public inbox for [email protected]
help / color / mirror / Atom feedAdding an table of contents in SGML
4+ messages / 3 participants
[nested] [flat]
* Adding an table of contents in SGML
@ 2009-03-31 01:23 Bruce Momjian <[email protected]>
0 siblings, 2 replies; 4+ messages in thread
From: Bruce Momjian @ 2009-03-31 01:23 UTC (permalink / raw)
To: pgsql-docs
I would like to add a table of contents to the top of the 8.4 release
notes:
http://developer.postgresql.org/pgdocs/postgres/release-8-4.html
Similar to the one at the top here:
http://developer.postgresql.org/pgdocs/postgres/datatype.html
I tried poking around but didn't find any obvious way to do it.
--
Bruce Momjian <[email protected]> http://momjian.us
EnterpriseDB http://enterprisedb.com
+ If your life is a hard drive, Christ can be your backup. +
^ permalink raw reply [nested|flat] 4+ messages in thread
* Re: Adding an table of contents in SGML
@ 2009-03-31 02:28 Tom Lane <[email protected]>
parent: Bruce Momjian <[email protected]>
1 sibling, 1 reply; 4+ messages in thread
From: Tom Lane @ 2009-03-31 02:28 UTC (permalink / raw)
To: Bruce Momjian <[email protected]>; +Cc: pgsql-docs
Bruce Momjian <[email protected]> writes:
> I would like to add a table of contents to the top of the 8.4 release
> notes:
Resist the temptation. If you have so many sub-sections that it needs
its own table of contents, you have too many.
> Similar to the one at the top here:
> http://developer.postgresql.org/pgdocs/postgres/datatype.html
That is a chapter heading, not a section heading.
regards, tom lane
^ permalink raw reply [nested|flat] 4+ messages in thread
* Re: Adding an table of contents in SGML
@ 2009-03-31 02:33 Bruce Momjian <[email protected]>
parent: Tom Lane <[email protected]>
0 siblings, 0 replies; 4+ messages in thread
From: Bruce Momjian @ 2009-03-31 02:33 UTC (permalink / raw)
To: Tom Lane <[email protected]>; +Cc: pgsql-docs
Tom Lane wrote:
> Bruce Momjian <[email protected]> writes:
> > I would like to add a table of contents to the top of the 8.4 release
> > notes:
>
> Resist the temptation. If you have so many sub-sections that it needs
> its own table of contents, you have too many.
It is not that things are hard to find but rather that it would be good
to present a list at the top to give users a better handle on the
contents; there are 276 items listed in the 8.4 release notes. 8.3 had
237, a 15% increase.
> > Similar to the one at the top here:
> > http://developer.postgresql.org/pgdocs/postgres/datatype.html
>
> That is a chapter heading, not a section heading.
True, but it says, "Table of Contents", at the top of the list of
headings.
--
Bruce Momjian <[email protected]> http://momjian.us
EnterpriseDB http://enterprisedb.com
+ If your life is a hard drive, Christ can be your backup. +
^ permalink raw reply [nested|flat] 4+ messages in thread
* Re: Adding an table of contents in SGML
@ 2009-03-31 20:48 Peter Eisentraut <[email protected]>
parent: Bruce Momjian <[email protected]>
1 sibling, 0 replies; 4+ messages in thread
From: Peter Eisentraut @ 2009-03-31 20:48 UTC (permalink / raw)
To: pgsql-docs; +Cc: Bruce Momjian <[email protected]>
On Tuesday 31 March 2009 04:23:09 Bruce Momjian wrote:
> I would like to add a table of contents to the top of the 8.4 release
> notes:
>
> http://developer.postgresql.org/pgdocs/postgres/release-8-4.html
>
> Similar to the one at the top here:
>
> http://developer.postgresql.org/pgdocs/postgres/datatype.html
>
> I tried poking around but didn't find any obvious way to do it.
There is no support for creating table of contents for divisions below chapter
level.
^ permalink raw reply [nested|flat] 4+ messages in thread
end of thread, other threads:[~2009-03-31 20:48 UTC | newest]
Thread overview: 4+ messages (download: mbox mbox.gz follow: Atom feed)
-- links below jump to the message on this page --
2009-03-31 01:23 Adding an table of contents in SGML Bruce Momjian <[email protected]>
2009-03-31 02:28 ` Tom Lane <[email protected]>
2009-03-31 02:33 ` Bruce Momjian <[email protected]>
2009-03-31 20:48 ` Peter Eisentraut <[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