Commit ae742cb5 authored by Chong Yidong's avatar Chong Yidong
Browse files

Text-fitting fixes for printed Emacs manual on 7x9 paper.

* building.texi (Flymake, Breakpoints Buffer):
* calendar.texi (Appointments):
* cmdargs.texi (General Variables, Display X):
* custom.texi (Saving Customizations, Face Customization)
(Directory Variables, Minibuffer Maps, Init Rebinding):
* display.texi (Font Lock, Font Lock, Useless Whitespace):
* fixit.texi (Spelling):
* frames.texi (Creating Frames, Fonts):
* help.texi (Help Files):
* mini.texi (Minibuffer File):
* misc.texi (emacsclient Options, Emulation):
* msdog.texi (Windows Startup, Windows HOME, Windows Fonts):
* mule.texi (International Chars, Language Environments)
(Select Input Method, Modifying Fontsets, Charsets):
* programs.texi (Custom C Indent):
* rmail.texi (Rmail Labels):
* text.texi (Table Conversion):
* trouble.texi (Known Problems, Known Problems):
* windows.texi (Change Window):
* xresources.texi (GTK resources): Reflow text and re-indent code
examples to avoid TeX overflows and underflows on 7x9 paper.

* emacs.texi: Fix the (commented out) smallbook command.

