emacs-devel
[Top][All Lists]
Advanced

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

Re: git history tracking across renames (and emacs support) (Was: The na


From: Richard Stallman
Subject: Re: git history tracking across renames (and emacs support) (Was: The name gnus-cloud.el)
Date: Mon, 08 Jan 2018 21:54:35 -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. ]]]

  > This is because code comments should explain the code, 
  > and not waste time explaining the code's history

Comments should state whatever will help future developers
do a good job.  If it's important for them to know why the code
should work this way, rather than some other way which was tried
in the past, then it's appropriate to explain in a comment.

  >    /* This variable used to be extern, but is static now.  */
  >    static pthread_t main_thread_id;

  > But such a comment would have been silly, 

As I explain in another message today, we don't suggest including
that silly comment.

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




reply via email to

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