<!DOCTYPE REFENTRY PUBLIC "-//Sun Microsystems//DTD DocBook V3.0-Based SolBook Subset V2.0//EN" [

<!--ArborText, Inc., 1988-1999, v.4002-->

<!ENTITY cmd "gnome-calculator">

<!ENTITY % commonents SYSTEM "smancommon.ent">

%commonents;

<!ENTITY % booktitles SYSTEM "booktitles.ent">

%booktitles;

<!ENTITY suncopy "Copyright (c) 2006, Sun Microsystems, Inc. All Rights Reserved.">

]>

<?Pub UDT _bookmark _target>

<?Pub Inc>

<refentry id="gnome-calculator-1">

<refmeta><refentrytitle>gnome-calculator</refentrytitle><manvolnum>1</manvolnum>

<refmiscinfo class="date">12 Sep 2006</refmiscinfo>

<refmiscinfo class="sectdesc">&man1;</refmiscinfo>

<refmiscinfo class="software">&release;</refmiscinfo>

<refmiscinfo class="arch">generic</refmiscinfo>

<refmiscinfo class="copyright">&suncopy;</refmiscinfo>

</refmeta>

<indexterm><primary>gnome-calculator</primary></indexterm><indexterm><primary>

gucharmap</primary></indexterm><indexterm><primary>insert special characters

into a document</primary></indexterm>

<refnamediv id="gnome-calculator-1-name"><refname>gnome-calculator</refname>

<refname>gcalctool</refname><refpurpose>perform basic, financial, and scientific

calculations</refpurpose></refnamediv>

<refsynopsisdiv id="gnome-calculator-1-synp"><title>&synp-tt;</title>

<cmdsynopsis><command>&cmd; | gcalctool</command>

<arg><option>a <replaceable>accuracy</replaceable></option></arg>

<arg><option>D</option></arg><arg><option>E</option></arg>

<arg><option>v</option></arg>

<arg><option role="nodash"><replaceable>gnome-std-options</replaceable></option></arg>

</cmdsynopsis></refsynopsisdiv>

<refsect1 id="gnome-calculator-1-desc"><title>&desc-tt;</title>

<para>Gnome calculator is a desktop calculator. It has been designed to be used with

either the mouse or the keyboard. It is visually similar to a lot of hand-held

calculators.</para>

<para>

Calculator has the following modes:

</para>

<variablelist>

<varlistentry>

<term>Basic Mode</term>

<listitem><para>

Provides standard calculator functions. You can store numbers in 10 different

memory registers, and easily retrieve and replace the numbers in the memory

registers. Basic Mode is the default mode. You can use all of the Basic Mode

functions in each of the other modes.

</para>

</listitem></varlistentry>

<varlistentry>

<term>Financial Mode</term>

<listitem><para>

Provides several complex financial functions.

</para>

</listitem></varlistentry>

<varlistentry>

<term>Scientific Mode</term>

<listitem><para>

Provides many additional mathematical functions, including trigonometric and

logical functions. You can also store your own functions and constants, when

you use Scientific Mode.

</para>

</listitem></varlistentry>

</variablelist></refsect1>

<refsect1 id="gnome-calculator-1-exde"><title>&exde-tt;</title>

<para>

Some of the calculator keys have menu marks, this indicates that there is a

menu associated with that key.

</para>

<para>

One of the most important things to remember about gnome-calculator is that

calculations are performed from left to right, with no arithmetic precedence.

If you need arithmetic precedence, then you should use parentheses.

</para>

<para>

Internal arithmetic is now down with multi-precision floating point numbers.

Accuracy can be adjusted from zero to nine numeric places in fixed notation,

but numbers can be displayed in engineering and scientific notation as well.

There is also an option to show or remove trailing zeroes after the numeric

point. The calculator reverts to scientific notation when the number is larger

than the display would allow in fixed notation. In the scientific mode, the

base of operation can be changed between binary, octal, decimal and

hexidecimal. Numbers are initially displayed in fixed notation to nine

numeric places, with trailing zeroes removed, in the decimal base.

</para>

<para>

You can use the Copy and Paste functions in conjunction with the numeric

display to store or retrieve characters from the clipboard. You can also remove

the last digit entered, completely clear the displayed entry and totally reset

the calculator.

</para>

<para>

There are ten memory registers. Numbers can be stored or retrieved in these

locations, and arithmetic can be performed upon register contents.

</para>

<para>

Context sensitive help is also available. Control-F1 toggles whether a tooltip

is displayed for the item which currently has focus.

</para>

<para>On startup, Calculator uses the following configuration resources stored

in a GConf database. </para>

<informaltable frame="none">

<tgroup cols="2" colsep="0" rowsep="0"><colspec colwidth="18.18*"><colspec

