public inbox for [email protected]
help / color / mirror / Atom feedDoc <synopsis> changes
6+ messages / 2 participants
[nested] [flat]
* Doc <synopsis> changes
@ 2003-02-23 15:44 Rod Taylor <[email protected]>
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 <[email protected]>
PGP Key: http://www.rbt.ca/rbtpub.asc
Attachments:
[application/pgp-signature] signature.asc (187B, 2-signature.asc)
download
^ permalink raw reply [nested|flat] 6+ messages in thread
* Re: Doc <synopsis> changes
@ 2003-02-23 19:57 Peter Eisentraut <[email protected]>
parent: Rod Taylor <[email protected]>
0 siblings, 2 replies; 6+ messages in thread
From: Peter Eisentraut @ 2003-02-23 19:57 UTC (permalink / raw)
To: Rod Taylor <[email protected]>; +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 [email protected]
^ permalink raw reply [nested|flat] 6+ messages in thread
* Re: Doc <synopsis> changes
@ 2003-02-23 20:01 Rod Taylor <[email protected]>
parent: Peter Eisentraut <[email protected]>
1 sibling, 0 replies; 6+ messages in thread
From: Rod Taylor @ 2003-02-23 20:01 UTC (permalink / raw)
To: Peter Eisentraut <[email protected]>; +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 <[email protected]>
PGP Key: http://www.rbt.ca/rbtpub.asc
Attachments:
[application/pgp-signature] signature.asc (187B, 2-signature.asc)
download
^ permalink raw reply [nested|flat] 6+ messages in thread
* Re: Doc <synopsis> changes
@ 2003-02-27 16:54 Rod Taylor <[email protected]>
parent: Peter Eisentraut <[email protected]>
1 sibling, 1 reply; 6+ messages in thread
From: Rod Taylor @ 2003-02-27 16:54 UTC (permalink / raw)
To: Peter Eisentraut <[email protected]>; +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 <[email protected]>
PGP Key: http://www.rbt.ca/rbtpub.asc
Attachments:
[application/pgp-signature] signature.asc (187B, 2-signature.asc)
download
^ permalink raw reply [nested|flat] 6+ messages in thread
* Re: Doc <synopsis> changes
@ 2003-02-28 12:43 Peter Eisentraut <[email protected]>
parent: Rod Taylor <[email protected]>
0 siblings, 1 reply; 6+ messages in thread
From: Peter Eisentraut @ 2003-02-28 12:43 UTC (permalink / raw)
To: Rod Taylor <[email protected]>; +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 [email protected]
^ permalink raw reply [nested|flat] 6+ messages in thread
* Re: Doc <synopsis> changes
@ 2003-02-28 13:35 Rod Taylor <[email protected]>
parent: Peter Eisentraut <[email protected]>
0 siblings, 0 replies; 6+ messages in thread
From: Rod Taylor @ 2003-02-28 13:35 UTC (permalink / raw)
To: Peter Eisentraut <[email protected]>; +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 <[email protected]>
PGP Key: http://www.rbt.ca/rbtpub.asc
Attachments:
[application/pgp-signature] signature.asc (187B, 2-signature.asc)
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 <[email protected]>
2003-02-23 19:57 ` Peter Eisentraut <[email protected]>
2003-02-23 20:01 ` Rod Taylor <[email protected]>
2003-02-27 16:54 ` Rod Taylor <[email protected]>
2003-02-28 12:43 ` Peter Eisentraut <[email protected]>
2003-02-28 13:35 ` Rod Taylor <[email protected]>
This inbox is served by agora; see mirroring instructions
for how to clone and mirror all data and code used for this inbox