Re: old testlo example code

From: Josh Kupershmidt <schmiddy(at)gmail(dot)com>
To: Peter Eisentraut <peter_e(at)gmx(dot)net>
Cc: Magnus Hagander <magnus(at)hagander(dot)net>, pgsql-docs <pgsql-docs(at)postgresql(dot)org>
Subject: Re: old testlo example code
Date: 2013-02-27 03:18:40
Message-ID: CAK3UJRFJEU1bUjRrxjs2kZcOA=Q+Vu+MPcCGnko+3DS05ZhCTw@mail.gmail.com
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-docs

On Thu, Feb 14, 2013 at 7:30 PM, Peter Eisentraut <peter_e(at)gmx(dot)net> wrote:
> On Sat, 2013-01-05 at 15:14 +0100, Magnus Hagander wrote:
>> ISTM we should either remove the example programs and replace them
>> with just a reference, or find a way to include the source code into
>> the documentation with some kind of include statement instead of
>> haivng a copy of it. That should be done the same way for all the
>> example programs, not just the testlo ones of course.
>>
>> Not sure if it's possible to create such an include though - someone
>> who knows our toolchain better can hopefully comment on that?
>
> I've been looking into this. It's not easily possible with the current
> SGML setup. (XInclude with XML would probably work.) So for now it
> would be best if someone could just sync up the docs with the code until
> we figure out a better way.

OK, here's a patch to update the example code in the docs to match the
example programs in ./src/test/examples . In addition to the testlo
example discussed, I updated the libpq examples as well. There's a
fair amount of whitespace churn in the diff, though I assume that's
from a pgindent change of the test code at some point.

Josh

Attachment Content-Type Size
example_code_in_documentation.diff application/octet-stream 31.0 KB

In response to

Responses

Browse pgsql-docs by date

  From Date Subject
Next Message Josh Kupershmidt 2013-03-02 02:02:39 few awkward phrasing fixes
Previous Message Kevin Hale Boyes 2013-02-25 01:00:11 Re: [DOCS] Contrib module "xml2" status