From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Stefan Monnier Newsgroups: gmane.emacs.devel Subject: Re: Summarizing the purpose of a change. Date: Sun, 22 Nov 2009 20:53:02 -0500 Message-ID: References: <87iqd4tkv4.fsf@red-bean.com> <20091121121950.GB2021@muc.de> <834ooooxp6.fsf@gnu.org> <87r5rqbihq.fsf@red-bean.com> NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Trace: ger.gmane.org 1258941204 7832 80.91.229.12 (23 Nov 2009 01:53:24 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Mon, 23 Nov 2009 01:53:24 +0000 (UTC) Cc: Alan Mackenzie , Eli Zaretskii , emacs-devel@gnu.org To: Karl Fogel Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Mon Nov 23 02:53:16 2009 Return-path: Envelope-to: ged-emacs-devel@m.gmane.org Original-Received: from lists.gnu.org ([199.232.76.165]) by lo.gmane.org with esmtp (Exim 4.50) id 1NCO7A-0002Q9-5b for ged-emacs-devel@m.gmane.org; Mon, 23 Nov 2009 02:53:16 +0100 Original-Received: from localhost ([127.0.0.1]:33227 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1NCO79-0008Cz-GP for ged-emacs-devel@m.gmane.org; Sun, 22 Nov 2009 20:53:15 -0500 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1NCO74-0008CJ-Hk for emacs-devel@gnu.org; Sun, 22 Nov 2009 20:53:10 -0500 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1NCO71-0008Bl-0p for emacs-devel@gnu.org; Sun, 22 Nov 2009 20:53:10 -0500 Original-Received: from [199.232.76.173] (port=42738 helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1NCO70-0008Bi-Qw for emacs-devel@gnu.org; Sun, 22 Nov 2009 20:53:06 -0500 Original-Received: from ironport2-out.teksavvy.com ([206.248.154.183]:65249 helo=ironport2-out.pppoe.ca) by monty-python.gnu.org with esmtp (Exim 4.60) (envelope-from ) id 1NCO6z-0003AD-0h; Sun, 22 Nov 2009 20:53:05 -0500 X-IronPort-Anti-Spam-Filtered: true X-IronPort-Anti-Spam-Result: ApsEANZ5CUvO+IIa/2dsb2JhbACBTdIHhDwEigI X-IronPort-AV: E=Sophos;i="4.47,268,1257138000"; d="scan'208";a="49822192" Original-Received: from 206-248-130-26.dsl.teksavvy.com (HELO ceviche.home) ([206.248.130.26]) by ironport2-out.pppoe.ca with ESMTP; 22 Nov 2009 20:53:03 -0500 Original-Received: by ceviche.home (Postfix, from userid 20848) id C8E05B40C9; Sun, 22 Nov 2009 20:53:02 -0500 (EST) In-Reply-To: <87r5rqbihq.fsf@red-bean.com> (Karl Fogel's message of "Sun, 22 Nov 2009 11:02:25 -0600") User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/23.1.50 (gnu/linux) X-detected-operating-system: by monty-python.gnu.org: Genre and OS details not recognized. X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Original-Sender: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.devel:117531 Archived-At: > So far, everyone who's chimed in has basically said "Yeah, I try to do > this". But my question is more about making it policy, in the sense > that of making it appropriate to follow up to change saying "How about a > summary line for that?" We could try it. I think adding such a summary line can be useful, indeed. We could try to make it more of a convention, indeed. As somebody else pointed out, many VCS have special support for such "summary line". And after all, we already do the same for docstrings. Let's try it for a while, Stefan