sgml

Hi,
I have cvs'ed PostgreSQL

cd /usr/local/pgsql
cvs -z3 update -d

and when I do:

cd src
autoconf (all fine)
autoheader (lot's of harmless warning messages)
./configure --with-tcl --with-perl

configure: warning: perl support disabled; must be root to install

make

some harmless messages
All of PostgreSQL is successfully made. Ready to install.

make install

Thank you for choosing PostgreSQL, the most advanced open source database
engine.

cd ../doc

make
if [ ! -d /usr/local/pgsql/doc ]; then mkdir /usr/local/pgsql/doc; fi

cd src

oh mei (18.000 lines with docs on my screen!!)

cd /usr/lib/sgml
mkdir stylesheets
cd stylesheets
mkdir jade
ln -s /usr/lib/dsssl/stylesheets/docbook /usr/lib/sgml/stylesheets/jade

cd /usr/local/pgsql/doc/src
make

only two warnings
jade:ref/set.sgml:455:5:E: document type does not allow element "PARA"
here
jade:start.sgml:229:26:X: reference to non-existent ID "PROGRAMMERS-GUIDE"

Wow, looks great! Many thanks to Oliver.

-Egon

I'm writing some documentation about my recent changes to the backend
but I'm having problems with the sgml format used in the doc sources.

OK, first off, just remember that the words are the most important, and
the markup can be fixed later. And I'll help as much as you want.

The makefile in doc/src references some files in
/usr/lib/sgml/stylesheets
which aren't installed in my system. I would like to know where to
find those files

http://www.nwalsh.com/docbook/dsssl/index.html

I'm using the v1.18 experimental release at the moment. Look in the
appendix on docs inside the postgres integrated documentation for a
description of what your Makefile.custom would look like.

The docs also discuss how to install jade and the other pieces used to
convert the sgml into html and hardcopy.

... and if it is possible to convert the sgml format to
and from some format easier to edit. I've found converters to lyx and
html, which could easily be edited with proper programs, but none to
convert back one of these formats into sgml. Any suggestion?

The problem with both lyx (latex) and html is that these formats mark up
appearance, not content. So, there is no easy way to go back to the
complete content-markup of the original sgml. I've heard that the lyx
folks are working toward understanding DocBook sgml, but would guess
that it isn't coming soon.

I have the impression that FrameMaker can use sgml for input and output,
but that is a commercial product.

emacs has an sgml editing mode, but I haven't been able to get it to
work completely for me yet. It has trouble finding or reading the DTDs
to teach itself how to understand the DocBook definitions.

I just type the stuff in emacs or vi, which is pretty primitive.

- Tom