[Top][All Lists]
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[bug #32307] Documentation does not identify versions at which new featu
From: |
Paul D. Smith |
Subject: |
[bug #32307] Documentation does not identify versions at which new features became available |
Date: |
Mon, 02 May 2011 15:16:49 +0000 |
User-agent: |
Mozilla/5.0 (X11; U; Linux x86_64; en-US; rv:1.9.2.16) 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:
<http://savannah.gnu.org/bugs/?32307>
_______________________________________________
Message sent via/by Savannah
http://savannah.gnu.org/
- [bug #32307] Documentation does not identify versions at which new features became available,
Paul D. Smith <=