z69.html

GTK+_ Gnome Application Development

            values of <span class="STRUCTNAME">PACKAGE</span> and
            <span class="STRUCTNAME">VERSION</span>, defined in <tt
            class="FILENAME">config.h</tt>.) &#13;
          </p>
        </li>
        <li>
          <p>
            <span class="SYMBOL">AM_MAINTAINER_MODE</span> turns
            off maintainer-only makefile targets by default, and
            changes <tt class="FILENAME">configure</tt> to
            understand a <tt class="APPLICATION">
            --enable-maintainer-mode</tt> option. <tt class= 
            "APPLICATION">--enable-maintainer-mode</tt> turns the
            maintainer-only targets back on. The maintainer-only
            makefile targets permit end users to clean
            automatically-generated files such as <tt class= 
            "FILENAME">configure</tt>, which means they have to
            have <tt class="APPLICATION">autoconf</tt> and <tt
            class="APPLICATION">automake</tt> installed to repair
            the damage. <span class="SYMBOL">
            AM_MAINTAINER_MODE</span> makes it a bit harder for
            users to shoot themselves in the foot. Note, however,
            that the <tt class="FILENAME">autogen.sh</tt> script
            used in Gnome automatically passes <tt class= 
            "APPLICATION">--enable-maintainer-mode</tt> to <tt
            class="FILENAME">configure</tt>, since <tt class= 
            "FILENAME">autogen.sh</tt> is intended for developers
            to use. &#13;
          </p>
        </li>
        <li>
          <p>
            <span class="SYMBOL">AM_ACLOCAL_INCLUDE</span>
            specifies an additional directory in which to search
            for <tt class="APPLICATION">m4</tt> macros. In this
            case, it specifies the <tt class="FILENAME">macros</tt>
            subdirectory, where you should have copied the Gnome
            macros. &#13;
          </p>
        </li>
        <li>
          <p>
            <span class="SYMBOL">GNOME_INIT</span> adds a number of
            Gnome-related command-line arguments to <tt class= 
            "FILENAME">configure</tt>, and defines makefile
            variables containing the necessary preprocessor and
            linker flags for Gnome programs. These flags are
            obtained from a <tt class="APPLICATION">
            gnome-config</tt> script installed by the <tt class= 
            "APPLICATION">gnome-libs</tt> package. &#13;
          </p>
        </li>
        <li>
          <p>
            <span class="SYMBOL">AC_PROG_CC</span> locates the C
            compiler. &#13;
          </p>
        </li>
        <li>
          <p>
            <span class="SYMBOL">AC_ISC_POSIX</span> adds some
            flags needed for POSIX compatibility on certain
            platforms. &#13;
          </p>
        </li>
        <li>
          <p>
            <span class="SYMBOL">AC_HEADER_STDC</span> checks
            whether the present system has the standard ANSI header
            files, and defines <tt class="FUNCTION">
            STDC_HEADERS</tt> if so. &#13;
          </p>
        </li>
        <li>
          <p>
            <span class="SYMBOL">AC_ARG_PROGRAM</span> adds options
            to <tt class="FILENAME">configure</tt> so that users
            can modify the name of an installed program. (Useful if
            your program happens to have the same name as some
            locally-installed program on their system.) &#13;
          </p>
        </li>
        <li>
          <p>
            <span class="SYMBOL">AM_PROG_LIBTOOL</span> is used by
            <tt class="APPLICATION">automake</tt> to set up its use
            of <tt class="APPLICATION">libtool</tt>. This is only
            required if you are planning to build a shared library
            or dynamically loadable modules; it is unnecessary for
            this early version of GnomeHello, but we're planning
            ahead. &#13;
          </p>
        </li>
        <li>
          <p>
            <span class="SYMBOL">GNOME_COMPILE_WARNINGS</span> adds
            a number of warning options to the <tt class= 
            "APPLICATION">gcc</tt> command line, but does nothing
            for most other compilers. &#13;
          </p>
        </li>
        <li>
          <p>
            <tt class="APPLICATION">ALL_LINGUAS="es"</tt> is not a
            macro, just a bit of shell code. It contains a
            space-separated list of language abbreviations,
            corresponding to <tt class="APPLICATION">.po</tt> files
            in the <tt class="APPLICATION">po</tt> subdirectory.
            (<tt class="APPLICATION">.po</tt> files contain
            translations into other languages, so <tt class= 
            "APPLICATION">ALL_LINGUAS</tt> should list all
            languages your program has been translated into.) &#13;
          </p>
        </li>
        <li>
          <p>
            <span class="SYMBOL">AM_GNU_GETTEXT</span> is used by
            <tt class="APPLICATION">automake</tt>, but the macro
            itself is distributed with the <tt class="APPLICATION">
            gettext</tt> package. It causes <tt class=
            "APPLICATION">automake</tt> to perform a number of
            internationalization-related tasks. &#13;
          </p>
        </li>
        <li>
          <p>
            <span class="SYMBOL">AC_SUBST</span> "exports" a
            variable into the files generated by <tt class=
            "FILENAME">configure</tt>. More on this below. &#13;
          </p>
        </li>
        <li>
          <p>
            <span class="SYMBOL">AC_OUTPUT</span> lists the files
            to be created by the <tt class="FILENAME">
            configure</tt> script. These will be created from a
            file with the same name, with <tt class="APPLICATION">
            .in</tt> appended. For example, the output file <tt
            class="APPLICATION">src/Makefile</tt> is generated from
            <tt class="APPLICATION">src/Makefile.in</tt>, and <tt
            class="APPLICATION">config.h</tt> comes from <tt class= 
            "APPLICATION">config.h.in</tt>. &#13;
          </p>
        </li>
      </ul>
      <p>
        In the <tt class="APPLICATION">AC_OUTPUT</tt> stage, <tt
        class="APPLICATION">configure</tt> processes files
        containing variables marked with two <tt class=
        "APPLICATION">@</tt> symbols; for example, <tt class= 
        "APPLICATION">@PACKAGE@</tt>. It recognizes such variables
        only if <span class="SYMBOL">AC_SUBST</span> was used to
        "export" the variable (many of the pre-written macros
        discussed above use <span class="SYMBOL">AC_SUBST</span> to
        define variables). Most commonly, this features is used to
        convert a <tt class="FILENAME">Makefile.in</tt> to a <tt
        class="FILENAME">Makefile</tt>. <tt class="FILENAME">
        Makefile.in</tt> is typically generated by <tt class= 
        "APPLICATION">automake</tt> from <tt class="FILENAME">
        Makefile.am</tt>. (However, you can use <tt class= 
        "APPLICATION">autoconf</tt> without <tt class=
        "APPLICATION">automake</tt>, and write <tt class=
        "FILENAME">Makefile.in</tt> yourself.)
      </p>
    </div>
    <div class="NAVFOOTER">
      <br>
      <br>
      <table width="100%" border="0" bgcolor="#ffffff" cellpadding= 
      "1" cellspacing="0">
        <tr>
          <td width="25%" bgcolor="#ffffff" align="left">
            <a href="z68.html"><font color="#0000ff" size="2"><b>
            &lt;&lt;&lt; Previous</b></font></a>
          </td>
          <td width="25%" colspan="2" bgcolor="#ffffff" align= 
          "center">
            <font color="#0000ff" size="2"><b><a href="ggad.html">
            <font color="#0000ff" size="2"><b>
            Home</b></font></a></b></font>
          </td>
          <td width="25%" bgcolor="#ffffff" align="right">
            <a href="z70.html"><font color="#0000ff" size="2"><b>
            Next &gt;&gt;&gt;</b></font></a>
          </td>
        </tr>
        <tr>
          <td colspan="2" align="left">
            <font color="#000000" size="2"><b>Source Tree
            Checklist</b></font>
          </td>
          <td colspan="2" align="right">
            <font color="#000000" size="2"><b><tt class="FILENAME">
            Makefile.am</tt></b></font>
          </td>
        </tr>
      </table>
    </div>
  </body>
</html>