sgml cleanup - Mailing list pgsql-docs

Hi all,

  In trying to get the doc/ tree in cvs to build, I noticed a _lot_ of
empty closing tags when I ran

  sh$ nsgmls -s -wall ./book-decl.sgml ./reference.sgml

from doc/src/sgml.  I know little about docbook, so I fixed the
tags to see if that would fix my problems in making man.tar, but
I still haven't gotten the man.tar to make properly :-(  I have a
patch against head to fix the empty tags, but it is quite large and
touches a /lot/ of files (listed below).  If this is a real problem,
let me know, and I'll send the patch to -patches (the gzipped patch
is about 17k).

  I also have modifications to config/docbook.m4 and doc/src/Makefile.in
to allow docs to (almost) build on my debian box.  The last outstanding
problem is that the names of the generated man pages have whitespace
between the program name and the appended ".1"...

brent$ tar tvf man.tar
drwxr-sr-x brent/brent       0 2001-11-21 21:16:24 man1/
-rw-r--r-- brent/brent    3797 2001-11-21 21:16:21 man1/createdb.1
-rw-r--r-- brent/brent    3041 2001-11-21 21:16:21 man1/createlang.1
-rw-r--r-- brent/brent    3748 2001-11-21 21:16:21 man1/createuser.1
-rw-r--r-- brent/brent    2821 2001-11-21 21:16:21 man1/dropdb.1
-rw-r--r-- brent/brent    2573 2001-11-21 21:16:22 man1/droplang.1
-rw-r--r-- brent/brent    2887 2001-11-21 21:16:22 man1/dropuser.1
-rw-r--r-- brent/brent    5987 2001-11-21 20:39:25 man1/ecpg  .1
-rw-r--r-- brent/brent    4648 2001-11-21 21:16:23 man1/initdb.1
-rw-r--r-- brent/brent    1562 2001-11-21 21:16:23 man1/initlocation.1
-rw-r--r-- brent/brent    1721 2001-11-21 21:16:23 man1/ipcclean.1
-rw-r--r-- brent/brent    2832 2001-11-21 21:16:22 man1/pg_config.1
-rw-r--r-- brent/brent    6409 2001-11-21 21:16:23 man1/pg_ctl.1
-rw-r--r-- brent/brent   12585 2001-11-21 20:39:26 man1/pg_dump\n  .1
-rw-r--r-- brent/brent    3669 2001-11-21 21:16:22 man1/pg_dumpall.1
-rw-r--r-- brent/brent    2678 2001-11-21 21:16:23 man1/pg_passwd.1
-rw-r--r-- brent/brent   12277 2001-11-21 20:39:26 man1/pg_restore\n  .1
-rw-r--r-- brent/brent    3613 2001-11-21 21:16:22 man1/pgaccess.1
-rw-r--r-- brent/brent    1098 2001-11-21 20:39:27 man1/pgtclsh\n  .1
-rw-r--r-- brent/brent    1196 2001-11-21 20:33:55 man1/pgtksh\n  .1


  Anyone care to share the details of the patched docbook2man-spec.pl
file mentioned in doc/src/Makefile.in?  Do these modifications fix the
problems seen above?

cheers.
  brent

brent$ grep '^Index: ' pgsql-doc.diff
Index: doc/src/sgml/protocol.sgml
Index: doc/src/sgml/ref/abort.sgml
Index: doc/src/sgml/ref/alter_group.sgml
Index: doc/src/sgml/ref/alter_table.sgml
Index: doc/src/sgml/ref/alter_user.sgml
Index: doc/src/sgml/ref/analyze.sgml
Index: doc/src/sgml/ref/begin.sgml
Index: doc/src/sgml/ref/close.sgml
Index: doc/src/sgml/ref/cluster.sgml
Index: doc/src/sgml/ref/comment.sgml
Index: doc/src/sgml/ref/commit.sgml
Index: doc/src/sgml/ref/copy.sgml
Index: doc/src/sgml/ref/create_aggregate.sgml
Index: doc/src/sgml/ref/create_constraint.sgml
Index: doc/src/sgml/ref/create_database.sgml
Index: doc/src/sgml/ref/create_function.sgml
Index: doc/src/sgml/ref/create_group.sgml
Index: doc/src/sgml/ref/create_index.sgml
Index: doc/src/sgml/ref/create_operator.sgml
Index: doc/src/sgml/ref/create_rule.sgml
Index: doc/src/sgml/ref/create_sequence.sgml
Index: doc/src/sgml/ref/create_table.sgml
Index: doc/src/sgml/ref/create_table_as.sgml
Index: doc/src/sgml/ref/create_type.sgml
Index: doc/src/sgml/ref/create_user.sgml
Index: doc/src/sgml/ref/create_view.sgml
Index: doc/src/sgml/ref/declare.sgml
Index: doc/src/sgml/ref/drop_aggregate.sgml
Index: doc/src/sgml/ref/drop_database.sgml
Index: doc/src/sgml/ref/drop_function.sgml
Index: doc/src/sgml/ref/drop_group.sgml
Index: doc/src/sgml/ref/drop_index.sgml
Index: doc/src/sgml/ref/drop_operator.sgml
Index: doc/src/sgml/ref/drop_rule.sgml
Index: doc/src/sgml/ref/drop_sequence.sgml
Index: doc/src/sgml/ref/drop_table.sgml
Index: doc/src/sgml/ref/drop_trigger.sgml
Index: doc/src/sgml/ref/drop_type.sgml
Index: doc/src/sgml/ref/drop_user.sgml
Index: doc/src/sgml/ref/drop_view.sgml
Index: doc/src/sgml/ref/ecpg-ref.sgml
Index: doc/src/sgml/ref/end.sgml
Index: doc/src/sgml/ref/explain.sgml
Index: doc/src/sgml/ref/fetch.sgml
Index: doc/src/sgml/ref/listen.sgml
Index: doc/src/sgml/ref/lock.sgml
Index: doc/src/sgml/ref/move.sgml
Index: doc/src/sgml/ref/notify.sgml
Index: doc/src/sgml/ref/pg_config-ref.sgml
Index: doc/src/sgml/ref/pg_dump.sgml
Index: doc/src/sgml/ref/pg_restore.sgml
Index: doc/src/sgml/ref/pg_upgrade.sgml
Index: doc/src/sgml/ref/pgtclsh.sgml
Index: doc/src/sgml/ref/pgtksh.sgml
Index: doc/src/sgml/ref/reindex.sgml
Index: doc/src/sgml/ref/rollback.sgml
Index: doc/src/sgml/ref/select.sgml
Index: doc/src/sgml/ref/select_into.sgml
Index: doc/src/sgml/ref/truncate.sgml
Index: doc/src/sgml/ref/unlisten.sgml
Index: doc/src/sgml/ref/update.sgml
Index: doc/src/sgml/ref/vacuum.sgml


--
"Develop your talent, man, and leave the world something. Records are
really gifts from people. To think that an artist would love you enough
to share his music with anyone is a beautiful thing."  -- Duane Allman