From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED!not-for-mail From: Richard Stallman Newsgroups: gmane.emacs.devel 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 Message-ID: References: <87bmj6dda0.fsf@linux-m68k.org> <87vahe911g.fsf@lifelogs.com> <87374id7jy.fsf@linux-m68k.org> <877ett8g7k.fsf@lifelogs.com> <87a7yn7tqp.fsf@lifelogs.com> <878te75xa1.fsf@lifelogs.com> <87ind6l2tt.fsf@lifelogs.com> <877etklvsa.fsf@lifelogs.com> <83y3m0pv8u.fsf@gnu.org> <86608msw0h.fsf@dod.no> <838tdiet25.fsf@gnu.org> <87y3li4vh7.fsf@telefonica.net> <87efnan46u.fsf@linux-m68k.org> <86wp12qtgo.fsf@dod.no> <83tvw6chqv.fsf@gnu.org> <86shbprix7.fsf_-_@dod.no> <7c7503b4-1f82-8a25-fedd-c61c3e7629f6@cs.ucla.edu> Reply-To: rms@gnu.org NNTP-Posting-Host: blaine.gmane.org Content-Type: text/plain; charset=Utf-8 X-Trace: blaine.gmane.org 1515466457 5867 195.159.176.226 (9 Jan 2018 02:54:17 GMT) X-Complaints-To: usenet@blaine.gmane.org NNTP-Posting-Date: Tue, 9 Jan 2018 02:54:17 +0000 (UTC) Cc: sb@dod.no, emacs-devel@gnu.org To: Paul Eggert Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Tue Jan 09 03:54:13 2018 Return-path: Envelope-to: ged-emacs-devel@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by blaine.gmane.org with esmtp (Exim 4.84_2) (envelope-from ) id 1eYk3D-0000qE-5N for ged-emacs-devel@m.gmane.org; Tue, 09 Jan 2018 03:54:07 +0100 Original-Received: from localhost ([::1]:48593 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1eYk5C-000427-Mp for ged-emacs-devel@m.gmane.org; Mon, 08 Jan 2018 21:56:10 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:57952) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1eYk4D-00041f-L1 for emacs-devel@gnu.org; Mon, 08 Jan 2018 21:55:13 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1eYk4C-0006dj-R2 for emacs-devel@gnu.org; Mon, 08 Jan 2018 21:55:09 -0500 Original-Received: from fencepost.gnu.org ([2001:4830:134:3::e]:47737) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1eYk3g-0006LV-5B; Mon, 08 Jan 2018 21:54:36 -0500 Original-Received: from rms by fencepost.gnu.org with local (Exim 4.82) (envelope-from ) id 1eYk3f-0000ze-NR; Mon, 08 Jan 2018 21:54:35 -0500 In-reply-to: <7c7503b4-1f82-8a25-fedd-c61c3e7629f6@cs.ucla.edu> (message from Paul Eggert on Sun, 7 Jan 2018 20:22:28 -0800) X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 2001:4830:134:3::e X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.21 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Original-Sender: "Emacs-devel" Xref: news.gmane.org gmane.emacs.devel:221740 Archived-At: [[[ 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.