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 |
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 |