summaryrefslogtreecommitdiffstats
path: root/doc/man/scripts/create_makefiles.1
diff options
context:
space:
mode:
Diffstat (limited to 'doc/man/scripts/create_makefiles.1')
-rw-r--r--doc/man/scripts/create_makefiles.163
1 files changed, 63 insertions, 0 deletions
diff --git a/doc/man/scripts/create_makefiles.1 b/doc/man/scripts/create_makefiles.1
new file mode 100644
index 00000000..2efc0379
--- /dev/null
+++ b/doc/man/scripts/create_makefiles.1
@@ -0,0 +1,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).