File indexing completed on 2024-11-17 05:08:32

0001 <?xml version="1.0" ?>
0002 <!DOCTYPE refentry PUBLIC "-//KDE//DTD DocBook XML V4.5-Based Variant V1.1//EN" "dtd/kdedbx45.dtd" [
0003 <!ENTITY kdeoptions SYSTEM "kdeoptions.docbook">
0004 <!ENTITY qtoptions SYSTEM "qtoptions.docbook">
0005 <!ENTITY % English "INCLUDE">
0006 ]>
0007 
0008 <refentry lang="&language;">
0009 <refentryinfo>
0010 <date>2003-03-08</date>
0011 </refentryinfo>
0012 
0013 <refmeta>
0014 <refentrytitle><command>create_makefile</command></refentrytitle>
0015 <manvolnum>1</manvolnum>
0016 </refmeta>
0017 
0018 <refnamediv>
0019 <refname><command>create_makefile</command></refname>
0020 <refpurpose>Creates <filename>Makefile.in</filename> and <filename>Makefile</filename> from a <filename>Makefile.am</filename></refpurpose>
0021 </refnamediv>
0022 
0023 <refsynopsisdiv>
0024 <cmdsynopsis>
0025 <command>create_makefile</command>
0026 <group><replaceable>relativepath/Makefile</replaceable></group>
0027 <group><replaceable>relativepath</replaceable></group>
0028 </cmdsynopsis>
0029 </refsynopsisdiv>
0030 
0031 <refsect1>
0032 <title>Description</title>
0033 
0034 <para><command>create_makefile</command> creates the
0035 <filename>Makefile.in</filename> and <filename>Makefile</filename> in
0036 a subdirectory containing a <filename>Makefile.am</filename>.  This
0037 script saves time compared to re-running configure completely</para>
0038 
0039 <para>Note that you must supply the path to the desired
0040 <filename>Makefile</filename> <filename>Makefile.am</filename> (though
0041 the final <filename>/Makefile</filename> may be omitted).</para>
0042 
0043 <para>This script may be run from the toplevel directory (the one
0044 containing <filename>configure</filename>) or from one of it's
0045 subdirectories.</para>
0046 
0047 <para>If the source directory is different from the build directory
0048 (see the environment variables below), it will be assumed that the
0049 <filename>Makefile.am</filename> and <filename>Makefile.in</filename>
0050 belong beneath the source directory and that the
0051 <filename>Makefile</filename> belongs beneath the build
0052 directory. </para>
0053 
0054 <para>This utility is part of the &kde; Software Development Kit.</para>
0055 
0056 </refsect1>
0057 
0058 <refsect1>
0059 <title>Environment</title>
0060 
0061 <para>One of the following variables (but not both) should be set if
0062 the source directory is different from the build directory. If the
0063 build directory is simply a subdirectory of the source directory, the
0064 simpler variable <envar>OBJ_SUBDIR</envar> should be used. </para>
0065 
0066 <variablelist>
0067 <varlistentry>
0068 <term><envar>OBJ_SUBJDIR</envar></term>
0069 <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>
0070 </varlistentry>
0071 <varlistentry>
0072 <term><envar>OBJ_REPLACEMENT</envar></term>
0073 <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">~/src/kdesdk</filename> and the build directory is <filename class="directory">~/src/kdesdk-obj</filename>, then <envar>OBJ_REPLACEMENT</envar> should be set to <parameter>s#kdesdk#kdesdk-obj#</parameter>.</para></listitem>
0074 </varlistentry>
0075 </variablelist>
0076 
0077 </refsect1>
0078 
0079 <refsect1>
0080 <title>See Also</title>
0081 
0082 <para>create_makefiles(1)</para>
0083 </refsect1>
0084 <refsect1>
0085 <title>Authors</title>
0086 
0087 <para>create_makefile was written by &David.Faure; &David.Faure.mail; and
0088  others.  This manual page was prepared by
0089  <personname><firstname>Ben</firstname><surname>Burton</surname></personname>
0090  <email>bab@debian.org</email> for the Debian GNU/Linux system (but may be
0091  used by others).</para>
0092 </refsect1>
0093 </refentry>