colwidth="81.82*">

<tbody>

<row><entry><para>Resource:</para></entry><entry><para>/schemes/apps/gcalctool/accuracy

</para></entry></row>

<row><entry><para>Values:</para></entry><entry><para>Accuracy value</para></entry>

</row>

<row><entry><para>Description:</para></entry><entry><para>The number of digits

displayed after the numeric point. This value must be in the range 0 to 9.

</para></entry></row>

</tbody>

</tgroup>

</informaltable>

<informaltable frame="none">

<tgroup cols="2" colsep="0" rowsep="0"><colspec colwidth="18.18*"><colspec

colwidth="81.82*">

<tbody>

<row><entry><para>Resource:</para></entry><entry><para>/schemes/apps/gcalctool/base

</para></entry></row>

<row><entry><para>Values:</para></entry><entry><para>Numeric Base</para></entry>

</row>

<row><entry><para>Description:</para></entry><entry><para>The initial numeric

base. Valid values are "BIN" (binary), "OCT" (octal), "DEC" (decimal), and

"HEX" (hexadecimal).</para></entry></row>

</tbody>

</tgroup>

</informaltable>

<informaltable frame="none">

<tgroup cols="2" colsep="0" rowsep="0"><colspec colwidth="18.18*"><colspec

colwidth="81.82*">

<tbody>

<row><entry><para>Resource:</para></entry><entry><para>/schemes/apps/gcalctool/display

</para></entry></row>

<row><entry><para>Values:</para></entry><entry><para>Display mode</para></entry>

</row>

<row><entry><para>Description:</para></entry><entry><para>The initial display

mode. Valid values are "ENG" (engineering), "FIX" (fixed-point), and SCI"

(scientific).</para></entry></row>

</tbody>

</tgroup>

</informaltable>

<informaltable frame="none">

<tgroup cols="2" colsep="0" rowsep="0"><colspec colwidth="18.18*"><colspec

colwidth="81.82*">

<tbody>

<row><entry><para>Resource:</para></entry><entry><para>/schemes/apps/gcalctool/mode

</para></entry></row>

<row><entry><para>Values:</para></entry><entry><para>Mode</para></entry></row>

<row><entry><para>Description:</para></entry><entry><para>The initial calculator

mode. Valid values are "BASIC", "FINANCIAL", and "SCIENTIFIC".</para></entry>

</row>

</tbody>

</tgroup>

</informaltable>

<informaltable frame="none">

<tgroup cols="2" colsep="0" rowsep="0"><colspec colwidth="18.18*"><colspec

colwidth="81.82*">

<tbody>

<row><entry><para>Resource:</para></entry><entry><para>/schemes/apps/gcalctool/showzeroes

</para></entry></row>

<row><entry><para>Values:</para></entry><entry><para>true, false (true)</para></entry>

</row>

<row><entry><para>Description:</para></entry><entry><para>Whether to show

trailing zeroes after the numeric point in the display value.</para></entry>

</row>

</tbody>

</tgroup>

</informaltable>

<informaltable frame="none">

<tgroup cols="2" colsep="0" rowsep="0"><colspec colwidth="18.18*"><colspec

colwidth="81.82*">

<tbody>

<row><entry><para>Resource:</para></entry><entry><para>/schemes/apps/gcalctool/showthousands

</para></entry></row>

<row><entry><para>Values:</para></entry><entry><para>true, false (false)</para></entry>

</row>

<row><entry><para>Description:</para></entry><entry><para>Whether fixed numbers

in the decimal base are displayed with thousands separated.</para></entry>

</row>

</tbody>

</tgroup>

</informaltable>

<informaltable frame="none">

<tgroup cols="2" colsep="0" rowsep="0"><colspec colwidth="18.18*"><colspec

colwidth="81.82*">

<tbody>

<row><entry><para>Resource:</para></entry><entry><para>/schemes/apps/gcalctool/showregisters

</para></entry></row>

<row><entry><para>Values:</para></entry><entry><para>true, false (true)</para></entry>

</row>

<row><entry><para>Description:</para></entry><entry><para>Whether to display

the memory register window when Calculator starts.</para></entry></row>

</tbody>

</tgroup>

</informaltable>

<informaltable frame="none">

<tgroup cols="2" colsep="0" rowsep="0"><colspec colwidth="18.18*"><colspec

colwidth="81.82*">

<tbody>

<row><entry><para>Resource:</para></entry><entry><para>/schemes/apps/gcalctool/trigtype

</para></entry></row>

<row><entry><para>Values:</para></entry><entry><para>Trig. type</para></entry>

</row>

<row><entry><para>Description:</para></entry><entry><para>The initial trigonometric

type. Valid values are "DEG" (degrees), "GRAD" (grads), and "RAD" (radians).

