ChangeLog indentation
adah@netstd.com
adah@netstd.com
Tue Apr 9 23:08:00 GMT 2002
I am absolutely certain about the correctness of the facts you mentioned.
You are the authority here. However:
- Telling people to model is not enough. You yourself predicted my
failure. Why not a better document? -- Of course, my statement is invalid
if only one newbie (I) made mistakes. I don't suppose so.
- The point is not about correctness. People are human instead of
machines. People are easy to be misled if not already knowing the correct
thing to do. For you it must be simple and straightforward, but not for
everybody who wants to contribute. -- To say the details, I thought I need
to "model" the content but not the format; the concept of CVS ChangeLog
interferes; the guidelines talk of bracketing function names but nothing
about structs....
Somebody else mentioned TABs. I thought he is right, but I am not sure
when reading your reply. I do not have to use a tab before the asterisk in
the ChangeLog?
Best regards,
Wu Yongwei
I just deleted a long reply to this message.
I realized that I'd just be repeating myself.
However, I'll try to briefly make a couple of points:
- The contrib web page says to model your entry on winsup/ChangeLog.
- If you can download files via the web, you can download a ChangeLog
file.
- AFAICT, I never mentioned anything about tabs. I only said that
Ralf Habacker got the indentation wrong. You should go back and
actually look at the changes that I made. It wasn't the lack of
a tab that I was referring to. It was the "hanging indent" style.
I actually made a couple of other changes there too. All of the
changes were for problems listed under "Improper ChangeLog
formatting".
That's it for me.
cgf
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://cygwin.com/pipermail/cygwin-patches/attachments/20020409/fd79b1e4/attachment.htm>
More information about the Cygwin-patches
mailing list