"Fossies" - the Fresh Open Source Software Archive

Member "emacs-25.3/msdos/INSTALL" (14 Apr 2017, 7143 Bytes) of package /linux/misc/emacs-25.3.tar.xz:


As a special service "Fossies" has tried to format the requested text file into HTML format (style: standard) with prefixed line numbers. Alternatively you can here view or download the uninterpreted source code file. See also the last Fossies "Diffs" side-by-side code changes report for "INSTALL": 25.1_vs_25.2.

    1 GNU Emacs Installation Guide for the DJGPP (a.k.a. MS-DOS) port
    2 
    3 Copyright (C) 1992, 1994, 1996-1997, 2000-2017 Free Software Foundation,
    4 Inc.
    5 See the end of the file for license conditions.
    6 
    7 The DJGPP port of GNU Emacs builds and runs on all versions of
    8 MS-Windows from version 3.X on, including Windows XP, Vista, and
    9 Windows 7 (however, see below for issues with Windows Vista and 7).
   10 Building on plain MS-DOS is supported only if long file names are
   11 supported (e.g., with a specialized driver such as doslfn).
   12 
   13 To build and install the DJGPP port, you need to have the DJGPP ports
   14 of GCC (the GNU C compiler), GNU Make, rm, mv, cp, and sed, and
   15 version 2.02 or later of DJGPP itself.  See the remarks in CONFIG.BAT
   16 for more information about locations and versions.  The Emacs FAQ (see
   17 info/efaq.info) includes pointers to Internet sites where you can find
   18 the necessary utilities; search for "MS-DOS".  The configuration step
   19 (see below) will test for these utilities and will refuse to continue
   20 if any of them isn't found.
   21 
   22 Bootstrapping Emacs or recompiling Lisp files in the `lisp'
   23 subdirectory using the various targets in the lisp/Makefile file
   24 requires additional utilities: `find' (from Findutils), GNU `echo' and
   25 `test' (from Sh-utils or Coreutils), `ls' and `chmod' (from Fileutils
   26 or Coreutils), `grep' (from Grep), and a port of Bash.  However, you
   27 should not normally need to run lisp/Makefile, as all the Lisp files
   28 are distributed in byte-compiled form as well.  As for bootstrapping
   29 itself, you will only need that if you check-out development sources
   30 from the Emacs source repository.
   31 
   32 Building the DJGPP version of Emacs is supported only on systems which
   33 support long file names (e.g. Windows 9X or Windows XP).  You need to
   34 unpack Emacs distribution in a way that doesn't truncate the original
   35 long filenames to the DOS 8.3 namespace; the easiest way to do this is
   36 to use djtar program which comes with DJGPP, since it will behave
   37 consistently with the rest of DJGPP tools.  Do _not_ disable the DJGPP
   38 long-file-name support (a.k.a. "LFN") while building Emacs.
   39 
   40 (By the time you read this, you have already unpacked the Emacs
   41 distribution, but if the explanations above imply that you should have
   42 done it differently, it's safer to delete the directory tree created
   43 by the unpacking program and unpack Emacs again, than to risk running
   44 into strange problems during the build process.)
   45 
   46 To unpack Emacs with djtar, type this command:
   47 
   48     djtar -x emacs.tgz
   49 
   50 (This assumes that the Emacs distribution is called `emacs.tgz' on
   51 your system.)
   52 
   53 When unpacking Emacs is done, a directory called `emacs-XX.YY' will be
   54 created, where XX.YY is the Emacs version.
   55 
   56 If you want to print international characters, install the intlfonts
   57 distribution.  For this, create a directory called `fonts' under the
   58 `emacs-XX.YY' top-level directory created by unpacking emacs.tgz,
   59 chdir into the directory `emacs-XX.YY/fonts', and type this:
   60 
   61     djtar -x intlfonts.tgz
   62 
   63 To build and install Emacs, chdir to the `emacs-XX.YY' directory and
   64 type these commands:
   65 
   66     config msdos
   67     make install
   68 
   69 Running "config msdos" checks for several programs that are required
   70 to configure and build Emacs; if one of those programs is not found,
   71 CONFIG.BAT stops and prints an error message.
   72 
   73 On Windows NT and Windows 2000/XP/Vista/7, running "config msdos"
   74 might print an error message like "VDM has been already loaded".  This
   75 is because those systems have a program called `redir.exe' which is
   76 incompatible with a program by the same name supplied with DJGPP,
   77 which is used by config.bat.  To resolve this, move the DJGPP's `bin'
   78 subdirectory to the front of your PATH environment variable.
   79 
   80 Windows Vista/7 has several bugs in its DPMI server related to memory
   81 allocation: it fails DPMI resize memory block function, and it
   82 arbitrarily limits the default amount of DPMI memory to 32MB.  To work
   83 around these bugs, first configure Emacs to use the `malloc' function
   84 from the DJGPP library.  To this end, run CONFIG.BAT with the
   85 "--with-system-malloc" option:
   86 
   87     config --with-system-malloc msdos
   88     make install
   89 
   90 In addition, for Windows Vista you'll need to install Service Pack 1
   91 (SP1) or later and enlarge its DPMI memory limit by setting the value
   92 of this Registry key:
   93 
   94   HKEY_LOCAL_MACHINE\System\CurrentControlSet\Control\Wow\DpmiLimit
   95 
   96 Create this key if it does not exist.  The value is a DWORD; setting
   97 it to 536870912 should let Emacs use up to 512MB of memory.
   98 
   99 If you have other problems, either building Emacs or running the
  100 produced binary, look in the file etc/PROBLEMS for some known problems
  101 related to the DJGPP port (search for "MS-DOS").
  102 
  103 To install the international fonts, chdir to the intlfonts-X.Y
  104 directory created when you unpacked the intlfonts distribution (X.Y is
  105 the version number of the fonts' distribution), and type the following
  106 command:
  107 
  108     make bdf INSTALLDIR=..
  109 
  110 After Make finishes, you may remove the directory intlfonts-X.Y; the
  111 fonts are installed into the fonts/bdf subdirectory of the top-level
  112 Emacs directory, and that is where Emacs will look for them by
  113 default.
  114 
  115 Building Emacs creates executable files in the src and lib-src
  116 directories.  Installing the DJGPP port of Emacs moves these
  117 executables to a sibling directory called bin.  For example, if you
  118 build in directory C:/emacs, installing moves the executables from
  119 C:/emacs/src and C:/emacs/lib-src to the directory C:/emacs/bin, so
  120 you can then delete the subdirectories C:/emacs/src and
  121 C:/emacs/lib-src if you wish.  The only subdirectories you need to
  122 keep are bin, lisp, etc and info.  (If you installed intlfonts, keep
  123 the fonts directory and all its subdirectories as well.)  The bin
  124 subdirectory should be added to your PATH.  The msdos subdirectory
  125 includes a PIF and an icon file for Emacs which you might find useful
  126 if you run Emacs under MS Windows.
  127 
  128 Emacs on MSDOS finds the lisp, etc and info directories by looking in
  129 ../lisp, ../etc and ../info, starting from the directory where the
  130 Emacs executable was run from.  You can override this by setting the
  131 environment variables EMACSDATA (for the location of `etc' directory),
  132 EMACSLOADPATH (for the location of `lisp' directory) and INFOPATH (for
  133 the location of the `info' directory).
  134 
  135 Emacs features which require asynchronous subprocesses that depend on
  136 multitasking do not work in the DJGPP port.  Synchronous subprocesses
  137 do work, so features such as compilation, grep, and Ispell run
  138 synchronously, unlike on other platforms.
  139 
  140 
  141 This file is part of GNU Emacs.
  142 
  143 GNU Emacs is free software: you can redistribute it and/or modify
  144 it under the terms of the GNU General Public License as published by
  145 the Free Software Foundation, either version 3 of the License, or
  146 (at your option) any later version.
  147 
  148 GNU Emacs is distributed in the hope that it will be useful,
  149 but WITHOUT ANY WARRANTY; without even the implied warranty of
  150 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  151 GNU General Public License for more details.
  152 
  153 You should have received a copy of the GNU General Public License
  154 along with GNU Emacs.  If not, see <http://www.gnu.org/licenses/>.