comparison nt/INSTALL @ 93965:b29775f48b94

Document make targets.

93964:46ac0eab32c3

    [7] not recommended; please report if you try this combination.
    [8] tested only on Windows XP.

  Other compilers may work, but specific reports from people that have
  tried suggest that the Intel C compiler (for example) may produce an
  Emacs executable with strange filename completion behaviour.  Unless
  you would like to assist by finding and fixing the cause of any bugs
  like this, we recommend the use of the supported compilers mentioned
  in the previous paragraph.

  You will also need a copy of the Posix cp, rm and mv programs.  These

  absolutely sure the produced binaries will never need to be run under
  a debugger.

  N.B.  It is normal to see a few error messages output while configure
  is running, when gcc support is being tested.  These cannot be
  surpressed because of limitations in the Windows 9x command.com shell.

  You are encouraged to look at the file config.log which shows details
  for failed tests, after configure.bat finishes.  Any unexplained failure
  should be investigated and perhaps reported as a bug (see the section
  about reporting bugs in the file README in this directory and in the

  expected names of the libraries.

  Some image libraries have dependencies on one another, or on zlib.
  For example, tiff support depends on the jpeg library.  If you did not
  compile the libraries yourself, you must make sure that any dependency
  is in the PATH or otherwise accesible and that the binaries are
  compatible (for example, that they were built with the same compiler).

  Binaries for the image libraries (among many others) can be found at
  the GnuWin32 project.  PNG, JPEG and TIFF libraries are also
  included with GTK, which is installed along with other Free Software

  (for `nmake', type "nmake install INSTALL_DIR=D:/emacs" instead).

  The install process will run addpm to setup the registry entries, and
  to create a Start menu icon for Emacs.

* Trouble-shooting

  The main problems that are likely to be encountered when building
  Emacs stem from using an old version of GCC, or old MinGW or W32 API
  headers.  Additionally, cygwin ports of GNU make may require the Emacs

  be displayed in the console window that was opened when the
  emacs.exe executable was started.  The output sent to the debugger
  should be displayed in its "Debug" output window.

  When you are in the process of debugging Emacs and you would like to
  examine the contents of a Lisp_Object variable, popup the QuickWatch
  window (QuickWatch has an eyeglass symbol on its button in the
  toolbar).  In the text field at the top of the window, enter
  debug_print(<variable>) and hit return.  For example, start and run
  Emacs in the debugger until it is waiting for user input.  Then click
  on the Break button in the debugger to halt execution.  Emacs should

93965:b29775f48b94

    [7] not recommended; please report if you try this combination.
    [8] tested only on Windows XP.

  Other compilers may work, but specific reports from people that have
  tried suggest that the Intel C compiler (for example) may produce an
  Emacs executable with strange filename completion behavior.  Unless
  you would like to assist by finding and fixing the cause of any bugs
  like this, we recommend the use of the supported compilers mentioned
  in the previous paragraph.

  You will also need a copy of the Posix cp, rm and mv programs.  These

  absolutely sure the produced binaries will never need to be run under
  a debugger.

  N.B.  It is normal to see a few error messages output while configure
  is running, when gcc support is being tested.  These cannot be
  suppressed because of limitations in the Windows 9x command.com shell.

  You are encouraged to look at the file config.log which shows details
  for failed tests, after configure.bat finishes.  Any unexplained failure
  should be investigated and perhaps reported as a bug (see the section
  about reporting bugs in the file README in this directory and in the

  expected names of the libraries.

  Some image libraries have dependencies on one another, or on zlib.
  For example, tiff support depends on the jpeg library.  If you did not
  compile the libraries yourself, you must make sure that any dependency
  is in the PATH or otherwise accessible and that the binaries are
  compatible (for example, that they were built with the same compiler).

  Binaries for the image libraries (among many others) can be found at
  the GnuWin32 project.  PNG, JPEG and TIFF libraries are also
  included with GTK, which is installed along with other Free Software

  (for `nmake', type "nmake install INSTALL_DIR=D:/emacs" instead).

  The install process will run addpm to setup the registry entries, and
  to create a Start menu icon for Emacs.

* Make targets

  The following make targets may be used by users building the source
  distribution, or users who have checked out of CVS after
  an initial bootstrapping.

  make
  Builds Emacs from the available sources and pre-compiled lisp files.

  make install
  Installs programs to the bin directory, and runs addpm to create
  Start Menu icons.

  make clean
  Removes object and executable files produced by the build process in
  the current configuration.  After make clean, you can rebuild with
  the same configuration using make.

  make distclean
  In addition to the files removed by make clean, this also removes
  Makefiles and other generated files to get back to the state of a
  freshly unpacked source distribution. Note that this will not remove
  installed files, or the results of builds performed with different
  compiler or optimization options than the current configuration.
  After make distclean, it is necessary to run configure.bat followed
  by make to rebuild.

  make cleanall
  Removes object and executable files that may have been created by
  previous builds with different configure options, in addition to
  the files produced by the current configuration.

  make realclean
  Removes the installed files in the bin subdirectory in addition to
  the files removed by make cleanall.


  The following targets are intended only for users who have checked out
  of CVS.

  make bootstrap
  Creates a temporary emacs binary with lisp source files and
  uses it to compile the lisp files.  Once the lisp files are built,
  emacs is redumped with the compiled lisp.

  make recompile
  Recompiles any changed lisp files after a cvs update.  This saves
  doing a full bootstrap after every update.  If this or a subsequent
  make fail, you probably need to perform a full bootstrap, though
  running this target multiple times may eventually sort out the
  interdependencies.

  make maintainer-clean
  Removes everything that can be recreated, including compiled lisp
  files, to get back to the state of a fresh CVS checkout.  After make
  maintainer-clean, it is necessary to run configure.bat and make
  bootstrap to rebuild.  Occasionally it may be necessary to run this
  target after a cvs update.


* Trouble-shooting

  The main problems that are likely to be encountered when building
  Emacs stem from using an old version of GCC, or old MinGW or W32 API
  headers.  Additionally, cygwin ports of GNU make may require the Emacs

  be displayed in the console window that was opened when the
  emacs.exe executable was started.  The output sent to the debugger
  should be displayed in its "Debug" output window.

  When you are in the process of debugging Emacs and you would like to
  examine the contents of a Lisp_Object variable, pop up the QuickWatch
  window (QuickWatch has an eyeglass symbol on its button in the
  toolbar).  In the text field at the top of the window, enter
  debug_print(<variable>) and hit return.  For example, start and run
  Emacs in the debugger until it is waiting for user input.  Then click
  on the Break button in the debugger to halt execution.  Emacs should