[gcalctool] Remove references to arithmetic/left-to-right precedence from the manual (Robert Ancell, Bug #559734
- From: Robert Ancell <rancell src gnome org>
- To: svn-commits-list gnome org
- Subject: [gcalctool] Remove references to arithmetic/left-to-right precedence from the manual (Robert Ancell, Bug #559734
- Date: Wed, 13 May 2009 20:00:16 -0400 (EDT)
commit 84bde2e8b68c2e1fc631a2dd627c6c3b1e561886
Author: Robert Ancell <robert ancell gmail com>
Date: Thu May 14 09:59:17 2009 +1000
Remove references to arithmetic/left-to-right precedence from the manual (Robert Ancell, Bug #559734)
---
help/C/gcalctool.xml | 100 +++++--------------------------------------------
help/ChangeLog | 5 ++
2 files changed, 16 insertions(+), 89 deletions(-)
diff --git a/help/C/gcalctool.xml b/help/C/gcalctool.xml
index 24e8430..67bfce4 100644
--- a/help/C/gcalctool.xml
+++ b/help/C/gcalctool.xml
@@ -296,7 +296,7 @@
</varlistentry>
<varlistentry> <term>Display area</term>
<listitem>
- <para>The display area shows the numbers that you enter, and the results of calculations. If you are not using arithmetic precedence, you can only enter numbers of up to forty digits. </para>
+ <para>The display area shows the numbers that you enter, and the results of calculations.</para>
</listitem>
</varlistentry>
<varlistentry> <term>Mode area</term>
@@ -510,16 +510,9 @@
<entry><para>Clear Entry</para> </entry>
<entry><para><guibutton>CE</guibutton></para></entry>
<entry><para>Removes the current value from the display area.</para>
- <para>This is only really meaningful if the Calculator is not in Arithmetic Precedence mode.</para>
- <para>In Arithmetic Precedence mode, this operation is the same as <guibutton>Clr</guibutton></para></entry>
- <entry><para>If the calculator is not in Arithmetic Precedence mode:</para>
- <para>1 <guibutton>+</guibutton> <guibutton>2</guibutton><guibutton>2</guibutton> <guibutton>CE</guibutton> <guibutton>=</guibutton></para>
- <para>If the calculator is in Arithmetic Precedence mode:</para>
- <para>1 <guibutton>+</guibutton> <guibutton>2</guibutton><guibutton>2</guibutton> <guibutton>CE</guibutton> <guibutton>=</guibutton></para></entry>
- <entry><para>If the calculator is not in Arithmetic Precedence mode:</para>
- <para>1</para>
- <para>If the calculator is in Arithmetic Precedence mode:</para>
- <para>0</para></entry>
+ <para>This operation is the same as <guibutton>Clr</guibutton></para></entry>
+ <entry><para>1 <guibutton>+</guibutton> <guibutton>2</guibutton><guibutton>2</guibutton> <guibutton>CE</guibutton> <guibutton>=</guibutton></para></entry>
+ <entry><para>0</para></entry>
</row>
<row valign="top">
<entry><para>Clear</para> </entry>
@@ -617,10 +610,7 @@
<entry><para>Square Root</para> </entry>
<entry><para><guibutton>Sqrt</guibutton></para></entry>
<entry><para>Calculates the square root of the current value in the display area.</para></entry>
- <entry><para>For arithmetic precedence mode:</para>
- <para><guibutton>Sqrt</guibutton> 9 <guibutton>)</guibutton><guibutton>=</guibutton></para>
- <para>For non-arithmetic precedence mode:</para>
- <para>9 <guibutton>Sqrt</guibutton></para></entry>
+ <entry><para><guibutton>Sqrt</guibutton> 9 <guibutton>)</guibutton><guibutton>=</guibutton></para></entry>
<entry><para>3</para></entry>
</row>
<row valign="top">
@@ -654,7 +644,7 @@
<row valign="top">
<entry><para>Parentheses</para> </entry>
<entry><para><guibutton>(</guibutton> and <guibutton>)</guibutton></para></entry>
- <entry><para>Provide precedence in arithmetic calculations if you are not using Arithmetic Precedence. See also <xref linkend="gcalctool-manage-order"/>. Calculations within parentheses are performed first. You can nest parentheses to any level. When the last parenthesis is matched, the display area is updated.</para></entry>
+ <entry><para>Calculations within parentheses are performed first. You can nest parentheses to any level.</para></entry>
<entry>
<para>2 <guibutton>+</guibutton> <guibutton>3</guibutton> <guibutton>*</guibutton> <guibutton>4</guibutton> <guibutton>=</guibutton></para>
<para>2 <guibutton>+</guibutton> <guibutton>(</guibutton> <guibutton>3</guibutton> <guibutton>*</guibutton> <guibutton>4</guibutton> <guibutton>)</guibutton></para>
@@ -1449,12 +1439,10 @@ To calculate the time period necessary to accumulate $120,000, press <guibutton>
<para>When you click <guibutton>Exp</guibutton>, the calculator displays <literal>. +</literal> to represent
<replaceable>base</replaceable> to the power of the next number that you enter. </para>
<para>To change the sign of the number, use the <guibutton>+/-</guibutton> button before the <guibutton>Exp</guibutton> button.
-How you change the sign of the exponent (the power to which the number is raised) depends on whether you are in
-arithmetic precedence mode or not. In arithmetic precedence mode, use <guibutton>-</guibutton> after the
-<guibutton>Exp</guibutton> button, otherwise use the <guibutton>+/-</guibutton> button
-after entering the exponent.</para>
+To change the sign of the exponent (the power to which the number is raised) use <guibutton>-</guibutton> after the
+<guibutton>Exp</guibutton> button.</para>
-<para>To enter a decimal number in exponential format, in arithmetic precedence mode, use the guidelines in the following table: </para>
+<para>To enter a decimal number in exponential format, use the guidelines in the following table: </para>
<informaltable frame="all">
<tgroup cols="3" colsep="1" rowsep="1">
<colspec colname="COLSPEC0" colwidth="50*"/>
@@ -1494,46 +1482,6 @@ after entering the exponent.</para>
</tgroup>
</informaltable>
-<para>To enter a decimal number in exponential format, in non-arithmetic precedence mode, use the guidelines in the following table: </para>
- <informaltable frame="all">
- <tgroup cols="3" colsep="1" rowsep="1">
- <colspec colname="COLSPEC0" colwidth="50*"/>
- <colspec colname="COLSPEC1" colwidth="50*"/>
- <thead>
- <row valign="top">
- <entry colname="COLSPEC0">
- <para>Number</para></entry>
- <entry colname="COLSPEC1">
- <para>Enter</para></entry>
- <entry colname="COLSPEC2">
- <para>Number Displayed</para></entry>
- </row>
- </thead>
- <tbody>
- <row valign="top">
- <entry><para>1200000000</para></entry>
- <entry><para>12 <guibutton>Exp</guibutton> <guibutton>8</guibutton> <guibutton>=</guibutton></para></entry>
- <entry><para>1200000000</para></entry>
- </row>
- <row valign="top">
- <entry><para>-1200000000</para></entry>
- <entry><para>12 <guibutton>+/-</guibutton> <guibutton>Exp</guibutton> <guibutton>8</guibutton> <guibutton>=</guibutton> </para></entry>
- <entry><para>-1200000000</para></entry>
- </row>
- <row valign="top">
- <entry><para>0.00000012</para></entry>
- <entry><para>12 <guibutton>Exp</guibutton> <guibutton>8</guibutton> <guibutton>+/-</guibutton> </para></entry>
- <entry><para>1.2e-7</para></entry>
- </row>
- <row valign="top">
- <entry><para>-0.00000012</para></entry>
- <entry><para>12 <guibutton>+/-</guibutton> <guibutton>Exp</guibutton> <guibutton>8</guibutton> <guibutton>+/-</guibutton> </para></entry>
- <entry><para>-1.2e-7</para></entry>
- </row>
- </tbody>
- </tgroup>
- </informaltable>
-
</sect3>
<sect3 id="gcalctool-edit-const">
<title>To Use Constant Values</title>
@@ -2137,17 +2085,6 @@ after entering the exponent.</para>
<sect1 id="gcalctool-tech-info">
<title>Technical Information</title>
- <sect2 id="gcalctool-manage-order">
- <title>Order of Operations</title>
- <para>By default, calculations are performed using arithmetic precedence. That is, the precedence of the arithmetic operators is taken into consideration and the result is only calculated when you click <guibutton>Return</guibutton>.</para>
- <para>In the following example, the result of the calculation is 22 because the multiplication operator, <literal>*</literal>, has precedence over the addition operator, <literal>+</literal>.</para>
-
- <screen><literal>4 + 3 * 6 = 22 </literal></screen>
-
- <para>If you do not wish to apply arithmetic precedence to your calculations, select <menuchoice><guimenu>View</guimenu><guimenuitem>Left-to-right Precedence</guimenuitem></menuchoice>. </para>
- <para>If you choose not to apply arithmetic precedence, then the result the calculation in the example is 42 because the calculation is performed from left to right.</para>
- </sect2>
-
<sect2 id="gcalctool-recognize-error">
<title>Error Conditions</title>
<para>If you perform an invalid calculation, &app; indicates the error condition as follows:
@@ -2184,11 +2121,8 @@ be reset to decimal.</para>
<sect2 id="gcalctool-changing-display-area">
<title>Changing The Display Area</title>
- <para>In arithmetic precedence mode, it is possible
-to use the mouse to click on the display area and edit
-it.</para>
- <para>All the normal keyboard shortcuts will work, plus
-the addition of:
+ <para>It is possible to use the mouse to click on the display area and edit it.</para>
+ <para>All the normal keyboard shortcuts will work, plus the addition of:
<itemizedlist>
<listitem><para><keycombo><keycap>Ctrl</keycap><keycap>Delete</keycap></keycombo> which will delete the character to the right of the text cursor</para></listitem>
<listitem><para><keycap>Home</keycap> which moves the text cursor to the beginning of the display area</para></listitem>
@@ -2814,12 +2748,6 @@ the addition of:
<entry><para><xref linkend="gcalctool-calc-functions-separator"/></para> </entry>
</row>
<row valign="top">
- <entry><para><keycombo><keycap>Ctrl</keycap><keycap>l</keycap></keycombo></para></entry>
- <entry><para> <menuchoice> <guimenu>View</guimenu> <guimenuitem>Left-to-right Precedence</guimenuitem> </menuchoice> </para></entry>
- <entry><para> Calculate results using left-to-right precedence</para> </entry>
- <entry><para><xref linkend="gcalctool-manage-order"/></para> </entry>
- </row>
- <row valign="top">
<entry><para><keycombo><keycap>Ctrl</keycap><keycap>m</keycap></keycombo></para></entry>
<entry><para> <menuchoice> <guimenu>View</guimenu> <guimenuitem>Memory Registers</guimenuitem> </menuchoice> </para></entry>
<entry><para>Display the <guilabel>Memory Registers</guilabel> window</para> </entry>
@@ -2838,12 +2766,6 @@ the addition of:
<entry><para><xref linkend="gcalctool-quit"/></para> </entry>
</row>
<row valign="top">
- <entry><para><keycombo><keycap>Ctrl</keycap><keycap>r</keycap></keycombo></para></entry>
- <entry><para> <menuchoice> <guimenu>View</guimenu> <guimenuitem>Arithmetic Precedence</guimenuitem> </menuchoice> </para></entry>
- <entry><para>Calculate results using arithmetic precedence</para> </entry>
- <entry><para><xref linkend="gcalctool-manage-order"/></para> </entry>
- </row>
- <row valign="top">
<entry><para><keycombo><keycap>Ctrl</keycap><keycap>s</keycap></keycombo></para></entry>
<entry><para> <menuchoice> <guimenu>View</guimenu> <guimenuitem>Scientific </guimenuitem> </menuchoice> </para></entry>
<entry><para>Change to Scientific mode</para> </entry>
diff --git a/help/ChangeLog b/help/ChangeLog
index 68effaa..26c6aa8 100644
--- a/help/ChangeLog
+++ b/help/ChangeLog
@@ -1,3 +1,8 @@
+2009-03-17 Robert Ancell <robert ancell gmail com>
+
+ * C/gcalctool.xml: Remove references to arithmetic/left-to-right precedence
+ from the manual (Robert Ancell, Bug #559734)
+
2009-05-04 Robin Sonefors <ozamosi flukkost nu>
* C/gcalctool.xml: Added word size, 1's and 2's complement documentation, updated documentation for other bitwise functions (Bug #581253)
[
Date Prev][
Date Next] [
Thread Prev][
Thread Next]
[
Thread Index]
[
Date Index]
[
Author Index]
