Skip site navigation (1) Skip section navigation (2)

Re: [GENERAL] Documentation quality WAS: interesting

From: Dennis Gearon <gearond(at)cvc(dot)net>
To: nolan(at)celery(dot)tssi(dot)com
Cc: Josh Berkus <josh(at)agliodbs(dot)com>,"'Advocacy PostgreSQL'" <pgsql-advocacy(at)postgresql(dot)org>,"'PostgreSQL-general'" <pgsql-general(at)postgresql(dot)org>
Subject: Re: [GENERAL] Documentation quality WAS: interesting
Date: 2003-06-24 15:01:56
Message-ID: 3EF867E4.9070700@cvc.net (view raw or flat)
Thread:
Lists: pgsql-advocacypgsql-docspgsql-general
There are MANY browsers that come with Linux nowadays. the one mentioned, Lynx, is text based, so you don't even have to have X running, or installed.

nolan(at)celery(dot)tssi(dot)com wrote:

>>??? You can look at an HTML file directy with any browser.  If you're SSH-ing 
>>in to a remote system, use Lynx.  Though I agree that providing both man and 
>>html would be nicer.
> 
> 
> Try accessing a HTML file on a Linux system from a PC-based browser.  
> 
> Unless you have some kind of file sharing software running, which I 
> generally don't because the only times I've ever been hacked into they 
> got in through file sharing ports, you can't get there from here.
>  
> 
>>O'Reilly seems to be pretty hit-and-miss on this account.  The Perl books are 
>>well-indexed, but "SQL in a Nutshell" has *no* index, perhaps because 
>>O'Reilly thought (wrongly) that it didn't need one because of the 
>>dictionary-like format.  The O'Reilly label is not a guarentee of quality, 
>>just a general indicator.
> 
> 
> I think the 'Nutshell' books are a different breed of cat, none of them
> have ever had indexes worth mentioning.
> 
> 
>>Authors seldom do the indexes themselves, as indexing is a black art known to 
>>few (and I have yet to see a really good index prepared by the author -- 
> 
> 
> I've been somewhat involved in three book projects (two textbooks and
> one rule book), in all three case the authors did their own index.  Maybe
> I've just had a good run of luck on the O'Reilly books I've bought, or maybe
> I haven't bought as many of them in the last three or four years as I used
> to.  
> --
> Mike Nolan
> 
> ---------------------------(end of broadcast)---------------------------
> TIP 1: subscribe and unsubscribe commands go to majordomo(at)postgresql(dot)org
> 


In response to

pgsql-docs by date

Next:From: scott.marloweDate: 2003-06-24 15:08:12
Subject: Re: [GENERAL] Documentation quality WAS: interesting
Previous:From: Tim HawkinsDate: 2003-06-24 14:54:47
Subject: Re: [GENERAL] Documentation quality WAS: interesting

pgsql-advocacy by date

Next:From: scott.marloweDate: 2003-06-24 15:08:12
Subject: Re: [GENERAL] Documentation quality WAS: interesting
Previous:From: Tim HawkinsDate: 2003-06-24 14:54:47
Subject: Re: [GENERAL] Documentation quality WAS: interesting

pgsql-general by date

Next:From: scott.marloweDate: 2003-06-24 15:08:12
Subject: Re: [GENERAL] Documentation quality WAS: interesting
Previous:From: Reuben D. BudiardjaDate: 2003-06-24 14:58:04
Subject: Error with word 'desc'

Privacy Policy | About PostgreSQL
Copyright © 1996-2014 The PostgreSQL Global Development Group