all messages for Emacs-related lists mirrored at yhetil.org
 help / color / mirror / code / Atom feed
* 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-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

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-18 14:26 documentation typo: `--terminal' fails 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
  -- strict thread matches above, loose matches on Subject: below --
2008-02-19  1:49 Robert J. Chassell
2008-02-19  2:19 ` Stefan Monnier

Code repositories for project(s) associated with this external index

	https://git.savannah.gnu.org/cgit/emacs.git
	https://git.savannah.gnu.org/cgit/emacs/org-mode.git

This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.