summaryrefslogtreecommitdiffstats
path: root/doc/man/scripts/create_makefiles.1
blob: 2efc0379516e162078de207e8deeb23f3ae029bc (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
.\"                                      Hey, EMACS: -*- nroff -*-
.\" First parameter, NAME, should be all caps
.\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
.\" other parameters are allowed: see man(7), man(1)
.TH CREATE_MAKEFILES 1 "September 27, 2002"
.\" Please adjust this date whenever revising the manpage.
.\"
.\" Some roff macros, for reference:
.\" .nh        disable hyphenation
.\" .hy        enable hyphenation
.\" .ad l      left justify
.\" .ad b      justify to both left and right margins
.\" .nf        disable filling
.\" .fi        enable filling
.\" .br        insert line break
.\" .sp <n>    insert n+1 empty lines
.\" for manpage-specific macros, see man(7)
.SH NAME
create_makefiles \- recreates all Makefiles beneath a directory
.SH SYNOPSIS
.B create_makefiles
.I dir
.SH DESCRIPTION
\fBcreate_makefiles\fP recreates all \fIMakefile\fPs in
\fIdir\fP and its (recursed) subdirectories from the corresponding
\fIMakefile.am\fP templates.
.PP
This script must be run from the toplevel directory (the
one containing \fIconfigure\fP).
This script saves time compared to re-running configure completely.
.PP
If the source directory is different from the build directory (see the
environment variables below), it will be assumed that each \fIMakefile.am\fP
and \fIMakefile.in\fP belongs beneath the source directory and that each
\fIMakefile\fP belongs beneath the build directory.
.PP
This utility is part of the TDE Software Development Kit.
.SH ENVIRONMENT VARIABLES
One of the following variables (but not both) should be set if the
source
directory is different from the build directory.
If the build directory is simply a subdirectory of the source directory,
the simpler variable OBJ_SUBDIR should be used.
.TP
OBJ_SUBDIR
Indicates that the build directory is in the given subdirectory of the
source directory.  For instance, if the source directory is \fItdesdk\fP
and the build directory is \fItdesdk/obj-i386-linux\fP, then OBJ_SUBDIR
should be set to \fIobj-i386-linux\fP.
.TP
OBJ_REPLACEMENT
A \fBsed\fP expression that is used to transform the source directory
into the build directory.
For instance, if the source directory is \fI~/src/tdesdk\fP and the
build directory is \fI~/src/tdesdk-obj\fP, then OBJ_REPLACEMENT could
be set to \fIs#tdesdk#tdesdk-obj#\fP.
.SH SEE ALSO
.BR create_makefile (1).
.SH AUTHOR
create_makefiles was written by David Faure <faure@kde.org>.
.br
This manual page was prepared by Ben Burton <bab@debian.org>
for the Debian GNU/Linux system (but may be used by others).