[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[bug #32307] Documentation does not identify versions at which new featu
Paul D. Smith
[bug #32307] Documentation does not identify versions at which new features became available
Mon, 02 May 2011 15:16:49 +0000
Mozilla/5.0 (X11; U; Linux x86_64; en-US; rv:126.96.36.199) Gecko/20110323 Ubuntu/10.10 (maverick) Firefox/3.6.16
Follow-up Comment #2, bug #32307 (project make):
The primary intent of the GNU make manual is to be printed into a paper book.
Maybe that's anachronistic now, but I still am not terribly jazzed about the
idea of sprinkling little parenthetical comments throughout the text such as
"(added in version 3.81)" or whatever.
I can see a few alternatives:
1. Make use of footnotes. I wouldn't mind having a footnote marker next to a
feature that, in the footnote, said "Added in GNU make 3.81" or whatever. But
that might not be so convenient for online reading?
2. Add a new chapter to the GNU make manual that was essentially a shortened,
cleaned up version of the NEWS file with new features only. This would
collect all the information in one place.
3. Add the "added in .." text using markup to ensure it's only present in the
online formats, not in the printed formats.
Reply to this item at:
Message sent via/by Savannah
- [bug #32307] Documentation does not identify versions at which new features became available,
Paul D. Smith <=