</para></entry></row>

</tbody>

</tgroup>

</informaltable>

<para>Any constants or functions that the user defines are also stored in

the GConf database.</para>

</refsect1>

<refsect1 id="gnome-calculator-1-opts"><title>&opts-tt;</title>

<para>The following options are supported:</para>

<variablelist termlength="medium">

<varlistentry><term><option>a <replaceable>accuracy</replaceable></option></term>

<listitem><para>Specifies the number of digits displayed after the numeric

point. This value must be in the range 0 to 9.</para>

</listitem></varlistentry>

<varlistentry><term><option>D</option></term><listitem><para>Enable debug

mode.</para>

</listitem></varlistentry>

<varlistentry><term><option>E</option></term><listitem><para>Enable debug

mode in the multiple-precision arithmetic package.</para>

</listitem></varlistentry>

<varlistentry<term><option>v</option></term><listitem><para>Show the version number

and usage information.</para></listitem</varlistentry>

<varlistentry><term><option role="nodash"><replaceable>gnome-std-options</replaceable></option></term>

<listitem><para>Standard options available for use with most GNOME applications.

See <citerefentry><refentrytitle>gnome-std-options</refentrytitle><manvolnum>

5</manvolnum></citerefentry> for more information.</para>

</listitem></varlistentry>

</variablelist></refsect1>

<refsect1 id="gnome-calculator-1-exam"><title>&exam-tt;</title>

<example role="example">

<title>Launching Calculator</title>

<para><screen>example% <userinput>&cmd; </userinput></screen></para>

</example>

</refsect1>

<refsect1 id="gnome-calculator-1-exit"><title>&exit-tt;</title>

<para>The following exit values are returned:</para>

<variablelist termlength="xtranarrow">

<varlistentry><term><returnvalue>0</returnvalue></term><listitem><para>Application

exited successfully</para>

</listitem></varlistentry>

<varlistentry><term><returnvalue>>0</returnvalue></term><listitem><para>Application

exited with failure</para>

</listitem></varlistentry>

</variablelist></refsect1>

<refsect1 id="gnome-calculator-1-file"><title>&file-tt;</title>

<para>The following files are used by this application:</para>

<variablelist termlength="wide">

<varlistentry><term><filename>/usr/bin/gcalctool</filename> </term><listitem>

<para>Executable for Calculator.</para>

</listitem></varlistentry>

<varlistentry><term><filename>/usr/bin/&cmd;</filename> </term><listitem>

<para>Symbolic link to <command>gcalctool</command>.</para>

</listitem></varlistentry>

<varlistentry><term><filename>~/.gcalctoolrc</filename> </term><listitem>

<para>User-specific resources for customizing the appearance and color of

Calculator.</para>

</listitem></varlistentry>

</variablelist></refsect1>

<refsect1 id="gnome-calculator-1-attr"><title>&attr-tt;</title>

<para>See <olink targetdocent="REFMAN5" localinfo="attributes-5"><citerefentry>

<refentrytitle>attributes</refentrytitle><manvolnum>5</manvolnum></citerefentry></olink>

for descriptions of the following attributes:</para>

<informaltable frame="all">

<tgroup cols="2" colsep="1" rowsep="1"><colspec colname="COLSPEC0" colwidth="1*">

<colspec colname="COLSPEC1" colwidth="1*">

<thead>

<row><entry align="center" valign="middle">ATTRIBUTE TYPE</entry><entry align="center"

valign="middle">ATTRIBUTE VALUE</entry></row>

</thead>

<tbody>

<row><entry><para>Availability</para></entry><entry><para>desktop/calculator/gcalctool

</para></entry></row>

<row><entry colname="COLSPEC0"><para>Interface stability</para></entry><entry

colname="COLSPEC1"><para>Volatile</para></entry></row>

</tbody>

</tgroup>

</informaltable>

</refsect1>

<refsect1 id="gnome-calculator-1-also"><title>&also-tt;</title>

<para><citetitle>Calculator Manual</citetitle></para>

<para>Latest version of the <citetitle>GNOME Desktop User Guide</citetitle>

for your platform.</para>

<para>

<citerefentry><refentrytitle>attributes</refentrytitle><manvolnum>5</manvolnum></citerefentry>,

<citerefentry><refentrytitle>gnome-std-options</refentrytitle><manvolnum>5</manvolnum></citerefentry>

</para>

</refsect1>

<refsect1 id="gnome-calculator-1-note"><title>&note-tt;</title>

<para>Written by Glynn Foster and Rich Burridge, Sun Microsystems Inc., 2003.

</para>

<para>Updated by Matt Keenan, Sun Microsystems Inc., 2006.</para>

</refsect1>

</refentry>