Guide to compilation and installation of the mined editor


-----------------------------------------------------------------------------
Build

- Go to the main package directory (the one containing this INSTALL file),
  then invoke make:

	make

  This automatically selects a suitable makefile in the 'src' 
  subdirectory for the most common operating environments, based on 
  the output of the 'uname' command.


  To override automatic selection of the makefile and use gcc, 
  you may invoke:

	CC=gcc make


  If you want to check mined with curses, you may invoke:

	make minced

  This uses the ncursesw library which supports UTF-8. Using curses is 
  discouraged, however; see the comments in doc/compilation.


  If compilation fails, you may try to select a suitable makefile 
  in the subdirectory src:

	cd src; make -f makefile.<system>

  Choose one closest to your operating system. Also please consult the 
  file doc/compilation for some hints on how to adapt a makefile for 
  your system. In this case, if you need help, or if you finally 
  succeed, please send a note to mined@towo.net so I can extend the 
  range of automatically supported systems.


-----------------------------------------------------------------------------
Install

- For installation into the usual system directories under /usr 
  of your target system, being the super-user (root), invoke:

	make install

  Alternatively, to install into /usr/local, invoke:

	make localinstall

  Alternatively, to install into /opt, invoke:

	make optinstall

  Alternatively (especially if you are not the "root" user), 
  to install into $HOME/opt, invoke:

	make homeinstall

  This installs the binary program, the manual page, the online help 
  file, and the runtime support library, to appropriate locations as 
  used by various systems.
  If you want to install to other locations, adapt the first few 
  variables in the makefile you use (src/makefile....) before 
  installation, or copy the compiled binary program manually to a 
  suitable place in your search path.
  If the online help file mined.hlp (from the usrshare directory of 
  the mined distribution) is not installed in one of the usual places, 
  configure your environment so that MINEDHELPFILE contains the full 
  path name of the online help file mined.hlp.


-----------------------------------------------------------------------------
