Re: pgsql "info" files?

From: Andreas Seltenreich <andreas+pg(at)gate450(dot)dyndns(dot)org>
To: mike dixon <mdixon(at)operamail(dot)com>
Cc: pgsql-general(at)postgresql(dot)org
Subject: Re: pgsql "info" files?
Date: 2005-10-30 00:06:38
Message-ID: 87mzkrlvg1.fsf@gate450.dyndns.org
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-general

Martijn van Oosterhout schrob:

> On Sat, Oct 29, 2005 at 08:29:32PM +0100, mike dixon wrote:
>> I really love the "info" help system (don't know its name; "info
>> emacs" on cmd line if it's installed calls it up; filenames are
>> "texinfo-info*" for example); anyone know if info files are available
>> anywhere for pgsql? I looked at what gentoo's "emerge" installed and
>> don't see anything...
>
> I don't think so. However, most of the documentation is in SGML format
> and you should be able to convert that to info format...

I was able to build one by adding some targets to
doc/src/sgml/Makefile using <http://docbook2x.sf.net/>:

--8<---------------cut here---------------start------------->8---
postgres.txml: postgres.xml
db2x_xsltproc -s texi postgres.xml -o postgres.txml

postgres.texi: postgres.txml
db2x_texixml --encoding=iso-8859-1//TRANSLIT postgres.txml --to-stdout | \
sed -e 's/^(at)setfilename(dot)*/@setfilename postgres.info/' \
-e '/^(at)direntry/,/^(at)end direntry/{\
s/([^)]\+/(postgres.info/\
}' \
> postgres.texi

postgres.info: postgres.texi
makeinfo --no-validate postgres.texi -o postgres.info
--8<---------------cut here---------------end--------------->8---

However, the resulting info documentation is still lacking an index,
which doesn't make it as usable at it could be :-/.

regards,
Andreas
--

In response to

Browse pgsql-general by date

  From Date Subject
Next Message Tom Lane 2005-10-30 00:45:57 Re: Generating an ANSI compliant schema recreation script
Previous Message Douglas McNaught 2005-10-29 23:57:25 Re: Generating an ANSI compliant schema recreation script