aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorRichard M. Stallman2001-02-17 17:52:52 +0000
committerRichard M. Stallman2001-02-17 17:52:52 +0000
commit8e375db276c58f0d54d169bcb8b78911bf31e2fd (patch)
treea10409fde01576b452410929a9df1b39cc269976
parentdf9d7630f46e4011be1227836c183082964f118f (diff)
downloademacs-8e375db276c58f0d54d169bcb8b78911bf31e2fd.tar.gz
emacs-8e375db276c58f0d54d169bcb8b78911bf31e2fd.zip
Delete find-file-text and find-file-binary.
Misc cleanups.
-rw-r--r--man/msdog.texi128
1 files changed, 53 insertions, 75 deletions
diff --git a/man/msdog.texi b/man/msdog.texi
index fcc83810ce7..099686215de 100644
--- a/man/msdog.texi
+++ b/man/msdog.texi
@@ -105,19 +105,17 @@ supported.
105@cindex mouse, set number of buttons 105@cindex mouse, set number of buttons
106@findex msdos-set-mouse-buttons 106@findex msdos-set-mouse-buttons
107 Some versions of mouse drivers don't report the number of mouse 107 Some versions of mouse drivers don't report the number of mouse
108buttons correctly. For example, mice with a wheel report that they have 108buttons correctly. For example, mice with a wheel report that they
1093 buttons, but only 2 of them are passed to Emacs; the clicks on the 109have 3 buttons, but only 2 of them are passed to Emacs; the clicks on
110wheel, which serves as the middle button, are not passed. In these 110the wheel, which serves as the middle button, are not passed. In
111cases, you can use the @kbd{M-x msdos-set-mouse-buttons} command to set 111these cases, you can use the @kbd{M-x msdos-set-mouse-buttons} command
112the notion of number of buttons used by Emacs. This command prompts for 112to tell Emacs how many mouse buttons to expect. You could make such a
113the number of buttons, and forces Emacs to behave as if your mouse had 113setting permanent by adding this fragment to your @file{_emacs} init
114that number of buttons. You could make such a setting permanent by 114file:
115adding this fragment to your @file{_emacs} init file:
116 115
117@example 116@example
118 ;; Force Emacs to behave as if the mouse had 117;; @r{Treat the mouse like a 2-button mouse.}
119 ;; only 2 buttons 118(msdos-set-mouse-buttons 2)
120 (msdos-set-mouse-buttons 2)
121@end example 119@end example
122 120
123@cindex Windows clipboard support 121@cindex Windows clipboard support
@@ -167,15 +165,15 @@ native font built into the DOS display.
167 165
168@cindex cursor shape on MS-DOS 166@cindex cursor shape on MS-DOS
169 When Emacs starts, it changes the cursor shape to a solid box. This 167 When Emacs starts, it changes the cursor shape to a solid box. This
170is for compatibility with the Unix version, where the box cursor is the 168is for compatibility with other systems, where the box cursor is the
171default. This default shape can be changed to a bar by specifying the 169default in Emacs. This default shape can be changed to a bar by
172@code{cursor-type} parameter in the variable @code{default-frame-alist} 170specifying the @code{cursor-type} parameter in the variable
173(@pxref{Creating Frames}). The MS-DOS terminal doesn't support a 171@code{default-frame-alist} (@pxref{Creating Frames}). The MS-DOS
174vertical-bar cursor, so the bar cursor is horizontal, and the 172terminal doesn't support a vertical-bar cursor, so the bar cursor is
175@code{@var{width}} parameter, if specified by the frame parameters, 173horizontal, and the @code{@var{width}} parameter, if specified by the
176actually determines its height. As an extension, the bar cursor 174frame parameters, actually determines its height. As an extension,
177specification can include the starting scan line of the cursor as well 175the bar cursor specification can include the starting scan line of the
178as its width, like this: 176cursor as well as its width, like this:
179 177
180@example 178@example
181 '(cursor-type bar @var{width} . @var{start}) 179 '(cursor-type bar @var{width} . @var{start})
@@ -186,12 +184,12 @@ In addition, if the @var{width} parameter is negative, the cursor bar
186begins at the top of the character cell. 184begins at the top of the character cell.
187 185
188@cindex frames on MS-DOS 186@cindex frames on MS-DOS
189 Multiple frames (@pxref{Frames}) are supported on MS-DOS, but they all 187 The MS-DOS terminal can only display a single frame at a time. The
190overlap, so you only see a single frame at any given moment. That 188Emacs frame facilities work on MS-DOS much as they do on text-only
191single visible frame occupies the entire screen. When you run Emacs 189terminals (@pxref{Frames}). When you run Emacs from a DOS window on
192from MS-Windows DOS box, you can make the visible frame smaller than 190MS-Windows, you can make the visible frame smaller than the full
193the full screen, but Emacs still cannot display more than a single 191screen, but Emacs still cannot display more than a single frame at a
194frame at a time. 192time.
195 193
196@cindex frame size under MS-DOS 194@cindex frame size under MS-DOS
197@findex mode4350 195@findex mode4350
@@ -287,9 +285,9 @@ environment variable. That is, if your Emacs binary,
287Emacs acts as if @env{HOME} were set to @samp{c:/utils/emacs}. In 285Emacs acts as if @env{HOME} were set to @samp{c:/utils/emacs}. In
288particular, that is where Emacs looks for the init file @file{_emacs}. 286particular, that is where Emacs looks for the init file @file{_emacs}.
289With this in mind, you can use @samp{~} in file names as an alias for 287With this in mind, you can use @samp{~} in file names as an alias for
290the home directory, as you would in Unix. You can also set @env{HOME} 288the home directory, as you would on GNU or Unix. You can also set
291variable in the environment before starting Emacs; its value will then 289@env{HOME} variable in the environment before starting Emacs; its
292override the above default behavior. 290value will then override the above default behavior.
293 291
294 Emacs on MS-DOS handles the directory name @file{/dev} specially, 292 Emacs on MS-DOS handles the directory name @file{/dev} specially,
295because of a feature in the emulator libraries of DJGPP that pretends 293because of a feature in the emulator libraries of DJGPP that pretends
@@ -301,8 +299,7 @@ using an actual directory named @file{/dev} on any disk.
301@cindex text and binary files on MS-DOS/MS-Windows 299@cindex text and binary files on MS-DOS/MS-Windows
302 300
303 GNU Emacs uses newline characters to separate text lines. This is the 301 GNU Emacs uses newline characters to separate text lines. This is the
304convention used on Unix, on which GNU Emacs was developed, and on GNU 302convention used on GNU and Unix.
305systems since they are modeled on Unix.
306 303
307@cindex end-of-line conversion on MS-DOS/MS-Windows 304@cindex end-of-line conversion on MS-DOS/MS-Windows
308 MS-DOS and MS-Windows normally use carriage-return linefeed, a 305 MS-DOS and MS-Windows normally use carriage-return linefeed, a
@@ -323,9 +320,10 @@ not agree with the file size information known to the operating system.
323 320
324 In addition, if Emacs recognizes from a file's contents that it uses 321 In addition, if Emacs recognizes from a file's contents that it uses
325newline rather than carriage-return linefeed as its line separator, it 322newline rather than carriage-return linefeed as its line separator, it
326does not perform EOL conversion when reading or writing that file. Thus, 323does not perform EOL conversion when reading or writing that file.
327you can read and edit files from Unix or GNU systems on MS-DOS with no 324Thus, you can read and edit files from GNU and Unix systems on MS-DOS
328special effort, and they will be left with their Unix-style EOLs. 325with no special effort, and they will retain their Unix-style
326end-of-line convention after you edit them.
329 327
330 The mode line indicates whether end-of-line translation was used for 328 The mode line indicates whether end-of-line translation was used for
331the current buffer. If MS-DOS end-of-line translation is in use for the 329the current buffer. If MS-DOS end-of-line translation is in use for the
@@ -336,25 +334,22 @@ instead of the backslash, to alert you that the file's EOL format is not
336the usual carriage-return linefeed. 334the usual carriage-return linefeed.
337 335
338@cindex DOS-to-Unix conversion of files 336@cindex DOS-to-Unix conversion of files
339@pindex dos2unix 337 To visit a file and specify whether it uses DOS-style or Unix-style
340 End-of-line conversion is part of the general coding system conversion 338end-of-line, specify a coding system (@pxref{Specify Coding}). For
341mechanism, so the way to control whether to treat a text file as 339example, @kbd{C-x @key{RET} c unix @key{RET} C-x C-f foobar.txt}
342DOS-style or Unix-style is with the commands for specifying a coding 340visits the file @file{foobar.txt} without converting the EOLs; if some
343system (@pxref{Specify Coding}). For example, @kbd{C-x @key{RET} c unix 341line ends with a carriage-return linefeed pair, Emacs will display
344@key{RET} C-x C-f foobar.txt} visits the file @file{foobar.txt} without 342@samp{^M} at the end of that line. Similarly, you can direct Emacs to
345converting the EOLs; if that file has carriage-return linefeed pairs at 343save a buffer in a specified EOL format with the @kbd{C-x @key{RET} f}
346the end of its lines, Emacs will display @samp{^M} at the end of each 344command. For example, to save a buffer with Unix EOL format, type
347line. Similarly, you can force Emacs to save a buffer with specific EOL 345@kbd{C-x @key{RET} f unix @key{RET} C-x C-s}. If you visit a file
348format with the @kbd{C-x @key{RET} f} command. For example, to save a 346with DOS EOL conversion, then save it with Unix EOL format, that
349buffer with Unix EOL format, type @kbd{C-x @key{RET} f unix @key{RET} 347effectively converts the file to Unix EOL style, like @code{dos2unix}.
350C-x C-s}. Thus, visiting a file with DOS EOL conversion, then saving it
351with Unix EOL format effectively converts the file to Unix text style,
352like the popular program @code{dos2unix} does.
353 348
354@cindex untranslated file system 349@cindex untranslated file system
355@findex add-untranslated-filesystem 350@findex add-untranslated-filesystem
356 When you use NFS or Samba to access file systems that reside on 351 When you use NFS or Samba to access file systems that reside on
357computers using Unix or GNU systems, Emacs should not perform 352computers using GNU or Unix systems, Emacs should not perform
358end-of-line translation on any files in these file systems--not even 353end-of-line translation on any files in these file systems--not even
359when you create a new file. To request this, designate these file 354when you create a new file. To request this, designate these file
360systems as @dfn{untranslated} file systems by calling the function 355systems as @dfn{untranslated} file systems by calling the function
@@ -387,10 +382,10 @@ the function @code{remove-untranslated-filesystem}. This function takes
387one argument, which should be a string just like the one that was used 382one argument, which should be a string just like the one that was used
388previously with @code{add-untranslated-filesystem}. 383previously with @code{add-untranslated-filesystem}.
389 384
390 Designating a file system as untranslated does @strong{not} disable 385 Designating a file system as untranslated does not affect character
391code conversions as specified by the coding systems set up by your 386set conversion, only end-of-line conversion. Essentially, it directs
392language environment, it only affects the EOL conversions, by forcing 387Emacs to create new files with the Unix-style convention of using
393Emacs to create new files with Unix-style newline-only EOLs. 388newline at the end of a line. @xref{Coding Systems}.
394 389
395@vindex file-name-buffer-file-type-alist 390@vindex file-name-buffer-file-type-alist
396@cindex binary files, on MS-DOS/MS-Windows 391@cindex binary files, on MS-DOS/MS-Windows
@@ -415,33 +410,16 @@ always writes those files with DOS-style EOLs.
415the file-name patterns in @code{file-name-buffer-file-type-alist}, the 410the file-name patterns in @code{file-name-buffer-file-type-alist}, the
416EOL conversion is determined by @code{file-name-buffer-file-type-alist}. 411EOL conversion is determined by @code{file-name-buffer-file-type-alist}.
417 412
418@findex find-file-text
419@findex find-file-binary
420 You can visit a file and specify whether to treat it as text or binary
421using the commands @code{find-file-text} and @code{find-file-binary}.
422@code{find-file-text} specifies DOS EOL conversions, but leaves the
423other coding conversions unspecified (Emacs determines the required
424conversions via the usual defaults and coding-detection mechanisms). On
425the other hand, @code{find-file-binary} turns off @emph{all}
426coding-system conversions.
427
428@findex find-file-literally@r{, and binary files}
429 The @code{find-file-text} and @code{find-file-binary} commands are
430only available when Emacs runs on MS-DOS or MS-Windows. The command
431@code{find-file-literally}, which is available on all platforms,
432produces the same effect as @code{find-file-binary}.
433
434@node MS-DOS Printing 413@node MS-DOS Printing
435@section Printing and MS-DOS 414@section Printing and MS-DOS
436 415
437 Printing commands, such as @code{lpr-buffer} (@pxref{Hardcopy}) and 416 Printing commands, such as @code{lpr-buffer} (@pxref{Hardcopy}) and
438@code{ps-print-buffer} (@pxref{PostScript}) can work in MS-DOS and 417@code{ps-print-buffer} (@pxref{PostScript}) can work in MS-DOS and
439MS-Windows by sending the output to one of the printer ports, if a 418MS-Windows by sending the output to one of the printer ports, if a
440Unix-style @code{lpr} program is unavailable. This behaviour is 419Unix-style @code{lpr} program is unavailable. The same Emacs
441controlled by the same variables that control printing with @code{lpr} 420variables control printing on all systems (@pxref{Hardcopy}), but in
442on Unix (@pxref{Hardcopy}, @pxref{PostScript Variables}), but the 421some cases they have different default values on MS-DOS and
443defaults for these variables on MS-DOS and MS-Windows are not the same 422MS-Windows.
444as the defaults on Unix.
445 423
446@vindex printer-name @r{(MS-DOS)} 424@vindex printer-name @r{(MS-DOS)}
447 If you want to use your local printer, printing on it in the usual DOS 425 If you want to use your local printer, printing on it in the usual DOS
@@ -703,7 +681,7 @@ when you want to use it (@pxref{Specify Coding}).
703a DOS codepage, using Emacs running on some other operating system. 681a DOS codepage, using Emacs running on some other operating system.
704 682
705@cindex MS-Windows codepages 683@cindex MS-Windows codepages
706 MS-Windows features its own codepages, which are different from the 684 MS-Windows provides its own codepages, which are different from the
707DOS codepages for the same locale. For example, DOS codepage 850 685DOS codepages for the same locale. For example, DOS codepage 850
708supports the same character set as Windows codepage 1252; DOS codepage 686supports the same character set as Windows codepage 1252; DOS codepage
709855 supports the same character set as Windows codepage 1251, etc. 687855 supports the same character set as Windows codepage 1251, etc.