File: INSTALL.DOC

package info (click to toggle)
mined 2000.15.4-1
  • links: PTS
  • area: main
  • in suites: squeeze
  • size: 16,616 kB
  • ctags: 2,957
  • sloc: ansic: 123,254; sh: 10,042; makefile: 266; sed: 221; perl: 172; cpp: 30
file content (131 lines) | stat: -rw-r--r-- 4,691 bytes parent folder | download
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).


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