From unknown Thu Aug 14 22:21:45 2025 X-Loop: help-debbugs@gnu.org Subject: bug#57815: 29.0.50; loaddefs-generate docstring: DIR vs. DIRS Resent-From: Michael Heerdegen Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Thu, 15 Sep 2022 02:56:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 57815 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: 57815@debbugs.gnu.org X-Debbugs-Original-To: bug-gnu-emacs@gnu.org Received: via spool by submit@debbugs.gnu.org id=B.166321052611593 (code B ref -1); Thu, 15 Sep 2022 02:56:01 +0000 Received: (at submit) by debbugs.gnu.org; 15 Sep 2022 02:55:26 +0000 Received: from localhost ([127.0.0.1]:56645 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1oYf2E-00030u-JA for submit@debbugs.gnu.org; Wed, 14 Sep 2022 22:55:26 -0400 Received: from lists.gnu.org ([209.51.188.17]:40708) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1oYf29-00030j-3U for submit@debbugs.gnu.org; Wed, 14 Sep 2022 22:55:24 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]:52936) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1oYf28-00033h-Pr for bug-gnu-emacs@gnu.org; Wed, 14 Sep 2022 22:55:20 -0400 Received: from mout.web.de ([212.227.17.12]:35031) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1oYf25-0001oO-Hi for bug-gnu-emacs@gnu.org; Wed, 14 Sep 2022 22:55:20 -0400 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=web.de; s=s29768273; t=1663210514; bh=xjhR+ox+OcVqqrzFaZvWq8pAwE+3Pp7F/dn+ON0B6QU=; h=X-UI-Sender-Class:From:To:Subject:Date; b=g53DiZUxvP62AlJmuT+dJNSeIdp0TVi7ogteyJIz5lKzkYVy0fIBNiUFXw/qbySQX N91zHAyFG/1ioxmI18y1IBqzfocnKv35cU9fBOvh1p5Q1yPJFzQHBSoWCH7QiGxZPQ msIUg+IHzZeU6b2BiFtolvv9v1vXnfgyWzJeu6l7Clqy2DCTFm/rDlFcVkBxdoGzFG o1bCOFrOUT3Tn+rCLvYXi6S1NXVaD+Ud0VJN23F6o0HDwHSPTHmhFag61fWv6XiiXQ JUokjbybLNHQG9k/7Gi0dSiMjdMe2kHmY88m5pE/ktEKc1kZ+liV8XnxaGWHT+Jbsh lUIOb0kgAt3Uw== X-UI-Sender-Class: 814a7b36-bfc1-4dae-8640-3722d8ec6cd6 Received: from drachen.dragon ([92.208.190.67]) by smtp.web.de (mrweb106 [213.165.67.124]) with ESMTPSA (Nemesis) id 1M28SB-1ob94d1DzN-002Cev for ; Thu, 15 Sep 2022 04:55:14 +0200 From: Michael Heerdegen Date: Thu, 15 Sep 2022 04:55:13 +0200 Message-ID: <87pmfxny7i.fsf@web.de> MIME-Version: 1.0 Content-Type: text/plain X-Provags-ID: V03:K1:1QWw7YXMnvH+pf4DmLLWMPayCUhhkIMlrdQGwVePcSFatCha6qe N//q7Yqb/5uWvHUl7ZG3VXWV2LRvpGuRCn6052ovy0gPCgTKSfoGGwZcyA3PXIyPy2axBSc QyP5hc9ibXM/6UWA2WWdTgxZeUl6O43fTODGjMkPB2UOdYqBFHbpJgOgr4IGYMu2PKTopus 8aviZ/hCmS/Rqal/TQuHg== X-Spam-Flag: NO X-UI-Out-Filterresults: notjunk:1;V03:K0:4QYn5zKaSu0=:5n/c33APBnw+bEUQjzQsLY SdgghjvoOiR8VO0AeBO8aAo5LrY8De9F+cCDuftXGPHEUwONyT4HL0wUTds2c0ZWOtTJXRDiQ 4cFyRF/keKbkX1+asOv0bNuZRMTinzy2poPGhYNaIQsxf/jyCx+VnSSpVLPFJPI9YDco+TDzt EwS/wbgRrWX4ND0MwMjt58IjaVSTkbyqxQlABGs3w3zbRn3GYQ1/K5TUkjEdd7OVq3UztbxxC RH3hsRu7xthvbu2F5P8N4hEmMOx0MVSMFkFZ7KmkWyb1JOyFzQCj5mvu7VUHh0vgisLXmmnW3 XufTAI/5RnYot/yXA4y/3ZEGQec8Jx3NtuWiZ1+RcbpR56ep1bU+wAjGUYMCFXgfswHuZy7Yh 0j7XLzgngDJG/va3V/3S1IAQYzYnLy01NdMDOctiTThEp7qLhRs83YM6c7s/C7MmkyNOvVZgA cNMXG2W8UA4HrNYX0qGF5Dk8epjisISWdTOPXFapljDuHKZuk58gTXftjZIWT/GY0ri0c4luP AZa6P8wmOjR7KlJ5fsgS2K3U59GwsdYb0GakogTB5SXpfzoDPTzHRT99G7JQk9ATHoH+scwEv G4tlfWMPHylhX7Y5iut1ldRhAH3gPTvKhW2bcF7eYH8RKlX+wLbLWFqvAgWltLsoPoH4aYUyt EhOSslm1VDJavT1L+YRrE2Q56JZu2pRhY9vJ0dq+H5+2MZaczrHbYf1AU7MQGFe8QbhWYVPCO z/msaa8vCqbUzac9Q+G4uLup0QinB/9LSyV2IHZ277j8yv6jy0dO58IbD6PQx6SaZnseopSGs xHMIpr6Od23fGkqOejpEUSuYXsi9iB8HRdges55GWRYP5uNH9RFX2Uzc3k3F0HbgJiWcM7InO qIgBbyyv7Tk8m21mvWxtDU2WeVlTER/z0KF3lep/VGBBQcqEUfKkKqDYUmPR0G/5ltqfTkRLM rjLYz4dvI15/xPwiLExVJKft6xCRGOZuiORSM/1Sfwo6OcxOPiNVGEO5cRLl8bH3KNoGm+Qzl KyJI1K3MuI43T9bPeMLFnKdHk13bkDARFZGMTI749PlSGZhijwNpExrUg7YUeHXmVaI7OpjYp 4IDNKPx4YuhwCBpS4BcECIxTlxR1Luq+Rvlha3Alfxou6fPc4XqSrpRwROSqfXMVroFQIVvIE kaPk1y5BAdV4SWtIlo5F8N8/Qe Received-SPF: pass client-ip=212.227.17.12; envelope-from=michael_heerdegen@web.de; helo=mout.web.de X-Spam_score_int: -20 X-Spam_score: -2.1 X-Spam_bar: -- X-Spam_report: (-2.1 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, FREEMAIL_FROM=0.001, RCVD_IN_MSPIKE_H3=0.001, RCVD_IN_MSPIKE_WL=0.001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001, T_SCC_BODY_TEXT_LINE=-0.01 autolearn=ham autolearn_force=no X-Spam_action: no action X-Spam-Score: 0.0 (/) 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.4 (--) Hello, the first arg of loaddefs-generate has the name DIR but the first sentence names it DIRS. While that argument can be a dir or a list of dirs, this first sentence breaks our rules. Would it be worth to name the argument "DIR-OR-DIRS" for discoverability - or should the docstring just say "Generate loaddefs files for Lisp files in DIR. DIR can be either a single directory or a list of directories. [...]" ? TIA, Michael. In GNU Emacs 29.0.50 (build 7, x86_64-pc-linux-gnu, X toolkit, cairo version 1.16.0, Xaw scroll bars) of 2022-09-14 built on drachen Repository revision: 0dfe8c6023564b4ea86424c790ad0b4925110e1a Repository branch: master Windowing system distributor 'The X.Org Foundation', version 11.0.12011000 System Description: Debian GNU/Linux 11 (bullseye) Configured using: 'configure --with-x-toolkit=lucid' From unknown Thu Aug 14 22:21:45 2025 X-Loop: help-debbugs@gnu.org Subject: bug#57815: 29.0.50; loaddefs-generate docstring: DIR vs. DIRS Resent-From: Eli Zaretskii Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Thu, 15 Sep 2022 06:19:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 57815 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: Michael Heerdegen Cc: 57815@debbugs.gnu.org Received: via spool by 57815-submit@debbugs.gnu.org id=B57815.166322273932582 (code B ref 57815); Thu, 15 Sep 2022 06:19:01 +0000 Received: (at 57815) by debbugs.gnu.org; 15 Sep 2022 06:18:59 +0000 Received: from localhost ([127.0.0.1]:56769 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1oYiDD-0008TS-Ji for submit@debbugs.gnu.org; Thu, 15 Sep 2022 02:18:59 -0400 Received: from eggs.gnu.org ([209.51.188.92]:43740) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1oYiD9-0008TB-VJ for 57815@debbugs.gnu.org; Thu, 15 Sep 2022 02:18:57 -0400 Received: from fencepost.gnu.org ([2001:470:142:3::e]:36418) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1oYiD4-0008Tt-Pt; Thu, 15 Sep 2022 02:18:50 -0400 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnu.org; s=fencepost-gnu-org; h=References:Subject:In-Reply-To:To:From:Date: mime-version; bh=LYdoNIY6r+Nn0EqPZGqSXNHX0otflrM4LeVofspx9ss=; b=BIuUIi316Oh2 JqRsmcKWA0FW7BGb+Yskm/Mw7DX9V3Y+3yDbRJ/frwVzOY6Myq4Y5wyNhR6VIOduhErE6h8v93D+B x6VRVAgKbH1dN4Avyes3fJRQWa+5s1xGyK0Kbn9zk2rc+gOwRS0Tp4ptO5wJvhxxvNP3daw1RcmhF Sh12nNB3LL0JAenKC0KELO6sRbvE3gCxAi3EZMY9KDSrNR+K/mAHOSgeu4/BRaCj1jHU7TlbHdNbT 3dNNmVJ4PIWmJjYGyCzOvHvqT7wW2rWZIsTe8GbmMw1Ps8+mopdhFjswzAQW3fCLdFPziEHXknzQg oPhv8kAH5QPfLJl+agupXA==; Received: from [87.69.77.57] (port=3472 helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1oYiD4-00019V-3T; Thu, 15 Sep 2022 02:18:50 -0400 Date: Thu, 15 Sep 2022 09:18:41 +0300 Message-Id: <834jx917pa.fsf@gnu.org> From: Eli Zaretskii In-Reply-To: <87pmfxny7i.fsf@web.de> (message from Michael Heerdegen on Thu, 15 Sep 2022 04:55:13 +0200) References: <87pmfxny7i.fsf@web.de> X-Spam-Score: -2.3 (--) 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 (---) > From: Michael Heerdegen > Date: Thu, 15 Sep 2022 04:55:13 +0200 > > the first arg of loaddefs-generate has the name DIR but the first > sentence names it DIRS. > > While that argument can be a dir or a list of dirs, this first sentence > breaks our rules. Yes, should be fixed now. > Would it be worth to name the argument "DIR-OR-DIRS" for discoverability > - or should the docstring just say > > "Generate loaddefs files for Lisp files in DIR. > DIR can be either a single directory or a list of directories. > [...]" ? I made it say Generate loaddefs files for Lisp files in one or more directories given by DIR. From unknown Thu Aug 14 22:21:45 2025 MIME-Version: 1.0 X-Mailer: MIME-tools 5.505 (Entity 5.505) X-Loop: help-debbugs@gnu.org From: help-debbugs@gnu.org (GNU bug Tracking System) To: Michael Heerdegen Subject: bug#57815: closed (Re: bug#57815: 29.0.50; loaddefs-generate docstring: DIR vs. DIRS) Message-ID: References: <875yhpf387.fsf@web.de> <87pmfxny7i.fsf@web.de> X-Gnu-PR-Message: they-closed 57815 X-Gnu-PR-Package: emacs Reply-To: 57815@debbugs.gnu.org Date: Thu, 15 Sep 2022 08:32:02 +0000 Content-Type: multipart/mixed; boundary="----------=_1663230722-13748-1" This is a multi-part message in MIME format... ------------=_1663230722-13748-1 Content-Disposition: inline Content-Transfer-Encoding: quoted-printable Content-Type: text/plain; charset="utf-8" Your bug report #57815: 29.0.50; loaddefs-generate docstring: DIR vs. DIRS which was filed against the emacs package, has been closed. The explanation is attached below, along with your original report. If you require more details, please reply to 57815@debbugs.gnu.org. --=20 57815: https://debbugs.gnu.org/cgi/bugreport.cgi?bug=3D57815 GNU Bug Tracking System Contact help-debbugs@gnu.org with problems ------------=_1663230722-13748-1 Content-Type: message/rfc822 Content-Disposition: inline Content-Transfer-Encoding: 7bit Received: (at 57815-done) by debbugs.gnu.org; 15 Sep 2022 08:31:55 +0000 Received: from localhost ([127.0.0.1]:56965 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1oYkHk-0003Z9-3u for submit@debbugs.gnu.org; Thu, 15 Sep 2022 04:31:54 -0400 Received: from mout.web.de ([212.227.15.14]:43257) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1oYkHg-0003Yo-19 for 57815-done@debbugs.gnu.org; Thu, 15 Sep 2022 04:31:46 -0400 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=web.de; s=s29768273; t=1663230697; bh=S8CQUhEU8HBaiIw0WzqXHD88sUWjQE2tRyDqRPrFcrM=; h=X-UI-Sender-Class:From:To:Cc:Subject:In-Reply-To:References:Date; b=lExTcHl4ASnXuNWVPCufysgyRN7rZK9LHloPRUhimyZMyHjAopfkf7E7Iw2O7LorH WonnhNu0MMeEDIiwZ7Bl0bLSkwDLJa5QV3FpeKWcDlDUjtTEvmrpsxjL7+yvUAdNZX yETEH2ethjRWqbbH3E14SOuNQSOgRTR31i4jp/0YnryLYE93y7LTY6k5NcfZCGLg9a Cb3Ha0EWDeaSP9PR7Q7KacpB7p/1JHzvHLGpLbIrmRMDiMTzO5DFQnrexNie/3rBw4 IMIKTft3pZxT9ohFO2Kolk3N1cYvnukhO7Yyl3XCGamTm0zsoggJzi62Mrh8oyzlWg jPxbb0CmDktKQ== X-UI-Sender-Class: 814a7b36-bfc1-4dae-8640-3722d8ec6cd6 Received: from drachen.dragon ([92.208.190.67]) by smtp.web.de (mrweb005 [213.165.67.108]) with ESMTPSA (Nemesis) id 1MP384-1oy0N32vV6-00PRAU; Thu, 15 Sep 2022 10:31:37 +0200 From: Michael Heerdegen To: Eli Zaretskii Subject: Re: bug#57815: 29.0.50; loaddefs-generate docstring: DIR vs. DIRS In-Reply-To: <834jx917pa.fsf@gnu.org> (Eli Zaretskii's message of "Thu, 15 Sep 2022 09:18:41 +0300") References: <87pmfxny7i.fsf@web.de> <834jx917pa.fsf@gnu.org> Date: Thu, 15 Sep 2022 10:31:36 +0200 Message-ID: <875yhpf387.fsf@web.de> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/29.0.50 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain X-Provags-ID: V03:K1:qgl+5a1FMaXV+PEdjqMNkZvwAFH4wgQHoVlQd4aCspHE5mrK70a tOkYZFyftbIPf3ydRnKg1lbUZPsRyoZ1mWDwtChLbgbaWiNLBmBX4+MaB7aB9WB+hV4Wm3v DLNs4+4ypdWv0Yod8DRG1PaZVB/U/oAEmkx2dtavj7XwS5WPyhuRTWl8BamMYXTUyDKVVlo BugNN4JHDNY9IUUfWH6ig== X-Spam-Flag: NO X-UI-Out-Filterresults: notjunk:1;V03:K0:Bre9tgMWWvM=:yZv1o7ZXaWJaRwRYGCM8Nx 4oZlMybjyVSijbQldWEGBSnmBJkpHc6Ns3fgIPwZ+gr3IS4GE7tRQg+/EKCyRcgCB1Fz//hH9 IB6LTAd7A38wBE0KEWZE7D9n82U0wfLFK8Q3JdEPYgt4xNFNBxoy6h+2fcqBlbbFPFlWLsGx0 kXaxZBfmjDRJemr+tRNe1qDHxNswSAJoGoiGopAU0fOVI9ufNYKIuxrEYxgJAICXHQNAT4CtL 5J1nVfT+uJhVF060EPPsgxx+morRtwg1Y6BBgtn7g32pq6y/xMsB2lg0aodkslMR5J6ZTNPo/ +odZ7N+XLKnmzATtrbf4YyTGSBQ5owDNCj0wGqwTLz5dZQeU41vlNVmY1tjaPDH/jGAxz1K3y 5Ymhy3bLleeTMIql+vV1SXvwuOETqn3RJWVvE2BcCDvl3bqrb5DYCoKKhKRu6ZapzBG678czx pUR6IqjUC6ob/e1Jtdr4kwxDvilAD17ZQdXC1nSeSVbJTBvKxJGY3ntsdOjLg/X/fNUFtS4uf cON8a9zmnrla9Eu5MAW7UhEs8Tc4kcSaqVaZQHPJaObWUU3IjyzZeUfy/Yn7XO1ah3Dfm+VkP Fejo021NzcixYxe0dkl3O7MaiicXfPb+s0NS5iLTY85zRcafpgN1R3i6r3PdCHbxqd7aIhqza 8qcujQU5UMdGuRtyEhobV4EXUi8fAwWNogrSqJKRBvxdJqXAZ+jcIcL1Np3TtV/m64gK34guL vnNohVEtYiui6mm1dxD1lpj1BPYcjFSSFJgMrrz2jlicuHVdzcS3+30TiROHCAwilz7oqO1D7 CRuLNBhOmofS/sxM7vS54MMhpiKKFS49dss062n2B80++S+a9FjYo6zQMTGQ02iyVv+FNxMIH L75d9jB6+zS70Q+/3v0/Lt623dNBsEuDpOZpUMaCGh/ttiSJHr7P2VC7Rr0QKIsWwHEAdhh2C CsIFOhrqtzz9mOR/WSEFtpLixhuxfIoHmgg1CobrM29DGyGi4AMhJregaDkX946wHot03PuQs Rscd8PE8knNYsW343XUtLEvpSCNiM7kw/j8NpXo4jUeOAnLpCvfELuAHlG38SH1cvTxkJ1ozT juGL25osO12r6C0U2PHQw87yBCJytNku8qNz730wKVBB8M+leSxwpiZh362wacYajsXHUuwip DfN2t0p9HconML1E4vQT8LKrsx X-Spam-Score: -0.7 (/) X-Debbugs-Envelope-To: 57815-done Cc: 57815-done@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 (-) Eli Zaretskii writes: > I made it say > > Generate loaddefs files for Lisp files in one or more directories > given by DIR. Perfect, thanks. Closing. Michael. ------------=_1663230722-13748-1 Content-Type: message/rfc822 Content-Disposition: inline Content-Transfer-Encoding: 7bit Received: (at submit) by debbugs.gnu.org; 15 Sep 2022 02:55:26 +0000 Received: from localhost ([127.0.0.1]:56645 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1oYf2E-00030u-JA for submit@debbugs.gnu.org; Wed, 14 Sep 2022 22:55:26 -0400 Received: from lists.gnu.org ([209.51.188.17]:40708) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1oYf29-00030j-3U for submit@debbugs.gnu.org; Wed, 14 Sep 2022 22:55:24 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]:52936) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1oYf28-00033h-Pr for bug-gnu-emacs@gnu.org; Wed, 14 Sep 2022 22:55:20 -0400 Received: from mout.web.de ([212.227.17.12]:35031) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1oYf25-0001oO-Hi for bug-gnu-emacs@gnu.org; Wed, 14 Sep 2022 22:55:20 -0400 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=web.de; s=s29768273; t=1663210514; bh=xjhR+ox+OcVqqrzFaZvWq8pAwE+3Pp7F/dn+ON0B6QU=; h=X-UI-Sender-Class:From:To:Subject:Date; b=g53DiZUxvP62AlJmuT+dJNSeIdp0TVi7ogteyJIz5lKzkYVy0fIBNiUFXw/qbySQX N91zHAyFG/1ioxmI18y1IBqzfocnKv35cU9fBOvh1p5Q1yPJFzQHBSoWCH7QiGxZPQ msIUg+IHzZeU6b2BiFtolvv9v1vXnfgyWzJeu6l7Clqy2DCTFm/rDlFcVkBxdoGzFG o1bCOFrOUT3Tn+rCLvYXi6S1NXVaD+Ud0VJN23F6o0HDwHSPTHmhFag61fWv6XiiXQ JUokjbybLNHQG9k/7Gi0dSiMjdMe2kHmY88m5pE/ktEKc1kZ+liV8XnxaGWHT+Jbsh lUIOb0kgAt3Uw== X-UI-Sender-Class: 814a7b36-bfc1-4dae-8640-3722d8ec6cd6 Received: from drachen.dragon ([92.208.190.67]) by smtp.web.de (mrweb106 [213.165.67.124]) with ESMTPSA (Nemesis) id 1M28SB-1ob94d1DzN-002Cev for ; Thu, 15 Sep 2022 04:55:14 +0200 From: Michael Heerdegen To: bug-gnu-emacs@gnu.org Subject: 29.0.50; loaddefs-generate docstring: DIR vs. DIRS Date: Thu, 15 Sep 2022 04:55:13 +0200 Message-ID: <87pmfxny7i.fsf@web.de> MIME-Version: 1.0 Content-Type: text/plain X-Provags-ID: V03:K1:1QWw7YXMnvH+pf4DmLLWMPayCUhhkIMlrdQGwVePcSFatCha6qe N//q7Yqb/5uWvHUl7ZG3VXWV2LRvpGuRCn6052ovy0gPCgTKSfoGGwZcyA3PXIyPy2axBSc QyP5hc9ibXM/6UWA2WWdTgxZeUl6O43fTODGjMkPB2UOdYqBFHbpJgOgr4IGYMu2PKTopus 8aviZ/hCmS/Rqal/TQuHg== X-Spam-Flag: NO X-UI-Out-Filterresults: notjunk:1;V03:K0:4QYn5zKaSu0=:5n/c33APBnw+bEUQjzQsLY SdgghjvoOiR8VO0AeBO8aAo5LrY8De9F+cCDuftXGPHEUwONyT4HL0wUTds2c0ZWOtTJXRDiQ 4cFyRF/keKbkX1+asOv0bNuZRMTinzy2poPGhYNaIQsxf/jyCx+VnSSpVLPFJPI9YDco+TDzt EwS/wbgRrWX4ND0MwMjt58IjaVSTkbyqxQlABGs3w3zbRn3GYQ1/K5TUkjEdd7OVq3UztbxxC RH3hsRu7xthvbu2F5P8N4hEmMOx0MVSMFkFZ7KmkWyb1JOyFzQCj5mvu7VUHh0vgisLXmmnW3 XufTAI/5RnYot/yXA4y/3ZEGQec8Jx3NtuWiZ1+RcbpR56ep1bU+wAjGUYMCFXgfswHuZy7Yh 0j7XLzgngDJG/va3V/3S1IAQYzYnLy01NdMDOctiTThEp7qLhRs83YM6c7s/C7MmkyNOvVZgA cNMXG2W8UA4HrNYX0qGF5Dk8epjisISWdTOPXFapljDuHKZuk58gTXftjZIWT/GY0ri0c4luP AZa6P8wmOjR7KlJ5fsgS2K3U59GwsdYb0GakogTB5SXpfzoDPTzHRT99G7JQk9ATHoH+scwEv G4tlfWMPHylhX7Y5iut1ldRhAH3gPTvKhW2bcF7eYH8RKlX+wLbLWFqvAgWltLsoPoH4aYUyt EhOSslm1VDJavT1L+YRrE2Q56JZu2pRhY9vJ0dq+H5+2MZaczrHbYf1AU7MQGFe8QbhWYVPCO z/msaa8vCqbUzac9Q+G4uLup0QinB/9LSyV2IHZ277j8yv6jy0dO58IbD6PQx6SaZnseopSGs xHMIpr6Od23fGkqOejpEUSuYXsi9iB8HRdges55GWRYP5uNH9RFX2Uzc3k3F0HbgJiWcM7InO qIgBbyyv7Tk8m21mvWxtDU2WeVlTER/z0KF3lep/VGBBQcqEUfKkKqDYUmPR0G/5ltqfTkRLM rjLYz4dvI15/xPwiLExVJKft6xCRGOZuiORSM/1Sfwo6OcxOPiNVGEO5cRLl8bH3KNoGm+Qzl KyJI1K3MuI43T9bPeMLFnKdHk13bkDARFZGMTI749PlSGZhijwNpExrUg7YUeHXmVaI7OpjYp 4IDNKPx4YuhwCBpS4BcECIxTlxR1Luq+Rvlha3Alfxou6fPc4XqSrpRwROSqfXMVroFQIVvIE kaPk1y5BAdV4SWtIlo5F8N8/Qe Received-SPF: pass client-ip=212.227.17.12; envelope-from=michael_heerdegen@web.de; helo=mout.web.de X-Spam_score_int: -20 X-Spam_score: -2.1 X-Spam_bar: -- X-Spam_report: (-2.1 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, FREEMAIL_FROM=0.001, RCVD_IN_MSPIKE_H3=0.001, RCVD_IN_MSPIKE_WL=0.001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001, T_SCC_BODY_TEXT_LINE=-0.01 autolearn=ham autolearn_force=no X-Spam_action: no action X-Spam-Score: 0.0 (/) 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: -2.4 (--) Hello, the first arg of loaddefs-generate has the name DIR but the first sentence names it DIRS. While that argument can be a dir or a list of dirs, this first sentence breaks our rules. Would it be worth to name the argument "DIR-OR-DIRS" for discoverability - or should the docstring just say "Generate loaddefs files for Lisp files in DIR. DIR can be either a single directory or a list of directories. [...]" ? TIA, Michael. In GNU Emacs 29.0.50 (build 7, x86_64-pc-linux-gnu, X toolkit, cairo version 1.16.0, Xaw scroll bars) of 2022-09-14 built on drachen Repository revision: 0dfe8c6023564b4ea86424c790ad0b4925110e1a Repository branch: master Windowing system distributor 'The X.Org Foundation', version 11.0.12011000 System Description: Debian GNU/Linux 11 (bullseye) Configured using: 'configure --with-x-toolkit=lucid' ------------=_1663230722-13748-1--