Re: pgsql "info" files?

[Andreas Seltenreich <andreas+pg(at)gate450(dot)dyndns(dot)org>]

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