summaryrefslogtreecommitdiff
path: root/INSTALL.REPO
blob: c08a5c99a9ef454876b668653fbdde0c90ec243f (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
    Copyright 2013
      Free Software Foundation, Inc.

    Last Update: 23 Dec 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.gen'.  It is meant for
people building directly from the development repository, rather than
a release or snapshot tarball .

If you want to start compiling the `groff' system with an existing
script `configure' you won't need the information in 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 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 currently, however, we plan to convert the
build system accordingly.  If you have experience in creating
`Makefile.am' files we would be glad if you could help us in the
conversion process.  Please contact the groff mailing list.

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.