From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Michael Heerdegen Newsgroups: gmane.emacs.bugs Subject: bug#48768: Introducing ability to append to docstring Date: Tue, 01 Jun 2021 16:08:21 +0200 Message-ID: <87bl8py8x6.fsf@web.de> References: Mime-Version: 1.0 Content-Type: text/plain Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="33777"; mail-complaints-to="usenet@ciao.gmane.io" User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/28.0.50 (gnu/linux) Cc: ludvig-faddeev@gmx.com, 48768@debbugs.gnu.org To: Richard Stallman Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Tue Jun 01 16:10:34 2021 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 1lo56I-0008aM-5l for geb-bug-gnu-emacs@m.gmane-mx.org; Tue, 01 Jun 2021 16:10:34 +0200 Original-Received: from localhost ([::1]:55236 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1lo56E-0005Nm-KV for geb-bug-gnu-emacs@m.gmane-mx.org; Tue, 01 Jun 2021 10:10:30 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:52228) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1lo54o-00035n-R5 for bug-gnu-emacs@gnu.org; Tue, 01 Jun 2021 10:09:02 -0400 Original-Received: from debbugs.gnu.org ([209.51.188.43]:54169) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1lo54o-0001XN-3f for bug-gnu-emacs@gnu.org; Tue, 01 Jun 2021 10:09:02 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1lo54n-0000vK-Vi for bug-gnu-emacs@gnu.org; Tue, 01 Jun 2021 10:09:01 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Michael Heerdegen Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Tue, 01 Jun 2021 14:09:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 48768 X-GNU-PR-Package: emacs Original-Received: via spool by 48768-submit@debbugs.gnu.org id=B48768.16225565113510 (code B ref 48768); Tue, 01 Jun 2021 14:09:01 +0000 Original-Received: (at 48768) by debbugs.gnu.org; 1 Jun 2021 14:08:31 +0000 Original-Received: from localhost ([127.0.0.1]:37482 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1lo54I-0000uX-VI for submit@debbugs.gnu.org; Tue, 01 Jun 2021 10:08:31 -0400 Original-Received: from mout.web.de ([212.227.17.11]:44319) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1lo54H-0000uJ-8z for 48768@debbugs.gnu.org; Tue, 01 Jun 2021 10:08:29 -0400 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=web.de; s=dbaedf251592; t=1622556502; bh=wJRZpx6+t5/Fv6USQtfiBqbAVaXEbzYSXDWE6ykqP+s=; h=X-UI-Sender-Class:From:To:Cc:Subject:References:Date:In-Reply-To; b=rqYsVen7LaoQNXB0ImhO4iFUrNaYXINIGXXEhlO1LSYpO6ZECw6xFhRC6cWZQH7xj mvKw086XaExnaLWoFQkVwRQEI6ynC9xqZrtkRGyKA6ah7ByGmXxF5JZB/hVwXbGhvV X05pX/uuVjTMZLczr5dZte2k5uhGE2RHMYg9Arx0= X-UI-Sender-Class: c548c8c5-30a9-4db5-a2e7-cb6cb037b8f9 Original-Received: from drachen.dragon ([94.218.219.0]) by smtp.web.de (mrweb101 [213.165.67.124]) with ESMTPSA (Nemesis) id 0MddBI-1m2PzG2X7s-00PMIZ; Tue, 01 Jun 2021 16:08:22 +0200 In-Reply-To: (Richard Stallman's message of "Tue, 01 Jun 2021 00:53:44 -0400") X-Provags-ID: V03:K1:DsIQHRz50VYu9aQ2g52tXGmYLXHY6Y91baKWo1Eeh/D+ubFZPzX eHlbLqluh9lfJDbR4hhamyHvQ0UbKtC/7CMtatM6zNYIdztYFbIzhDntBibBe/54gooc3ur 8nr+ZkyMzEb66RxK5Fk04kdGztts2PJC3p5e5S+zmElDAjYi7z2R7SI+UsC/0abpGtmuQV7 qrfNB2/FZGTn5ZSx0qC+Q== X-UI-Out-Filterresults: notjunk:1;V03:K0:BmifbjDfWts=:cpdP3r3K2eyz5kxF+Y6YWW BcoEWHBQxFCA3IkDQhVUFK/EpVA5qzmMEbkqpa9Gm8xaS6XXIK4jdmSvFdtZCKVG20nOtkNJB h3u+vLru/VqxkzK0EYSmnFhykUp8kq14xfDQ+YBWVp8AMxuklJWLlYxGGqVozCClZCwogB5qC OcZMSRl9JOWoUbTxcsOE4u4psJ836dtocqp/qNqf+LVzQHhftqkrDPsZnlbq8Nk9uUYkQUQwi cl7oROjHlNTxfgcJxhvACKeyFRze872JjNWtXQ08/Gdzltf+YsvlXp5cLtzY24p4l1vGT28vO PTKHaH8/icJBei0GyXao3pO5SEyMWhgRJF8+oP+1VtygkqU5uGUdlFnDzgkBeR9Q10WcESa6/ c4ELuIZS/PglRlU9490eQIq+3iAfR2LQvBxfa2pEJGKGlIw5fDKwUusjqbdJqYjgDoZ9ex1lt LOj2NZYnBdcTuLw+LRhzOoa5vM99GxS9SFsQfuo2tTZ3675fzTV5rAf/eZz1SLkd32VIWlzV8 O2Xc2v5F8qlq8BVTIseAaWEtFuXdjm4F4H037HYar3n2rYLHpuMc7PBsCGHNS7JOSaOpYiIKx 7AA7EWfWikuB/PTww3NECBgN4IwJqIP8CUSZx2/8NCKlDtS4bC4Uh2X3f89o52XYNRq26Ixyr smGX/8XA00Zj40OWHI/uHZdZEjJ+/RlTR++aI1OAYGoyBaHLh/kLqkK80okAyJ81MTqI0RHLX Ez6Uqq/VzWgUPXb1pUWj9HXINi9Uzii3SB+bXkCa/jRmhdH4IAuYdG4szNWR6kFQ7HTLZAav 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:207777 Archived-At: Richard Stallman writes: > > A useful capability would allow one to append to a defun docstring > > using a defvar. > > > User could write a brief description for the docstring, and later > > append more details > > from a defvar. > > Could you show an example of what this would look like, in use? > > I'm trying to guess -- though I don't have confidence in my guess -- > and I think this might be a useful feature but would be easier to use > with a different interface. We already have the `function-documentation' symbol property, no? I wonder what use cases the OP has in mind for that that interface we have is not sufficient and why the suggested interface would be more appropriate. Michael.