From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.ciao.gmane.io!not-for-mail From: Richard Stallman Newsgroups: gmane.emacs.bugs Subject: bug#41026: Improve documentation of `makunbound' and `fmakunbound' Date: Sun, 03 May 2020 23:06:39 -0400 Message-ID: References: <83sggisacb.fsf@gnu.org> <87pnbm4e1r.fsf@stefankangas.se> <83o8r6s9g0.fsf@gnu.org> <87a72q3wyy.fsf@stefankangas.se> <878siarqhc.fsf@igel.home> Reply-To: rms@gnu.org Content-Type: text/plain; charset=Utf-8 Injection-Info: ciao.gmane.io; posting-host="ciao.gmane.io:159.69.161.202"; logging-data="75992"; mail-complaints-to="usenet@ciao.gmane.io" Cc: stefan@marxist.se, 41026@debbugs.gnu.org To: Andreas Schwab Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Mon May 04 05:07:18 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 1jVRRt-000Jfo-2h for geb-bug-gnu-emacs@m.gmane-mx.org; Mon, 04 May 2020 05:07:17 +0200 Original-Received: from localhost ([::1]:45704 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1jVRRs-0004cq-4c for geb-bug-gnu-emacs@m.gmane-mx.org; Sun, 03 May 2020 23:07:16 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:34310) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1jVRRe-0004ZB-1x for bug-gnu-emacs@gnu.org; Sun, 03 May 2020 23:07:02 -0400 Original-Received: from debbugs.gnu.org ([209.51.188.43]:47168) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1jVRRd-0003Gh-Ok for bug-gnu-emacs@gnu.org; Sun, 03 May 2020 23:07:01 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1jVRRd-0002MR-KY for bug-gnu-emacs@gnu.org; Sun, 03 May 2020 23:07:01 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Richard Stallman Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Mon, 04 May 2020 03:07: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.15885616109056 (code B ref 41026); Mon, 04 May 2020 03:07:01 +0000 Original-Received: (at 41026) by debbugs.gnu.org; 4 May 2020 03:06:50 +0000 Original-Received: from localhost ([127.0.0.1]:58714 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1jVRRR-0002Lz-SP for submit@debbugs.gnu.org; Sun, 03 May 2020 23:06:50 -0400 Original-Received: from eggs.gnu.org ([209.51.188.92]:59492) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1jVRRQ-0002Lm-2p for 41026@debbugs.gnu.org; Sun, 03 May 2020 23:06:48 -0400 Original-Received: from fencepost.gnu.org ([2001:470:142:3::e]:43947) by eggs.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1jVRRK-00034g-PB; Sun, 03 May 2020 23:06:42 -0400 Original-Received: from rms by fencepost.gnu.org with local (Exim 4.82) (envelope-from ) id 1jVRRH-0008Qf-1k; Sun, 03 May 2020 23:06:39 -0400 In-Reply-To: <878siarqhc.fsf@igel.home> (message from Andreas Schwab on Sat, 02 May 2020 23:12:15 +0200) 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:179655 Archived-At: [[[ 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. ]]] > Why do these unimportant functions that almost nobody needs require such > elaborate doc strings? So that those people who may want to use them, even if they are few, can be sure of how to use them. The cost of writing full and clear doc strings is some work, but once that work is done, it costs nothing to have them in the source files. -- Dr Richard Stallman Chief GNUisance of the GNU Project (https://gnu.org) Founder, Free Software Foundation (https://fsf.org) Internet Hall-of-Famer (https://internethalloffame.org)