Doc <synopsis> changes

Started by Rod Taylorover 23 years ago6 messagespatches
Jump to latest
#1Rod Taylor
rbt@rbt.ca

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@rbt.ca>

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

#2Rod Taylor
rbt@rbt.ca
In reply to: Rod Taylor (#1)
Re: Doc <synopsis> changes

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@rbt.ca>

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

Attachments:

dbpsql2.patchtext/plain; charset=ISO-8859-1; name=dbpsql2.patchDownload+2742-2552
#3Bruce Momjian
bruce@momjian.us
In reply to: Rod Taylor (#2)
Re: Doc <synopsis> changes

Your patch has been added to the PostgreSQL unapplied patches list at:

http://momjian.postgresql.org/cgi-bin/pgpatches

I will try to apply it within the next 48 hours.

---------------------------------------------------------------------------

Rod Taylor wrote:
-- Start of PGP signed section.

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@rbt.ca>

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

[ Attachment, skipping... ]
-- End of PGP section, PGP failed!

-- 
  Bruce Momjian                        |  http://candle.pha.pa.us
  pgman@candle.pha.pa.us               |  (610) 359-1001
  +  If your life is a hard drive,     |  13 Roberts Road
  +  Christ can be your backup.        |  Newtown Square, Pennsylvania 19073
#4Rod Taylor
rbt@rbt.ca
In reply to: Bruce Momjian (#3)
Re: Doc <synopsis> changes

Peter decided he didn't like this.

Please skip it.

On Mon, 2003-03-17 at 12:47, Bruce Momjian wrote:

Your patch has been added to the PostgreSQL unapplied patches list at:

http://momjian.postgresql.org/cgi-bin/pgpatches

I will try to apply it within the next 48 hours.

---------------------------------------------------------------------------

Rod Taylor wrote:
-- Start of PGP signed section.

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@rbt.ca>

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

[ Attachment, skipping... ]
-- End of PGP section, PGP failed!

--
Rod Taylor <rbt@rbt.ca>

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

#5Bruce Momjian
bruce@momjian.us
In reply to: Rod Taylor (#2)
Re: Doc <synopsis> changes

Patch removed at request of author.

---------------------------------------------------------------------------

Rod Taylor wrote:
-- Start of PGP signed section.

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@rbt.ca>

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

[ Attachment, skipping... ]
-- End of PGP section, PGP failed!

-- 
  Bruce Momjian                        |  http://candle.pha.pa.us
  pgman@candle.pha.pa.us               |  (610) 359-1001
  +  If your life is a hard drive,     |  13 Roberts Road
  +  Christ can be your backup.        |  Newtown Square, Pennsylvania 19073
#6Bruce Momjian
bruce@momjian.us
In reply to: Rod Taylor (#4)
Re: Doc <synopsis> changes

Thanks, removed.

---------------------------------------------------------------------------

Rod Taylor wrote:
-- Start of PGP signed section.

Peter decided he didn't like this.

Please skip it.

On Mon, 2003-03-17 at 12:47, Bruce Momjian wrote:

Your patch has been added to the PostgreSQL unapplied patches list at:

http://momjian.postgresql.org/cgi-bin/pgpatches

I will try to apply it within the next 48 hours.

---------------------------------------------------------------------------

Rod Taylor wrote:
-- Start of PGP signed section.

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@rbt.ca>

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

[ Attachment, skipping... ]
-- End of PGP section, PGP failed!

--
Rod Taylor <rbt@rbt.ca>

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

-- End of PGP section, PGP failed!

-- 
  Bruce Momjian                        |  http://candle.pha.pa.us
  pgman@candle.pha.pa.us               |  (610) 359-1001
  +  If your life is a hard drive,     |  13 Roberts Road
  +  Christ can be your backup.        |  Newtown Square, Pennsylvania 19073