aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorEli Zaretskii2008-11-08 19:07:31 +0000
committerEli Zaretskii2008-11-08 19:07:31 +0000
commitb73f809ce4cf69d11f5b5bb8ec8e0bc3ed759323 (patch)
treeaaf7ad6c01580aeb6a26359aa9d42ae6be3b1ef8
parenta1401ab1230bfd8e9e433c9714e1f0010e19a3a3 (diff)
downloademacs-b73f809ce4cf69d11f5b5bb8ec8e0bc3ed759323.tar.gz
emacs-b73f809ce4cf69d11f5b5bb8ec8e0bc3ed759323.zip
Move MS-DOS specific instructions to msdos/INSTALL.
-rw-r--r--ChangeLog4
-rw-r--r--INSTALL142
2 files changed, 8 insertions, 138 deletions
diff --git a/ChangeLog b/ChangeLog
index cf313b1dc5c..7e28d8b8640 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,7 @@
12008-11-08 Eli Zaretskii <eliz@gnu.org>
2
3 * INSTALL: Move MS-DOS specific instructions to msdos/INSTALL.
4
12008-11-07 Glenn Morris <rgm@gnu.org> 52008-11-07 Glenn Morris <rgm@gnu.org>
2 6
3 * configure.in (HAVE_LIB64_DIR): Check for crtn.o. (Bug#1287) 7 * configure.in (HAVE_LIB64_DIR): Check for crtn.o. (Bug#1287)
diff --git a/INSTALL b/INSTALL
index 1930cac1491..372e703e0b5 100644
--- a/INSTALL
+++ b/INSTALL
@@ -5,8 +5,8 @@ See the end of the file for license conditions.
5 5
6 6
7This file contains general information. For more specific information 7This file contains general information. For more specific information
8for the Windows, and GNUstep/Mac OS X ports, also see the files 8for the Windows, GNUstep/Mac OS X, and MS-DOS ports, also see the files
9nt/INSTALL and nextstep/INSTALL. 9nt/INSTALL nextstep/INSTALL, and msdos/INSTALL.
10 10
11 11
12BASIC INSTALLATION 12BASIC INSTALLATION
@@ -229,8 +229,8 @@ Debian 3 and above.
229DETAILED BUILDING AND INSTALLATION: 229DETAILED BUILDING AND INSTALLATION:
230 230
231(This is for a Unix or Unix-like system. For MS-DOS and Windows 3.X, 231(This is for a Unix or Unix-like system. For MS-DOS and Windows 3.X,
232see below; search for MSDOG. For Windows 9X, Windows ME, Windows NT, 232see msdos/INSTALL. For Windows 9X, Windows ME, Windows NT, Windows
233Windows 2000, Windows XP/2003, and Windows Vista/2008, see the file 2332000, Windows XP/2003, and Windows Vista/2008, see the file
234nt/INSTALL. For GNUstep and Mac OS X, see nextstep/INSTALL.) 234nt/INSTALL. For GNUstep and Mac OS X, see nextstep/INSTALL.)
235 235
2361) Make sure your system has enough swapping space allocated to handle 2361) Make sure your system has enough swapping space allocated to handle
@@ -796,140 +796,6 @@ PROBLEMS
796 796
797See the file PROBLEMS in etc subdirectory for a list of various 797See the file PROBLEMS in etc subdirectory for a list of various
798problems sometimes encountered, and what to do about them. 798problems sometimes encountered, and what to do about them.
799
800
801Installation on MSDOG (a.k.a. MSDOS)
802
803To install on MSDOG, you need to have the GNU C compiler for MSDOG
804(also known as djgpp), GNU Make, rm, mv, and sed. See the remarks in
805config.bat for more information about locations and versions. The
806file etc/FAQ includes pointers to Internet sites where you can find
807the necessary utilities; search for "MS-DOS". The configuration step
808(see below) will test for these utilities and will refuse to continue
809if any of them isn't found.
810
811Recompiling Lisp files in the `lisp' subdirectory using the various
812targets in the lisp/Makefile file requires additional utilities:
813`find' and `xargs' (from Findutils), `touch' (from Fileutils) GNU
814`echo' and `test' (from Sh-utils), `tr, `sort', and `uniq' (from
815Textutils), and a port of Bash. However, you should not normally need
816to run lisp/Makefile, as all the Lisp files are distributed in
817byte-compiled form as well.
818
819If you are building the MSDOG version of Emacs on an MSDOG-like system
820which supports long file names (e.g. Windows 9X or Windows XP), you
821need to make sure that long file names are handled consistently both
822when you unpack the distribution and compile it. If you intend to
823compile with DJGPP v2.0 or later, and long file names support is
824enabled (LFN=y in the environment), you need to unpack Emacs
825distribution in a way that doesn't truncate the original long
826filenames to the DOS 8.3 namespace; the easiest way to do this is to
827use djtar program which comes with DJGPP, since it will note the LFN
828setting and behave accordingly. DJGPP v1 doesn't support long
829filenames, so you must unpack Emacs with a program that truncates the
830filenames to 8.3 naming as it extracts files; again, using djtar after
831setting LFN=n is the recommended way. You can build Emacs with LFN=n
832even if you use DJGPP v2, if some of your tools don't support long
833file names: just ensure that LFN is set to `n' during both unpacking
834and compiling.
835
836(By the time you read this, you have already unpacked the Emacs
837distribution, but if the explanations above imply that you should have
838done it differently, it's safer to delete the directory tree created
839by the unpacking program and unpack Emacs again, than to risk running
840into problems during the build process.)
841
842It is important to understand that the runtime support of long file
843names by the Emacs binary is NOT affected by the LFN setting during
844compilation; Emacs compiled with DJGPP v2.0 or later will always
845support long file names on Windows no matter what was the setting
846of LFN at compile time. However, if you compiled with LFN disabled
847and want to enable LFN support after Emacs was already built, you need
848to make sure that the support files in the lisp, etc and info
849directories are called by their original long names as found in the
850distribution. You can do this either by renaming the files manually,
851or by extracting them from the original distribution archive with
852djtar after you set LFN=y in the environment.
853
854To unpack Emacs with djtar, type this command:
855
856 djtar -x emacs.tgz
857
858(This assumes that the Emacs distribution is called `emacs.tgz' on
859your system.)
860
861If you want to print international characters, install the intlfonts
862distribution. For this, create a directory called `fonts' under the
863Emacs top-level directory (usually called `emacs-XX.YY') created by
864unpacking emacs.tgz, chdir into the directory emacs-XX.YY/fonts, and
865type this:
866
867 djtar -x intlfonts.tgz
868
869When unpacking is done, a directory called `emacs-XX.YY' will be
870created, where XX.YY is the Emacs version. To build and install
871Emacs, chdir to that directory and type these commands:
872
873 config msdos
874 make install
875
876Running "config msdos" checks for several programs that are required
877to configure and build Emacs; if one of those programs is not found,
878CONFIG.BAT stops and prints an error message. If you have DJGPP
879version 2.0 or 2.01, it will complain about a program called
880DJECHO.EXE. These old versions of DJGPP shipped that program under
881the name ECHO.EXE, so you can simply copy ECHO.EXE to DJECHO.EXE and
882rerun CONFIG.BAT. If you have neither ECHO.EXE nor DJECHO.EXE, you
883should be able to find them in your djdevNNN.zip archive (where NNN is
884the DJGPP version number).
885
886On Windows NT, Windows 2000/XP/Vista, running "config msdos" might
887print an error message like "VDM has been already loaded". This is
888because those systems have a program called `redir.exe' which is
889incompatible with a program by the same name supplied with DJGPP,
890which is used by config.bat. To resolve this, move the DJGPP's `bin'
891subdirectory to the front of your PATH environment variable.
892
893To install the international fonts, chdir to the intlfonts-X.Y
894directory created when you unpacked the intlfonts distribution (X.Y is
895the version number of the fonts' distribution), and type the following
896command:
897
898 make bdf INSTALLDIR=..
899
900After Make finishes, you may remove the directory intlfonts-X.Y; the
901fonts are installed into the fonts/bdf subdirectory of the top-level
902Emacs directory, and that is where Emacs will look for them by
903default.
904
905Building Emacs creates executable files in the src and lib-src
906directories. Installing Emacs on MSDOS moves these executables to a
907sibling directory called bin. For example, if you build in directory
908/emacs, installing moves the executables from /emacs/src and
909/emacs/lib-src to the directory /emacs/bin, so you can then delete the
910subdirectories /emacs/src and /emacs/lib-src if you wish. The only
911subdirectories you need to keep are bin, lisp, etc and info. (If you
912installed intlfonts, keep the fonts directory and all its
913subdirectories as well.) The bin subdirectory should be added to your
914PATH. The msdos subdirectory includes a PIF and an icon file for
915Emacs which you might find useful if you run Emacs under MS Windows.
916
917Emacs on MSDOS finds the lisp, etc and info directories by looking in
918../lisp, ../etc and ../info, starting from the directory where the
919Emacs executable was run from. You can override this by setting the
920environment variables EMACSDATA (for the location of `etc' directory),
921EMACSLOADPATH (for the location of `lisp' directory) and INFOPATH (for
922the location of the `info' directory).
923
924MSDOG is a not a multitasking operating system, so Emacs features such
925as asynchronous subprocesses that depend on multitasking will not
926work. Synchronous subprocesses do work.
927
928Version 2.0 of djgpp has two bugs that affect Emacs. We've included
929corrected versions of two files from djgpp in the msdos subdirectory:
930is_exec.c and sigaction.c. To work around the bugs, compile these
931files and link them into temacs. Djgpp versions 2.01 and later have
932these bugs fixed, so upgrade if you can before building Emacs.
933 799
934This file is part of GNU Emacs. 800This file is part of GNU Emacs.
935 801