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: Generating the ChangeLog files from the commit messages Date: Tue, 18 Nov 2014 21:32:01 +0100 Message-ID: <87k32sl072.fsf@zigzag.favinet> References: <21606.10799.112099.788101@a1i15.kph.uni-mainz.de> <1753218.Ot8JCqssfN@descartes> <546AABCF.8030705@cs.ucla.edu> <9xioico2nm.fsf@fencepost.gnu.org> <83k32s9zm5.fsf@gnu.org> <546B8833.60505@cs.ucla.edu> Reply-To: emacs-devel@gnu.org NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: multipart/signed; boundary="=-=-="; micalg=pgp-sha1; protocol="application/pgp-signature" X-Trace: ger.gmane.org 1416342513 28465 80.91.229.3 (18 Nov 2014 20:28:33 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Tue, 18 Nov 2014 20:28:33 +0000 (UTC) To: emacs-devel@gnu.org Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Tue Nov 18 21:28:26 2014 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 1XqpNy-0001Ru-ER for ged-emacs-devel@m.gmane.org; Tue, 18 Nov 2014 21:28:26 +0100 Original-Received: from localhost ([::1]:55219 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1XqpNy-000259-2F for ged-emacs-devel@m.gmane.org; Tue, 18 Nov 2014 15:28:26 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:54240) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1XqpNc-0001yd-Uy for emacs-devel@gnu.org; Tue, 18 Nov 2014 15:28:10 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1XqpNW-00039p-A3 for emacs-devel@gnu.org; Tue, 18 Nov 2014 15:28:04 -0500 Original-Received: from smtp206.alice.it ([82.57.200.102]:57619) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1XqpNV-00039F-Sq for emacs-devel@gnu.org; Tue, 18 Nov 2014 15:27:58 -0500 Original-Received: from zigzag.favinet (80.180.3.187) by smtp206.alice.it (8.6.060.28) id 5440E1E108288D69 for emacs-devel@gnu.org; Tue, 18 Nov 2014 21:27:56 +0100 Original-Received: from ttn by zigzag.favinet with local (Exim 4.80) (envelope-from ) id 1XqpRb-0003L6-QI for emacs-devel@gnu.org; Tue, 18 Nov 2014 21:32:11 +0100 Mail-Followup-To: emacs-devel@gnu.org In-Reply-To: <546B8833.60505@cs.ucla.edu> (Paul Eggert's message of "Tue, 18 Nov 2014 09:56:03 -0800") User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/25.0.50 (gnu/linux) X-detected-operating-system: by eggs.gnu.org: Genre and OS details not recognized. X-Received-From: 82.57.200.102 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:177649 Archived-At: --=-=-= Content-Type: text/plain Content-Transfer-Encoding: quoted-printable () Paul Eggert () Tue, 18 Nov 2014 09:56:03 -0800 Glenn's objection (2) was that he sometimes wants more details in the commit log than in the ChangeLog. He's right, this is a downside, but my own feeling is that it's a minor one. We shouldn't be spending so much time on ChangeLog files that we worry about this sort of thing. Just write a decent entry and move on. If we settle on an "official commit log format" that sets aside an area for such details, then that area can be mechanically omitted when generating the ChangeLog file. I'm partial to: TITLE PARAGRAPH-1 PARAGRAPH-2 * FILE (FUNC): DESCRIPTION-OF-CHANGE. The PARAGRAPHs are easily distinguishable; the generated ChangeLog would be: YYYY-MM-DD AUTHOR TITLE * FILE (FUNC): DESCRIPTION-OF-CHANGE. (modulo some bol TABs), which is the current practice AFAICT. =2D-=20 Thien-Thi Nguyen GPG key: 4C807502 (if you're human and you know it) read my lisp: (responsep (questions 'technical) (not (via 'mailing-list))) =3D> nil --=-=-= Content-Type: application/pgp-signature; name="signature.asc" -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.4.12 (GNU/Linux) iEYEARECAAYFAlRrrMQACgkQZwMiJEyAdQIxywCg0wNRL0EyAEjo/8Jck3uBDwSt wn0AnRLRUfCkcP/rxbLMLFtNc46QIIFD =t06i -----END PGP SIGNATURE----- --=-=-=--