forked from unofficial-mirror/groff
-
Notifications
You must be signed in to change notification settings - Fork 0
/
INSTALL.extra
179 lines (127 loc) · 6.42 KB
/
INSTALL.extra
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
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
Copyright 1997-2021 Free Software Foundation, Inc.
Copying and distribution of this file, with or without modification,
are permitted in any medium without royalty provided the copyright
notice and this notice are preserved.
This file contains information that supplements the generic
installation instructions in file `INSTALL'.
Normal Installation
===================
The simplest way to compile groff is:
1. `cd' to the directory containing groff's source code and type
`./configure' to configure groff for your system. If you are
using `csh' on an old version of System V, you might need to type
`sh ./configure' instead to prevent `csh' from trying to execute
`configure' itself.
Running `configure' takes awhile. While running, it prints some
messages telling which features it is checking for.
2. Type `make' to compile groff.
3. Type `sudo make install' to install the groff programs and any
data files and documentation. `make install' is the only step for
which you need `root' access; this is done by `sudo'.
4. You can remove the groff binaries and object files from the
source code directory by typing `make clean'. To also remove the
files that `configure' created (so you can compile groff for
a different kind of computer), type `make distclean'.
External Installation
=====================
It is also possible to perform the whole installation process outside
of the source code directory. In this case a whole external build
directory structure is created without changing any parts of the source
code tree. This is useful if the source code is read-only or if
several different installations, such as for multiple architectures,
should be constructed.
As an example we assume that the source code of the `groff' code is in
`/usr/local/src/groff', and that the build process should be done
within the directory `/home/my/groff.compile'.
0. Create `/home/my/groff.compile' and change to that directory.
1. Call `/usr/local/src/groff/configure' in that directory to
configure groff for your system. If you are using `csh' on an old
version of System V, you might need to type `sh
/usr/local/src/groff/configure' instead.
2. Type `make' to compile groff in that directory.
3. Type `sudo make install' to install the groff programs and any
data files and documentation.
4. You can remove the groff binaries and object files from the
build directory by typing `make clean'. To also remove the
files that `configure' created (so you can compile the package for
a different kind of computer), type `make distclean'.
Special Platforms
=================
For instructions how to build groff with DJGPP tools for MS-DOS and
MS-Windows, see the file arch/djgpp/README.
For instructions how to build groff with the MinGW tools for
MS-Windows, see the file README.MinGW.
Dependencies
============
groff is written in C++, so you need a C++ compiler. The C++ source
files use a suffix of `.cpp', so your C++ compiler must be able to
handle this. If you don't already have a C++ compiler, we suggest gcc
2.7.1 or later (gcc version 2 includes GNU C++ as well as GNU C). From
gcc 2.5, it is no longer necessary to install libg++: the C++ header
files needed by groff are created by the gcc installation process. To
override configure's choice of C++ compiler, you can set the CXX
environment variable.
If you have a library that provides a faster malloc than your system's
usual malloc, it is good idea to include it in LIBS. For example,
using the malloc that comes with GNU Emacs version 20 can give a
worthwhile (and sometimes spectacular) performance improvement.
Many programs within the `groff' system are written in the Perl
language. So you need a `perl' program with the least version of
`v5.6.1'.
In order to build the documentation you would need `makeinfo' from the
'texinfo' package, in fact `configure' will fail if this program is
not found unless you pass the option `with-doc=no'.
The `uchardet' library is an optional dependency of the `preconv'
program: if this library is found by `configure' it will be
automatically used by `preconv'. In order to discover the presence of
the `uchardet' library you would also need to have the `pkg-config'
program installed on your system.
Miscellaneous
=============
If you want A4 or letter paper format and the configure script produces
an incorrect guess, say
PAGE=xxx ./configure
where `xxx' should be either `A4' or `letter'. Note that this only
affects the paper selection of some device drivers like grops (which
can be still overridden on the command line). For compatibility with
ditroff, the default page length in gtroff is always 11 inches. The
page length can be changed with the `pl' request.
Evaluation
==========
Once groff is built, you can check it for correct operation without
having to install it. groff comes with a test suite; use `make check'
to run it.
You can also try it out from the directory you used to build it. A
script called `test-groff' is supplied for this purpose. It sets up
environment variables to allow groff to run without being installed.
For example, the command
./test-groff -man -Tascii src/roff/groff/groff.1 | less -R
displays the groff(1) man page with the `less' pager. (You might prefer
either the `-Tlatin' or `-Tutf8' option to `-Tascii' depending on the
character set you're using.)
The groff texinfo manual can be previewed as an info document.
info ./doc/groff.info
It can be viewed as text as well (albeit text encoded in ISO Latin-1).
iconv -f latin1 -t utf8 doc/groff.txt | less # for UTF-8 users
less doc/groff.txt # for Latin-1 users
To get a DVI, PDF, or HTML version of the groff texinfo manual, say
`make groff.dvi', `make groff.pdf', or `make groff.html', respectively,
in the `doc' subdirectory (after configuring the groff package).
Texinfo version 5.0 or later is a prerequisite for generation of these
formats. Here are some ways you might view the documents produced.
xdvi doc/groff.dvi
evince doc/groff.pdf
lynx doc/groff.html
In Case of Trouble
==================
If you have problems, read the PROBLEMS file. If this doesn't help
and you need support, please contact the `groff' mailing list. If you
think that you have found a bug, please submit a report to our bug
tracker.
https://savannah.gnu.org/bugs/?group=groff&func=additem
##### Editor settings
Local Variables:
fill-column: 72
mode: text
End:
vim: set textwidth=72: