source: networking/netlibs/geocode-glib.xml@ d5d39eb

<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
   "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
  <!ENTITY % general-entities SYSTEM "../../general.ent">
  %general-entities;

  <!ENTITY geocode-glib-download-http 
           "&gnome-download-http;/geocode-glib/0.99/geocode-glib-&geocode-glib-version;.tar.bz2">
  <!ENTITY geocode-glib-download-ftp  
           "&gnome-download-ftp;/geocode-glib/0.99/geocode-glib-&geocode-glib-version;.tar.bz2">
  <!ENTITY geocode-glib-md5sum        "73ac778225f35ad996ea0345c5abe4b9">
  <!ENTITY geocode-glib-size          "300 KB">
  <!ENTITY geocode-glib-buildsize     "3.0 MB">
  <!ENTITY geocode-glib-time          "less than 0.1 SBU">
]>

<sect1 id="geocode-glib" xreflabel="geocode-glib-&geocode-glib-version;">
  <?dbhtml filename="geocode-glib.html"?>

  <sect1info>
    <othername>$LastChangedBy$</othername>
    <date>$Date$</date>
  </sect1info>

  <title>geocode-glib-&geocode-glib-version;</title>

  <indexterm zone="geocode-glib">
    <primary sortas="a-geocode-glib">geocode-glib</primary>
  </indexterm>

  <sect2 role="package">
    <title>Introduction to geocode-glib</title>

    <para>
      The <application>geocode-glib</application> is a convenience library 
      for the Yahoo! Place Finder APIs. The Place Finder web service allows 
      to do geocoding (finding longitude and latitude from an address), and 
      reverse geocoding (finding an address from coordinates).
    </para>

    &lfs70_checked;

    <bridgehead renderas="sect3">Package Information</bridgehead>
    <itemizedlist spacing="compact">
      <listitem>
        <para>
          Download (HTTP): <ulink url="&geocode-glib-download-http;"/>
        </para>
      </listitem>
      <listitem>
        <para>
          Download (FTP): <ulink url="&geocode-glib-download-ftp;"/>
        </para>
      </listitem>
      <listitem>
        <para>
          Download MD5 sum: &geocode-glib-md5sum;
        </para>
      </listitem>
      <listitem>
        <para>
          Download size: &geocode-glib-size;
        </para>
      </listitem>
      <listitem>
        <para>
          Estimated disk space required: &geocode-glib-buildsize;
        </para>
      </listitem>
      <listitem>
        <para>
          Estimated build time: &geocode-glib-time;
        </para>
      </listitem>
    </itemizedlist>

    <bridgehead renderas="sect3">geocode-glib Dependencies</bridgehead>

    <bridgehead renderas="sect4">Required</bridgehead>
    <para role="required">
      <xref linkend="json-glib"/> and
      <xref linkend="libsoup"/>
    </para>

    <bridgehead renderas="sect4">Recommended</bridgehead>
    <para role="recommended">
      <xref linkend="gobject-introspection"/>
      (Required if building GNOME)
    </para>

    <bridgehead renderas="sect4">Optional</bridgehead>
    <para role="optional">
      <xref linkend="gtk-doc"/>
    </para>

    <para condition="html" role="usernotes">
      User Notes: <ulink url="&blfs-wiki;/geocode-glib"/>
    </para>
  </sect2>

  <sect2 role="installation">
    <title>Installation of geocode-glib</title>

    <para>
      Install <application>geocode-glib</application> by running the following
      commands:
    </para>

<screen><userinput>./configure --prefix=/usr &amp;&amp;
make</userinput></screen>

    <para>
      To test the results, issue: <command>make check</command>.
    </para>

    <para>
      Now, as the <systemitem class="username">root</systemitem> user:
    </para>

<screen role="root"><userinput>make install</userinput></screen>
  </sect2>

  <sect2 role="commands">
    <title>Command Explanations</title>

    <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
      href="../../xincludes/gtk-doc-rebuild.xml"/>

  </sect2>

  <sect2 role="content">
    <title>Contents</title>

    <segmentedlist>
      <segtitle>Installed Library</segtitle>
      <segtitle>Installed Directories</segtitle>

      <seglistitem>
        <seg>
          libgeocode-glib.so
        </seg>
        <seg>
          /usr/include/geocode-glib and
          /usr/share/gtk-doc/html/geocode-glib
        </seg>
      </seglistitem>
    </segmentedlist>

    <variablelist>
      <bridgehead renderas="sect3">Short Descriptions</bridgehead>
      <?dbfo list-presentation="list"?>
      <?dbhtml list-presentation="table"?>

      <varlistentry id="libgeocode-glib">
        <term><filename class="libraryfile">libgeocode-glib.so</filename></term>
        <listitem>
          <para>
            contains the geocode-glib API functions.
          </para>
          <indexterm zone="geocode-glib libgeocode-glib">
            <primary sortas="c-libgeocode-glib">libgeocode-glib.so</primary>
          </indexterm>
        </listitem>
      </varlistentry>

    </variablelist>

  </sect2>

</sect1>