Skip site navigation (1) Skip section navigation (2)

Re: reference pages for libpq

From: Peter Eisentraut <peter_e(at)gmx(dot)net>
To: "Robert B(dot) Easter" <reaster(at)comptechnews(dot)com>
Cc: <pgsql-docs(at)postgresql(dot)org>
Subject: Re: reference pages for libpq
Date: 2001-02-10 22:20:58
Message-ID: Pine.LNX.4.30.0102102311380.775-100000@peter.localdomain (view raw or flat)
Thread:
Lists: pgsql-docs
Robert B. Easter writes:

> I don't see any reference (man) pages for the C API library (libpq).  It's
> got ok html documentation but would it be a good idea to make man pages for
> that library too?  Personally, I really like man page docs for programming
> libraries.  However, I don't want to work on something no one else would want
> or that might just make documentation updating more difficult having two
> places to update if things change.

You could convert the function descriptions that are currently in an
<itemizedlist> into a sequence of <refentry>s.  From that you can make man
pages.  The flow in the HTML might become slightly awkward, though, so
some rewriting might be in order.  The libpgtcl chapter is currently
organized that way (although we don't make man pages from it).

I say try and see how it looks.

-- 
Peter Eisentraut      peter_e(at)gmx(dot)net       http://yi.org/peter-e/


In response to

pgsql-docs by date

Next:From: Bruce MomjianDate: 2001-02-11 15:14:04
Subject: release date
Previous:From: Bruce MomjianDate: 2001-02-10 21:27:25
Subject: Re: reference pages for libpq

Privacy Policy | About PostgreSQL
Copyright © 1996-2014 The PostgreSQL Global Development Group