root/current/host/trunk/empath/trunk/empath.1.xml

<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN" "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd">
<!-- lifted from troff+man by doclifter -->
<!-- generate manpage using
xsltproc -''-nonet http://docbook.sourceforge.net/release/xsl/current/manpages/docbook.xsl  empath.1.xml
-->
<book label="empath" status="0.0.2">
  <bookinfo>
    <title>em_make</title>
    <date>Fri Mar 23 08:55:56 2007</date>
    <releaseinfo>Release: 0.0.2</releaseinfo>
  </bookinfo>
  <chapter label="1" id="manpages">
    <title>EMDEBIAN</title>
    <refentry id="empath">
      <refentryinfo>
        <productname>empath</productname>
        <productnumber/>
      </refentryinfo>
      <refmeta>
        <refentrytitle>empath</refentrytitle>
        <manvolnum>1</manvolnum>
        <refmiscinfo class="source">EMDEBIAN-TOOLS</refmiscinfo>
        <refmiscinfo class="manual">EMDEBIAN-TOOLS</refmiscinfo>
      </refmeta>
      <refnamediv id="name">
        <refname>empath</refname>
        <refpurpose>Generate a path to cross-build a target package.</refpurpose>
      </refnamediv>
      <refsynopsisdiv>
        <cmdsynopsis>
          <command>empath</command>
          <arg>
            <group>
              <arg>-d</arg>
              <arg>--debug</arg>
            </group>
          </arg>
          <arg>-p</arg>
          <arg>--package</arg>
          <replaceable> PACKAGE</replaceable>
        </cmdsynopsis>
        <cmdsynopsis>
          <command>empath</command>
          <group>
            <arg>-l</arg>
            <arg>--list</arg>
          </group>
        </cmdsynopsis>
        <cmdsynopsis>
          <command>empath</command>
          <group>
            <arg>-?</arg>
            <arg>-h</arg>
            <arg>--help</arg>
          </group>
        </cmdsynopsis>
      </refsynopsisdiv>
      <refsect1 id="description">
        <title>DESCRIPTION</title>
        <para><filename>empath</filename>
                Starting with a known package set and a need to cross-build
                a new package set from upstream Debian packages, empath plots
                a cross-building path through the dependencies to identify
                the required sequence to build the new packages, starting with
                packages that only depend on the currently available set.
                </para>
      </refsect1>
      <refsect1 id="options">
        <title>OPTIONS</title>
        <variablelist>
          <varlistentry>
            <term>
                        <option>-d</option> | <option>--debug</option>
                        </term>
            <listitem>
              <para>Enable debug messages to help track down circular
                                dependencies or follow the progress of long paths. 
                          </para>
            </listitem>
          </varlistentry>
          <varlistentry>
            <term><option>-p</option> | <option>--package</option>
                        <replaceable>PACKAGE</replaceable>
                        </term>
            <listitem>
              <para>Specify the target package name to try to build from
                        the current base set. <emphasis>empath</emphasis> uses the
                        Build-Depends to determine which dependencies of the target can be
                        cross-built from the current base set of packages which could be 
                        just the cross-building toolchain packages.</para>
            </listitem>
          </varlistentry>
          <varlistentry>
            <term><option>-l</option> | <option>--list</option></term>
            <listitem>
              <para>List the current set of packages that will be 
                        ignored when looking up the build dependencies of the target 
                        packages. These are packages that need to be installed on the 
                        cross-building host but do not need to be installed on the 
                        embedded target device.
                        </para>
            </listitem>
          </varlistentry>
        </variablelist>
      </refsect1>
      <refsect1 id="seealso">
        <title>SEE ALSO</title>
        <para>See also <emphasis>emdebian-tools</emphasis> (1).
                </para>
      </refsect1>
    </refentry>
  </chapter>
</book>