summaryrefslogtreecommitdiff
path: root/man/cmdargs.texi
diff options
context:
space:
mode:
authorRichard M. Stallman <rms@gnu.org>2005-02-06 11:11:51 +0000
committerRichard M. Stallman <rms@gnu.org>2005-02-06 11:11:51 +0000
commite93b7ca6aa44231ddb36c513809598db6fe66dd4 (patch)
treecbf98cf604a1e908da17ff491309736614a60595 /man/cmdargs.texi
parent1b53c26efbef002c7d668a08cc8ceb7113628dc3 (diff)
downloademacs-e93b7ca6aa44231ddb36c513809598db6fe66dd4.tar.gz
(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.
Diffstat (limited to 'man/cmdargs.texi')
-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
for sophisticated activities. We don't recommend using them for
ordinary editing.
- Arguments starting with @samp{-} are @dfn{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 @samp{--} says
-that all subsequent arguments are file names, not options, even if
-they start with @samp{-}.
+ Arguments starting with @samp{-} are @dfn{options}, and so is
+@samp{+@var{linenum}. All 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 @samp{--} says that all subsequent
+arguments are file names, not options, even if they start with
+@samp{-}.
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
@@ -111,9 +112,10 @@ Visit @var{file} using @code{find-file}, then go to line number
@opindex --load
@cindex loading Lisp libraries, command-line argument
Load a Lisp library named @var{file} with the function @code{load}.
-@xref{Lisp Libraries}. The library can be found either in the current
-directory, or in the Emacs library search path as specified
-with @env{EMACSLOADPATH} (@pxref{General Variables}).
+@xref{Lisp Libraries}. If @var{file} is not an absolute file name,
+the library can be found either in the current directory, or in the
+Emacs library search path as specified with @env{EMACSLOADPATH}
+(@pxref{General Variables}).
@item -L @var{dir}
@opindex -L
@@ -218,10 +220,11 @@ echo area, while @code{message} and error messages output to
@code{stderr}. Functions that would normally read from the minibuffer
take their input from @code{stdin} instead.
-@samp{--batch} implies @samp{-q} (do not load an init file). It also
-causes Emacs to exit after processing all the command options. In
-addition, it disables auto-saving except in buffers for which it has
-been explicitly requested.
+@samp{--batch} implies @samp{-q} (do not load an init file), but
+@file{site-start.el} is loaded nonetheless. It also causes Emacs to
+exit after processing all the command options. In addition, it
+disables auto-saving except in buffers for which it has been
+explicitly requested.
@item --script @var{file}
@opindex --script
@@ -301,7 +304,8 @@ All buffers and strings are unibyte unless you (or a Lisp program)
explicitly ask for a multibyte buffer or string. (Note that Emacs
always loads Lisp files in multibyte mode, even if @samp{--unibyte} is
specified; see @ref{Enabling Multibyte}.) Setting the environment
-variable @env{EMACS_UNIBYTE} has the same effect.
+variable @env{EMACS_UNIBYTE} has the same effect
+(@pxref{General Variables}).
@item --multibyte
@opindex --multibyte
@@ -320,7 +324,7 @@ loaded, performs some useful operation on the current buffer, expected
to be a C program.
@example
-emacs -batch foo.c -l hack-c -f save-buffer >& log
+emacs --batch foo.c -l hack-c -f save-buffer >& log
@end example
@noindent