> On Friday 07 November 2003 3:56 pm, you wrote:
> [ On Friday, November 7, 2003 at 14:58:50 (+0100), Michal Pasternak
> wrote: ]
>
> > Subject: Re: hier(7) silent on pkg documentation
> >
> > Well, for me, it is very predictable, than when I want to read
> > PostgreSQL guide with HTML browser, I should go to
> > /usr/pkg/share/doc/html/postgresql.
>
> The uniform, predictable, location of the documentation is very
> important.  The file format of the documentation _MUST_ come second,
> if ever, and ideally it should be only a filename suffix.
>
Exactly - how do you find the docs if you don't know what format they 
are in? Personally, I dont much care what format the docs are in, it 
doesn't matter a jot if you cant find them anyway!

Perhaps it would be nice to have a tool which transparently yeilds docs 
in the format you prefer! Kind of like a link, but dynamically 
translating. <I dont know how it would be implemented> ie
click on man.html and you get an html version created on the fly. Kind 
of like compressed man pages. 

Useless factoid: For some bizarre reason, the system used to highlight 
man pages doent agree with the VGA card on one of my servers. It makes 
the text invisible instead. Next time you read a man page, think how 
useful it would be with all the highlighted text deleted:-{

Andrew