Mercurial > emacs
annotate man/msdog.texi @ 39934:674e73ec881a
(syms_of_callproc): Init Vexec_suffixes to Qnil.
(decode_suffixes): Remove.
author | Stefan Monnier <monnier@iro.umontreal.ca> |
---|---|
date | Sun, 14 Oct 2001 20:13:47 +0000 |
parents | 449f9371ac14 |
children | 7248f6ca013d |
rev | line source |
---|---|
24095 | 1 @c This is part of the Emacs manual. |
39142
449f9371ac14
Mention Windows ME and Windows 2000 in the list of supported versions.
Eli Zaretskii <eliz@gnu.org>
parents:
38869
diff
changeset
|
2 @c Copyright (C) 1985,86,87,93,94,95,1997,2000,2001 |
449f9371ac14
Mention Windows ME and Windows 2000 in the list of supported versions.
Eli Zaretskii <eliz@gnu.org>
parents:
38869
diff
changeset
|
3 @c Free Software Foundation, Inc. |
24095 | 4 @c See file emacs.texi for copying conditions. |
34200
551b6c1b5ee5
Update due to inclusion of macos.texi.
Eli Zaretskii <eliz@gnu.org>
parents:
31060
diff
changeset
|
5 @node MS-DOS, Manifesto, Mac OS, Top |
24095 | 6 @appendix Emacs and MS-DOS |
7 @cindex MS-DOG | |
8 @cindex MS-DOS peculiarities | |
9 | |
10 This section briefly describes the peculiarities of using Emacs under | |
11 the MS-DOS ``operating system'' (also known as ``MS-DOG''). If you | |
12 build Emacs for MS-DOS, the binary will also run on Windows 3.X, Windows | |
39142
449f9371ac14
Mention Windows ME and Windows 2000 in the list of supported versions.
Eli Zaretskii <eliz@gnu.org>
parents:
38869
diff
changeset
|
13 NT, Windows 9X/ME, Windows 2000, or OS/2 as a DOS application; the |
449f9371ac14
Mention Windows ME and Windows 2000 in the list of supported versions.
Eli Zaretskii <eliz@gnu.org>
parents:
38869
diff
changeset
|
14 information in this chapter applies for all of those systems, if you use |
449f9371ac14
Mention Windows ME and Windows 2000 in the list of supported versions.
Eli Zaretskii <eliz@gnu.org>
parents:
38869
diff
changeset
|
15 an Emacs that was built for MS-DOS. |
24095 | 16 |
39142
449f9371ac14
Mention Windows ME and Windows 2000 in the list of supported versions.
Eli Zaretskii <eliz@gnu.org>
parents:
38869
diff
changeset
|
17 Note that it is possible to build Emacs specifically for Windows NT/2K |
449f9371ac14
Mention Windows ME and Windows 2000 in the list of supported versions.
Eli Zaretskii <eliz@gnu.org>
parents:
38869
diff
changeset
|
18 or Windows 9X/ME. If you do that, most of this chapter does not apply; |
24095 | 19 instead, you get behavior much closer to what is documented in the rest |
20 of the manual, including support for long file names, multiple frames, | |
21 scroll bars, mouse menus, and subprocesses. However, the section on | |
22 text files and binary files does still apply. There are also two | |
39142
449f9371ac14
Mention Windows ME and Windows 2000 in the list of supported versions.
Eli Zaretskii <eliz@gnu.org>
parents:
38869
diff
changeset
|
23 sections at the end of this chapter which apply specifically for the |
449f9371ac14
Mention Windows ME and Windows 2000 in the list of supported versions.
Eli Zaretskii <eliz@gnu.org>
parents:
38869
diff
changeset
|
24 Windows version. |
24095 | 25 |
26 @menu | |
27 * Input: MS-DOS Input. Keyboard and mouse usage on MS-DOS. | |
28 * Display: MS-DOS Display. Fonts, frames and display size on MS-DOS. | |
29 * Files: MS-DOS File Names. File name conventions on MS-DOS. | |
30 * Text and Binary:: Text files on MS-DOS use CRLF to separate lines. | |
31 * Printing: MS-DOS Printing. How to specify the printer on MS-DOS. | |
32 * I18N: MS-DOS and MULE. Support for internationalization on MS-DOS. | |
33 * Processes: MS-DOS Processes. Running subprocesses on MS-DOS. | |
34 * Windows Processes:: Running subprocesses on Windows. | |
35 * Windows System Menu:: Controlling what the ALT key does. | |
36 @end menu | |
37 | |
38 @node MS-DOS Input | |
39 @section Keyboard and Mouse on MS-DOS | |
40 | |
41 @cindex Meta (under MS-DOS) | |
42 @cindex Hyper (under MS-DOS) | |
43 @cindex Super (under MS-DOS) | |
44 @vindex dos-super-key | |
45 @vindex dos-hyper-key | |
46 The PC keyboard maps use the left @key{ALT} key as the @key{META} key. | |
47 You have two choices for emulating the @key{SUPER} and @key{HYPER} keys: | |
48 choose either the right @key{CTRL} key or the right @key{ALT} key by | |
49 setting the variables @code{dos-hyper-key} and @code{dos-super-key} to 1 | |
50 or 2 respectively. If neither @code{dos-super-key} nor | |
51 @code{dos-hyper-key} is 1, then by default the right @key{ALT} key is | |
52 also mapped to the @key{META} key. However, if the MS-DOS international | |
53 keyboard support program @file{KEYB.COM} is installed, Emacs will | |
54 @emph{not} map the right @key{ALT} to @key{META}, since it is used for | |
55 accessing characters like @kbd{~} and @kbd{@@} on non-US keyboard | |
56 layouts; in this case, you may only use the left @key{ALT} as @key{META} | |
57 key. | |
58 | |
59 @kindex C-j @r{(MS-DOS)} | |
60 @vindex dos-keypad-mode | |
61 The variable @code{dos-keypad-mode} is a flag variable that controls | |
62 what key codes are returned by keys in the numeric keypad. You can also | |
63 define the keypad @key{ENTER} key to act like @kbd{C-j}, by putting the | |
64 following line into your @file{_emacs} file: | |
65 | |
66 @smallexample | |
37847 | 67 ;; @r{Make the @key{ENTER} key from the numeric keypad act as @kbd{C-j}.} |
24095 | 68 (define-key function-key-map [kp-enter] [?\C-j]) |
69 @end smallexample | |
70 | |
71 @kindex DEL @r{(MS-DOS)} | |
72 @kindex BS @r{(MS-DOS)} | |
73 The key that is called @key{DEL} in Emacs (because that's how it is | |
74 designated on most workstations) is known as @key{BS} (backspace) on a | |
75 PC. That is why the PC-specific terminal initialization remaps the | |
76 @key{BS} key to act as @key{DEL}; the @key{DEL} key is remapped to act | |
77 as @kbd{C-d} for the same reasons. | |
78 | |
79 @kindex C-g @r{(MS-DOS)} | |
80 @kindex C-BREAK @r{(MS-DOS)} | |
81 @cindex quitting on MS-DOS | |
82 Emacs built for MS-DOS recognizes @kbd{C-@key{BREAK}} as a quit | |
83 character, just like @kbd{C-g}. This is because Emacs cannot detect | |
84 that you have typed @kbd{C-g} until it is ready for more input. As a | |
85 consequence, you cannot use @kbd{C-g} to stop a running command | |
86 (@pxref{Quitting}). By contrast, @kbd{C-@key{BREAK}} @emph{is} detected | |
87 as soon as you type it (as @kbd{C-g} is on other systems), so it can be | |
88 used to stop a running command and for emergency escape | |
89 (@pxref{Emergency Escape}). | |
90 | |
91 @cindex mouse support under MS-DOS | |
92 Emacs on MS-DOS supports a mouse (on the default terminal only). | |
93 The mouse commands work as documented, including those that use menus | |
94 and the menu bar (@pxref{Menu Bar}). Scroll bars don't work in | |
95 MS-DOS Emacs. PC mice usually have only two buttons; these act as | |
96 @kbd{Mouse-1} and @kbd{Mouse-2}, but if you press both of them | |
30534
cddd0f1a86b1
(MS-DOS Input): Document msdos-set-mouse-buttons.
Eli Zaretskii <eliz@gnu.org>
parents:
29853
diff
changeset
|
97 together, that has the effect of @kbd{Mouse-3}. If the mouse does have |
cddd0f1a86b1
(MS-DOS Input): Document msdos-set-mouse-buttons.
Eli Zaretskii <eliz@gnu.org>
parents:
29853
diff
changeset
|
98 3 buttons, Emacs detects that at startup, and all the 3 buttons function |
cddd0f1a86b1
(MS-DOS Input): Document msdos-set-mouse-buttons.
Eli Zaretskii <eliz@gnu.org>
parents:
29853
diff
changeset
|
99 normally, as on X. |
cddd0f1a86b1
(MS-DOS Input): Document msdos-set-mouse-buttons.
Eli Zaretskii <eliz@gnu.org>
parents:
29853
diff
changeset
|
100 |
31057
40ac457814bc
Document support for help strings and mouse highlight.
Eli Zaretskii <eliz@gnu.org>
parents:
30534
diff
changeset
|
101 Help strings for menu-bar and pop-up menus are displayed in the echo |
40ac457814bc
Document support for help strings and mouse highlight.
Eli Zaretskii <eliz@gnu.org>
parents:
30534
diff
changeset
|
102 area when the mouse pointer moves across the menu items. |
40ac457814bc
Document support for help strings and mouse highlight.
Eli Zaretskii <eliz@gnu.org>
parents:
30534
diff
changeset
|
103 Highlighting of mouse-sensitive text (@pxref{Mouse References}) is also |
40ac457814bc
Document support for help strings and mouse highlight.
Eli Zaretskii <eliz@gnu.org>
parents:
30534
diff
changeset
|
104 supported. |
40ac457814bc
Document support for help strings and mouse highlight.
Eli Zaretskii <eliz@gnu.org>
parents:
30534
diff
changeset
|
105 |
30534
cddd0f1a86b1
(MS-DOS Input): Document msdos-set-mouse-buttons.
Eli Zaretskii <eliz@gnu.org>
parents:
29853
diff
changeset
|
106 @cindex mouse, set number of buttons |
cddd0f1a86b1
(MS-DOS Input): Document msdos-set-mouse-buttons.
Eli Zaretskii <eliz@gnu.org>
parents:
29853
diff
changeset
|
107 @findex msdos-set-mouse-buttons |
cddd0f1a86b1
(MS-DOS Input): Document msdos-set-mouse-buttons.
Eli Zaretskii <eliz@gnu.org>
parents:
29853
diff
changeset
|
108 Some versions of mouse drivers don't report the number of mouse |
36169
86e871a073b6
Delete find-file-text and find-file-binary.
Richard M. Stallman <rms@gnu.org>
parents:
35188
diff
changeset
|
109 buttons correctly. For example, mice with a wheel report that they |
86e871a073b6
Delete find-file-text and find-file-binary.
Richard M. Stallman <rms@gnu.org>
parents:
35188
diff
changeset
|
110 have 3 buttons, but only 2 of them are passed to Emacs; the clicks on |
86e871a073b6
Delete find-file-text and find-file-binary.
Richard M. Stallman <rms@gnu.org>
parents:
35188
diff
changeset
|
111 the wheel, which serves as the middle button, are not passed. In |
86e871a073b6
Delete find-file-text and find-file-binary.
Richard M. Stallman <rms@gnu.org>
parents:
35188
diff
changeset
|
112 these cases, you can use the @kbd{M-x msdos-set-mouse-buttons} command |
86e871a073b6
Delete find-file-text and find-file-binary.
Richard M. Stallman <rms@gnu.org>
parents:
35188
diff
changeset
|
113 to tell Emacs how many mouse buttons to expect. You could make such a |
86e871a073b6
Delete find-file-text and find-file-binary.
Richard M. Stallman <rms@gnu.org>
parents:
35188
diff
changeset
|
114 setting permanent by adding this fragment to your @file{_emacs} init |
86e871a073b6
Delete find-file-text and find-file-binary.
Richard M. Stallman <rms@gnu.org>
parents:
35188
diff
changeset
|
115 file: |
30534
cddd0f1a86b1
(MS-DOS Input): Document msdos-set-mouse-buttons.
Eli Zaretskii <eliz@gnu.org>
parents:
29853
diff
changeset
|
116 |
cddd0f1a86b1
(MS-DOS Input): Document msdos-set-mouse-buttons.
Eli Zaretskii <eliz@gnu.org>
parents:
29853
diff
changeset
|
117 @example |
36169
86e871a073b6
Delete find-file-text and find-file-binary.
Richard M. Stallman <rms@gnu.org>
parents:
35188
diff
changeset
|
118 ;; @r{Treat the mouse like a 2-button mouse.} |
86e871a073b6
Delete find-file-text and find-file-binary.
Richard M. Stallman <rms@gnu.org>
parents:
35188
diff
changeset
|
119 (msdos-set-mouse-buttons 2) |
30534
cddd0f1a86b1
(MS-DOS Input): Document msdos-set-mouse-buttons.
Eli Zaretskii <eliz@gnu.org>
parents:
29853
diff
changeset
|
120 @end example |
24095 | 121 |
122 @cindex Windows clipboard support | |
123 Emacs built for MS-DOS supports clipboard operations when it runs on | |
124 Windows. Commands that put text on the kill ring, or yank text from the | |
35188
94d46968a93f
Don't say "X Windows". From Colin Walters <walters@cis.ohio-state.edu>.
Eli Zaretskii <eliz@gnu.org>
parents:
34293
diff
changeset
|
125 ring, check the Windows clipboard first, just as Emacs does on the X |
94d46968a93f
Don't say "X Windows". From Colin Walters <walters@cis.ohio-state.edu>.
Eli Zaretskii <eliz@gnu.org>
parents:
34293
diff
changeset
|
126 Window System (@pxref{Mouse Commands}). Only the primary selection and |
94d46968a93f
Don't say "X Windows". From Colin Walters <walters@cis.ohio-state.edu>.
Eli Zaretskii <eliz@gnu.org>
parents:
34293
diff
changeset
|
127 the cut buffer are supported by MS-DOS Emacs on Windows; the secondary |
94d46968a93f
Don't say "X Windows". From Colin Walters <walters@cis.ohio-state.edu>.
Eli Zaretskii <eliz@gnu.org>
parents:
34293
diff
changeset
|
128 selection always appears as empty. |
24095 | 129 |
130 Due to the way clipboard access is implemented by Windows, the | |
131 length of text you can put into the clipboard is limited by the amount | |
132 of free DOS memory that is available to Emacs. Usually, up to 620KB of | |
133 text can be put into the clipboard, but this limit depends on the system | |
134 configuration and is lower if you run Emacs as a subprocess of | |
38869
8be184904f6c
Don't use "print" for displaying a message.
Richard M. Stallman <rms@gnu.org>
parents:
38865
diff
changeset
|
135 another program. If the killed text does not fit, Emacs outputs a |
24095 | 136 message saying so, and does not put the text into the clipboard. |
137 | |
138 Null characters also cannot be put into the Windows clipboard. If the | |
139 killed text includes null characters, Emacs does not put such text into | |
38869
8be184904f6c
Don't use "print" for displaying a message.
Richard M. Stallman <rms@gnu.org>
parents:
38865
diff
changeset
|
140 the clipboard, and displays in the echo area a message to that effect. |
24095 | 141 |
142 @vindex dos-display-scancodes | |
143 The variable @code{dos-display-scancodes}, when non-@code{nil}, | |
144 directs Emacs to display the ASCII value and the keyboard scan code of | |
145 each keystroke; this feature serves as a complement to the | |
146 @code{view-lossage} command, for debugging. | |
147 | |
148 @node MS-DOS Display | |
149 @section Display on MS-DOS | |
150 @cindex faces under MS-DOS | |
151 @cindex fonts, emulating under MS-DOS | |
152 | |
153 Display on MS-DOS cannot use font variants, like bold or italic, | |
154 but it does support | |
155 multiple faces, each of which can specify a foreground and a background | |
156 color. Therefore, you can get the full functionality of Emacs packages | |
157 that use fonts (such as @code{font-lock}, Enriched Text mode, and | |
158 others) by defining the relevant faces to use different colors. Use the | |
159 @code{list-colors-display} command (@pxref{Frame Parameters}) and the | |
160 @code{list-faces-display} command (@pxref{Faces}) to see what colors and | |
161 faces are available and what they look like. | |
162 | |
37847 | 163 @xref{MS-DOS and MULE}, later in this chapter, for information on |
164 how Emacs displays glyphs and characters that aren't supported by the | |
24095 | 165 native font built into the DOS display. |
166 | |
28093
3e652235df91
(MS-DOS Display) Explain the differences in cursor type control
Eli Zaretskii <eliz@gnu.org>
parents:
27213
diff
changeset
|
167 @cindex cursor shape on MS-DOS |
3e652235df91
(MS-DOS Display) Explain the differences in cursor type control
Eli Zaretskii <eliz@gnu.org>
parents:
27213
diff
changeset
|
168 When Emacs starts, it changes the cursor shape to a solid box. This |
36169
86e871a073b6
Delete find-file-text and find-file-binary.
Richard M. Stallman <rms@gnu.org>
parents:
35188
diff
changeset
|
169 is for compatibility with other systems, where the box cursor is the |
86e871a073b6
Delete find-file-text and find-file-binary.
Richard M. Stallman <rms@gnu.org>
parents:
35188
diff
changeset
|
170 default in Emacs. This default shape can be changed to a bar by |
86e871a073b6
Delete find-file-text and find-file-binary.
Richard M. Stallman <rms@gnu.org>
parents:
35188
diff
changeset
|
171 specifying the @code{cursor-type} parameter in the variable |
86e871a073b6
Delete find-file-text and find-file-binary.
Richard M. Stallman <rms@gnu.org>
parents:
35188
diff
changeset
|
172 @code{default-frame-alist} (@pxref{Creating Frames}). The MS-DOS |
86e871a073b6
Delete find-file-text and find-file-binary.
Richard M. Stallman <rms@gnu.org>
parents:
35188
diff
changeset
|
173 terminal doesn't support a vertical-bar cursor, so the bar cursor is |
86e871a073b6
Delete find-file-text and find-file-binary.
Richard M. Stallman <rms@gnu.org>
parents:
35188
diff
changeset
|
174 horizontal, and the @code{@var{width}} parameter, if specified by the |
86e871a073b6
Delete find-file-text and find-file-binary.
Richard M. Stallman <rms@gnu.org>
parents:
35188
diff
changeset
|
175 frame parameters, actually determines its height. As an extension, |
86e871a073b6
Delete find-file-text and find-file-binary.
Richard M. Stallman <rms@gnu.org>
parents:
35188
diff
changeset
|
176 the bar cursor specification can include the starting scan line of the |
86e871a073b6
Delete find-file-text and find-file-binary.
Richard M. Stallman <rms@gnu.org>
parents:
35188
diff
changeset
|
177 cursor as well as its width, like this: |
28093
3e652235df91
(MS-DOS Display) Explain the differences in cursor type control
Eli Zaretskii <eliz@gnu.org>
parents:
27213
diff
changeset
|
178 |
3e652235df91
(MS-DOS Display) Explain the differences in cursor type control
Eli Zaretskii <eliz@gnu.org>
parents:
27213
diff
changeset
|
179 @example |
3e652235df91
(MS-DOS Display) Explain the differences in cursor type control
Eli Zaretskii <eliz@gnu.org>
parents:
27213
diff
changeset
|
180 '(cursor-type bar @var{width} . @var{start}) |
3e652235df91
(MS-DOS Display) Explain the differences in cursor type control
Eli Zaretskii <eliz@gnu.org>
parents:
27213
diff
changeset
|
181 @end example |
3e652235df91
(MS-DOS Display) Explain the differences in cursor type control
Eli Zaretskii <eliz@gnu.org>
parents:
27213
diff
changeset
|
182 |
3e652235df91
(MS-DOS Display) Explain the differences in cursor type control
Eli Zaretskii <eliz@gnu.org>
parents:
27213
diff
changeset
|
183 @noindent |
3e652235df91
(MS-DOS Display) Explain the differences in cursor type control
Eli Zaretskii <eliz@gnu.org>
parents:
27213
diff
changeset
|
184 In addition, if the @var{width} parameter is negative, the cursor bar |
3e652235df91
(MS-DOS Display) Explain the differences in cursor type control
Eli Zaretskii <eliz@gnu.org>
parents:
27213
diff
changeset
|
185 begins at the top of the character cell. |
3e652235df91
(MS-DOS Display) Explain the differences in cursor type control
Eli Zaretskii <eliz@gnu.org>
parents:
27213
diff
changeset
|
186 |
24095 | 187 @cindex frames on MS-DOS |
36169
86e871a073b6
Delete find-file-text and find-file-binary.
Richard M. Stallman <rms@gnu.org>
parents:
35188
diff
changeset
|
188 The MS-DOS terminal can only display a single frame at a time. The |
86e871a073b6
Delete find-file-text and find-file-binary.
Richard M. Stallman <rms@gnu.org>
parents:
35188
diff
changeset
|
189 Emacs frame facilities work on MS-DOS much as they do on text-only |
86e871a073b6
Delete find-file-text and find-file-binary.
Richard M. Stallman <rms@gnu.org>
parents:
35188
diff
changeset
|
190 terminals (@pxref{Frames}). When you run Emacs from a DOS window on |
86e871a073b6
Delete find-file-text and find-file-binary.
Richard M. Stallman <rms@gnu.org>
parents:
35188
diff
changeset
|
191 MS-Windows, you can make the visible frame smaller than the full |
86e871a073b6
Delete find-file-text and find-file-binary.
Richard M. Stallman <rms@gnu.org>
parents:
35188
diff
changeset
|
192 screen, but Emacs still cannot display more than a single frame at a |
86e871a073b6
Delete find-file-text and find-file-binary.
Richard M. Stallman <rms@gnu.org>
parents:
35188
diff
changeset
|
193 time. |
24095 | 194 |
195 @cindex frame size under MS-DOS | |
196 @findex mode4350 | |
197 @findex mode25 | |
198 The @code{mode4350} command switches the display to 43 or 50 | |
199 lines, depending on your hardware; the @code{mode25} command switches | |
200 to the default 80x25 screen size. | |
201 | |
202 By default, Emacs only knows how to set screen sizes of 80 columns by | |
203 25, 28, 35, 40, 43 or 50 rows. However, if your video adapter has | |
204 special video modes that will switch the display to other sizes, you can | |
205 have Emacs support those too. When you ask Emacs to switch the frame to | |
206 @var{n} rows by @var{m} columns dimensions, it checks if there is a | |
207 variable called @code{screen-dimensions-@var{n}x@var{m}}, and if so, | |
208 uses its value (which must be an integer) as the video mode to switch | |
209 to. (Emacs switches to that video mode by calling the BIOS @code{Set | |
210 Video Mode} function with the value of | |
211 @code{screen-dimensions-@var{n}x@var{m}} in the @code{AL} register.) | |
212 For example, suppose your adapter will switch to 66x80 dimensions when | |
213 put into video mode 85. Then you can make Emacs support this screen | |
214 size by putting the following into your @file{_emacs} file: | |
215 | |
216 @example | |
217 (setq screen-dimensions-66x80 85) | |
218 @end example | |
219 | |
220 Since Emacs on MS-DOS can only set the frame size to specific | |
221 supported dimensions, it cannot honor every possible frame resizing | |
222 request. When an unsupported size is requested, Emacs chooses the next | |
223 larger supported size beyond the specified size. For example, if you | |
224 ask for 36x80 frame, you will get 40x80 instead. | |
225 | |
226 The variables @code{screen-dimensions-@var{n}x@var{m}} are used only | |
227 when they exactly match the specified size; the search for the next | |
228 larger supported size ignores them. In the above example, even if your | |
229 VGA supports 38x80 dimensions and you define a variable | |
230 @code{screen-dimensions-38x80} with a suitable value, you will still get | |
231 40x80 screen when you ask for a 36x80 frame. If you want to get the | |
232 38x80 size in this case, you can do it by setting the variable named | |
233 @code{screen-dimensions-36x80} with the same video mode value as | |
234 @code{screen-dimensions-38x80}. | |
235 | |
236 Changing frame dimensions on MS-DOS has the effect of changing all the | |
237 other frames to the new dimensions. | |
238 | |
239 @node MS-DOS File Names | |
240 @section File Names on MS-DOS | |
241 @cindex file names under MS-DOS | |
242 @cindex init file, default name under MS-DOS | |
243 | |
244 MS-DOS normally uses a backslash, @samp{\}, to separate name units | |
245 within a file name, instead of the slash used on other systems. Emacs | |
246 on MS-DOS permits use of either slash or backslash, and also knows | |
247 about drive letters in file names. | |
248 | |
249 On MS-DOS, file names are case-insensitive and limited to eight | |
250 characters, plus optionally a period and three more characters. Emacs | |
251 knows enough about these limitations to handle file names that were | |
252 meant for other operating systems. For instance, leading dots @samp{.} | |
253 in file names are invalid in MS-DOS, so Emacs transparently converts | |
254 them to underscores @samp{_}; thus your default init file (@pxref{Init | |
255 File}) is called @file{_emacs} on MS-DOS. Excess characters before or | |
256 after the period are generally ignored by MS-DOS itself; thus, if you | |
257 visit the file @file{LongFileName.EvenLongerExtension}, you will | |
258 silently get @file{longfile.eve}, but Emacs will still display the long | |
259 file name on the mode line. Other than that, it's up to you to specify | |
260 file names which are valid under MS-DOS; the transparent conversion as | |
261 described above only works on file names built into Emacs. | |
262 | |
263 @cindex backup file names on MS-DOS | |
264 The above restrictions on the file names on MS-DOS make it almost | |
265 impossible to construct the name of a backup file (@pxref{Backup | |
266 Names}) without losing some of the original file name characters. For | |
267 example, the name of a backup file for @file{docs.txt} is | |
268 @file{docs.tx~} even if single backup is used. | |
269 | |
270 @cindex file names under Windows 95/NT | |
271 @cindex long file names in DOS box under Windows 95/NT | |
39142
449f9371ac14
Mention Windows ME and Windows 2000 in the list of supported versions.
Eli Zaretskii <eliz@gnu.org>
parents:
38869
diff
changeset
|
272 If you run Emacs as a DOS application under Windows 9X, Windows ME, or |
449f9371ac14
Mention Windows ME and Windows 2000 in the list of supported versions.
Eli Zaretskii <eliz@gnu.org>
parents:
38869
diff
changeset
|
273 Windows 2000, you can turn on support for long file names. If you do |
449f9371ac14
Mention Windows ME and Windows 2000 in the list of supported versions.
Eli Zaretskii <eliz@gnu.org>
parents:
38869
diff
changeset
|
274 that, Emacs doesn't truncate file names or convert them to lower case; |
449f9371ac14
Mention Windows ME and Windows 2000 in the list of supported versions.
Eli Zaretskii <eliz@gnu.org>
parents:
38869
diff
changeset
|
275 instead, it uses the file names that you specify, verbatim. To enable |
449f9371ac14
Mention Windows ME and Windows 2000 in the list of supported versions.
Eli Zaretskii <eliz@gnu.org>
parents:
38869
diff
changeset
|
276 long file name support, set the environment variable @env{LFN} to |
449f9371ac14
Mention Windows ME and Windows 2000 in the list of supported versions.
Eli Zaretskii <eliz@gnu.org>
parents:
38869
diff
changeset
|
277 @samp{y} before starting Emacs. Unfortunately, Windows NT doesn't allow |
449f9371ac14
Mention Windows ME and Windows 2000 in the list of supported versions.
Eli Zaretskii <eliz@gnu.org>
parents:
38869
diff
changeset
|
278 DOS programs to access long file names, so Emacs built for MS-DOS will |
449f9371ac14
Mention Windows ME and Windows 2000 in the list of supported versions.
Eli Zaretskii <eliz@gnu.org>
parents:
38869
diff
changeset
|
279 only see their short 8+3 aliases. |
24095 | 280 |
29107 | 281 @cindex @env{HOME} directory under MS-DOS |
24095 | 282 MS-DOS has no notion of home directory, so Emacs on MS-DOS pretends |
29107 | 283 that the directory where it is installed is the value of @env{HOME} |
24095 | 284 environment variable. That is, if your Emacs binary, |
285 @file{emacs.exe}, is in the directory @file{c:/utils/emacs/bin}, then | |
29107 | 286 Emacs acts as if @env{HOME} were set to @samp{c:/utils/emacs}. In |
24095 | 287 particular, that is where Emacs looks for the init file @file{_emacs}. |
288 With this in mind, you can use @samp{~} in file names as an alias for | |
36169
86e871a073b6
Delete find-file-text and find-file-binary.
Richard M. Stallman <rms@gnu.org>
parents:
35188
diff
changeset
|
289 the home directory, as you would on GNU or Unix. You can also set |
86e871a073b6
Delete find-file-text and find-file-binary.
Richard M. Stallman <rms@gnu.org>
parents:
35188
diff
changeset
|
290 @env{HOME} variable in the environment before starting Emacs; its |
86e871a073b6
Delete find-file-text and find-file-binary.
Richard M. Stallman <rms@gnu.org>
parents:
35188
diff
changeset
|
291 value will then override the above default behavior. |
24095 | 292 |
293 Emacs on MS-DOS handles the directory name @file{/dev} specially, | |
294 because of a feature in the emulator libraries of DJGPP that pretends | |
295 I/O devices have names in that directory. We recommend that you avoid | |
296 using an actual directory named @file{/dev} on any disk. | |
297 | |
298 @node Text and Binary | |
299 @section Text Files and Binary Files | |
300 @cindex text and binary files on MS-DOS/MS-Windows | |
301 | |
302 GNU Emacs uses newline characters to separate text lines. This is the | |
36169
86e871a073b6
Delete find-file-text and find-file-binary.
Richard M. Stallman <rms@gnu.org>
parents:
35188
diff
changeset
|
303 convention used on GNU and Unix. |
24095 | 304 |
305 @cindex end-of-line conversion on MS-DOS/MS-Windows | |
306 MS-DOS and MS-Windows normally use carriage-return linefeed, a | |
307 two-character sequence, to separate text lines. (Linefeed is the same | |
308 character as newline.) Therefore, convenient editing of typical files | |
309 with Emacs requires conversion of these end-of-line (EOL) sequences. | |
310 And that is what Emacs normally does: it converts carriage-return | |
311 linefeed into newline when reading files, and converts newline into | |
312 carriage-return linefeed when writing files. The same mechanism that | |
313 handles conversion of international character codes does this conversion | |
314 also (@pxref{Coding Systems}). | |
315 | |
29853
d49e929bbdf6
(Text and Binary): Separate description of EOL
Eli Zaretskii <eliz@gnu.org>
parents:
29107
diff
changeset
|
316 @cindex cursor location, on MS-DOS |
d49e929bbdf6
(Text and Binary): Separate description of EOL
Eli Zaretskii <eliz@gnu.org>
parents:
29107
diff
changeset
|
317 @cindex point location, on MS-DOS |
24095 | 318 One consequence of this special format-conversion of most files is |
319 that character positions as reported by Emacs (@pxref{Position Info}) do | |
320 not agree with the file size information known to the operating system. | |
321 | |
322 In addition, if Emacs recognizes from a file's contents that it uses | |
323 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
|
324 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
|
325 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
|
326 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
|
327 end-of-line convention after you edit them. |
24095 | 328 |
29853
d49e929bbdf6
(Text and Binary): Separate description of EOL
Eli Zaretskii <eliz@gnu.org>
parents:
29107
diff
changeset
|
329 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
|
330 the current buffer. If MS-DOS end-of-line translation is in use for the |
d49e929bbdf6
(Text and Binary): Separate description of EOL
Eli Zaretskii <eliz@gnu.org>
parents:
29107
diff
changeset
|
331 buffer, a backslash @samp{\} is displayed after the coding system |
d49e929bbdf6
(Text and Binary): Separate description of EOL
Eli Zaretskii <eliz@gnu.org>
parents:
29107
diff
changeset
|
332 mnemonic near the beginning of the mode line (@pxref{Mode Line}). If no |
d49e929bbdf6
(Text and Binary): Separate description of EOL
Eli Zaretskii <eliz@gnu.org>
parents:
29107
diff
changeset
|
333 EOL translation was performed, the string @samp{(Unix)} is displayed |
d49e929bbdf6
(Text and Binary): Separate description of EOL
Eli Zaretskii <eliz@gnu.org>
parents:
29107
diff
changeset
|
334 instead of the backslash, to alert you that the file's EOL format is not |
d49e929bbdf6
(Text and Binary): Separate description of EOL
Eli Zaretskii <eliz@gnu.org>
parents:
29107
diff
changeset
|
335 the usual carriage-return linefeed. |
24095 | 336 |
29853
d49e929bbdf6
(Text and Binary): Separate description of EOL
Eli Zaretskii <eliz@gnu.org>
parents:
29107
diff
changeset
|
337 @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
|
338 To visit a file and specify whether it uses DOS-style or Unix-style |
86e871a073b6
Delete find-file-text and find-file-binary.
Richard M. Stallman <rms@gnu.org>
parents:
35188
diff
changeset
|
339 end-of-line, specify a coding system (@pxref{Specify Coding}). For |
86e871a073b6
Delete find-file-text and find-file-binary.
Richard M. Stallman <rms@gnu.org>
parents:
35188
diff
changeset
|
340 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
|
341 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
|
342 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
|
343 @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
|
344 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
|
345 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
|
346 @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
|
347 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
|
348 effectively converts the file to Unix EOL style, like @code{dos2unix}. |
24095 | 349 |
350 @cindex untranslated file system | |
351 @findex add-untranslated-filesystem | |
352 When you use NFS or Samba to access file systems that reside on | |
36169
86e871a073b6
Delete find-file-text and find-file-binary.
Richard M. Stallman <rms@gnu.org>
parents:
35188
diff
changeset
|
353 computers using GNU or Unix systems, Emacs should not perform |
24095 | 354 end-of-line translation on any files in these file systems--not even |
355 when you create a new file. To request this, designate these file | |
356 systems as @dfn{untranslated} file systems by calling the function | |
357 @code{add-untranslated-filesystem}. It takes one argument: the file | |
358 system name, including a drive letter and optionally a directory. For | |
359 example, | |
360 | |
361 @example | |
362 (add-untranslated-filesystem "Z:") | |
363 @end example | |
364 | |
365 @noindent | |
366 designates drive Z as an untranslated file system, and | |
367 | |
368 @example | |
369 (add-untranslated-filesystem "Z:\\foo") | |
370 @end example | |
371 | |
372 @noindent | |
373 designates directory @file{\foo} on drive Z as an untranslated file | |
374 system. | |
375 | |
376 Most often you would use @code{add-untranslated-filesystem} in your | |
377 @file{_emacs} file, or in @file{site-start.el} so that all the users at | |
378 your site get the benefit of it. | |
379 | |
380 @findex remove-untranslated-filesystem | |
381 To countermand the effect of @code{add-untranslated-filesystem}, use | |
382 the function @code{remove-untranslated-filesystem}. This function takes | |
383 one argument, which should be a string just like the one that was used | |
384 previously with @code{add-untranslated-filesystem}. | |
385 | |
36169
86e871a073b6
Delete find-file-text and find-file-binary.
Richard M. Stallman <rms@gnu.org>
parents:
35188
diff
changeset
|
386 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
|
387 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
|
388 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
|
389 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
|
390 |
d49e929bbdf6
(Text and Binary): Separate description of EOL
Eli Zaretskii <eliz@gnu.org>
parents:
29107
diff
changeset
|
391 @vindex file-name-buffer-file-type-alist |
d49e929bbdf6
(Text and Binary): Separate description of EOL
Eli Zaretskii <eliz@gnu.org>
parents:
29107
diff
changeset
|
392 @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
|
393 Some kinds of files should not be converted at all, because their |
d49e929bbdf6
(Text and Binary): Separate description of EOL
Eli Zaretskii <eliz@gnu.org>
parents:
29107
diff
changeset
|
394 contents are not really text. Therefore, Emacs on MS-DOS distinguishes |
d49e929bbdf6
(Text and Binary): Separate description of EOL
Eli Zaretskii <eliz@gnu.org>
parents:
29107
diff
changeset
|
395 certain files as @dfn{binary files}. (This distinction is not part of |
d49e929bbdf6
(Text and Binary): Separate description of EOL
Eli Zaretskii <eliz@gnu.org>
parents:
29107
diff
changeset
|
396 MS-DOS; it is made by Emacs only.) Binary files include executable |
d49e929bbdf6
(Text and Binary): Separate description of EOL
Eli Zaretskii <eliz@gnu.org>
parents:
29107
diff
changeset
|
397 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
|
398 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
|
399 @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
|
400 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
|
401 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
|
402 @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
|
403 @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
|
404 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
|
405 @code{file-name-buffer-file-type-alist} also includes file-name patterns |
d49e929bbdf6
(Text and Binary): Separate description of EOL
Eli Zaretskii <eliz@gnu.org>
parents:
29107
diff
changeset
|
406 for files which are known to be DOS-style text files with |
d49e929bbdf6
(Text and Binary): Separate description of EOL
Eli Zaretskii <eliz@gnu.org>
parents:
29107
diff
changeset
|
407 carriage-return linefeed EOL format, such as @file{CONFIG.SYS}; Emacs |
d49e929bbdf6
(Text and Binary): Separate description of EOL
Eli Zaretskii <eliz@gnu.org>
parents:
29107
diff
changeset
|
408 always writes those files with DOS-style EOLs. |
d49e929bbdf6
(Text and Binary): Separate description of EOL
Eli Zaretskii <eliz@gnu.org>
parents:
29107
diff
changeset
|
409 |
d49e929bbdf6
(Text and Binary): Separate description of EOL
Eli Zaretskii <eliz@gnu.org>
parents:
29107
diff
changeset
|
410 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
|
411 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
|
412 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
|
413 |
24095 | 414 @node MS-DOS Printing |
415 @section Printing and MS-DOS | |
416 | |
417 Printing commands, such as @code{lpr-buffer} (@pxref{Hardcopy}) and | |
27213 | 418 @code{ps-print-buffer} (@pxref{PostScript}) can work in MS-DOS and |
24096
083c21910c49
(MS-DOS Printing): Rewrite section.
Andrew Innes <andrewi@gnu.org>
parents:
24095
diff
changeset
|
419 MS-Windows by sending the output to one of the printer ports, if a |
38865
62e02f5ae533
Avoid saying "Unix" in a way that includes GNU.
Richard M. Stallman <rms@gnu.org>
parents:
38788
diff
changeset
|
420 Posix-style @code{lpr} program is unavailable. The same Emacs |
36169
86e871a073b6
Delete find-file-text and find-file-binary.
Richard M. Stallman <rms@gnu.org>
parents:
35188
diff
changeset
|
421 variables control printing on all systems (@pxref{Hardcopy}), but in |
86e871a073b6
Delete find-file-text and find-file-binary.
Richard M. Stallman <rms@gnu.org>
parents:
35188
diff
changeset
|
422 some cases they have different default values on MS-DOS and |
86e871a073b6
Delete find-file-text and find-file-binary.
Richard M. Stallman <rms@gnu.org>
parents:
35188
diff
changeset
|
423 MS-Windows. |
24095 | 424 |
24723 | 425 @vindex printer-name @r{(MS-DOS)} |
24095 | 426 If you want to use your local printer, printing on it in the usual DOS |
24096
083c21910c49
(MS-DOS Printing): Rewrite section.
Andrew Innes <andrewi@gnu.org>
parents:
24095
diff
changeset
|
427 manner, then set the Lisp variable @code{lpr-command} to @code{""} (its |
083c21910c49
(MS-DOS Printing): Rewrite section.
Andrew Innes <andrewi@gnu.org>
parents:
24095
diff
changeset
|
428 default value) and @code{printer-name} to the name of the printer |
083c21910c49
(MS-DOS Printing): Rewrite section.
Andrew Innes <andrewi@gnu.org>
parents:
24095
diff
changeset
|
429 port---for example, @code{"PRN"}, the usual local printer port (that's |
083c21910c49
(MS-DOS Printing): Rewrite section.
Andrew Innes <andrewi@gnu.org>
parents:
24095
diff
changeset
|
430 the default), or @code{"LPT2"}, or @code{"COM1"} for a serial printer. |
083c21910c49
(MS-DOS Printing): Rewrite section.
Andrew Innes <andrewi@gnu.org>
parents:
24095
diff
changeset
|
431 You can also set @code{printer-name} to a file name, in which case |
083c21910c49
(MS-DOS Printing): Rewrite section.
Andrew Innes <andrewi@gnu.org>
parents:
24095
diff
changeset
|
432 ``printed'' output is actually appended to that file. If you set |
083c21910c49
(MS-DOS Printing): Rewrite section.
Andrew Innes <andrewi@gnu.org>
parents:
24095
diff
changeset
|
433 @code{printer-name} to @code{"NUL"}, printed output is silently |
24095 | 434 discarded (sent to the system null device). |
435 | |
24096
083c21910c49
(MS-DOS Printing): Rewrite section.
Andrew Innes <andrewi@gnu.org>
parents:
24095
diff
changeset
|
436 On MS-Windows, when the Windows network software is installed, you can |
083c21910c49
(MS-DOS Printing): Rewrite section.
Andrew Innes <andrewi@gnu.org>
parents:
24095
diff
changeset
|
437 also use a printer shared by another machine by setting |
083c21910c49
(MS-DOS Printing): Rewrite section.
Andrew Innes <andrewi@gnu.org>
parents:
24095
diff
changeset
|
438 @code{printer-name} to the UNC share name for that printer--for example, |
083c21910c49
(MS-DOS Printing): Rewrite section.
Andrew Innes <andrewi@gnu.org>
parents:
24095
diff
changeset
|
439 @code{"//joes_pc/hp4si"}. (It doesn't matter whether you use forward |
083c21910c49
(MS-DOS Printing): Rewrite section.
Andrew Innes <andrewi@gnu.org>
parents:
24095
diff
changeset
|
440 slashes or backslashes here.) To find out the names of shared printers, |
083c21910c49
(MS-DOS Printing): Rewrite section.
Andrew Innes <andrewi@gnu.org>
parents:
24095
diff
changeset
|
441 run the command @samp{net view} at a DOS command prompt to obtain a list |
24731 | 442 of servers, and @samp{net view @var{server-name}} to see the names of printers |
34293
4338fab68f06
Explain how to print on Windows to a printer that expecs DOS codepage
Eli Zaretskii <eliz@gnu.org>
parents:
34200
diff
changeset
|
443 (and directories) shared by that server. Alternatively, click the |
4338fab68f06
Explain how to print on Windows to a printer that expecs DOS codepage
Eli Zaretskii <eliz@gnu.org>
parents:
34200
diff
changeset
|
444 @samp{Network Neighborhood} icon on your desktop, and look for machines |
4338fab68f06
Explain how to print on Windows to a printer that expecs DOS codepage
Eli Zaretskii <eliz@gnu.org>
parents:
34200
diff
changeset
|
445 which share their printers via the network. |
4338fab68f06
Explain how to print on Windows to a printer that expecs DOS codepage
Eli Zaretskii <eliz@gnu.org>
parents:
34200
diff
changeset
|
446 |
36978
425c1d8cbbda
(MS-DOS Printing): Document the use of "net use" with networked printers.
Eli Zaretskii <eliz@gnu.org>
parents:
36169
diff
changeset
|
447 @cindex @samp{net use}, and printing on MS-Windows |
425c1d8cbbda
(MS-DOS Printing): Document the use of "net use" with networked printers.
Eli Zaretskii <eliz@gnu.org>
parents:
36169
diff
changeset
|
448 @cindex networked printers (MS-Windows) |
425c1d8cbbda
(MS-DOS Printing): Document the use of "net use" with networked printers.
Eli Zaretskii <eliz@gnu.org>
parents:
36169
diff
changeset
|
449 If the printer doesn't appear in the output of @samp{net view}, or |
425c1d8cbbda
(MS-DOS Printing): Document the use of "net use" with networked printers.
Eli Zaretskii <eliz@gnu.org>
parents:
36169
diff
changeset
|
450 if setting @code{printer-name} to the UNC share name doesn't produce a |
425c1d8cbbda
(MS-DOS Printing): Document the use of "net use" with networked printers.
Eli Zaretskii <eliz@gnu.org>
parents:
36169
diff
changeset
|
451 hardcopy on that printer, you can use the @samp{net use} command to |
425c1d8cbbda
(MS-DOS Printing): Document the use of "net use" with networked printers.
Eli Zaretskii <eliz@gnu.org>
parents:
36169
diff
changeset
|
452 connect a local print port such as @code{"LPT2"} to the networked |
425c1d8cbbda
(MS-DOS Printing): Document the use of "net use" with networked printers.
Eli Zaretskii <eliz@gnu.org>
parents:
36169
diff
changeset
|
453 printer. For example, typing @kbd{net use LPT2: |
425c1d8cbbda
(MS-DOS Printing): Document the use of "net use" with networked printers.
Eli Zaretskii <eliz@gnu.org>
parents:
36169
diff
changeset
|
454 \\joes_pc\hp4si}@footnote{ |
425c1d8cbbda
(MS-DOS Printing): Document the use of "net use" with networked printers.
Eli Zaretskii <eliz@gnu.org>
parents:
36169
diff
changeset
|
455 Note that the @samp{net use} command requires the UNC share name to be |
425c1d8cbbda
(MS-DOS Printing): Document the use of "net use" with networked printers.
Eli Zaretskii <eliz@gnu.org>
parents:
36169
diff
changeset
|
456 typed with the Windows-style backslashes, while the value of |
425c1d8cbbda
(MS-DOS Printing): Document the use of "net use" with networked printers.
Eli Zaretskii <eliz@gnu.org>
parents:
36169
diff
changeset
|
457 @code{printer-name} can be set with either forward- or backslashes.} |
425c1d8cbbda
(MS-DOS Printing): Document the use of "net use" with networked printers.
Eli Zaretskii <eliz@gnu.org>
parents:
36169
diff
changeset
|
458 causes Windows to @dfn{capture} the LPT2 port and redirect the printed |
425c1d8cbbda
(MS-DOS Printing): Document the use of "net use" with networked printers.
Eli Zaretskii <eliz@gnu.org>
parents:
36169
diff
changeset
|
459 material to the printer connected to the machine @code{joes_pc}. |
425c1d8cbbda
(MS-DOS Printing): Document the use of "net use" with networked printers.
Eli Zaretskii <eliz@gnu.org>
parents:
36169
diff
changeset
|
460 After this command, setting @code{printer-name} to @code{"LPT2"} |
37081 | 461 should produce the hardcopy on the networked printer. |
36978
425c1d8cbbda
(MS-DOS Printing): Document the use of "net use" with networked printers.
Eli Zaretskii <eliz@gnu.org>
parents:
36169
diff
changeset
|
462 |
38052
9408156a3159
(MS-DOS Printing): Mention that printer port can be redirected via
Eli Zaretskii <eliz@gnu.org>
parents:
37847
diff
changeset
|
463 With some varieties of Windows network software, you can instruct |
38788 | 464 Windows to capture a specific printer port such as @code{"LPT2"}, and |
38052
9408156a3159
(MS-DOS Printing): Mention that printer port can be redirected via
Eli Zaretskii <eliz@gnu.org>
parents:
37847
diff
changeset
|
465 redirect it to a networked printer via the @w{@code{Control |
9408156a3159
(MS-DOS Printing): Mention that printer port can be redirected via
Eli Zaretskii <eliz@gnu.org>
parents:
37847
diff
changeset
|
466 Panel->Printers}} applet instead of @samp{net use}. |
9408156a3159
(MS-DOS Printing): Mention that printer port can be redirected via
Eli Zaretskii <eliz@gnu.org>
parents:
37847
diff
changeset
|
467 |
34293
4338fab68f06
Explain how to print on Windows to a printer that expecs DOS codepage
Eli Zaretskii <eliz@gnu.org>
parents:
34200
diff
changeset
|
468 Some printers expect DOS codepage encoding of non-ASCII text, even |
4338fab68f06
Explain how to print on Windows to a printer that expecs DOS codepage
Eli Zaretskii <eliz@gnu.org>
parents:
34200
diff
changeset
|
469 though they are connected to a Windows machine which uses a different |
4338fab68f06
Explain how to print on Windows to a printer that expecs DOS codepage
Eli Zaretskii <eliz@gnu.org>
parents:
34200
diff
changeset
|
470 encoding for the same locale. For example, in the Latin-1 locale, DOS |
4338fab68f06
Explain how to print on Windows to a printer that expecs DOS codepage
Eli Zaretskii <eliz@gnu.org>
parents:
34200
diff
changeset
|
471 uses codepage 850 whereas Windows uses codepage 1252. @xref{MS-DOS and |
4338fab68f06
Explain how to print on Windows to a printer that expecs DOS codepage
Eli Zaretskii <eliz@gnu.org>
parents:
34200
diff
changeset
|
472 MULE}. When you print to such printers from Windows, you can use the |
4338fab68f06
Explain how to print on Windows to a printer that expecs DOS codepage
Eli Zaretskii <eliz@gnu.org>
parents:
34200
diff
changeset
|
473 @kbd{C-x RET c} (@code{universal-coding-system-argument}) command before |
4338fab68f06
Explain how to print on Windows to a printer that expecs DOS codepage
Eli Zaretskii <eliz@gnu.org>
parents:
34200
diff
changeset
|
474 @kbd{M-x lpr-buffer}; Emacs will then convert the text to the DOS |
4338fab68f06
Explain how to print on Windows to a printer that expecs DOS codepage
Eli Zaretskii <eliz@gnu.org>
parents:
34200
diff
changeset
|
475 codepage that you specify. For example, @kbd{C-x RET c cp850-dos RET |
4338fab68f06
Explain how to print on Windows to a printer that expecs DOS codepage
Eli Zaretskii <eliz@gnu.org>
parents:
34200
diff
changeset
|
476 M-x lpr-region RET} will print the region while converting it to the |
4338fab68f06
Explain how to print on Windows to a printer that expecs DOS codepage
Eli Zaretskii <eliz@gnu.org>
parents:
34200
diff
changeset
|
477 codepage 850 encoding. You may need to create the @code{cp@var{nnn}} |
4338fab68f06
Explain how to print on Windows to a printer that expecs DOS codepage
Eli Zaretskii <eliz@gnu.org>
parents:
34200
diff
changeset
|
478 coding system with @kbd{M-x codepage-setup}. |
24096
083c21910c49
(MS-DOS Printing): Rewrite section.
Andrew Innes <andrewi@gnu.org>
parents:
24095
diff
changeset
|
479 |
083c21910c49
(MS-DOS Printing): Rewrite section.
Andrew Innes <andrewi@gnu.org>
parents:
24095
diff
changeset
|
480 If you set @code{printer-name} to a file name, it's best to use an |
24095 | 481 absolute file name. Emacs changes the working directory according to |
482 the default directory of the current buffer, so if the file name in | |
24096
083c21910c49
(MS-DOS Printing): Rewrite section.
Andrew Innes <andrewi@gnu.org>
parents:
24095
diff
changeset
|
483 @code{printer-name} is relative, you will end up with several such |
083c21910c49
(MS-DOS Printing): Rewrite section.
Andrew Innes <andrewi@gnu.org>
parents:
24095
diff
changeset
|
484 files, each one in the directory of the buffer from which the printing |
083c21910c49
(MS-DOS Printing): Rewrite section.
Andrew Innes <andrewi@gnu.org>
parents:
24095
diff
changeset
|
485 was done. |
24095 | 486 |
487 @findex print-buffer @r{(MS-DOS)} | |
488 @findex print-region @r{(MS-DOS)} | |
489 @vindex lpr-headers-switches @r{(MS-DOS)} | |
490 The commands @code{print-buffer} and @code{print-region} call the | |
491 @code{pr} program, or use special switches to the @code{lpr} program, to | |
24096
083c21910c49
(MS-DOS Printing): Rewrite section.
Andrew Innes <andrewi@gnu.org>
parents:
24095
diff
changeset
|
492 produce headers on each printed page. MS-DOS and MS-Windows don't |
083c21910c49
(MS-DOS Printing): Rewrite section.
Andrew Innes <andrewi@gnu.org>
parents:
24095
diff
changeset
|
493 normally have these programs, so by default, the variable |
083c21910c49
(MS-DOS Printing): Rewrite section.
Andrew Innes <andrewi@gnu.org>
parents:
24095
diff
changeset
|
494 @code{lpr-headers-switches} is set so that the requests to print page |
083c21910c49
(MS-DOS Printing): Rewrite section.
Andrew Innes <andrewi@gnu.org>
parents:
24095
diff
changeset
|
495 headers are silently ignored. Thus, @code{print-buffer} and |
083c21910c49
(MS-DOS Printing): Rewrite section.
Andrew Innes <andrewi@gnu.org>
parents:
24095
diff
changeset
|
496 @code{print-region} produce the same output as @code{lpr-buffer} and |
083c21910c49
(MS-DOS Printing): Rewrite section.
Andrew Innes <andrewi@gnu.org>
parents:
24095
diff
changeset
|
497 @code{lpr-region}, respectively. If you do have a suitable @code{pr} |
083c21910c49
(MS-DOS Printing): Rewrite section.
Andrew Innes <andrewi@gnu.org>
parents:
24095
diff
changeset
|
498 program (for example, from GNU Textutils), set |
083c21910c49
(MS-DOS Printing): Rewrite section.
Andrew Innes <andrewi@gnu.org>
parents:
24095
diff
changeset
|
499 @code{lpr-headers-switches} to @code{nil}; Emacs will then call |
24095 | 500 @code{pr} to produce the page headers, and print the resulting output as |
24096
083c21910c49
(MS-DOS Printing): Rewrite section.
Andrew Innes <andrewi@gnu.org>
parents:
24095
diff
changeset
|
501 specified by @code{printer-name}. |
24095 | 502 |
503 @vindex print-region-function @r{(MS-DOS)} | |
504 @cindex lpr usage under MS-DOS | |
505 @vindex lpr-command @r{(MS-DOS)} | |
506 @vindex lpr-switches @r{(MS-DOS)} | |
24096
083c21910c49
(MS-DOS Printing): Rewrite section.
Andrew Innes <andrewi@gnu.org>
parents:
24095
diff
changeset
|
507 Finally, if you do have an @code{lpr} work-alike, you can set the |
083c21910c49
(MS-DOS Printing): Rewrite section.
Andrew Innes <andrewi@gnu.org>
parents:
24095
diff
changeset
|
508 variable @code{lpr-command} to @code{"lpr"}. Then Emacs will use |
083c21910c49
(MS-DOS Printing): Rewrite section.
Andrew Innes <andrewi@gnu.org>
parents:
24095
diff
changeset
|
509 @code{lpr} for printing, as on other systems. (If the name of the |
083c21910c49
(MS-DOS Printing): Rewrite section.
Andrew Innes <andrewi@gnu.org>
parents:
24095
diff
changeset
|
510 program isn't @code{lpr}, set @code{lpr-command} to specify where to |
083c21910c49
(MS-DOS Printing): Rewrite section.
Andrew Innes <andrewi@gnu.org>
parents:
24095
diff
changeset
|
511 find it.) The variable @code{lpr-switches} has its standard meaning |
083c21910c49
(MS-DOS Printing): Rewrite section.
Andrew Innes <andrewi@gnu.org>
parents:
24095
diff
changeset
|
512 when @code{lpr-command} is not @code{""}. If the variable |
083c21910c49
(MS-DOS Printing): Rewrite section.
Andrew Innes <andrewi@gnu.org>
parents:
24095
diff
changeset
|
513 @code{printer-name} has a string value, it is used as the value for the |
083c21910c49
(MS-DOS Printing): Rewrite section.
Andrew Innes <andrewi@gnu.org>
parents:
24095
diff
changeset
|
514 @code{-P} option to @code{lpr}, as on Unix. |
24095 | 515 |
516 @findex ps-print-buffer @r{(MS-DOS)} | |
517 @findex ps-spool-buffer @r{(MS-DOS)} | |
24715 | 518 @vindex ps-printer-name @r{(MS-DOS)} |
24095 | 519 @vindex ps-lpr-command @r{(MS-DOS)} |
520 @vindex ps-lpr-switches @r{(MS-DOS)} | |
24096
083c21910c49
(MS-DOS Printing): Rewrite section.
Andrew Innes <andrewi@gnu.org>
parents:
24095
diff
changeset
|
521 A parallel set of variables, @code{ps-lpr-command}, |
27213 | 522 @code{ps-lpr-switches}, and @code{ps-printer-name} (@pxref{PostScript |
24564 | 523 Variables}), defines how PostScript files should be printed. These |
24096
083c21910c49
(MS-DOS Printing): Rewrite section.
Andrew Innes <andrewi@gnu.org>
parents:
24095
diff
changeset
|
524 variables are used in the same way as the corresponding variables |
083c21910c49
(MS-DOS Printing): Rewrite section.
Andrew Innes <andrewi@gnu.org>
parents:
24095
diff
changeset
|
525 described above for non-PostScript printing. Thus, the value of |
083c21910c49
(MS-DOS Printing): Rewrite section.
Andrew Innes <andrewi@gnu.org>
parents:
24095
diff
changeset
|
526 @code{ps-printer-name} is used as the name of the device (or file) to |
083c21910c49
(MS-DOS Printing): Rewrite section.
Andrew Innes <andrewi@gnu.org>
parents:
24095
diff
changeset
|
527 which PostScript output is sent, just as @code{printer-name} is used for |
083c21910c49
(MS-DOS Printing): Rewrite section.
Andrew Innes <andrewi@gnu.org>
parents:
24095
diff
changeset
|
528 non-PostScript printing. (There are two distinct sets of variables in |
083c21910c49
(MS-DOS Printing): Rewrite section.
Andrew Innes <andrewi@gnu.org>
parents:
24095
diff
changeset
|
529 case you have two printers attached to two different ports, and only one |
083c21910c49
(MS-DOS Printing): Rewrite section.
Andrew Innes <andrewi@gnu.org>
parents:
24095
diff
changeset
|
530 of them is a PostScript printer.) |
083c21910c49
(MS-DOS Printing): Rewrite section.
Andrew Innes <andrewi@gnu.org>
parents:
24095
diff
changeset
|
531 |
083c21910c49
(MS-DOS Printing): Rewrite section.
Andrew Innes <andrewi@gnu.org>
parents:
24095
diff
changeset
|
532 The default value of the variable @code{ps-lpr-command} is @code{""}, |
083c21910c49
(MS-DOS Printing): Rewrite section.
Andrew Innes <andrewi@gnu.org>
parents:
24095
diff
changeset
|
533 which causes PostScript output to be sent to the printer port specified |
083c21910c49
(MS-DOS Printing): Rewrite section.
Andrew Innes <andrewi@gnu.org>
parents:
24095
diff
changeset
|
534 by @code{ps-printer-name}, but @code{ps-lpr-command} can also be set to |
083c21910c49
(MS-DOS Printing): Rewrite section.
Andrew Innes <andrewi@gnu.org>
parents:
24095
diff
changeset
|
535 the name of a program which will accept PostScript files. Thus, if you |
083c21910c49
(MS-DOS Printing): Rewrite section.
Andrew Innes <andrewi@gnu.org>
parents:
24095
diff
changeset
|
536 have a non-PostScript printer, you can set this variable to the name of |
083c21910c49
(MS-DOS Printing): Rewrite section.
Andrew Innes <andrewi@gnu.org>
parents:
24095
diff
changeset
|
537 a PostScript interpreter program (such as Ghostscript). Any switches |
083c21910c49
(MS-DOS Printing): Rewrite section.
Andrew Innes <andrewi@gnu.org>
parents:
24095
diff
changeset
|
538 that need to be passed to the interpreter program are specified using |
083c21910c49
(MS-DOS Printing): Rewrite section.
Andrew Innes <andrewi@gnu.org>
parents:
24095
diff
changeset
|
539 @code{ps-lpr-switches}. (If the value of @code{ps-printer-name} is a |
083c21910c49
(MS-DOS Printing): Rewrite section.
Andrew Innes <andrewi@gnu.org>
parents:
24095
diff
changeset
|
540 string, it will be added to the list of switches as the value for the |
083c21910c49
(MS-DOS Printing): Rewrite section.
Andrew Innes <andrewi@gnu.org>
parents:
24095
diff
changeset
|
541 @code{-P} option. This is probably only useful if you are using |
083c21910c49
(MS-DOS Printing): Rewrite section.
Andrew Innes <andrewi@gnu.org>
parents:
24095
diff
changeset
|
542 @code{lpr}, so when using an interpreter typically you would set |
083c21910c49
(MS-DOS Printing): Rewrite section.
Andrew Innes <andrewi@gnu.org>
parents:
24095
diff
changeset
|
543 @code{ps-printer-name} to something other than a string so it is |
083c21910c49
(MS-DOS Printing): Rewrite section.
Andrew Innes <andrewi@gnu.org>
parents:
24095
diff
changeset
|
544 ignored.) |
24095 | 545 |
546 For example, to use Ghostscript for printing on an Epson printer | |
24715 | 547 connected to the @samp{LPT2} port, put this in your @file{_emacs} file: |
24095 | 548 |
549 @example | |
24096
083c21910c49
(MS-DOS Printing): Rewrite section.
Andrew Innes <andrewi@gnu.org>
parents:
24095
diff
changeset
|
550 (setq ps-printer-name t) ; Ghostscript doesn't understand -P |
24095 | 551 (setq ps-lpr-command "c:/gs/gs386") |
552 (setq ps-lpr-switches '("-q" "-dNOPAUSE" | |
553 "-sDEVICE=epson" | |
554 "-r240x72" | |
555 "-sOutputFile=LPT2" | |
24096
083c21910c49
(MS-DOS Printing): Rewrite section.
Andrew Innes <andrewi@gnu.org>
parents:
24095
diff
changeset
|
556 "-Ic:/gs")) |
24095 | 557 @end example |
558 | |
559 @noindent | |
560 (This assumes that Ghostscript is installed in the @file{"c:/gs"} | |
561 directory.) | |
562 | |
24096
083c21910c49
(MS-DOS Printing): Rewrite section.
Andrew Innes <andrewi@gnu.org>
parents:
24095
diff
changeset
|
563 @vindex dos-printer |
083c21910c49
(MS-DOS Printing): Rewrite section.
Andrew Innes <andrewi@gnu.org>
parents:
24095
diff
changeset
|
564 @vindex dos-ps-printer |
083c21910c49
(MS-DOS Printing): Rewrite section.
Andrew Innes <andrewi@gnu.org>
parents:
24095
diff
changeset
|
565 For backwards compatibility, the value of @code{dos-printer} |
083c21910c49
(MS-DOS Printing): Rewrite section.
Andrew Innes <andrewi@gnu.org>
parents:
24095
diff
changeset
|
566 (@code{dos-ps-printer}), if it has a value, overrides the value of |
083c21910c49
(MS-DOS Printing): Rewrite section.
Andrew Innes <andrewi@gnu.org>
parents:
24095
diff
changeset
|
567 @code{printer-name} (@code{ps-printer-name}), on MS-DOS and MS-Windows |
083c21910c49
(MS-DOS Printing): Rewrite section.
Andrew Innes <andrewi@gnu.org>
parents:
24095
diff
changeset
|
568 only. |
083c21910c49
(MS-DOS Printing): Rewrite section.
Andrew Innes <andrewi@gnu.org>
parents:
24095
diff
changeset
|
569 |
083c21910c49
(MS-DOS Printing): Rewrite section.
Andrew Innes <andrewi@gnu.org>
parents:
24095
diff
changeset
|
570 |
24095 | 571 @node MS-DOS and MULE |
572 @section International Support on MS-DOS | |
573 @cindex international support @r{(MS-DOS)} | |
574 | |
575 Emacs on MS-DOS supports the same international character sets as it | |
38865
62e02f5ae533
Avoid saying "Unix" in a way that includes GNU.
Richard M. Stallman <rms@gnu.org>
parents:
38788
diff
changeset
|
576 does on GNU, Unix and other platforms (@pxref{International}), including |
24095 | 577 coding systems for converting between the different character sets. |
38865
62e02f5ae533
Avoid saying "Unix" in a way that includes GNU.
Richard M. Stallman <rms@gnu.org>
parents:
38788
diff
changeset
|
578 However, due to incompatibilities between MS-DOS/MS-Windows and other systems, |
62e02f5ae533
Avoid saying "Unix" in a way that includes GNU.
Richard M. Stallman <rms@gnu.org>
parents:
38788
diff
changeset
|
579 there are several DOS-specific aspects of this support that you should |
24095 | 580 be aware of. This section describes these aspects. |
581 | |
582 @table @kbd | |
583 @item M-x dos-codepage-setup | |
584 Set up Emacs display and coding systems as appropriate for the current | |
585 DOS codepage. | |
586 | |
587 @item M-x codepage-setup | |
588 Create a coding system for a certain DOS codepage. | |
589 @end table | |
590 | |
591 @cindex codepage, MS-DOS | |
592 @cindex DOS codepages | |
593 MS-DOS is designed to support one character set of 256 characters at | |
594 any given time, but gives you a variety of character sets to choose | |
595 from. The alternative character sets are known as @dfn{DOS codepages}. | |
596 Each codepage includes all 128 ASCII characters, but the other 128 | |
597 characters (codes 128 through 255) vary from one codepage to another. | |
598 Each DOS codepage is identified by a 3-digit number, such as 850, 862, | |
599 etc. | |
600 | |
35188
94d46968a93f
Don't say "X Windows". From Colin Walters <walters@cis.ohio-state.edu>.
Eli Zaretskii <eliz@gnu.org>
parents:
34293
diff
changeset
|
601 In contrast to X, which lets you use several fonts at the same time, |
37264
ff4c34a90065
(MS-DOS and MULE): Make the wording about a single-codepage-until-reboot
Eli Zaretskii <eliz@gnu.org>
parents:
37244
diff
changeset
|
602 MS-DOS normally doesn't allow use of several codepages in a single |
ff4c34a90065
(MS-DOS and MULE): Make the wording about a single-codepage-until-reboot
Eli Zaretskii <eliz@gnu.org>
parents:
37244
diff
changeset
|
603 session. MS-DOS was designed to load a single codepage at system |
ff4c34a90065
(MS-DOS and MULE): Make the wording about a single-codepage-until-reboot
Eli Zaretskii <eliz@gnu.org>
parents:
37244
diff
changeset
|
604 startup, and require you to reboot in order to change |
ff4c34a90065
(MS-DOS and MULE): Make the wording about a single-codepage-until-reboot
Eli Zaretskii <eliz@gnu.org>
parents:
37244
diff
changeset
|
605 it@footnote{Normally, one particular codepage is burnt into the display |
ff4c34a90065
(MS-DOS and MULE): Make the wording about a single-codepage-until-reboot
Eli Zaretskii <eliz@gnu.org>
parents:
37244
diff
changeset
|
606 memory, while other codepages can be installed by modifying system |
ff4c34a90065
(MS-DOS and MULE): Make the wording about a single-codepage-until-reboot
Eli Zaretskii <eliz@gnu.org>
parents:
37244
diff
changeset
|
607 configuration files, such as @file{CONFIG.SYS}, and rebooting. While |
ff4c34a90065
(MS-DOS and MULE): Make the wording about a single-codepage-until-reboot
Eli Zaretskii <eliz@gnu.org>
parents:
37244
diff
changeset
|
608 third-party software is known to exist that allows to change the |
ff4c34a90065
(MS-DOS and MULE): Make the wording about a single-codepage-until-reboot
Eli Zaretskii <eliz@gnu.org>
parents:
37244
diff
changeset
|
609 codepage without rebooting, we describe here how a stock MS-DOS system |
ff4c34a90065
(MS-DOS and MULE): Make the wording about a single-codepage-until-reboot
Eli Zaretskii <eliz@gnu.org>
parents:
37244
diff
changeset
|
610 behaves.}. Much the same limitation applies when you run DOS |
24095 | 611 executables on other systems such as MS-Windows. |
612 | |
613 @cindex unibyte operation @r{(MS-DOS)} | |
614 If you invoke Emacs on MS-DOS with the @samp{--unibyte} option | |
615 (@pxref{Initial Options}), Emacs does not perform any conversion of | |
616 non-ASCII characters. Instead, it reads and writes any non-ASCII | |
617 characters verbatim, and sends their 8-bit codes to the display | |
618 verbatim. Thus, unibyte Emacs on MS-DOS supports the current codepage, | |
619 whatever it may be, but cannot even represent any other characters. | |
620 | |
621 @vindex dos-codepage | |
622 For multibyte operation on MS-DOS, Emacs needs to know which | |
623 characters the chosen DOS codepage can display. So it queries the | |
624 system shortly after startup to get the chosen codepage number, and | |
625 stores the number in the variable @code{dos-codepage}. Some systems | |
626 return the default value 437 for the current codepage, even though the | |
627 actual codepage is different. (This typically happens when you use the | |
628 codepage built into the display hardware.) You can specify a different | |
629 codepage for Emacs to use by setting the variable @code{dos-codepage} in | |
630 your init file. | |
631 | |
632 @cindex language environment, automatic selection on @r{MS-DOS} | |
24615
393b5f9a3631
Fix wording for the last change.
Eli Zaretskii <eliz@gnu.org>
parents:
24594
diff
changeset
|
633 Multibyte Emacs supports only certain DOS codepages: those which can |
24594
2105eae5069b
Describe Far-Eastern DOS terminal support.
Eli Zaretskii <eliz@gnu.org>
parents:
24564
diff
changeset
|
634 display Far-Eastern scripts, like the Japanese codepage 932, and those |
2105eae5069b
Describe Far-Eastern DOS terminal support.
Eli Zaretskii <eliz@gnu.org>
parents:
24564
diff
changeset
|
635 that encode a single ISO 8859 character set. |
2105eae5069b
Describe Far-Eastern DOS terminal support.
Eli Zaretskii <eliz@gnu.org>
parents:
24564
diff
changeset
|
636 |
2105eae5069b
Describe Far-Eastern DOS terminal support.
Eli Zaretskii <eliz@gnu.org>
parents:
24564
diff
changeset
|
637 The Far-Eastern codepages can directly display one of the MULE |
2105eae5069b
Describe Far-Eastern DOS terminal support.
Eli Zaretskii <eliz@gnu.org>
parents:
24564
diff
changeset
|
638 character sets for these countries, so Emacs simply sets up to use the |
2105eae5069b
Describe Far-Eastern DOS terminal support.
Eli Zaretskii <eliz@gnu.org>
parents:
24564
diff
changeset
|
639 appropriate terminal coding system that is supported by the codepage. |
2105eae5069b
Describe Far-Eastern DOS terminal support.
Eli Zaretskii <eliz@gnu.org>
parents:
24564
diff
changeset
|
640 The special features described in the rest of this section mostly |
2105eae5069b
Describe Far-Eastern DOS terminal support.
Eli Zaretskii <eliz@gnu.org>
parents:
24564
diff
changeset
|
641 pertain to codepages that encode ISO 8859 character sets. |
2105eae5069b
Describe Far-Eastern DOS terminal support.
Eli Zaretskii <eliz@gnu.org>
parents:
24564
diff
changeset
|
642 |
2105eae5069b
Describe Far-Eastern DOS terminal support.
Eli Zaretskii <eliz@gnu.org>
parents:
24564
diff
changeset
|
643 For the codepages which correspond to one of the ISO character sets, |
24615
393b5f9a3631
Fix wording for the last change.
Eli Zaretskii <eliz@gnu.org>
parents:
24594
diff
changeset
|
644 Emacs knows the character set name based on the codepage number. Emacs |
393b5f9a3631
Fix wording for the last change.
Eli Zaretskii <eliz@gnu.org>
parents:
24594
diff
changeset
|
645 automatically creates a coding system to support reading and writing |
393b5f9a3631
Fix wording for the last change.
Eli Zaretskii <eliz@gnu.org>
parents:
24594
diff
changeset
|
646 files that use the current codepage, and uses this coding system by |
393b5f9a3631
Fix wording for the last change.
Eli Zaretskii <eliz@gnu.org>
parents:
24594
diff
changeset
|
647 default. The name of this coding system is @code{cp@var{nnn}}, where |
393b5f9a3631
Fix wording for the last change.
Eli Zaretskii <eliz@gnu.org>
parents:
24594
diff
changeset
|
648 @var{nnn} is the codepage number.@footnote{The standard Emacs coding |
393b5f9a3631
Fix wording for the last change.
Eli Zaretskii <eliz@gnu.org>
parents:
24594
diff
changeset
|
649 systems for ISO 8859 are not quite right for the purpose, because |
393b5f9a3631
Fix wording for the last change.
Eli Zaretskii <eliz@gnu.org>
parents:
24594
diff
changeset
|
650 typically the DOS codepage does not match the standard ISO character |
393b5f9a3631
Fix wording for the last change.
Eli Zaretskii <eliz@gnu.org>
parents:
24594
diff
changeset
|
651 codes. For example, the letter @samp{@,{c}} (@samp{c} with cedilla) has |
393b5f9a3631
Fix wording for the last change.
Eli Zaretskii <eliz@gnu.org>
parents:
24594
diff
changeset
|
652 code 231 in the standard Latin-1 character set, but the corresponding |
393b5f9a3631
Fix wording for the last change.
Eli Zaretskii <eliz@gnu.org>
parents:
24594
diff
changeset
|
653 DOS codepage 850 uses code 135 for this glyph.} |
24095 | 654 |
655 @cindex mode line @r{(MS-DOS)} | |
656 All the @code{cp@var{nnn}} coding systems use the letter @samp{D} (for | |
657 ``DOS'') as their mode-line mnemonic. Since both the terminal coding | |
658 system and the default coding system for file I/O are set to the proper | |
659 @code{cp@var{nnn}} coding system at startup, it is normal for the mode | |
660 line on MS-DOS to begin with @samp{-DD\-}. @xref{Mode Line}. | |
24594
2105eae5069b
Describe Far-Eastern DOS terminal support.
Eli Zaretskii <eliz@gnu.org>
parents:
24564
diff
changeset
|
661 Far-Eastern DOS terminals do not use the @code{cp@var{nnn}} coding |
38865
62e02f5ae533
Avoid saying "Unix" in a way that includes GNU.
Richard M. Stallman <rms@gnu.org>
parents:
38788
diff
changeset
|
662 systems, and thus their initial mode line looks like the Emacs default. |
24095 | 663 |
664 Since the codepage number also indicates which script you are using, | |
665 Emacs automatically runs @code{set-language-environment} to select the | |
666 language environment for that script (@pxref{Language Environments}). | |
667 | |
668 If a buffer contains a character belonging to some other ISO 8859 | |
669 character set, not the one that the chosen DOS codepage supports, Emacs | |
670 displays it using a sequence of ASCII characters. For example, if the | |
671 current codepage doesn't have a glyph for the letter @samp{@`o} (small | |
672 @samp{o} with a grave accent), it is displayed as @samp{@{`o@}}, where | |
673 the braces serve as a visual indication that this is a single character. | |
674 (This may look awkward for some non-Latin characters, such as those from | |
675 Greek or Hebrew alphabets, but it is still readable by a person who | |
676 knows the language.) Even though the character may occupy several | |
677 columns on the screen, it is really still just a single character, and | |
678 all Emacs commands treat it as one. | |
679 | |
37244
c1ad9d98c553
(MS-DOS and MULE): IBM graphics characters are no longer displayed
Eli Zaretskii <eliz@gnu.org>
parents:
37081
diff
changeset
|
680 @cindex IBM graphics characters (MS-DOS) |
c1ad9d98c553
(MS-DOS and MULE): IBM graphics characters are no longer displayed
Eli Zaretskii <eliz@gnu.org>
parents:
37081
diff
changeset
|
681 @cindex box-drawing characters (MS-DOS) |
c1ad9d98c553
(MS-DOS and MULE): IBM graphics characters are no longer displayed
Eli Zaretskii <eliz@gnu.org>
parents:
37081
diff
changeset
|
682 @cindex line-drawing characters (MS-DOS) |
24095 | 683 Not all characters in DOS codepages correspond to ISO 8859 |
684 characters---some are used for other purposes, such as box-drawing | |
37244
c1ad9d98c553
(MS-DOS and MULE): IBM graphics characters are no longer displayed
Eli Zaretskii <eliz@gnu.org>
parents:
37081
diff
changeset
|
685 characters and other graphics. Emacs maps these characters to two |
c1ad9d98c553
(MS-DOS and MULE): IBM graphics characters are no longer displayed
Eli Zaretskii <eliz@gnu.org>
parents:
37081
diff
changeset
|
686 special character sets called @code{eight-bit-control} and |
c1ad9d98c553
(MS-DOS and MULE): IBM graphics characters are no longer displayed
Eli Zaretskii <eliz@gnu.org>
parents:
37081
diff
changeset
|
687 @code{eight-bit-graphic}, and displays them as their IBM glyphs. |
c1ad9d98c553
(MS-DOS and MULE): IBM graphics characters are no longer displayed
Eli Zaretskii <eliz@gnu.org>
parents:
37081
diff
changeset
|
688 However, you should be aware that other systems might display these |
c1ad9d98c553
(MS-DOS and MULE): IBM graphics characters are no longer displayed
Eli Zaretskii <eliz@gnu.org>
parents:
37081
diff
changeset
|
689 characters differently, so you should avoid them in text that might be |
c1ad9d98c553
(MS-DOS and MULE): IBM graphics characters are no longer displayed
Eli Zaretskii <eliz@gnu.org>
parents:
37081
diff
changeset
|
690 copied to a different operating system, or even to another DOS machine |
c1ad9d98c553
(MS-DOS and MULE): IBM graphics characters are no longer displayed
Eli Zaretskii <eliz@gnu.org>
parents:
37081
diff
changeset
|
691 that uses a different codepage. |
24095 | 692 |
37244
c1ad9d98c553
(MS-DOS and MULE): IBM graphics characters are no longer displayed
Eli Zaretskii <eliz@gnu.org>
parents:
37081
diff
changeset
|
693 @vindex dos-unsupported-character-glyph |
24095 | 694 Emacs supports many other characters sets aside from ISO 8859, but it |
695 cannot display them on MS-DOS. So if one of these multibyte characters | |
24113
fd1968847853
(MS-DOS and MULE): dos-unsupported-character-glyph is
Eli Zaretskii <eliz@gnu.org>
parents:
24096
diff
changeset
|
696 appears in a buffer, Emacs on MS-DOS displays them as specified by the |
fd1968847853
(MS-DOS and MULE): dos-unsupported-character-glyph is
Eli Zaretskii <eliz@gnu.org>
parents:
24096
diff
changeset
|
697 @code{dos-unsupported-character-glyph} variable; by default, this glyph |
fd1968847853
(MS-DOS and MULE): dos-unsupported-character-glyph is
Eli Zaretskii <eliz@gnu.org>
parents:
24096
diff
changeset
|
698 is an empty triangle. Use the @kbd{C-u C-x =} command to display the |
fd1968847853
(MS-DOS and MULE): dos-unsupported-character-glyph is
Eli Zaretskii <eliz@gnu.org>
parents:
24096
diff
changeset
|
699 actual code and character set of such characters. @xref{Position Info}. |
24095 | 700 |
701 @findex codepage-setup | |
702 By default, Emacs defines a coding system to support the current | |
703 codepage. To define a coding system for some other codepage (e.g., to | |
704 visit a file written on a DOS machine in another country), use the | |
705 @kbd{M-x codepage-setup} command. It prompts for the 3-digit code of | |
706 the codepage, with completion, then creates the coding system for the | |
707 specified codepage. You can then use the new coding system to read and | |
708 write files, but you must specify it explicitly for the file command | |
709 when you want to use it (@pxref{Specify Coding}). | |
710 | |
711 These coding systems are also useful for visiting a file encoded using | |
712 a DOS codepage, using Emacs running on some other operating system. | |
713 | |
34293
4338fab68f06
Explain how to print on Windows to a printer that expecs DOS codepage
Eli Zaretskii <eliz@gnu.org>
parents:
34200
diff
changeset
|
714 @cindex MS-Windows codepages |
36169
86e871a073b6
Delete find-file-text and find-file-binary.
Richard M. Stallman <rms@gnu.org>
parents:
35188
diff
changeset
|
715 MS-Windows provides its own codepages, which are different from the |
34293
4338fab68f06
Explain how to print on Windows to a printer that expecs DOS codepage
Eli Zaretskii <eliz@gnu.org>
parents:
34200
diff
changeset
|
716 DOS codepages for the same locale. For example, DOS codepage 850 |
4338fab68f06
Explain how to print on Windows to a printer that expecs DOS codepage
Eli Zaretskii <eliz@gnu.org>
parents:
34200
diff
changeset
|
717 supports the same character set as Windows codepage 1252; DOS codepage |
4338fab68f06
Explain how to print on Windows to a printer that expecs DOS codepage
Eli Zaretskii <eliz@gnu.org>
parents:
34200
diff
changeset
|
718 855 supports the same character set as Windows codepage 1251, etc. |
4338fab68f06
Explain how to print on Windows to a printer that expecs DOS codepage
Eli Zaretskii <eliz@gnu.org>
parents:
34200
diff
changeset
|
719 The MS-Windows version of Emacs uses the current codepage for display |
4338fab68f06
Explain how to print on Windows to a printer that expecs DOS codepage
Eli Zaretskii <eliz@gnu.org>
parents:
34200
diff
changeset
|
720 when invoked with the @samp{-nw} option. |
4338fab68f06
Explain how to print on Windows to a printer that expecs DOS codepage
Eli Zaretskii <eliz@gnu.org>
parents:
34200
diff
changeset
|
721 |
24095 | 722 @node MS-DOS Processes |
723 @section Subprocesses on MS-DOS | |
724 | |
725 @cindex compilation under MS-DOS | |
726 @cindex inferior processes under MS-DOS | |
727 @findex compile @r{(MS-DOS)} | |
728 @findex grep @r{(MS-DOS)} | |
729 Because MS-DOS is a single-process ``operating system,'' | |
730 asynchronous subprocesses are not available. In particular, Shell | |
731 mode and its variants do not work. Most Emacs features that use | |
732 asynchronous subprocesses also don't work on MS-DOS, including | |
31060
d24cddac1e33
Document that ispell works, and mention Eshell as an alternative
Eli Zaretskii <eliz@gnu.org>
parents:
31057
diff
changeset
|
733 Shell mode and GUD. When in doubt, try and see; commands that |
38869
8be184904f6c
Don't use "print" for displaying a message.
Richard M. Stallman <rms@gnu.org>
parents:
38865
diff
changeset
|
734 don't work output an error message saying that asynchronous processes |
24095 | 735 aren't supported. |
736 | |
737 Compilation under Emacs with @kbd{M-x compile}, searching files with | |
738 @kbd{M-x grep} and displaying differences between files with @kbd{M-x | |
739 diff} do work, by running the inferior processes synchronously. This | |
740 means you cannot do any more editing until the inferior process | |
741 finishes. | |
742 | |
31060
d24cddac1e33
Document that ispell works, and mention Eshell as an alternative
Eli Zaretskii <eliz@gnu.org>
parents:
31057
diff
changeset
|
743 Spell checking also works, by means of special support for synchronous |
d24cddac1e33
Document that ispell works, and mention Eshell as an alternative
Eli Zaretskii <eliz@gnu.org>
parents:
31057
diff
changeset
|
744 invocation of the @code{ispell} program. This is slower than the |
38865
62e02f5ae533
Avoid saying "Unix" in a way that includes GNU.
Richard M. Stallman <rms@gnu.org>
parents:
38788
diff
changeset
|
745 asynchronous invocation on other platforms |
31060
d24cddac1e33
Document that ispell works, and mention Eshell as an alternative
Eli Zaretskii <eliz@gnu.org>
parents:
31057
diff
changeset
|
746 |
d24cddac1e33
Document that ispell works, and mention Eshell as an alternative
Eli Zaretskii <eliz@gnu.org>
parents:
31057
diff
changeset
|
747 Instead of the Shell mode, which doesn't work on MS-DOS, you can use |
d24cddac1e33
Document that ispell works, and mention Eshell as an alternative
Eli Zaretskii <eliz@gnu.org>
parents:
31057
diff
changeset
|
748 the @kbd{M-x eshell} command. This invokes the Eshell package that |
38865
62e02f5ae533
Avoid saying "Unix" in a way that includes GNU.
Richard M. Stallman <rms@gnu.org>
parents:
38788
diff
changeset
|
749 implements a Posix-like shell entirely in Emacs Lisp. |
31060
d24cddac1e33
Document that ispell works, and mention Eshell as an alternative
Eli Zaretskii <eliz@gnu.org>
parents:
31057
diff
changeset
|
750 |
24095 | 751 By contrast, Emacs compiled as native Windows application |
752 @strong{does} support asynchronous subprocesses. @xref{Windows | |
753 Processes}. | |
754 | |
755 @cindex printing under MS-DOS | |
756 Printing commands, such as @code{lpr-buffer} (@pxref{Hardcopy}) and | |
27213 | 757 @code{ps-print-buffer} (@pxref{PostScript}), work in MS-DOS by sending |
24095 | 758 the output to one of the printer ports. @xref{MS-DOS Printing}. |
759 | |
760 When you run a subprocess synchronously on MS-DOS, make sure the | |
761 program terminates and does not try to read keyboard input. If the | |
762 program does not terminate on its own, you will be unable to terminate | |
763 it, because MS-DOS provides no general way to terminate a process. | |
764 Pressing @kbd{C-c} or @kbd{C-@key{BREAK}} might sometimes help in these | |
765 cases. | |
766 | |
767 Accessing files on other machines is not supported on MS-DOS. Other | |
768 network-oriented commands such as sending mail, Web browsing, remote | |
769 login, etc., don't work either, unless network access is built into | |
770 MS-DOS with some network redirector. | |
771 | |
772 @cindex directory listing on MS-DOS | |
773 @vindex dired-listing-switches @r{(MS-DOS)} | |
774 Dired on MS-DOS uses the @code{ls-lisp} package where other | |
775 platforms use the system @code{ls} command. Therefore, Dired on | |
776 MS-DOS supports only some of the possible options you can mention in | |
777 the @code{dired-listing-switches} variable. The options that work are | |
778 @samp{-A}, @samp{-a}, @samp{-c}, @samp{-i}, @samp{-r}, @samp{-S}, | |
779 @samp{-s}, @samp{-t}, and @samp{-u}. | |
780 | |
781 @node Windows Processes | |
39142
449f9371ac14
Mention Windows ME and Windows 2000 in the list of supported versions.
Eli Zaretskii <eliz@gnu.org>
parents:
38869
diff
changeset
|
782 @section Subprocesses on Windows 9X/ME and Windows NT/2K |
24095 | 783 |
784 Emacs compiled as a native Windows application (as opposed to the DOS | |
785 version) includes full support for asynchronous subprocesses. | |
786 In the Windows version, synchronous and asynchronous subprocesses work | |
787 fine on both | |
39142
449f9371ac14
Mention Windows ME and Windows 2000 in the list of supported versions.
Eli Zaretskii <eliz@gnu.org>
parents:
38869
diff
changeset
|
788 Windows 9X and Windows NT/2K as long as you run only 32-bit Windows |
24095 | 789 applications. However, when you run a DOS application in a subprocess, |
790 you may encounter problems or be unable to run the application at all; | |
791 and if you run two DOS applications at the same time in two | |
792 subprocesses, you may have to reboot your system. | |
793 | |
794 Since the standard command interpreter (and most command line utilities) | |
795 on Windows 95 are DOS applications, these problems are significant when | |
796 using that system. But there's nothing we can do about them; only | |
797 Microsoft can fix them. | |
798 | |
799 If you run just one DOS application subprocess, the subprocess should | |
800 work as expected as long as it is ``well-behaved'' and does not perform | |
801 direct screen access or other unusual actions. If you have a CPU | |
802 monitor application, your machine will appear to be 100% busy even when | |
803 the DOS application is idle, but this is only an artifact of the way CPU | |
804 monitors measure processor load. | |
805 | |
806 You must terminate the DOS application before you start any other DOS | |
807 application in a different subprocess. Emacs is unable to interrupt or | |
808 terminate a DOS subprocess. The only way you can terminate such a | |
809 subprocess is by giving it a command that tells its program to exit. | |
810 | |
811 If you attempt to run two DOS applications at the same time in separate | |
812 subprocesses, the second one that is started will be suspended until the | |
813 first one finishes, even if either or both of them are asynchronous. | |
814 | |
815 If you can go to the first subprocess, and tell it to exit, the second | |
816 subprocess should continue normally. However, if the second subprocess | |
817 is synchronous, Emacs itself will be hung until the first subprocess | |
818 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
|
819 choice but to reboot if you are running on Windows 9X. If you are |
449f9371ac14
Mention Windows ME and Windows 2000 in the list of supported versions.
Eli Zaretskii <eliz@gnu.org>
parents:
38869
diff
changeset
|
820 running on Windows NT/2K, you can use a process viewer application to kill |
24095 | 821 the appropriate instance of ntvdm instead (this will terminate both DOS |
822 subprocesses). | |
823 | |
39142
449f9371ac14
Mention Windows ME and Windows 2000 in the list of supported versions.
Eli Zaretskii <eliz@gnu.org>
parents:
38869
diff
changeset
|
824 If you have to reboot Windows 9X in this situation, do not use the |
24095 | 825 @code{Shutdown} command on the @code{Start} menu; that usually hangs the |
826 system. Instead, type @kbd{CTL-ALT-@key{DEL}} and then choose | |
827 @code{Shutdown}. That usually works, although it may take a few minutes | |
828 to do its job. | |
829 | |
830 @node Windows System Menu | |
831 @section Using the System Menu on Windows | |
832 | |
833 Emacs compiled as a native Windows application normally turns off the | |
834 Windows feature that tapping the @key{ALT} | |
835 key invokes the Windows menu. The reason is that the @key{ALT} also | |
836 serves as @key{META} in Emacs. When using Emacs, users often press the | |
837 @key{META} key temporarily and then change their minds; if this has the | |
838 effect of bringing up the Windows menu, it alters the meaning of | |
839 subsequent commands. Many users find this frustrating. | |
840 | |
841 @vindex w32-pass-alt-to-system | |
842 You can reenable Windows's default handling of tapping the @key{ALT} key | |
843 by setting @code{w32-pass-alt-to-system} to a non-@code{nil} value. | |
844 |