(emacs.info) Command Arguments
Command Line Arguments
GNU Emacs supports command line arguments to request various actions
when invoking Emacs. These are for compatibility with other editors and
for sophisticated activities. We don't recommend using them for
Arguments starting with `-' are "options". Other arguments specify
files to visit. Emacs visits the specified files while it starts up.
The last file name on your command line becomes the current buffer; the
other files are also present in other buffers. As usual, the special
argument `--' says that all subsequent arguments are file names, not
options, even if they start with `-'.
Emacs command options can specify many things, such as the size and
position of the X window Emacs uses, its colors, and so on. A few
options support advanced usage, such as running Lisp functions on files
in batch mode. The sections of this chapter describe the available
options, arranged according to their purpose.
There are two ways of writing options: the short forms that start
with a single `-', and the long forms that start with `--'. For
example, `-d' is a short form and `--display' is the corresponding long
The long forms with `--' are easier to remember, but longer to type.
However, you don't have to spell out the whole option name; any
unambiguous abbreviation is enough. When a long option takes an
argument, you can use either a space or an equal sign to separate the
option name and the argument. Thus, you can write either `--display
sugar-bombs:0.0' or `--display=sugar-bombs:0.0'. We recommend an equal
sign because it makes the relationship clearer, and the tables below
always show an equal sign.
Most options specify how to initialize Emacs, or set parameters for
the Emacs session. We call them "initial options". A few options
specify things to do: for example, load libraries, call functions, or
exit Emacs. These are called "action options". These and file names
together are called "action arguments". Emacs processes all the action
arguments in the order they are written.
* Action Arguments Arguments to visit files, load libraries,
and call functions.
* Initial Options Arguments that take effect while starting Emacs.
* Command Example Examples of using command line arguments.
* Resume Arguments Specifying arguments when you resume a running Emacs.
* Environment Environment variables that Emacs uses.
* Display X Changing the default display and using remote login.
* Font X Choosing a font for text, under X.
* Colors X Choosing colors, under X.
* Window Size X Start-up window size, under X.
* Borders X Internal and external borders, under X.
* Title X Specifying the initial frame's title.
* Icons X Choosing what sort of icon to use, under X.
* Resources X Advanced use of classes and resources, under X.
* Lucid Resources X resources for Lucid menus.
* Motif Resources X resources for Motif menus.
automatically generated by