Re[2]: A comment

[Pavel Tsekov]

Hello Maurizio,

Tuesday, March 12, 2002, 7:43:12 AM, you wrote:

ML> 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.

ML> _YOU_ should know better what you are speaking about.  First: THERE IS NO
ML> HTML FILE in commoncpp2-0.99.1.tar.gz .

As I said - I assumed to much... In 1.x.x releases all the docu was
included with the distrubuted tarball. As David explained, this is no
longer the case and I was not aware of the fact.

ML> And - second: you are suggesting that to learn C or C++ a feasible
ML> solution is to have a look at the source of gcc?  Really?  YMMV, but when
ML> I am concerned --- I like *manuals*.

Nope - this has nothing to do with GCC and its sources. CommonC++
documentation is created from comments inside its sources. So the
documentation is actually contained in the sourcefiles.