Re: Doc <synopsis> changes

From: Rod Taylor <rbt(at)rbt(dot)ca>
To: PostgreSQL Patches <pgsql-patches(at)postgresql(dot)org>
Subject: Re: Doc <synopsis> changes
Date: 2003-02-23 15:49:09
Message-ID: 1046015348.84130.185.camel@jester
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-patches

All that and I forgot the patch -- attached.

On Sun, 2003-02-23 at 10:45, Rod Taylor wrote:
> If applied, a second pass on the docs will be made for format tweeking,
> content sharing, and exporting more elements as synopfragments.
>
>
> Sent to -docs:
>
> 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
>
>
> Yes, I've updated psql's create_help.pl to deal with the SGML formatted
> areas.
--
Rod Taylor <rbt(at)rbt(dot)ca>

PGP Key: http://www.rbt.ca/rbtpub.asc

Attachment Content-Type Size
dbpsql2.patch text/plain 172.2 KB

In response to

Responses

Browse pgsql-patches by date

  From Date Subject
Next Message Peter Eisentraut 2003-02-23 16:16:56 Re: Feature list correction
Previous Message Rod Taylor 2003-02-23 15:45:02 Doc <synopsis> changes