From debbugs-submit-bounces@debbugs.gnu.org Mon Jan 06 15:36:45 2020 Received: (at submit) by debbugs.gnu.org; 6 Jan 2020 20:36:46 +0000 Received: from localhost ([127.0.0.1]:46878 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1ioZ7F-00015j-J4 for submit@debbugs.gnu.org; Mon, 06 Jan 2020 15:36:45 -0500 Received: from lists.gnu.org ([209.51.188.17]:44649) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1ioZ44-00010m-SI for submit@debbugs.gnu.org; Mon, 06 Jan 2020 15:33:29 -0500 Received: from eggs.gnu.org ([2001:470:142:3::10]:49769) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1ioZ43-00051F-FY for bug-gnu-emacs@gnu.org; Mon, 06 Jan 2020 15:33:28 -0500 X-Spam-Checker-Version: SpamAssassin 3.3.2 (2011-06-06) on eggs.gnu.org X-Spam-Level: X-Spam-Status: No, score=0.8 required=5.0 tests=BAYES_50,FREEMAIL_FROM, HTML_MESSAGE, RCVD_IN_DNSWL_NONE, URIBL_BLOCKED autolearn=disabled version=3.3.2 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1ioZ3z-0007No-JX for bug-gnu-emacs@gnu.org; Mon, 06 Jan 2020 15:33:24 -0500 Received: from sonic302-22.consmr.mail.ne1.yahoo.com ([66.163.186.148]:33551) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1ioZ3y-0007LZ-Vp for bug-gnu-emacs@gnu.org; Mon, 06 Jan 2020 15:33:23 -0500 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=aim.com; s=a2048; t=1578342799; bh=KovVSPN6L2Z03ZeSlO8SuRK/d4btSkyRiM/igS6/Lks=; h=Date:From:To:Subject:References:From:Subject; b=ciZhGQ+3nx1vLLp7x308qAFS6U8AAGeYsR5QyRylN+MH5GcMa4RJg56V0tUQ6lXy4v3uK1/jU7fqp8DejmcRCcLUbIIFZ53XW0yXnUnDdRIg2JPN/u0RY51Iq401ijiAwNcjO7rVcoJmVayjhLJnR8bhpiL/yY5XsrNKR2MNbjyBqd0d5I6tjvmtvVOw0FUAadIdhx4vxVK5ZWv6uDxT8ldEDxvCV7YRoC2W9jH8qmTrDYaqFTDWQ87m/OaNXCWrXVauFJtnEnkCRTxU3qIof1PWrskuW0w3NEFqgbif5YdxTnL61UsPDhkVvtpq+2ncQ90FfpT0RrGRwal63sPx6A== X-YMail-OSG: iDfF7dMVM1nEWeAal8I0BDccoCShf_mcQwKh3JyjyLIgegd704MEfu0coDaa5PT beZ.7I6IxlcMcmMRPCAXUf2DbjbmF7WIhgvc_BMVYNLKiTrTopWGRfmieeFid7ImL0cKT13Czyjl fRXSBvUsJo8PKykvdUxjq.s.r3gtrzDlzFXvSF462lpUeJ2n5QqQ19zdf2ahH1Jbk384b3cfh2Tl 0bhIWNzEtrE_1W6glG_EiH7DN5wNef8hVDZLvgTiY7pXjpyloABj00Ei2B63WRrWPdNU5Z2Z6shm G101YzF_rTqdmwwyqWpzAASlnneVtUrOEyfm74gR9gEmbh7sQZ.7xiaKngXXlMkXb6r.sQfqKnVq tpqXZtEAgyV27OfBx.ZFwXF0gt0pgQSGA9OrDg._jWh4BIG5td9XGLuTLcpVkwokgUcEiMYVLIud 1QTj.m4gLUfFZ2oSPoIr4LE3M0SrTxhaAIWDnw9TWKrdNdkjE6wn2wxs7vZY82KnNKeomgRSrqPL _gBLnYn6EiqEaZgefNhBY_OV_taKdboUaDMUutmqwLTE4.WzfnN4xIHOwuZuyG5MzBdZWVcgVfmW j5fqW65B7hR0HIj9dQfRUszYv3ujtErEaRPaMz5T1fTLjKI5peIz6S2_ud9aS6__xoWDca20MWCU HTRYGrmd2OWVJGc5OU21KQwI5weYmEqGNchn.1bwDu5tBDKHqSHam9NrB_nVBkQoJ86rZA1.nHIu NyQTAOdll9sjensEkwJf2mTK3EAC7.dPilMBAdkD_IQBVI.QCPhaxnbLbqu1KvT0pW7MxERf5yRv UtE696W.5t.eiHEvgGJENUCzzM72MCcrdwT0tG04GO4Lj4wZo46ofeah_h4NzsOgjppCR8oOKeCH zPFc61yd5g8x7wl.UXpi6mKhStRr0rPTIY4H0VSkTWHwel7Gg.85c43ZQc8A.zF3OUIr3gdc6ZNG 5YmDeMImd2S3OfQWPo.kK0lxV_tUFpaBLrpG.EXc9OSF_SDJtIIObOKj_y_tvhBi55wju77KLeXh xTxL8wWh1R0neb5ILBMALMV4CtMsIm1Q9hp8k_Gbv1g9lHCblJ9D25KVhmtTm1OT6q69p2L1IvfT QQTAgjLfXCdi1jST89npl.mKKnzNficIr8WLR3_iK_5ZWITxB73zSNFlXBIdQUyY57oyvelX4plL RyNFCU_tBf0okGHIa6SAPPtLMCHW.CWlOZHR7rKfcR1lUve_a2OcPt1gBG957T1i7towtdz6u1JA 7_OnUKari4p5izRWntNAIiQV.T9_DNRih Received: from sonic.gate.mail.ne1.yahoo.com by sonic302.consmr.mail.ne1.yahoo.com with HTTP; Mon, 6 Jan 2020 20:33:19 +0000 Date: Mon, 6 Jan 2020 20:33:15 +0000 (UTC) From: Mark Harig To: bug-gnu-emacs@gnu.org Message-ID: <258277221.7485058.1578342795150@mail.yahoo.com> Subject: 26.3; Missing documentation for `list-at-point' function in elisp manual. MIME-Version: 1.0 Content-Type: multipart/alternative; boundary="----=_Part_7485057_1974001302.1578342795149" References: <258277221.7485058.1578342795150.ref@mail.yahoo.com> X-Mailer: WebService/1.1.14873 aolwebmail Mozilla/5.0 (X11; Fedora; Linux x86_64; rv:71.0) Gecko/20100101 Firefox/71.0 Content-Length: 2491 X-detected-operating-system: by eggs.gnu.org: GNU/Linux 3.x [fuzzy] X-Received-From: 66.163.186.148 X-Spam-Score: -1.6 (-) X-Debbugs-Envelope-To: submit X-Mailman-Approved-At: Mon, 06 Jan 2020 15:36:44 -0500 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: -2.6 (--) ------=_Part_7485057_1974001302.1578342795149 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: quoted-printable Emacs Maintainers, Several searches at debbugs.gnu.org did not turn up any reports for this mi= nor documentation omission. The NEWS file for Emacs 26.2/.3 documents changes to `thing-at-point', incl= uding mention of the function `list-at-point'.=C2=A0 C-h f (describe-functi= on) provides documentation of `list-at-point', but C-h S (info-lookup-symbo= l) for `list-at-point' responds with "Not documented as a symbol: list-at-p= oint'.=C2=A0 A check of the node in the elisp manual that documents `thing-= at-point' does not show any mention of `list-at-point', nor does the previo= us node ("Near Point").=C2=A0 If `list-at-point' is documented elsewhere in= the elisp manual, then an index manual entry is needed for this function.= =C2=A0 Without this documentation, it is still possible to use `list-at-poi= nt', but when it is not documented in the manual, users might not know that= it exists. (End of report.) ------=_Part_7485057_1974001302.1578342795149 Content-Type: text/html; charset=UTF-8 Content-Transfer-Encoding: 7bit
Emacs Maintainers,

Several searches at debbugs.gnu.org did not turn up any reports for this minor documentation omission.

The NEWS file for Emacs 26.2/.3 documents changes to `thing-at-point', including mention of the function `list-at-point'.  C-h f (describe-function) provides documentation of `list-at-point', but C-h S (info-lookup-symbol) for `list-at-point' responds with "Not documented as a symbol: list-at-point'.  A check of the node in the elisp manual that documents `thing-at-point' does not show any mention of `list-at-point', nor does the previous node ("Near Point").  If `list-at-point' is documented elsewhere in the elisp manual, then an index manual entry is needed for this function.  Without this documentation, it is still possible to use `list-at-point', but when it is not documented in the manual, users might not know that it exists.

(End of report.)

------=_Part_7485057_1974001302.1578342795149-- From debbugs-submit-bounces@debbugs.gnu.org Tue Jan 07 11:17:57 2020 Received: (at 38996) by debbugs.gnu.org; 7 Jan 2020 16:17:57 +0000 Received: from localhost ([127.0.0.1]:49096 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1iorYL-0002et-8h for submit@debbugs.gnu.org; Tue, 07 Jan 2020 11:17:57 -0500 Received: from eggs.gnu.org ([209.51.188.92]:59063) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1iorYJ-0002eg-UD for 38996@debbugs.gnu.org; Tue, 07 Jan 2020 11:17:56 -0500 Received: from fencepost.gnu.org ([2001:470:142:3::e]:49394) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1iorYE-0006Oe-RO; Tue, 07 Jan 2020 11:17:50 -0500 Received: from [176.228.60.248] (port=2270 helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_256_CBC_SHA1:256) (Exim 4.82) (envelope-from ) id 1iorYD-00061n-V1; Tue, 07 Jan 2020 11:17:50 -0500 Date: Tue, 07 Jan 2020 18:18:02 +0200 Message-Id: <83imlnckat.fsf@gnu.org> From: Eli Zaretskii To: Mark Harig In-reply-to: <258277221.7485058.1578342795150@mail.yahoo.com> (bug-gnu-emacs@gnu.org) Subject: Re: bug#38996: 26.3; Missing documentation for `list-at-point' function in elisp manual. References: <258277221.7485058.1578342795150.ref@mail.yahoo.com> <258277221.7485058.1578342795150@mail.yahoo.com> X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Spam-Score: -2.3 (--) X-Debbugs-Envelope-To: 38996 Cc: 38996@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 (---) > Date: Mon, 6 Jan 2020 20:33:15 +0000 (UTC) > From: Mark Harig via "Bug reports for GNU Emacs, > the Swiss army knife of text editors" > > The NEWS file for Emacs 26.2/.3 documents changes to `thing-at-point', including mention of the function > `list-at-point'. C-h f (describe-function) provides documentation of `list-at-point', but C-h S > (info-lookup-symbol) for `list-at-point' responds with "Not documented as a symbol: list-at-point'. A check of > the node in the elisp manual that documents `thing-at-point' does not show any mention of `list-at-point', nor > does the previous node ("Near Point"). If `list-at-point' is documented elsewhere in the elisp manual, then an > index manual entry is needed for this function. Without this documentation, it is still possible to use > `list-at-point', but when it is not documented in the manual, users might not know that it exists. Thank you for your report. We don't document every function in the manual: that would make the manual too large (it already prints as 2 very thick volumes). This function is new, and has no callers inside Emacs, so whether it is important enough to warrant a place in the manual remains to be seen. For discoverability, we rely on built-in Help features such as 'apropos', and yes, on people reading NEWS when they start using a new version, because reading that will tell them about changes in a much more efficient way than the same information buried among many hundreds of pages of the manual. So I think we should wait and see if this function needs to be added to the manual. From debbugs-submit-bounces@debbugs.gnu.org Wed Jan 08 05:11:21 2020 Received: (at 38996) by debbugs.gnu.org; 8 Jan 2020 10:11:21 +0000 Received: from localhost ([127.0.0.1]:49796 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1ip8J7-0003du-Bn for submit@debbugs.gnu.org; Wed, 08 Jan 2020 05:11:21 -0500 Received: from mail-pf1-f180.google.com ([209.85.210.180]:46628) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1ip8J5-0003dW-B6 for 38996@debbugs.gnu.org; Wed, 08 Jan 2020 05:11:19 -0500 Received: by mail-pf1-f180.google.com with SMTP id n9so1363800pff.13 for <38996@debbugs.gnu.org>; Wed, 08 Jan 2020 02:11:19 -0800 (PST) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:mime-version:references:in-reply-to:from:date :message-id:subject:to:cc; bh=PTKJRgEqPbYrJtmBNnKMQqFlhfy4sNydx4Wwf382zYI=; b=thgTnt1U2u9g0285Qp7tCZ4IatNumwJ4LlGzkZPvDstokFZIXjzG7oPunQDLXGzuV3 aG41ao7cta5pnN+HnNzC1UWwT5CkWUc+jCz1xWp5FKe5xmPJMZZt0Hq9D47t+VPpwxon Mt9U5qSsRP/Vot143bSzcylVoU+RNWM/9aBhdfC8uPg72W3xYloR/dMBMGrFfMh7tQku DzR8wAS9IWvWaXA8RCflDMjtoCIc9wEBwWj7+jShVfboggDXEtDbXWRVixYYLge/x4H8 CCbN2VCRuH0PCe3KPJ7vfV/A7hWTGKqBqTwrrwrwT+ScsbnBRx3lngEi7zWQVptgT1tN o/cA== X-Gm-Message-State: APjAAAXXk48/p0O/xys0vuquT/hDQPTVIXx0so3h8d7MMVcxb1YBouui IAoCLz69u7FiuqSHW3q3EXgeyMZ5X+lDenTG5OU= X-Google-Smtp-Source: APXvYqxSJj6N2Ll+hNPnG22SbnpH07Mufkgf+uEvQGgxSac9KrGW0qFgzd8E4OUfQW4GxLP4gW+WlXGe9f791jRR50I= X-Received: by 2002:a63:6c86:: with SMTP id h128mr4045683pgc.200.1578478273630; Wed, 08 Jan 2020 02:11:13 -0800 (PST) MIME-Version: 1.0 References: <258277221.7485058.1578342795150.ref@mail.yahoo.com> <258277221.7485058.1578342795150@mail.yahoo.com> <83imlnckat.fsf@gnu.org> In-Reply-To: <83imlnckat.fsf@gnu.org> From: Stefan Kangas Date: Wed, 8 Jan 2020 11:11:02 +0100 Message-ID: Subject: Re: bug#38996: 26.3; Missing documentation for `list-at-point' function in elisp manual. To: Eli Zaretskii Content-Type: text/plain; charset="UTF-8" X-Spam-Score: 0.5 (/) X-Debbugs-Envelope-To: 38996 Cc: 38996@debbugs.gnu.org, Mark Harig 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: -0.5 (/) tags 38996 + notabug wontfix close 38996 thanks Eli Zaretskii : > So I think we should wait and see if this function needs to be added > to the manual. I agree, and I'm therefore closing this bug report. Best regards, Stefan Kangas From debbugs-submit-bounces@debbugs.gnu.org Wed Jan 08 13:02:41 2020 Received: (at 38996) by debbugs.gnu.org; 8 Jan 2020 18:02:41 +0000 Received: from localhost ([127.0.0.1]:51271 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1ipFfD-0005A1-A6 for submit@debbugs.gnu.org; Wed, 08 Jan 2020 13:02:41 -0500 Received: from sonic313-9.consmr.mail.ne1.yahoo.com ([66.163.185.32]:42825) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1ipFTQ-0004os-VR for 38996@debbugs.gnu.org; Wed, 08 Jan 2020 12:50:30 -0500 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=aim.com; s=a2048; t=1578505822; bh=ZK2AXhM5ih0K6IsdEhBLIqPNvuD0IGbCqynp7TGCMhQ=; h=Date:From:To:Subject:References:From:Subject; b=ZBhGE8nyZ+MpYuyDqM8pbMt9BQbsijj6uLqxNA5Nk0EF2I/NWgLqKT/jdhAJarmjbZ0FCjZBSVN/SmgTZre+tbzgL5Zx5I/T/SWNF0+Ok35MGx0wueTmKKCaIjqxXJpWaAmX/UYPZ6qr/H33p8LoUmIFGgQXVaIXKnCiYFW2m398SUeOocdPMr4PT/SqEzQxEq2f/Ig0Q61X9iGd4QOTGEfQ0dCGxLzoZ0fxnCcM41FGeL7H1crbhY+Rnf9Gh4T4UC2Rzs6rUl/HpQjqGg78yL72RsYQdfuDASwwFCqLXkj2fZ5+ijY/2c78iyWynRh5WOQZ2+AqBugUZYj6at7QTQ== X-YMail-OSG: EGpIVXoVM1nawSTfHImCbD.tc14N58r0mWffqBwt4ZqE.Q5dnGoGHqF3IB7K_hw GRobf2XLBvtQQ_8ElHzRon4rAi19QtD3y5pdyrwWajLu5sM_f.RfodlBbsnEeFpVHeBOCAvbTRhL XmbfUmQclIjxDsMbzEjfSSDB2z_TXGed8nIGO8t3TM5bDhLdpYiTHz7RkawSpy.VIX5mkQsngm3b mf22jNNx_y71HVpfRtYBvwKNDDrQnFcF1Lt93.yJiWgAaTd3U9r85ETlRCbDRqlDzo5e1z4ynP_W tNDR54d0d1vFGxiWAh0w_3XyrB_xPDjtyX5fPsyFG53jAWfPzJVaoC6jkkSDbiNdBM_z3Z5bkmC1 oIT97Nn6XfE0uvcLOeedbnpr2ii7Xy6MBvguK7Mq.8LE528NQrUkGXJx0uIY1nA9UVEYRQtW2Oo9 YLoLZ3geZiylIIi4nEh2fk.6cbOCubBmJwOPx4Zns6Xpc5j61ljIXunGm7K3yYXOdJQpPGyu7F6t i4BCZflY2Px3M_oWn6NyTZ3J8Gy_5uF8639CFhHbRnmrz_RrXQNUB3lhiT1x7b5rjl4wtEcs7t9Z E7TOj3i9apSrArfVhpf1fRcj7.qlhzZMzI7ZuqqUZ4H5Av1Kg0M9YHHRr23vONdQZbXPe8NpUV4d R0DAEK5iEbCgxw6jyxfXLZi76iMbIdGoDNNg1QbRupVArtRYkpPcuj_P1vm_je0FNTPBO8J3RNAu q71pcDBikL5kchjbfJZJXqCjUAP0u4.C9yjuzePoSpryqZFFeu8qSpobaspV5xgTOARiI3_9x_P8 fIZZH7eSKaKJOHPElLDVTT9pUs0ziWaosl6S_2gN38efZJyclVdwaV1rC7d0HZDJzYSCs36TY41X E4G3SmNzig5q3Ex5fW0LAFVFn7RavM2_huzvAWU_0AKLsdFfPGReiuBQQ8hfsxKtsCCvcX08SE3F 63ys4274UmkaNDygUs.tmHVwSbOXW.w46c7FEXr6w1_21ULoRsBOhTCLcVN_wYiSEzVoZNtITs00 vxb3Lmb1Z31.u5YXk8kVr.Z5RPMOxRURAWIHI16S4P2_cJ99WpVubCU7Lb88NGd6dkHqjsVdhXc9 ES02FM7I.LO0AxalVy14G4UIivffs9_AyOvPFadf58K99kbuEJU.oimI6LlJlre_vJRu3VADO2uX NkKmSzuVs4rwv2o7TWUvVpgsEpqfdCiNsdSSLoGZbk4BqcTuehx46u6HuMfAGKScyy_CwukCSsKX sYLLFbUbrAaSqZWeYkHYGNogy9y_CzqqcTg-- Received: from sonic.gate.mail.ne1.yahoo.com by sonic313.consmr.mail.ne1.yahoo.com with HTTP; Wed, 8 Jan 2020 17:50:22 +0000 Date: Wed, 8 Jan 2020 17:50:16 +0000 (UTC) From: Mark Harig To: 38996@debbugs.gnu.org Message-ID: <856796400.8608681.1578505816990@mail.yahoo.com> Subject: Re: bug#38996: 26.3; Missing documentation for `list-at-point' function in elisp manual. MIME-Version: 1.0 Content-Type: multipart/alternative; boundary="----=_Part_8608680_999115868.1578505816988" References: <856796400.8608681.1578505816990.ref@mail.yahoo.com> X-Mailer: WebService/1.1.14873 aolwebmail Mozilla/5.0 (X11; Fedora; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/79.0.3945.117 Safari/537.36 Content-Length: 3760 X-Spam-Score: 0.0 (/) X-Debbugs-Envelope-To: 38996 X-Mailman-Approved-At: Wed, 08 Jan 2020 13:02:38 -0500 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 (-) ------=_Part_8608680_999115868.1578505816988 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: quoted-printable > We don't document every function in the manual: that would make the> manu= al too large (it already prints as 2 very thick volumes).=C2=A0 This> funct= ion is new, and has no callers inside Emacs, so whether it is> important en= ough to warrant a place in the manual remains to be seen.>=C2=A0> For disco= verability, we rely on built-in Help features such as> 'apropos', and yes, = on people reading NEWS when they start using a new> version, because readin= g that will tell them about changes in a much> more efficient way than the = same information buried among many> hundreds of pages of the manual. OK. Going forward, how are end users to know which functions have notbeen d= ocumented on purpose and which have not been documented due tooversight?=C2= =A0 It might be worth considering adding to future NEWS, whena new function= or variable is added, a some brief note saying that"this function/variable= will not (yet) be documented in one of themanuals."=C2=A0 Without that, it= is impossible for a user to know whetherthe lack of documentation is inten= tional or an error to be reported here. --- ------=_Part_8608680_999115868.1578505816988 Content-Type: text/html; charset=UTF-8 Content-Transfer-Encoding: 7bit
> We don't document every function in the manual: that would make the
> manual too large (it already prints as 2 very thick volumes).  This
> function is new, and has no callers inside Emacs, so whether it is
> important enough to warrant a place in the manual remains to be seen.
> 
> For discoverability, we rely on built-in Help features such as
> 'apropos', and yes, on people reading NEWS when they start using a new
> version, because reading that will tell them about changes in a much
> more efficient way than the same information buried among many
> hundreds of pages of the manual.

OK. Going forward, how are end users to know which functions have not
been documented on purpose and which have not been documented due to
oversight?  It might be worth considering adding to future NEWS, when
a new function or variable is added, a some brief note saying that
"this function/variable will not (yet) be documented in one of the
manuals."  Without that, it is impossible for a user to know whether
the lack of documentation is intentional or an error to be reported here.

---

------=_Part_8608680_999115868.1578505816988-- From debbugs-submit-bounces@debbugs.gnu.org Wed Jan 08 13:16:57 2020 Received: (at 38996) by debbugs.gnu.org; 8 Jan 2020 18:16:57 +0000 Received: from localhost ([127.0.0.1]:51280 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1ipFt2-0005VM-SS for submit@debbugs.gnu.org; Wed, 08 Jan 2020 13:16:57 -0500 Received: from eggs.gnu.org ([209.51.188.92]:57605) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1ipFt1-0005V8-Ay for 38996@debbugs.gnu.org; Wed, 08 Jan 2020 13:16:55 -0500 Received: from fencepost.gnu.org ([2001:470:142:3::e]:42601) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1ipFsw-0002Ip-4D; Wed, 08 Jan 2020 13:16:50 -0500 Received: from [176.228.60.248] (port=1894 helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_256_CBC_SHA1:256) (Exim 4.82) (envelope-from ) id 1ipFsv-0005HL-A5; Wed, 08 Jan 2020 13:16:49 -0500 Date: Wed, 08 Jan 2020 20:17:03 +0200 Message-Id: <83blrdbyow.fsf@gnu.org> From: Eli Zaretskii To: Mark Harig In-reply-to: <856796400.8608681.1578505816990@mail.yahoo.com> (bug-gnu-emacs@gnu.org) Subject: Re: bug#38996: 26.3; Missing documentation for `list-at-point' function in elisp manual. References: <856796400.8608681.1578505816990.ref@mail.yahoo.com> <856796400.8608681.1578505816990@mail.yahoo.com> X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Spam-Score: -2.3 (--) X-Debbugs-Envelope-To: 38996 Cc: 38996@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 (---) > Date: Wed, 8 Jan 2020 17:50:16 +0000 (UTC) > From: Mark Harig via "Bug reports for GNU Emacs, > the Swiss army knife of text editors" > > OK. Going forward, how are end users to know which functions have not > been documented on purpose and which have not been documented due to > oversight? I don't think there should be a way. If you think something should be there, and you have a good reason, feel free to report it as a bug. At worst, you will hear an explanation why it's not an omission; no harm done. From unknown Sat Aug 16 00:33:51 2025 Received: (at fakecontrol) by fakecontrolmessage; To: internal_control@debbugs.gnu.org From: Debbugs Internal Request Subject: Internal Control Message-Id: bug archived. Date: Thu, 06 Feb 2020 12:24:06 +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