From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Stephen Leake Newsgroups: gmane.emacs.devel Subject: Re: Your commit 7409a79 Date: Wed, 10 Dec 2014 03:26:39 -0600 Message-ID: <85388n97ow.fsf@stephe-leake.org> References: <83h9x917il.fsf@gnu.org> <85k324h0hg.fsf@stephe-leake.org> <83k324yv44.fsf@gnu.org> <85tx17dqzy.fsf@stephe-leake.org> <83y4qixhq8.fsf@gnu.org> <85r3w9bu3y.fsf@stephe-leake.org> <83mw6wwyl8.fsf@gnu.org> NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain X-Trace: ger.gmane.org 1418203668 5067 80.91.229.3 (10 Dec 2014 09:27:48 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Wed, 10 Dec 2014 09:27:48 +0000 (UTC) To: emacs-devel@gnu.org Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Wed Dec 10 10:27:42 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 1XydYb-0000iO-MD for ged-emacs-devel@m.gmane.org; Wed, 10 Dec 2014 10:27:41 +0100 Original-Received: from localhost ([::1]:44152 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1XydYa-0002ou-OK for ged-emacs-devel@m.gmane.org; Wed, 10 Dec 2014 04:27:40 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:56089) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1XydYG-0002nx-QK for emacs-devel@gnu.org; Wed, 10 Dec 2014 04:27:27 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1XydYA-0003Lw-2v for emacs-devel@gnu.org; Wed, 10 Dec 2014 04:27:20 -0500 Original-Received: from gproxy2-pub.mail.unifiedlayer.com ([69.89.18.3]:33870) by eggs.gnu.org with smtp (Exim 4.71) (envelope-from ) id 1XydY9-0003Li-T5 for emacs-devel@gnu.org; Wed, 10 Dec 2014 04:27:14 -0500 Original-Received: (qmail 10970 invoked by uid 0); 10 Dec 2014 09:27:09 -0000 Original-Received: from unknown (HELO cmgw2) (10.0.90.83) by gproxy2.mail.unifiedlayer.com with SMTP; 10 Dec 2014 09:27:09 -0000 Original-Received: from host114.hostmonster.com ([74.220.207.114]) by cmgw2 with id RlSz1p00C2UdiVW01lT2B5; Wed, 10 Dec 2014 02:27:09 -0700 X-Authority-Analysis: v=2.1 cv=Hd2HEE08 c=1 sm=1 tr=0 a=CQdxDb2CKd3SRg4I0/XZPQ==:117 a=CQdxDb2CKd3SRg4I0/XZPQ==:17 a=DsvgjBjRAAAA:8 a=f5113yIGAAAA:8 a=fNEgcOh0sVsA:10 a=9i_RQKNPAAAA:8 a=hEr_IkYJT6EA:10 a=jrwKn-8xaegA:10 a=A92cGCtB03wA:10 a=mDV3o1hIAAAA:8 a=wzf8qmpa23IK648gs0QA:9 a=AGuZ_lgX3aYA:10 Original-Received: from [70.94.38.149] (port=56797 helo=TAKVER) by host114.hostmonster.com with esmtpa (Exim 4.82) (envelope-from ) id 1XydXt-0002Zx-7o for emacs-devel@gnu.org; Wed, 10 Dec 2014 02:26:59 -0700 In-Reply-To: <83mw6wwyl8.fsf@gnu.org> (Eli Zaretskii's message of "Tue, 09 Dec 2014 18:57:07 +0200") User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/24.3.94 (windows-nt) X-Identified-User: {2442:host114.hostmonster.com:stephele:stephe-leake.org} {sentby:smtp auth 70.94.38.149 authed with stephen_leake@stephe-leake.org} X-detected-operating-system: by eggs.gnu.org: GNU/Linux 3.x X-Received-From: 69.89.18.3 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:179638 Archived-At: Eli Zaretskii writes: >> > CONTRIBUTE: Moved from etc/CONTRIBUTE. >> > >> > This is in preparation for restructuring of developer contribution >> > documents; see http:/ for the related discussion, >> > and see http:/ for the decision to move the file. >> > >> > This has a short summary line which tells enough in "git log" short >> > formats, and then the details below, including the rationale. >> > >> > But this all is a creative, stylistic issue, not something to be >> > codified in mandatory documents. There is no single solution to this; >> > as long as people choose a reasonable one, and don't goof with >> > misspellings or missing punctuation, they should be OK. > >> It's a big stretch to go from the examples in the Gnu coding standards >> to this example. There are some like this in ./Changelog; first one >> 2014-11-11 Eric S. Raymond , and that has a leading >> asterisk on the first line. > > Asterisks come from add-change-log-entry and friends, so it will not > be there if you just write free text, like I did above. > In any case, the asterisks are optional, IMO. http://www.gnu.org/prep/standards/html_node/Change-Log-Concepts.html last paragraph says asterisks are part of the required Changelog style. > From experience, the rules are not rigid. True, they are not consistently enforced. But a new developer needs a clear set of rules, so they know what they need to change in their habits from other projects. > You need to put the right information there, and make it in correct > English, and that's about all that's really required. Beyond that, > it's all about your perfectionism. That is not the impression I get from the mentoring comments on this list, and it is not what it says in CONTRIBUTE. -- -- Stephe