From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Stefan Kangas Newsgroups: gmane.emacs.bugs Subject: bug#75290: Fwd: remove-pos-from-symbol and bare-symbol Date: Thu, 2 Jan 2025 11:22:44 -0600 Message-ID: References: Mime-Version: 1.0 Content-Type: text/plain; charset="UTF-8" Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="24343"; mail-complaints-to="usenet@ciao.gmane.io" Cc: rms@gnu.org, acm@muc.de To: 75290@debbugs.gnu.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Thu Jan 02 18:23:25 2025 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 1tTOuq-0006CX-Tm for geb-bug-gnu-emacs@m.gmane-mx.org; Thu, 02 Jan 2025 18:23:25 +0100 Original-Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1tTOuY-0003u2-1f; Thu, 02 Jan 2025 12:23:06 -0500 Original-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 1tTOuV-0003tG-Uu for bug-gnu-emacs@gnu.org; Thu, 02 Jan 2025 12:23:03 -0500 Original-Received: from debbugs.gnu.org ([2001:470:142:5::43]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1tTOuV-0006AF-MH; Thu, 02 Jan 2025 12:23:03 -0500 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=debbugs.gnu.org; s=debbugs-gnu-org; h=Date:MIME-Version:References:From:To:Subject; bh=VC8im9qxHgkrKHrig3OEEXgtwCxAbOs/dCH8shBMqgM=; b=j7I5OztkfNvLW/RDNYJBag2YhioFSi7cOKVLKijBO8ZP85SVEhmdRnqpH4xntI08fa4heHPr+MIh0dAI4RsqA9QS56t1si2jVmIy/+QNZQIWJe/Q71FU4r9gLHk7tbw89zz6N8uxxrDx+3or6rf9VVecOxQ8mMFm575GWD0BpERuD3HOrPRBOnXGVoRbxZdrNJgQB9+hx/f8uF6KKoti3BKLK/ow4yL55rNYGX7M/92nYoN1Jddvg2Q68lxep5VuN3GVlSMSMkI+00RLsL4swpr+9dcuoywpq8XfFzD+XjK5bGnlavHvmUwloDMFqdJHNN5himhtGpAqQ+NywxT3eA==; Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1tTOuV-0004TC-8I; Thu, 02 Jan 2025 12:23:03 -0500 X-Loop: help-debbugs@gnu.org Resent-From: Stefan Kangas Original-Sender: "Debbugs-submit" Resent-CC: rms@gnu.org, acm@muc.de, bug-gnu-emacs@gnu.org Resent-Date: Thu, 02 Jan 2025 17:23:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 75290 X-GNU-PR-Package: emacs X-Debbugs-Original-To: bug-gnu-emacs@gnu.org X-Debbugs-Original-Xcc: rms@gnu.org, acm@muc.de Original-Received: via spool by submit@debbugs.gnu.org id=B.173583857717137 (code B ref -1); Thu, 02 Jan 2025 17:23:02 +0000 Original-Received: (at submit) by debbugs.gnu.org; 2 Jan 2025 17:22:57 +0000 Original-Received: from localhost ([127.0.0.1]:46414 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1tTOuO-0004SL-Gk for submit@debbugs.gnu.org; Thu, 02 Jan 2025 12:22:56 -0500 Original-Received: from lists.gnu.org ([2001:470:142::17]:54726) by debbugs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.84_2) (envelope-from ) id 1tTOuM-0004S7-CQ for submit@debbugs.gnu.org; Thu, 02 Jan 2025 12:22:55 -0500 Original-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 1tTOuG-0003sJ-RL for bug-gnu-emacs@gnu.org; Thu, 02 Jan 2025 12:22:49 -0500 Original-Received: from mail-ed1-x52d.google.com ([2a00:1450:4864:20::52d]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1tTOuE-00067p-Ur for bug-gnu-emacs@gnu.org; Thu, 02 Jan 2025 12:22:48 -0500 Original-Received: by mail-ed1-x52d.google.com with SMTP id 4fb4d7f45d1cf-5d7e3f1fdafso23674523a12.0 for ; Thu, 02 Jan 2025 09:22:46 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1735838565; x=1736443365; darn=gnu.org; h=to:subject:message-id:date:mime-version:references:from:from:to:cc :subject:date:message-id:reply-to; bh=VC8im9qxHgkrKHrig3OEEXgtwCxAbOs/dCH8shBMqgM=; b=KqTngBppoUManKve9dVutmMRjD2ne+ibKeJjX0o9ZKpMnwic4Hr1rzxdGu6IXVqoly bAIB0ZpU+FJicYF01hdEBH0IdjlAyCmCs3j20qs0mUUfxGWTjbyIZ+hYBTHK2ayK0/LW JqjS25p3UqU9x3wYbt+V++WHSs7mQzYEu7pmkJAO6WWKWusNVIenyM14RMo6hbXtm+Oe aQsU0iw1ZUAqLbvHpfAkCS5nS+cAlvTDHLa1ofIn9AICjX2llHMYx/LjL02l8PUE/K57 db4+Qw4rzYO8G/ZdTavvryGm2J4Di89CiKtU6LTcNhjNL72YEUYqIrUYpq7JxyWPYoBn 7fZQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1735838565; x=1736443365; h=to:subject:message-id:date:mime-version:references:from :x-gm-message-state:from:to:cc:subject:date:message-id:reply-to; bh=VC8im9qxHgkrKHrig3OEEXgtwCxAbOs/dCH8shBMqgM=; b=qndjKvLBYiGEmZBO86o8eDCyMvHiq8uF4iFlxnaLh6f7sCCU3+0CN3gaeKTh/T/8TO SQ+7/x4beENOejp6Pnx7tpr7eOs0E64JUr4baUpvz3ovTwOJlnLoTloBquaOaSTYOsOr /+zJhqZUrUa9vgyhKxHWS2atY8HCMQ2xgQYceGabVt7On5ZYwhNfGzz8iOPJtuodlls3 flT5a3Kf6neOn729tDEKACxGxtpkbFgI4F2eoqh85TVpHkm4lBaxP28LS9l+a3qE19Qr IbZpzj4PLhhMa3l71vAgIo9IooYuMAn9AU8s9yu/IDDCw97y0Rk43kXA0EMElQDxdrJb UR4A== X-Gm-Message-State: AOJu0YwkMP6JD5E5fQXHOOVT/oECyVVFFHKG4O190mWSil0hcqkGRpSS VQzZZ2wxRbbel17yAdFtCbOuJ8lSldqrMU6Z14+wj/moh7JnO+k/iICEU14fEV62FnqaVE7Hbzy 6RuZFOeFDnJiYzMafG9hc5xsx7UiHufXlcpO/xw== X-Gm-Gg: ASbGncv9Qiu8jIr0PCV0EvV7tefNPSXAy9S/NXX3eQXf6gowGq/+KGkQV6aY2vElWiM 6LnKBgE1nubp+ZToNns35esUAOYE5Bj8PvL16Qqs= X-Google-Smtp-Source: AGHT+IHGrM1jjgXqqzgcAfhydXsXu3CG0gsuVbyeGY8XTArOsYcHKusIf3PMTdljZhqAXH3bzKhYov8fGA5ZQRf+j68= X-Received: by 2002:a05:6402:4492:b0:5cf:d19c:e21c with SMTP id 4fb4d7f45d1cf-5d81ddec945mr46470107a12.20.1735838565042; Thu, 02 Jan 2025 09:22:45 -0800 (PST) Original-Received: from 753933720722 named unknown by gmailapi.google.com with HTTPREST; Thu, 2 Jan 2025 11:22:44 -0600 Received-SPF: pass client-ip=2a00:1450:4864:20::52d; envelope-from=stefankangas@gmail.com; helo=mail-ed1-x52d.google.com X-Spam_score_int: -20 X-Spam_score: -2.1 X-Spam_bar: -- X-Spam_report: (-2.1 / 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, FREEMAIL_FROM=0.001, RCVD_IN_DNSWL_NONE=-0.0001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001 autolearn=ham autolearn_force=no X-Spam_action: no action 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-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Xref: news.gmane.io gmane.emacs.bugs:298198 Archived-At: Severity: wishlist I'm forwarding this to the bug tracker so that we don't lose track of it. Alan, any comments here? -------------------- Start of forwarded message -------------------- From: Richard Stallman To: emacs-devel@gnu.org Subject: remove-pos-from-symbol and bare-symbol Date: Sun, 10 Mar 2024 22:39:23 -0400 [[[ 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. ]]] The doc string of remove-pos-from-symbol says to compare it with bare-symbol. The doc strings are too sketchy to make clear what the difference is. Someone who knows should make that clear. Is the difference what they do to an argument that is not a symbol? If so, it would be good to state that explicitly in the doc string of bare-symbol. "If need be" is not explicit, not concrete. I tried looking at the macros they call, which are in lisp.h. But those don't have doc strings and just call other functions that have no comments to say what they do. The macros and inline functions in lisp.h need to be documented there. -- 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) -------------------- End of forwarded message --------------------