Re: Inconsistencies in our approach
On Mon, 18 Aug 2003 17:06:49 +0300, Richard Braakman <email@example.com> said:
> On Thu, Aug 07, 2003 at 04:33:05PM -0500, John Goerzen wrote:
>> I will grant that these definitions are imperfect and improbable
>> arguments could be lodged against them; at the same time, I believe
>> that reasonable people not engaging in a Jesuit exercise to find
>> logical needles in a haystack of common sense are able to tell the
>> difference between a manpage and a C source file.
Could you be bothered to demonstrate such discernment? The
page http://www.stdc.com/QMS/documentation/ belongs to an old
project of mine; could you tell the documentation apart from the
code? I can also send, on request, the full set of man pages
generated (I think there are 350+ man pages, so attaching them to
this mail is going to be a problem for many people). (For the record,
the source code -- the .h and .cpp files -- are the sole sources of
the HTML pages you see at that URL).
I would also suggest that you look at doxygen before making
assertions like this. Or are you suggesting that we sweep literate
programming under the rug while considering how we treat licensing of
content that we are planning on shipping on the official CD?
The only way I can see to distinguish them is to say that the
comments in a .cpp file are not code, and documentation, and may be
considered separately from the code itself [<humour>copyright blah
vlah -- you may distribute this program such that the code is under
the gpl, but the comments may not be modified oniota, they are under
the gfdl invariant clause</humour>]
None of our men are "experts." We have most unfortunately found it
necessary to get rid of a man as soon as he thinks himself an expert
-- because no one ever considers himself expert if he really knows his
job. A man who knows a job sees so much more to be done than he has
done, that he is always pressing forward and never gives up an instant
of thought to how good and how efficient he is. Thinking always
ahead, thinking always of trying to do more, brings a state of mind in
which nothing is impossible. The moment one gets into the "expert"
state of mind a great number of things become impossible. From Henry
Ford Sr., "My Life and Work"
Manoj Srivastava <firstname.lastname@example.org> <http://www.debian.org/%7Esrivasta/>
1024R/C7261095 print CB D9 F4 12 68 07 E4 05 CC 2D 27 12 1D F5 E8 6E
1024D/BF24424C print 4966 F272 D093 B493 410B 924B 21BA DABB BF24 424C