<!DOCTYPE Article PUBLIC "-//GNOME//DTD DocBook PNG Variant V1.1//EN"[
<!ENTITY version "1.2.0">
]>

<article id="index">

 <artheader>
  <title>GNOME Calculator Manual</title>
  <copyright>
   <year>2000</year>
   <holder>Gregory Leblanc</holder>
  </copyright>

  <!-- translators: uncomment this:

  <copyright>
   <year>2000</year>
   <holder>ME-THE-TRANSLATOR (Latin translation)</holder>
  </copyright>

   -->
<legalnotice id="legalnotice">
      <para>Permission is granted to copy, distribute and/or modify this document
	under the terms of the <ulink type="help"
	url="gnome-help:fdl"><citetitle>GNU Free Documentation
	    License</citetitle></ulink>, Version 1.1 or any later version 
	published by the Free Software Foundation with no Invariant Sections, 
	no Front-Cover Texts, and no Back-Cover Texts.  A copy of the license
	can be found <ulink type="help" url="gnome-help:fdl">here</ulink>.
      </para>
      <para>Many of the names used by companies to distinguish their products and
	services are claimed as trademarks. Where those names appear in any
	GNOME documentation, and those trademarks are made aware to the members
	of the GNOME Documentation Project, the names have been printed in caps
	or initial caps.
      </para>
    </legalnotice>
 

  <releaseinfo>
  This is version 0.2 of the GNOME Calculator manual.
  </releaseinfo>

 </artheader>

 <sect1 id="intro">
  <title>Introduction</title>

  <para>
   <application>GNOME Calculator</application> is a double precision calculator application.  It provides advanced scientific and mathematical features such as trigonometric functions (sine, cosine, tangent) and logarithms (log, ln).
  </para>

  <para>
   To run <application>GNOME Calculator</application>, select
   <guimenuitem>Simple Calculator</guimenuitem> from the
   <guisubmenu>Utilities</guisubmenu> submenu of the <guimenu>Main
   Menu</guimenu>, or type <command>gcalc</command> on the
   command line. 
  </para>

  <para>
   <application>GNOME Calculator</application> is included in the
   <filename>gnome-utils</filename> package, which is part of the
   GNOME desktop environment. This document describes version
   &version; of <application>GNOME Calculator</application>.
  </para>

 </sect1>

 <sect1 id="usage">
  <title>Using <application>GNOME Calculator</application></title>
  <para>
   <application>GNOME Calculator</application> can be used to perform
   any of the calculations that you would normally use a scientific
   calculator or slide-rule for, or to replace the trigonometric and
   logarithmic tables generally found in the appendix of science
   textbooks.  It is intended as a GNOME replacement for
   <application>xcalc</application>. 
  </para>


  <sect2 id="mainwin">
   <title>Basic usage</title>
   <para>
    Starting <application>GNOME Calculator</application> opens 
    the <interface>Main window</interface>, shown in <xref
    linkend="mainwindow-fig">.

    <figure id="mainwindow-fig">
     <title><application>GNOME Calculator</application> Main Window</title>
     <screenshot>
      <screeninfo><application>GNOME Calculator</application> Main Window</screeninfo>
      <graphic fileref="figures/gcalc-main" format="png"
       srccredit="Gregory Leblanc">
      </graphic>
     </screenshot>
    </figure>
   </para>

   <para>
    To perform calculations, type in the numbers using the number keys
    on your keyboard, or use the <guibutton>0</guibutton> through
    <guibutton>9</guibutton> buttons on the main window, and the
    operator buttons surrounding them. 
   </para>

  </sect2>


  <sect2 id="menubar">
   <title>Menus</title>
   <para>
    The menu bar, located at the top of the <interface>Main
    Window</interface>, contains the following menus:
   </para>

   <variablelist>
    <varlistentry>
     <term><guimenu>File</guimenu></term>
     <listitem>
      <para>
       <menuchoice>
        <shortcut>
         <keysym>Ctl-Q</keysym>
        </shortcut>
        <guimenuitem>Quit</guimenuitem>
       </menuchoice>
       which exits from <application>GNOME Calculator</application>.
      </para>
     </listitem>
    </varlistentry>

    <varlistentry>
     <term><guimenu>Edit</guimenu></term>
     <listitem>
      <para>
        <menuchoice>
         <shortcut>
          <keysym>Ctl-C</keysym>
         </shortcut>
         <guimenuitem>Edit</guimenuitem>
        </menuchoice>
        which copies the current display.
      </para>
     </listitem>
    </varlistentry>

    <varlistentry>
     <term><guimenu>Help</guimenu></term>
        <listitem>
         <para>
          <guimenuitem>About</guimenuitem> &mdash; shows
          basic information about
          <application>GNOME Calculator</application>, such as
          the author's name and the application version number.
         </para>
        </listitem>
    </varlistentry>
   </variablelist>
  </sect2>


  <sect2 id="buttons">
   <title>Buttons</title>
   <para>
    The buttons, located on the <interface>Main
    Window</interface>, are as follows:
   </para>

   <variablelist>

    <varlistentry>
 <term>1/x</term>
     <listitem>
      <para>
       Inverts the current display.  
       <example>
        <title>1/x</title>
        <para>When <command><replaceable>10</replaceable></command> is displayed, pressing <guibutton>1/x</guibutton> will cause <application>GNOME Calculator</application> to display <command><replaceable>0.1</replaceable></command>.</para>
       </example>
      </para>
     </listitem>
    </varlistentry>

     <varlistentry>
      <term><guibutton>x^2</guibutton></term>
      <listitem>
       <para>
        Raises the current display to the second power.
        <example>
         <title>x^2</title>
         <para>When <command><replaceable>5</replaceable></command> is displayed, pressing <guibutton>x^2</guibutton> will cause <application>GNOME Calculator</application> to display <command><replaceable>25</replaceable></command>.</para>
        </example>
       </para>
      </listitem>
     </varlistentry>

     <varlistentry>
      <term><guibutton>SQRT</guibutton></term>
      <listitem>
       <para>
        Calculates the square root.
        <example>
         <title>SQRT</title>
         <para>When <command><replaceable>81</replaceable></command> is displayed, pressing <guibutton>SQRT</guibutton> will cause <application>GNOME Calculator</application> to display <command><replaceable>9</replaceable></command>.</para>
        </example>
       </para>
      </listitem>
     </varlistentry>

     <varlistentry>
      <term><guibutton>CE/C</guibutton></term>
      <listitem>
       <para>
        This button clears the display.
       </para>
      </listitem>
     </varlistentry>

     <varlistentry>
      <term><guibutton>AC</guibutton></term>
      <listitem>
       <para>
        This button clears the display and all queued commands.
       </para>
      </listitem>
     </varlistentry>

     <varlistentry>
      <term><guibutton>INV</guibutton></term>
      <listitem>
       <para>
        The <guibutton>INV</guibutton> is used to &quot;invert&quot; some operations in <application>GNOME Calculator</application>.
        <example>
	 <title>INV</title>
	 <para>The <guibutton>INV</guibutton> can be used to compute the arcsine of a number.  If the display shows <command><replaceable>1</replaceable></command>, pressing <guibutton>INV</guibutton>, followed by <guibutton>sin</guibutton>, yields a result of <command><replaceable>90</replaceable></command>, assuming that the units display is set on <command><replaceable>DEG</replaceable></command>.
         </para>
	</example>
       </para>
      </listitem>
     </varlistentry>

     <varlistentry>
      <term><guibutton>sin</guibutton></term>
      <listitem>
       <para>
        Computes the trigonometric sine.  The units used are displayed on the second button down on the right column of buttons.
        <example>
         <title>sin</title>
         <para>When the display shows <command><replaceable>90</replaceable></command> and the units display shows <command><replaceable>DEG</replaceable></command> pressing <guibutton>sin</guibutton> will cause <application>GNOME Calculator</application> to display <command><replaceable>1</replaceable></command>.</para>
        </example>
       </para>
      </listitem>
     </varlistentry>

     <varlistentry>
      <term><guibutton>cos</guibutton></term>
      <listitem>
       <para>
        Computes the trigonometric cosine, or compliment's sine.  The units used are displayed on the second button down on the right column of buttons.
        <example>
         <title>cos</title>
         <para>When the display shows <command><replaceable>60</replaceable></command> and the units display shows <command><replaceable>DEG</replaceable></command>, pressing <guibutton>cos</guibutton> will cause <application>GNOME Calculator</application> to display <command><replaceable>.5</replaceable></command>.</para>
        </example>
       </para>
      </listitem>
     </varlistentry>

     <varlistentry>
      <term><guibutton>tan</guibutton></term>
      <listitem>
       <para>
        Computes the trigonometric tangent.
        <example>
         <title>tan</title>
         <para>When the display shows <command><replaceable>45</replaceable></command> and the units display shows <command><replaceable>DEG</replaceable></command>, pressing <guibutton>tan</guibutton> will cause <application>GNOME Calculator</application> to display <command><replaceable>1</replaceable></command>.</para>
        </example>
       </para>
      </listitem>
     </varlistentry>

     <varlistentry>
      <term><guibutton>DEG/RAD/GRAD</guibutton></term>
      <listitem>
       <para>
        Displays and changes the units of angle measure
       </para>
      </listitem>
     </varlistentry>

     <varlistentry>
      <term><guibutton>e</guibutton></term>
      <listitem>
       <para>
        Uses the irrational number e for the next argument.  The number displayed is not necessarily the same as used for calculations.
       </para>
      </listitem>
     </varlistentry>

     <varlistentry>
      <term><guibutton>EE</guibutton></term>
      <listitem>
       <para>
        Multiplies the current display by 10 to the power of the next number entered.  
        <example>
         <title>EE</title>
         <para>Clicking <command><replaceable>8</replaceable></command> and then <guibutton>EE</guibutton> and then <command><replaceable>3</replaceable></command> and then <command><replaceable>=</replaceable></command> would display <command><replaceable>8000</replaceable></command>.</para>
        </example>
       </para>
      </listitem>
     </varlistentry>

     <varlistentry>
      <term><guibutton>log</guibutton></term>
      <listitem>
       <para>
        Calculates the logarithm base 10 of the display.
        <example>
         <title>log</title>
         <para>Entering <command><replaceable>1000</replaceable></command> and pressing <guibutton>log</guibutton> yields a result of <command><replaceable>3</replaceable></command>.</para>
        </example>
       </para>
      </listitem>
     </varlistentry>

     <varlistentry>
      <term><guibutton>ln</guibutton></term>
      <listitem>
       <para>
        Calculates the natual logarithm (base e) of the display.
        <example>
         <title>ln</title>
         <para>Entering <command><replaceable>403.4287935</replaceable></command> and pressing <guibutton>ln</guibutton> causes <application>GNOME Calculator</application> to display <command><replaceable>6</replaceable></command>.</para>
        </example>
       </para>
      </listitem>
     </varlistentry>

     <varlistentry>
      <term><guibutton>x^y</guibutton></term>
      <listitem>
       <para>
        Raises the number in the display to the power of the next number entered.
        <example>
         <title>x^y</title>
         <para>With <command><replaceable>5</replaceable></command> in the display, pressing <guibutton>x^y</guibutton> and then entering <command><replaceable>3</replaceable></command> will yield a result of <command><replaceable>125</replaceable></command>.</para>
        </example>
       </para>
      </listitem>
     </varlistentry>

     <varlistentry>
      <term><guibutton>PI</guibutton></term>
      <listitem>
       <para>
        Enters the irrational number Pi into the display.
       </para>
      </listitem>
     </varlistentry>

     <varlistentry>
      <term><guibutton>x!</guibutton></term>
      <listitem>
       <para>
        Calculates the factorial of the number in the display.
        <example>
         <title>x!</title>
         <para>Entering <command><replaceable>7</replaceable></command> in the display and pressing <guibutton>x!</guibutton> will cause <application>GNOME Calculator</application> to display <command><replaceable>5040</replaceable></command>.</para>
        </example>
       </para>
      </listitem>
     </varlistentry>

     <varlistentry>
      <term><guibutton>(</guibutton><guibutton>)</guibutton></term>
      <listitem>
       <para>
        Parenthesis can be used to group operations, overriding the default order of operations for mathematics.  
       </para>
      </listitem>
     </varlistentry>

     <varlistentry>
      <term><guibutton>/</guibutton><guibutton>*</guibutton><guibutton>+</guibutton><guibutton>-</guibutton></term>
      <listitem>
       <para>
        These buttons let you perform the basic arethemetic operations of division <guibutton>/</guibutton>, multiplication <guibutton>*</guibutton>, addition <guibutton>+</guibutton>, and subtraction <guibutton>-</guibutton>.
       </para>
      </listitem>
     </varlistentry>

     <varlistentry>
      <term><guibutton>STO</guibutton><guibutton>RCL</guibutton></term>
      <listitem>
       <para>
        The <guibutton>STO</guibutton> is used to store the display into the calculators memory.
       </para>
      </listitem>
     </varlistentry>

     <varlistentry>
      <term><guibutton>RCL</guibutton></term>
      <listitem>
       <para>
        The <guibutton>RCL</guibutton> is used to recall the stored value from memory.
       </para>
      </listitem>
     </varlistentry>

     <varlistentry>
      <term><guibutton>0</guibutton><guibutton>1</guibutton><guibutton>2</guibutton><guibutton>3</guibutton><guibutton>4</guibutton><guibutton>5</guibutton><guibutton>6</guibutton><guibutton>7</guibutton><guibutton>8</guibutton><guibutton>9</guibutton></term>
      <listitem>
       <para>
        These buttons are used to input the numeric characters 0 through 9, for use in calculations.
       </para>
      </listitem>
     </varlistentry>

     <varlistentry>
      <term><guibutton>SUM</guibutton></term>
      <listitem>
       <para>
        Adds the displayed number to the number stored in <application>GNOME Calculator's</application> memory.  This will act the same as the <guibutton>STO</guibutton> when the calculator's memory is empty, or zero.
       </para>
      </listitem>
     </varlistentry>

     <varlistentry>
      <term><guibutton>EXC</guibutton></term>
      <listitem>
       <para>
        Swaps the values in the display an memory.
        <example>
	 <title>EXC</title>
	 <para>
          First, store <command><replaceable>12</replaceable></command> into memory.  Then, enter <command><replaceable>56</replaceable></command>, and press <guibutton>EXC</guibutton>.  You should now see <command><replaceable>12</replaceable></command> in the display.  Press <guibutton>CE/C</guibutton> followed by <guibutton>RCL</guibutton>, and <application>GNOME Calculator</application> will display <command><replaceable>12</replaceable></command>.
         </para>
	</example>
       </para>
      </listitem>
     </varlistentry>

     <varlistentry>
      <term><guibutton>.</guibutton></term>
      <listitem>
       <para>
        The <guibutton>.</guibutton> is used to delimit between whole numbers, and fractional, or decimal, numbers while using <application>GNOME Calculator</application>.
       </para>
      </listitem>
     </varlistentry>

     <varlistentry>
      <term><guibutton>+/-</guibutton></term>
      <listitem>
       <para>
        The <guibutton>+/-</guibutton> is used to change the sign of the number displayed from positive to negative, or vice versa.
       </para>
      </listitem>
     </varlistentry>

     <varlistentry>
      <term><guibutton>=</guibutton></term>
      <listitem>
       <para>
        The <guibutton>=</guibutton> is used to tell
        <application>GNOME Calculator</application> to perform the
        currently pending operations.  This command can also be
        invoked using the <keycap>Enter</keycap> or
        <keycap>Return</keycap> key on the keyboard.
       </para>
      </listitem>
     </varlistentry>

  </variablelist>
  </sect2>


 </sect1>


 <sect1 id="bugs">
  <title>Known Bugs and Limitations</title>
  <para>
   I don't know of any bugs in this program.  If you find some, please
   submit them using the instructions in  <xref linkend="authors">. 
  </para>
 </sect1>

 <sect1 id="authors">
  <title>Authors</title>
  <para>
   <application>GNOME Calculator</application> was written by George Lebl
   (<email>jirka@5z.com</email>).  Please send all comments, suggestions, and bug
   reports to the <ulink url="http://bugzilla.gnome.org" type="http">GNOME
   bug tracking database</ulink>. (Instructions for submitting bug
   reports can be found <ulink
   url="http://bugs.gnome.org/Reporting.html" type="http">
   on-line</ulink>.) If you are using
   GNOME 1.1 or later, you can also use <application>Bug Report
   Tool</application> (<command>bug-buddy</command>), available in the
   <guisubmenu>Utilities</guisubmenu> submenu of <guimenu>Main
   Menu</guimenu>, for submitting bug reports.
  </para>

  <para>
   This manual was written by Gregory Leblanc
   (<email>gleblanc@cu-portland.edu</email>). Please send all comments and
   suggestions regarding this manual to the <ulink type="http"
   url="http://developer.gnome.org/projects/gdp/">GNOME Documentation Project</ulink> 
   by sending an email to <email>docs@gnome.org</email>. You can also
   add your comments online by using the <ulink type="http"
   url="http://developer.gnome.org/projects/gdp/">GNOME Documentation Status
   Table</ulink>.
  </para>

  <!-- For translations: uncomment this:

  <para>
   Latin translation was done by ME
   (<email>MYNAME@MYADDRESS</email>). Please send all  comments  and
   suggestions regarding this translation to SOMEWHERE.
  </para>

  -->

 </sect1>

 <sect1 id="license">
  <title>License</title>
  <para>
   This program is free software; you can redistribute it and/or
   modify it under the terms of the  <ulink type="help" url="gnome-help:gpl">
    <citetitle>GNU General Public License</citetitle></ulink> 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
   <citetitle>GNU General Public License</citetitle> for more details.
  </para>
  <para>
   A copy of the <citetitle>GNU General Public License</citetitle> is
   included as an appendix to the <citetitle>GNOME Users
   Guide</citetitle>.  You may also obtain a copy of the
   <citetitle>GNU General Public License</citetitle> from the Free
   Software Foundation by visiting <ulink type="http"
   url="http://www.fsf.org">their Web site</ulink> or by writing to
   <address>
    Free Software Foundation, Inc.
    <street>59 Temple Place</street> - Suite 330
    <city>Boston</city>, <state>MA</state> <postcode>02111-1307</postcode>
    <country>USA</country>
   </address>
  </para>
 </sect1>
</article>
