[Top][All Lists]
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re[2]: A comment
From: |
Pavel Tsekov |
Subject: |
Re[2]: A comment |
Date: |
Mon, 11 Mar 2002 13:22:56 +0100 |
It seems I assumed too much :(
Sorry, if my post sounded too harsh...
Monday, March 11, 2002, 1:33:40 PM, you wrote:
DS> There is a "make" target, "make doxy", which rebuilds the browsable
DS> documentation from source if you have doxygen installed. We were asked to
DS> remove the documentation from the source distribution because the class
DS> diagrams are constructed using gif's. The doxygen author is in the
DS> process of creating a non-gif capable release of doxygen, and we expect to
DS> distribute pregenerated documentation with the release tarballs again.
DS> On Mon, 11 Mar 2002, Pavel Tsekov wrote:
>> Hello Maurizio,
>>
>> Monday, March 11, 2002, 11:41:19 AM, you wrote:
>>
>> ML> (Any comments, questions, patches, and/or bug reports should be sent to
>> ML> "address@hidden".)
>>
>> ML> You assert in your commoncpp2-0.99.1/README: "Extensive class-by-class
>> ML> functional documentation is also provided in browsable form in the "doc"
>> ML> directory.". This is just plain wrong.
>>
>> ML> I am trying to use your socket classes, but an extensive browsing inside
>> ML> doc/man3 has only originated frustration. Either supply an _usable_
>> ML> manual, or avoid to at all to distribute a library. Period.
>>
>> Well, maybe you should try harder. IMO, 'browsable' implies using a
>> browser - try doc/html. Also you can take a look at the source files.