From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Ram Bhamidipaty Newsgroups: gmane.emacs.bugs Subject: bug#22220: 24.5; no documentation for default process sentinel Date: Wed, 23 Dec 2015 17:45:22 +0000 Message-ID: References: <837fk6queu.fsf@gnu.org> <83r3idq1db.fsf@gnu.org> NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: quoted-printable X-Trace: ger.gmane.org 1450892783 24906 80.91.229.3 (23 Dec 2015 17:46:23 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Wed, 23 Dec 2015 17:46:23 +0000 (UTC) Cc: "22220@debbugs.gnu.org" <22220@debbugs.gnu.org> To: John Wiegley , Eli Zaretskii Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Wed Dec 23 18:46:12 2015 Return-path: Envelope-to: geb-bug-gnu-emacs@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 1aBnUI-00067L-2b for geb-bug-gnu-emacs@m.gmane.org; Wed, 23 Dec 2015 18:46:10 +0100 Original-Received: from localhost ([::1]:57251 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1aBnUH-0001Ta-Ij for geb-bug-gnu-emacs@m.gmane.org; Wed, 23 Dec 2015 12:46:09 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:43862) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1aBnUD-0001TS-Rd for bug-gnu-emacs@gnu.org; Wed, 23 Dec 2015 12:46:07 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1aBnUA-0001ht-Ls for bug-gnu-emacs@gnu.org; Wed, 23 Dec 2015 12:46:05 -0500 Original-Received: from debbugs.gnu.org ([208.118.235.43]:53566) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1aBnUA-0001hn-Ht for bug-gnu-emacs@gnu.org; Wed, 23 Dec 2015 12:46:02 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84) (envelope-from ) id 1aBnUA-0000E4-C9 for bug-gnu-emacs@gnu.org; Wed, 23 Dec 2015 12:46:02 -0500 X-Loop: help-debbugs@gnu.org Resent-From: Ram Bhamidipaty Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Wed, 23 Dec 2015 17:46:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 22220 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: Original-Received: via spool by 22220-submit@debbugs.gnu.org id=B22220.1450892732826 (code B ref 22220); Wed, 23 Dec 2015 17:46:02 +0000 Original-Received: (at 22220) by debbugs.gnu.org; 23 Dec 2015 17:45:32 +0000 Original-Received: from localhost ([127.0.0.1]:32935 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84) (envelope-from ) id 1aBnTg-0000DF-1n for submit@debbugs.gnu.org; Wed, 23 Dec 2015 12:45:32 -0500 Original-Received: from mail-bn1bon0060.outbound.protection.outlook.com ([157.56.111.60]:7649 helo=na01-bn1-obe.outbound.protection.outlook.com) by debbugs.gnu.org with esmtp (Exim 4.84) (envelope-from ) id 1aBnTe-0000D0-Rn for 22220@debbugs.gnu.org; Wed, 23 Dec 2015 12:45:31 -0500 Original-Received: from BLUPR0101MB1553.prod.exchangelabs.com (10.163.118.24) by BLUPR0101MB1475.prod.exchangelabs.com (10.163.118.149) with Microsoft SMTP Server (TLS) id 15.1.361.13; Wed, 23 Dec 2015 17:45:23 +0000 Original-Received: from BLUPR0101MB1553.prod.exchangelabs.com (10.163.118.24) by BLUPR0101MB1553.prod.exchangelabs.com (10.163.118.24) with Microsoft SMTP Server (TLS) id 15.1.361.13; Wed, 23 Dec 2015 17:45:22 +0000 Original-Received: from BLUPR0101MB1553.prod.exchangelabs.com ([10.163.118.24]) by BLUPR0101MB1553.prod.exchangelabs.com ([10.163.118.24]) with mapi id 15.01.0361.006; Wed, 23 Dec 2015 17:45:22 +0000 Thread-Topic: bug#22220: 24.5; no documentation for default process sentinel Thread-Index: AdE8Vt0yhgfex/qTQOqx6UdhV2nl8QAhQ69VAAzqu6AACP4syAAdJWdQAAAGu4A= In-Reply-To: Accept-Language: en-US Content-Language: en-US X-MS-Has-Attach: X-MS-TNEF-Correlator: authentication-results: spf=none (sender IP is ) smtp.mailfrom=rbhamidipaty@roku.com; x-originating-ip: [216.38.147.4] x-microsoft-exchange-diagnostics: 1; BLUPR0101MB1553; 5:mBaD1Nfia9h6E7hTgDP8HZG2ib5QaXJoX3C9Lc+J0IKaTZbWY3ivZnK8rcQFkXtXJFlOam9F3RQNAusZamN1Ofs/Edy2w+CXkEvZkXqaNJGCSlyjXUOgK9wXAOZ2QNFYnSlyFGiQo1QSC1MtVMc9wA==; 24:qClOSynDW6/9r/D7J9eEe66Wjp61XYeLnQoiiPW3U+n4W14iivt3UM8BuW+8xTIg6gyagHctlIdmJxBnNvzbCjGBSjS/diW7aV4jIZ6/agY= x-microsoft-antispam: UriScan:;BCL:0;PCL:0;RULEID:;SRVR:BLUPR0101MB1553; x-microsoft-antispam-prvs: x-exchange-antispam-report-test: UriScan:(169088704739312); x-exchange-antispam-report-cfa-test: BCL:0; PCL:0; RULEID:(2401047)(5005006)(520078)(8121501046)(10201501046)(3002001); SRVR:BLUPR0101MB1553; BCL:0; PCL:0; RULEID:; SRVR:BLUPR0101MB1553; x-forefront-prvs: 0799B1B2D7 x-forefront-antispam-report: SFV:NSPM; SFS:(10009020)(6009001)(377454003)(189002)(199003)(13464003)(15975445007)(6116002)(16601075003)(92566002)(2900100001)(3846002)(77096005)(11100500001)(586003)(2950100001)(101416001)(5004730100002)(102836003)(87936001)(5002640100001)(5003600100002)(66066001)(1096002)(1220700001)(33656002)(19580405001)(19580395003)(40100003)(10400500002)(74316001)(122556002)(93886004)(54356999)(97736004)(5008740100001)(50986999)(76176999)(5001770100001)(81156007)(106356001)(86362001)(5001960100002)(105586002)(189998001)(21314002); DIR:OUT; SFP:1101; SCL:1; SRVR:BLUPR0101MB1553; H:BLUPR0101MB1553.prod.exchangelabs.com; FPR:; SPF:None; PTR:InfoNoRecords; MX:1; A:1; LANG:en; received-spf: None (protection.outlook.com: roku.com does not designate permitted sender hosts) spamdiagnosticoutput: 1:23 spamdiagnosticmetadata: NSPM X-MS-Exchange-CrossTenant-originalarrivaltime: 23 Dec 2015 17:45:22.0316 (UTC) X-MS-Exchange-CrossTenant-fromentityheader: Hosted X-MS-Exchange-CrossTenant-id: 00fc7e42-ad65-4c4c-ab54-848ba124a5b7 X-MS-Exchange-Transport-CrossTenantHeadersStamped: BLUPR0101MB1553 X-Microsoft-Exchange-Diagnostics: 1; BLUPR0101MB1475; 2:w04jbvGecHBrMJKZH0OyZFFAGox5t6rQGXje56NFRF4gzD8yWrwvzBLUqksOsIqo3IAcaxOhTdYmKBZMoP9XQgcpr1U4KuTk9Sncr2o0P5RJuZ14ptixpoMI/rmcT4/jMNSPd7yBDZDMgzGt0d6Y4g==; 23:F45ZW9YTuJrbGZR4QNPI+bLoXW9Dt83xfyrTWlpsfVD0Bh1z87dZHYUmkbl+Pjzov/dpvX1Yu6w1MOvV9bA7p8tayciyleGbLJZ4xRl+oUuGNHe8dkDi72pQRv0aX1jtLnLXAPbsnFNd1JsqjCo2iYcftnnvHAMMnaBSpdvLw4hQzGNx36WtdFq0lo2x8Khc X-OriginatorOrg: roku.com X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 208.118.235.43 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.org@gnu.org Original-Sender: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.bugs:110313 Archived-At: This is what I ran into: I am working on some code using the emacs process = facility. And I started seeing messages (from the default sentinel) that I = did not expect. When I _skimmed_ through the sentinel section I did not not= ice that a default sentinel is added to all processes. I acknowledge that s= kimming the docs was not the right thing to do - since I missed the fact th= at there is a default sentinel. >From my point of view - I would have been nice - if the default sentinel in= fo were a bit more prominent. So - I proposed that the name and behavior of the default sentinel be docum= ented. It might not be needed - in the sense that the name itself is not re= quired - but if there were a block of text in the info section like "-- Fun= ction: xxx default-sentinel" that would be more prominent - and probably ha= rder to miss. -Ram -----Original Message----- From: John Wiegley [mailto:jwiegley@gmail.com]=20 Sent: Wednesday, December 23, 2015 9:34 AM To: Eli Zaretskii Cc: Ram Bhamidipaty ; 22220@debbugs.gnu.org Subject: Re: bug#22220: 24.5; no documentation for default process sentinel >>>>> Eli Zaretskii writes: >> It would be nice if the default process sentinel were explicitly documen= ted >> - at least the name and formal description. > As for the name, why is that important? You can always get it installed f= or > the process using nil as the argument to set-process-sentinel, and the > implementation is in C, so how would the name help? I must admit to a similar confusion. Aside from the fact that more could be said: does more need to be said? --=20 John Wiegley GPG fingerprint =3D 4710 CF98 AF9B 327B B80F http://newartisans.com 60E1 46C4 BD1A 7AC1 4BA2