| Lists: | pgsql-docs |
|---|
| From: | Bruce Momjian <bruce(at)momjian(dot)us> |
|---|---|
| To: | PostgreSQL-documentation <pgsql-docs(at)postgresql(dot)org> |
| Subject: | Adding an table of contents in SGML |
| Date: | 2009-03-31 01:23:09 |
| Message-ID: | 200903310123.n2V1N9014716@momjian.us |
| Views: | Raw Message | Whole Thread | Download mbox | Resend email |
| Lists: | 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 <bruce(at)momjian(dot)us> http://momjian.us
EnterpriseDB http://enterprisedb.com
+ If your life is a hard drive, Christ can be your backup. +
| From: | Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us> |
|---|---|
| To: | Bruce Momjian <bruce(at)momjian(dot)us> |
| Cc: | PostgreSQL-documentation <pgsql-docs(at)postgresql(dot)org> |
| Subject: | Re: Adding an table of contents in SGML |
| Date: | 2009-03-31 02:28:29 |
| Message-ID: | 28586.1238466509@sss.pgh.pa.us |
| Views: | Raw Message | Whole Thread | Download mbox | Resend email |
| Lists: | pgsql-docs |
Bruce Momjian <bruce(at)momjian(dot)us> 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
| From: | Bruce Momjian <bruce(at)momjian(dot)us> |
|---|---|
| To: | Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us> |
| Cc: | PostgreSQL-documentation <pgsql-docs(at)postgresql(dot)org> |
| Subject: | Re: Adding an table of contents in SGML |
| Date: | 2009-03-31 02:33:49 |
| Message-ID: | 200903310233.n2V2Xnb02553@momjian.us |
| Views: | Raw Message | Whole Thread | Download mbox | Resend email |
| Lists: | pgsql-docs |
Tom Lane wrote:
> Bruce Momjian <bruce(at)momjian(dot)us> 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 <bruce(at)momjian(dot)us> http://momjian.us
EnterpriseDB http://enterprisedb.com
+ If your life is a hard drive, Christ can be your backup. +
| From: | Peter Eisentraut <peter_e(at)gmx(dot)net> |
|---|---|
| To: | pgsql-docs(at)postgresql(dot)org |
| Cc: | Bruce Momjian <bruce(at)momjian(dot)us> |
| Subject: | Re: Adding an table of contents in SGML |
| Date: | 2009-03-31 20:48:34 |
| Message-ID: | 200903312348.35190.peter_e@gmx.net |
| Views: | Raw Message | Whole Thread | Download mbox | Resend email |
| Lists: | pgsql-docs |
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.