From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Thien-Thi Nguyen Newsgroups: gmane.emacs.devel Subject: Re: Proposal: 'struct window' cleanup Date: Tue, 22 May 2012 09:40:35 +0200 Message-ID: <87txz864uk.fsf@gnuvola.org> References: <4FBA5060.7070702@yandex.ru> <4FBB3B62.4070504@yandex.ru> NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain X-Trace: dough.gmane.org 1337672374 8994 80.91.229.3 (22 May 2012 07:39:34 GMT) X-Complaints-To: usenet@dough.gmane.org NNTP-Posting-Date: Tue, 22 May 2012 07:39:34 +0000 (UTC) Cc: emacs-devel@gnu.org To: Dmitry Antipov Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Tue May 22 09:39:33 2012 Return-path: Envelope-to: ged-emacs-devel@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by plane.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1SWjgo-0007EW-K0 for ged-emacs-devel@m.gmane.org; Tue, 22 May 2012 09:39:30 +0200 Original-Received: from localhost ([::1]:39586 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1SWjgo-0002hC-5R for ged-emacs-devel@m.gmane.org; Tue, 22 May 2012 03:39:30 -0400 Original-Received: from eggs.gnu.org ([208.118.235.92]:53401) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1SWjgg-0002bS-Nf for emacs-devel@gnu.org; Tue, 22 May 2012 03:39:28 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1SWjga-0003Hf-A0 for emacs-devel@gnu.org; Tue, 22 May 2012 03:39:22 -0400 Original-Received: from smtp207.alice.it ([82.57.200.103]:47731) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1SWjgZ-0003FQ-Ta for emacs-devel@gnu.org; Tue, 22 May 2012 03:39:16 -0400 Original-Received: from ambire (95.249.52.141) by smtp207.alice.it (8.6.023.02) id 4F05A6650FBC4E09; Tue, 22 May 2012 09:38:55 +0200 Original-Received: from ttn by ambire with local (Exim 4.72) (envelope-from ) id 1SWjhr-0000ZU-NG; Tue, 22 May 2012 09:40:35 +0200 In-Reply-To: <4FBB3B62.4070504@yandex.ru> (Dmitry Antipov's message of "Tue, 22 May 2012 11:08:18 +0400") User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/24.0.92 (gnu/linux) X-detected-operating-system: by eggs.gnu.org: Genre and OS details not recognized. X-Received-From: 82.57.200.103 X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.14 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-bounces+ged-emacs-devel=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.devel:150601 Archived-At: () Dmitry Antipov () Tue, 22 May 2012 11:08:18 +0400 [...] a lot of small and simple changes. Is there a convenient way to document them in ChangeLog? Perhaps you could say: TITLE * window.h (struct window): Rename member OLD-NAME-1 to NEW-NAME-1, converting its type to NEW-TYPE, and moving it to NEW-PLACE. Likewise for OLD-NAME-2 -> NEW-NAME-2, ... * FILE-1.c (first_func): Use new names, adjusting for NEW-TYPE. (second_func, third_func, fourth_func, ...) (penultimate_func, nth_func): Likewise. * FILE-2.c (first_func, second_func, third_func, fourth_func, ...) (penultimate_func, nth_func): Likewise. where TITLE is the optional (but recommended) one-line description of the change. This way is most concise, if not completely convenient.