Re: Using VC for change descriptions

[Richard Stallman]

[[[ To any NSA and FBI agents reading my email: please consider    ]]]
[[[ whether defending the US Constitution against all enemies,     ]]]
[[[ foreign or domestic, requires you to follow Snowden's example. ]]]

  > It's important to have commit messages that provide that high-level 
  > overview.  The problem I'm concerned with is that the ChangeLog format 
  > forces descriptions at the level of individual files and named entities 
  > therein, and for many changes that's not a high-level overview, it's a 
  > low-level repetition of the diffs in English,

Although it might seem to be a repetition, it actually adds something:
the names of the entities that were changed.  That is a crucial piece
of information that isn't in the diff.

Thus, the question of whether ChangeLog files are truly superfluous
reduces to the question of whether we can regenerate this crucial
information from the repository.


-- 
Dr Richard Stallman
President, Free Software Foundation (https://gnu.org, https://fsf.org)
Internet Hall-of-Famer (https://internethalloffame.org)
Skype: No way! See https://stallman.org/skype.html.