Thread

1. sgml

   Massimo Dal Zotto <dz@cs.unitn.it> — 1998-10-14T21:08:24Z

   Hi,
   
   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.
   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 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?
   
   -- 
   Massimo Dal Zotto
   
   +----------------------------------------------------------------------+
   |  Massimo Dal Zotto                email:  dz@cs.unitn.it             |
   |  Via Marconi, 141                 phone:  ++39-461-534251            |
   |  38057 Pergine Valsugana (TN)     www:  http://www.cs.unitn.it/~dz/  |
   |  Italy                            pgp:  finger dz@tango.cs.unitn.it  |
   +----------------------------------------------------------------------+
   
   

2. Problems

   Egon Schmid <eschmid@delos.stuttgart.netsurf.de> — 1998-10-14T23:13:24Z

   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
   
   
   
   

3. Re: [HACKERS] sgml

   Thomas Lockhart <lockhart@alumni.caltech.edu> — 1998-10-15T06:47:02Z

   > 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