From unknown Wed Jun 18 23:07:02 2025 Content-Disposition: inline Content-Transfer-Encoding: quoted-printable MIME-Version: 1.0 X-Mailer: MIME-tools 5.509 (Entity 5.509) Content-Type: text/plain; charset=utf-8 From: bug#78784 <78784@debbugs.gnu.org> To: bug#78784 <78784@debbugs.gnu.org> Subject: Status: [PATCH] Improve the documentation of the internal Lisp_Process->status field Reply-To: bug#78784 <78784@debbugs.gnu.org> Date: Thu, 19 Jun 2025 06:07:02 +0000 retitle 78784 [PATCH] Improve the documentation of the internal Lisp_Proces= s->status field reassign 78784 emacs submitter 78784 Steven Allen severity 78784 minor tag 78784 patch thanks From debbugs-submit-bounces@debbugs.gnu.org Fri Jun 13 10:55:07 2025 Received: (at submit) by debbugs.gnu.org; 13 Jun 2025 14:55:07 +0000 Received: from localhost ([127.0.0.1]:47666 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1uQ5oA-0007A1-Ex for submit@debbugs.gnu.org; Fri, 13 Jun 2025 10:55:07 -0400 Received: from lists.gnu.org ([2001:470:142::17]:57714) by debbugs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.84_2) (envelope-from ) id 1uQ5o7-000786-Bg for submit@debbugs.gnu.org; Fri, 13 Jun 2025 10:55:03 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1uQ5o2-0007ZY-1V for bug-gnu-emacs@gnu.org; Fri, 13 Jun 2025 10:54:58 -0400 Received: from fout-a1-smtp.messagingengine.com ([103.168.172.144]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1uQ5o0-0007tm-35 for bug-gnu-emacs@gnu.org; Fri, 13 Jun 2025 10:54:57 -0400 Received: from phl-compute-02.internal (phl-compute-02.phl.internal [10.202.2.42]) by mailfout.phl.internal (Postfix) with ESMTP id 9350B13803C1 for ; Fri, 13 Jun 2025 10:54:55 -0400 (EDT) Received: from phl-mailfrontend-01 ([10.202.2.162]) by phl-compute-02.internal (MEProxy); Fri, 13 Jun 2025 10:54:55 -0400 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=stebalien.com; h=cc:content-type:content-type:date:date:from:from:in-reply-to :message-id:mime-version:reply-to:subject:subject:to:to; s=fm3; t=1749826495; x=1749912895; bh=ivEWcNlzY8n1Y62PnJNsmVTNHcylB7/k MCGKQzWxl44=; b=TeX1ATKtfbFWmKWfrAw3rLc80fzVgVuZvIwtKqwl8v5V7yGF xAVS6sA4anFCzYBV3n3gFk+fFuGRxEy03PabdAKU4BWRJvx+kpUaDpjaC6CQrsEz z5fumB6tuH4bTmucqoOv1OYjtT33pkvrHK4fHcEXjrZWXEUUNWEzIKkWYrEMFW50 UY1PudgwRu71aX1EwcQCdOsGL9/lQmjsIbmQC7vxEcQSetU3go8LK0a3TEBxLXmJ mmemrvC3zy+V0cOHUxCIDxTHgYSW3SuUZX3/aGHpe5XYwvG23lxg39OmOEnu4dcx vno7db2Zfd/bN//1xoalAytU5XnF0G2cDz5ffw== DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d= messagingengine.com; h=cc:content-type:content-type:date:date :feedback-id:feedback-id:from:from:in-reply-to:message-id :mime-version:reply-to:subject:subject:to:to:x-me-proxy :x-me-sender:x-me-sender:x-sasl-enc; s=fm1; t=1749826495; x= 1749912895; bh=ivEWcNlzY8n1Y62PnJNsmVTNHcylB7/kMCGKQzWxl44=; b=G 7luCWqz+qeRyjPsIGsL0/tvOf3dZLhU54TjZfe6XoH7Zd0McNTxbhGAEKYo+oSrp kWWIwyaowJomxU7vxOJN/4Uh1FAH+hqIy8t2sIhCIQEWVY+eRYgWE80CrxHab9Y6 gUI50v2DmW3SbbSJ/fsnDoJfCg9PkLGnDtPlFQqKF9Q6XZQw0+3Gn6lU2013/MpG kcK5LkQPJeVfIGLp9h+IhHEtSsUku006YICILDBGiGwIzBwhV3B4WKa5sI0hHHs1 CkZYE8aIL9m4IZZhRrr4Oc3fJX/D6Plm623QCiL5FG+xKQquCeE5o3QEiOqcJYHj g6T4pwmjLC78P6W0amDyA== X-ME-Sender: X-ME-Received: X-ME-Proxy-Cause: gggruggvucftvghtrhhoucdtuddrgeeffedrtddugddukedvgecutefuodetggdotefrod ftvfcurfhrohhfihhlvgemucfhrghsthforghilhdpggftfghnshhusghstghrihgsvgdp uffrtefokffrpgfnqfghnecuuegrihhlohhuthemuceftddtnecunecujfgurhephffvuf ffkfggtgesmhdtreertddttdenucfhrhhomhepufhtvghvvghnucetlhhlvghnuceoshht vghvvghnsehsthgvsggrlhhivghnrdgtohhmqeenucggtffrrghtthgvrhhnpeekffffgf evteehtdeiffelffegkedvieeigeehfedtteejkeefhfevtddtkeefffenucevlhhushht vghrufhiiigvpedtnecurfgrrhgrmhepmhgrihhlfhhrohhmpehsthgvvhgvnhesshhtvg gsrghlihgvnhdrtghomhdpnhgspghrtghpthhtohepuddpmhhouggvpehsmhhtphhouhht pdhrtghpthhtohepsghughdqghhnuhdqvghmrggtshesghhnuhdrohhrgh X-ME-Proxy: Feedback-ID: ie8a146a7:Fastmail Received: by mail.messagingengine.com (Postfix) with ESMTPA for ; Fri, 13 Jun 2025 10:54:55 -0400 (EDT) From: Steven Allen To: bug-gnu-emacs@gnu.org Subject: [PATCH] Improve the documentation of the internal Lisp_Process->status field X-Debbugs-Cc: Date: Fri, 13 Jun 2025 07:54:54 -0700 Message-ID: <878qlvhetd.fsf@stebalien.com> MIME-Version: 1.0 Content-Type: multipart/mixed; boundary="=-=-=" Received-SPF: pass client-ip=103.168.172.144; envelope-from=steven@stebalien.com; helo=fout-a1-smtp.messagingengine.com X-Spam_score_int: -27 X-Spam_score: -2.8 X-Spam_bar: -- X-Spam_report: (-2.8 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, RCVD_IN_DNSWL_LOW=-0.7, RCVD_IN_VALIDITY_RPBL_BLOCKED=0.001, RCVD_IN_VALIDITY_SAFE_BLOCKED=0.001, SPF_HELO_PASS=-0.001, SPF_PASS=-0.001 autolearn=ham autolearn_force=no X-Spam_action: no action X-Spam-Score: 0.7 (/) X-Debbugs-Envelope-To: submit X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -0.3 (/) --=-=-= Content-Type: text/plain Tags: patch Contrary to the existing documentation here, the value of this field cannot be the symbols open or closed. Furthermore, this field is never set to "stop" for network connections. In GNU Emacs 31.0.50 (build 1, x86_64-pc-linux-gnu, cairo version 1.18.4) of 2025-06-12 built on Laptop Repository revision: 7bca4f75b1784c555f776910845fdb5c06224fc0 Repository branch: makepkg Windowing system distributor 'The X.Org Foundation', version 11.0.12101016 System Description: Arch Linux Configured using: 'configure 'CPPFLAGS=-I/run/user/1000/build/emacs-git/src/mps-git/build/include ' 'LDFLAGS=-L/run/user/1000/build/emacs-git/src/mps-git/build/lib -Wl,-O1 -Wl,--sort-common -Wl,--as-needed -Wl,-z,relro -Wl,-z,now -Wl,-z,pack-relative-relocs -flto=auto' --prefix=/usr --sysconfdir=/etc --libexecdir=/usr/lib --localstatedir=/var --mandir=/usr/share/man --with-gameuser=:games --with-modules --without-m17n-flt --without-selinux --without-pop --without-gconf --disable-gc-mark-trace --with-mps=yes --enable-link-time-optimization --with-native-compilation=yes --with-xinput2 --with-x-toolkit=no --without-toolkit-scroll-bars --without-xaw3d --without-gsettings --with-cairo-xcb --without-xft --with-sound=no --with-tree-sitter --without-gpm --without-compress-install '--program-transform-name=s/\([ec]tags\)/\1.emacs/' 'CFLAGS=-march=native -mtune=native -O3 -pipe -fno-plt -fexceptions -Wp,-D_FORTIFY_SOURCE=3 -Wformat -Werror=format-security -fstack-clash-protection -fcf-protection -fomit-frame-pointer -fno-math-errno -fno-trapping-math -flto=auto' 'CXXFLAGS=-march=native -mtune=native -O3 -pipe -fno-plt -fexceptions -Wp,-D_FORTIFY_SOURCE=3 -Wformat -Werror=format-security -fstack-clash-protection -fcf-protection -fomit-frame-pointer -Wp,-D_GLIBCXX_ASSERTIONS -flto=auto'' --=-=-= Content-Type: text/patch Content-Disposition: attachment; filename=0001-Improve-the-documentation-of-the-internal-Lisp_Proce.patch >From 691b508753d8d2ebfc4b8670ba75d3898df95b79 Mon Sep 17 00:00:00 2001 From: Steven Allen Date: Fri, 13 Jun 2025 07:51:37 -0700 Subject: [PATCH] Improve the documentation of the internal Lisp_Process->status field Contrary to the existing documentation here, the value of this field cannot be the symbols open or closed. Furthermore, this field is never set to "stop" for network connections. * src/process.h (Lisp_Process): improve/fix documentation of the status field. --- src/process.h | 11 +++++++++-- 1 file changed, 9 insertions(+), 2 deletions(-) diff --git a/src/process.h b/src/process.h index a27e95a9199..1e0ad8c7f68 100644 --- a/src/process.h +++ b/src/process.h @@ -83,13 +83,20 @@ #define EMACS_PROCESS_H Lisp_Object mark; /* Symbol indicating status of process. - This may be a symbol: run, open, closed, listen, or failed. + This may be a symbol: run, listen, or failed. Or it may be a pair (connect . ADDRINFOS) where ADDRINFOS is a list of remaining (PROTOCOL . ADDRINFO) pairs to try. Or it may be (failed ERR) where ERR is an integer, string or symbol. Or it may be a list, whose car is stop, exit or signal and whose cdr is a pair (EXIT_CODE . COREDUMP_FLAG) - or (SIGNAL_NUMBER . COREDUMP_FLAG). */ + or (SIGNAL_NUMBER . COREDUMP_FLAG). + The symbols open and closed are not used here: an open network + process has an internal status of "run" and a closed network + process an internal status of "exit". + Stopped network processes do not set this status to "stop"; + instead, they set command to t. "stop" is only used here to + indicate stopped system processes. + */ Lisp_Object status; /* Coding-system for decoding the input from this process. */ -- 2.49.0 --=-=-=-- From debbugs-submit-bounces@debbugs.gnu.org Sat Jun 14 11:04:09 2025 Received: (at 78784-done) by debbugs.gnu.org; 14 Jun 2025 15:04:09 +0000 Received: from localhost ([127.0.0.1]:40435 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1uQSQS-0004fC-Sx for submit@debbugs.gnu.org; Sat, 14 Jun 2025 11:04:09 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]:44568) by debbugs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.84_2) (envelope-from ) id 1uQSQQ-0004eh-Os for 78784-done@debbugs.gnu.org; Sat, 14 Jun 2025 11:04:07 -0400 Received: from fencepost.gnu.org ([2001:470:142:3::e]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1uQSQL-0003dG-BU; Sat, 14 Jun 2025 11:04:01 -0400 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnu.org; s=fencepost-gnu-org; h=References:Subject:In-Reply-To:To:From:Date: mime-version; bh=DlaSbhnOo6j+jurkluNfgc1MS2aQhFYv6ReszjvdsGQ=; b=iewXv6JEXzpG sHIvex1ipXU+eXB4HdGK/jx4VkD3IbvPO04Voar5qzcAjALZdznkQCy22q1vkhEzsc2TaY7hnIPLM aYylSwBdHwSRJ70goVsCzmN/D5hNUX/TcqrbcJSB+vdK6AU6LBbOWr93T5sIM5twpT1ggYffV5Z7Z struOhlOHkATgrBs2TfRrmGyi929Bi6yDRt7MLF+Ztu6zgMquzA0Bg9CCt+8tG1LH15eovsJRoL2h gaZoc6IOul2hXtnUTwV481owqlZoyyfzad8fBgAQcObOkd17nwLg0KrPv+MfFDXLyC8sXV0EaiDR9 teyqboG+iMIEbPseVrdi0w==; Date: Sat, 14 Jun 2025 18:03:59 +0300 Message-Id: <86tt4iqs9s.fsf@gnu.org> From: Eli Zaretskii To: Steven Allen In-Reply-To: <878qlvhetd.fsf@stebalien.com> (bug-gnu-emacs@gnu.org) Subject: Re: bug#78784: [PATCH] Improve the documentation of the internal Lisp_Process->status field References: <878qlvhetd.fsf@stebalien.com> X-Spam-Score: -2.3 (--) X-Debbugs-Envelope-To: 78784-done Cc: 78784-done@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -3.3 (---) > Date: Fri, 13 Jun 2025 07:54:54 -0700 > From: Steven Allen via "Bug reports for GNU Emacs, > the Swiss army knife of text editors" > > Contrary to the existing documentation here, the value of this field > cannot be the symbols open or closed. Furthermore, this field is never > set to "stop" for network connections. Thanks, installed on master, and closing the bug. From debbugs-submit-bounces@debbugs.gnu.org Sun Jun 15 23:19:34 2025 Received: (at 78784) by debbugs.gnu.org; 16 Jun 2025 03:19:34 +0000 Received: from localhost ([127.0.0.1]:38147 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1uR0Nh-0004sr-M3 for submit@debbugs.gnu.org; Sun, 15 Jun 2025 23:19:33 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]:58998) by debbugs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.84_2) (envelope-from ) id 1uR0Ne-0004sD-VS for 78784@debbugs.gnu.org; Sun, 15 Jun 2025 23:19:31 -0400 Received: from fencepost.gnu.org ([2001:470:142:3::e]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1uR0NY-0000t9-Vj; Sun, 15 Jun 2025 23:19:24 -0400 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnu.org; s=fencepost-gnu-org; h=Date:References:Subject:In-Reply-To:To:From: mime-version; bh=t+Dkqv6l06FXYMXfH19fNAz7Djjce0uQetCMwr5gDQc=; b=W7EusgmU5q17 d4vUkQZUhTSwqTsbtdDp7YIb8yXJsrq+TZcJTln1EdoXtB/+PWn15/T1KF1dNy546iYow6edXx5AF SBg7WYr/Jrmby8cKouwlA6UnbR/cxIq7IjSPPxKIvN3mLzCjkKh5lzEuri+kdO93H910mC8mZb6Ke YPi/nOtws8cPLV3q1pAl32JCP4dsyCQuCSe5/zdtC1r8/hyueTB4KdkZ6pq6FZPB8HCB4eO8/KFjT xOfqJ/2d2+ztYgwcxRa5mgXJvWYItyATQs+k9X+Ge5xBlvFNJeN4f3lTwb7Ju4vMncdnIqfAdwmaR Zc+xZ8/l9VrDl3ZaCTeBSg==; Received: from rms by fencepost.gnu.org with local (Exim 4.90_1) (envelope-from ) id 1uR0NY-0006Pd-Lg; Sun, 15 Jun 2025 23:19:24 -0400 Content-Type: text/plain; charset=Utf-8 From: Richard Stallman To: Steven Allen In-Reply-To: <878qlvhetd.fsf@stebalien.com> (bug-gnu-emacs@gnu.org) Subject: Re: bug#78784: [PATCH] Improve the documentation of the internal Lisp_Process->status field References: <878qlvhetd.fsf@stebalien.com> Message-Id: Date: Sun, 15 Jun 2025 23:19:24 -0400 X-Spam-Score: -2.3 (--) X-Debbugs-Envelope-To: 78784 Cc: 78784@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Reply-To: rms@gnu.org Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -3.3 (---) [[[ To any NSA and FBI agents reading my email: please consider ]]] [[[ whether defending the US Constitution against all enemies, ]]] [[[ foreign or domestic, requires you to follow Snowden's example. ]]] > Contrary to the existing documentation here, the value of this field > cannot be the symbols open or closed. Furthermore, this field is never > set to "stop" for network connections. This could be considered a bug in the documentation, or a bug in the code. To tell which it is, is not automatic. -- Dr Richard Stallman (https://stallman.org) Chief GNUisance of the GNU Project (https://gnu.org) Founder, Free Software Foundation (https://fsf.org) Internet Hall-of-Famer (https://internethalloffame.org) From debbugs-submit-bounces@debbugs.gnu.org Mon Jun 16 01:39:24 2025 Received: (at 78784) by debbugs.gnu.org; 16 Jun 2025 05:39:24 +0000 Received: from localhost ([127.0.0.1]:39588 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1uR2Z2-0008WI-5F for submit@debbugs.gnu.org; Mon, 16 Jun 2025 01:39:24 -0400 Received: from fhigh-a2-smtp.messagingengine.com ([103.168.172.153]:54501) by debbugs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.84_2) (envelope-from ) id 1uR2Yz-0008Vt-3Q for 78784@debbugs.gnu.org; Mon, 16 Jun 2025 01:39:21 -0400 Received: from phl-compute-05.internal (phl-compute-05.phl.internal [10.202.2.45]) by mailfhigh.phl.internal (Postfix) with ESMTP id 6963D11402A2; Mon, 16 Jun 2025 01:39:15 -0400 (EDT) Received: from phl-mailfrontend-01 ([10.202.2.162]) by phl-compute-05.internal (MEProxy); Mon, 16 Jun 2025 01:39:15 -0400 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=stebalien.com; h=cc:cc:content-type:content-type:date:date:from:from :in-reply-to:in-reply-to:message-id:mime-version:references :reply-to:subject:subject:to:to; s=fm3; t=1750052355; x= 1750138755; bh=1nHdUrabG/q594AxAEgnlyWM3eJD2K3eeLAR2oW9KtY=; b=r MQt3oW8H1GIvbNnbh9D07/Zc6ZX6drt2cGkHavd+taZ4f12eWNzqEpR1SdRGIOZe qruF4a802S7dAdCwQE/6drPesSRGW0S9VpwGxNOEzmR9FUY+K4czL/Jgs+QhjZZd WauyDkLx4UjlFku8hAFfQze4U4ixU2hO4399AECWLWLF8uvlB4npVpV62K7eMCXK CY9Ns2yyB7OsN6/P0lGQmKWkY9PwoU/3j/3+IFpKjF6yz98DJ3g59bmcUaHd/M/e zPbqrk20unRCVMtjXEMK7ZCOkxizApX0T2zVA7Txhgw2Sv71+jLMT6aIuuge0zM6 igrlAglsFnF/y3awUYSOw== DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d= messagingengine.com; h=cc:cc:content-type:content-type:date:date :feedback-id:feedback-id:from:from:in-reply-to:in-reply-to :message-id:mime-version:references:reply-to:subject:subject:to :to:x-me-proxy:x-me-sender:x-me-sender:x-sasl-enc; s=fm1; t= 1750052355; x=1750138755; bh=1nHdUrabG/q594AxAEgnlyWM3eJD2K3eeLA R2oW9KtY=; b=asHwxeKYIAk/VNG+aaJySCScXrFq/wqlmzLG7pnUL6rhkUhtKPt wcMS+iTwnpG2gGon11pepKFq8ITRwA7P1HiBU+mOkhn+k6SpXH1hw/b5BMX3akiA vyCpoZVDWYy98dYxKCzLim7zkDNxZCPNZyjTG/7PDc1KwCBa8+0wc78jsMGD/tOA dcwIomCa908Nw2Fdq8eC1P7JdQA/8lqIAMWcTRz3R45YJkqXiSMAEBzDX5EyQmJ6 ZEttyj9+PeubkW7Yb1tM/nCjQfl5pXXq3i8WqmPaDarF4Sc1Ypz+SY8mDLkSuSQT WCKK1pkwT9nzi1kXJve/XrPurrB0gI7ER9A== X-ME-Sender: X-ME-Received: X-ME-Proxy-Cause: gggruggvucftvghtrhhoucdtuddrgeeffedrtddugddvheejiecutefuodetggdotefrod ftvfcurfhrohhfihhlvgemucfhrghsthforghilhdpggftfghnshhusghstghrihgsvgdp uffrtefokffrpgfnqfghnecuuegrihhlohhuthemuceftddtnecunecujfgurhephffvve fujghffffkgggtsehttdertddttddtnecuhfhrohhmpefuthgvvhgvnhcutehllhgvnhcu oehsthgvvhgvnhesshhtvggsrghlihgvnhdrtghomheqnecuggftrfgrthhtvghrnhepvd ekheekgeelheehgefgudelkeethffhgfeuffetkeegtddvfeduuddttdejjedvnecuvehl uhhsthgvrhfuihiivgeptdenucfrrghrrghmpehmrghilhhfrhhomhepshhtvghvvghnse hsthgvsggrlhhivghnrdgtohhmpdhnsggprhgtphhtthhopedvpdhmohguvgepshhmthhp ohhuthdprhgtphhtthhopehrmhhssehgnhhurdhorhhgpdhrtghpthhtohepjeekjeekge esuggvsggsuhhgshdrghhnuhdrohhrgh X-ME-Proxy: Feedback-ID: ie8a146a7:Fastmail Received: by mail.messagingengine.com (Postfix) with ESMTPA; Mon, 16 Jun 2025 01:39:14 -0400 (EDT) From: Steven Allen To: rms@gnu.org Subject: Re: bug#78784: [PATCH] Improve the documentation of the internal Lisp_Process->status field In-Reply-To: References: <878qlvhetd.fsf@stebalien.com> Date: Sun, 15 Jun 2025 22:39:13 -0700 Message-ID: <87ldpsb5z2.fsf@stebalien.com> MIME-Version: 1.0 Content-Type: text/plain X-Spam-Score: -0.7 (/) X-Debbugs-Envelope-To: 78784 Cc: 78784@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -1.7 (-) Richard Stallman writes: > [[[ To any NSA and FBI agents reading my email: please consider ]]] > [[[ whether defending the US Constitution against all enemies, ]]] > [[[ foreign or domestic, requires you to follow Snowden's example. ]]] > > > Contrary to the existing documentation here, the value of this field > > cannot be the symbols open or closed. Furthermore, this field is never > > set to "stop" for network connections. > > This could be considered a bug in the documentation, or a bug in the code. > To tell which it is, is not automatic. For network processes, the various status values are by `process-status`: run -> open, exit -> closed, etc. Here I'm just updating the internal documentation so contributors aren't confused about why src/process.c never checks if a process's (internal) status is open/closed/etc but instead only checks for run/exit/etc. Effectively, "open" and "closed" are virtual states. From debbugs-submit-bounces@debbugs.gnu.org Mon Jun 16 02:05:19 2025 Received: (at 78784) by debbugs.gnu.org; 16 Jun 2025 06:05:20 +0000 Received: from localhost ([127.0.0.1]:39923 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1uR2y7-0002Qp-Hw for submit@debbugs.gnu.org; Mon, 16 Jun 2025 02:05:19 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]:43864) by debbugs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.84_2) (envelope-from ) id 1uR2y4-0002MN-Gf for 78784@debbugs.gnu.org; Mon, 16 Jun 2025 02:05:17 -0400 Received: from fencepost.gnu.org ([2001:470:142:3::e]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1uR2xy-0001Yd-Qf; Mon, 16 Jun 2025 02:05:10 -0400 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnu.org; s=fencepost-gnu-org; h=References:Subject:In-Reply-To:To:From:Date: mime-version; bh=dDrsYmXudp9ulirc3UHsUr7AeIf6VZFE9HrhZ0pWVOs=; b=b3pnr0tUV2f4 JVABCEdWIbEJY/VugaMBwy8seSieSM/BD0fCEuwyLtyuWKMTB+S6cfvXNMhRRsCOROBmYaHJQ/z4j obABfx4hACg8Fsgm9y5jLvdvsP2NrhqkGEn71navoR6sbfQzXwRj4URg7+w2y+118CLi24bupEapW dGAlyFtplsbLfAhTAtLzY5P5iIafiRnKrg/8naVNrnC5+qqmPPhxG5MiD+4f99F9ZUHOJQlEEmT2V HOueFwjhEBlq7XXXZdFXOLyduc/Nax22S1MjAnJEftNEwKsgzqtLyHoCwULCeKKi8o/aBWuqemjPR ePi+oMQHraS0FVgN7XxOzA==; Date: Mon, 16 Jun 2025 09:04:53 +0300 Message-Id: <86ikkwp6gq.fsf@gnu.org> From: Eli Zaretskii To: rms@gnu.org In-Reply-To: (message from Richard Stallman on Sun, 15 Jun 2025 23:19:24 -0400) Subject: Re: bug#78784: [PATCH] Improve the documentation of the internal Lisp_Process->status field References: <878qlvhetd.fsf@stebalien.com> X-Spam-Score: -2.3 (--) X-Debbugs-Envelope-To: 78784 Cc: 78784@debbugs.gnu.org, steven@stebalien.com X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -3.3 (---) > Cc: 78784@debbugs.gnu.org > From: Richard Stallman > Date: Sun, 15 Jun 2025 23:19:24 -0400 > > > Contrary to the existing documentation here, the value of this field > > cannot be the symbols open or closed. Furthermore, this field is never > > set to "stop" for network connections. > > This could be considered a bug in the documentation, or a bug in the code. > To tell which it is, is not automatic. I think it's a bug in the documentation, because someone looked at what process-status can report and concluded (incorrectly) that the same values are held internally in the process object.