bug-standards
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: Script to generate ChangeLogs automatically


From: Richard Stallman
Subject: Re: Script to generate ChangeLogs automatically
Date: Wed, 28 Nov 2018 19:14:49 -0500

[[[ 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. ]]]

  >      I think you're arguing about a non-issue.
  >      Remember what this feature is meant for.
  >      It is to make it possible to find  which
  >      changes affected a particular entity.
     
  > I think I might have mentioned it before, but IMO it would be much
  > more useful to know *why* a particular entity was changed.  

The idea nowadays is that the commit log entry explains the purpose
and logic of the change.  Meanwhile, comments in the code explain
why the code is written the way it is.

The issue that remains is that it is sometimes necessary to find which
commits changed some specific entity in the code.  The current format
of change logging gives a way to do that.  The issue is how to arrange
to do that if we no longer itemize the entities changed by each
commit.

-- 
Dr Richard Stallman
President, Free Software Foundation (https://gnu.org, https://fsf.org)
Internet Hall-of-Famer (https://internethalloffame.org)





reply via email to

[Prev in Thread] Current Thread [Next in Thread]