From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED!not-for-mail From: Richard Copley Newsgroups: gmane.emacs.devel Subject: Re: [PATCH] Use recommended long options syntax in man page Date: Wed, 10 Jan 2018 19:26:54 +0000 Message-ID: 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> <2a79ab0b-9257-6653-f2e3-baed797346cf@cs.ucla.edu> <83mv1m5qrl.fsf@gnu.org> NNTP-Posting-Host: blaine.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset="UTF-8" X-Trace: blaine.gmane.org 1515612398 17136 195.159.176.226 (10 Jan 2018 19:26:38 GMT) X-Complaints-To: usenet@blaine.gmane.org NNTP-Posting-Date: Wed, 10 Jan 2018 19:26:38 +0000 (UTC) Cc: Philipp Stephani , p.stephani2@gmail.com, Paul Eggert , Richard Stallman , Emacs Development To: Eli Zaretskii Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Wed Jan 10 20:26:33 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 1eZM0z-0003MW-Gc for ged-emacs-devel@m.gmane.org; Wed, 10 Jan 2018 20:26:21 +0100 Original-Received: from localhost ([::1]:34249 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1eZM2z-0002vh-7q for ged-emacs-devel@m.gmane.org; Wed, 10 Jan 2018 14:28:25 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:38150) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1eZM26-0002Jg-1v for emacs-devel@gnu.org; Wed, 10 Jan 2018 14:27:30 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1eZM25-0006ud-9K for emacs-devel@gnu.org; Wed, 10 Jan 2018 14:27:30 -0500 Original-Received: from mail-oi0-x236.google.com ([2607:f8b0:4003:c06::236]:38161) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1eZM22-0006rw-5a; Wed, 10 Jan 2018 14:27:26 -0500 Original-Received: by mail-oi0-x236.google.com with SMTP id m65so66947oig.5; Wed, 10 Jan 2018 11:27:25 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=mime-version:in-reply-to:references:from:date:message-id:subject:to :cc; bh=61dpoVzfdOs12wPiRIlEJ6tq7wDj6AiYQ2jjXxtuFvI=; b=ki/yLiNIeEJfZPTd5Q4mXrgvddDPVgKIe2sHC4MO84SCI4SPNxvDJlx2stBBuE6MWj bFbuMN/F6OubBGrKfnC4/LS2/opF15ScVM7PxqkTFWB26xQzkzYXeXFcyUiwAsJ1Yrgk WHfzEuuAZzkpYRF3CSFmpXjq6OH3wRUtkcR1H9wotCAPHi/HRrNLWTvGXIIhItY106oL 0PwSqoeEE6TJizHaMSGmAwmHkokOeF6K7dKfjYfAj5CfMLeichX+7QFGagmAPUCn9Spa GJsW69Ojx7458EqNmc7fzxlQDBsdyeSQrK8FvMYw1R2ggZeKjMvf89GhnvMsgr4VO/Wr xjdg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:mime-version:in-reply-to:references:from:date :message-id:subject:to:cc; bh=61dpoVzfdOs12wPiRIlEJ6tq7wDj6AiYQ2jjXxtuFvI=; b=XbQ1TdW2jlbdOgiRtrTIZCX2TI0syVS76/0+XSX9bsjJWgdz5iSGEzrw9un+tVrKkl ErQJT+LblYfUQApFx3yWC8OZuqVS4OTxlteh+47AQdHRiKvV7JAvXanCckc/qbh7m1pN Td0QYduQLz16DOQMSXYuDLBwfZUPauixxrgHCosa+p35JPxv1O8y15MbHKcm5Lb/1Rgv 1el8O8o1PgA7A/AfkUkLdCRNpTk6hQfaFfsXUNoAWIHani9WYXoMHRyB0h8lSvh0UNeR 6e+mfowzIciPHCw8cnvkCtt8+49jJTnMbBXNfn+xl4ilpEpR1V0Wt5FPW76smuS75ZtA 8EZQ== X-Gm-Message-State: AKGB3mJ2vKUdo63jLsOZJFFlcn4nkxJy3IKtRwMHnOrG6itPm/Ntv4tp s7k1jNMB1P38OconGogSojoFLVdBTB2JNA1MK+vz1A== X-Google-Smtp-Source: ACJfBoun0P+Bmj6q9OLQwGAwyInYpQGHch0gtYwFU6Ul3uYFxpxyXNXUl9aET9gtEJDqK2QRg//832GfUGDLPyIQJnc= X-Received: by 10.202.252.3 with SMTP id a3mr10375102oii.252.1515612444866; Wed, 10 Jan 2018 11:27:24 -0800 (PST) Original-Received: by 10.157.5.184 with HTTP; Wed, 10 Jan 2018 11:26:54 -0800 (PST) In-Reply-To: <83mv1m5qrl.fsf@gnu.org> X-detected-operating-system: by eggs.gnu.org: Genre and OS details not recognized. X-Received-From: 2607:f8b0:4003:c06::236 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:221806 Archived-At: On 10 January 2018 at 03:36, Eli Zaretskii wrote: >> Cc: rms@gnu.org, phst@google.com, p.stephani2@gmail.com, emacs-devel@gnu.org >> From: Paul Eggert >> Date: Tue, 9 Jan 2018 14:21:49 -0800 >> >> 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. > > Newbies or people who only rarely use these options would not know > which arguments are optional, so recommending to always use a '=' > makes their muscle memory more future-proof. Both arguments have merit. Manuals aren't just for newbies. Maybe there's room to introduce the syntax with the = first, then elaborate explaining the actual syntax in full. Or maybe that level of detail is best left for the TexInfo manual.