1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131
|
Guide to compilation and installation of the mined editor
------------------------------------------------------------------------
Build
- Go to the main package directory (the one containing this 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
-------------------------------------------------------
On a 64 bit system, libraries may have to be referred to using
a different directory. On a 64 bit Linux system, invoke:
LIB=64 make
On a SunOS 64 bit system, this would be:
LIB=/64 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 COMPILE.DOC.
-------------------------------------------------------
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 COMPILE.DOC 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.
------------------------------------------------------------------------
Terminal control
Mined uses the termcap API to control screen output on the terminal.
On many newer systems (esp. Linux), this API is no longer provided
separately but captured by the ncurses library.
Mined does, however, not necessarily depend on the ncurses-devel
package to be installed for building. The makefile was enhanced so that
at least when the newer ncursesw library is available, mined will
compile and work properly without an ncurses development installation
(a bug in preceding ncurses versions used to prevent proper operation
without ncursesw in this case).
-----------------------------------------------------------------------------
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
Different assumptions about the subdirectory structure are taken
for these 3 install targets (as configured in makefile.*),
corresponding to typically different system structures.
-------------------------------------------------------
The default install directories and the directory for installation
of the Mined runtime support library can be modified by setting
the following variables when invoking make; defauls are listed here:
For all install targets:
root=/
For make install:
prefix = $(root)/usr
rundir = $(prefix)/share/mined # on most systems
rundir = $(prefix)/share/lib/mined # on SunOS, HPUX, UCB
For make localinstall:
lprefix = $(root)/usr/local # on most systems
lprefix = $(root)/sw # on Mac OS X
lrundir = $(lprefix)/share/mined
So, to select an individual installation directory, e.g.
if you are not the "root" user, or if you are preparing a
system-specific package, invoke something like
make install prefix=/software
or
make install root=tmp.mined-package
or
make optinstall root=$HOME
or
make localinstall lrundir=/doc/mined
To change a makefile to regularly install to other locations, adapt
the first few variables in the makefile you use (src/makefile....).
------------------------------------------------------------------------
Installation actions
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.
------------------------------------------------------------------------
Access to Mined runtime support library
Mined needs access to some files in the Mined runtime support library
(online help file mined.hlp, uprint script).
If it is not installed in one of the usual places,
configure the user environments so that MINEDDIR contains the
path name of the Mined runtime support library (so that
$MINEDDIR/help/mined.hlp and $MINEDDIR/bin/uprint are found).
------------------------------------------------------------------------
|