public inbox for [email protected]
help / color / mirror / Atom feedFrom: Rod Taylor <[email protected]>
To: [email protected]
Subject: Doc <synopsis> changes
Date: 23 Feb 2003 10:44:54 -0500
Message-ID: <1046015094.84130.178.camel@jester> (raw)
I needed to make the synopsis areas more consistent for a side project.
By far the simplest way to do that was to change them into <cmdsynopsis>
entities.
Benefits include increased consistency in spacing and formatting, nice
<synopfragment> linkouts (click the (1)), and the ability to share
code. It may be possible to generate railroad diagrams from the marked
up copy.
The biggest problem is you cannot indent sections anymore, but that may
be correctable with a stylesheet change.
New CREATE TABLE:
http://www.rbt.ca/docs/reference/sql-createtable.html#SQL-CREATETABLE-REFERENCES-FRAGMENT
Old CREATE TABLE:
http://candle.pha.pa.us/main/writings/pgsql/sgml/sql-createtable.html
Patch submitted to -patches. Another pass will be made for formatting
details if this method is accepted.
Yes, I've updated psql's create_help.pl to deal with the SGML formatted
areas.
--
Rod Taylor <[email protected]>
PGP Key: http://www.rbt.ca/rbtpub.asc
Attachments:
[application/pgp-signature] signature.asc (187B, 2-signature.asc)
download
view thread (6+ messages) latest in thread
reply
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: [email protected]
Cc: [email protected]
Subject: Re: Doc <synopsis> changes
In-Reply-To: <1046015094.84130.178.camel@jester>
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
This inbox is served by agora; see mirroring instructions
for how to clone and mirror all data and code used for this inbox