Mercurial > emacs
annotate man/msdog.texi @ 81548:334bfc4cc092
*** empty log message ***
author | Jay Belanger <jay.p.belanger@gmail.com> |
---|---|
date | Fri, 22 Jun 2007 06:10:39 +0000 |
parents | 5bf909478893 |
children | 02b9a9aa5b0c f83d17e1ace6 |
rev | line source |
---|---|
24095 | 1 @c This is part of the Emacs manual. |
64890
3723093a21fd
Update years in copyright notice; nfc.
Thien-Thi Nguyen <ttn@gnuvola.org>
parents:
64742
diff
changeset
|
2 @c Copyright (C) 1985, 1986, 1987, 1993, 1994, 1995, 1997, 2000, 2001, |
75348 | 3 @c 2002, 2003, 2004, 2005, 2006, 2007 Free Software Foundation, Inc. |
24095 | 4 @c See file emacs.texi for copying conditions. |
70435
95f50a235a27
Rename `Emacs and Microsoft Windows' into `Microsoft Windows'.
Eli Zaretskii <eliz@gnu.org>
parents:
70159
diff
changeset
|
5 @node Microsoft Windows, Manifesto, Mac OS, Top |
70443
8e32c8ab08d7
(Microsoft Windows): Rename from "Emacs and Microsoft Windows". All
Eli Zaretskii <eliz@gnu.org>
parents:
70437
diff
changeset
|
6 @appendix Emacs and Microsoft Windows/MS-DOS |
68460
bb56c788af45
(MS-DOS): Rewrite intro to explain how this
Richard M. Stallman <rms@gnu.org>
parents:
64890
diff
changeset
|
7 @cindex Microsoft Windows |
70153
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
8 @cindex MS-Windows, Emacs peculiarities |
68460
bb56c788af45
(MS-DOS): Rewrite intro to explain how this
Richard M. Stallman <rms@gnu.org>
parents:
64890
diff
changeset
|
9 |
69898
601830ae280c
move MS-DOS material to emacs-xtra.texi
Karl Berry <karl@gnu.org>
parents:
68639
diff
changeset
|
10 This section describes peculiarities of using Emacs on Microsoft |
70153
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
11 Windows. Some of these peculiarities are also relevant to Microsoft's |
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
12 older MS-DOS ``operating system'' (also known as ``MS-DOG''). |
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
13 However, Emacs features that are relevant @emph{only} to MS-DOS are |
70443
8e32c8ab08d7
(Microsoft Windows): Rename from "Emacs and Microsoft Windows". All
Eli Zaretskii <eliz@gnu.org>
parents:
70437
diff
changeset
|
14 described in a separate |
8e32c8ab08d7
(Microsoft Windows): Rename from "Emacs and Microsoft Windows". All
Eli Zaretskii <eliz@gnu.org>
parents:
70437
diff
changeset
|
15 @iftex |
70472
8566e3f340ec
msdog.texi (Microsoft Windows):
Eli Zaretskii <eliz@gnu.org>
parents:
70443
diff
changeset
|
16 manual (@pxref{MS-DOS,,, emacs-xtra, Specialized Emacs Features}). |
70443
8e32c8ab08d7
(Microsoft Windows): Rename from "Emacs and Microsoft Windows". All
Eli Zaretskii <eliz@gnu.org>
parents:
70437
diff
changeset
|
17 @end iftex |
8e32c8ab08d7
(Microsoft Windows): Rename from "Emacs and Microsoft Windows". All
Eli Zaretskii <eliz@gnu.org>
parents:
70437
diff
changeset
|
18 @ifnottex |
8e32c8ab08d7
(Microsoft Windows): Rename from "Emacs and Microsoft Windows". All
Eli Zaretskii <eliz@gnu.org>
parents:
70437
diff
changeset
|
19 section (@pxref{MS-DOS}). |
8e32c8ab08d7
(Microsoft Windows): Rename from "Emacs and Microsoft Windows". All
Eli Zaretskii <eliz@gnu.org>
parents:
70437
diff
changeset
|
20 @end ifnottex |
8e32c8ab08d7
(Microsoft Windows): Rename from "Emacs and Microsoft Windows". All
Eli Zaretskii <eliz@gnu.org>
parents:
70437
diff
changeset
|
21 |
24095 | 22 |
70153
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
23 The behavior of Emacs on MS-Windows is reasonably similar to what is |
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
24 documented in the rest of the manual, including support for long file |
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
25 names, multiple frames, scroll bars, mouse menus, and subprocesses. |
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
26 However, a few special considerations apply, and they are described |
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
27 here. |
24095 | 28 |
29 @menu | |
70443
8e32c8ab08d7
(Microsoft Windows): Rename from "Emacs and Microsoft Windows". All
Eli Zaretskii <eliz@gnu.org>
parents:
70437
diff
changeset
|
30 * Text and Binary:: Text files use CRLF to terminate lines. |
8e32c8ab08d7
(Microsoft Windows): Rename from "Emacs and Microsoft Windows". All
Eli Zaretskii <eliz@gnu.org>
parents:
70437
diff
changeset
|
31 * Windows Files:: File-name conventions on Windows. |
71468 | 32 * ls in Lisp:: Emulation of @code{ls} for Dired. |
70443
8e32c8ab08d7
(Microsoft Windows): Rename from "Emacs and Microsoft Windows". All
Eli Zaretskii <eliz@gnu.org>
parents:
70437
diff
changeset
|
33 * Windows HOME:: Where Emacs looks for your @file{.emacs}. |
71470
5785f48e4265
(Windows Keyboard): New section.
Eli Zaretskii <eliz@gnu.org>
parents:
71468
diff
changeset
|
34 * Windows Keyboard:: Windows-specific keyboard features. |
71473
662c32135523
(Windows Mouse): New section.
Eli Zaretskii <eliz@gnu.org>
parents:
71472
diff
changeset
|
35 * Windows Mouse:: Windows-specific mouse features. |
70443
8e32c8ab08d7
(Microsoft Windows): Rename from "Emacs and Microsoft Windows". All
Eli Zaretskii <eliz@gnu.org>
parents:
70437
diff
changeset
|
36 * Windows Processes:: Running subprocesses on Windows. |
8e32c8ab08d7
(Microsoft Windows): Rename from "Emacs and Microsoft Windows". All
Eli Zaretskii <eliz@gnu.org>
parents:
70437
diff
changeset
|
37 * Windows Printing:: How to specify the printer on MS-Windows. |
71473
662c32135523
(Windows Mouse): New section.
Eli Zaretskii <eliz@gnu.org>
parents:
71472
diff
changeset
|
38 * Windows Misc:: Miscellaneous Windows features. |
70443
8e32c8ab08d7
(Microsoft Windows): Rename from "Emacs and Microsoft Windows". All
Eli Zaretskii <eliz@gnu.org>
parents:
70437
diff
changeset
|
39 @ifnottex |
8e32c8ab08d7
(Microsoft Windows): Rename from "Emacs and Microsoft Windows". All
Eli Zaretskii <eliz@gnu.org>
parents:
70437
diff
changeset
|
40 * MS-DOS:: Using Emacs on MS-DOS (otherwise known as @dfn{MS-DOG}). |
8e32c8ab08d7
(Microsoft Windows): Rename from "Emacs and Microsoft Windows". All
Eli Zaretskii <eliz@gnu.org>
parents:
70437
diff
changeset
|
41 @end ifnottex |
24095 | 42 @end menu |
43 | |
44 @node Text and Binary | |
45 @section Text Files and Binary Files | |
46 @cindex text and binary files on MS-DOS/MS-Windows | |
47 | |
48 GNU Emacs uses newline characters to separate text lines. This is the | |
70153
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
49 convention used on GNU, Unix, and other Posix-compliant systems. |
24095 | 50 |
51 @cindex end-of-line conversion on MS-DOS/MS-Windows | |
70153
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
52 By contrast, MS-DOS and MS-Windows normally use carriage-return linefeed, |
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
53 a two-character sequence, to separate text lines. (Linefeed is the same |
24095 | 54 character as newline.) Therefore, convenient editing of typical files |
55 with Emacs requires conversion of these end-of-line (EOL) sequences. | |
56 And that is what Emacs normally does: it converts carriage-return | |
57 linefeed into newline when reading files, and converts newline into | |
58 carriage-return linefeed when writing files. The same mechanism that | |
59 handles conversion of international character codes does this conversion | |
60 also (@pxref{Coding Systems}). | |
61 | |
29853
d49e929bbdf6
(Text and Binary): Separate description of EOL
Eli Zaretskii <eliz@gnu.org>
parents:
29107
diff
changeset
|
62 @cindex cursor location, on MS-DOS |
d49e929bbdf6
(Text and Binary): Separate description of EOL
Eli Zaretskii <eliz@gnu.org>
parents:
29107
diff
changeset
|
63 @cindex point location, on MS-DOS |
24095 | 64 One consequence of this special format-conversion of most files is |
65 that character positions as reported by Emacs (@pxref{Position Info}) do | |
66 not agree with the file size information known to the operating system. | |
67 | |
68 In addition, if Emacs recognizes from a file's contents that it uses | |
69 newline rather than carriage-return linefeed as its line separator, it | |
36169
86e871a073b6
Delete find-file-text and find-file-binary.
Richard M. Stallman <rms@gnu.org>
parents:
35188
diff
changeset
|
70 does not perform EOL conversion when reading or writing that file. |
86e871a073b6
Delete find-file-text and find-file-binary.
Richard M. Stallman <rms@gnu.org>
parents:
35188
diff
changeset
|
71 Thus, you can read and edit files from GNU and Unix systems on MS-DOS |
86e871a073b6
Delete find-file-text and find-file-binary.
Richard M. Stallman <rms@gnu.org>
parents:
35188
diff
changeset
|
72 with no special effort, and they will retain their Unix-style |
86e871a073b6
Delete find-file-text and find-file-binary.
Richard M. Stallman <rms@gnu.org>
parents:
35188
diff
changeset
|
73 end-of-line convention after you edit them. |
24095 | 74 |
29853
d49e929bbdf6
(Text and Binary): Separate description of EOL
Eli Zaretskii <eliz@gnu.org>
parents:
29107
diff
changeset
|
75 The mode line indicates whether end-of-line translation was used for |
d49e929bbdf6
(Text and Binary): Separate description of EOL
Eli Zaretskii <eliz@gnu.org>
parents:
29107
diff
changeset
|
76 the current buffer. If MS-DOS end-of-line translation is in use for the |
70153
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
77 buffer, the MS-Windows build of Emacs displays a backslash @samp{\} after |
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
78 the coding system mnemonic near the beginning of the mode line |
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
79 (@pxref{Mode Line}). If no EOL translation was performed, the string |
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
80 @samp{(Unix)} is displayed instead of the backslash, to alert you that the |
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
81 file's EOL format is not the usual carriage-return linefeed. |
24095 | 82 |
29853
d49e929bbdf6
(Text and Binary): Separate description of EOL
Eli Zaretskii <eliz@gnu.org>
parents:
29107
diff
changeset
|
83 @cindex DOS-to-Unix conversion of files |
36169
86e871a073b6
Delete find-file-text and find-file-binary.
Richard M. Stallman <rms@gnu.org>
parents:
35188
diff
changeset
|
84 To visit a file and specify whether it uses DOS-style or Unix-style |
68544
d29761b06e4e
(Text and Binary, MS-DOS and MULE): Fix xrefs.
Richard M. Stallman <rms@gnu.org>
parents:
68460
diff
changeset
|
85 end-of-line, specify a coding system (@pxref{Text Coding}). For |
36169
86e871a073b6
Delete find-file-text and find-file-binary.
Richard M. Stallman <rms@gnu.org>
parents:
35188
diff
changeset
|
86 example, @kbd{C-x @key{RET} c unix @key{RET} C-x C-f foobar.txt} |
86e871a073b6
Delete find-file-text and find-file-binary.
Richard M. Stallman <rms@gnu.org>
parents:
35188
diff
changeset
|
87 visits the file @file{foobar.txt} without converting the EOLs; if some |
86e871a073b6
Delete find-file-text and find-file-binary.
Richard M. Stallman <rms@gnu.org>
parents:
35188
diff
changeset
|
88 line ends with a carriage-return linefeed pair, Emacs will display |
86e871a073b6
Delete find-file-text and find-file-binary.
Richard M. Stallman <rms@gnu.org>
parents:
35188
diff
changeset
|
89 @samp{^M} at the end of that line. Similarly, you can direct Emacs to |
86e871a073b6
Delete find-file-text and find-file-binary.
Richard M. Stallman <rms@gnu.org>
parents:
35188
diff
changeset
|
90 save a buffer in a specified EOL format with the @kbd{C-x @key{RET} f} |
86e871a073b6
Delete find-file-text and find-file-binary.
Richard M. Stallman <rms@gnu.org>
parents:
35188
diff
changeset
|
91 command. For example, to save a buffer with Unix EOL format, type |
86e871a073b6
Delete find-file-text and find-file-binary.
Richard M. Stallman <rms@gnu.org>
parents:
35188
diff
changeset
|
92 @kbd{C-x @key{RET} f unix @key{RET} C-x C-s}. If you visit a file |
86e871a073b6
Delete find-file-text and find-file-binary.
Richard M. Stallman <rms@gnu.org>
parents:
35188
diff
changeset
|
93 with DOS EOL conversion, then save it with Unix EOL format, that |
86e871a073b6
Delete find-file-text and find-file-binary.
Richard M. Stallman <rms@gnu.org>
parents:
35188
diff
changeset
|
94 effectively converts the file to Unix EOL style, like @code{dos2unix}. |
24095 | 95 |
96 @cindex untranslated file system | |
97 @findex add-untranslated-filesystem | |
70153
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
98 When you use NFS, Samba, or some other similar method to access file |
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
99 systems that reside on computers using GNU or Unix systems, Emacs |
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
100 should not perform end-of-line translation on any files in these file |
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
101 systems---not even when you create a new file. To request this, |
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
102 designate these file systems as @dfn{untranslated} file systems by |
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
103 calling the function @code{add-untranslated-filesystem}. It takes one |
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
104 argument: the file system name, including a drive letter and |
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
105 optionally a directory. For example, |
24095 | 106 |
107 @example | |
108 (add-untranslated-filesystem "Z:") | |
109 @end example | |
110 | |
111 @noindent | |
112 designates drive Z as an untranslated file system, and | |
113 | |
114 @example | |
115 (add-untranslated-filesystem "Z:\\foo") | |
116 @end example | |
117 | |
118 @noindent | |
119 designates directory @file{\foo} on drive Z as an untranslated file | |
120 system. | |
121 | |
122 Most often you would use @code{add-untranslated-filesystem} in your | |
70153
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
123 @file{.emacs} file, or in @file{site-start.el} so that all the users at |
24095 | 124 your site get the benefit of it. |
125 | |
126 @findex remove-untranslated-filesystem | |
127 To countermand the effect of @code{add-untranslated-filesystem}, use | |
128 the function @code{remove-untranslated-filesystem}. This function takes | |
129 one argument, which should be a string just like the one that was used | |
130 previously with @code{add-untranslated-filesystem}. | |
131 | |
36169
86e871a073b6
Delete find-file-text and find-file-binary.
Richard M. Stallman <rms@gnu.org>
parents:
35188
diff
changeset
|
132 Designating a file system as untranslated does not affect character |
86e871a073b6
Delete find-file-text and find-file-binary.
Richard M. Stallman <rms@gnu.org>
parents:
35188
diff
changeset
|
133 set conversion, only end-of-line conversion. Essentially, it directs |
86e871a073b6
Delete find-file-text and find-file-binary.
Richard M. Stallman <rms@gnu.org>
parents:
35188
diff
changeset
|
134 Emacs to create new files with the Unix-style convention of using |
86e871a073b6
Delete find-file-text and find-file-binary.
Richard M. Stallman <rms@gnu.org>
parents:
35188
diff
changeset
|
135 newline at the end of a line. @xref{Coding Systems}. |
29853
d49e929bbdf6
(Text and Binary): Separate description of EOL
Eli Zaretskii <eliz@gnu.org>
parents:
29107
diff
changeset
|
136 |
d49e929bbdf6
(Text and Binary): Separate description of EOL
Eli Zaretskii <eliz@gnu.org>
parents:
29107
diff
changeset
|
137 @vindex file-name-buffer-file-type-alist |
d49e929bbdf6
(Text and Binary): Separate description of EOL
Eli Zaretskii <eliz@gnu.org>
parents:
29107
diff
changeset
|
138 @cindex binary files, on MS-DOS/MS-Windows |
d49e929bbdf6
(Text and Binary): Separate description of EOL
Eli Zaretskii <eliz@gnu.org>
parents:
29107
diff
changeset
|
139 Some kinds of files should not be converted at all, because their |
70153
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
140 contents are not really text. Therefore, Emacs on MS-Windows distinguishes |
29853
d49e929bbdf6
(Text and Binary): Separate description of EOL
Eli Zaretskii <eliz@gnu.org>
parents:
29107
diff
changeset
|
141 certain files as @dfn{binary files}. (This distinction is not part of |
70153
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
142 MS-Windows; it is made by Emacs only.) Binary files include executable |
29853
d49e929bbdf6
(Text and Binary): Separate description of EOL
Eli Zaretskii <eliz@gnu.org>
parents:
29107
diff
changeset
|
143 programs, compressed archives, etc. Emacs uses the file name to decide |
d49e929bbdf6
(Text and Binary): Separate description of EOL
Eli Zaretskii <eliz@gnu.org>
parents:
29107
diff
changeset
|
144 whether to treat a file as binary: the variable |
d49e929bbdf6
(Text and Binary): Separate description of EOL
Eli Zaretskii <eliz@gnu.org>
parents:
29107
diff
changeset
|
145 @code{file-name-buffer-file-type-alist} defines the file-name patterns |
d49e929bbdf6
(Text and Binary): Separate description of EOL
Eli Zaretskii <eliz@gnu.org>
parents:
29107
diff
changeset
|
146 that indicate binary files. If a file name matches one of the patterns |
d49e929bbdf6
(Text and Binary): Separate description of EOL
Eli Zaretskii <eliz@gnu.org>
parents:
29107
diff
changeset
|
147 for binary files (those whose associations are of the type |
d49e929bbdf6
(Text and Binary): Separate description of EOL
Eli Zaretskii <eliz@gnu.org>
parents:
29107
diff
changeset
|
148 @code{(@var{pattern} . t)}, Emacs reads and writes that file using the |
d49e929bbdf6
(Text and Binary): Separate description of EOL
Eli Zaretskii <eliz@gnu.org>
parents:
29107
diff
changeset
|
149 @code{no-conversion} coding system (@pxref{Coding Systems}) which turns |
d49e929bbdf6
(Text and Binary): Separate description of EOL
Eli Zaretskii <eliz@gnu.org>
parents:
29107
diff
changeset
|
150 off @emph{all} coding-system conversions, not only the EOL conversion. |
d49e929bbdf6
(Text and Binary): Separate description of EOL
Eli Zaretskii <eliz@gnu.org>
parents:
29107
diff
changeset
|
151 @code{file-name-buffer-file-type-alist} also includes file-name patterns |
70153
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
152 for files which are known to be Windows-style text files with |
29853
d49e929bbdf6
(Text and Binary): Separate description of EOL
Eli Zaretskii <eliz@gnu.org>
parents:
29107
diff
changeset
|
153 carriage-return linefeed EOL format, such as @file{CONFIG.SYS}; Emacs |
70153
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
154 always writes those files with Windows-style EOLs. |
29853
d49e929bbdf6
(Text and Binary): Separate description of EOL
Eli Zaretskii <eliz@gnu.org>
parents:
29107
diff
changeset
|
155 |
d49e929bbdf6
(Text and Binary): Separate description of EOL
Eli Zaretskii <eliz@gnu.org>
parents:
29107
diff
changeset
|
156 If a file which belongs to an untranslated file system matches one of |
d49e929bbdf6
(Text and Binary): Separate description of EOL
Eli Zaretskii <eliz@gnu.org>
parents:
29107
diff
changeset
|
157 the file-name patterns in @code{file-name-buffer-file-type-alist}, the |
d49e929bbdf6
(Text and Binary): Separate description of EOL
Eli Zaretskii <eliz@gnu.org>
parents:
29107
diff
changeset
|
158 EOL conversion is determined by @code{file-name-buffer-file-type-alist}. |
d49e929bbdf6
(Text and Binary): Separate description of EOL
Eli Zaretskii <eliz@gnu.org>
parents:
29107
diff
changeset
|
159 |
70153
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
160 @node Windows Files |
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
161 @section File Names on MS-Windows |
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
162 @cindex file names on MS-Windows |
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
163 |
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
164 MS-Windows and MS-DOS normally use a backslash, @samp{\}, to |
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
165 separate name units within a file name, instead of the slash used on |
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
166 other systems. Emacs on MS-DOS/MS-Windows permits use of either slash or |
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
167 backslash, and also knows about drive letters in file names. |
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
168 |
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
169 @cindex file-name completion, on MS-Windows |
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
170 On MS-DOS/MS-Windows, file names are case-insensitive, so Emacs by |
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
171 default ignores letter-case in file names during completion. |
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
172 |
71473
662c32135523
(Windows Mouse): New section.
Eli Zaretskii <eliz@gnu.org>
parents:
71472
diff
changeset
|
173 @vindex w32-get-true-file-attributes |
662c32135523
(Windows Mouse): New section.
Eli Zaretskii <eliz@gnu.org>
parents:
71472
diff
changeset
|
174 If the variable @code{w32-get-true-file-attributes} is |
662c32135523
(Windows Mouse): New section.
Eli Zaretskii <eliz@gnu.org>
parents:
71472
diff
changeset
|
175 non-@code{nil} (the default), Emacs tries to determine the accurate |
74657
01df1e874f91
(Windows Files): `w32-get-true-file-attributes' is only relevant for NTFS
Eli Zaretskii <eliz@gnu.org>
parents:
74655
diff
changeset
|
176 link counts for files. This option is only useful on NTFS volumes, |
01df1e874f91
(Windows Files): `w32-get-true-file-attributes' is only relevant for NTFS
Eli Zaretskii <eliz@gnu.org>
parents:
74655
diff
changeset
|
177 and it considerably slows down Dired and other features, so use it |
01df1e874f91
(Windows Files): `w32-get-true-file-attributes' is only relevant for NTFS
Eli Zaretskii <eliz@gnu.org>
parents:
74655
diff
changeset
|
178 only on fast machines. |
71473
662c32135523
(Windows Mouse): New section.
Eli Zaretskii <eliz@gnu.org>
parents:
71472
diff
changeset
|
179 |
71468 | 180 @node ls in Lisp |
181 @section Emulation of @code{ls} on MS-Windows | |
182 @cindex Dired, and MS-Windows/MS-DOS | |
183 @cindex @code{ls} emulation | |
184 | |
185 Dired normally uses the external program @code{ls} (or its close | |
186 work-alike) to produce the directory listing displayed in Dired | |
187 buffers (@pxref{Dired}). However, MS-Windows and MS-DOS systems don't | |
188 come with such a program, although several ports of @sc{gnu} @code{ls} | |
189 are available. Therefore, Emacs on those systems @emph{emulates} | |
190 @code{ls} in Lisp, by using the @file{ls-lisp.el} package. While | |
191 @file{ls-lisp.el} provides a reasonably full emulation of @code{ls}, | |
71544
70062eaec923
(ls in Lisp, Windows Keyboard, Windows Mouse)
Eli Zaretskii <eliz@gnu.org>
parents:
71473
diff
changeset
|
192 there are some options and features peculiar to that emulation; |
70062eaec923
(ls in Lisp, Windows Keyboard, Windows Mouse)
Eli Zaretskii <eliz@gnu.org>
parents:
71473
diff
changeset
|
193 @iftex |
70062eaec923
(ls in Lisp, Windows Keyboard, Windows Mouse)
Eli Zaretskii <eliz@gnu.org>
parents:
71473
diff
changeset
|
194 for more details, see the documentation of the variables whose names |
70062eaec923
(ls in Lisp, Windows Keyboard, Windows Mouse)
Eli Zaretskii <eliz@gnu.org>
parents:
71473
diff
changeset
|
195 begin with @code{ls-lisp}. |
70062eaec923
(ls in Lisp, Windows Keyboard, Windows Mouse)
Eli Zaretskii <eliz@gnu.org>
parents:
71473
diff
changeset
|
196 @end iftex |
70062eaec923
(ls in Lisp, Windows Keyboard, Windows Mouse)
Eli Zaretskii <eliz@gnu.org>
parents:
71473
diff
changeset
|
197 @ifnottex |
70062eaec923
(ls in Lisp, Windows Keyboard, Windows Mouse)
Eli Zaretskii <eliz@gnu.org>
parents:
71473
diff
changeset
|
198 they are described in this section. |
71468 | 199 |
200 The @code{ls} emulation supports many of the @code{ls} switches, but | |
201 it doesn't support all of them. Here's the list of the switches it | |
202 does support: @option{-A}, @option{-a}, @option{-B}, @option{-C}, | |
203 @option{-c}, @option{-i}, @option{-G}, @option{-g}, @option{-R}, | |
204 @option{-r}, @option{-S}, @option{-s}, @option{-t}, @option{-U}, | |
205 @option{-u}, and @option{-X}. The @option{-F} switch is partially | |
206 supported (it appends the character that classifies the file, but does | |
207 not prevent symlink following). | |
208 | |
209 @vindex ls-lisp-use-insert-directory-program | |
210 On MS-Windows and MS-DOS, @file{ls-lisp.el} is preloaded when Emacs | |
211 is built, so the Lisp emulation of @code{ls} is always used on those | |
212 platforms. If you have a ported @code{ls}, setting | |
213 @code{ls-lisp-use-insert-directory-program} to a non-@code{nil} value | |
214 will revert to using an external program named by the variable | |
215 @code{insert-directory-program}. | |
216 | |
217 @vindex ls-lisp-ignore-case | |
218 By default, @file{ls-lisp.el} uses a case-sensitive sort order for | |
219 the directory listing it produces; this is so the listing looks the | |
220 same as on other platforms. If you wish that the files be sorted in | |
221 case-insensitive order, set the variable @code{ls-lisp-ignore-case} to | |
222 a non-@code{nil} value. | |
223 | |
224 @vindex ls-lisp-dirs-first | |
225 By default, files and subdirectories are sorted together, to emulate | |
226 the behavior of @code{ls}. However, native MS-Windows/MS-DOS file | |
227 managers list the directories before the files; if you want that | |
228 behavior, customize the option @code{ls-lisp-dirs-first} to a | |
229 non-@code{nil} value. | |
230 | |
231 @vindex ls-lisp-verbosity | |
232 The variable @code{ls-lisp-verbosity} controls the file attributes | |
233 that @file{ls-lisp.el} displays. The value should be a list that | |
234 contains one or more of the symbols @code{links}, @code{uid}, and | |
235 @code{gid}. @code{links} means display the count of different file | |
236 names that are associated with (a.k.a.@: @dfn{links to}) the file's | |
74657
01df1e874f91
(Windows Files): `w32-get-true-file-attributes' is only relevant for NTFS
Eli Zaretskii <eliz@gnu.org>
parents:
74655
diff
changeset
|
237 data; this is only useful on NTFS volumes. @code{uid} means display |
01df1e874f91
(Windows Files): `w32-get-true-file-attributes' is only relevant for NTFS
Eli Zaretskii <eliz@gnu.org>
parents:
74655
diff
changeset
|
238 the numerical identifier of the user who owns the file. @code{gid} |
01df1e874f91
(Windows Files): `w32-get-true-file-attributes' is only relevant for NTFS
Eli Zaretskii <eliz@gnu.org>
parents:
74655
diff
changeset
|
239 means display the numerical identifier of the file owner's group. The |
01df1e874f91
(Windows Files): `w32-get-true-file-attributes' is only relevant for NTFS
Eli Zaretskii <eliz@gnu.org>
parents:
74655
diff
changeset
|
240 default value is @code{(links uid gid)} i.e.@: all the 3 optional |
01df1e874f91
(Windows Files): `w32-get-true-file-attributes' is only relevant for NTFS
Eli Zaretskii <eliz@gnu.org>
parents:
74655
diff
changeset
|
241 attributes are displayed. |
71468 | 242 |
243 @vindex ls-lisp-emulation | |
244 The variable @code{ls-lisp-emulation} controls the flavour of the | |
245 @code{ls} emulation by setting the defaults for the 3 options | |
246 described above: @code{ls-lisp-ignore-case}, | |
247 @code{ls-lisp-dirs-first}, and @code{ls-lisp-verbosity}. The value of | |
248 this option can be one of the following symbols: | |
249 | |
250 @table @code | |
251 @item GNU | |
252 @itemx nil | |
253 Emulate @sc{gnu} systems; this is the default. This sets | |
254 @code{ls-lisp-ignore-case} and @code{ls-lisp-dirs-first} to | |
255 @code{nil}, and @code{ls-lisp-verbosity} to @code{(links uid gid)}. | |
256 @item UNIX | |
257 Emulate Unix systems. Like @code{GNU}, but sets | |
258 @code{ls-lisp-verbosity} to @code{(links uid)}. | |
259 @item MacOS | |
260 Emulate MacOS. Sets @code{ls-lisp-ignore-case} to @code{t}, and | |
261 @code{ls-lisp-dirs-first} and @code{ls-lisp-verbosity} to @code{nil}. | |
262 @item MS-Windows | |
263 Emulate MS-Windows. Sets @code{ls-lisp-ignore-case} and | |
264 @code{ls-lisp-dirs-first} to @code{t}, and @code{ls-lisp-verbosity} to | |
265 @code{(links)} on Windows NT/2K/XP/2K3 and to @code{nil} on Windows 9X. | |
266 Note that the default emulation is @emph{not} @code{MS-Windows}, even | |
267 on Windows, since many users of Emacs on those platforms prefer the | |
268 @sc{gnu} defaults. | |
269 @end table | |
270 | |
271 @noindent | |
272 Any other value of @code{ls-lisp-emulation} means the same as | |
273 @code{GNU}. Note that this option needs to be set @emph{before} | |
274 @file{ls-lisp.el} is loaded, which means that on MS-Windows and MS-DOS | |
275 you will have to set the value from your @file{.emacs} file and then | |
276 restart Emacs, since @file{ls-lisp.el} is preloaded. | |
277 | |
278 @vindex ls-lisp-support-shell-wildcards | |
279 The variable @code{ls-lisp-support-shell-wildcards} controls how | |
280 file-name patterns are supported: if it is non-@code{nil} (the | |
281 default), they are treated as shell-style wildcards; otherwise they | |
282 are treated as Emacs regular expressions. | |
75427
5bf909478893
(ls in Lisp): Document ls-lisp-format-time-list and
Eli Zaretskii <eliz@gnu.org>
parents:
75348
diff
changeset
|
283 |
5bf909478893
(ls in Lisp): Document ls-lisp-format-time-list and
Eli Zaretskii <eliz@gnu.org>
parents:
75348
diff
changeset
|
284 @vindex ls-lisp-format-time-list |
5bf909478893
(ls in Lisp): Document ls-lisp-format-time-list and
Eli Zaretskii <eliz@gnu.org>
parents:
75348
diff
changeset
|
285 The variable @code{ls-lisp-format-time-list} defines how to format |
5bf909478893
(ls in Lisp): Document ls-lisp-format-time-list and
Eli Zaretskii <eliz@gnu.org>
parents:
75348
diff
changeset
|
286 the date and time of files. @emph{The value of this variable is |
5bf909478893
(ls in Lisp): Document ls-lisp-format-time-list and
Eli Zaretskii <eliz@gnu.org>
parents:
75348
diff
changeset
|
287 ignored}, unless Emacs cannot determine the current locale. (However, |
5bf909478893
(ls in Lisp): Document ls-lisp-format-time-list and
Eli Zaretskii <eliz@gnu.org>
parents:
75348
diff
changeset
|
288 if the value of @code{ls-lisp-use-localized-time-format} is |
5bf909478893
(ls in Lisp): Document ls-lisp-format-time-list and
Eli Zaretskii <eliz@gnu.org>
parents:
75348
diff
changeset
|
289 non-@code{nil}, Emacs obeys @code{ls-lisp-format-time-list} even if |
5bf909478893
(ls in Lisp): Document ls-lisp-format-time-list and
Eli Zaretskii <eliz@gnu.org>
parents:
75348
diff
changeset
|
290 the current locale is available; see below.) |
5bf909478893
(ls in Lisp): Document ls-lisp-format-time-list and
Eli Zaretskii <eliz@gnu.org>
parents:
75348
diff
changeset
|
291 |
5bf909478893
(ls in Lisp): Document ls-lisp-format-time-list and
Eli Zaretskii <eliz@gnu.org>
parents:
75348
diff
changeset
|
292 The value of @code{ls-lisp-format-time-list} is a list of 2 strings. |
5bf909478893
(ls in Lisp): Document ls-lisp-format-time-list and
Eli Zaretskii <eliz@gnu.org>
parents:
75348
diff
changeset
|
293 The first string is used if the file was modified within the current |
5bf909478893
(ls in Lisp): Document ls-lisp-format-time-list and
Eli Zaretskii <eliz@gnu.org>
parents:
75348
diff
changeset
|
294 year, while the second string is used for older files. In each of |
5bf909478893
(ls in Lisp): Document ls-lisp-format-time-list and
Eli Zaretskii <eliz@gnu.org>
parents:
75348
diff
changeset
|
295 these two strings you can use @samp{%}-sequences to substitute parts |
5bf909478893
(ls in Lisp): Document ls-lisp-format-time-list and
Eli Zaretskii <eliz@gnu.org>
parents:
75348
diff
changeset
|
296 of the time. For example: |
5bf909478893
(ls in Lisp): Document ls-lisp-format-time-list and
Eli Zaretskii <eliz@gnu.org>
parents:
75348
diff
changeset
|
297 @lisp |
5bf909478893
(ls in Lisp): Document ls-lisp-format-time-list and
Eli Zaretskii <eliz@gnu.org>
parents:
75348
diff
changeset
|
298 ("%b %e %H:%M" "%b %e %Y") |
5bf909478893
(ls in Lisp): Document ls-lisp-format-time-list and
Eli Zaretskii <eliz@gnu.org>
parents:
75348
diff
changeset
|
299 @end lisp |
5bf909478893
(ls in Lisp): Document ls-lisp-format-time-list and
Eli Zaretskii <eliz@gnu.org>
parents:
75348
diff
changeset
|
300 |
5bf909478893
(ls in Lisp): Document ls-lisp-format-time-list and
Eli Zaretskii <eliz@gnu.org>
parents:
75348
diff
changeset
|
301 @noindent |
5bf909478893
(ls in Lisp): Document ls-lisp-format-time-list and
Eli Zaretskii <eliz@gnu.org>
parents:
75348
diff
changeset
|
302 Note that the strings substituted for these @samp{%}-sequences depend |
5bf909478893
(ls in Lisp): Document ls-lisp-format-time-list and
Eli Zaretskii <eliz@gnu.org>
parents:
75348
diff
changeset
|
303 on the current locale. @xref{Time Parsing,,, elisp, The Emacs Lisp |
5bf909478893
(ls in Lisp): Document ls-lisp-format-time-list and
Eli Zaretskii <eliz@gnu.org>
parents:
75348
diff
changeset
|
304 Reference Manual}, for more about format time specs. |
5bf909478893
(ls in Lisp): Document ls-lisp-format-time-list and
Eli Zaretskii <eliz@gnu.org>
parents:
75348
diff
changeset
|
305 |
5bf909478893
(ls in Lisp): Document ls-lisp-format-time-list and
Eli Zaretskii <eliz@gnu.org>
parents:
75348
diff
changeset
|
306 @vindex ls-lisp-use-localized-time-format |
5bf909478893
(ls in Lisp): Document ls-lisp-format-time-list and
Eli Zaretskii <eliz@gnu.org>
parents:
75348
diff
changeset
|
307 Normally, Emacs formats the file time stamps in either traditional |
5bf909478893
(ls in Lisp): Document ls-lisp-format-time-list and
Eli Zaretskii <eliz@gnu.org>
parents:
75348
diff
changeset
|
308 or ISO-style time format. However, if the value of the variable |
5bf909478893
(ls in Lisp): Document ls-lisp-format-time-list and
Eli Zaretskii <eliz@gnu.org>
parents:
75348
diff
changeset
|
309 @code{ls-lisp-use-localized-time-format} is non-@code{nil}, Emacs |
5bf909478893
(ls in Lisp): Document ls-lisp-format-time-list and
Eli Zaretskii <eliz@gnu.org>
parents:
75348
diff
changeset
|
310 formats file time stamps according to what |
5bf909478893
(ls in Lisp): Document ls-lisp-format-time-list and
Eli Zaretskii <eliz@gnu.org>
parents:
75348
diff
changeset
|
311 @code{ls-lisp-format-time-list} specifies. The @samp{%}-sequences in |
5bf909478893
(ls in Lisp): Document ls-lisp-format-time-list and
Eli Zaretskii <eliz@gnu.org>
parents:
75348
diff
changeset
|
312 @code{ls-lisp-format-time-list} produce locale-dependent month and day |
5bf909478893
(ls in Lisp): Document ls-lisp-format-time-list and
Eli Zaretskii <eliz@gnu.org>
parents:
75348
diff
changeset
|
313 names, which might cause misalignment of columns in Dired display. |
71544
70062eaec923
(ls in Lisp, Windows Keyboard, Windows Mouse)
Eli Zaretskii <eliz@gnu.org>
parents:
71473
diff
changeset
|
314 @end ifnottex |
71468 | 315 |
70153
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
316 @node Windows HOME |
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
317 @section HOME Directory on MS-Windows |
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
318 @cindex @code{HOME} directory on MS-Windows |
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
319 |
71593 | 320 The Windows equivalent of the @code{HOME} directory is the |
70153
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
321 @dfn{user-specific application data directory}. The actual location |
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
322 depends on your Windows version and system configuration; typical values |
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
323 are @file{C:\Documents and Settings\@var{username}\Application Data} on |
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
324 Windows 2K/XP and later, and either @file{C:\WINDOWS\Application Data} |
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
325 or @file{C:\WINDOWS\Profiles\@var{username}\Application Data} on the |
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
326 older Windows 9X/ME systems. |
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
327 |
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
328 @cindex init file @file{.emacs} on MS-Windows |
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
329 The home directory is where your init file @file{.emacs} is stored. |
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
330 When Emacs starts, it first checks whether the environment variable |
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
331 @env{HOME} is set. If it is, it looks for the init file in the |
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
332 directory pointed by @env{HOME}. If @env{HOME} is not defined, Emacs |
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
333 checks for an existing @file{.emacs} file in @file{C:\}, the root |
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
334 directory of drive @file{C:}@footnote{ |
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
335 The check in @file{C:\} is in preference to the application data |
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
336 directory for compatibility with older versions of Emacs, which didn't |
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
337 check the application data directory. |
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
338 }. If there's no such file in @file{C:\}, Emacs next uses the Windows |
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
339 system calls to find out the exact location of your application data |
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
340 directory. If that fails as well, Emacs falls back to @file{C:\}. |
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
341 |
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
342 Whatever the final place is, Emacs sets the value of the @env{HOME} |
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
343 environment variable to point to it, and it will use that location for |
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
344 other files and directories it normally creates in the user's home |
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
345 directory. |
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
346 |
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
347 You can always find out where Emacs thinks is your home directory's |
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
348 location by typing @kbd{C-x d ~/ @key{RET}}. This should present the |
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
349 list of files in the home directory, and show its full name on the |
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
350 first line. Likewise, to visit your init file, type @kbd{C-x C-f |
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
351 ~/.emacs @key{RET}}. |
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
352 |
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
353 @cindex @file{_emacs} init file, MS-Windows |
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
354 Because MS-DOS does not allow file names with leading dots, and |
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
355 because older Windows systems made it hard to create files with such |
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
356 names, the Windows port of Emacs supports an alternative name |
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
357 @file{_emacs} as a fallback, if such a file exists in the home |
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
358 directory, whereas @file{.emacs} does not. |
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
359 |
71470
5785f48e4265
(Windows Keyboard): New section.
Eli Zaretskii <eliz@gnu.org>
parents:
71468
diff
changeset
|
360 @node Windows Keyboard |
5785f48e4265
(Windows Keyboard): New section.
Eli Zaretskii <eliz@gnu.org>
parents:
71468
diff
changeset
|
361 @section Keyboard Usage on MS-Windows |
5785f48e4265
(Windows Keyboard): New section.
Eli Zaretskii <eliz@gnu.org>
parents:
71468
diff
changeset
|
362 @cindex keyboard, MS-Windows |
5785f48e4265
(Windows Keyboard): New section.
Eli Zaretskii <eliz@gnu.org>
parents:
71468
diff
changeset
|
363 |
5785f48e4265
(Windows Keyboard): New section.
Eli Zaretskii <eliz@gnu.org>
parents:
71468
diff
changeset
|
364 This section describes the Windows-specific features related to |
5785f48e4265
(Windows Keyboard): New section.
Eli Zaretskii <eliz@gnu.org>
parents:
71468
diff
changeset
|
365 keyboard input in Emacs. |
5785f48e4265
(Windows Keyboard): New section.
Eli Zaretskii <eliz@gnu.org>
parents:
71468
diff
changeset
|
366 |
74932
a5c161e9b578
(Windows Keyboard): Mention widespread Windows bindings, and how to get
Eli Zaretskii <eliz@gnu.org>
parents:
74731
diff
changeset
|
367 @cindex MS-Windows keyboard shortcuts |
75054
5dbe8e3c9ddd
(Windows Keyboard): Explain that Windows was incompatible
Richard M. Stallman <rms@gnu.org>
parents:
74932
diff
changeset
|
368 Many key combinations (known as ``keyboard shortcuts'') that have |
5dbe8e3c9ddd
(Windows Keyboard): Explain that Windows was incompatible
Richard M. Stallman <rms@gnu.org>
parents:
74932
diff
changeset
|
369 conventional uses in MS-Windows programs conflict with traditional |
75195
7c64e88ce71e
(Windows Keyboard): Another small cleanup.
Richard M. Stallman <rms@gnu.org>
parents:
75177
diff
changeset
|
370 Emacs key bindings. (These Emacs key bindings were established years |
7c64e88ce71e
(Windows Keyboard): Another small cleanup.
Richard M. Stallman <rms@gnu.org>
parents:
75177
diff
changeset
|
371 before Microsoft was founded.) Examples of conflicts include |
7c64e88ce71e
(Windows Keyboard): Another small cleanup.
Richard M. Stallman <rms@gnu.org>
parents:
75177
diff
changeset
|
372 @kbd{C-c}, @kbd{C-x}, @kbd{C-z}, @kbd{C-a}, and @kbd{W-@key{SPC}}. |
7c64e88ce71e
(Windows Keyboard): Another small cleanup.
Richard M. Stallman <rms@gnu.org>
parents:
75177
diff
changeset
|
373 You can redefine some of them with meanings more like the MS-Windows |
7c64e88ce71e
(Windows Keyboard): Another small cleanup.
Richard M. Stallman <rms@gnu.org>
parents:
75177
diff
changeset
|
374 meanings by enabling CUA Mode (@pxref{CUA Bindings}). |
74932
a5c161e9b578
(Windows Keyboard): Mention widespread Windows bindings, and how to get
Eli Zaretskii <eliz@gnu.org>
parents:
74731
diff
changeset
|
375 |
71470
5785f48e4265
(Windows Keyboard): New section.
Eli Zaretskii <eliz@gnu.org>
parents:
71468
diff
changeset
|
376 @kindex F10 @r{(MS-Windows)} |
5785f48e4265
(Windows Keyboard): New section.
Eli Zaretskii <eliz@gnu.org>
parents:
71468
diff
changeset
|
377 @cindex menu bar access using keyboard @r{(MS-Windows)} |
5785f48e4265
(Windows Keyboard): New section.
Eli Zaretskii <eliz@gnu.org>
parents:
71468
diff
changeset
|
378 The @key{F10} key on Windows activates the menu bar in a way that |
5785f48e4265
(Windows Keyboard): New section.
Eli Zaretskii <eliz@gnu.org>
parents:
71468
diff
changeset
|
379 makes it possible to use the menus without a mouse. In this mode, the |
5785f48e4265
(Windows Keyboard): New section.
Eli Zaretskii <eliz@gnu.org>
parents:
71468
diff
changeset
|
380 arrow keys traverse the menus, @key{RET} selects a highlighted menu |
5785f48e4265
(Windows Keyboard): New section.
Eli Zaretskii <eliz@gnu.org>
parents:
71468
diff
changeset
|
381 item, and @key{ESC} closes the menu. |
5785f48e4265
(Windows Keyboard): New section.
Eli Zaretskii <eliz@gnu.org>
parents:
71468
diff
changeset
|
382 |
71714
55c201f395e3
(Windows Keyboard) [@iftex]: Add an @inforef to the on-line manual for the rest
Eli Zaretskii <eliz@gnu.org>
parents:
71593
diff
changeset
|
383 @iftex |
55c201f395e3
(Windows Keyboard) [@iftex]: Add an @inforef to the on-line manual for the rest
Eli Zaretskii <eliz@gnu.org>
parents:
71593
diff
changeset
|
384 @inforef{Windows Keyboard, , emacs}, for information about additional |
55c201f395e3
(Windows Keyboard) [@iftex]: Add an @inforef to the on-line manual for the rest
Eli Zaretskii <eliz@gnu.org>
parents:
71593
diff
changeset
|
385 Windows-specific variables in this category. |
55c201f395e3
(Windows Keyboard) [@iftex]: Add an @inforef to the on-line manual for the rest
Eli Zaretskii <eliz@gnu.org>
parents:
71593
diff
changeset
|
386 @end iftex |
71544
70062eaec923
(ls in Lisp, Windows Keyboard, Windows Mouse)
Eli Zaretskii <eliz@gnu.org>
parents:
71473
diff
changeset
|
387 @ifnottex |
71470
5785f48e4265
(Windows Keyboard): New section.
Eli Zaretskii <eliz@gnu.org>
parents:
71468
diff
changeset
|
388 @vindex w32-alt-is-meta |
5785f48e4265
(Windows Keyboard): New section.
Eli Zaretskii <eliz@gnu.org>
parents:
71468
diff
changeset
|
389 @cindex @code{Alt} key (MS-Windows) |
5785f48e4265
(Windows Keyboard): New section.
Eli Zaretskii <eliz@gnu.org>
parents:
71468
diff
changeset
|
390 By default, the key labeled @key{Alt} is mapped as the @key{META} |
5785f48e4265
(Windows Keyboard): New section.
Eli Zaretskii <eliz@gnu.org>
parents:
71468
diff
changeset
|
391 key. If you wish it to produce the @code{Alt} modifier instead, set |
5785f48e4265
(Windows Keyboard): New section.
Eli Zaretskii <eliz@gnu.org>
parents:
71468
diff
changeset
|
392 the variable @code{w32-alt-is-meta} to a @code{nil} value. |
5785f48e4265
(Windows Keyboard): New section.
Eli Zaretskii <eliz@gnu.org>
parents:
71468
diff
changeset
|
393 |
5785f48e4265
(Windows Keyboard): New section.
Eli Zaretskii <eliz@gnu.org>
parents:
71468
diff
changeset
|
394 @vindex w32-capslock-is-shiftlock |
5785f48e4265
(Windows Keyboard): New section.
Eli Zaretskii <eliz@gnu.org>
parents:
71468
diff
changeset
|
395 By default, the @key{CapsLock} key only affects normal character |
5785f48e4265
(Windows Keyboard): New section.
Eli Zaretskii <eliz@gnu.org>
parents:
71468
diff
changeset
|
396 keys (it converts lower-case characters to their upper-case |
5785f48e4265
(Windows Keyboard): New section.
Eli Zaretskii <eliz@gnu.org>
parents:
71468
diff
changeset
|
397 variants). However, if you set the variable |
5785f48e4265
(Windows Keyboard): New section.
Eli Zaretskii <eliz@gnu.org>
parents:
71468
diff
changeset
|
398 @code{w32-capslock-is-shiftlock} to a non-@code{nil} value, the |
5785f48e4265
(Windows Keyboard): New section.
Eli Zaretskii <eliz@gnu.org>
parents:
71468
diff
changeset
|
399 @key{CapsLock} key will affect non-character keys as well, as if you |
5785f48e4265
(Windows Keyboard): New section.
Eli Zaretskii <eliz@gnu.org>
parents:
71468
diff
changeset
|
400 pressed the @key{Shift} key while typing the non-character key. |
5785f48e4265
(Windows Keyboard): New section.
Eli Zaretskii <eliz@gnu.org>
parents:
71468
diff
changeset
|
401 |
5785f48e4265
(Windows Keyboard): New section.
Eli Zaretskii <eliz@gnu.org>
parents:
71468
diff
changeset
|
402 @vindex w32-enable-caps-lock |
5785f48e4265
(Windows Keyboard): New section.
Eli Zaretskii <eliz@gnu.org>
parents:
71468
diff
changeset
|
403 If the variable @code{w32-enable-caps-lock} is set to a @code{nil} |
5785f48e4265
(Windows Keyboard): New section.
Eli Zaretskii <eliz@gnu.org>
parents:
71468
diff
changeset
|
404 value, the @key{CapsLock} key produces the symbol @code{capslock} |
5785f48e4265
(Windows Keyboard): New section.
Eli Zaretskii <eliz@gnu.org>
parents:
71468
diff
changeset
|
405 instead of the shifted version of they keys. The default value is |
5785f48e4265
(Windows Keyboard): New section.
Eli Zaretskii <eliz@gnu.org>
parents:
71468
diff
changeset
|
406 @code{t}. |
5785f48e4265
(Windows Keyboard): New section.
Eli Zaretskii <eliz@gnu.org>
parents:
71468
diff
changeset
|
407 |
5785f48e4265
(Windows Keyboard): New section.
Eli Zaretskii <eliz@gnu.org>
parents:
71468
diff
changeset
|
408 @vindex w32-enable-num-lock |
5785f48e4265
(Windows Keyboard): New section.
Eli Zaretskii <eliz@gnu.org>
parents:
71468
diff
changeset
|
409 @cindex keypad keys (MS-Windows) |
5785f48e4265
(Windows Keyboard): New section.
Eli Zaretskii <eliz@gnu.org>
parents:
71468
diff
changeset
|
410 Similarly, if @code{w32-enable-num-lock} is @code{nil}, the |
5785f48e4265
(Windows Keyboard): New section.
Eli Zaretskii <eliz@gnu.org>
parents:
71468
diff
changeset
|
411 @key{NumLock} key will produce the symbol @code{kp-numlock}. The |
5785f48e4265
(Windows Keyboard): New section.
Eli Zaretskii <eliz@gnu.org>
parents:
71468
diff
changeset
|
412 default is @code{t}, which causes @key{NumLock} to work as expected: |
5785f48e4265
(Windows Keyboard): New section.
Eli Zaretskii <eliz@gnu.org>
parents:
71468
diff
changeset
|
413 toggle the meaning of the keys on the numeric keypad. |
71544
70062eaec923
(ls in Lisp, Windows Keyboard, Windows Mouse)
Eli Zaretskii <eliz@gnu.org>
parents:
71473
diff
changeset
|
414 @end ifnottex |
71470
5785f48e4265
(Windows Keyboard): New section.
Eli Zaretskii <eliz@gnu.org>
parents:
71468
diff
changeset
|
415 |
71472 | 416 @vindex w32-apps-modifier |
417 The variable @code{w32-apps-modifier} controls the effect of the | |
418 @key{Apps} key (usually located between the right @key{Alt} and the | |
419 right @key{Ctrl} keys). Its value can be one of the symbols | |
420 @code{hyper}, @code{super}, @code{meta}, @code{alt}, @code{control}, | |
421 or @code{shift} for the respective modifier, or @code{nil} to appear | |
422 as the key @code{apps}. The default is @code{nil}. | |
423 | |
71470
5785f48e4265
(Windows Keyboard): New section.
Eli Zaretskii <eliz@gnu.org>
parents:
71468
diff
changeset
|
424 @vindex w32-lwindow-modifier |
5785f48e4265
(Windows Keyboard): New section.
Eli Zaretskii <eliz@gnu.org>
parents:
71468
diff
changeset
|
425 @vindex w32-rwindow-modifier |
5785f48e4265
(Windows Keyboard): New section.
Eli Zaretskii <eliz@gnu.org>
parents:
71468
diff
changeset
|
426 @vindex w32-scroll-lock-modifier |
5785f48e4265
(Windows Keyboard): New section.
Eli Zaretskii <eliz@gnu.org>
parents:
71468
diff
changeset
|
427 The variable @code{w32-lwindow-modifier} determines the effect of |
5785f48e4265
(Windows Keyboard): New section.
Eli Zaretskii <eliz@gnu.org>
parents:
71468
diff
changeset
|
428 the left Windows key (usually labeled with @key{start} and the Windows |
5785f48e4265
(Windows Keyboard): New section.
Eli Zaretskii <eliz@gnu.org>
parents:
71468
diff
changeset
|
429 logo). If its value is @code{nil} (the default), the key will produce |
5785f48e4265
(Windows Keyboard): New section.
Eli Zaretskii <eliz@gnu.org>
parents:
71468
diff
changeset
|
430 the symbol @code{lwindow}. Setting it to one of the symbols |
5785f48e4265
(Windows Keyboard): New section.
Eli Zaretskii <eliz@gnu.org>
parents:
71468
diff
changeset
|
431 @code{hyper}, @code{super}, @code{meta}, @code{alt}, @code{control}, |
5785f48e4265
(Windows Keyboard): New section.
Eli Zaretskii <eliz@gnu.org>
parents:
71468
diff
changeset
|
432 or @code{shift} will produce the respective modifier. A similar |
5785f48e4265
(Windows Keyboard): New section.
Eli Zaretskii <eliz@gnu.org>
parents:
71468
diff
changeset
|
433 variable @code{w32-rwindow-modifier} controls the effect of the right |
5785f48e4265
(Windows Keyboard): New section.
Eli Zaretskii <eliz@gnu.org>
parents:
71468
diff
changeset
|
434 Windows key, and @code{w32-scroll-lock-modifier} does the same for the |
5785f48e4265
(Windows Keyboard): New section.
Eli Zaretskii <eliz@gnu.org>
parents:
71468
diff
changeset
|
435 @key{ScrLock} key. If these variables are set to @code{nil}, the |
5785f48e4265
(Windows Keyboard): New section.
Eli Zaretskii <eliz@gnu.org>
parents:
71468
diff
changeset
|
436 right Windows key produces the symbol @code{rwindow} and @key{ScrLock} |
5785f48e4265
(Windows Keyboard): New section.
Eli Zaretskii <eliz@gnu.org>
parents:
71468
diff
changeset
|
437 produces the symbol @code{scroll}. |
5785f48e4265
(Windows Keyboard): New section.
Eli Zaretskii <eliz@gnu.org>
parents:
71468
diff
changeset
|
438 |
5785f48e4265
(Windows Keyboard): New section.
Eli Zaretskii <eliz@gnu.org>
parents:
71468
diff
changeset
|
439 @vindex w32-pass-alt-to-system |
71473
662c32135523
(Windows Mouse): New section.
Eli Zaretskii <eliz@gnu.org>
parents:
71472
diff
changeset
|
440 @cindex Windows system menu |
662c32135523
(Windows Mouse): New section.
Eli Zaretskii <eliz@gnu.org>
parents:
71472
diff
changeset
|
441 @cindex @code{Alt} key invokes menu (Windows) |
662c32135523
(Windows Mouse): New section.
Eli Zaretskii <eliz@gnu.org>
parents:
71472
diff
changeset
|
442 Emacs compiled as a native Windows application normally turns off |
662c32135523
(Windows Mouse): New section.
Eli Zaretskii <eliz@gnu.org>
parents:
71472
diff
changeset
|
443 the Windows feature that tapping the @key{ALT} key invokes the Windows |
662c32135523
(Windows Mouse): New section.
Eli Zaretskii <eliz@gnu.org>
parents:
71472
diff
changeset
|
444 menu. The reason is that the @key{ALT} serves as @key{META} in Emacs. |
662c32135523
(Windows Mouse): New section.
Eli Zaretskii <eliz@gnu.org>
parents:
71472
diff
changeset
|
445 When using Emacs, users often press the @key{META} key temporarily and |
662c32135523
(Windows Mouse): New section.
Eli Zaretskii <eliz@gnu.org>
parents:
71472
diff
changeset
|
446 then change their minds; if this has the effect of bringing up the |
662c32135523
(Windows Mouse): New section.
Eli Zaretskii <eliz@gnu.org>
parents:
71472
diff
changeset
|
447 Windows menu, it alters the meaning of subsequent commands. Many |
662c32135523
(Windows Mouse): New section.
Eli Zaretskii <eliz@gnu.org>
parents:
71472
diff
changeset
|
448 users find this frustrating. |
662c32135523
(Windows Mouse): New section.
Eli Zaretskii <eliz@gnu.org>
parents:
71472
diff
changeset
|
449 |
662c32135523
(Windows Mouse): New section.
Eli Zaretskii <eliz@gnu.org>
parents:
71472
diff
changeset
|
450 You can re-enable Windows' default handling of tapping the @key{ALT} |
662c32135523
(Windows Mouse): New section.
Eli Zaretskii <eliz@gnu.org>
parents:
71472
diff
changeset
|
451 key by setting @code{w32-pass-alt-to-system} to a non-@code{nil} |
662c32135523
(Windows Mouse): New section.
Eli Zaretskii <eliz@gnu.org>
parents:
71472
diff
changeset
|
452 value. |
662c32135523
(Windows Mouse): New section.
Eli Zaretskii <eliz@gnu.org>
parents:
71472
diff
changeset
|
453 |
71544
70062eaec923
(ls in Lisp, Windows Keyboard, Windows Mouse)
Eli Zaretskii <eliz@gnu.org>
parents:
71473
diff
changeset
|
454 @ifnottex |
71470
5785f48e4265
(Windows Keyboard): New section.
Eli Zaretskii <eliz@gnu.org>
parents:
71468
diff
changeset
|
455 @vindex w32-pass-lwindow-to-system |
5785f48e4265
(Windows Keyboard): New section.
Eli Zaretskii <eliz@gnu.org>
parents:
71468
diff
changeset
|
456 @vindex w32-pass-rwindow-to-system |
71473
662c32135523
(Windows Mouse): New section.
Eli Zaretskii <eliz@gnu.org>
parents:
71472
diff
changeset
|
457 The variables @code{w32-pass-lwindow-to-system} and |
71470
5785f48e4265
(Windows Keyboard): New section.
Eli Zaretskii <eliz@gnu.org>
parents:
71468
diff
changeset
|
458 @code{w32-pass-rwindow-to-system} determine whether the respective |
5785f48e4265
(Windows Keyboard): New section.
Eli Zaretskii <eliz@gnu.org>
parents:
71468
diff
changeset
|
459 keys are passed to Windows or swallowed by Emacs. If the value is |
5785f48e4265
(Windows Keyboard): New section.
Eli Zaretskii <eliz@gnu.org>
parents:
71468
diff
changeset
|
460 @code{nil}, the respective key is silently swallowed by Emacs, |
71473
662c32135523
(Windows Mouse): New section.
Eli Zaretskii <eliz@gnu.org>
parents:
71472
diff
changeset
|
461 otherwise it is passed to Windows. The default is @code{t} for both |
662c32135523
(Windows Mouse): New section.
Eli Zaretskii <eliz@gnu.org>
parents:
71472
diff
changeset
|
462 of these variables. Passing each of these keys to Windows produces |
662c32135523
(Windows Mouse): New section.
Eli Zaretskii <eliz@gnu.org>
parents:
71472
diff
changeset
|
463 its normal effect: for example, @kbd{@key{Lwindow}} opens the |
74731
eae4f771f536
(Windows Keyboard): Add a footnote about "Windows" keys peculiarities.
Eli Zaretskii <eliz@gnu.org>
parents:
74663
diff
changeset
|
464 @code{Start} menu, etc.@footnote{ |
eae4f771f536
(Windows Keyboard): Add a footnote about "Windows" keys peculiarities.
Eli Zaretskii <eliz@gnu.org>
parents:
74663
diff
changeset
|
465 Some combinations of the ``Windows'' keys with other keys are caught |
eae4f771f536
(Windows Keyboard): Add a footnote about "Windows" keys peculiarities.
Eli Zaretskii <eliz@gnu.org>
parents:
74663
diff
changeset
|
466 by Windows at low level in a way that Emacs currently cannot prevent. |
eae4f771f536
(Windows Keyboard): Add a footnote about "Windows" keys peculiarities.
Eli Zaretskii <eliz@gnu.org>
parents:
74663
diff
changeset
|
467 For example, @kbd{@key{Lwindow} r} always pops up the Windows |
eae4f771f536
(Windows Keyboard): Add a footnote about "Windows" keys peculiarities.
Eli Zaretskii <eliz@gnu.org>
parents:
74663
diff
changeset
|
468 @samp{Run} dialog. Customizing the value of |
eae4f771f536
(Windows Keyboard): Add a footnote about "Windows" keys peculiarities.
Eli Zaretskii <eliz@gnu.org>
parents:
74663
diff
changeset
|
469 @code{w32-phantom-key-code} might help in some cases, though.} |
71470
5785f48e4265
(Windows Keyboard): New section.
Eli Zaretskii <eliz@gnu.org>
parents:
71468
diff
changeset
|
470 |
5785f48e4265
(Windows Keyboard): New section.
Eli Zaretskii <eliz@gnu.org>
parents:
71468
diff
changeset
|
471 @vindex w32-recognize-altgr |
5785f48e4265
(Windows Keyboard): New section.
Eli Zaretskii <eliz@gnu.org>
parents:
71468
diff
changeset
|
472 @kindex AltGr @r{(MS-Windows)} |
5785f48e4265
(Windows Keyboard): New section.
Eli Zaretskii <eliz@gnu.org>
parents:
71468
diff
changeset
|
473 @cindex AltGr key (MS-Windows) |
74655
5d3a0349d385
(Windows Keyboard): Clarify `w32-recognize-altgr' effect.
Eli Zaretskii <eliz@gnu.org>
parents:
74348
diff
changeset
|
474 The variable @code{w32-recognize-altgr} controls whether the |
74663
83b90e9f1a60
(Windows Keyboard): Fix last change.
Eli Zaretskii <eliz@gnu.org>
parents:
74657
diff
changeset
|
475 @key{AltGr} key (if it exists on your keyboard), or its equivalent, |
83b90e9f1a60
(Windows Keyboard): Fix last change.
Eli Zaretskii <eliz@gnu.org>
parents:
74657
diff
changeset
|
476 the combination of the right @key{Alt} and left @key{Ctrl} keys |
83b90e9f1a60
(Windows Keyboard): Fix last change.
Eli Zaretskii <eliz@gnu.org>
parents:
74657
diff
changeset
|
477 pressed together, is recognized as the @key{AltGr} key. The default |
83b90e9f1a60
(Windows Keyboard): Fix last change.
Eli Zaretskii <eliz@gnu.org>
parents:
74657
diff
changeset
|
478 is @code{t}, which means these keys produce @code{AltGr}; setting it |
83b90e9f1a60
(Windows Keyboard): Fix last change.
Eli Zaretskii <eliz@gnu.org>
parents:
74657
diff
changeset
|
479 to @code{nil} causes @key{AltGr} or the equivalent key combination to |
83b90e9f1a60
(Windows Keyboard): Fix last change.
Eli Zaretskii <eliz@gnu.org>
parents:
74657
diff
changeset
|
480 be interpreted as the combination of @key{CTRL} and @key{META} |
83b90e9f1a60
(Windows Keyboard): Fix last change.
Eli Zaretskii <eliz@gnu.org>
parents:
74657
diff
changeset
|
481 modifiers. |
71544
70062eaec923
(ls in Lisp, Windows Keyboard, Windows Mouse)
Eli Zaretskii <eliz@gnu.org>
parents:
71473
diff
changeset
|
482 @end ifnottex |
71470
5785f48e4265
(Windows Keyboard): New section.
Eli Zaretskii <eliz@gnu.org>
parents:
71468
diff
changeset
|
483 |
71473
662c32135523
(Windows Mouse): New section.
Eli Zaretskii <eliz@gnu.org>
parents:
71472
diff
changeset
|
484 @node Windows Mouse |
662c32135523
(Windows Mouse): New section.
Eli Zaretskii <eliz@gnu.org>
parents:
71472
diff
changeset
|
485 @section Mouse Usage on MS-Windows |
662c32135523
(Windows Mouse): New section.
Eli Zaretskii <eliz@gnu.org>
parents:
71472
diff
changeset
|
486 @cindex mouse, and MS-Windows |
662c32135523
(Windows Mouse): New section.
Eli Zaretskii <eliz@gnu.org>
parents:
71472
diff
changeset
|
487 |
662c32135523
(Windows Mouse): New section.
Eli Zaretskii <eliz@gnu.org>
parents:
71472
diff
changeset
|
488 This section describes the Windows-specific variables related to |
662c32135523
(Windows Mouse): New section.
Eli Zaretskii <eliz@gnu.org>
parents:
71472
diff
changeset
|
489 mouse. |
662c32135523
(Windows Mouse): New section.
Eli Zaretskii <eliz@gnu.org>
parents:
71472
diff
changeset
|
490 |
662c32135523
(Windows Mouse): New section.
Eli Zaretskii <eliz@gnu.org>
parents:
71472
diff
changeset
|
491 @vindex w32-mouse-button-tolerance |
662c32135523
(Windows Mouse): New section.
Eli Zaretskii <eliz@gnu.org>
parents:
71472
diff
changeset
|
492 @cindex simulation of middle mouse button |
662c32135523
(Windows Mouse): New section.
Eli Zaretskii <eliz@gnu.org>
parents:
71472
diff
changeset
|
493 The variable @code{w32-mouse-button-tolerance} specifies the |
662c32135523
(Windows Mouse): New section.
Eli Zaretskii <eliz@gnu.org>
parents:
71472
diff
changeset
|
494 time interval, in milliseconds, for faking middle mouse button press |
662c32135523
(Windows Mouse): New section.
Eli Zaretskii <eliz@gnu.org>
parents:
71472
diff
changeset
|
495 on 2-button mice. If both mouse buttons are depressed within this |
662c32135523
(Windows Mouse): New section.
Eli Zaretskii <eliz@gnu.org>
parents:
71472
diff
changeset
|
496 time interval, Emacs generates a middle mouse button click event |
662c32135523
(Windows Mouse): New section.
Eli Zaretskii <eliz@gnu.org>
parents:
71472
diff
changeset
|
497 instead of a double click on one of the buttons. |
662c32135523
(Windows Mouse): New section.
Eli Zaretskii <eliz@gnu.org>
parents:
71472
diff
changeset
|
498 |
662c32135523
(Windows Mouse): New section.
Eli Zaretskii <eliz@gnu.org>
parents:
71472
diff
changeset
|
499 @vindex w32-pass-extra-mouse-buttons-to-system |
662c32135523
(Windows Mouse): New section.
Eli Zaretskii <eliz@gnu.org>
parents:
71472
diff
changeset
|
500 If the variable @code{w32-pass-extra-mouse-buttons-to-system} is |
662c32135523
(Windows Mouse): New section.
Eli Zaretskii <eliz@gnu.org>
parents:
71472
diff
changeset
|
501 non-@code{nil}, Emacs passes the fourth and fifth mouse buttons to |
662c32135523
(Windows Mouse): New section.
Eli Zaretskii <eliz@gnu.org>
parents:
71472
diff
changeset
|
502 Windows. |
662c32135523
(Windows Mouse): New section.
Eli Zaretskii <eliz@gnu.org>
parents:
71472
diff
changeset
|
503 |
662c32135523
(Windows Mouse): New section.
Eli Zaretskii <eliz@gnu.org>
parents:
71472
diff
changeset
|
504 @vindex w32-swap-mouse-buttons |
662c32135523
(Windows Mouse): New section.
Eli Zaretskii <eliz@gnu.org>
parents:
71472
diff
changeset
|
505 The variable @code{w32-swap-mouse-buttons} controls which of the 3 |
662c32135523
(Windows Mouse): New section.
Eli Zaretskii <eliz@gnu.org>
parents:
71472
diff
changeset
|
506 mouse buttons generates the @kbd{mouse-2} events. When it is |
662c32135523
(Windows Mouse): New section.
Eli Zaretskii <eliz@gnu.org>
parents:
71472
diff
changeset
|
507 @code{nil} (the default), the middle button generates @kbd{mouse-2} |
662c32135523
(Windows Mouse): New section.
Eli Zaretskii <eliz@gnu.org>
parents:
71472
diff
changeset
|
508 and the right button generates @kbd{mouse-3} events. If this variable |
662c32135523
(Windows Mouse): New section.
Eli Zaretskii <eliz@gnu.org>
parents:
71472
diff
changeset
|
509 is non-@code{nil}, the roles of these two buttons are reversed. |
71470
5785f48e4265
(Windows Keyboard): New section.
Eli Zaretskii <eliz@gnu.org>
parents:
71468
diff
changeset
|
510 |
24095 | 511 @node Windows Processes |
70153
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
512 @section Subprocesses on Windows 9X/ME and Windows NT/2K/XP |
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
513 @cindex subprocesses on MS-Windows |
24095 | 514 |
70153
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
515 @cindex DOS applications, running from Emacs |
60110
f1ac3b1b3584
(MS-DOS Keyboard, MS-DOS Mouse): Split from MS-DOS Input node.
Richard M. Stallman <rms@gnu.org>
parents:
57368
diff
changeset
|
516 Emacs compiled as a native Windows application (as opposed to the DOS |
24095 | 517 version) includes full support for asynchronous subprocesses. |
518 In the Windows version, synchronous and asynchronous subprocesses work | |
519 fine on both | |
70153
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
520 Windows 9X/ME and Windows NT/2K/XP as long as you run only 32-bit Windows |
24095 | 521 applications. However, when you run a DOS application in a subprocess, |
522 you may encounter problems or be unable to run the application at all; | |
523 and if you run two DOS applications at the same time in two | |
524 subprocesses, you may have to reboot your system. | |
525 | |
526 Since the standard command interpreter (and most command line utilities) | |
70153
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
527 on Windows 9X are DOS applications, these problems are significant when |
24095 | 528 using that system. But there's nothing we can do about them; only |
529 Microsoft can fix them. | |
530 | |
531 If you run just one DOS application subprocess, the subprocess should | |
532 work as expected as long as it is ``well-behaved'' and does not perform | |
533 direct screen access or other unusual actions. If you have a CPU | |
534 monitor application, your machine will appear to be 100% busy even when | |
535 the DOS application is idle, but this is only an artifact of the way CPU | |
536 monitors measure processor load. | |
537 | |
538 You must terminate the DOS application before you start any other DOS | |
539 application in a different subprocess. Emacs is unable to interrupt or | |
540 terminate a DOS subprocess. The only way you can terminate such a | |
541 subprocess is by giving it a command that tells its program to exit. | |
542 | |
543 If you attempt to run two DOS applications at the same time in separate | |
544 subprocesses, the second one that is started will be suspended until the | |
545 first one finishes, even if either or both of them are asynchronous. | |
546 | |
70153
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
547 @cindex kill DOS application |
24095 | 548 If you can go to the first subprocess, and tell it to exit, the second |
549 subprocess should continue normally. However, if the second subprocess | |
550 is synchronous, Emacs itself will be hung until the first subprocess | |
551 finishes. If it will not finish without user input, then you have no | |
39142
449f9371ac14
Mention Windows ME and Windows 2000 in the list of supported versions.
Eli Zaretskii <eliz@gnu.org>
parents:
38869
diff
changeset
|
552 choice but to reboot if you are running on Windows 9X. If you are |
70153
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
553 running on Windows NT/2K/XP, you can use a process viewer application to kill |
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
554 the appropriate instance of NTVDM instead (this will terminate both DOS |
24095 | 555 subprocesses). |
556 | |
39142
449f9371ac14
Mention Windows ME and Windows 2000 in the list of supported versions.
Eli Zaretskii <eliz@gnu.org>
parents:
38869
diff
changeset
|
557 If you have to reboot Windows 9X in this situation, do not use the |
24095 | 558 @code{Shutdown} command on the @code{Start} menu; that usually hangs the |
559 system. Instead, type @kbd{CTL-ALT-@key{DEL}} and then choose | |
560 @code{Shutdown}. That usually works, although it may take a few minutes | |
561 to do its job. | |
562 | |
71473
662c32135523
(Windows Mouse): New section.
Eli Zaretskii <eliz@gnu.org>
parents:
71472
diff
changeset
|
563 @vindex w32-quote-process-args |
71714
55c201f395e3
(Windows Keyboard) [@iftex]: Add an @inforef to the on-line manual for the rest
Eli Zaretskii <eliz@gnu.org>
parents:
71593
diff
changeset
|
564 The variable @code{w32-quote-process-args} controls how Emacs quotes |
55c201f395e3
(Windows Keyboard) [@iftex]: Add an @inforef to the on-line manual for the rest
Eli Zaretskii <eliz@gnu.org>
parents:
71593
diff
changeset
|
565 the process arguments. Non-@code{nil} means quote with the @code{"} |
55c201f395e3
(Windows Keyboard) [@iftex]: Add an @inforef to the on-line manual for the rest
Eli Zaretskii <eliz@gnu.org>
parents:
71593
diff
changeset
|
566 character. If the value is a character, use that character to escape |
55c201f395e3
(Windows Keyboard) [@iftex]: Add an @inforef to the on-line manual for the rest
Eli Zaretskii <eliz@gnu.org>
parents:
71593
diff
changeset
|
567 any quote characters that appear; otherwise chose a suitable escape |
55c201f395e3
(Windows Keyboard) [@iftex]: Add an @inforef to the on-line manual for the rest
Eli Zaretskii <eliz@gnu.org>
parents:
71593
diff
changeset
|
568 character based on the type of the program. |
71473
662c32135523
(Windows Mouse): New section.
Eli Zaretskii <eliz@gnu.org>
parents:
71472
diff
changeset
|
569 |
74348
4fd4b53813c6
(Windows Processes) [@ifnottex]: Mention w32-shell-execute.
Eli Zaretskii <eliz@gnu.org>
parents:
71714
diff
changeset
|
570 @ifnottex |
4fd4b53813c6
(Windows Processes) [@ifnottex]: Mention w32-shell-execute.
Eli Zaretskii <eliz@gnu.org>
parents:
71714
diff
changeset
|
571 @findex w32-shell-execute |
4fd4b53813c6
(Windows Processes) [@ifnottex]: Mention w32-shell-execute.
Eli Zaretskii <eliz@gnu.org>
parents:
71714
diff
changeset
|
572 The function @code{w32-shell-execute} can be useful for writing |
4fd4b53813c6
(Windows Processes) [@ifnottex]: Mention w32-shell-execute.
Eli Zaretskii <eliz@gnu.org>
parents:
71714
diff
changeset
|
573 customized commands that run MS-Windows applications registered to |
4fd4b53813c6
(Windows Processes) [@ifnottex]: Mention w32-shell-execute.
Eli Zaretskii <eliz@gnu.org>
parents:
71714
diff
changeset
|
574 handle a certain standard Windows operation for a specific type of |
4fd4b53813c6
(Windows Processes) [@ifnottex]: Mention w32-shell-execute.
Eli Zaretskii <eliz@gnu.org>
parents:
71714
diff
changeset
|
575 document or file. This function is a wrapper around the Windows |
4fd4b53813c6
(Windows Processes) [@ifnottex]: Mention w32-shell-execute.
Eli Zaretskii <eliz@gnu.org>
parents:
71714
diff
changeset
|
576 @code{ShellExecute} API. See the MS-Windows API documentation for |
4fd4b53813c6
(Windows Processes) [@ifnottex]: Mention w32-shell-execute.
Eli Zaretskii <eliz@gnu.org>
parents:
71714
diff
changeset
|
577 more details. |
4fd4b53813c6
(Windows Processes) [@ifnottex]: Mention w32-shell-execute.
Eli Zaretskii <eliz@gnu.org>
parents:
71714
diff
changeset
|
578 @end ifnottex |
4fd4b53813c6
(Windows Processes) [@ifnottex]: Mention w32-shell-execute.
Eli Zaretskii <eliz@gnu.org>
parents:
71714
diff
changeset
|
579 |
70153
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
580 @node Windows Printing |
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
581 @section Printing and MS-Windows |
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
582 |
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
583 Printing commands, such as @code{lpr-buffer} (@pxref{Printing}) and |
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
584 @code{ps-print-buffer} (@pxref{PostScript}) work in MS-DOS and |
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
585 MS-Windows by sending the output to one of the printer ports, if a |
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
586 Posix-style @code{lpr} program is unavailable. The same Emacs |
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
587 variables control printing on all systems, but in some cases they have |
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
588 different default values on MS-DOS and MS-Windows. |
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
589 |
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
590 Emacs on Windows automatically determines your default printer and |
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
591 sets the variable @var{printer-name} to that printer's name. But in |
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
592 some rare cases this can fail, or you may wish to use a different |
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
593 printer from within Emacs. The rest of this section explains how to |
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
594 tell Emacs which printer to use. |
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
595 |
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
596 @vindex printer-name@r{, (MS-DOS/MW-Windows)} |
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
597 If you want to use your local printer, then set the Lisp variable |
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
598 @code{lpr-command} to @code{""} (its default value on Windows) and |
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
599 @code{printer-name} to the name of the printer port---for example, |
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
600 @code{"PRN"}, the usual local printer port or @code{"LPT2"}, or |
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
601 @code{"COM1"} for a serial printer. You can also set |
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
602 @code{printer-name} to a file name, in which case ``printed'' output |
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
603 is actually appended to that file. If you set @code{printer-name} to |
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
604 @code{"NUL"}, printed output is silently discarded (sent to the system |
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
605 null device). |
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
606 |
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
607 You can also use a printer shared by another machine by setting |
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
608 @code{printer-name} to the UNC share name for that printer---for |
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
609 example, @code{"//joes_pc/hp4si"}. (It doesn't matter whether you use |
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
610 forward slashes or backslashes here.) To find out the names of shared |
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
611 printers, run the command @samp{net view} from the command prompt to |
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
612 obtain a list of servers, and @samp{net view @var{server-name}} to see |
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
613 the names of printers (and directories) shared by that server. |
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
614 Alternatively, click the @samp{Network Neighborhood} icon on your |
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
615 desktop, and look for machines which share their printers via the |
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
616 network. |
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
617 |
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
618 @cindex @samp{net use}, and printing on MS-Windows |
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
619 @cindex networked printers (MS-Windows) |
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
620 If the printer doesn't appear in the output of @samp{net view}, or |
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
621 if setting @code{printer-name} to the UNC share name doesn't produce a |
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
622 hardcopy on that printer, you can use the @samp{net use} command to |
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
623 connect a local print port such as @code{"LPT2"} to the networked |
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
624 printer. For example, typing @kbd{net use LPT2: \\joes_pc\hp4si}@footnote{ |
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
625 Note that the @samp{net use} command requires the UNC share name to be |
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
626 typed with the Windows-style backslashes, while the value of |
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
627 @code{printer-name} can be set with either forward- or backslashes.} |
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
628 causes Windows to @dfn{capture} the @code{LPT2} port and redirect the |
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
629 printed material to the printer connected to the machine @code{joes_pc}. |
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
630 After this command, setting @code{printer-name} to @code{"LPT2"} |
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
631 should produce the hardcopy on the networked printer. |
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
632 |
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
633 With some varieties of Windows network software, you can instruct |
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
634 Windows to capture a specific printer port such as @code{"LPT2"}, and |
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
635 redirect it to a networked printer via the @w{@code{Control |
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
636 Panel->Printers}} applet instead of @samp{net use}. |
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
637 |
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
638 If you set @code{printer-name} to a file name, it's best to use an |
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
639 absolute file name. Emacs changes the working directory according to |
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
640 the default directory of the current buffer, so if the file name in |
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
641 @code{printer-name} is relative, you will end up with several such |
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
642 files, each one in the directory of the buffer from which the printing |
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
643 was done. |
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
644 |
70782
9fb34710a5dd
(Windows Printing): Mention non-support of plain text printing with some
Eli Zaretskii <eliz@gnu.org>
parents:
70472
diff
changeset
|
645 If the value of @code{printer-name} is correct, but printing does |
9fb34710a5dd
(Windows Printing): Mention non-support of plain text printing with some
Eli Zaretskii <eliz@gnu.org>
parents:
70472
diff
changeset
|
646 not produce the hardcopy on your printer, it is possible that your |
9fb34710a5dd
(Windows Printing): Mention non-support of plain text printing with some
Eli Zaretskii <eliz@gnu.org>
parents:
70472
diff
changeset
|
647 printer does not support printing plain text (some cheap printers omit |
71714
55c201f395e3
(Windows Keyboard) [@iftex]: Add an @inforef to the on-line manual for the rest
Eli Zaretskii <eliz@gnu.org>
parents:
71593
diff
changeset
|
648 this functionality). In that case, try the PostScript print commands, |
55c201f395e3
(Windows Keyboard) [@iftex]: Add an @inforef to the on-line manual for the rest
Eli Zaretskii <eliz@gnu.org>
parents:
71593
diff
changeset
|
649 described below. |
70782
9fb34710a5dd
(Windows Printing): Mention non-support of plain text printing with some
Eli Zaretskii <eliz@gnu.org>
parents:
70472
diff
changeset
|
650 |
70153
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
651 @findex print-buffer @r{(MS-DOS)} |
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
652 @findex print-region @r{(MS-DOS)} |
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
653 @vindex lpr-headers-switches @r{(MS-DOS)} |
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
654 The commands @code{print-buffer} and @code{print-region} call the |
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
655 @code{pr} program, or use special switches to the @code{lpr} program, to |
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
656 produce headers on each printed page. MS-DOS and MS-Windows don't |
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
657 normally have these programs, so by default, the variable |
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
658 @code{lpr-headers-switches} is set so that the requests to print page |
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
659 headers are silently ignored. Thus, @code{print-buffer} and |
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
660 @code{print-region} produce the same output as @code{lpr-buffer} and |
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
661 @code{lpr-region}, respectively. If you do have a suitable @code{pr} |
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
662 program (for example, from GNU Coreutils), set |
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
663 @code{lpr-headers-switches} to @code{nil}; Emacs will then call |
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
664 @code{pr} to produce the page headers, and print the resulting output as |
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
665 specified by @code{printer-name}. |
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
666 |
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
667 @vindex print-region-function @r{(MS-DOS)} |
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
668 @cindex lpr usage under MS-DOS |
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
669 @vindex lpr-command @r{(MS-DOS)} |
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
670 @vindex lpr-switches @r{(MS-DOS)} |
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
671 Finally, if you do have an @code{lpr} work-alike, you can set the |
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
672 variable @code{lpr-command} to @code{"lpr"}. Then Emacs will use |
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
673 @code{lpr} for printing, as on other systems. (If the name of the |
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
674 program isn't @code{lpr}, set @code{lpr-command} to specify where to |
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
675 find it.) The variable @code{lpr-switches} has its standard meaning |
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
676 when @code{lpr-command} is not @code{""}. If the variable |
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
677 @code{printer-name} has a string value, it is used as the value for the |
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
678 @code{-P} option to @code{lpr}, as on Unix. |
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
679 |
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
680 @findex ps-print-buffer @r{(MS-DOS)} |
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
681 @findex ps-spool-buffer @r{(MS-DOS)} |
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
682 @vindex ps-printer-name @r{(MS-DOS)} |
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
683 @vindex ps-lpr-command @r{(MS-DOS)} |
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
684 @vindex ps-lpr-switches @r{(MS-DOS)} |
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
685 A parallel set of variables, @code{ps-lpr-command}, |
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
686 @code{ps-lpr-switches}, and @code{ps-printer-name} (@pxref{PostScript |
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
687 Variables}), defines how PostScript files should be printed. These |
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
688 variables are used in the same way as the corresponding variables |
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
689 described above for non-PostScript printing. Thus, the value of |
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
690 @code{ps-printer-name} is used as the name of the device (or file) to |
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
691 which PostScript output is sent, just as @code{printer-name} is used |
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
692 for non-PostScript printing. (There are two distinct sets of |
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
693 variables in case you have two printers attached to two different |
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
694 ports, and only one of them is a PostScript printer.) |
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
695 |
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
696 The default value of the variable @code{ps-lpr-command} is @code{""}, |
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
697 which causes PostScript output to be sent to the printer port specified |
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
698 by @code{ps-printer-name}, but @code{ps-lpr-command} can also be set to |
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
699 the name of a program which will accept PostScript files. Thus, if you |
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
700 have a non-PostScript printer, you can set this variable to the name of |
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
701 a PostScript interpreter program (such as Ghostscript). Any switches |
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
702 that need to be passed to the interpreter program are specified using |
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
703 @code{ps-lpr-switches}. (If the value of @code{ps-printer-name} is a |
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
704 string, it will be added to the list of switches as the value for the |
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
705 @code{-P} option. This is probably only useful if you are using |
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
706 @code{lpr}, so when using an interpreter typically you would set |
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
707 @code{ps-printer-name} to something other than a string so it is |
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
708 ignored.) |
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
709 |
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
710 For example, to use Ghostscript for printing on the system's default |
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
711 printer, put this in your @file{.emacs} file: |
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
712 |
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
713 @example |
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
714 (setq ps-printer-name t) |
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
715 (setq ps-lpr-command "D:/gs6.01/bin/gswin32c.exe") |
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
716 (setq ps-lpr-switches '("-q" "-dNOPAUSE" "-dBATCH" |
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
717 "-sDEVICE=mswinpr2" |
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
718 "-sPAPERSIZE=a4")) |
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
719 @end example |
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
720 |
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
721 @noindent |
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
722 (This assumes that Ghostscript is installed in the |
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
723 @file{D:/gs6.01} directory.) |
63b105ced679
(Windows Files, Windows HOME, MS-Windows Printing): New nodes.
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
724 |
71473
662c32135523
(Windows Mouse): New section.
Eli Zaretskii <eliz@gnu.org>
parents:
71472
diff
changeset
|
725 @node Windows Misc |
662c32135523
(Windows Mouse): New section.
Eli Zaretskii <eliz@gnu.org>
parents:
71472
diff
changeset
|
726 @section Miscellaneous Windows-specific features |
662c32135523
(Windows Mouse): New section.
Eli Zaretskii <eliz@gnu.org>
parents:
71472
diff
changeset
|
727 |
662c32135523
(Windows Mouse): New section.
Eli Zaretskii <eliz@gnu.org>
parents:
71472
diff
changeset
|
728 This section describes miscellaneous Windows-specific features. |
662c32135523
(Windows Mouse): New section.
Eli Zaretskii <eliz@gnu.org>
parents:
71472
diff
changeset
|
729 |
71714
55c201f395e3
(Windows Keyboard) [@iftex]: Add an @inforef to the on-line manual for the rest
Eli Zaretskii <eliz@gnu.org>
parents:
71593
diff
changeset
|
730 @vindex w32-use-visible-system-caret |
55c201f395e3
(Windows Keyboard) [@iftex]: Add an @inforef to the on-line manual for the rest
Eli Zaretskii <eliz@gnu.org>
parents:
71593
diff
changeset
|
731 @cindex screen reader software, MS-Windows |
55c201f395e3
(Windows Keyboard) [@iftex]: Add an @inforef to the on-line manual for the rest
Eli Zaretskii <eliz@gnu.org>
parents:
71593
diff
changeset
|
732 The variable @code{w32-use-visible-system-caret} is a flag that |
55c201f395e3
(Windows Keyboard) [@iftex]: Add an @inforef to the on-line manual for the rest
Eli Zaretskii <eliz@gnu.org>
parents:
71593
diff
changeset
|
733 determines whether to make the system caret visible. The default is |
55c201f395e3
(Windows Keyboard) [@iftex]: Add an @inforef to the on-line manual for the rest
Eli Zaretskii <eliz@gnu.org>
parents:
71593
diff
changeset
|
734 @code{nil}, which means Emacs draws its own cursor to indicate the |
55c201f395e3
(Windows Keyboard) [@iftex]: Add an @inforef to the on-line manual for the rest
Eli Zaretskii <eliz@gnu.org>
parents:
71593
diff
changeset
|
735 position of point. A non-@code{nil} value means Emacs will indicate |
55c201f395e3
(Windows Keyboard) [@iftex]: Add an @inforef to the on-line manual for the rest
Eli Zaretskii <eliz@gnu.org>
parents:
71593
diff
changeset
|
736 point location by the system caret; this facilitates use of screen |
55c201f395e3
(Windows Keyboard) [@iftex]: Add an @inforef to the on-line manual for the rest
Eli Zaretskii <eliz@gnu.org>
parents:
71593
diff
changeset
|
737 reader software. When this variable is non-@code{nil}, other |
55c201f395e3
(Windows Keyboard) [@iftex]: Add an @inforef to the on-line manual for the rest
Eli Zaretskii <eliz@gnu.org>
parents:
71593
diff
changeset
|
738 variables affecting the cursor display have no effect. |
55c201f395e3
(Windows Keyboard) [@iftex]: Add an @inforef to the on-line manual for the rest
Eli Zaretskii <eliz@gnu.org>
parents:
71593
diff
changeset
|
739 |
55c201f395e3
(Windows Keyboard) [@iftex]: Add an @inforef to the on-line manual for the rest
Eli Zaretskii <eliz@gnu.org>
parents:
71593
diff
changeset
|
740 @iftex |
55c201f395e3
(Windows Keyboard) [@iftex]: Add an @inforef to the on-line manual for the rest
Eli Zaretskii <eliz@gnu.org>
parents:
71593
diff
changeset
|
741 @inforef{Windows Misc, , emacs}, for information about additional |
55c201f395e3
(Windows Keyboard) [@iftex]: Add an @inforef to the on-line manual for the rest
Eli Zaretskii <eliz@gnu.org>
parents:
71593
diff
changeset
|
742 Windows-specific variables in this category. |
55c201f395e3
(Windows Keyboard) [@iftex]: Add an @inforef to the on-line manual for the rest
Eli Zaretskii <eliz@gnu.org>
parents:
71593
diff
changeset
|
743 @end iftex |
55c201f395e3
(Windows Keyboard) [@iftex]: Add an @inforef to the on-line manual for the rest
Eli Zaretskii <eliz@gnu.org>
parents:
71593
diff
changeset
|
744 |
71544
70062eaec923
(ls in Lisp, Windows Keyboard, Windows Mouse)
Eli Zaretskii <eliz@gnu.org>
parents:
71473
diff
changeset
|
745 @ifnottex |
71473
662c32135523
(Windows Mouse): New section.
Eli Zaretskii <eliz@gnu.org>
parents:
71472
diff
changeset
|
746 @vindex w32-grab-focus-on-raise |
662c32135523
(Windows Mouse): New section.
Eli Zaretskii <eliz@gnu.org>
parents:
71472
diff
changeset
|
747 @cindex frame focus policy, MS-Windows |
662c32135523
(Windows Mouse): New section.
Eli Zaretskii <eliz@gnu.org>
parents:
71472
diff
changeset
|
748 The variable @code{w32-grab-focus-on-raise}, if set to a |
662c32135523
(Windows Mouse): New section.
Eli Zaretskii <eliz@gnu.org>
parents:
71472
diff
changeset
|
749 non-@code{nil} value causes a frame to grab focus when it is raised. |
662c32135523
(Windows Mouse): New section.
Eli Zaretskii <eliz@gnu.org>
parents:
71472
diff
changeset
|
750 The default is @code{t}, which fits well with the Windows default |
662c32135523
(Windows Mouse): New section.
Eli Zaretskii <eliz@gnu.org>
parents:
71472
diff
changeset
|
751 click-to-focus policy. |
24095 | 752 |
71473
662c32135523
(Windows Mouse): New section.
Eli Zaretskii <eliz@gnu.org>
parents:
71472
diff
changeset
|
753 @vindex w32-list-proportional-fonts |
662c32135523
(Windows Mouse): New section.
Eli Zaretskii <eliz@gnu.org>
parents:
71472
diff
changeset
|
754 The variable @code{w32-list-proportional-fonts} controls whether |
662c32135523
(Windows Mouse): New section.
Eli Zaretskii <eliz@gnu.org>
parents:
71472
diff
changeset
|
755 proportional fonts are included in the font selection dialog. If its |
662c32135523
(Windows Mouse): New section.
Eli Zaretskii <eliz@gnu.org>
parents:
71472
diff
changeset
|
756 value is non-@code{nil}, these fonts will be included. The default is |
662c32135523
(Windows Mouse): New section.
Eli Zaretskii <eliz@gnu.org>
parents:
71472
diff
changeset
|
757 @code{nil}. |
71544
70062eaec923
(ls in Lisp, Windows Keyboard, Windows Mouse)
Eli Zaretskii <eliz@gnu.org>
parents:
71473
diff
changeset
|
758 @end ifnottex |
24095 | 759 |
70443
8e32c8ab08d7
(Microsoft Windows): Rename from "Emacs and Microsoft Windows". All
Eli Zaretskii <eliz@gnu.org>
parents:
70437
diff
changeset
|
760 @ifnottex |
8e32c8ab08d7
(Microsoft Windows): Rename from "Emacs and Microsoft Windows". All
Eli Zaretskii <eliz@gnu.org>
parents:
70437
diff
changeset
|
761 @include msdog-xtra.texi |
8e32c8ab08d7
(Microsoft Windows): Rename from "Emacs and Microsoft Windows". All
Eli Zaretskii <eliz@gnu.org>
parents:
70437
diff
changeset
|
762 @end ifnottex |
8e32c8ab08d7
(Microsoft Windows): Rename from "Emacs and Microsoft Windows". All
Eli Zaretskii <eliz@gnu.org>
parents:
70437
diff
changeset
|
763 |
52401 | 764 @ignore |
765 arch-tag: f39d2590-5dcc-4318-88d9-0eb73ca10fa2 | |
766 @end ignore |