Received: from malur.postgresql.org ([217.196.149.56]) by arkaria.postgresql.org with esmtp (Exim 4.72) (envelope-from ) id 1TrmHa-0004F6-2J for pgsql-docs@arkaria.postgresql.org; Sun, 06 Jan 2013 09:12:42 +0000 Received: from localhost ([127.0.0.1] helo=postgresql.org) by malur.postgresql.org with smtp (Exim 4.72) (envelope-from ) id 1TrmHY-0005bb-SP for pgsql-docs@arkaria.postgresql.org; Sun, 06 Jan 2013 09:12:40 +0000 Received: from magus.postgresql.org ([87.238.57.229]) by malur.postgresql.org with esmtp (Exim 4.72) (envelope-from ) id 1TrmHX-0005b5-UR for pgsql-docs@postgresql.org; Sun, 06 Jan 2013 09:12:40 +0000 Received: from mail-oa0-f53.google.com ([209.85.219.53]) by magus.postgresql.org with esmtp (Exim 4.72) (envelope-from ) id 1TrmHU-0006VZ-Rm for pgsql-docs@postgresql.org; Sun, 06 Jan 2013 09:12:39 +0000 Received: by mail-oa0-f53.google.com with SMTP id j6so16473447oag.26 for ; Sun, 06 Jan 2013 01:12:35 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=mime-version:in-reply-to:references:date:message-id:subject:from:to :cc:content-type; bh=cETRFVDx2MRHO7xZAA4vWOmBJ1KkPjOMO0twmAjixSA=; b=vx2P5mwkkY44v8sEqG6beDw37sGE9g8k3hQZ3EykY3q2AlZs7POgaUE4bw5m10YEtS 5pPAdUln8ulIPgy4Po6RqAba3M9GpYth2ZDWX4ZwWGbCv9NBsm/ERrL6Vc8t/NSt393v OmiLkYFWZU5szPngOr739O/xOxXwqSy38GvsrX3XxmREpqoARMdzukjgX4eR3VASOnVK NXDit7m+C6Kf9A4zz7xvgutE3+t2g7zUKDchS4NbNYMXFqv8FEZuVSSNs2txnBGM7wew 5js5XSh36Fma37rkv2UNqZAQvU8DTjR6QHFIW84rJcTfSkOng4TLMdeGqwWohaFZeVs7 4eIQ== MIME-Version: 1.0 Received: by 10.182.31.33 with SMTP id x1mr42295555obh.29.1357463555038; Sun, 06 Jan 2013 01:12:35 -0800 (PST) Received: by 10.76.12.65 with HTTP; Sun, 6 Jan 2013 01:12:34 -0800 (PST) In-Reply-To: References: Date: Sun, 6 Jan 2013 13:12:34 +0400 Message-ID: Subject: Re: old testlo example code From: Dmitriy Igrishin To: Magnus Hagander Cc: Josh Kupershmidt , pgsql-docs Content-Type: multipart/alternative; boundary=14dae93a19effe5e0704d29b1c01 X-Pg-Spam-Score: -2.7 (--) List-Archive: List-Help: List-ID: List-Owner: List-Post: List-Subscribe: List-Unsubscribe: X-Mailing-List: pgsql-docs Precedence: bulk Sender: pgsql-docs-owner@postgresql.org --14dae93a19effe5e0704d29b1c01 Content-Type: text/plain; charset=UTF-8 2013/1/5 Magnus Hagander > On Sat, Jan 5, 2013 at 3:27 AM, Josh Kupershmidt > wrote: > > This documentation page: > > http://www.postgresql.org/docs/current/static/lo-examplesect.html > > > > contains a hardcoded copy of ./src/test/examples/testlo.c, and it > > seems like this version hasn't been updated along with its source. The > > version from the docs no longer compiles for me, at least not when I > > drop it into the place of the current ./src/test/examples/testlo.c. > > That's easy enough to fix, though I have a historical question about > > this code. > > 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 think it's possible with Doxygen. > > -- > Magnus Hagander > Me: http://www.hagander.net/ > Work: http://www.redpill-linpro.com/ > > > -- > Sent via pgsql-docs mailing list (pgsql-docs@postgresql.org) > To make changes to your subscription: > http://www.postgresql.org/mailpref/pgsql-docs > -- // Dmitriy. --14dae93a19effe5e0704d29b1c01 Content-Type: text/html; charset=UTF-8 Content-Transfer-Encoding: quoted-printable



2013/1/5 Magnus Hagander <magnus@hagander.net>
=
On Sat, Jan 5, 2013 at 3:27 AM, Josh Kupershmidt <schmiddy@gmail.com> wrote:
> This documentation page:
> =C2=A0 http://www.postgresql.org/docs/current/sta= tic/lo-examplesect.html
>
> contains a hardcoded copy of ./src/test/examples/testlo.c, and it
> seems like this version hasn't been updated along with its source.= The
> version from the docs no longer compiles for me, at least not when I > drop it into the place of the current ./src/test/examples/testlo.c. > That's easy enough to fix, though I have a historical question abo= ut
> this code.

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 think it's possible with Doxygen.=C2=A0

--
=C2=A0Magnus Hagander
=C2=A0Me: http://www= .hagander.net/
=C2=A0Work: ht= tp://www.redpill-linpro.com/


--
Sent via pgsql-docs mailing list (pgsql-docs@postgresql.org)
To make changes to your subscription:
http://www.postgresql.org/mailpref/pgsql-docs



--
= // Dmitriy.

--14dae93a19effe5e0704d29b1c01--