From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED!not-for-mail From: Paul Eggert Newsgroups: gmane.emacs.devel Subject: Re: [PATCH] Use recommended long options syntax in man page Date: Tue, 9 Jan 2018 14:21:49 -0800 Organization: UCLA Computer Science Department Message-ID: <2a79ab0b-9257-6653-f2e3-baed797346cf@cs.ucla.edu> References: <20180107231238.76897-1-phst@google.com> <439239ad-5191-84a6-4c07-b34536ebd437@cs.ucla.edu> <245f0400-3234-3623-1085-d8be74c5bd04@cs.ucla.edu> <83608b6j3u.fsf@gnu.org> NNTP-Posting-Host: blaine.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8; format=flowed Content-Transfer-Encoding: 7bit X-Trace: blaine.gmane.org 1515536472 17114 195.159.176.226 (9 Jan 2018 22:21:12 GMT) X-Complaints-To: usenet@blaine.gmane.org NNTP-Posting-Date: Tue, 9 Jan 2018 22:21:12 +0000 (UTC) User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:52.0) Gecko/20100101 Thunderbird/52.5.0 Cc: phst@google.com, p.stephani2@gmail.com, rms@gnu.org, emacs-devel@gnu.org To: Eli Zaretskii Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Tue Jan 09 23:21:08 2018 Return-path: Envelope-to: ged-emacs-devel@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by blaine.gmane.org with esmtp (Exim 4.84_2) (envelope-from ) id 1eZ2GN-0003Hm-Q4 for ged-emacs-devel@m.gmane.org; Tue, 09 Jan 2018 23:20:55 +0100 Original-Received: from localhost ([::1]:52152 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1eZ2IM-0006gC-BE for ged-emacs-devel@m.gmane.org; Tue, 09 Jan 2018 17:22:58 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:41779) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1eZ2HO-0006fl-PP for emacs-devel@gnu.org; Tue, 09 Jan 2018 17:21:59 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1eZ2HO-0006lg-1v for emacs-devel@gnu.org; Tue, 09 Jan 2018 17:21:58 -0500 Original-Received: from zimbra.cs.ucla.edu ([131.179.128.68]:50226) by eggs.gnu.org with esmtps (TLS1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1eZ2HI-0006dP-EL; Tue, 09 Jan 2018 17:21:52 -0500 Original-Received: from localhost (localhost [127.0.0.1]) by zimbra.cs.ucla.edu (Postfix) with ESMTP id 7CF7816161C; Tue, 9 Jan 2018 14:21:50 -0800 (PST) Original-Received: from zimbra.cs.ucla.edu ([127.0.0.1]) by localhost (zimbra.cs.ucla.edu [127.0.0.1]) (amavisd-new, port 10032) with ESMTP id IhchiwtjYLxq; Tue, 9 Jan 2018 14:21:49 -0800 (PST) Original-Received: from localhost (localhost [127.0.0.1]) by zimbra.cs.ucla.edu (Postfix) with ESMTP id C3E251615F2; Tue, 9 Jan 2018 14:21:49 -0800 (PST) X-Virus-Scanned: amavisd-new at zimbra.cs.ucla.edu Original-Received: from zimbra.cs.ucla.edu ([127.0.0.1]) by localhost (zimbra.cs.ucla.edu [127.0.0.1]) (amavisd-new, port 10026) with ESMTP id U9TbzBX3lQVp; Tue, 9 Jan 2018 14:21:49 -0800 (PST) Original-Received: from Penguin.CS.UCLA.EDU (Penguin.CS.UCLA.EDU [131.179.64.200]) by zimbra.cs.ucla.edu (Postfix) with ESMTPSA id A73E71606B2; Tue, 9 Jan 2018 14:21:49 -0800 (PST) In-Reply-To: <83608b6j3u.fsf@gnu.org> Content-Language: en-US X-detected-operating-system: by eggs.gnu.org: GNU/Linux 3.x [fuzzy] X-Received-From: 131.179.128.68 X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.21 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Original-Sender: "Emacs-devel" Xref: news.gmane.org gmane.emacs.devel:221769 Archived-At: On 01/09/2018 09:24 AM, Eli Zaretskii wrote: > The latter works in more use cases than the former, see bug#24949. So > recommending it will trip fewer newbies. That is true only for options with an optional argument, as Bug#24949#30 mentions. Most options are not that way, and we needn't recommend the spurious "=" for them. On the contrary, it's better to use "=" only in examples of options with an optional argument, as a way to help remind users that these options are unusual.