* Re: documentation typo: `--terminal' fails
@ 2008-02-19 1:49 Robert J. Chassell
2008-02-19 2:19 ` Stefan Monnier
0 siblings, 1 reply; 10+ messages in thread
From: Robert J. Chassell @ 2008-02-19 1:49 UTC (permalink / raw)
To: emacs-devel
But the documentation also doesn't mention that --terminal is
a valid argument.
Since it says `--terminal' implies `--no-window-system'.
I think it is fair to presume that `--terminal' is a valid argument.
I suggest we replace "`--terminal'" with
"This argument" or just "This".
That does not make it the same as `--no-window-system' or `-nw' which
is how I understand the documentation
`--terminal' implies `--no-window-system'.
Incidently,
(info "(emacs) Emacs Invocation")
says
GNU Emacs supports command line arguments to request various actions
when invoking Emacs.
`--terminal=DEVICE', `--display=DISPLAY', and `--no-window-system' are
called `initial options' both in that node and in the subnode
(info "(emacs) Initial Options")
> If the `--terminal' for `--no-window-system' needed a DEVICE argument
> I would expect it to say
>
> `--terminal=DEVICE' implies `--no-window-system'
The argument is not part of the option name.
Perhaps to an expert that is true, but when the documentation says
`--terminal' implies `--no-window-system'
I do not expect it to mean
`--terminal=DEVICE' implies `--no-window-system'
That is why I asked,
Perhaps this trouble is an ambiguity of the documentation?
--
Robert J. Chassell GnuPG Key ID: 004B4AC8
bob@rattlesnake.com bob@gnu.org
http://www.rattlesnake.com http://www.teak.cc
^ permalink raw reply [flat|nested] 10+ messages in thread* documentation typo: `--terminal' fails
@ 2008-02-18 14:26 Robert J. Chassell
2008-02-18 14:52 ` Andreas Schwab
0 siblings, 1 reply; 10+ messages in thread
From: Robert J. Chassell @ 2008-02-18 14:26 UTC (permalink / raw)
To: emacs-devel
When I run both in an xterm in an X windowing system and in a console
with no X:
$ /usr/local/src/emacs/src/emacs -Q -D --terminal
we see
emacs: Option `--terminal' requires an argument
so the documentation in
(info "(emacs)Initial Options")
is wrong. It says:
`-t DEVICE'
`--terminal=DEVICE'
Use DEVICE as the device for terminal input and output.
`--terminal' implies `--no-window-system'.
However, the following succeeds in both:
`-nw'
`--no-window-system'
Don't communicate directly with the window system, disregarding the
`DISPLAY' environment variable even if it is set. This means that
Emacs uses the terminal from which it was launched for all its
display and input.
Today's GNU Emacs CVS snapshot, Mon, 2008 Feb 18 10:46 UTC
GNU Emacs 23.0.60.5 (i686-pc-linux-gnu, GTK+ Version 2.12.5)
--
Robert J. Chassell GnuPG Key ID: 004B4AC8
bob@rattlesnake.com bob@gnu.org
http://www.rattlesnake.com http://www.teak.cc
^ permalink raw reply [flat|nested] 10+ messages in thread* Re: documentation typo: `--terminal' fails
2008-02-18 14:26 Robert J. Chassell
@ 2008-02-18 14:52 ` Andreas Schwab
2008-02-18 15:51 ` Robert J. Chassell
0 siblings, 1 reply; 10+ messages in thread
From: Andreas Schwab @ 2008-02-18 14:52 UTC (permalink / raw)
To: bob; +Cc: emacs-devel
"Robert J. Chassell" <bob@rattlesnake.com> writes:
> When I run both in an xterm in an X windowing system and in a console
> with no X:
>
> $ /usr/local/src/emacs/src/emacs -Q -D --terminal
>
> we see
>
> emacs: Option `--terminal' requires an argument
>
> so the documentation in
>
> (info "(emacs)Initial Options")
>
> is wrong. It says:
>
> `-t DEVICE'
> `--terminal=DEVICE'
> Use DEVICE as the device for terminal input and output.
> `--terminal' implies `--no-window-system'.
In which way is this wrong?
Andreas.
--
Andreas Schwab, SuSE Labs, schwab@suse.de
SuSE Linux Products GmbH, Maxfeldstraße 5, 90409 Nürnberg, Germany
PGP key fingerprint = 58CA 54C7 6D53 942B 1756 01D3 44D5 214B 8276 4ED5
"And now for something completely different."
^ permalink raw reply [flat|nested] 10+ messages in thread
* Re: documentation typo: `--terminal' fails
2008-02-18 14:52 ` Andreas Schwab
@ 2008-02-18 15:51 ` Robert J. Chassell
2008-02-18 15:56 ` Stefan Monnier
2008-02-18 15:58 ` Andreas Schwab
0 siblings, 2 replies; 10+ messages in thread
From: Robert J. Chassell @ 2008-02-18 15:51 UTC (permalink / raw)
To: emacs-devel
> `-t DEVICE'
> `--terminal=DEVICE'
> Use DEVICE as the device for terminal input and output.
> `--terminal' implies `--no-window-system'.
In which way is this wrong?
It fails to run Emacs although
$ /usr/local/src/emacs/src/emacs -Q -D --no-window-system
does.
--
Robert J. Chassell GnuPG Key ID: 004B4AC8
bob@rattlesnake.com bob@gnu.org
http://www.rattlesnake.com http://www.teak.cc
^ permalink raw reply [flat|nested] 10+ messages in thread* Re: documentation typo: `--terminal' fails
2008-02-18 15:51 ` Robert J. Chassell
@ 2008-02-18 15:56 ` Stefan Monnier
2008-02-18 20:50 ` Robert J. Chassell
2008-02-18 15:58 ` Andreas Schwab
1 sibling, 1 reply; 10+ messages in thread
From: Stefan Monnier @ 2008-02-18 15:56 UTC (permalink / raw)
To: bob; +Cc: emacs-devel
>> `-t DEVICE'
>> `--terminal=DEVICE'
>> Use DEVICE as the device for terminal input and output.
>> `--terminal' implies `--no-window-system'.
> In which way is this wrong?
> It fails to run Emacs although
> $ /usr/local/src/emacs/src/emacs -Q -D --no-window-system
> does.
Because you forgot the DEVICE argument, which is clearly required
according to the documentation you quoted.
Stefan
^ permalink raw reply [flat|nested] 10+ messages in thread* Re: documentation typo: `--terminal' fails
2008-02-18 15:56 ` Stefan Monnier
@ 2008-02-18 20:50 ` Robert J. Chassell
2008-02-18 21:16 ` Stefan Monnier
2008-02-18 22:23 ` Andreas Schwab
0 siblings, 2 replies; 10+ messages in thread
From: Robert J. Chassell @ 2008-02-18 20:50 UTC (permalink / raw)
To: emacs-devel
>> `-t DEVICE'
>> `--terminal=DEVICE'
>> Use DEVICE as the device for terminal input and output.
>> `--terminal' implies `--no-window-system'.
> In which way is this wrong?
> It fails to run Emacs although
> $ /usr/local/src/emacs/src/emacs -Q -D --no-window-system
> does.
Because you forgot the DEVICE argument, which is clearly required
according to the documentation you quoted.
No, the documentation clearly says that
`--terminal' implies `--no-window-system'
and neither `--terminal' nor `--no-window-system' say they need an argument.
If the `--terminal' for `--no-window-system' needed a DEVICE argument
I would expect it to say
`--terminal=DEVICE' implies `--no-window-system'
but it does not.
Perhaps this trouble is an ambiguity of the documentation?
> It fails to run Emacs although
In which way does it fail when used as documented?
>
> $ /usr/local/src/emacs/src/emacs -Q -D --no-window-system
>
> does.
Does what?
/usr/local/src/emacs/src/emacs -Q -D --no-window-system
runs an instance of Emacs.
--
Robert J. Chassell GnuPG Key ID: 004B4AC8
bob@rattlesnake.com bob@gnu.org
http://www.rattlesnake.com http://www.teak.cc
^ permalink raw reply [flat|nested] 10+ messages in thread* Re: documentation typo: `--terminal' fails
2008-02-18 20:50 ` Robert J. Chassell
@ 2008-02-18 21:16 ` Stefan Monnier
2008-02-18 22:23 ` Andreas Schwab
1 sibling, 0 replies; 10+ messages in thread
From: Stefan Monnier @ 2008-02-18 21:16 UTC (permalink / raw)
To: bob; +Cc: emacs-devel
>>> `-t DEVICE'
>>> `--terminal=DEVICE'
>>> Use DEVICE as the device for terminal input and output.
>>> `--terminal' implies `--no-window-system'.
>> In which way is this wrong?
>> It fails to run Emacs although
>> $ /usr/local/src/emacs/src/emacs -Q -D --no-window-system
>> does.
> Because you forgot the DEVICE argument, which is clearly required
> according to the documentation you quoted.
> No, the documentation clearly says that
> `--terminal' implies `--no-window-system'
But the documentation also doesn't mention that --terminal is
a valid argument. So I think your interpretation is pretty far fetched,
but obviously you disagree. I suggest we replace "`--terminal'" with
"This argument" or just "This".
Stefan
^ permalink raw reply [flat|nested] 10+ messages in thread* Re: documentation typo: `--terminal' fails
2008-02-18 20:50 ` Robert J. Chassell
2008-02-18 21:16 ` Stefan Monnier
@ 2008-02-18 22:23 ` Andreas Schwab
1 sibling, 0 replies; 10+ messages in thread
From: Andreas Schwab @ 2008-02-18 22:23 UTC (permalink / raw)
To: bob; +Cc: emacs-devel
"Robert J. Chassell" <bob@rattlesnake.com> writes:
> >> `-t DEVICE'
> >> `--terminal=DEVICE'
> >> Use DEVICE as the device for terminal input and output.
> >> `--terminal' implies `--no-window-system'.
>
> > In which way is this wrong?
> > It fails to run Emacs although
> > $ /usr/local/src/emacs/src/emacs -Q -D --no-window-system
> > does.
>
> Because you forgot the DEVICE argument, which is clearly required
> according to the documentation you quoted.
>
> No, the documentation clearly says that
>
> `--terminal' implies `--no-window-system'
>
> and neither `--terminal' nor `--no-window-system' say they need an argument.
The doc clearly says that --terminal requires an argument.
> If the `--terminal' for `--no-window-system' needed a DEVICE argument
> I would expect it to say
>
> `--terminal=DEVICE' implies `--no-window-system'
The argument is not part of the option name.
> Perhaps this trouble is an ambiguity of the documentation?
There is no ambiguity in referring to the option as --terminal.
Andreas.
--
Andreas Schwab, SuSE Labs, schwab@suse.de
SuSE Linux Products GmbH, Maxfeldstraße 5, 90409 Nürnberg, Germany
PGP key fingerprint = 58CA 54C7 6D53 942B 1756 01D3 44D5 214B 8276 4ED5
"And now for something completely different."
^ permalink raw reply [flat|nested] 10+ messages in thread
* Re: documentation typo: `--terminal' fails
2008-02-18 15:51 ` Robert J. Chassell
2008-02-18 15:56 ` Stefan Monnier
@ 2008-02-18 15:58 ` Andreas Schwab
1 sibling, 0 replies; 10+ messages in thread
From: Andreas Schwab @ 2008-02-18 15:58 UTC (permalink / raw)
To: bob; +Cc: emacs-devel
"Robert J. Chassell" <bob@rattlesnake.com> writes:
> > `-t DEVICE'
> > `--terminal=DEVICE'
> > Use DEVICE as the device for terminal input and output.
> > `--terminal' implies `--no-window-system'.
>
> In which way is this wrong?
>
> It fails to run Emacs although
In which way does it fail when used as documented?
>
> $ /usr/local/src/emacs/src/emacs -Q -D --no-window-system
>
> does.
Does what?
Andreas.
--
Andreas Schwab, SuSE Labs, schwab@suse.de
SuSE Linux Products GmbH, Maxfeldstraße 5, 90409 Nürnberg, Germany
PGP key fingerprint = 58CA 54C7 6D53 942B 1756 01D3 44D5 214B 8276 4ED5
"And now for something completely different."
^ permalink raw reply [flat|nested] 10+ messages in thread
end of thread, other threads:[~2008-02-19 2:19 UTC | newest]
Thread overview: 10+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2008-02-19 1:49 documentation typo: `--terminal' fails Robert J. Chassell
2008-02-19 2:19 ` Stefan Monnier
-- strict thread matches above, loose matches on Subject: below --
2008-02-18 14:26 Robert J. Chassell
2008-02-18 14:52 ` Andreas Schwab
2008-02-18 15:51 ` Robert J. Chassell
2008-02-18 15:56 ` Stefan Monnier
2008-02-18 20:50 ` Robert J. Chassell
2008-02-18 21:16 ` Stefan Monnier
2008-02-18 22:23 ` Andreas Schwab
2008-02-18 15:58 ` Andreas Schwab
Code repositories for project(s) associated with this public inbox
https://git.savannah.gnu.org/cgit/emacs.git
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).