[ < ] [ > ]   [ << ] [ Up ] [ >> ]         [Top] [Contents] [Index] [ ? ]

AE. 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 ordinary editing.

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 visited in other buffers. If there are two files, they are both displayed; otherwise the last file is displayed along with a buffer list that shows what other buffers there are. As with most programs, 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 form.

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 terminate 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.

AE.1 Action Arguments  Arguments to visit files, load libraries, and call functions.
AE.2 Initial Options  Arguments that take effect while starting Emacs.
AE.3 Command Argument Example  Examples of using command line arguments.
AE.4 Resuming Emacs with Arguments  Specifying arguments when you resume a running Emacs.
AE.5 Environment Variables  Environment variables that Emacs uses.

AE.6 Specifying the Display Name  Changing the default display and using remote login.
AE.7 Font Specification Options  Choosing a font for text, under X.
AE.8 Window Color Options  Choosing colors, under X.
AE.9 Options for Window Geometry  Start-up window size, under X.
AE.10 Internal and External Borders  Internal and external borders, under X.
AE.11 Frame Titles  Specifying the initial frame's title.
AE.12 Icons  Choosing what sort of icon to use, under X.
AE.13 X Resources  Advanced use of classes and resources, under X.
AE.14 Lucid Menu X Resources  X resources for Lucid menus.
AE.15 LessTif Menu X Resources  X resources for LessTif and Motif menus.


[ < ] [ > ]   [ << ] [ Up ] [ >> ]         [Top] [Contents] [Index] [ ? ]

This document was generated on April 2, 2002 using texi2html