ALT Linux Sisyphus

<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.1.2-Based Variant V1.0//EN" "dtd/kdex.dtd" [
  <!ENTITY kappname "&kunit;">
  <!ENTITY kunit "<application>KUnit</application>">
  <!ENTITY % addindex "IGNORE">
  <!ENTITY % English "INCLUDE" > <!-- change language only here -->
]>
<!-- Important note: please use template.docbook instead of this file.
     This is only the conversion of app.sgml into DocBook SGML.
     template.docbook gives you more information on what you can and
     should do.  Thanks. -->

<book lang="&language;">

  <bookinfo>
    <title>The KUnit Handbook</title>
    <authorgroup>
      <author>
        <firstname>Jan</firstname>
        <surname>Schaumann</surname>
        <affiliation><address><email>jschauma@netmeister.org</email></address></affiliation>
      </author>
    </authorgroup>
    <date>05/29/2001</date>
    <releaseinfo>0.5</releaseinfo>
    <abstract>
      <para>This Handbook describes KUnit Version 0.5</para>
    </abstract>
    <keywordset>
      <keyword>KDE</keyword>
      <keyword>KUnit</keyword>
      <keyword>units</keyword>
    </keywordset>
  </bookinfo>

  <chapter id="introduction">
    <title>Introduction</title>
    <para><emphasis>&kunit;</emphasis> is a simple program to convert various units.</para>
    <para><emphasis>&kunit;</emphasis> currently converts the following categories:</para>
    <itemizedlist>
		<listitem><para>acceleration</para></listitem>
		<listitem><para>angle</para></listitem>
		<listitem><para>angular acceleration</para></listitem>
		<listitem><para>angular velocity</para></listitem>
		<listitem><para>area</para></listitem>
		<listitem><para>bits and bytes</para></listitem>
		<listitem><para>capacitance</para></listitem>
		<listitem><para>charge</para></listitem>
		<listitem><para>colors</para></listitem>
		<listitem><para>current</para></listitem>
		<listitem><para>energy</para></listitem>
		<listitem><para>force</para></listitem>
		<listitem><para>illuminance</para></listitem>
		<listitem><para>inductance</para></listitem>
		<listitem><para>length</para></listitem>
		<listitem><para>luminance</para></listitem>
		<listitem><para>magnetic flux</para></listitem>
		<listitem><para>mass (or weight)</para></listitem>
		<listitem><para>power</para></listitem>
		<listitem><para>pressure</para></listitem>
		<listitem><para>Shoe Sizes</para></listitem>
		<listitem><para>SI prefixes</para></listitem>
		<listitem><para>specific heat</para></listitem>
		<listitem><para>temperature</para></listitem>
		<listitem><para>thermal conductivity</para></listitem>
		<listitem><para>time</para></listitem>
		<listitem><para>torque</para></listitem>
		<listitem><para>velocity</para></listitem>
		<listitem><para>viscosity (dynamic)</para></listitem>
		<listitem><para>viscosity (kinematic)</para></listitem>
		<listitem><para>voltage</para></listitem>
		<listitem><para>volume</para></listitem>
    </itemizedlist>

  </chapter>

  <chapter id="installation">
    <title>Installation</title>

    <sect1 id="how-to-obtain-kunit">
      <title>How to obtain KUnit</title>
      <para><emphasis>&kunit;</emphasis> 0.5 can be obtained from:</para>
      <itemizedlist>
		<listitem><para><ulink url="http://www.netmeister.org/apps/kunit-0.5.tar.gz">http://www.netmeister.org/apps/kunit-0.5.tar.gz</ulink></para></listitem>
      </itemizedlist>
	  <para>Older versions can be downloaded from <ulink url="http://www.netmeister.org/apps/">here</ulink></para>
   </sect1>

    <sect1 id="requirements">
      <title>Requirements</title>

      <para>In order to successfully compile and use <emphasis>&kunit;</emphasis>, you need the following programs and libraries which are available on most platforms as distribution packages and thereby can be installed easily.</para>
      <para><emphasis>Required:</emphasis></para>
      <itemizedlist>
		<listitem><para>g++ 2.7.2/g++ 2.8.1/egcs 1.1 (or compatible), available at <ulink url="http://www.gnu.org">http://www.gnu.org</ulink></para></listitem>
		<listitem><para>GNU make (or compatible), available at <ulink url="http://www.gnu.org">http://www.gnu.org</ulink></para></listitem>
		<listitem><para>autoconf 2.12, available at <ulink url="http://www.gnu.org">http://www.gnu.org</ulink></para></listitem>
		<listitem><para>automake 1.2, available at <ulink url="http://www.gnu.org">http://www.gnu.org</ulink></para></listitem>
		<listitem><para>Qt 2.2.x or higher, available at <ulink url="http://www.troll.no">http://www.troll.no</ulink></para></listitem>
      </itemizedlist>
    </sect1>

    <sect1 id="compilation-and-installation">
      <title>Compilation and Installation</title>
        <para>In order to compile and install <emphasis>&kunit;</emphasis> on your system, type the following in the base directory of the <emphasis>&kunit;</emphasis> distribution:
        <screen>
          <prompt>%</prompt> <userinput><command>make</command></userinput>
          <prompt>%</prompt> <userinput><command>su</command></userinput>
          <prompt>%</prompt> <userinput><command>make</command> install</userinput></screen>
      </para>

      <para>Should you run into problems please report them to the the author at <ulink url="mailto:jschauma@netmeister.org">Jan Schaumann</ulink></para>
    </sect1>
  </chapter>

  <chapter id="using-kunit">
    <title>Using KUnit</title>

    <para>Straight forward:</para>
	<itemizedlist>
		<listitem><para>Run <command>kunit</command>.</para></listitem>
		<listitem><para>Choose the category for your units.</para></listitem>
		<listitem><para>Choose the unit to convert from and the unit to convert to.</para></listitem>
		<listitem><para>Enter the number to convert into the appropriate text-field.</para></listitem>
		<listitem><para>Happily read the result from the appropriate text-field.</para></listitem>
	</itemizedlist>
  </chapter>

  <chapter id="copyright">
    <title>Copyright</title>

    <para>KUnit Copyright 2000, 2001 Jan Schaumann, <ulink url="mailto:jschauma@netmeister.org">jschauma@netmeister.org</ulink></para>
    <para>This program is free software; you can redistribute it and/or modify
	it under the terms of the GNU General Public License as published by
	the Free Software Foundation; either version 2 of the License, or
	(at your option) any later version.</para>
	<para>This program is distributed in the hope that it will be useful,
	but WITHOUT ANY WARRANTY; without even the implied warranty of
	MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
	GNU General Public License for more details.</para>
	<para>You should have received a copy of the GNU General Public License
	along with this program; if not, write to the Free Software
	Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.</para>
  </chapter>

  <chapter id="misc">
    <title>Misc</title>

    <para>Please take the time to visit these websites:</para>
	<itemizedlist>
		<listitem><para><ulink url="http://www.aclu.org">http://www.aclu.org</ulink></para></listitem>
		<listitem><para><ulink url="http://www.amnesty.org">http://www.amnesty.org</ulink></para></listitem>
		<listitem><para><ulink url="http://www.worldwildlife.org">http://www.worldwildlife.org</ulink></para></listitem>
		<listitem><para><ulink url="http://www.ncadp.org">http://www.ncadp.org</ulink></para></listitem>
	</itemizedlist>
	<para>Take the time to think about it.</para>
  </chapter>

</book>
<!--
Local Variables:
mode: sgml
sgml-omittag: nil
sgml-shorttag: t
sgml-general-insert-case: lower
End:
-->

5.1:	0.5-alt9
4.1:	0.5-alt7.M41.1
3.0:	0.5-alt5.1