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#57815: 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 Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="25882"; mail-complaints-to="usenet@ciao.gmane.io" To: 57815@debbugs.gnu.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Thu Sep 15 04:56:28 2022 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 1oYf3D-0006ZR-Ls for geb-bug-gnu-emacs@m.gmane-mx.org; Thu, 15 Sep 2022 04:56:27 +0200 Original-Received: from localhost ([::1]:52148 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1oYf3C-0003or-H2 for geb-bug-gnu-emacs@m.gmane-mx.org; Wed, 14 Sep 2022 22:56:26 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:55152) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1oYf2o-0003ml-HN for bug-gnu-emacs@gnu.org; Wed, 14 Sep 2022 22:56:02 -0400 Original-Received: from debbugs.gnu.org ([209.51.188.43]:39713) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1oYf2o-000264-8Y for bug-gnu-emacs@gnu.org; Wed, 14 Sep 2022 22:56:02 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1oYf2n-00031k-P6 for bug-gnu-emacs@gnu.org; Wed, 14 Sep 2022 22:56: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: 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-Debbugs-Original-To: bug-gnu-emacs@gnu.org Original-Received: via spool by submit@debbugs.gnu.org id=B.166321052611593 (code B ref -1); Thu, 15 Sep 2022 02:56:01 +0000 Original-Received: (at submit) by debbugs.gnu.org; 15 Sep 2022 02:55:26 +0000 Original-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 Original-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 Original-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 Original-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 Original-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 X-Provags-ID: V03:K1:1QWw7YXMnvH+pf4DmLLWMPayCUhhkIMlrdQGwVePcSFatCha6qe N//q7Yqb/5uWvHUl7ZG3VXWV2LRvpGuRCn6052ovy0gPCgTKSfoGGwZcyA3PXIyPy2axBSc QyP5hc9ibXM/6UWA2WWdTgxZeUl6O43fTODGjMkPB2UOdYqBFHbpJgOgr4IGYMu2PKTopus 8aviZ/hCmS/Rqal/TQuHg== 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/9LSyV2IHZ277j8yv6jy0dO58IbD6PQx6SaZnseopSG 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-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:242550 Archived-At: 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'