From unknown Thu Aug 14 21:42:38 2025 Content-Disposition: inline Content-Transfer-Encoding: quoted-printable MIME-Version: 1.0 X-Mailer: MIME-tools 5.509 (Entity 5.509) Content-Type: text/plain; charset=utf-8 From: bug#57815 <57815@debbugs.gnu.org> To: bug#57815 <57815@debbugs.gnu.org> Subject: Status: 29.0.50; loaddefs-generate docstring: DIR vs. DIRS Reply-To: bug#57815 <57815@debbugs.gnu.org> Date: Fri, 15 Aug 2025 04:42:38 +0000 retitle 57815 29.0.50; loaddefs-generate docstring: DIR vs. DIRS reassign 57815 emacs submitter 57815 Michael Heerdegen severity 57815 normal thanks From debbugs-submit-bounces@debbugs.gnu.org Wed Sep 14 22:55:26 2022 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' From debbugs-submit-bounces@debbugs.gnu.org Thu Sep 15 02:18:59 2022 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 To: Michael Heerdegen In-Reply-To: <87pmfxny7i.fsf@web.de> (message from Michael Heerdegen on Thu, 15 Sep 2022 04:55:13 +0200) Subject: Re: bug#57815: 29.0.50; loaddefs-generate docstring: DIR vs. DIRS References: <87pmfxny7i.fsf@web.de> X-Spam-Score: -2.3 (--) X-Debbugs-Envelope-To: 57815 Cc: 57815@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 (---) > 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 debbugs-submit-bounces@debbugs.gnu.org Thu Sep 15 04:31:55 2022 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. From unknown Thu Aug 14 21:42:38 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, 13 Oct 2022 11: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