aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorEli Zaretskii2006-04-21 11:42:01 +0000
committerEli Zaretskii2006-04-21 11:42:01 +0000
commit7dfdf4652055f64db2f23547f943dec7daaf72cc (patch)
treeba8ea082f1d2abf41c72ddbd898226d8a0b615c3
parent270c6692527fd0a1128b8390d63a703fe8e17260 (diff)
downloademacs-7dfdf4652055f64db2f23547f943dec7daaf72cc.tar.gz
emacs-7dfdf4652055f64db2f23547f943dec7daaf72cc.zip
(MS-DOS File Names): Remove section about backslashes and case-insensitivity
in file names (moved to the main manual). (MS-DOS Printing): Move most of the text to the main manual.
-rw-r--r--man/emacs-xtra.texi148
1 files changed, 9 insertions, 139 deletions
diff --git a/man/emacs-xtra.texi b/man/emacs-xtra.texi
index d4a1e5f000e..d6b1ca42583 100644
--- a/man/emacs-xtra.texi
+++ b/man/emacs-xtra.texi
@@ -3316,7 +3316,7 @@ Windows).
3316* Mouse: MS-DOS Mouse. Mouse conventions on MS-DOS. 3316* Mouse: MS-DOS Mouse. Mouse conventions on MS-DOS.
3317* Display: MS-DOS Display. Fonts, frames and display size on MS-DOS. 3317* Display: MS-DOS Display. Fonts, frames and display size on MS-DOS.
3318* Files: MS-DOS File Names. File name conventions on MS-DOS. 3318* Files: MS-DOS File Names. File name conventions on MS-DOS.
3319* Printing: MS-DOS Printing. How to specify the printer on MS-DOS. 3319* Printing: MS-DOS Printing. Printing specifics on MS-DOS.
3320* I18N: MS-DOS and MULE. Support for internationalization on MS-DOS. 3320* I18N: MS-DOS and MULE. Support for internationalization on MS-DOS.
3321* Processes: MS-DOS Processes. Running subprocesses on MS-DOS. 3321* Processes: MS-DOS Processes. Running subprocesses on MS-DOS.
3322@end menu 3322@end menu
@@ -3534,11 +3534,6 @@ other frames to the new dimensions.
3534@cindex file names under MS-DOS 3534@cindex file names under MS-DOS
3535@cindex init file, default name under MS-DOS 3535@cindex init file, default name under MS-DOS
3536 3536
3537 MS-DOS normally uses a backslash, @samp{\}, to separate name units
3538within a file name, instead of the slash used on other systems. Emacs
3539on MS-DOS permits use of either slash or backslash, and also knows
3540about drive letters in file names.
3541
3542 On MS-DOS, file names are case-insensitive and limited to eight 3537 On MS-DOS, file names are case-insensitive and limited to eight
3543characters, plus optionally a period and three more characters. Emacs 3538characters, plus optionally a period and three more characters. Emacs
3544knows enough about these limitations to handle file names that were 3539knows enough about these limitations to handle file names that were
@@ -3593,55 +3588,14 @@ using an actual directory named @file{/dev} on any disk.
3593@section Printing and MS-DOS 3588@section Printing and MS-DOS
3594 3589
3595 Printing commands, such as @code{lpr-buffer} 3590 Printing commands, such as @code{lpr-buffer}
3596(@pxref{Printing,,,emacs, the Emacs Manual }) and 3591(@pxref{Printing,,,emacs, the Emacs Manual}) and
3597@code{ps-print-buffer} (@pxref{PostScript,,,emacs, the Emacs Manual}) 3592@code{ps-print-buffer} (@pxref{PostScript,,,emacs, the Emacs Manual})
3598can work in MS-DOS and MS-Windows by sending the output to one of the 3593can work on MS-DOS by sending the output to one of the printer ports,
3599printer ports, if a Posix-style @code{lpr} program is unavailable. 3594if a Posix-style @code{lpr} program is unavailable. The same Emacs
3600The same Emacs variables control printing on all systems, but in some 3595variables control printing on all systems, but in some cases they have
3601cases they have different default values on MS-DOS and MS-Windows. 3596different default values on MS-DOS.
3602 3597
3603@vindex printer-name @r{(MS-DOS)} 3598@xref{MS-Windows Printing,,,emacs, the Emacs Manual}, for details.
3604 If you want to use your local printer, printing on it in the usual DOS
3605manner, then set the Lisp variable @code{lpr-command} to @code{""} (its
3606default value) and @code{printer-name} to the name of the printer
3607port---for example, @code{"PRN"}, the usual local printer port (that's
3608the default), or @code{"LPT2"}, or @code{"COM1"} for a serial printer.
3609You can also set @code{printer-name} to a file name, in which case
3610``printed'' output is actually appended to that file. If you set
3611@code{printer-name} to @code{"NUL"}, printed output is silently
3612discarded (sent to the system null device).
3613
3614 On MS-Windows, when the Windows network software is installed, you can
3615also use a printer shared by another machine by setting
3616@code{printer-name} to the UNC share name for that printer---for example,
3617@code{"//joes_pc/hp4si"}. (It doesn't matter whether you use forward
3618slashes or backslashes here.) To find out the names of shared printers,
3619run the command @samp{net view} at a DOS command prompt to obtain a list
3620of servers, and @samp{net view @var{server-name}} to see the names of printers
3621(and directories) shared by that server. Alternatively, click the
3622@samp{Network Neighborhood} icon on your desktop, and look for machines
3623which share their printers via the network.
3624
3625@cindex @samp{net use}, and printing on MS-Windows
3626@cindex networked printers (MS-Windows)
3627 If the printer doesn't appear in the output of @samp{net view}, or
3628if setting @code{printer-name} to the UNC share name doesn't produce a
3629hardcopy on that printer, you can use the @samp{net use} command to
3630connect a local print port such as @code{"LPT2"} to the networked
3631printer. For example, typing @kbd{net use LPT2:
3632\\joes_pc\hp4si}@footnote{
3633Note that the @samp{net use} command requires the UNC share name to be
3634typed with the Windows-style backslashes, while the value of
3635@code{printer-name} can be set with either forward- or backslashes.}
3636causes Windows to @dfn{capture} the LPT2 port and redirect the printed
3637material to the printer connected to the machine @code{joes_pc}.
3638After this command, setting @code{printer-name} to @code{"LPT2"}
3639should produce the hardcopy on the networked printer.
3640
3641 With some varieties of Windows network software, you can instruct
3642Windows to capture a specific printer port such as @code{"LPT2"}, and
3643redirect it to a networked printer via the @w{@code{Control
3644Panel->Printers}} applet instead of @samp{net use}.
3645 3599
3646 Some printers expect DOS codepage encoding of non-@acronym{ASCII} text, even 3600 Some printers expect DOS codepage encoding of non-@acronym{ASCII} text, even
3647though they are connected to a Windows machine which uses a different 3601though they are connected to a Windows machine which uses a different
@@ -3655,95 +3609,11 @@ M-x lpr-region RET} will print the region while converting it to the
3655codepage 850 encoding. You may need to create the @code{cp@var{nnn}} 3609codepage 850 encoding. You may need to create the @code{cp@var{nnn}}
3656coding system with @kbd{M-x codepage-setup}. 3610coding system with @kbd{M-x codepage-setup}.
3657 3611
3658 If you set @code{printer-name} to a file name, it's best to use an
3659absolute file name. Emacs changes the working directory according to
3660the default directory of the current buffer, so if the file name in
3661@code{printer-name} is relative, you will end up with several such
3662files, each one in the directory of the buffer from which the printing
3663was done.
3664
3665@findex print-buffer @r{(MS-DOS)}
3666@findex print-region @r{(MS-DOS)}
3667@vindex lpr-headers-switches @r{(MS-DOS)}
3668 The commands @code{print-buffer} and @code{print-region} call the
3669@code{pr} program, or use special switches to the @code{lpr} program, to
3670produce headers on each printed page. MS-DOS and MS-Windows don't
3671normally have these programs, so by default, the variable
3672@code{lpr-headers-switches} is set so that the requests to print page
3673headers are silently ignored. Thus, @code{print-buffer} and
3674@code{print-region} produce the same output as @code{lpr-buffer} and
3675@code{lpr-region}, respectively. If you do have a suitable @code{pr}
3676program (for example, from GNU Textutils), set
3677@code{lpr-headers-switches} to @code{nil}; Emacs will then call
3678@code{pr} to produce the page headers, and print the resulting output as
3679specified by @code{printer-name}.
3680
3681@vindex print-region-function @r{(MS-DOS)}
3682@cindex lpr usage under MS-DOS
3683@vindex lpr-command @r{(MS-DOS)}
3684@vindex lpr-switches @r{(MS-DOS)}
3685 Finally, if you do have an @code{lpr} work-alike, you can set the
3686variable @code{lpr-command} to @code{"lpr"}. Then Emacs will use
3687@code{lpr} for printing, as on other systems. (If the name of the
3688program isn't @code{lpr}, set @code{lpr-command} to specify where to
3689find it.) The variable @code{lpr-switches} has its standard meaning
3690when @code{lpr-command} is not @code{""}. If the variable
3691@code{printer-name} has a string value, it is used as the value for the
3692@code{-P} option to @code{lpr}, as on Unix.
3693
3694@findex ps-print-buffer @r{(MS-DOS)}
3695@findex ps-spool-buffer @r{(MS-DOS)}
3696@vindex ps-printer-name @r{(MS-DOS)}
3697@vindex ps-lpr-command @r{(MS-DOS)}
3698@vindex ps-lpr-switches @r{(MS-DOS)}
3699 A parallel set of variables, @code{ps-lpr-command},
3700@code{ps-lpr-switches}, and @code{ps-printer-name} (@pxref{PostScript
3701Variables,,,emacs, the Emacs Manual}), defines how PostScript files
3702should be printed. These variables are used in the same way as the
3703corresponding variables described above for non-PostScript printing.
3704Thus, the value of @code{ps-printer-name} is used as the name of the
3705device (or file) to which PostScript output is sent, just as
3706@code{printer-name} is used for non-PostScript printing. (There are
3707two distinct sets of variables in case you have two printers attached
3708to two different ports, and only one of them is a PostScript printer.)
3709
3710 The default value of the variable @code{ps-lpr-command} is @code{""},
3711which causes PostScript output to be sent to the printer port specified
3712by @code{ps-printer-name}, but @code{ps-lpr-command} can also be set to
3713the name of a program which will accept PostScript files. Thus, if you
3714have a non-PostScript printer, you can set this variable to the name of
3715a PostScript interpreter program (such as Ghostscript). Any switches
3716that need to be passed to the interpreter program are specified using
3717@code{ps-lpr-switches}. (If the value of @code{ps-printer-name} is a
3718string, it will be added to the list of switches as the value for the
3719@code{-P} option. This is probably only useful if you are using
3720@code{lpr}, so when using an interpreter typically you would set
3721@code{ps-printer-name} to something other than a string so it is
3722ignored.)
3723
3724 For example, to use Ghostscript for printing on an Epson printer
3725connected to the @samp{LPT2} port, put this in your @file{_emacs} file:
3726
3727@example
3728(setq ps-printer-name t) ; Ghostscript doesn't understand -P
3729(setq ps-lpr-command "c:/gs/gs386")
3730(setq ps-lpr-switches '("-q" "-dNOPAUSE"
3731 "-sDEVICE=epson"
3732 "-r240x72"
3733 "-sOutputFile=LPT2"
3734 "-Ic:/gs"))
3735@end example
3736
3737@noindent
3738(This assumes that Ghostscript is installed in the @file{"c:/gs"}
3739directory.)
3740
3741@vindex dos-printer 3612@vindex dos-printer
3742@vindex dos-ps-printer 3613@vindex dos-ps-printer
3743 For backwards compatibility, the value of @code{dos-printer} 3614 For backwards compatibility, the value of @code{dos-printer}
3744(@code{dos-ps-printer}), if it has a value, overrides the value of 3615(@code{dos-ps-printer}), if it has a value, overrides the value of
3745@code{printer-name} (@code{ps-printer-name}), on MS-DOS and MS-Windows 3616@code{printer-name} (@code{ps-printer-name}), on MS-DOS.
3746only.
3747 3617
3748 3618
3749@node MS-DOS and MULE 3619@node MS-DOS and MULE