comparison man/xemacs/cmdargs.texi @ 446:1ccc32a20af4 r21-2-38

Import from CVS: tag r21-2-38
author cvs
date Mon, 13 Aug 2007 11:37:21 +0200
parents abe6d1db359e
children fd8a9a4d81d9
comparison
equal deleted inserted replaced
445:34f3776fcf0e 446:1ccc32a20af4
9 with other editors and for sophisticated activities. If you are using 9 with other editors and for sophisticated activities. If you are using
10 XEmacs under the X window system, you can also use a number of 10 XEmacs under the X window system, you can also use a number of
11 standard Xt command line arguments. Command line arguments are not usually 11 standard Xt command line arguments. Command line arguments are not usually
12 needed for editing with Emacs; new users can skip this section. 12 needed for editing with Emacs; new users can skip this section.
13 13
14 Many editors are designed to be started afresh each time you want to 14 Many editors are designed to be started afresh each time you want to
15 edit. You start the editor to edit one file; then exit the editor. The 15 edit. You start the editor to edit one file; then exit the editor. The
16 next time you want to edit either another file or the same one, you 16 next time you want to edit either another file or the same one, you
17 start the editor again. Under these circumstances, it makes sense to use a 17 start the editor again. Under these circumstances, it makes sense to use a
18 command line argument to say which file to edit. 18 command line argument to say which file to edit.
19 19
26 to log out. Since you usually read files by typing commands to Emacs, 26 to log out. Since you usually read files by typing commands to Emacs,
27 command line arguments for specifying a file when Emacs is started are seldom 27 command line arguments for specifying a file when Emacs is started are seldom
28 needed. 28 needed.
29 29
30 Emacs accepts command-line arguments that specify files to visit, 30 Emacs accepts command-line arguments that specify files to visit,
31 functions to call, and other activities and operating modes. If you are 31 functions to call, and other activities and operating modes. If you
32 running XEmacs under the X window system, a number of standard 32 are running XEmacs under the X window system, a number of standard Xt
33 Xt command line arguments are available as well. 33 command line arguments are available, as well as a few X parameters
34 that are XEmacs-specific.
35
36 Options with long names with a single initial hyphen are also
37 recognized with the GNU double initial hyphen syntax. (The reverse
38 is not true.)
34 39
35 The following subsections list: 40 The following subsections list:
36 @itemize @bullet 41 @itemize @bullet
37 @item 42 @item
38 Command line arguments that you can always use 43 Command line arguments that you can always use
76 @itemx -i @var{file} 81 @itemx -i @var{file}
77 Insert the contents of @var{file} into the current buffer. This is like 82 Insert the contents of @var{file} into the current buffer. This is like
78 what @kbd{M-x insert-buffer} does; @xref{Misc File Ops}. 83 what @kbd{M-x insert-buffer} does; @xref{Misc File Ops}.
79 84
80 @item -kill 85 @item -kill
81 Exit from Emacs without asking for confirmation. 86 Exit from Emacs without asking for confirmation. Always the last
87 argument processed, no matter where it appears in the command line.
82 88
83 @item -version 89 @item -version
84 @itemx -V 90 @itemx -V
85 Prints version information. This implies @samp{-batch}. 91 Prints version information. This implies @samp{-batch}.
86 92
97 The following arguments are recognized only at the beginning of the 103 The following arguments are recognized only at the beginning of the
98 command line. If more than one of them appears, they must appear in the 104 command line. If more than one of them appears, they must appear in the
99 order in which they appear in this table. 105 order in which they appear in this table.
100 106
101 @table @samp 107 @table @samp
102 @item -t @var{file} 108 @item --show-dump-id
109 @itemx -sd
110 Print the ID for the new portable dumper's dump file on the terminal and
111 exit. (Prints an error message and exits if XEmacs was not configured
112 @samp{--pdump}.)
113
114 @item --no-dump-file
115 @itemx -nd
116 Don't load the dump file. Roughly equivalent to old temacs. (Ignored if
117 XEmacs was not configured @samp{--pdump}.)
118
119 @item --terminal @var{file}
120 @itemx -t @var{file}
103 Use @var{file} instead of the terminal for input and output. This 121 Use @var{file} instead of the terminal for input and output. This
104 implies the @samp{-nw} option, documented below. 122 implies the @samp{-nw} option, documented below.
105 123
106 @cindex batch mode 124 @cindex batch mode
107 @item -batch 125 @item -batch
119 @samp{-batch} implies @samp{-q} (do not load an init file). It also 137 @samp{-batch} implies @samp{-q} (do not load an init file). It also
120 causes Emacs to kill itself after all command switches have been 138 causes Emacs to kill itself after all command switches have been
121 processed. In addition, auto-saving is not done except in buffers for 139 processed. In addition, auto-saving is not done except in buffers for
122 which it has been explicitly requested. 140 which it has been explicitly requested.
123 141
124 @item -nw 142 @item --no-windows
143 @itemx -nw
125 Start up XEmacs in TTY mode (using the TTY XEmacs was started from), 144 Start up XEmacs in TTY mode (using the TTY XEmacs was started from),
126 rather than trying to connect to an X display. Note that this happens 145 rather than trying to connect to an X display. Note that this happens
127 automatically if the @samp{DISPLAY} environment variable is not set. 146 automatically if the @samp{DISPLAY} environment variable is not set.
128 147
129 @item -debug-init 148 @item -debug-init
165 184
166 @item -user @var{user} 185 @item -user @var{user}
167 @itemx -u @var{user} 186 @itemx -u @var{user}
168 Equivalent to @samp{-user-init-file ~@var{user}/.xemacs/init.el 187 Equivalent to @samp{-user-init-file ~@var{user}/.xemacs/init.el
169 -user-init-directory ~@var{user}/.xemacs}, or @samp{-user-init-file 188 -user-init-directory ~@var{user}/.xemacs}, or @samp{-user-init-file
170 ~@var{user}/.emacs -user-init-directory ~@var{user}/.xemacs}. whichever 189 ~@var{user}/.emacs -user-init-directory ~@var{user}/.xemacs}, whichever
171 init file comes first. @xref{Init File}. 190 init file comes first. @xref{Init File}.
172 191
173 @end table 192 @end table
174 193
175 @vindex command-line-args 194 @vindex command-line-args