Message-ID: <4522966D.2080408@dunslane.net>
Date: Tue, 03 Oct 2006 12:57:17 -0400
From: Andrew Dunstan <andrew@dunslane.net>
User-Agent: Mozilla/5.0 (X11; U; Linux x86_64; en-US;
	rv:1.8.0.6) Gecko/20060804 Fedora/1.0.4-0.5.1.fc5 SeaMonkey/1.0.4
MIME-Version: 1.0
To: "Jim C. Nasby" <jim@nasby.net>
CC: Tom Lane <tgl@sss.pgh.pa.us>, Markus Schaber <schabi@logix-tt.com>,
	pgsql-docs@postgresql.org
Subject: Re: [HACKERS] timestamptz alias
References: <45218F90.1050303@logix-tt.com>
	<794403F6-6CB5-4726-806C-5EF76D64C7E3@themactionfaction.com>
	<34B58049-42F3-468D-AA2A-AE79DC8FB244@decibel.org>
	<45222B63.2070608@logix-tt.com> <26117.1159889582@sss.pgh.pa.us>
	<45228C3A.2090704@dunslane.net> <20061003164715.GW81937@nasby.net>
In-Reply-To: <20061003164715.GW81937@nasby.net>
Content-Type: text/plain; charset=ISO-8859-1; format=flowed
Content-Transfer-Encoding: 7bit

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