pg.ddx.io pgsql-docs@postgresql.org mailing list archive
help / color / mirror / Atom feedDoc <synopsis> changes
6+ messages / 2 participants
[nested] [flat]
* Doc <synopsis> changes
@ 2003-02-23 15:44 Rod Taylor <rbt@rbt.ca>
2003-02-23 19:57 ` Re: Doc <synopsis> changes Peter Eisentraut <peter_e@gmx.net>
0 siblings, 1 reply; 6+ messages in thread
From: Rod Taylor @ 2003-02-23 15:44 UTC (permalink / raw)
To: pgsql-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
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 <rbt@rbt.ca>
PGP Key: http://www.rbt.ca/rbtpub.asc
Attachments:
signature.asc (application/pgp-signature, 186B) download
^ permalink raw reply [nested|flat] 6+ messages in thread
* Re: Doc <synopsis> changes
2003-02-23 15:44 Doc <synopsis> changes Rod Taylor <rbt@rbt.ca>
@ 2003-02-23 19:57 ` Peter Eisentraut <peter_e@gmx.net>
2003-02-23 20:01 ` Re: Doc <synopsis> changes Rod Taylor <rbt@rbt.ca>
2003-02-27 16:54 ` Re: Doc <synopsis> changes Rod Taylor <rbt@rbt.ca>
0 siblings, 2 replies; 6+ messages in thread
From: Peter Eisentraut @ 2003-02-23 19:57 UTC (permalink / raw)
To: Rod Taylor <rbt@rbt.ca>; +Cc: pgsql-docs
Rod Taylor writes:
> New CREATE TABLE:
> http://www.rbt.ca/docs/reference/sql-createtable.html#SQL-CREATETABLE-REFERENCES-FRAGMENT
Sorry, but that is very ugly. Unless you also provide stylesheet updates
with this, I don't think we can accept that.
--
Peter Eisentraut peter_e@gmx.net
^ permalink raw reply [nested|flat] 6+ messages in thread
* Re: Doc <synopsis> changes
2003-02-23 15:44 Doc <synopsis> changes Rod Taylor <rbt@rbt.ca>
2003-02-23 19:57 ` Re: Doc <synopsis> changes Peter Eisentraut <peter_e@gmx.net>
@ 2003-02-23 20:01 ` Rod Taylor <rbt@rbt.ca>
1 sibling, 0 replies; 6+ messages in thread
From: Rod Taylor @ 2003-02-23 20:01 UTC (permalink / raw)
To: Peter Eisentraut <peter_e@gmx.net>; +Cc: pgsql-docs
On Sun, 2003-02-23 at 14:57, Peter Eisentraut wrote:
> Rod Taylor writes:
>
> > New CREATE TABLE:
> > http://www.rbt.ca/docs/reference/sql-createtable.html#SQL-CREATETABLE-REFERENCES-FRAGMENT
>
> Sorry, but that is very ugly. Unless you also provide stylesheet updates
> with this, I don't think we can accept that.
Agreed, it's ugly. I have a decent stylesheet -- but it's an XSLT. I'll
see what I can do about updating the dsssl.
--
Rod Taylor <rbt@rbt.ca>
PGP Key: http://www.rbt.ca/rbtpub.asc
Attachments:
signature.asc (application/pgp-signature, 186B) download
^ permalink raw reply [nested|flat] 6+ messages in thread
* Re: Doc <synopsis> changes
2003-02-23 15:44 Doc <synopsis> changes Rod Taylor <rbt@rbt.ca>
2003-02-23 19:57 ` Re: Doc <synopsis> changes Peter Eisentraut <peter_e@gmx.net>
@ 2003-02-27 16:54 ` Rod Taylor <rbt@rbt.ca>
2003-02-28 12:43 ` Re: Doc <synopsis> changes Peter Eisentraut <peter_e@gmx.net>
1 sibling, 1 reply; 6+ messages in thread
From: Rod Taylor @ 2003-02-27 16:54 UTC (permalink / raw)
To: Peter Eisentraut <peter_e@gmx.net>; +Cc: pgsql-docs
On Sun, 2003-02-23 at 14:57, Peter Eisentraut wrote:
> Rod Taylor writes:
>
> > New CREATE TABLE:
> > http://www.rbt.ca/docs/reference/sql-createtable.html#SQL-CREATETABLE-REFERENCES-FRAGMENT
>
> Sorry, but that is very ugly. Unless you also provide stylesheet updates
> with this, I don't think we can accept that.
Minor changes made to indenting.
Cleaned up a good chunk of the 'repeatable' elements to be clearer.
Anyway, I think it looks as good as the old version did -- but could be
wrong ;) Any further suggestions?
I link to createtable, as it is the poorest of the set.
NOTE: The change of brackets on the CREATE CONSTRAINT TRIGGER change.
They're quoted in the original -- but that isn't how one types in the
function name.
Any suggestions on further formatting or style?
--
Rod Taylor <rbt@rbt.ca>
PGP Key: http://www.rbt.ca/rbtpub.asc
Attachments:
signature.asc (application/pgp-signature, 186B) download
^ permalink raw reply [nested|flat] 6+ messages in thread
* Re: Doc <synopsis> changes
2003-02-23 15:44 Doc <synopsis> changes Rod Taylor <rbt@rbt.ca>
2003-02-23 19:57 ` Re: Doc <synopsis> changes Peter Eisentraut <peter_e@gmx.net>
2003-02-27 16:54 ` Re: Doc <synopsis> changes Rod Taylor <rbt@rbt.ca>
@ 2003-02-28 12:43 ` Peter Eisentraut <peter_e@gmx.net>
2003-02-28 13:35 ` Re: Doc <synopsis> changes Rod Taylor <rbt@rbt.ca>
0 siblings, 1 reply; 6+ messages in thread
From: Peter Eisentraut @ 2003-02-28 12:43 UTC (permalink / raw)
To: Rod Taylor <rbt@rbt.ca>; +Cc: pgsql-docs
Rod Taylor writes:
> Anyway, I think it looks as good as the old version did -- but could be
> wrong ;) Any further suggestions?
I think the cmdsynopsis element is fundamentally unsuitable for SQL
commands, because their syntax isn't simply command + arguments.
--
Peter Eisentraut peter_e@gmx.net
^ permalink raw reply [nested|flat] 6+ messages in thread
* Re: Doc <synopsis> changes
2003-02-23 15:44 Doc <synopsis> changes Rod Taylor <rbt@rbt.ca>
2003-02-23 19:57 ` Re: Doc <synopsis> changes Peter Eisentraut <peter_e@gmx.net>
2003-02-27 16:54 ` Re: Doc <synopsis> changes Rod Taylor <rbt@rbt.ca>
2003-02-28 12:43 ` Re: Doc <synopsis> changes Peter Eisentraut <peter_e@gmx.net>
@ 2003-02-28 13:35 ` Rod Taylor <rbt@rbt.ca>
0 siblings, 0 replies; 6+ messages in thread
From: Rod Taylor @ 2003-02-28 13:35 UTC (permalink / raw)
To: Peter Eisentraut <peter_e@gmx.net>; +Cc: pgsql-docs
On Fri, 2003-02-28 at 07:43, Peter Eisentraut wrote:
> Rod Taylor writes:
>
> > Anyway, I think it looks as good as the old version did -- but could be
> > wrong ;) Any further suggestions?
>
> I think the cmdsynopsis element is fundamentally unsuitable for SQL
> commands, because their syntax isn't simply command + arguments.
Hmm.. wish you would have said that the first time. Anyway, I've
accomplished what I was asked to, so I'll leave it at that.
Thanks for your thoughts.
--
Rod Taylor <rbt@rbt.ca>
PGP Key: http://www.rbt.ca/rbtpub.asc
Attachments:
signature.asc (application/pgp-signature, 186B) download
^ permalink raw reply [nested|flat] 6+ messages in thread
end of thread, other threads:[~2003-02-28 13:35 UTC | newest]
Thread overview: 6+ messages (download: mbox mbox.gz follow: Atom feed)
-- links below jump to the message on this page --
2003-02-23 15:44 Doc <synopsis> changes Rod Taylor <rbt@rbt.ca>
2003-02-23 19:57 ` Peter Eisentraut <peter_e@gmx.net>
2003-02-23 20:01 ` Rod Taylor <rbt@rbt.ca>
2003-02-27 16:54 ` Rod Taylor <rbt@rbt.ca>
2003-02-28 12:43 ` Peter Eisentraut <peter_e@gmx.net>
2003-02-28 13:35 ` Rod Taylor <rbt@rbt.ca>
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