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
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-advocacy pgsql-docs pgsql-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

Browse pgsql-advocacy by date

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

Browse pgsql-docs by date

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

Browse pgsql-general by date

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