File indexing completed on 2024-03-24 05:44:44

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 create_makefiles "<command>create_makefiles</command>">
0004 <!ENTITY % English "INCLUDE">
0005 ]>
0006 
0007 <refentry lang="&language;">
0008 <refentryinfo>
0009 <date>2003-03-08</date>
0010 </refentryinfo>
0011 
0012 <refmeta>
0013 <refentrytitle>&create_makefiles;</refentrytitle>
0014 <manvolnum>1</manvolnum>
0015 </refmeta>
0016 
0017 <refnamediv>
0018 <refname>&create_makefiles;</refname>
0019 <refpurpose>Recreates all <filename>Makefile</filename>s beneath a directory</refpurpose>
0020 </refnamediv>
0021 
0022 <refsynopsisdiv>
0023 <cmdsynopsis>
0024 &create_makefiles;
0025 <group><replaceable>dir</replaceable></group>
0026 
0027 </cmdsynopsis>
0028 </refsynopsisdiv>
0029 
0030 <refsect1>
0031 <title>Description</title>
0032 
0033 <para>&create_makefiles; recreates all <filename>Makefile</filename>s
0034 in <replaceable>dir</replaceable> and its
0035 (recursed) subdirectories from the corresponding
0036 <filename>Makefile.am</filename> templates.</para>
0037 
0038 <para>This script must be run from the toplevel directory (the one
0039 containing configure). This script saves time compared to re-running
0040 configure completely.</para>
0041 
0042 <para>If the source directory is different from the build directory
0043 (see the environment variables below), it will be assumed that each
0044 <filename>Makefile.am</filename> and <filename>Makefile.in</filename>
0045 belongs beneath the source directory and that each
0046 <filename>Makefile</filename> belongs beneath the build
0047 directory.</para>
0048 
0049 <para>This utility is part of the &kde; Software Development Kit.</para>
0050 </refsect1>
0051 
0052 
0053 <refsect1>
0054 <title>Environment</title>
0055 <para>One of the following variables (but not both) should be set if
0056 the source directory is different from the build directory. If the
0057 build directory is simply a subdirectory of the source directory, the
0058 simpler variable <envar>OBJ_SUBDIR</envar> should be used. </para>
0059 
0060 <variablelist>
0061 <varlistentry>
0062 <term><envar>OBJ_SUBJDIR</envar></term>
0063 <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>
0064 </varlistentry>
0065 <varlistentry>
0066 <term><envar>OBJ_REPLACEMENT</envar></term>
0067 <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>
0068 </listitem>
0069 </varlistentry>
0070 </variablelist>
0071 </refsect1>
0072 
0073 <refsect1>
0074 <title>See Also</title>
0075 
0076 <para>create_makefile(1) make(2)</para>
0077 
0078 </refsect1>
0079 
0080 <refsect1>
0081 <title>Authors</title>
0082 
0083 <para>&create_makefiles; was written by &David.Faure; &David.Faure.mail;.</para>
0084 
0085 <para>This manual page was prepared by
0086 <personname><firstname>Ben</firstname><surname>Burton</surname></personname>
0087 <email>bab@debian.org</email> for the Debian GNU/Linux system (but may be
0088 used by others).</para>
0089  
0090 </refsect1>
0091 
0092 </refentry>