From mboxrd@z Thu Jan 1 00:00:00 1970
Path: news.gmane.org!.POSTED!not-for-mail
From: Philipp Stephani
Newsgroups: gmane.emacs.bugs
Subject: bug#30106: [PATCH 1/2] Use recommended long options syntax in man page
Date: Wed, 17 Jan 2018 23:28:45 +0100
Message-ID: <20180117222846.93077-1-phst@google.com>
References:
NNTP-Posting-Host: blaine.gmane.org
X-Trace: blaine.gmane.org 1516228114 25961 195.159.176.226 (17 Jan 2018 22:28:34 GMT)
X-Complaints-To: usenet@blaine.gmane.org
NNTP-Posting-Date: Wed, 17 Jan 2018 22:28:34 +0000 (UTC)
Cc: Philipp Stephani
To: Glenn Morris , Eli Zaretskii ,
30106@debbugs.gnu.org
Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Wed Jan 17 23:28:29 2018
Return-path:
Envelope-to: geb-bug-gnu-emacs@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 1ebwBq-0005Ws-KT
for geb-bug-gnu-emacs@m.gmane.org; Wed, 17 Jan 2018 23:28:14 +0100
Original-Received: from localhost ([::1]:39231 helo=lists.gnu.org)
by lists.gnu.org with esmtp (Exim 4.71)
(envelope-from )
id 1ebwDp-0001zF-0q
for geb-bug-gnu-emacs@m.gmane.org; Wed, 17 Jan 2018 17:30:17 -0500
Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:47569)
by lists.gnu.org with esmtp (Exim 4.71)
(envelope-from ) id 1ebwDg-0001yv-82
for bug-gnu-emacs@gnu.org; Wed, 17 Jan 2018 17:30:09 -0500
Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
(envelope-from ) id 1ebwDb-00071E-5k
for bug-gnu-emacs@gnu.org; Wed, 17 Jan 2018 17:30:08 -0500
Original-Received: from debbugs.gnu.org ([208.118.235.43]:52757)
by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16)
(Exim 4.71) (envelope-from )
id 1ebwDb-00070Y-2D
for bug-gnu-emacs@gnu.org; Wed, 17 Jan 2018 17:30:03 -0500
Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2)
(envelope-from ) id 1ebwDa-0000S6-JW
for bug-gnu-emacs@gnu.org; Wed, 17 Jan 2018 17:30:02 -0500
X-Loop: help-debbugs@gnu.org
Resent-From: Philipp Stephani
Original-Sender: "Debbugs-submit"
Resent-CC: bug-gnu-emacs@gnu.org
Resent-Date: Wed, 17 Jan 2018 22:30:02 +0000
Resent-Message-ID:
Resent-Sender: help-debbugs@gnu.org
X-GNU-PR-Message: followup 30106
X-GNU-PR-Package: emacs
X-GNU-PR-Keywords:
Original-Received: via spool by 30106-submit@debbugs.gnu.org id=B30106.15162281431640
(code B ref 30106); Wed, 17 Jan 2018 22:30:02 +0000
Original-Received: (at 30106) by debbugs.gnu.org; 17 Jan 2018 22:29:03 +0000
Original-Received: from localhost ([127.0.0.1]:60650 helo=debbugs.gnu.org)
by debbugs.gnu.org with esmtp (Exim 4.84_2)
(envelope-from )
id 1ebwCd-0000QN-BB
for submit@debbugs.gnu.org; Wed, 17 Jan 2018 17:29:03 -0500
Original-Received: from mail-wr0-f179.google.com ([209.85.128.179]:39005)
by debbugs.gnu.org with esmtp (Exim 4.84_2)
(envelope-from ) id 1ebwCb-0000Pr-NE
for 30106@debbugs.gnu.org; Wed, 17 Jan 2018 17:29:02 -0500
Original-Received: by mail-wr0-f179.google.com with SMTP id z48so20588225wrz.6
for <30106@debbugs.gnu.org>; Wed, 17 Jan 2018 14:29:01 -0800 (PST)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025;
h=from:to:cc:subject:date:message-id:in-reply-to:references;
bh=TLar6gWv3GLhCBiJpcFIs/ZaeTdiXoZ4PQivVduO3Fw=;
b=QNsgv8hNAhnrhYPacM+1Sk3cNuN1Grh/eV+Jl/qdWbdriczkwPOVow/GvxKKI7EuFm
ukcJk2lHgdURvC4cBWShmjQV/yUuhEbNL9z9VOr8nJAaCsvHOiptQlcQSbmFkKMZDl1u
hiJA4zuVfMt6mqf8O8VHHfHdNofijnKashBMSFu5z69sAHa1OE/dkTHG/CrfmgPQ6oqt
WsFr3fAsaPoCcOCTkvWlEcldD4mZ+lL6cTdvifJIHzaHEeP0F2mMGHieKRUq1GWznioT
P1PbEe89HfgZA5yQD/HbgWCcAa5IHi63pCE2BfC+y23tkQQhq832pqryZjDanYdCZmjx
Y/gQ==
X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed;
d=1e100.net; s=20161025;
h=x-gm-message-state:from:to:cc:subject:date:message-id:in-reply-to
:references;
bh=TLar6gWv3GLhCBiJpcFIs/ZaeTdiXoZ4PQivVduO3Fw=;
b=q1lpM1X+mbus30f+jVqUVkvSbLbTD9LuacZkA58yNjuArueq50r++7q0GIlvBvbCcX
U+ZtE+FsehguOmDdE9XKljWqPJhqVufiS3KD70oz5TorNP7lDHtY9EAMfAE9vUu2eDKZ
4f8jczBTva7ts0x05deCD5G3rsxw8e1QXXAH1645f93LPBPVbZ62uJ+IKfpZs/KsMDEr
K8W64T66MWpaKVoiRWiKDdKPUQr3hV2zZoVXJsAYM2pebDkICeccRKwGQOyu6apWGXyu
oQkW65q5ABmBqiYdSZ5aeeFSxqI8xNVL4q+OL0MaAYqjY3KjYxJPtaaOABsO97ggyJGs
gOMQ==
X-Gm-Message-State: AKwxytfGjNDDbh2ZDacip74iTJKs7HXsl6gCXFl/PzC/MWTgdPy6ad5F
CoguzZN6Nu2A9dGHtxf2vXY=
X-Google-Smtp-Source: ACJfBotjQdKV2oeRTsSn7NE0ek6ZuJyPb9LTltt8TVEgb08bd5riSCxjPW4Kkl2n4ir+Xx7NbIN8CQ==
X-Received: by 10.223.184.58 with SMTP id h55mr3976377wrf.110.1516228135862;
Wed, 17 Jan 2018 14:28:55 -0800 (PST)
Original-Received: from p.cm.cablesurf.de (46.128.198.151.dynamic.cablesurf.de.
[46.128.198.151]) by smtp.gmail.com with ESMTPSA id
z71sm16696138wrc.11.2018.01.17.14.28.54
(version=TLS1_2 cipher=ECDHE-RSA-AES128-SHA bits=128/128);
Wed, 17 Jan 2018 14:28:55 -0800 (PST)
X-Google-Original-From: Philipp Stephani
X-Mailer: git-send-email 2.15.1
In-Reply-To:
X-BeenThere: debbugs-submit@debbugs.gnu.org
X-Mailman-Version: 2.1.18
Precedence: list
X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic]
X-Received-From: 208.118.235.43
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.org@gnu.org
Original-Sender: "bug-gnu-emacs"
Xref: news.gmane.org gmane.emacs.bugs:142240
Archived-At:
* doc/man/emacs.1.in: Specify equals sign for long options, as
recommended in the manual.
---
doc/man/emacs.1.in | 50 +++++++++++++++++++++++++-------------------------
1 file changed, 25 insertions(+), 25 deletions(-)
diff --git a/doc/man/emacs.1.in b/doc/man/emacs.1.in
index 7654c9610d..5116953041 100644
--- a/doc/man/emacs.1.in
+++ b/doc/man/emacs.1.in
@@ -61,7 +61,7 @@ The following options are of general interest:
Edit
.IR file .
.TP
-.BI \-\-file " file\fR,\fP " \-\-find-file " file\fR,\fP " \-\-visit " file"
+.BI \-\-file= "file\fR,\fP " \-\-find-file= "file\fR,\fP " \-\-visit= "file"
The same as specifying
.I file
directly as an argument.
@@ -79,7 +79,7 @@ Go to the specified
and
.IR column .
.TP
-.BI \-\-chdir " directory"
+.BI \-\-chdir= "directory"
Change to
.IR directory .
.TP
@@ -112,12 +112,12 @@ Lisp debugger during the processing of the user init file
.BR ~/.emacs .
This is useful for debugging problems in the init file.
.TP
-.BI \-u " user\fR,\fP " \-\-user " user"
+.BI \-u " user\fR,\fP " \-\-user= "user"
Load
.IR user 's
init file.
.TP
-.BI \-t " file\fR,\fP " \-\-terminal " file"
+.BI \-t " file\fR,\fP " \-\-terminal= "file"
Use specified
.I file
as the terminal instead of using stdin/stdout.
@@ -144,15 +144,15 @@ The following options are Lisp-oriented
(these options are processed in the order encountered):
.RS
.TP 8
-.BI \-f " function\fR,\fP " \-\-funcall " function"
+.BI \-f " function\fR,\fP " \-\-funcall= "function"
Execute the lisp function
.IR function .
.TP
-.BI \-l " file\fR,\fP " \-\-load " file"
+.BI \-l " file\fR,\fP " \-\-load= "file"
Load the lisp code in the file
.IR file .
.TP
-.BI \-\-eval " expr\fR,\fP " \-\-execute " expr"
+.BI \-\-eval= "expr\fR,\fP " \-\-execute= "expr"
Evaluate the Lisp expression
.IR expr .
.RE
@@ -168,12 +168,12 @@ The editor will send messages to stderr.
You must use \-l and \-f options to specify files to execute
and functions to call.
.TP
-.BI \-\-script " file"
+.BI \-\-script= "file"
Run
.I file
as an Emacs Lisp script.
.TP
-.BI \-\-insert " file"
+.BI \-\-insert= "file"
Insert contents of
.I file
into the current buffer.
@@ -183,7 +183,7 @@ Exit
.I Emacs
while in batch mode.
.TP
-.BI \-L " dir\fR,\fP " \-\-directory " dir"
+.BI \-L " dir\fR,\fP " \-\-directory= "dir"
Add
.I dir
to the list of directories
@@ -206,13 +206,13 @@ process so that you can continue using your original window.
can be started with the following X switches:
.RS
.TP 8
-.BI \-\-name " name"
+.BI \-\-name= "name"
Specify the name which should be assigned to the initial
.I Emacs
window.
This controls looking up X resources as well as the window title.
.TP
-.BI \-T " name\fR,\fP " \-\-title " name"
+.BI \-T " name\fR,\fP " \-\-title= "name"
Specify the title for the initial X window.
.TP
.BR \-r ", " \-rv ", " \-\-reverse\-video
@@ -220,7 +220,7 @@ Display the
.I Emacs
window in reverse video.
.TP
-.BI \-fn " font\fR,\fP " \-\-font " font"
+.BI \-fn " font\fR,\fP " \-\-font= "font"
Set the
.I Emacs
window's font to that specified by
@@ -247,7 +247,7 @@ for more information.
When you specify a font, be sure to put a space between the
switch and the font name.
.TP
-.BI \-\-xrm " resources"
+.BI \-\-xrm= "resources"
Set additional X resources.
.TP
.BI "\-\-color\fR,\fP \-\-color=" mode
@@ -256,20 +256,20 @@ Override color mode for character terminals;
defaults to "auto", and can also be "never", "auto", "always",
or a mode name like "ansi8".
.TP
-.BI \-bw " pixels\fR,\fP " \-\-border\-width " pixels"
+.BI \-bw " pixels\fR,\fP " \-\-border\-width= "pixels"
Set the
.I Emacs
window's border width to the number of pixels specified by
.IR pixels .
Defaults to one pixel on each side of the window.
.TP
-.BI \-ib " pixels\fR,\fP " \-\-internal\-border " pixels"
+.BI \-ib " pixels\fR,\fP " \-\-internal\-border= "pixels"
Set the window's internal border width to the number of pixels specified
by
.IR pixels .
Defaults to one pixel of padding on each side of the window.
.TP
-.BI \-g " geometry\fR,\fP " \-\-geometry " geometry"
+.BI \-g " geometry\fR,\fP " \-\-geometry= "geometry"
Set the
.I Emacs
window's width, height, and position as specified.
@@ -282,7 +282,7 @@ See the Emacs manual, section "Options for Window Size and Position",
for information on how window sizes interact
with selecting or deselecting the tool bar and menu bar.
.TP
-.BI \-lsp " pixels\fR,\fP " \-\-line\-spacing " pixels"
+.BI \-lsp " pixels\fR,\fP " \-\-line\-spacing= "pixels"
Additional space to put between lines.
.TP
.BR \-vb ", " \-\-vertical\-scroll\-bars
@@ -300,26 +300,26 @@ Make the first frame as wide as the screen.
.BR \-mm ", " \-\-maximized
Maximize the first frame, like "\-fw \-fh".
.TP
-.BI \-fg " color\fR,\fP " \-\-foreground\-color " color"
+.BI \-fg " color\fR,\fP " \-\-foreground\-color= "color"
On color displays, set the color of the text.
Use the command
.I M\-x list\-colors\-display
for a list of valid color names.
.TP
-.BI \-bg " color\fR,\fP " \-\-background\-color " color"
+.BI \-bg " color\fR,\fP " \-\-background\-color= "color"
On color displays, set the color of the window's background.
.TP
-.BI \-bd " color\fR,\fP " \-\-border\-color " color"
+.BI \-bd " color\fR,\fP " \-\-border\-color= "color"
On color displays, set the color of the window's border.
.TP
-.BI \-cr " color\fR,\fP " \-\-cursor\-color " color"
+.BI \-cr " color\fR,\fP " \-\-cursor\-color= "color"
On color displays, set the color of the window's text cursor.
.TP
-.BI \-ms " color\fR,\fP " \-\-mouse\-color " color"
+.BI \-ms " color\fR,\fP " \-\-mouse\-color= "color"
On color displays, set the color of the window's mouse cursor.
.TP
-.BI \-d " displayname\fR,\fP " \-\-display " displayname"
+.BI \-d " displayname\fR,\fP " \-\-display= "displayname"
Create the
.I Emacs
window on the display specified by
@@ -337,7 +337,7 @@ in iconified state.
.BR \-nbc ", " \-\-no\-blinking\-cursor
Disable blinking cursor.
.TP
-.BI \-\-parent-id " xid"
+.BI \-\-parent-id= "xid"
Set parent window.
.TP
.BR \-nw ", " \-\-no\-window\-system
--
2.15.1