aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorRichard M. Stallman2005-02-06 11:11:51 +0000
committerRichard M. Stallman2005-02-06 11:11:51 +0000
commite93b7ca6aa44231ddb36c513809598db6fe66dd4 (patch)
treecbf98cf604a1e908da17ff491309736614a60595
parent1b53c26efbef002c7d668a08cc8ceb7113628dc3 (diff)
downloademacs-e93b7ca6aa44231ddb36c513809598db6fe66dd4.tar.gz
emacs-e93b7ca6aa44231ddb36c513809598db6fe66dd4.zip
(Emacs Invocation): +LINENUM is also an option.
(Action Arguments): Explain which kinds of -l args are found how. (Initial Options): --batch does not inhibit site-start. Add xrefs. (Command Example): Use --batch, not -batch.
-rw-r--r--man/cmdargs.texi40
1 files changed, 22 insertions, 18 deletions
diff --git a/man/cmdargs.texi b/man/cmdargs.texi
index d131baa094a..b5f98375f8f 100644
--- a/man/cmdargs.texi
+++ b/man/cmdargs.texi
@@ -14,15 +14,16 @@ when invoking Emacs. These are for compatibility with other editors and
14for sophisticated activities. We don't recommend using them for 14for sophisticated activities. We don't recommend using them for
15ordinary editing. 15ordinary editing.
16 16
17 Arguments starting with @samp{-} are @dfn{options}. Other arguments 17 Arguments starting with @samp{-} are @dfn{options}, and so is
18specify files to visit. Emacs visits the specified files while it 18@samp{+@var{linenum}. All other arguments specify files to visit.
19starts up. The last file name on your command line becomes the 19Emacs visits the specified files while it starts up. The last file
20current buffer; the other files are also visited in other buffers. If 20name on your command line becomes the current buffer; the other files
21there are two files, they are both displayed; otherwise the last file 21are also visited in other buffers. If there are two files, they are
22is displayed along with a buffer list that shows what other buffers 22both displayed; otherwise the last file is displayed along with a
23there are. As with most programs, the special argument @samp{--} says 23buffer list that shows what other buffers there are. As with most
24that all subsequent arguments are file names, not options, even if 24programs, the special argument @samp{--} says that all subsequent
25they start with @samp{-}. 25arguments are file names, not options, even if they start with
26@samp{-}.
26 27
27 Emacs command options can specify many things, such as the size and 28 Emacs command options can specify many things, such as the size and
28position of the X window Emacs uses, its colors, and so on. A few 29position of the X window Emacs uses, its colors, and so on. A few
@@ -111,9 +112,10 @@ Visit @var{file} using @code{find-file}, then go to line number
111@opindex --load 112@opindex --load
112@cindex loading Lisp libraries, command-line argument 113@cindex loading Lisp libraries, command-line argument
113Load a Lisp library named @var{file} with the function @code{load}. 114Load a Lisp library named @var{file} with the function @code{load}.
114@xref{Lisp Libraries}. The library can be found either in the current 115@xref{Lisp Libraries}. If @var{file} is not an absolute file name,
115directory, or in the Emacs library search path as specified 116the library can be found either in the current directory, or in the
116with @env{EMACSLOADPATH} (@pxref{General Variables}). 117Emacs library search path as specified with @env{EMACSLOADPATH}
118(@pxref{General Variables}).
117 119
118@item -L @var{dir} 120@item -L @var{dir}
119@opindex -L 121@opindex -L
@@ -218,10 +220,11 @@ echo area, while @code{message} and error messages output to
218@code{stderr}. Functions that would normally read from the minibuffer 220@code{stderr}. Functions that would normally read from the minibuffer
219take their input from @code{stdin} instead. 221take their input from @code{stdin} instead.
220 222
221@samp{--batch} implies @samp{-q} (do not load an init file). It also 223@samp{--batch} implies @samp{-q} (do not load an init file), but
222causes Emacs to exit after processing all the command options. In 224@file{site-start.el} is loaded nonetheless. It also causes Emacs to
223addition, it disables auto-saving except in buffers for which it has 225exit after processing all the command options. In addition, it
224been explicitly requested. 226disables auto-saving except in buffers for which it has been
227explicitly requested.
225 228
226@item --script @var{file} 229@item --script @var{file}
227@opindex --script 230@opindex --script
@@ -301,7 +304,8 @@ All buffers and strings are unibyte unless you (or a Lisp program)
301explicitly ask for a multibyte buffer or string. (Note that Emacs 304explicitly ask for a multibyte buffer or string. (Note that Emacs
302always loads Lisp files in multibyte mode, even if @samp{--unibyte} is 305always loads Lisp files in multibyte mode, even if @samp{--unibyte} is
303specified; see @ref{Enabling Multibyte}.) Setting the environment 306specified; see @ref{Enabling Multibyte}.) Setting the environment
304variable @env{EMACS_UNIBYTE} has the same effect. 307variable @env{EMACS_UNIBYTE} has the same effect
308(@pxref{General Variables}).
305 309
306@item --multibyte 310@item --multibyte
307@opindex --multibyte 311@opindex --multibyte
@@ -320,7 +324,7 @@ loaded, performs some useful operation on the current buffer, expected
320to be a C program. 324to be a C program.
321 325
322@example 326@example
323emacs -batch foo.c -l hack-c -f save-buffer >& log 327emacs --batch foo.c -l hack-c -f save-buffer >& log
324@end example 328@end example
325 329
326@noindent 330@noindent