* macos.texi (Mac / GNUstep Events):
* xresources.texi (Lucid Resources): Remove extraneous examples.
parent ce1539b4
2011-05-15 Chong Yidong <cyd@stupidchicken.com>
Fixes for fitting text into 7x9 printed manual.
* building.texi (Flymake, Breakpoints Buffer):
* calendar.texi (Appointments):
* cmdargs.texi (General Variables, Display X):
* custom.texi (Saving Customizations, Face Customization)
(Directory Variables, Minibuffer Maps, Init Rebinding):
* display.texi (Font Lock, Font Lock, Useless Whitespace):
* fixit.texi (Spelling):
* frames.texi (Creating Frames, Fonts):
* help.texi (Help Files):
* mini.texi (Minibuffer File):
* misc.texi (emacsclient Options, Emulation):
* msdog.texi (Windows Startup, Windows HOME, Windows Fonts):
* mule.texi (International Chars, Language Environments)
(Select Input Method, Modifying Fontsets, Charsets):
* programs.texi (Custom C Indent):
* rmail.texi (Rmail Labels):
* text.texi (Table Conversion):
* trouble.texi (Known Problems, Known Problems):
* windows.texi (Change Window):
* xresources.texi (GTK resources): Reflow text and re-indent code
examples to avoid TeX overflows and underflows on 7x9 paper.
* emacs.texi: Fix the (commented out) smallbook command.
* macos.texi (Mac / GNUstep Events):
* xresources.texi (Lucid Resources): Remove extraneous examples.
2011-04-13 Juanma Barranquero <lekktu@gmail.com> 2011-04-13 Juanma Barranquero <lekktu@gmail.com>
* mini.texi (Minibuffer Edit): * mini.texi (Minibuffer Edit):
......
...@@ -439,8 +439,8 @@ syntax checking tool used depends on the language; for example, for ...@@ -439,8 +439,8 @@ syntax checking tool used depends on the language; for example, for
C/C++ files this is usually the C compiler. Flymake can also use C/C++ files this is usually the C compiler. Flymake can also use
build tools such as @code{make} for checking complicated projects. build tools such as @code{make} for checking complicated projects.
To activate Flymake mode, type @kbd{M-x flymake-mode}. You can move To enable Flymake mode, type @kbd{M-x flymake-mode}. You can go to
to the errors spotted by Flymake mode with @kbd{M-x the errors found by Flymake mode with @kbd{M-x
flymake-goto-next-error} and @kbd{M-x flymake-goto-prev-error}. To flymake-goto-next-error} and @kbd{M-x flymake-goto-prev-error}. To
display any error messages associated with the current line, use display any error messages associated with the current line, use
@kbd{M-x flymake-display-err-menu-for-current-line}. @kbd{M-x flymake-display-err-menu-for-current-line}.
...@@ -992,7 +992,7 @@ breakpoint}, the breakpoint which point is on. ...@@ -992,7 +992,7 @@ breakpoint}, the breakpoint which point is on.
@item @key{SPC} @item @key{SPC}
@kindex SPC @r{(GDB breakpoints buffer)} @kindex SPC @r{(GDB breakpoints buffer)}
@findex gdb-toggle-breakpoint @findex gdb-toggle-breakpoint
Enable/disable the current breakpoint (@code{gdb-toggle-breakpoint}). Enable/disable current breakpoint (@code{gdb-toggle-breakpoint}).
On a graphical display, this changes the color of a bullet in the On a graphical display, this changes the color of a bullet in the
margin of a source buffer at the relevant line. This is red when margin of a source buffer at the relevant line. This is red when
the breakpoint is enabled and grey when it is disabled. Text-only the breakpoint is enabled and grey when it is disabled. Text-only
......
...@@ -1474,12 +1474,12 @@ give the names of functions used to create and destroy the window, ...@@ -1474,12 +1474,12 @@ give the names of functions used to create and destroy the window,
respectively. respectively.
@findex appt-activate @findex appt-activate
To enable appointment notification, use the command @kbd{M-x To enable appointment notification, type @kbd{M-x appt-activate}.
appt-activate}. With a positive argument, it enables notification; With a positive argument, it enables notification; with a negative
with a negative argument, it disables notification; with no argument, argument, it disables notification; with no argument, it toggles.
it toggles. Enabling notification also sets up an appointment list Enabling notification also sets up an appointment list for today from
for today from the diary file, giving all diary entries found with the diary file, giving all diary entries found with recognizable times
recognizable times of day, and reminds you just before each of them. of day, and reminds you just before each of them.
For example, suppose the diary file contains these lines: For example, suppose the diary file contains these lines:
......
...@@ -465,9 +465,8 @@ when you specify a relative directory name. ...@@ -465,9 +465,8 @@ when you specify a relative directory name.
Directory for the architecture-independent files that come with Emacs. Directory for the architecture-independent files that come with Emacs.
This is used to initialize the Lisp variable @code{data-directory}. This is used to initialize the Lisp variable @code{data-directory}.
@item EMACSDOC @item EMACSDOC
Directory for the documentation string file, Directory for the documentation string file, which is used to
@file{DOC-@var{emacsversion}}. This is used to initialize the Lisp initialize the Lisp variable @code{doc-directory}.
variable @code{doc-directory}.
@item EMACSLOADPATH @item EMACSLOADPATH
A colon-separated list of directories@footnote{ A colon-separated list of directories@footnote{
Here and below, whenever we say ``colon-separated list of directories,'' Here and below, whenever we say ``colon-separated list of directories,''
...@@ -713,14 +712,14 @@ window displayed at their local terminal. You might need to log in ...@@ -713,14 +712,14 @@ window displayed at their local terminal. You might need to log in
to another system because the files you want to edit are there, or to another system because the files you want to edit are there, or
because the Emacs executable file you want to run is there. because the Emacs executable file you want to run is there.
The syntax of the @env{DISPLAY} environment variable is @env{DISPLAY} has the syntax
@samp{@var{host}:@var{display}.@var{screen}}, where @var{host} is the @samp{@var{host}:@var{display}.@var{screen}}, where @var{host} is the
host name of the X Window System server machine, @var{display} is an host name of the X Window System server machine, @var{display} is an
arbitrarily-assigned number that distinguishes your server (X terminal) arbitrarily-assigned number that distinguishes your server (X
from other servers on the same machine, and @var{screen} is a terminal) from other servers on the same machine, and @var{screen} is
rarely-used field that allows an X server to control multiple terminal a rarely-used field that allows an X server to control multiple
screens. The period and the @var{screen} field are optional. If terminal screens. The period and the @var{screen} field are optional.
included, @var{screen} is usually zero. If included, @var{screen} is usually zero.
For example, if your host is named @samp{glasperle} and your server is For example, if your host is named @samp{glasperle} and your server is
the first (or perhaps the only) server listed in the configuration, your the first (or perhaps the only) server listed in the configuration, your
......
...@@ -527,7 +527,8 @@ files for different Emacs versions, like this: ...@@ -527,7 +527,8 @@ files for different Emacs versions, like this:
(cond ((< emacs-major-version 22) (cond ((< emacs-major-version 22)
;; @r{Emacs 21 customization.} ;; @r{Emacs 21 customization.}
(setq custom-file "~/.custom-21.el")) (setq custom-file "~/.custom-21.el"))
((and (= emacs-major-version 22) (< emacs-minor-version 3)) ((and (= emacs-major-version 22)
(< emacs-minor-version 3))
;; @r{Emacs 22 customization, before version 22.3.} ;; @r{Emacs 22 customization, before version 22.3.}
(setq custom-file "~/.custom-22.el")) (setq custom-file "~/.custom-22.el"))
(t (t
...@@ -583,15 +584,15 @@ means that it's disabled. You can enable or disable the attribute by ...@@ -583,15 +584,15 @@ means that it's disabled. You can enable or disable the attribute by
clicking that button. When the attribute is enabled, you can change clicking that button. When the attribute is enabled, you can change
the attribute value in the usual ways. the attribute value in the usual ways.
For the colors, you can specify a color name (use @kbd{M-x You can specify a color name (use @kbd{M-x list-colors-display} for
list-colors-display} for a list of them) or a hexadecimal color a list of them) or a hexadecimal color specification of the form
specification of the form @samp{#@var{rr}@var{gg}@var{bb}}. @samp{#@var{rr}@var{gg}@var{bb}}. (@samp{#000000} is black,
(@samp{#000000} is black, @samp{#ff0000} is red, @samp{#00ff00} is @samp{#ff0000} is red, @samp{#00ff00} is green, @samp{#0000ff} is
green, @samp{#0000ff} is blue, and @samp{#ffffff} is white.) On a blue, and @samp{#ffffff} is white.) On a black-and-white display, the
black-and-white display, the colors you can use for the background are colors you can use for the background are @samp{black}, @samp{white},
@samp{black}, @samp{white}, @samp{gray}, @samp{gray1}, and @samp{gray}, @samp{gray1}, and @samp{gray3}. Emacs supports these
@samp{gray3}. Emacs supports these shades of gray by using background shades of gray by using background stipple patterns instead of a
stipple patterns instead of a color. color.
Setting, saving and resetting a face work like the same operations for Setting, saving and resetting a face work like the same operations for
variables (@pxref{Changing a Variable}). variables (@pxref{Changing a Variable}).
...@@ -1334,7 +1335,8 @@ corresponding alist applies to all the files in that subdirectory. ...@@ -1334,7 +1335,8 @@ corresponding alist applies to all the files in that subdirectory.
(c-mode . ((c-file-style . "BSD"))) (c-mode . ((c-file-style . "BSD")))
(java-mode . ((c-file-style . "BSD"))) (java-mode . ((c-file-style . "BSD")))
("src/imported" ("src/imported"
. ((nil . ((change-log-default-name . "ChangeLog.local")))))) . ((nil . ((change-log-default-name .
"ChangeLog.local"))))))
@end example @end example
@noindent @noindent
...@@ -1561,7 +1563,7 @@ just like @key{RET}. ...@@ -1561,7 +1563,7 @@ just like @key{RET}.
@code{minibuffer-local-must-match-map} is for strict completion and @code{minibuffer-local-must-match-map} is for strict completion and
for cautious completion. for cautious completion.
@item @item
Finally, @code{minibuffer-local-filename-completion-map} and @code{minibuffer-local-filename-completion-map} and
@code{minibuffer-local-must-match-filename-map} are like the two @code{minibuffer-local-must-match-filename-map} are like the two
previous ones, but they are specifically for file name completion. previous ones, but they are specifically for file name completion.
They do not bind @key{SPC}. They do not bind @key{SPC}.
...@@ -1692,7 +1694,6 @@ and mouse events: ...@@ -1692,7 +1694,6 @@ and mouse events:
(global-set-key (kbd "C-<f5>") 'linum-mode) (global-set-key (kbd "C-<f5>") 'linum-mode)
(global-set-key (kbd "C-<right>") 'forward-sentence) (global-set-key (kbd "C-<right>") 'forward-sentence)
(global-set-key (kbd "<mouse-2>") 'mouse-save-then-kill) (global-set-key (kbd "<mouse-2>") 'mouse-save-then-kill)
(global-set-key (kbd "C-<down-mouse-3>") 'mouse-yank-at-click)
@end example @end example
Instead of using the @code{kbd} macro, you can use a Lisp string or Instead of using the @code{kbd} macro, you can use a Lisp string or
...@@ -1756,8 +1757,10 @@ and @kbd{C-c p} in Texinfo mode: ...@@ -1756,8 +1757,10 @@ and @kbd{C-c p} in Texinfo mode:
@example @example
(add-hook 'texinfo-mode-hook (add-hook 'texinfo-mode-hook
'(lambda () '(lambda ()
(define-key texinfo-mode-map "\C-cp" 'backward-paragraph) (define-key texinfo-mode-map "\C-cp"
(define-key texinfo-mode-map "\C-cn" 'forward-paragraph))) 'backward-paragraph)
(define-key texinfo-mode-map "\C-cn"
'forward-paragraph)))
@end example @end example
@node Modifier Keys @node Modifier Keys
......
...@@ -647,17 +647,17 @@ that follows an open-parenthesis or open-brace in the leftmost column ...@@ -647,17 +647,17 @@ that follows an open-parenthesis or open-brace in the leftmost column
that is inside a string or comment. that is inside a string or comment.
@cindex slow display during scrolling @cindex slow display during scrolling
The variable @code{font-lock-beginning-of-syntax-function} (always The variable @code{font-lock-beginning-of-syntax-function}, which is
buffer-local) specifies how Font Lock mode can find a position always buffer-local, specifies how Font Lock mode can find a position
guaranteed to be outside any comment or string. In modes which use the guaranteed to be outside any comment or string. In modes which use
leftmost column parenthesis convention, the default value of the variable the leftmost column parenthesis convention, the default value of the
is @code{beginning-of-defun}---that tells Font Lock mode to use the variable is @code{beginning-of-defun}---that tells Font Lock mode to
convention. If you set this variable to @code{nil}, Font Lock no longer use the convention. If you set this variable to @code{nil}, Font Lock
relies on the convention. This avoids incorrect results, but the price no longer relies on the convention. This avoids incorrect results,
is that, in some cases, fontification for a changed text must rescan but the price is that, in some cases, fontification for a changed text
buffer text from the beginning of the buffer. This can considerably must rescan buffer text from the beginning of the buffer. This can
slow down redisplay while scrolling, particularly if you are close to considerably slow down redisplay while scrolling, particularly if you
the end of a large buffer. are close to the end of a large buffer.
@findex font-lock-add-keywords @findex font-lock-add-keywords
Font Lock highlighting patterns already exist for many modes, but you Font Lock highlighting patterns already exist for many modes, but you
...@@ -670,7 +670,8 @@ comments, use this: ...@@ -670,7 +670,8 @@ comments, use this:
(add-hook 'c-mode-hook (add-hook 'c-mode-hook
(lambda () (lambda ()
(font-lock-add-keywords nil (font-lock-add-keywords nil
'(("\\<\\(FIXME\\):" 1 font-lock-warning-face t))))) '(("\\<\\(FIXME\\):" 1
font-lock-warning-face t)))))
@end example @end example
@findex font-lock-remove-keywords @findex font-lock-remove-keywords
...@@ -874,9 +875,9 @@ the location of point is enough to show you that the spaces are ...@@ -874,9 +875,9 @@ the location of point is enough to show you that the spaces are
present. present.
@findex delete-trailing-whitespace @findex delete-trailing-whitespace
To delete all trailing whitespace within the buffer's accessible Type @kbd{M-x delete-trailing-whitespace @key{RET}} to delete all
portion (@pxref{Narrowing}), type @kbd{M-x delete-trailing-whitespace trailing whitespace within the buffer's accessible portion
@key{RET}}. This command does not remove newline characters. (@pxref{Narrowing}). This command does not remove newline characters.
@vindex indicate-empty-lines @vindex indicate-empty-lines
@cindex unused lines @cindex unused lines
......
...@@ -39,7 +39,7 @@ developing GNU and promoting software freedom.'' ...@@ -39,7 +39,7 @@ developing GNU and promoting software freedom.''
@c in general, keep the following line commented out, unless doing a @c in general, keep the following line commented out, unless doing a
@c copy of this manual that will be published. The manual should go @c copy of this manual that will be published. The manual should go
@c onto the distribution in the full, 8.5 x 11" size. @c onto the distribution in the full, 8.5 x 11" size.
@c set smallbook @c @smallbook
@ifset smallbook @ifset smallbook
@smallbook @smallbook
......
...@@ -347,8 +347,7 @@ Quit interactive spell checking and move point back to where it was ...@@ -347,8 +347,7 @@ Quit interactive spell checking and move point back to where it was
when you started spell checking. when you started spell checking.
@item q @item q
Quit interactive spell checking and kill the Aspell/Ispell/Hunspell Quit interactive spell checking and kill the spell-checker subprocess.
subprocess.
@item ? @item ?
Show the list of options. Show the list of options.
......
...@@ -586,7 +586,8 @@ the default foreground color and font: ...@@ -586,7 +586,8 @@ the default foreground color and font:
@example @example
(add-to-list 'default-frame-alist '(font . "10x20")) (add-to-list 'default-frame-alist '(font . "10x20"))
(add-to-list 'default-frame-alist '(foreground-color . "blue")) (add-to-list 'default-frame-alist
'(foreground-color . "blue"))
@end example @end example
@noindent @noindent
...@@ -753,12 +754,9 @@ DejaVu Sans Mono:bold:italic ...@@ -753,12 +754,9 @@ DejaVu Sans Mono:bold:italic
Monospace-12:weight=bold:slant=italic Monospace-12:weight=bold:slant=italic
@end smallexample @end smallexample
See the Fontconfig manual for a more detailed description of For a more detailed description of Fontconfig patterns, see the
Fontconfig patterns. This manual is located in the file Fontconfig manual, which is distributed with Fontconfig and available
@file{fontconfig-user.html}, distributed with Fontconfig. It is also online at @url{http://fontconfig.org/fontconfig-user.html}.
available online at @url{http://fontconfig.org/fontconfig-user.html}.
In particular, that manual describes additional font properties that
influence how the font is hinted, antialiased, or scaled.
The second way to specify a font is to use a @dfn{GTK font The second way to specify a font is to use a @dfn{GTK font
description}. These have the syntax description}. These have the syntax
...@@ -831,9 +829,9 @@ The font slant---normally @samp{r} (roman), @samp{i} (italic), ...@@ -831,9 +829,9 @@ The font slant---normally @samp{r} (roman), @samp{i} (italic),
@samp{o} (oblique), @samp{ri} (reverse italic), or @samp{ot} (other). @samp{o} (oblique), @samp{ri} (reverse italic), or @samp{ot} (other).
Some font names support other values. Some font names support other values.
@item widthtype @item widthtype
The font width---normally @samp{condensed}, @samp{extended}, The font width---normally @samp{normal}, @samp{condensed},
@samp{semicondensed} or @samp{normal} (some font names support other @samp{extended}, or @samp{semicondensed} (some font names support
values). other values).
@item style @item style
An optional additional style name. Usually it is empty---most long An optional additional style name. Usually it is empty---most long
font names have two hyphens in a row at this point. font names have two hyphens in a row at this point.
......
...@@ -630,7 +630,7 @@ C-@var{char}}; that is, @kbd{C-h} followed by a control character. ...@@ -630,7 +630,7 @@ C-@var{char}}; that is, @kbd{C-h} followed by a control character.
Display the Emacs copying conditions (@code{describe-copying}). Display the Emacs copying conditions (@code{describe-copying}).
These are the rules under which you can copy and redistribute Emacs. These are the rules under which you can copy and redistribute Emacs.
@item C-h C-d @item C-h C-d
Display how to debug Emacs problems (@code{view-emacs-debugging}). Display help for debugging Emacs (@code{view-emacs-debugging}).
@item C-h C-f @item C-h C-f
Display the Emacs frequently-answered-questions list (@code{view-emacs-FAQ}). Display the Emacs frequently-answered-questions list (@code{view-emacs-FAQ}).
@item C-h g @item C-h g
......
...@@ -162,10 +162,6 @@ This event occurs when another application requests that Emacs open a ...@@ -162,10 +162,6 @@ This event occurs when another application requests that Emacs open a
temporary file. By default, this is handled by just generating a temporary file. By default, this is handled by just generating a
@code{ns-open-file} event, the results of which are described above. @code{ns-open-file} event, the results of which are described above.
You can bind @key{ns-pop-up-frames} and @key{ns-open-temp-file} to
other Lisp functions. When the event is registered, the name of the
file to open is stored in the variable @code{ns-input-file}.
@item ns-open-file-line @item ns-open-file-line
Some applications, such as ProjectBuilder and gdb, request not only a Some applications, such as ProjectBuilder and gdb, request not only a
particular file, but also a particular line or sequence of lines in particular file, but also a particular line or sequence of lines in
......
...@@ -69,10 +69,10 @@ the default directory. If you now type @kbd{buffer.c} as input, that ...@@ -69,10 +69,10 @@ the default directory. If you now type @kbd{buffer.c} as input, that
specifies the file @file{/u2/emacs/src/buffer.c}. @xref{File Names}, specifies the file @file{/u2/emacs/src/buffer.c}. @xref{File Names},
for information about the default directory. for information about the default directory.
You can specify the parent directory by adding @file{..}: for You can specify the parent directory with @file{..}:
example, @file{/u2/emacs/src/../lisp/simple.el} is equivalent to @file{/a/b/../foo.el} is equivalent to @file{/a/foo.el}.
@file{/u2/emacs/lisp/simple.el}. Alternatively, you can use Alternatively, you can use @kbd{M-@key{DEL}} to kill directory names
@kbd{M-@key{DEL}} to kill directory names backwards (@pxref{Words}). backwards (@pxref{Words}).
To specify a file in a completely different directory, you can kill To specify a file in a completely different directory, you can kill
the entire default with @kbd{C-a C-k} (@pxref{Minibuffer Edit}). the entire default with @kbd{C-a C-k} (@pxref{Minibuffer Edit}).
......
...@@ -1585,16 +1585,8 @@ listed below: ...@@ -1585,16 +1585,8 @@ listed below:
@item -a @var{command} @item -a @var{command}
@itemx --alternate-editor=@var{command} @itemx --alternate-editor=@var{command}
Specify a command to run if @code{emacsclient} fails to contact Emacs. Specify a command to run if @code{emacsclient} fails to contact Emacs.
This is useful when running @code{emacsclient} in a script. For This is useful when running @code{emacsclient} in a script.
example, the following setting for the @env{EDITOR} environment
variable will always give you an editor, even if no Emacs server is
running:
@example
EDITOR="emacsclient --alternate-editor emacs +%d %s"
@end example
@noindent
As a special exception, if @var{command} is the empty string, then As a special exception, if @var{command} is the empty string, then
@code{emacsclient} starts Emacs in daemon mode and then tries @code{emacsclient} starts Emacs in daemon mode and then tries
connecting again. connecting again.
...@@ -2490,9 +2482,8 @@ also use the command @kbd{M-x scroll-all-mode} or set the variable ...@@ -2490,9 +2482,8 @@ also use the command @kbd{M-x scroll-all-mode} or set the variable
@item EDT (DEC VMS editor) @item EDT (DEC VMS editor)
@findex edt-emulation-on @findex edt-emulation-on
@findex edt-emulation-off @findex edt-emulation-off
Turn on EDT emulation with the command @kbd{M-x edt-emulation-on}, Turn on EDT emulation @kbd{M-x edt-emulation-on}; use @kbd{M-x
while @kbd{M-x edt-emulation-off} restores normal Emacs command edt-emulation-off} to restore normal Emacs command bindings.
bindings.
Most of the EDT emulation commands are keypad keys, and most standard Most of the EDT emulation commands are keypad keys, and most standard
Emacs key bindings are still available. The EDT emulation rebindings Emacs key bindings are still available. The EDT emulation rebindings
......
...@@ -85,30 +85,29 @@ Emacs will start in the current directory of the Windows shell. ...@@ -85,30 +85,29 @@ Emacs will start in the current directory of the Windows shell.
@cindex invoking Emacs from Windows Explorer @cindex invoking Emacs from Windows Explorer
@pindex emacsclient.exe @pindex emacsclient.exe
@pindex emacsclientw.exe @pindex emacsclientw.exe
Via the Emacs client program, @file{emacsclient.exe} or Via @file{emacsclient.exe} or @file{emacsclientw.exe}, which allow you
@file{emacsclientw.exe}. This allows to invoke Emacs from other to invoke Emacs from other programs, and to reuse a running Emacs
programs, and to reuse a running Emacs process for serving editing process for serving editing jobs required by other programs.
jobs required by other programs. @xref{Emacs Server}. The difference @xref{Emacs Server}. The difference between @file{emacsclient.exe}
between @file{emacsclient.exe} and @file{emacsclientw.exe} is that the and @file{emacsclientw.exe} is that the former is a console program,
former is a console program, while the latter is a Windows GUI while the latter is a Windows GUI program. Both programs wait for
program. Both programs wait for Emacs to signal that the editing job Emacs to signal that the editing job is finished, before they exit and
is finished, before they exit and return control to the program that return control to the program that invoked them. Which one of them to
invoked them. Which one of them to use in each case depends on the use in each case depends on the expectations of the program that needs
expectations of the program that needs editing services. If that editing services. If that program is itself a console (text-mode)
program is itself a console (text-mode) program, you should use program, you should use @file{emacsclient.exe}, so that any of its
@file{emacsclient.exe}, so that any of its messages and prompts appear messages and prompts appear in the same command window as those of the
in the same command window as those of the invoking program. By invoking program. By contrast, if the invoking program is a GUI
contrast, if the invoking program is a GUI program, you will be better program, you will be better off using @file{emacsclientw.exe}, because
off using @file{emacsclientw.exe}, because @file{emacsclient.exe} will @file{emacsclient.exe} will pop up a command window if it is invoked
pop up a command window if it is invoked from a GUI program. A from a GUI program. A notable situation where you would want
notable situation where you would want @file{emacsclientw.exe} is when @file{emacsclientw.exe} is when you right-click on a file in the
you right-click on a file in the Windows Explorer and select ``Open Windows Explorer and select ``Open With'' from the pop-up menu. Use
With'' from the pop-up menu. Use the @samp{--alternate-editor=} or the @samp{--alternate-editor=} or @samp{-a} options if Emacs might not
@samp{-a} options if Emacs might not be running (or not running as a be running (or not running as a server) when @command{emacsclient} is
server) when @command{emacsclient} is invoked---that will always give invoked---that will always give you an editor. When invoked via
you an editor. When invoked via @command{emacsclient}, Emacs will @command{emacsclient}, Emacs will start in the current directory of
start in the current directory of the program that invoked the program that invoked @command{emacsclient}.
@command{emacsclient}.
@end enumerate @end enumerate
@node Text and Binary @node Text and Binary
...@@ -402,11 +401,11 @@ names, which might cause misalignment of columns in Dired display. ...@@ -402,11 +401,11 @@ names, which might cause misalignment of columns in Dired display.
The Windows equivalent of the @code{HOME} directory is the The Windows equivalent of the @code{HOME} directory is the
@dfn{user-specific application data directory}. The actual location @dfn{user-specific application data directory}. The actual location
depends on your Windows version and system configuration; typical values depends on the Windows version; typical values are @file{C:\Documents
are @file{C:\Documents and Settings\@var{username}\Application Data} on and Settings\@var{username}\Application Data} on Windows 2K/XP/2K3,
Windows 2K/XP/2K3, @file{C:\Users\@var{username}\AppData\Roaming} on @file{C:\Users\@var{username}\AppData\Roaming} on Windows Vista/7/2K8,
Windows Vista/7/2K8, and either @file{C:\WINDOWS\Application Data} and either @file{C:\WINDOWS\Application Data} or
or @file{C:\WINDOWS\Profiles\@var{username}\Application Data} on the @file{C:\WINDOWS\Profiles\@var{username}\Application Data} on the
older Windows 9X/ME systems. If this directory does not exist or older Windows 9X/ME systems. If this directory does not exist or
cannot be accessed, Emacs falls back to @file{C:\} as the default cannot be accessed, Emacs falls back to @file{C:\} as the default
value of @code{HOME}. value of @code{HOME}.
...@@ -955,11 +954,12 @@ The following scripts are recognized on Windows: @code{latin}, @code{greek}, ...@@ -955,11 +954,12 @@ The following scripts are recognized on Windows: @code{latin}, @code{greek},
@cindex font antialiasing (MS Windows) @cindex font antialiasing (MS Windows)
@item antialias @item antialias
Specifies the antialiasing to use for the font. The value @code{none} Specifies the antialiasing method. The value @code{none} means no
means no antialiasing, @code{standard} means use standard antialiasing, antialiasing, @code{standard} means use standard antialiasing,
@code{subpixel} means use subpixel antialiasing (known as Cleartype on Windows), @code{subpixel} means use subpixel antialiasing (known as Cleartype on
and @code{natural} means use subpixel antialiasing with adjusted spacing between Windows), and @code{natural} means use subpixel antialiasing with
letters. If unspecified, the font will use the system default antialiasing. adjusted spacing between letters. If unspecified, the font will use
the system default antialiasing.
@end table @end table
@node Windows Misc @node Windows Misc
......
...@@ -226,7 +226,8 @@ preferred charset: unicode (Unicode (ISO10646)) ...@@ -226,7 +226,8 @@ preferred charset: unicode (Unicode (ISO10646))
buffer code: #xC3 #x80 buffer code: #xC3 #x80
file code: not encodable by coding system undecided-unix file code: not encodable by coding system undecided-unix
display: by this font (glyph code) display: by this font (glyph code)
xft:-unknown-DejaVu Sans Mono-normal-normal-normal-*-13-*-*-*-m-0-iso10646-1 (#x82) xft:-unknown-DejaVu Sans Mono-normal-normal-
normal-*-13-*-*-*-m-0-iso10646-1 (#x82)
Character code properties: customize what to show Character code properties: customize what to show
name: LATIN CAPITAL LETTER A WITH GRAVE name: LATIN CAPITAL LETTER A WITH GRAVE
...@@ -316,7 +317,7 @@ language environment also specifies a default input method. ...@@ -316,7 +317,7 @@ language environment also specifies a default input method.
@findex set-language-environment @findex set-language-environment
@vindex current-language-environment @vindex current-language-environment
To select a language environment, customize the variable To select a language environment, customize
@code{current-language-environment} or use the command @kbd{M-x @code{current-language-environment} or use the command @kbd{M-x
set-language-environment}. It makes no difference which buffer is set-language-environment}. It makes no difference which buffer is
current when you use this command, because the effects apply globally current when you use this command, because the effects apply globally
...@@ -641,9 +642,9 @@ shows that information in addition to the other information about the ...@@ -641,9 +642,9 @@ shows that information in addition to the other information about the
character. character.
@findex list-input-methods @findex list-input-methods
To see a list of all the supported input methods, type @kbd{M-x @kbd{M-x list-input-methods} displays a list of all the supported
list-input-methods}. The list gives information about each input input methods. The list gives information about each input method,
method, including the string that stands for it in the mode line. including the string that stands for it in the mode line.
@node Coding Systems @node Coding Systems
@section Coding Systems @section Coding Systems
...@@ -1469,18 +1470,22 @@ examples are: ...@@ -1469,18 +1470,22 @@ examples are:
@example @example
;; Use Liberation Mono for latin-3 charset. ;; Use Liberation Mono for latin-3 charset.
(set-fontset-font "fontset-default" 'iso-8859-3 "Liberation Mono") (set-fontset-font "fontset-default" 'iso-8859-3
"Liberation Mono")
;; Prefer a big5 font for han characters ;; Prefer a big5 font for han characters
(set-fontset-font "fontset-default" 'han (font-spec :registry "big5") (set-fontset-font "fontset-default"
'han (font-spec :registry "big5")
nil 'prepend) nil 'prepend)
;; Use DejaVu Sans Mono as a fallback in fontset-startup before ;; Use DejaVu Sans Mono as a fallback in fontset-startup
;; resorting to fontset-default. ;; before resorting to fontset-default.
(set-fontset-font "fontset-startup" nil "DejaVu Sans Mono" nil 'append) (set-fontset-font "fontset-startup" nil "DejaVu Sans Mono"
nil 'append)