From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED.blaine.gmane.org!not-for-mail From: Juri Linkov Newsgroups: gmane.emacs.devel Subject: ChangeLog styles (was: master 7e387c9: * lisp/man.el (Man-width-max): New defcustom (bug#32536, bug#9385)) Date: Sun, 08 Dec 2019 23:45:09 +0200 Organization: LINKOV.NET Message-ID: <87o8wize3e.fsf@mail.linkov.net> References: <83zhg2d78w.fsf@gnu.org> Mime-Version: 1.0 Content-Type: text/plain Injection-Info: blaine.gmane.org; posting-host="blaine.gmane.org:195.159.176.226"; logging-data="25849"; mail-complaints-to="usenet@blaine.gmane.org" User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/27.0.50 (x86_64-pc-linux-gnu) Cc: emacs-devel@gnu.org To: Eli Zaretskii Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Sun Dec 08 22:59:47 2019 Return-path: Envelope-to: ged-emacs-devel@m.gmane.org Original-Received: from lists.gnu.org ([209.51.188.17]) by blaine.gmane.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.89) (envelope-from ) id 1ie4af-0006ap-9k for ged-emacs-devel@m.gmane.org; Sun, 08 Dec 2019 22:59:45 +0100 Original-Received: from localhost ([::1]:33712 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1ie4ad-0005To-O0 for ged-emacs-devel@m.gmane.org; Sun, 08 Dec 2019 16:59:43 -0500 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:44045) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1ie4Xj-0003Nc-Qg for emacs-devel@gnu.org; Sun, 08 Dec 2019 16:56:45 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1ie4Xe-0004BT-Pf for emacs-devel@gnu.org; Sun, 08 Dec 2019 16:56:43 -0500 Original-Received: from antelope.elm.relay.mailchannels.net ([23.83.212.4]:31255) by eggs.gnu.org with esmtps (TLS1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1ie4Xc-0003sd-JR; Sun, 08 Dec 2019 16:56:36 -0500 X-Sender-Id: dreamhost|x-authsender|jurta@jurta.org Original-Received: from relay.mailchannels.net (localhost [127.0.0.1]) by relay.mailchannels.net (Postfix) with ESMTP id 24FE42102C; Sun, 8 Dec 2019 21:56:35 +0000 (UTC) Original-Received: from pdx1-sub0-mail-a35.g.dreamhost.com (100-96-6-199.trex.outbound.svc.cluster.local [100.96.6.199]) (Authenticated sender: dreamhost) by relay.mailchannels.net (Postfix) with ESMTPA id B475B215F9; Sun, 8 Dec 2019 21:56:34 +0000 (UTC) X-Sender-Id: dreamhost|x-authsender|jurta@jurta.org Original-Received: from pdx1-sub0-mail-a35.g.dreamhost.com ([TEMPUNAVAIL]. [64.90.62.162]) (using TLSv1.2 with cipher DHE-RSA-AES256-GCM-SHA384) by 0.0.0.0:2500 (trex/5.18.5); Sun, 08 Dec 2019 21:56:35 +0000 X-MC-Relay: Neutral X-MailChannels-SenderId: dreamhost|x-authsender|jurta@jurta.org X-MailChannels-Auth-Id: dreamhost X-Belong-Stretch: 782dff20362ccd48_1575842194958_2738596491 X-MC-Loop-Signature: 1575842194958:3327758829 X-MC-Ingress-Time: 1575842194958 Original-Received: from pdx1-sub0-mail-a35.g.dreamhost.com (localhost [127.0.0.1]) by pdx1-sub0-mail-a35.g.dreamhost.com (Postfix) with ESMTP id 751E7A123E; Sun, 8 Dec 2019 13:56:29 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha1; c=relaxed; d=jurta.org; h=from:to:cc :subject:references:date:in-reply-to:message-id:mime-version :content-type; s=jurta.org; bh=ae4SRgBEgYyLBEgZYKSYUFDWAfo=; b=Q PuhdCNkPWO1cCuTu6SIYacEVg+GkbwmK+k6E0WUteZIYBk9YfXgMN/X+CzER+e5H 7NWT6fv0UkyrSFcMJ9cF8zfmCnES53EWFpZqQvTcMlPUhr9tJZxf95ZppH/d7UOO mXHQCSDGKdWIMBL6FziJSCN82VA5DKOXv5GiFyUxXM= Original-Received: from mail.jurta.org (m91-129-96-42.cust.tele2.ee [91.129.96.42]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) (Authenticated sender: jurta@jurta.org) by pdx1-sub0-mail-a35.g.dreamhost.com (Postfix) with ESMTPSA id 7F1B081F1D; Sun, 8 Dec 2019 13:56:27 -0800 (PST) X-DH-BACKEND: pdx1-sub0-mail-a35 In-Reply-To: <83zhg2d78w.fsf@gnu.org> (Eli Zaretskii's message of "Sun, 08 Dec 2019 20:03:59 +0200") X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] [fuzzy] X-Received-From: 23.83.212.4 X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.23 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:243247 Archived-At: > P.S. And please do not "optimize" the log messages the way you did in > this commit: it will make the generated ChangeLog entry look wrong. > Please only use the ChangeLog-style text in the header line of the log > entry if it is the entire text; otherwise please come up with some > summary there, and leave the ChangeLog-style text in its original > form, without an empty line in between. TIA. This is not optimization. The first line of this log message is a complete sentence. It provides all information about the change, answering the questions: WHERE and WHAT. WHERE: * lisp/man.el (Man-width-max) WHAT: New defcustom If even adds the references to bug reports: bug#32536, bug#9385 Many log messages don't provide the information about location of the change in their subject, so it's difficult to guess what files are affected by the change. For example, such log subject provides no clue about the affected package: Fix documentation of '-position' server command It's not clear what is a server command it's talking about. It takes additional efforts to output the full message to see that actually it meant the package lisp/server.el. Such subject would be much more clear: * lisp/server.el: Fix documentation of '-position' command