From: "Stefan Näwe" <stefan.naewe@xxxxxxxxxxxxxxxxxxxx>
Am 16.01.2014 22:14, schrieb Philip Oakley:
From: "Stefan Näwe" <stefan.naewe@xxxxxxxxxxxxxxxxxxxx>
[...]
I'd really like to see 'git help relnotes' working as well...
Stefan
Stefan,
Were you thinking that all the release notes would be quoted verbatim
in
the one long man page?
Or that it would be a set of links to each of the individual text
files
(see the ifdef::stalenotes[] in git/Documentation/git.txt)?
The latter allows individual release notes to be checked, but still
leaves folks with a difficult search problem if they want to find
when
some command was 'tweaked'.
Obviously, any method would need to be easy to maintain. And the
RelNotes symlink would need handling.
'git help relnotes' should show the current release note with
a link to the previous.
OK, that seems very sensible, as the concatenated release notes run to
15k lines!
Determining which is the current release note is possibly more
problematic, which should be when making the documentation.
And 'git help git' should link to the current release note.
In some sense that 'current' should be the same as the 'git --version',
but through an assumption of a common distribution of git and the
documentation, rather than any run time determination.
At the moment the Documenation/git.txt 'stalenotes' section could be
separated into its own file to act as the basis for the links, but as
yet I don't have a good view as to how the current release notes (with /
without maint notes?) would be embedded without a maintenance burden for
Junio.
Philip
--
To unsubscribe from this list: send the line "unsubscribe git" in
the body of a message to majordomo@xxxxxxxxxxxxxxx
More majordomo info at http://vger.kernel.org/majordomo-info.html