summaryrefslogtreecommitdiff
path: root/INSTALL.CVS
blob: 17b93a39bafbd1f94d50771fbbeb73058c863cb5 (plain)
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
    Copyright 2013
      Free Software Foundation, Inc.

    Last Update: 16 Apr 2013

    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.autotools'.


If you want to start compiling the `groff' system with an existing
script `configure' you won't need the information ion this file.


But if you want to use the `GNU autotools' (`aclocal', `autoreconf')
for creating the following and some more files:

    aclocal.m4
    configure
    Makefile


To change the file `aclocal.m4', run the shell command

    $ aclocal -I m4


To recreate the files `configure' and `Makefile', use the shell command

    $ autoreconf -I m4


The option `-I m4' is necessary.  It refers to the subdirectory `m4'
that has files with m4 macro definitions that are needed by the
`autotools'.


If you use an old `autoreconf' version < 2.69, there might be an
error warning like:

    /usr/share/aclocal/gtkglextmm-1.2.m4:225: warning: underquoted \
definition of AC_GTKGLEXTMM_SUPPORTS_MULTIHEAD
    /usr/share/aclocal/gtkglextmm-1.2.m4:225:   run info \
'(automake)Extending aclocal'
    /usr/share/aclocal/gtkglextmm-1.2.m4:225:   or see \
http://www.gnu.org/software/automake/manual/automake.html#Extending-aclocal

Just ignore this.  It doesn't occur in the actual versions of `autoreconf'.


You may even use the shell command

    $ autoconf

instead of `autoreconf', but that will ignore some features.  So
`autoreconf' is better.


`automake' is not used.  `autoreconf' does part of this.  If you know
about creating `Makefile.am' files we are glad to have you for the
inclusion of `automake'.  Take contact with the `groff Mailinglist'.


After the use of the `GNU autotools', the usual compilation should
work.  If the run of `configure' produces error reports you have
produced errors in the `autotools' modification.