public inbox for [email protected]  

help / color / mirror / Atom feed

From: Andrew Dunstan <[email protected]>
To: Jim C. Nasby <[email protected]>
Cc: Tom Lane <[email protected]>
Cc: Markus Schaber <[email protected]>
Cc: [email protected]
Subject: Re: [HACKERS] timestamptz alias
Date: Tue, 03 Oct 2006 12:57:17 -0400
Message-ID: <[email protected]> (raw)
In-Reply-To: <[email protected]>
References: <[email protected]>
	<[email protected]>
	<[email protected]>
	<[email protected]>
	<[email protected]>
	<[email protected]>
	<[email protected]>

Jim C. Nasby wrote:
> On Tue, Oct 03, 2006 at 12:13:46PM -0400, Andrew Dunstan wrote:
>   
>>>
>>> Perhaps it'd be better to provide a small table of recognized type
>>> aliases, rather than inserting equivalent notes into three or four places.
>>>
>>> 	
>>>       
>> you mean like the table here?  
>> http://momjian.us/main/writings/pgsql/sgml/datatype.html
>>     
>
> An issue I've seen with the docs is that for chapters that have a lot of
> sections (such as 8), the section list at the start of each chapter
> fills the screen, so it's easy to miss the fact that there's more info
> beneath the list (which is wy presumably most folks never knew that
> table existed).
>
> I think the ideal way to handle this would be to put the table of
> contents in a side-bar and flow the text around it. But that could be a
> real bear to do in docbook/sgml, so perhaps it would be better to just
> force the TOC for each chapter onto it's own page (and ensure the
> overview/introduction text shows up in the TOC).
>   

I would like a frame driven version of the docs (c.f. doxygen, javadoc, 
etc.). The we would not need contents links at the top of each chapter 
like this. Navigating the HTML docs is less than pleasant. 
Unfortunately, I don't have enough time or docbook-fu to be able to do this.

cheers

andrew

view thread (18+ messages)  latest in thread

reply

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Reply to all the recipients using the --to and --cc options:
  reply via email

  To: [email protected]
  Cc: [email protected], [email protected], [email protected], [email protected]
  Subject: Re: [HACKERS] timestamptz alias
  In-Reply-To: <[email protected]>

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

This inbox is served by agora; see mirroring instructions
for how to clone and mirror all data and code used for this inbox