From: Brent Verner <brent@rcfile.org>
To: pgsql-docs@postgresql.org
Subject: sgml cleanup
Date: Wed, 21 Nov 2001 22:47:21 -0500
Message-ID: <20011121224721.A28646@rcfile.org> (raw)
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
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Reply to all the recipients using the --to and --cc options:
reply via email
To: pgsql-docs@postgresql.org
Cc: brent@rcfile.org
Subject: Re: sgml cleanup
In-Reply-To: <20011121224721.A28646@rcfile.org>
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
This inbox is served by DDX for PostgreSQL; see mirroring instructions
for how to clone and mirror all data and code used for this inbox