[bug #32307] Documentation does not identify versions at which new features became available

[Paul D. Smith]

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/