sgml cleanup

From: Brent Verner <brent(at)rcfile(dot)org>
To: pgsql-docs(at)postgresql(dot)org
Subject: sgml cleanup
Date: 2001-11-22 03:47:21
Message-ID: 20011121224721.A28646@rcfile.org
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: 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

Responses

Browse pgsql-docs by date

  From Date Subject
Next Message Tom Lane 2001-11-22 04:11:52 Re: sgml cleanup
Previous Message Andrew G. Hammond 2001-11-22 01:09:42 Re: PL/pgSQL examples NOT involving functions