Commit 3f0ec1b7 authored by Richard M. Stallman's avatar Richard M. Stallman
Browse files

Explain about MSDOS installation and long file name support.

parent 289e5a55
...@@ -511,34 +511,55 @@ problems sometimes encountered, and what to do about them. ...@@ -511,34 +511,55 @@ problems sometimes encountered, and what to do about them.
Installation on MSDOG (a.k.a. MSDOS) Installation on MSDOG (a.k.a. MSDOS)
To install on MSDOG, you need to have the GNU C compiler for MSDOG To install on MSDOG, you need to have the GNU C compiler for MSDOG
(also known as djgpp), GNU Make, rm, mv, chmod, and sed. See the (also known as djgpp), GNU Make, rm, mv, and sed. See the remarks in
remarks in config.bat for more information about locations and config.bat for more information about locations and versions. The
versions. file etc/FAQ includes pointers to Internet sites where you can find
the necessary utilities; search for "MS-DOS". The configuration step
If you are compiling on an MSDOG-like system which has long file (see below) will test for these utilities and will refuse to continue
names, you may need to do `SET LFN=y' for some of the commands, if any of them isn't found.
especially the compilation commands. It might be more convenient to
unpack the Emacs distribution with djtar, which comes with djgpp; if If you are building the MSDOG version of Emacs on an MSDOG-like system
you do `SET LFN=n' before unpacking, djtar truncates file names to 8.3 which supports long file names (e.g. Windows 95), you need to make
naming as it extracts files, even if the system allows long file sure that long file names are handled consistently both when you
names, and this ensures that build procedures designed for 8.3 file unpack the distribution and compile it. If you intend to compile with
names still work. Use djtar with the command `djtar -x foo.tar' or DJGPP v2.0 or later, and long file names support is enabled (LFN=y in
`djtar -x foo.tgz'. the environment), you need to unpack Emacs distribution in a way that
doesn't truncate the original long filenames to the DOS 8.3 namespace;
Some users report that running Emacs 19.29 requires dpmi memory the easiest way to do this is to use djtar program which comes with
management. We do not know why this is so, since 19.28 did not need DJGPP, since it will note the LFN setting and behave accordingly.
it. If we find out what change introduced this requirement, we may DJGPP v1 doesn't support long filenames, so you must unpack Emacs with
try to eliminate it. ("May" because perhaps djgpp version 2's a program that truncates the filenames to 8.3 naming as it extracts
improved dpmi handling means this is no longer a problem.) files; again, using djtar after setting LFN=n is the recommended way.
You can build Emacs with LFN=n even if you use DJGPP v2, if some of
It is possible that this problem happens only when there is not enough your tools don't support long file names: just ensure that LFN is set
physical memory on the machine. to `n' during both unpacking and compiling.
You can find out if you have a dpmi host by running go32 (part of (By the time you read this, you have already unpacked the Emacs
djgpp) without arguments; it will tell you if it uses dpmi memory. distribution, but if the explanations above imply that you should have
For more information about dpmi memory, consult the djgpp FAQ. done it differently, it's safer to delete the directory tree created
by the unpacking program and unpack Emacs again, than to risk running
To build and install Emacs, type these commands: into problems during the build process.)
It is important to understand that the runtime support of long file
names by the Emacs binary is NOT affected by the LFN setting during
compilation; Emacs compiled with DJGPP v2.0 or later will always
support long file names on Windows 95 no matter what was the setting
of LFN at compile time.
To unpack Emacs with djtar, type this command:
djtar -x emacs.tgz
(This assumes that the Emacs distribution is called `emacs.tgz' on
your system.) There are a few files in the archive whose names
collide with other files under the 8.3 DOS naming. If you have set
LFN=n, djtar will ask you to supply alternate names for these files;
you can just press `Enter' when this happens (which makes djtar skip
these files) because they aren't required for MS-DOS.
When unpacking is done, a directory called `emacs-XX.YY' will be
created, where XX.YY is the Emacs version. To build and install
Emacs, chdir to that directory and type these commands:
config msdos config msdos
make install make install
...@@ -549,7 +570,10 @@ sibling directory called bin. For example, if you build in directory ...@@ -549,7 +570,10 @@ sibling directory called bin. For example, if you build in directory
/emacs, installing moves the executables from /emacs/src and /emacs, installing moves the executables from /emacs/src and
/emacs/lib-src to the directory /emacs/bin, so you can then delete the /emacs/lib-src to the directory /emacs/bin, so you can then delete the
subdirectories /emacs/src and /emacs/lib-src if you wish. The only subdirectories /emacs/src and /emacs/lib-src if you wish. The only
subdirectories you need to keep are bin, lisp, etc and info. subdirectories you need to keep are bin, lisp, etc and info. The bin
subdirectory should be added to your PATH. The msdos subdirectory
includes a PIF and an icon file for Emacs which you might find useful
if you run Emacs under MS Windows.
Emacs on MSDOS finds the lisp, etc and info directories by looking in Emacs on MSDOS finds the lisp, etc and info directories by looking in
../lisp, ../etc and ../info, starting from the directory where the ../lisp, ../etc and ../info, starting from the directory where the
......
Markdown is supported
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment