>>>>> Thomas Bushnell, BSG writes:
TBB> OKUJI Yoshinori <[EMAIL PROTECTED]> writes:
>> For now, I'm afraid of two things about that. One of these is that
>> people often write documents and comments differently, of course,
>> intentionally.
TBB> I agree with Okuji here. The job of the comment in a header
TBB> file is to remind a programmer what the interface is. The job
TBB> of the manual is to explain the interface.
Okay, I can agree with that. The constraint I was operating under was
to give some way of indicating to a documentor when an interface
change has been made, and indicating to the coder when a description
has been clarified.
Perhaps just `diffmon' is good enough, and is already as specific as
possible.
--
Gordon Matzigkeit <[EMAIL PROTECTED]> //\ I'm a FIG (http://fig.org/)
Committed to freedom and diversity \// I use GNU (http://fig.org/gnu/)
_______________________________________________
Bug-hurd mailing list
[EMAIL PROTECTED]
http://mail.gnu.org/mailman/listinfo/bug-hurd
