From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Thibault Polge Newsgroups: gmane.emacs.bugs Subject: bug#52018: 28.0.60; Improve documentation for compilation-finish-functions Date: Sun, 21 Nov 2021 20:44:46 +0100 Message-ID: <87sfvpguoh.fsf@thb.lt> References: <871r39hjj3.fsf@thb.lt> <83sfvpr17k.fsf@gnu.org> <87wnl1gwc7.fsf@thb.lt> <83ilwlqpiw.fsf@gnu.org> Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="36956"; mail-complaints-to="usenet@ciao.gmane.io" Cc: 52018@debbugs.gnu.org To: Eli Zaretskii Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Sun Nov 21 20:45:37 2021 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane-mx.org Original-Received: from lists.gnu.org ([209.51.188.17]) by ciao.gmane.io with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1mosmP-0009Tn-7t for geb-bug-gnu-emacs@m.gmane-mx.org; Sun, 21 Nov 2021 20:45:37 +0100 Original-Received: from localhost ([::1]:40838 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1mosmO-0002Rq-6l for geb-bug-gnu-emacs@m.gmane-mx.org; Sun, 21 Nov 2021 14:45:36 -0500 Original-Received: from eggs.gnu.org ([209.51.188.92]:58686) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1moslq-0002Q0-GF for bug-gnu-emacs@gnu.org; Sun, 21 Nov 2021 14:45:02 -0500 Original-Received: from debbugs.gnu.org ([209.51.188.43]:34528) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1moslq-0007Xp-77 for bug-gnu-emacs@gnu.org; Sun, 21 Nov 2021 14:45:02 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1moslq-000529-3q for bug-gnu-emacs@gnu.org; Sun, 21 Nov 2021 14:45:02 -0500 X-Loop: help-debbugs@gnu.org Resent-From: Thibault Polge Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sun, 21 Nov 2021 19:45:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 52018 X-GNU-PR-Package: emacs Original-Received: via spool by 52018-submit@debbugs.gnu.org id=B52018.163752389519321 (code B ref 52018); Sun, 21 Nov 2021 19:45:02 +0000 Original-Received: (at 52018) by debbugs.gnu.org; 21 Nov 2021 19:44:55 +0000 Original-Received: from localhost ([127.0.0.1]:46074 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1moslj-00051Z-HE for submit@debbugs.gnu.org; Sun, 21 Nov 2021 14:44:55 -0500 Original-Received: from 14.mo581.mail-out.ovh.net ([178.33.251.19]:36995) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1moslh-00051P-GP for 52018@debbugs.gnu.org; Sun, 21 Nov 2021 14:44:54 -0500 Original-Received: from player788.ha.ovh.net (unknown [10.109.146.143]) by mo581.mail-out.ovh.net (Postfix) with ESMTP id E021122090 for <52018@debbugs.gnu.org>; Sun, 21 Nov 2021 19:44:51 +0000 (UTC) Original-Received: from thb.lt (lfbn-idf3-1-453-168.w83-114.abo.wanadoo.fr [83.114.45.168]) (Authenticated sender: thibault@thb.lt) by player788.ha.ovh.net (Postfix) with ESMTPSA id A96742480A2A4; Sun, 21 Nov 2021 19:44:49 +0000 (UTC) Authentication-Results: garm.ovh; auth=pass (GARM-105G0069e68a697-7d8e-4d73-ad5e-9f7f07a868e6, 43582B99CDFB24B69BBBFB8E6FA79B8263DCE2E8) smtp.auth=thibault@thb.lt X-OVh-ClientIp: 83.114.45.168 In-Reply-To: <83ilwlqpiw.fsf@gnu.org> X-Ovh-Tracer-Id: 11651656662844162892 X-VR-SPAMSTATE: OK X-VR-SPAMSCORE: -100 X-VR-SPAMCAUSE: gggruggvucftvghtrhhoucdtuddrgedvuddrgedvgddufedvucetufdoteggodetrfdotffvucfrrhhofhhilhgvmecuqfggjfdpvefjgfevmfevgfenuceurghilhhouhhtmecuhedttdenucesvcftvggtihhpihgvnhhtshculddquddttddmnecujfgurhephffvufgjfhffkfggtgfgsehtqhertddttdejnecuhfhrohhmpefvhhhisggruhhlthcurfholhhgvgcuoehthhhisggruhhlthesthhhsgdrlhhtqeenucggtffrrghtthgvrhhnpeehfeffffffveelieeukefhgeeuueetuedvudeljedujeefuddvveeftdejtdejfeenucfkpheptddrtddrtddrtddpkeefrdduudegrdeghedrudeikeenucevlhhushhtvghrufhiiigvpedtnecurfgrrhgrmhepmhhouggvpehsmhhtphhouhhtpdhhvghlohepphhlrgihvghrjeekkedrhhgrrdhovhhhrdhnvghtpdhinhgvtheptddrtddrtddrtddpmhgrihhlfhhrohhmpehthhhisggruhhlthesthhhsgdrlhhtpdhrtghpthhtohephedvtddukeesuggvsggsuhhgshdrghhnuhdrohhrgh X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list X-BeenThere: bug-gnu-emacs@gnu.org List-Id: "Bug reports for GNU Emacs, the Swiss army knife of text editors" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Original-Sender: "bug-gnu-emacs" Xref: news.gmane.io gmane.emacs.bugs:220589 Archived-At: > Maybe so, but I'm looking at the calls of compilation-handle-exit, and > the callers do all kinds of transformations with the original status, > so I think documenting what happens to be more-or-less correct now is > fragile. I assumed this interface was reasonably stable, I may be wrong. > Why do you think this addition is of such great importance to have it > spelled out in the doc string? All the docstring currently states about that argument is that it's =E2=80= =9Ca string describing how the process finished=E2=80=9D, which requires users to determine its possible values through trial and error, or by digging into the code. I assumed it would be nicer (but not of =E2=80=9Cgreat importance=E2=80=9D) to just document it a bit further. Best regards,