1 files changed, 94 insertions, 0 deletions
diff --git a/doc/scripts/man-create_makefile.1.docbook b/doc/scripts/man-create_makefile.1.docbook
new file mode 100644
index 00000000..553e2512
--- /dev/null
+++ b/doc/scripts/man-create_makefile.1.docbook
@@ -0,0 +1,94 @@
+<?xml version="1.0" ?>
+<!DOCTYPE refentry PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [
+<!ENTITY kdeoptions SYSTEM "kdeoptions.docbook">
+<!ENTITY qtoptions SYSTEM "qtoptions.docbook">
+<!ENTITY % English "INCLUDE">
+]>
+
+<refentry lang="&language;">
+<refentryinfo>
+<date>March 8, 2003</date>
+</refentryinfo>
+
+<refmeta>
+<refentrytitle><command>create_makefile</command></refentrytitle>
+<manvolnum>1</manvolnum>
+</refmeta>
+
+<refnamediv>
+<refname><command>create_makefile</command></refname>
+<refpurpose>Creates <filename>Makefile.in</filename> and <filename>Makefile</filename> from a <filename>Makefile.am</filename></refpurpose>
+</refnamediv>
+
+<refsynopsisdiv>
+<cmdsynopsis>
+<command>create_makefile</command>
+<group><replaceable>relativepath/Makefile</replaceable></group>
+<group><replaceable>relativepath</replaceable></group>
+</cmdsynopsis>
+</refsynopsisdiv>
+
+<refsect1>
+<title>Description</title>
+
+<para><command>create_makefile</command> creates the
+<filename>Makefile.in</filename> and <filename>Makefile</filename> in
+a subdirectory containing a <filename>Makefile.am</filename>.  This
+script saves time compared to re-running configure completely</para>
+
+<para>Note that you must supply the path to the desired
+<filename>Makefile</filename> <filename>Makefile.am</filename> (though
+the final <filename>/Makefile</filename> may be omitted).</para>
+
+<para>This script may be run from the toplevel directory (the one
+containing <filename>configure</filename> or from one of it's
+subdirectories.</para>
+
+<para>If the source directory is different from the build directory
+(see the environment variables below), it will be assumed that the
+<filename>Makefile.am</filename> and <filename>Makefile.in</filename>
+belong beneath the source directory and that the
+<filename>Makefile</filename> belongs beneath the build
+directory. </para>
+
+<para>This utility is part of the &kde; Software Development Kit.</para>
+
+</refsect1>
+
+<refsect1>
+<title>Environment</title>
+
+<para>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 <envar>OBJ_SUBDIR</envar> should be used. </para>
+
+<variablelist>
+<varlistentry>
+<term><envar>OBJ_SUBJDIR</envar></term>
+<listitem><para>Indicates that the build directory is in the given subdirectory of the source directory. For instance, if the source directory is <filename class="directory">kdesdk</filename> and the build directory is <filename class="directory">kdesdk/obj-i386-linux</filename>, then <envar>OBJ_SUBDIR</envar> should be set to <parameter>obj-i386-linux</parameter>.</para></listitem>
+</varlistentry>
+<varlistentry>
+<term><envar>OBJ_REPLACEMENT</envar></term>
+<listitem><para>A <command>sed</command> expression that is used to transform the source directory into the build directory.  For instance, if the source directory is <filename class="directory">kdesdk/obj-i386-linux</filename>, then <envar>OBJ_REPLACEMENT</envar> should be set to <parameter>s#kdesdk#kdesdk-obj#</parameter>.</para>
+</listitem>
+</varlistentry>
+</variablelist>
+
+</refsect1>
+
+<refsect1>
+<title>See Also</title>
+
+<para>create_makefiles(1)</para>
+</refsect1>
+<refsect1>
+<title>Authors</title>
+
+<para>create_makefile was written by &David.Faure; &David.Faure.mail; and
+ others.  This manual page was prepared by
+ <personname><firstname>Ben</firstname><surname>Burton</surname></personname>
+ <email>bab@debian.org</email> for the Debian GNU/Linux system (but may be
+ used by others).</para>
+</refsect1>
+</refentry>