From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.ciao.gmane.io!not-for-mail From: Eli Zaretskii Newsgroups: gmane.emacs.bugs Subject: bug#41026: Improve documentation of `makunbound' and `fmakunbound' Date: Sat, 02 May 2020 17:22:39 +0300 Message-ID: <83o8r6s9g0.fsf@gnu.org> References: <83sggisacb.fsf@gnu.org> <87pnbm4e1r.fsf@stefankangas.se> Injection-Info: ciao.gmane.io; posting-host="ciao.gmane.io:159.69.161.202"; logging-data="3071"; mail-complaints-to="usenet@ciao.gmane.io" Cc: 41026@debbugs.gnu.org To: Stefan Kangas Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Sat May 02 16:23:13 2020 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 1jUt2v-0000hj-7b for geb-bug-gnu-emacs@m.gmane-mx.org; Sat, 02 May 2020 16:23:13 +0200 Original-Received: from localhost ([::1]:59344 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1jUt2u-0004EN-73 for geb-bug-gnu-emacs@m.gmane-mx.org; Sat, 02 May 2020 10:23:12 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:34548) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1jUt2l-000474-HV for bug-gnu-emacs@gnu.org; Sat, 02 May 2020 10:23:04 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.90_1) (envelope-from ) id 1jUt2k-00044A-44 for bug-gnu-emacs@gnu.org; Sat, 02 May 2020 10:23:02 -0400 Original-Received: from debbugs.gnu.org ([209.51.188.43]:42046) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1jUt2j-00042t-NF for bug-gnu-emacs@gnu.org; Sat, 02 May 2020 10:23:01 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1jUt2j-0000IQ-Ir for bug-gnu-emacs@gnu.org; Sat, 02 May 2020 10:23:01 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Eli Zaretskii Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sat, 02 May 2020 14:23:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 41026 X-GNU-PR-Package: emacs Original-Received: via spool by 41026-submit@debbugs.gnu.org id=B41026.15884293791119 (code B ref 41026); Sat, 02 May 2020 14:23:01 +0000 Original-Received: (at 41026) by debbugs.gnu.org; 2 May 2020 14:22:59 +0000 Original-Received: from localhost ([127.0.0.1]:53592 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1jUt2g-0000Hx-V1 for submit@debbugs.gnu.org; Sat, 02 May 2020 10:22:59 -0400 Original-Received: from eggs.gnu.org ([209.51.188.92]:59728) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1jUt2c-0000Hi-2r for 41026@debbugs.gnu.org; Sat, 02 May 2020 10:22:57 -0400 Original-Received: from fencepost.gnu.org ([2001:470:142:3::e]:58474) by eggs.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1jUt2W-0003PK-3P; Sat, 02 May 2020 10:22:48 -0400 Original-Received: from [176.228.60.248] (port=4574 helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_256_CBC_SHA1:256) (Exim 4.82) (envelope-from ) id 1jUt2V-00068v-A3; Sat, 02 May 2020 10:22:47 -0400 In-Reply-To: <87pnbm4e1r.fsf@stefankangas.se> (message from Stefan Kangas on Sat, 02 May 2020 16:17:04 +0200) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list X-Received-From: 209.51.188.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-mx.org@gnu.org Original-Sender: "bug-gnu-emacs" Xref: news.gmane.io gmane.emacs.bugs:179512 Archived-At: > From: Stefan Kangas > Cc: 41026@debbugs.gnu.org > Date: Sat, 02 May 2020 16:17:04 +0200 > > >> +The corresponding operation for functions is `fmakunbound'. */) > > ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ > > The "corresponding" part isn't accurate, is it? > > Sorry, I thought it was. But my understanding of this is probably > much too naive. > > Would we avoid the inaccuracy by deleting the word "corresponding"? I'd just say "See also `fmakunbound'". And the same in the fmakunbound doc string. Btw, why the link to the manual? Does the manual say something important that the doc strings don't? If it does, perhaps we should make the laconic doc string slightly more elaborate?