# HG changeset patch # User Eli Zaretskii # Date 983612803 0 # Node ID 3dfa039c6a8c0ea313af0a5aa233e254ba884ddf # Parent 7da7487bbbd8d9153074a1128e8d84fec3864407 Many typo-fixes and clarifications from Dr Francis J. Wright . diff -r 7da7487bbbd8 -r 3dfa039c6a8c man/cmdargs.texi --- a/man/cmdargs.texi Sat Mar 03 09:18:52 2001 +0000 +++ b/man/cmdargs.texi Sat Mar 03 09:46:43 2001 +0000 @@ -77,8 +77,8 @@ @table @samp @item @var{file} -@itemx --visit @var{file} -@itemx --file @var{file} +@itemx --visit=@var{file} +@itemx --file=@var{file} Visit @var{file} using @code{find-file}. @xref{Visiting}. @item +@var{linenum} @var{file} @@ -97,8 +97,8 @@ @itemx --funcall=@var{function} Call Lisp function @var{function} with no arguments. -@item --eval @var{expression} -@itemx --execute @var{expression} +@item --eval=@var{expression} +@itemx --execute=@var{expression} Evaluate Lisp expression @var{expression}. @item --insert=@var{file} @@ -344,9 +344,9 @@ Used for shell-mode to override the @env{SHELL} environment variable. @item HISTFILE The name of the file that shell commands are saved in between logins. -This variable defaults to @file{~/.history} if you use (t)csh as shell, -to @file{~/.bash_history} if you use bash, to @file{~/.sh_history} if -you use ksh, and to @file{~/.history} otherwise. +This variable defaults to @file{~/.bash_history} if you use Bash, to +@file{~/.sh_history} if you use ksh, and to @file{~/.history} +otherwise. @item HOME The location of the user's files in the directory tree; used for expansion of file names starting with a tilde (@file{~}). On MS-DOS, it @@ -426,7 +426,7 @@ This specifies the current time zone and possibly also daylight savings information. On MS-DOS, if @code{TZ} is not set in the environment when Emacs starts, Emacs defines a default value as -appropriate for the country code returned by DOS. MS Windows +appropriate for the country code returned by DOS. On MS Windows, Emacs does not use @code{TZ} at all. @item USER The user's login name. See also @env{LOGNAME}. On MS-DOS, this @@ -443,8 +443,10 @@ @table @env @item COMSPEC -On MS-DOS, the name of the command interpreter to use. This is used to -make a default value for the @env{SHELL} environment variable. +On MS-DOS and MS-Windows, the name of the command interpreter to use +when invoking batch files and commands internal to the shell. On MS-DOS +this is also used to make a default value for the @env{SHELL} environment +variable. @item NAME On MS-DOS, this variable defaults to the value of the @env{USER} @@ -452,8 +454,8 @@ @item TEMP @itemx TMP -On MS-DOS, these specify the name of the directory for storing temporary -files in. +On MS-DOS and MS-Windows, these specify the name of the directory for +storing temporary files in. @item EMACSTEST On MS-DOS, this specifies a file to use to log the operation of the @@ -463,7 +465,7 @@ @item EMACSCOLORS Used on MS-DOS systems to set screen colors early, so that the screen won't momentarily flash the default colors when Emacs starts up. The -value of this variable should be two-character encoding of the +value of this variable should be the two-character encoding of the foreground (the first character) and the background (the second character) colors of the default face. Each character should be the hexadecimal code for the desired color on a standard PC text-mode @@ -492,7 +494,7 @@ With Emacs, the main reason people change the default display is to let them log into another system, run Emacs on that system, but have the -window displayed at their local terminal. You might need to use login +window displayed at their local terminal. You might need to login to another system because the files you want to edit are there, or because the Emacs executable file you want to run is there. @@ -517,7 +519,7 @@ emacs --display=glasperle:0 & @end smallexample - You can inhibit the direct use of X with the @samp{-nw} option. This + You can inhibit the direct use of the GUI with the @samp{-nw} option. This is also an initial option. It tells Emacs to display using ordinary ASCII on its controlling terminal. @@ -541,14 +543,13 @@ By default, Emacs displays text in the font named @samp{9x15}, which makes each character nine pixels wide and fifteen pixels high. You can specify a different font on your command line through the option -@samp{-fn @var{name}}. +@samp{-fn @var{name}} (or @samp{--font}, which is an alias for +@samp{-fn}). @table @samp @item -fn @var{name} +@itemx --font=@var{name} Use font @var{name} as the default font. - -@item --font=@var{name} -@samp{--font} is an alias for @samp{-fn}. @end table Under X, each font has a long name which consists of eleven words or @@ -605,7 +606,7 @@ This is the horizontal resolution, in pixels per inch, of the screen for which the font is intended. @item vert -This is the vertical resolution, in dots per inch, of the screen for +This is the vertical resolution, in pixels per inch, of the screen for which the font is intended. Normally the resolution of the fonts on your system is the right value for your screen; therefore, you normally specify @samp{*} for this and @var{horiz}. @@ -668,7 +669,9 @@ @table @samp @item -fg @var{color} @itemx --foreground-color=@var{color} -Specify the foreground color. +Specify the foreground color. @var{color} should be a standard color +name or a numeric specification of the color's red, green, and blue +components as in @samp{#4682B4} or @samp{RGB:46/82/B4}. @item -bg @var{color} @itemx --background-color=@var{color} Specify the background color. @@ -728,13 +731,16 @@ Emacs uses the same units as @code{xterm} does to interpret the geometry. The @var{width} and @var{height} are measured in characters, so a large font -creates a larger frame than a small font. The @var{xoffset} and -@var{yoffset} are measured in pixels. +creates a larger frame than a small font. The @var{xoffset} +and @var{yoffset} are measured in pixels. Since the mode line and the echo area occupy the last 2 lines of the frame, the height of the initial text window is 2 less than the height specified in your geometry. In non-X-toolkit versions of Emacs, -the menu bar also takes one line of the specified number. +the menu bar also takes one line of the specified number. The tool bar, +if present, is excluded from the height of the initial text window; +Emacs will enlarge the frame's height as needed to accomodate for the +tool bar. You do not have to specify all of the fields in the geometry specification. @@ -776,11 +782,11 @@ @table @samp @item -ib @var{width} @itemx --internal-border=@var{width} -Specify @var{width} as the width of the internal border. +Specify @var{width} as the width of the internal border in pixels. @item -bw @var{width} @itemx --border-width=@var{width} -Specify @var{width} as the width of the main border. +Specify @var{width} as the width of the main border in pixels. @end table When you specify the size of the frame, that does not count the @@ -842,7 +848,7 @@ The @samp{-iconic} option tells Emacs to begin running as an icon, rather than opening a frame right away. In this situation, the icon -window provides only indication that Emacs has started; the usual text +window provides only an indication that Emacs has started; the usual text frame doesn't appear until you deiconify it. @node Resources X @@ -933,7 +939,7 @@ use with the command line option @samp{-xrm @var{resources}}. The text @var{resources} should have the same format that you would use inside a file of X resources. To include multiple resource specifications in -@var{data}, put a newline between them, just as you would in a file. +@var{resources}, put a newline between them, just as you would in a file. You can also use @samp{#include "@var{filename}"} to include a file full of resource specifications. Resource values specified with @samp{-xrm} take precedence over all other resource specifications. @@ -1137,8 +1143,8 @@ Each individual string in the menu bar is a subwidget; the subwidget's name is the same as the menu item string. For example, the word -@samp{Files} in the menu bar is part of a subwidget named -@samp{emacs.pane.menubar.Files}. Most likely, you want to specify the +@samp{File} in the menu bar is part of a subwidget named +@samp{emacs.pane.menubar.File}. Most likely, you want to specify the same resources for the whole menu bar. To do this, use @samp{*} instead of a specific subwidget name. For example, to specify the font @samp{8x16} for the menu-bar items, write this: @@ -1151,25 +1157,26 @@ This also specifies the resource value for submenus. Each item in a submenu in the menu bar also has its own name for X -resources; for example, the @samp{Files} submenu has an item named -@samp{Save Buffer}. A resource specification for a submenu item looks -like this: +resources; for example, the @samp{File} submenu has an item named +@samp{Save (current buffer)}. A resource specification for a submenu +item looks like this: @smallexample Emacs.pane.menubar.popup_*.@var{menu}.@var{item}.@var{resource}: @var{value} @end smallexample @noindent -For example, here's how to specify the font for the @samp{Save Buffer} -item: +For example, here's how to specify the font for the @samp{Save (current +buffer)} item: @smallexample -Emacs.pane.menubar.popup_*.Files.Save Buffer.fontList: 8x16 +Emacs.pane.menubar.popup_*.File.Save (current buffer).fontList: 8x16 @end smallexample @noindent -For an item in a second-level submenu, such as @samp{Check Message} -under @samp{Spell} under @samp{Edit}, the resource fits this template: +For an item in a second-level submenu, such as @samp{Spell-Check Message} +under @samp{Spell Checking} under @samp{Tools}, the resource fits this +template: @smallexample Emacs.pane.menubar.popup_*.popup_*.@var{menu}.@var{resource}: @var{value} @@ -1179,7 +1186,7 @@ For example, @smallexample -Emacs.pane.menubar.popup_*.popup_*.Spell.Check Message: @var{value} +Emacs.pane.menubar.popup_*.popup_*.Spell Checking.Spell-Check Message: @var{value} @end smallexample It's impossible to specify a resource for all the menu-bar items