From debbugs-submit-bounces@debbugs.gnu.org Mon May 31 20:07:16 2021 Received: (at submit) by debbugs.gnu.org; 1 Jun 2021 00:07:17 +0000 Received: from localhost ([127.0.0.1]:35286 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1lnrw4-0005zJ-J8 for submit@debbugs.gnu.org; Mon, 31 May 2021 20:07:16 -0400 Received: from lists.gnu.org ([209.51.188.17]:38212) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1lnrw2-0005zB-CJ for submit@debbugs.gnu.org; Mon, 31 May 2021 20:07:06 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]:42646) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1lnrw2-0004RL-3o for bug-gnu-emacs@gnu.org; Mon, 31 May 2021 20:07:06 -0400 Received: from mout.gmx.net ([212.227.15.15]:37005) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1lnrw0-00025I-81 for bug-gnu-emacs@gnu.org; Mon, 31 May 2021 20:07:05 -0400 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=gmx.net; s=badeba3b8450; t=1622506022; bh=uGjefbMNX2ABQEeD9jFOFiskXS0SIDCZCulwyWFheII=; h=X-UI-Sender-Class:From:To:Subject:Date; b=FvzOm7b3MmZVOzkRjwio+yUvAaaQFhmuR6982OhsWyTNw+5FWbw29SMghPRcG+73+ RDkRglzk2zF1Mqhh/QwNmCqcG3Lb29GHR9HmH5XN405CaKBBcLgvhxK6pirNq0lEoA DROi66BLC2iSORuKWyan3aGVzO5JlJxbzNhUIL/0= X-UI-Sender-Class: 01bb95c1-4bf8-414a-932a-4f6e2808ef9c Received: from [213.165.168.94] ([213.165.168.94]) by web-mail.gmx.net (3c-app-mailcom-bs01.server.lan [172.19.170.58]) (via HTTP); Tue, 1 Jun 2021 02:07:02 +0200 MIME-Version: 1.0 Message-ID: From: ludvig-faddeev@gmx.com To: bug-gnu-emacs@gnu.org Subject: Introducing ability to append to docstring Content-Type: text/plain; charset=UTF-8 Date: Tue, 1 Jun 2021 02:07:02 +0200 Importance: normal Sensitivity: Normal X-Priority: 3 X-Provags-ID: V03:K1:8+TJfzYEJ0nURsqlAHouCARNGeSuFAeM3vdPjjDYN8cr5vUO2GDVlqY4ZlLPnt27Q1jSD fdhB6kfHrPjDegTjPxzBxK/aq/BYnF+hmZOihKAn3kdXLgxUQtL7T377i1bH+UymdQ7XTWzRCch+ KtNSY1SD0bDp4h5hyFnwLoupz91CK4eRgnmTBRh95UZyST60c4MSEGzoP5P9ch0KRq35VuAQQDjY F2+YmXRsdkDipoaNuAWslqn9OLGslUPok/zx5Ld+9qNTC/P9UoF//FppqbTJ7mPJgFoj3vmIkG3R QI= X-Spam-Flag: NO X-UI-Out-Filterresults: notjunk:1;V03:K0:NqVsYCX2BIU=:TDBBtwxsPWAANsUIZ0Zh12 W3kac+Jfnis3qyhUtKl04o+jVOTEAjc77tycw0PYhfetpzwAYxJPY1WGnwgQY7/wNm6TLjQqh W6Dm6ILL058KVZNtMaVuEpa7h/HB4DTW39mnX3nTI+CPie1ChD7gwNvWlfmZVAgjtrGcP+quP T7fAjns0oTK+pv9dbWy4eiN3priTm3R7wHosX9cmNMFGA0r4tuHi9WHAf7Ildxo7vpeRjE6k4 H65HHDq3Ud+Y9GUw8ZNtksUKDmhyUXCFDxjDhRUcZN0DY8w7nBG2AtXFmkStFrXp+IjUY+Sfb /nlAVrqN3mMYBI7NBlvf1m28xkailwj6dlf8M8MlUqb3FMvmYFov7AGPJgI2+s/U2X6vGXMse Sz9WWs7tnO9sAxtYCesA59ixMJbCj+Ww8ZKja7o0NsbYniIHgZn/XLQrptGTzm75bOmwnlYwT QXF5dAwMFlI125/yvnz6nDfpAXKfjWgf4D2XUmg+R4kYXteeBxrXH7prN04jPaTR8LwXloyLW ejxqoRwafOf8g2VLj+k7kmIbcNjYkS54HM8ROFZfL4ndd8+t9AYqhLR/4+C55kLF6xi6fuY1R 9XwZseGPBD36IImMe4x6o2ucFyCThAKDs6SeZIr87okm6tAVne//Y0c//BmYOk+1N5nsIx4Wa 1a253VzoT5cNQbwdf3DlomTpPp/COisbUzJpdXQ6fvtNWDaxNbj4YrpsZfUVvMFEaO8g2iRLe W3XZDB1wPsHy+lrKIkju3uV4pBF3kjIhDJxd1xL9P5RbCGQBK5gzfwzBmJTuJB61gc/tSpye1 C/UV5umqgWqJIlCIUthAofrHBb+NNRj8s3Y81QA2dxQwcwyAv1b3dtuaGPGA3IOG1Yx1h0J8e WxxGPEfG9aPyEWzAHjNrTgg0pJyKMRJwuPlEbvSqf33E2svN/al4qsp8G0Rdni02lSqDDC91g PXnrE+0Y0Xg== Received-SPF: pass client-ip=212.227.15.15; envelope-from=ludvig-faddeev@gmx.com; helo=mout.gmx.net X-Spam_score_int: -18 X-Spam_score: -1.9 X-Spam_bar: - X-Spam_report: (-1.9 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, FREEMAIL_FROM=0.001, RCVD_IN_DNSWL_NONE=-0.0001, RCVD_IN_MSPIKE_H3=0.001, RCVD_IN_MSPIKE_WL=0.001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001 autolearn=ham autolearn_force=no X-Spam_action: no action X-Spam-Score: 0.6 (/) 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: -3.3 (---) 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. I like my functions to be succinct without an overly long docstring. This makes the implementation code readily displayed on the visible window, without having to scroll through an excessively long documentation string. From debbugs-submit-bounces@debbugs.gnu.org Tue Jun 01 00:53:53 2021 Received: (at 48768) by debbugs.gnu.org; 1 Jun 2021 04:53:53 +0000 Received: from localhost ([127.0.0.1]:35435 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1lnwPZ-0004R4-DP for submit@debbugs.gnu.org; Tue, 01 Jun 2021 00:53:53 -0400 Received: from eggs.gnu.org ([209.51.188.92]:53418) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1lnwPW-0004Qp-NH for 48768@debbugs.gnu.org; Tue, 01 Jun 2021 00:53:52 -0400 Received: from fencepost.gnu.org ([2001:470:142:3::e]:44192) by eggs.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1lnwPR-0002Rh-Ae; Tue, 01 Jun 2021 00:53:45 -0400 Received: from rms by fencepost.gnu.org with local (Exim 4.90_1) (envelope-from ) id 1lnwPQ-0002Bd-VR; Tue, 01 Jun 2021 00:53:45 -0400 Content-Type: text/plain; charset=Utf-8 From: Richard Stallman To: ludvig-faddeev@gmx.com In-Reply-To: (ludvig-faddeev@gmx.com) Subject: Re: bug#48768: Introducing ability to append to docstring References: Message-Id: Date: Tue, 01 Jun 2021 00:53:44 -0400 X-Spam-Score: -2.3 (--) X-Debbugs-Envelope-To: 48768 Cc: 48768@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. ]]] > 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. -- 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 Tue Jun 01 10:08:31 2021 Received: (at 48768) by debbugs.gnu.org; 1 Jun 2021 14:08:31 +0000 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 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 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 From: Michael Heerdegen To: Richard Stallman Subject: Re: bug#48768: Introducing ability to append to docstring References: Date: Tue, 01 Jun 2021 16:08:21 +0200 In-Reply-To: (Richard Stallman's message of "Tue, 01 Jun 2021 00:53:44 -0400") Message-ID: <87bl8py8x6.fsf@web.de> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/28.0.50 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain X-Provags-ID: V03:K1:DsIQHRz50VYu9aQ2g52tXGmYLXHY6Y91baKWo1Eeh/D+ubFZPzX eHlbLqluh9lfJDbR4hhamyHvQ0UbKtC/7CMtatM6zNYIdztYFbIzhDntBibBe/54gooc3ur 8nr+ZkyMzEb66RxK5Fk04kdGztts2PJC3p5e5S+zmElDAjYi7z2R7SI+UsC/0abpGtmuQV7 qrfNB2/FZGTn5ZSx0qC+Q== X-Spam-Flag: NO 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/jRmhdH4IAuYdG4szNWR6kFQ7HTLZAavx ZqgIRWIGPP9oLONoYyn6AQMR+Am57QCjz1DqMC2gG4C7f7lX0ne64VMvqXu6c7O1s9AoA+Vwi TzBBNRliwjgKRQEBYVwpNhPsBmTAvhqY/8GeIrSoQvq/xkZxKJqB3UeZNuHMIyDTSzyosUx/2 D9BdtLQ7CZcizxT9qCLu90LO6KW9BP/DqtzUBOvVxgBXt8HW/999rjtSew+h59Ago1aW+plkJ A7WYz3U95tLcs9zkEEPJecR+97xXYTfcOAAG9bYNFIyoVi2J0gp7/GN/keF0KJDvsStWNZfae 4PYiwlSEy1j+2oecSi8ltUwcswqYh9578hEY7umzIoA8sRqYdo4qXJ3RQ== X-Spam-Score: 0.0 (/) X-Debbugs-Envelope-To: 48768 Cc: ludvig-faddeev@gmx.com, 48768@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.0 (-) 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. From debbugs-submit-bounces@debbugs.gnu.org Tue Jun 01 10:44:28 2021 Received: (at 48768) by debbugs.gnu.org; 1 Jun 2021 14:44:28 +0000 Received: from localhost ([127.0.0.1]:37513 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1lo5d5-0001nR-Ux for submit@debbugs.gnu.org; Tue, 01 Jun 2021 10:44:28 -0400 Received: from userp2120.oracle.com ([156.151.31.85]:51102) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1lo5d3-0001n7-OX for 48768@debbugs.gnu.org; Tue, 01 Jun 2021 10:44:26 -0400 Received: from pps.filterd (userp2120.oracle.com [127.0.0.1]) by userp2120.oracle.com (8.16.0.42/8.16.0.42) with SMTP id 151Ee8BJ113111; Tue, 1 Jun 2021 14:44:19 GMT DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=oracle.com; h=from : to : cc : subject : date : message-id : references : in-reply-to : content-type : content-transfer-encoding : mime-version; s=corp-2020-01-29; bh=H5132VQhP4gGboTiIEusvOCiDNlCvRi+Eh4CUSoiiL4=; b=ibrvaRifmRiUMtKf2fzgrglSJnwEYHeT/pigoeBZry3Eui81E68j+5qLVCB0LHkL550r YLM7gAr4q1uhNQM2mKxqsDFG0nTAvcyp9TwLC6IfDqcXq3dh+mjRNJ6HGmiRXZcDC5yr 2QfVJk2JagzNNpvUJr+OHC/VHtngOum0QqOuEbTOYZPDajqM1zX/R5flriZ3wraUBk2B 00sqsFxAQXPrIp5Vrd/3A5BDrylhGDakj619oaoqilSpeRWJBvcrxsUmIHPlKOanNLwF 5L22yoaa1e4t+TvLKndjP04Wwg0vEWI3+D7zz263IPSPYJpJtLxwvn4ADBg7fgE+AZuZ Qw== Received: from aserp3020.oracle.com (aserp3020.oracle.com [141.146.126.70]) by userp2120.oracle.com with ESMTP id 38ue8pdr3n-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Tue, 01 Jun 2021 14:44:19 +0000 Received: from pps.filterd (aserp3020.oracle.com [127.0.0.1]) by aserp3020.oracle.com (8.16.0.42/8.16.0.42) with SMTP id 151EZIIf165787; Tue, 1 Jun 2021 14:44:18 GMT Received: from nam10-bn7-obe.outbound.protection.outlook.com (mail-bn7nam10lp2109.outbound.protection.outlook.com [104.47.70.109]) by aserp3020.oracle.com with ESMTP id 38ude93ka1-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Tue, 01 Jun 2021 14:44:18 +0000 ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=ARlS/rOKsLaQlp5nGRZlxChImr/SKbeSuDZRfhHWJZ6IZoT1ijQ+Vewz4UQXfuLEfpKLwQ/+nyIcRbpM6XiU+ECBcD22dYjRa0ex7ad3oMHkabZIu/yBM1v9jlGMMvwr3pUiV5d4VzZtHpGHaUdz4gvTvPY69kvGma2KoMoshyRfiWHY/7p4F+gKFHsiCmjSpHfdhwbHy4MKYgng+axYtps7s3mcY+4zzKi9cijGylFz4jquJMWR9dp4dHuVUGilod56oWQtiA3QfTy+giw6+B8ZpzE+1Q4JIIkhrgtRwW07rAVelDVFaF6UeK6grNCKhNepryZP6aN68bPAV+N/4g== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=microsoft.com; s=arcselector9901; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=H5132VQhP4gGboTiIEusvOCiDNlCvRi+Eh4CUSoiiL4=; b=X4ene11tLiUxbFeQ6qaNRrEFcKKZQbm7mq1QKeOWIj+DgpkXMR1lsyPf2kwh2R5/fjmVzU/GWLH5GeiiRHozHi8UfuU3MOebpPcsdr5J21i12Qtf+ea4u9EsunFy4MlMG9PfIjzcS6FTx84xI5RusZNujA9AybuvJuYQU2j2gYKiPngqm2GTrQLmj3SOMQI75wRvIkR/sTVV1/r4em6u5YS7DKHlDZvkjudGjoq/sYsTDqZPp/P/1ryMOBtiXbCHwP5fP9TgExITTiPKAz26U9+gXPM25ZBX92OcukRTIpKQLLy726gCWWLSg4c/CQ0ZL/QHN++AiVkcRlGbUZXvsQ== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass smtp.mailfrom=oracle.com; dmarc=pass action=none header.from=oracle.com; dkim=pass header.d=oracle.com; arc=none DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=oracle.onmicrosoft.com; s=selector2-oracle-onmicrosoft-com; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=H5132VQhP4gGboTiIEusvOCiDNlCvRi+Eh4CUSoiiL4=; b=OT6uTN/iPsSlruXBLe9GQf9VSD2U7ILyUT9iYD2+bAmYIG7u8HvMhT20/j0QT2T6nJ+9B8pPgZgqbvlOoV+wqN5hue5rBdp26PFn4nTw7ZLbGwWNGE3dfOanglFWou1NhnFdWbQrwHvMCEMfMfh5sO4aoJbGK7EK+duNTa9YWDc= Received: from SA2PR10MB4474.namprd10.prod.outlook.com (2603:10b6:806:11b::15) by SA2PR10MB4442.namprd10.prod.outlook.com (2603:10b6:806:11a::21) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.4173.24; Tue, 1 Jun 2021 14:44:16 +0000 Received: from SA2PR10MB4474.namprd10.prod.outlook.com ([fe80::2109:9725:fd4a:6494]) by SA2PR10MB4474.namprd10.prod.outlook.com ([fe80::2109:9725:fd4a:6494%6]) with mapi id 15.20.4173.030; Tue, 1 Jun 2021 14:44:16 +0000 From: Drew Adams To: Michael Heerdegen , Richard Stallman Subject: RE: [External] : bug#48768: Introducing ability to append to docstring Thread-Topic: [External] : bug#48768: Introducing ability to append to docstring Thread-Index: AQHXVu/e38fFisylUEG5l/mgWMITd6r/NVXQ Date: Tue, 1 Jun 2021 14:44:16 +0000 Message-ID: References: <87bl8py8x6.fsf@web.de> In-Reply-To: <87bl8py8x6.fsf@web.de> Accept-Language: en-US Content-Language: en-US X-MS-Has-Attach: X-MS-TNEF-Correlator: authentication-results: web.de; dkim=none (message not signed) header.d=none;web.de; dmarc=none action=none header.from=oracle.com; x-originating-ip: [73.170.83.28] x-ms-publictraffictype: Email x-ms-office365-filtering-correlation-id: 441c9e3f-af20-4878-cef0-08d9250bbb36 x-ms-traffictypediagnostic: SA2PR10MB4442: x-microsoft-antispam-prvs: x-ms-oob-tlc-oobclassifiers: OLM:10000; x-ms-exchange-senderadcheck: 1 x-microsoft-antispam: BCL:0; x-microsoft-antispam-message-info: r+d4CMXN2C2/bw95uEQOUlQZlkBuZ0vcInSDZ2ZBQiQQR5COhsyoEhUpvZzDCeo4dfvyTLkyezZ7DD6Z8rF5uqSUstRQxr5y27OY7h5GWDjXCn9TjSaHH38+QoEwgx5mvAI3kYoUs9NWvgQ6p5HToPqA3JkpnhJ0Gd7c1p0XA2ZCDUspZHjchbsAmAUJcX569Hodo8PY7xAYyQPzDpFkocrGAM1CrkJWEVn0DyhhLpOmFeqBv2OdsIOYrMbKr1RtW9jb+bjdbx/zbnQtZkWCIJHGVA1XltBTt8JRkKzuUsWlaWDvLZA6FuT3SIHRmeR0DtPpGmr2zGYgHyjqSnWKKyuE8hR91EGvlzvVR5+Ku2wpXhKD1bte4e2oiM/nvpjHEx/vFS+C1BZZubgcLdypnbHD4KsjR8qxfgYrDqmXIZzO/XZkB3GW5ZhshYNKo+t1IY+LzmxlvDEVjK8cgD3BCV+ZS2i3Hq/2sOR2E95FPncBq20BG8HZ0I83Sjc/wvpK+w5LzkU5DSApApWj5HE9rNyKtQegLb6KAIeHjgnx7Dy1JfDMWnLpGgpbFslL4qrnuXMUfSTZhT2winDooQ6TYkCIBCkhAWUw68c9r29DNl8= x-forefront-antispam-report: CIP:255.255.255.255; CTRY:; LANG:en; SCL:1; SRV:; IPV:NLI; SFV:NSPM; H:SA2PR10MB4474.namprd10.prod.outlook.com; PTR:; CAT:NONE; SFS:(346002)(136003)(366004)(376002)(396003)(39860400002)(4326008)(55016002)(8936002)(8676002)(66946007)(71200400001)(478600001)(66556008)(44832011)(2906002)(64756008)(9686003)(76116006)(186003)(66476007)(7696005)(110136005)(122000001)(66446008)(38100700002)(5660300002)(33656002)(316002)(54906003)(86362001)(83380400001)(26005)(6506007)(52536014); DIR:OUT; SFP:1101; x-ms-exchange-antispam-messagedata: =?us-ascii?Q?T7/3d9i/rpQt+ZaC7MNvLZVXlpigJU7jH6ZFUzDNWgY4hZh+GTmue5wQ4rYR?= =?us-ascii?Q?R1GtcylHmzsgFn2htaznrkJe+iUAxs7CO4UWgUwYZM6fwr6LzJc/7oyJNr8h?= =?us-ascii?Q?XpHd2JAlUi25Koc4OOrHW3hrrA3YE2wZh6p5FVYZldUMmZOF7GGKipt/sKyO?= =?us-ascii?Q?qHCkMMyzIgCvrXMrd48A0ypdLFydOiz08aGfpEPxXBhCqirGP3VYRzufp6O1?= =?us-ascii?Q?cutWI9GI6SJJnmqb9Op/3xmj0P3wcGU2TiPA2MIAu3o0m3xqHiAWmKk/KNuS?= =?us-ascii?Q?fO+9RiL2VCcl3BpO7RVSFHBBKWBY1K2+D1+qihWR5PRqMQ+h5iFs4PtxbHkr?= =?us-ascii?Q?tR+IfevY5jFRlYdpwMZvtySxoSTTRnmf5mHWcThenywRsHeTLEq362rzn+IL?= =?us-ascii?Q?UUW5PcqxImHtu+gvAYQBmkcPiodBRMeMeDUQYB+Ybx6rIkj92faKtnf794b4?= =?us-ascii?Q?yuONWArk6oVIAdTMGHxe62rzCf/tF5qGihff1X4Xr1EPgI6lCi4rEebd4K4o?= =?us-ascii?Q?OKIo21rI77c+BXEwPHviS4nXdUXjCagk0hGnYLoJVUFi9tm3lXoFU1QaF7Yw?= =?us-ascii?Q?P4MfcdcIeaPAtXwpCbbbxhWhtTp5JvJ2wUXsYxq8jGbTPXbLFahfOj8Jlct+?= =?us-ascii?Q?udZ4hLCbKr03x1BW5xWWRQWhCjBgn78aFSNXperxlqZbyfg1Sysko6hERoAe?= =?us-ascii?Q?0M9vM3swTGZD2vQPzgeKBXdNpSbImTyEg7jOHKyZnksuw6wRDK3O8ncrTKLQ?= =?us-ascii?Q?tcm0I8Ls6dKTWXD/CXhfXJDHpeLszcsEUGI7Eh26CIogoZCkZPXcGRJoiISc?= =?us-ascii?Q?z0gpgTkS5FMQl4iM5oNCRMjBzCKJEiOHCdkhtm3OPI/0bpz7opkPmohrW0L8?= =?us-ascii?Q?ZsA9HOaZlkT5X3jrR4pqoQcGF/01/7F9DzqcZjuFZhB7cxiyIdXyXvI4+b+v?= =?us-ascii?Q?4qGlmSws6jenv8UIzY/tjfYSYlJKycZqVjqw+AMXpES/wk7N56xpR89SaDgJ?= =?us-ascii?Q?Jyr5+kadk3b4u0Lq7xJzIMMg2mx/pAioKfq7YzxWFRCiuMwxFAIyJ+vI7NvO?= =?us-ascii?Q?8TCrF8mhm6910kxafmBU44AQ7mAtvIsivX5BXC6ZJ7+yyRVq15DHZvolIvEI?= =?us-ascii?Q?eJQAUSyfegbWMswIpjxBQZ9dm2y14u0x5JCh+Mt/UlgCafARGeRnUQfnn8VG?= =?us-ascii?Q?IKA6Hxp3j2qcGAkGpHZQht5xdtBWi1veJswa+DrSFku/uVgtZ5sGViCfxkg4?= =?us-ascii?Q?J2dPpH8gGr+A/CxB2/ZnhavW7pqXL5qyUz9I5M2soxnORQwYehuS7XFup1TG?= =?us-ascii?Q?aOU=3D?= x-ms-exchange-transport-forked: True Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: quoted-printable MIME-Version: 1.0 X-OriginatorOrg: oracle.com X-MS-Exchange-CrossTenant-AuthAs: Internal X-MS-Exchange-CrossTenant-AuthSource: SA2PR10MB4474.namprd10.prod.outlook.com X-MS-Exchange-CrossTenant-Network-Message-Id: 441c9e3f-af20-4878-cef0-08d9250bbb36 X-MS-Exchange-CrossTenant-originalarrivaltime: 01 Jun 2021 14:44:16.4469 (UTC) X-MS-Exchange-CrossTenant-fromentityheader: Hosted X-MS-Exchange-CrossTenant-id: 4e2c6054-71cb-48f1-bd6c-3a9705aca71b X-MS-Exchange-CrossTenant-mailboxtype: HOSTED X-MS-Exchange-CrossTenant-userprincipalname: H7JYPgVYPCfFOFoWTlCzmotC4eaFCP537N7FrGwxXzB6GniVqtinV1Z0GUUKuRAztjJhFnCeftL/1VFaEF3m2A== X-MS-Exchange-Transport-CrossTenantHeadersStamped: SA2PR10MB4442 X-Proofpoint-Virus-Version: vendor=nai engine=6200 definitions=10002 signatures=668682 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 malwarescore=0 mlxscore=0 phishscore=0 suspectscore=0 spamscore=0 mlxlogscore=999 adultscore=0 bulkscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.12.0-2104190000 definitions=main-2106010099 X-Proofpoint-GUID: JR4_qMFzbk4JyMdOyENCO4CsKJ0NKMV2 X-Proofpoint-ORIG-GUID: JR4_qMFzbk4JyMdOyENCO4CsKJ0NKMV2 X-Proofpoint-Virus-Version: vendor=nai engine=6200 definitions=10002 signatures=668682 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 mlxscore=0 impostorscore=0 malwarescore=0 adultscore=0 suspectscore=0 lowpriorityscore=0 spamscore=0 bulkscore=0 phishscore=0 priorityscore=1501 clxscore=1011 mlxlogscore=999 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.12.0-2104190000 definitions=main-2106010099 X-Spam-Score: -2.3 (--) X-Debbugs-Envelope-To: 48768 Cc: "ludvig-faddeev@gmx.com" , "48768@debbugs.gnu.org" <48768@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 (---) > > > 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. >=20 > We already have the `function-documentation' symbol property, no? >=20 > 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. Not to mention that you can add to an existing doc string using advice (old advice or new nadvice, AFAIK). ___ In the days before nadvice, the doc addition appeared in-line, as part of the doc you see when you use `C-h f'. Now (unfortunately) we instead insert a link in the `C-h f' help display, and only if you click that link do you see (only) that added doc in *Help*. IOW, you don't get an integrated view of the doc. One could argue that this is a plus, not a minus, as it separates what is provided by the advice. I think this is a loss, but I can see that it could be good for each behavior (integrated or separate) to be possible. Unfortunately, we only have the separate-display (link) behavior, not the integrated-doc behavior. There's one such link for each bit of advice for the function, and there's no indication that any given bit of advice provides more doc. E.g. In my setup command `dired' has two bits of advice, and this is (the start of) what `C-h f dired' shows: ,---- | dired is an interactive autoloaded compiled Lisp function in | 'dired.el'. |=20 | It is bound to C-x d, menu-bar file dired. |=20 | (dired DIRNAME &optional SWITCHES) |=20 | :around advice: 'ad-Advice-dired' | :around advice: 'ls-lisp--dired' |=20 | "Edit" directory DIRNAME--delete, rename, print, etc. some files in it. | Optional second argument SWITCHES specifies the `ls' options used. | (Interactively, use a prefix argument to be able to specify SWITCHES.) | ... `---- 'ad-Advice-dired' and 'ls-lisp--dired' are help links. That first bit of advice, named `ad-Advice-dired', only adds doc to the doc string. Clicking that link shows (only) that additional doc. The second bit of advice adds no doc - it is provided by vanilla Emacs itself (in ls-lisp.el). Clicking that second link shows only this in *Help*: ,---- | ls-lisp--dired is an interactive compiled Lisp function in | 'ls-lisp.el'. |=20 | (ls-lisp--dired ORIG-FUN DIR-OR-LIST &optional SWITCHES) `---- ___ I thought Emacs has a general policy for its code not to use advice, but `ls-lisp.el' does use it: (advice-add 'dired :around #'ls-lisp--dired) From debbugs-submit-bounces@debbugs.gnu.org Tue Jun 01 11:36:31 2021 Received: (at 48768) by debbugs.gnu.org; 1 Jun 2021 15:36:31 +0000 Received: from localhost ([127.0.0.1]:37553 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1lo6RT-0003Db-2X for submit@debbugs.gnu.org; Tue, 01 Jun 2021 11:36:31 -0400 Received: from quimby.gnus.org ([95.216.78.240]:46112) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1lo6RR-0003DK-6B for 48768@debbugs.gnu.org; Tue, 01 Jun 2021 11:36:29 -0400 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnus.org; s=20200322; h=Content-Type:MIME-Version:Message-ID:In-Reply-To:Date: References:Subject:Cc:To:From:Sender:Reply-To:Content-Transfer-Encoding: Content-ID:Content-Description:Resent-Date:Resent-From:Resent-Sender: Resent-To:Resent-Cc:Resent-Message-ID:List-Id:List-Help:List-Unsubscribe: List-Subscribe:List-Post:List-Owner:List-Archive; bh=tKlJL1Uxzc0MCbtI3CzU+/f+Tb5pP/w2ViQ/lWZj9u0=; b=jelEAlCKj8V0g25wfHA9jFlnxV awN/oabviO0eGGw4TdpBJe25b/oAusFnaOXtjIJog20PUD9Y0pBserQN3x1su2em8tiRbPKkN5EC2 dK7ZioYLpSmm0gWUQFKqinACCbfbEnfsOz7zOJw0rZAfsTcJhNENAXIO3OlQC7J4q/kY=; Received: from cm-84.212.220.105.getinternet.no ([84.212.220.105] helo=xo) by quimby.gnus.org with esmtpsa (TLS1.3:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1lo6RI-0001tN-Vm; Tue, 01 Jun 2021 17:36:23 +0200 From: Lars Ingebrigtsen To: ludvig-faddeev@gmx.com Subject: Re: bug#48768: Introducing ability to append to docstring References: X-Now-Playing: Tom Demac's _Kompakt Total 19_: "Serenade" Date: Tue, 01 Jun 2021 17:36:20 +0200 In-Reply-To: (ludvig-faddeev@gmx.com's message of "Tue, 1 Jun 2021 02:07:02 +0200") Message-ID: <87r1hlbnrf.fsf@gnus.org> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/28.0.50 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain X-Spam-Report: Spam detection software, running on the system "quimby.gnus.org", has NOT identified this incoming email as spam. The original message has been attached to this so you can view it or label similar future email. If you have any questions, see @@CONTACT_ADDRESS@@ for details. Content preview: ludvig-faddeev@gmx.com 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. Content analysis details: (-2.9 points, 5.0 required) pts rule name description ---- ---------------------- -------------------------------------------------- -1.0 ALL_TRUSTED Passed through trusted hosts only via SMTP -1.9 BAYES_00 BODY: Bayes spam probability is 0 to 1% [score: 0.0000] X-Spam-Score: -0.7 (/) X-Debbugs-Envelope-To: 48768 Cc: 48768@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 (-) ludvig-faddeev@gmx.com 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. I do not think that would be a useful interface -- you can append and change doc strings all you want by manipulating the `function-documentation' property. So I'm closing this bug report. -- (domestic pets only, the antidote for overdose, milk.) bloggy blog: http://lars.ingebrigtsen.no From debbugs-submit-bounces@debbugs.gnu.org Tue Jun 01 11:36:37 2021 Received: (at control) by debbugs.gnu.org; 1 Jun 2021 15:36:37 +0000 Received: from localhost ([127.0.0.1]:37556 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1lo6RZ-0003Dv-9X for submit@debbugs.gnu.org; Tue, 01 Jun 2021 11:36:37 -0400 Received: from quimby.gnus.org ([95.216.78.240]:46126) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1lo6RX-0003DZ-6R for control@debbugs.gnu.org; Tue, 01 Jun 2021 11:36:35 -0400 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnus.org; s=20200322; h=Subject:From:To:Message-Id:Date:Sender:Reply-To:Cc: MIME-Version:Content-Type:Content-Transfer-Encoding:Content-ID: Content-Description:Resent-Date:Resent-From:Resent-Sender:Resent-To:Resent-Cc :Resent-Message-ID:In-Reply-To:References:List-Id:List-Help:List-Unsubscribe: List-Subscribe:List-Post:List-Owner:List-Archive; bh=tELwvPI4XNBQOEEsGYSBVIxLNufuDBINbaQ1Ub11l9I=; b=G0/hYXvsJKuxrLNOegbrhkxXYO 9CqjJCpSipjjSUooxCTfJEYh4peCB1TwsTcKSzu+QwTYPpoMxqCWS/2JBsASHny7fgmtE4qxfVO+3 h/vh1SoKFBkXu8dwpPnfAIXL9haRpMCHHpt5P43PUdvYoHu8KBXVfq/7Sz2VdxODttQQ=; Received: from cm-84.212.220.105.getinternet.no ([84.212.220.105] helo=xo) by quimby.gnus.org with esmtpsa (TLS1.3:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1lo6RP-0001tZ-Pm for control@debbugs.gnu.org; Tue, 01 Jun 2021 17:36:29 +0200 Date: Tue, 01 Jun 2021 17:36:27 +0200 Message-Id: <87pmx5bnr8.fsf@gnus.org> To: control@debbugs.gnu.org From: Lars Ingebrigtsen Subject: control message for bug #48768 X-Spam-Report: Spam detection software, running on the system "quimby.gnus.org", has NOT identified this incoming email as spam. The original message has been attached to this so you can view it or label similar future email. If you have any questions, see @@CONTACT_ADDRESS@@ for details. Content preview: close 48768 quit Content analysis details: (-2.9 points, 5.0 required) pts rule name description ---- ---------------------- -------------------------------------------------- -1.0 ALL_TRUSTED Passed through trusted hosts only via SMTP -1.9 BAYES_00 BODY: Bayes spam probability is 0 to 1% [score: 0.0000] X-Spam-Score: -0.7 (/) X-Debbugs-Envelope-To: control 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 (-) close 48768 quit From debbugs-submit-bounces@debbugs.gnu.org Tue Jun 01 12:03:44 2021 Received: (at 48768) by debbugs.gnu.org; 1 Jun 2021 16:03:44 +0000 Received: from localhost ([127.0.0.1]:37648 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1lo6ro-0008Oc-10 for submit@debbugs.gnu.org; Tue, 01 Jun 2021 12:03:44 -0400 Received: from mout.gmx.net ([212.227.15.15]:54059) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1lo6rm-0008OP-Bq for 48768@debbugs.gnu.org; Tue, 01 Jun 2021 12:03:43 -0400 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=gmx.net; s=badeba3b8450; t=1622563416; bh=+v7FzQEQjUGAZF3LF5JMPWU03zaI/UuTOEfCUzJdevM=; h=X-UI-Sender-Class:From:To:Cc:Subject:Date:In-Reply-To:References; b=jvgkHFlffbdm+8vYy5+jfMrPj0V4HBxN4xhI57GHPh636OQ7OEv8M23Zas/slHoTH dKXmChZGrw3CfDpiwwqSZu65rKmuuC3w6eB/OidpSBGnQi/qNlo3i7jNBx2rsmTsDp qb5aHcWkmVtEx8krjS2zFsf6s8co4H/tWF857ADc= X-UI-Sender-Class: 01bb95c1-4bf8-414a-932a-4f6e2808ef9c Received: from [213.165.168.94] ([213.165.168.94]) by web-mail.gmx.net (3c-app-mailcom-bs01.server.lan [172.19.170.58]) (via HTTP); Tue, 1 Jun 2021 18:03:36 +0200 MIME-Version: 1.0 Message-ID: From: ludvig-faddeev@gmx.com To: Lars Ingebrigtsen Subject: bug#48768: Introducing ability to append to docstring Content-Type: text/plain; charset=UTF-8 Date: Tue, 1 Jun 2021 18:03:36 +0200 Importance: normal Sensitivity: Normal In-Reply-To: <87r1hlbnrf.fsf@gnus.org> References: <87r1hlbnrf.fsf@gnus.org> X-UI-Message-Type: mail X-Priority: 3 X-Provags-ID: V03:K1:LnEBeF6DTUBmWAoEFik3XB7P7l7tb4qv/WU1/ml/8Xlt1xH84H6oi48yEffBZj2G77/1b k2Wp57NiK4WtVqJ+SU1Rw7g++Ly7MfZ3LIZRcUJxz9KWFXaLNiIBeUWDnSEBIJGf985SQnvkDgnu L5xbTsGqIyBeWge9OwOQoOyIwo2AKdlAPEAAx12X53x701S4uSn6b9wLg0P5j7vb6AKesePN71te sxbDtgU0HncxeQcqDHOwvCZxp5FmH99BHjzCsnti6sUs8lVLgKwlqtJb5YJ9c9FtNpt3N32kqJNp bA= X-Spam-Flag: NO X-UI-Out-Filterresults: notjunk:1;V03:K0:gvDBR2cIChA=:ioIQ83ec69bMonEjElNu+e Apjz1bXfigj1m6JeZju+ptsZtaHz5s0tOVNE4rdVz064WCa4MueMVYK/gNn9fLm6Ph07Vi5Gn EzLiwMmFPv9HwMHJ1GGRbF0htxzIH8cw7Hf4d9cj8XHxQOZi3qYRyP/SPaStPLLDOmeOU7Xas 08R5U9ikADaM6P5ogd03/yFBDqO+/QBcvjQR20yf+74ctSQNf8SNjK1ivCMJTo7ORs8d0ZBlz m9CGKcBSwQRSHqrsi9/6I9fCdSaXRQOXOpxF5ZiPhgsI++hBNt15D9yC6Nhr1NtGnyjUqx+np FtiRnVKjQ5+qqyHctzoITp6KqXv9H8mCPguV30BdUleqfKp9T3XBZ5KFVKXVoR5O9L3lbKhtQ O6yQ2VEKMHeoNUXLhLAZdFjBmr0sT+RgtLr6SHiOL+A3nvC+2OdDdpgQqF6X4N/ppTwUJrLkj 2PDBUXHNjCY0ftCGMIpku+CrOgpPcbVMgfsIfEkN2KOA+d9aarSdGKlC7lJnVyMi/3sOUeGs8 VxumtKWtG0XBB0jHOhbcOgpMJpk9LinX78RyZ9rue/mOeZL7gWFEfa7YdZzuS2H6iY/YJ1wqi hhHr0EvTpNITHGzRfzpT0M+NObfenJqpflcHCHyTSdDK7gdTmAjjpDsTvVMr3XgefzB5bGY4F HgHtnfGmQCkuETNeGRkbwW6kB0XFWzvRBVx+yhFXgbJaeW+5fxJdPnAJycJbZzRzMGJFBmpua 7Dd6RVML5ae5ARDhHDNycObsAOdSP9UekEbTwOV6NrY6SK6r9HEQaODPcwZ5OoRbwCUj50hC7 j6vxiOP9RFRQsClG4Ui9GTtWl9DirH14BXHIhtW6xxbBb1cEho= Content-Transfer-Encoding: quoted-printable X-Spam-Score: 0.0 (/) X-Debbugs-Envelope-To: 48768 Cc: 48768@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.0 (-) > Sent: Wednesday, June 02, 2021 at 3:36 AM > From: "Lars Ingebrigtsen" > To: ludvig-faddeev@gmx.com > Cc: 48768@debbugs.gnu.org > Subject: Re: bug#48768: Introducing ability to append to docstring > > ludvig-faddeev@gmx.com 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. > > I do not think that would be a useful interface -- you can append and > change doc strings all you want by manipulating the > `function-documentation' property. > > So I'm closing this bug report. If you can tell me how to append, I can use that, but currently, what peop= le have said do not work. So appending to a doc-string is not useful. Appending to a string is the = most useful thing there is ! > -- > (domestic pets only, the antidote for overdose, milk.) > bloggy blog: http://lars.ingebrigtsen.no > From unknown Sat Aug 09 13:23:29 2025 Received: (at fakecontrol) by fakecontrolmessage; To: internal_control@debbugs.gnu.org From: Debbugs Internal Request Subject: Internal Control Message-Id: bug archived. Date: Wed, 30 Jun 2021 11:24:07 +0000 User-Agent: Fakemail v42.6.9 # This is a fake control message. # # The action: # bug archived. thanks # This fakemail brought to you by your local debbugs # administrator