From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED!not-for-mail From: Richard Stallman Newsgroups: gmane.emacs.devel Subject: Re: [PATCH] Use recommended long options syntax in man page Date: Thu, 11 Jan 2018 14:51:30 -0500 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> Reply-To: rms@gnu.org NNTP-Posting-Host: blaine.gmane.org Content-Type: text/plain; charset=Utf-8 X-Trace: blaine.gmane.org 1515700242 6331 195.159.176.226 (11 Jan 2018 19:50:42 GMT) X-Complaints-To: usenet@blaine.gmane.org NNTP-Posting-Date: Thu, 11 Jan 2018 19:50:42 +0000 (UTC) Cc: phst@google.com, eliz@gnu.org, eggert@cs.ucla.edu, p.stephani2@gmail.com, emacs-devel@gnu.org To: Richard Copley Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Thu Jan 11 20:50:37 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 1eZirs-0000gF-GX for ged-emacs-devel@m.gmane.org; Thu, 11 Jan 2018 20:50:28 +0100 Original-Received: from localhost ([::1]:37824 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1eZits-0004QP-2X for ged-emacs-devel@m.gmane.org; Thu, 11 Jan 2018 14:52:32 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:55120) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1eZit0-0003q4-5j for emacs-devel@gnu.org; Thu, 11 Jan 2018 14:51:41 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1eZisz-0006yf-FA for emacs-devel@gnu.org; Thu, 11 Jan 2018 14:51:38 -0500 Original-Received: from fencepost.gnu.org ([2001:4830:134:3::e]:53883) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1eZiss-0006q1-FK; Thu, 11 Jan 2018 14:51:30 -0500 Original-Received: from rms by fencepost.gnu.org with local (Exim 4.82) (envelope-from ) id 1eZiss-0008T6-0R; Thu, 11 Jan 2018 14:51:30 -0500 In-reply-to: (message from Richard Copley on Wed, 10 Jan 2018 19:26:54 +0000) X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 2001:4830:134:3::e 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:221855 Archived-At: [[[ To any NSA and FBI agents reading my email: please consider ]]] [[[ whether defending the US Constitution against all enemies, ]]] [[[ foreign or domestic, requires you to follow Snowden's example. ]]] > 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. Please use = for long option arguments in the man page. -- Dr Richard Stallman President, Free Software Foundation (https://gnu.org, https://fsf.org) Internet Hall-of-Famer (https://internethalloffame.org) Skype: No way! See https://stallman.org/skype.html.