source: general/genutils/time.xml@ 2d56483

<?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 time-download-http "http://ftp.gnu.org/gnu/time/time-1.7.tar.gz">
  <!ENTITY time-download-ftp  "ftp://ftp.gnu.org/gnu/time/time-1.7.tar.gz">
  <!ENTITY time-md5sum        "e38d2b8b34b1ca259cf7b053caac32b3">
  <!ENTITY time-size          "101 KB">
  <!ENTITY time-buildsize     "640 KB">
  <!ENTITY time-time          "Less than 0.1 SBU">
]>

<!-- Try to keep the indentation used in this file-->
<sect1 id="time" xreflabel="time-&time-version;">
  <?dbhtml filename="time.html"?>

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

  <!-- No other tags inside any title.
       Use Title Case in All Titles -->
  <title>Time-&time-version;</title>

  <indexterm zone="time">
    <primary sortas="a-time">time</primary>
  </indexterm>

  <!--Required section-->
  <sect2 role="package">
    <title>Introduction to Time</title>

    <para>
      The <application>time</application> utility is a program that
      measures many of the CPU resources, such as time and memory, that
      other programs use.  The GNU version can format the output in
      arbitrary ways by using a printf-style format string to include
      various resource measurements.
    </para>
    <para>
      Although the shell has a builtin command providing similar
      functionalities, this utility is reuired by the LSB.
    </para>

    &lfs75_checked;

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

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

  <sect2 role="installation">
    <title>Installation of Time</title>

    <para>
      Install <application>Time</application> by running the following
      commands:
    </para>

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

    <para>
      This package does not come with a test suite.
    </para>

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

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

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

    <segmentedlist>
      <segtitle>Installed Program(s)</segtitle>

      <!-- If there were no programs, libraries, or directories created, then
           we would list the section as "None". However, a decision must have
           been made to change the "None" to just removing the whole section
           because I've noticed that many packages have had the "None"
           removed and the section completely removed as well. The reasoning
           was that by putting "None", it appears as we know there are none.
           Without anything it appears as we are not sure. -->

      <seglistitem>
        <seg>
          time.
        </seg>
      </seglistitem>
    </segmentedlist>

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

      <varlistentry id="time-prog">
        <term><command>time</command></term>
        <listitem>
          <para>
            reports various srtatistics about an executed command.
          </para>
          <indexterm zone="time time-prog">
            <primary sortas="b-time">time</primary>
          </indexterm>
        </listitem>
      </varlistentry>
    </variablelist>
  </sect2>
</sect1>