gcc/libstdc++-v3/doc/xml/api.xml

<?xml version='1.0'?>
<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" 
 "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" 
[ ]>

<book>

<article id="api" xreflabel="API">
<?dbhtml filename="api.html"?>

<articleinfo>
  <title>API Documentation</title>
  <copyright>
    <year>
      2008
    </year>
    <year>
      2010
    </year>
    <holder>
      <ulink url="http://www.fsf.org/">FSF
      </ulink>
    </holder>
  </copyright>
  <legalnotice>
    <para>
      <link linkend="manual.intro.status.license">License 
      </link>
    </para>
  </legalnotice>
</articleinfo>
 
<para>
  The GNU C++ library sources have been specially formatted so that
  with the proper invocation of another tool (Doxygen), a set of
  indexed reference material can generated from the sources files
  themselves. The resultant documentation is referred to as the API
  documentation, and is useful for examining the signatures of public
  member functions for the library classes, finding out what is in a
  particular include file, looking at inheritance diagrams, etc.
</para>

<para>
  The API documentation, rendered into HTML, can be viewed online:
</para>

<itemizedlist>
  <listitem>
    <para>
      <ulink url="http://gcc.gnu.org/onlinedocs/libstdc++/libstdc++-html-USERS-3.4/index.html">for the 3.4 release
      </ulink>
    </para>
  </listitem>
  <listitem>
    <para>
      <ulink url="http://gcc.gnu.org/onlinedocs/libstdc++/libstdc++-html-USERS-4.1/index.html">for the 4.1 release
      </ulink>
    </para>
  </listitem>
  <listitem>
    <para>
      <ulink url="http://gcc.gnu.org/onlinedocs/libstdc++/libstdc++-html-USERS-4.2/index.html">for the 4.2 release
      </ulink>
    </para>
  </listitem>
  <listitem>
    <para>
      <ulink url="http://gcc.gnu.org/onlinedocs/libstdc++/libstdc++-html-USERS-4.3/index.html">for the 4.3 release
      </ulink>
    </para>
  </listitem>
  <listitem>
    <para>
      <ulink url="http://gcc.gnu.org/onlinedocs/libstdc++/libstdc++-html-USERS-4.4/index.html">for the 4.4 release
      </ulink>
    </para>
  </listitem>
  <listitem>
    <para>
      <ulink url="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/index.html">&quot;the latest collection&quot;
      </ulink>
      (For the main development tree; see the date on the first page.)
    </para>
  </listitem>
</itemizedlist>

<para>
  The rendered HTML, as above, is also available for download on the
  gcc.org site in a directory located at
   <literal>&lt;URL:ftp://gcc.gnu.org/pub/gcc/libstdc++/doxygen/&gt;</literal>.
   You will almost certainly need to use one of the
   <ulink url="http://gcc.gnu.org/mirrors.html">mirror sites</ulink> to download
   the tarball. After unpacking, simply load libstdc++-html-*/index.html
   into a browser.
</para>

<para>
  In addition, a rendered set of man pages are available in the same
  location specified above. Start with C++Intro(3).
</para>

</article>

</book>