| 1 |
<?xml version="1.0" ?> |
| 2 |
<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.5-Based Variant V1.1//EN" "dtd/kdedbx45.dtd" [ |
| 3 |
<!ENTITY % addindex "IGNORE"> |
| 4 |
<!ENTITY % English "INCLUDE" > <!-- change language only here --> |
| 5 |
<!ENTITY commands SYSTEM "commands.docbook"> |
| 6 |
]> |
| 7 |
|
| 8 |
<book id="kcalc" lang="&language;"> |
| 9 |
<bookinfo> |
| 10 |
<title>The &kcalc; Handbook</title> |
| 11 |
|
| 12 |
<authorgroup> |
| 13 |
<author> |
| 14 |
&Bernd.Johannes.Wuebben; &Bernd.Johannes.Wuebben.mail; |
| 15 |
</author> |
| 16 |
|
| 17 |
<author> |
| 18 |
&Pamela.Roberts;&Pamela.Roberts.mail; |
| 19 |
<!-- <affiliation><jobtitle>Handbook maintainer</jobtitle> |
| 20 |
</affiliation> --> |
| 21 |
</author> |
| 22 |
<author> |
| 23 |
&Anne-Marie.Mahfouf;&Anne-Marie.Mahfouf.mail; |
| 24 |
<!-- <affiliation><jobtitle>Handbook maintainer</jobtitle> |
| 25 |
</affiliation> --> |
| 26 |
</author> |
| 27 |
<!-- TRANS:ROLES_OF_TRANSLATORS --> |
| 28 |
</authorgroup> |
| 29 |
|
| 30 |
<copyright> |
| 31 |
<year>2001</year> <year>2002</year> <year>2005</year> <year>2006</year> |
| 32 |
<holder>&Bernd.Johannes.Wuebben;, &Pamela.Roberts;, |
| 33 |
&Anne-Marie.Mahfouf;</holder> |
| 34 |
</copyright> |
| 35 |
|
| 36 |
<legalnotice>&FDLNotice;</legalnotice> |
| 37 |
|
| 38 |
<date>2016-07-25</date> |
| 39 |
<releaseinfo>Applications 16.08</releaseinfo> |
| 40 |
|
| 41 |
<abstract><para>&kcalc; is a calculator for your desktop environment. In the simple mode it can |
| 42 |
be used for basic arithmetic operations, but provides advanced modes for scientific, |
| 43 |
statistical and numeral system calculations.</para></abstract> |
| 44 |
|
| 45 |
<keywordset> |
| 46 |
<keyword>KDE</keyword> |
| 47 |
<keyword>KCalc</keyword> |
| 48 |
<keyword>calculator</keyword> |
| 49 |
</keywordset> |
| 50 |
</bookinfo> |
| 51 |
|
| 52 |
<chapter id="introduction"> |
| 53 |
<title>Introduction</title> |
| 54 |
|
| 55 |
<para>&kcalc; offers many more mathematical functions than meets the eye |
| 56 |
at a first glance. Please study the section on keyboard accelerators and |
| 57 |
modes in this handbook to learn more about the many functions |
| 58 |
available.</para> |
| 59 |
|
| 60 |
<para>In addition to the usual functionality offered by most scientific |
| 61 |
calculators, &kcalc; offers a number of features, which I think are |
| 62 |
worthwhile pointing out:</para> |
| 63 |
|
| 64 |
<itemizedlist> |
| 65 |
<listitem> |
| 66 |
<para>&kcalc; provides trigonometric functions, logic operations, and it is |
| 67 |
able to do statistical calculations.</para> |
| 68 |
</listitem> |
| 69 |
<listitem> |
| 70 |
<para>&kcalc; allows you to cut and paste numbers from/into its display.</para> |
| 71 |
</listitem> |
| 72 |
<listitem> |
| 73 |
<para>&kcalc; features a <firstterm>results-stack</firstterm> which lets |
| 74 |
you conveniently recall previous results.</para> |
| 75 |
</listitem> |
| 76 |
<listitem> |
| 77 |
<para>You can configure &kcalc;'s display colors and font.</para> |
| 78 |
</listitem> |
| 79 |
<listitem> |
| 80 |
<para>You can configure &kcalc;'s precision, the number of displayed digits and the number |
| 81 |
of digits after the period in the settings dialog.</para> |
| 82 |
</listitem> |
| 83 |
<listitem> |
| 84 |
<para> &kcalc; offers a great number of useful <link linkend="key-accels"> |
| 85 |
key-bindings</link>, which make using &kcalc; without using a pointing device easy.</para> |
| 86 |
<para>Hint: pressing (and holding) the &Ctrl;-key, displays on |
| 87 |
every button,the corresponding key-binding.</para> |
| 88 |
</listitem> |
| 89 |
</itemizedlist> |
| 90 |
|
| 91 |
<!--see https://bugs.kde.org/show_bug.cgi?id=326481--> |
| 92 |
<note><para>&kcalc; uses <ulink url="https://en.wikipedia.org/wiki/Calculator_input_methods#Infix_notation">Infix |
| 93 |
notation</ulink> which enforces correct order of operations as taught in school; contrary to |
| 94 |
<ulink url="https://en.wikipedia.org/wiki/Calculator_input_methods#Immediate_execution">Immediate execution</ulink> |
| 95 |
used by many simple calculators. |
| 96 |
</para></note> |
| 97 |
|
| 98 |
<para>Have fun with &kcalc;!</para> |
| 99 |
|
| 100 |
<para>&Bernd.Johannes.Wuebben;</para> |
| 101 |
|
| 102 |
</chapter> |
| 103 |
|
| 104 |
|
| 105 |
<chapter id="usage"> |
| 106 |
<title>Usage</title> |
| 107 |
<sect1 id="general-usage"> |
| 108 |
<title>General Usage</title> |
| 109 |
|
| 110 |
<para>General usage is straightforward and similar to the way most |
| 111 |
simple scientific calculators operate, but take note of the following |
| 112 |
special &kcalc; features:</para> |
| 113 |
|
| 114 |
<variablelist> |
| 115 |
<varlistentry> |
| 116 |
<term>Result Stack</term> |
| 117 |
<listitem><para>Each time you &LMB; click on the |
| 118 |
<guibutton>=</guibutton> button or press your keyboard's |
| 119 |
&Enter; or <keysym>=</keysym> keys, the display result is |
| 120 |
written to &kcalc;'s result stack. You can navigate through the result |
| 121 |
stack with your keyboard's |
| 122 |
<keycombo action="simul">&Ctrl;<keycap>Z</keycap></keycombo> |
| 123 |
and <keycombo action="simul">&Ctrl; &Shift;<keycap>Z</keycap></keycombo> |
| 124 |
keys.</para> |
| 125 |
</listitem> |
| 126 |
</varlistentry> |
| 127 |
|
| 128 |
<varlistentry> |
| 129 |
<term>Percent Function</term> |
| 130 |
<listitem> |
| 131 |
<para>The percent function works somewhat differently to that on most |
| 132 |
calculators. However, once understood, its enhanced functionality proves |
| 133 |
quite useful. See the section about the <link |
| 134 |
linkend="percent">percent</link> function for further details.</para> |
| 135 |
</listitem></varlistentry> |
| 136 |
|
| 137 |
<varlistentry> |
| 138 |
<term>Cut and Paste</term> |
| 139 |
<listitem> |
| 140 |
<para><itemizedlist> |
| 141 |
<listitem> |
| 142 |
<para>Pressing <keycombo action="simul">&Ctrl;<keycap>C</keycap></keycombo> |
| 143 |
will place the displayed number onto the clipboard.</para> |
| 144 |
</listitem> |
| 145 |
<listitem> |
| 146 |
<para>Pressing <keycombo action="simul">&Ctrl;<keycap>V</keycap></keycombo> |
| 147 |
will paste the clipboard content into the display if the content of the |
| 148 |
clipboard is a valid floating point number.</para> |
| 149 |
</listitem> |
| 150 |
<listitem> |
| 151 |
<para>It is still possible to copy/paste by clicking on &kcalc;'s display, |
| 152 |
but this may disappear in future versions.</para> |
| 153 |
</listitem> |
| 154 |
</itemizedlist> |
| 155 |
</para></listitem></varlistentry> |
| 156 |
|
| 157 |
<varlistentry> |
| 158 |
<term>Advanced functions</term> |
| 159 |
<listitem> |
| 160 |
<para>When you start &kcalc; for the first time, the calculator will only |
| 161 |
display buttons for basic arithmetic computations.</para> |
| 162 |
<para>Under the menu entry <guimenu>Settings</guimenu> it is possible to select a mode for &kcalc;: |
| 163 |
it is possible to choose |
| 164 |
<link linkend="simple-mode">Simple</link> or |
| 165 |
<link linkend="science-mode">Science</link> or |
| 166 |
<link linkend="statistical-mode">Statistic</link> or |
| 167 |
<link linkend="numeral-system-mode">Numeral System</link> mode. Please note, that these modes will |
| 168 |
slightly change as &kcalc; evolves.</para> |
| 169 |
</listitem> |
| 170 |
</varlistentry> |
| 171 |
|
| 172 |
<varlistentry> |
| 173 |
<term>Button Layout</term> |
| 174 |
<listitem> |
| 175 |
<para>To give easy access to all the functions in advanced modes in &kcalc;, many keys have a second layout. Click |
| 176 |
on <guibutton>&Shift;</guibutton> or press the shortcut <keycombo action="simul">&Ctrl;<keycap>2</keycap></keycombo> to make |
| 177 |
the second layout of the buttons visible.</para> |
| 178 |
</listitem> |
| 179 |
</varlistentry> |
| 180 |
|
| 181 |
<varlistentry> |
| 182 |
<term>History</term> |
| 183 |
<listitem> |
| 184 |
<para>The history area shows all the calculations done in &kcalc; for the active session of &kcalc;. |
| 185 |
Click on <guibutton>AC</guibutton> or press the shortcut <keycap>Del</keycap> to clear the content of the history. |
| 186 |
To activate or deactivate it, use the item <guilabel>Show History</guilabel> in the menu <guimenu>Settings</guimenu> of the |
| 187 |
menu bar, or press <keycombo action="simul">&Ctrl;<keycap>H</keycap></keycombo>.</para> |
| 188 |
</listitem> |
| 189 |
</varlistentry> |
| 190 |
|
| 191 |
</variablelist> |
| 192 |
</sect1> |
| 193 |
|
| 194 |
|
| 195 |
<!-- describing MODES here --> |
| 196 |
|
| 197 |
<sect1 id="simple-mode"> |
| 198 |
<title>Simple Mode</title> |
| 199 |
<para>This mode contains only those buttons and functions, which are essential necessary for basic calculations.</para> |
| 200 |
<para>If you just want to sum up all items on an invoice this mode may be your choice.</para> |
| 201 |
</sect1> |
| 202 |
|
| 203 |
|
| 204 |
<sect1 id="science-mode"> |
| 205 |
<title>Science Mode</title> |
| 206 |
|
| 207 |
<para>In this mode the left column of buttons is allocated to trigonometric |
| 208 |
functions:</para> |
| 209 |
|
| 210 |
<informaltable><tgroup cols="2"> |
| 211 |
<thead> |
| 212 |
<row><entry>Buttons</entry> |
| 213 |
<entry>Function</entry></row> |
| 214 |
</thead> |
| 215 |
<tbody> |
| 216 |
<row><entry><guibutton>Hyp</guibutton></entry> |
| 217 |
<entry>Enter Hyperbolic sub mode. Hyp Sin for example is the hyperbolic sine: |
| 218 |
sinh</entry></row> |
| 219 |
|
| 220 |
<row><entry><guibutton>Sin</guibutton></entry> |
| 221 |
<entry>Compute the sine</entry></row> |
| 222 |
|
| 223 |
<row><entry>&Shift; <guibutton>Sin</guibutton> or <guibutton>Asin</guibutton></entry> |
| 224 |
<entry>Compute the inverse sine</entry></row> |
| 225 |
|
| 226 |
<row><entry><guibutton>Cos</guibutton></entry> |
| 227 |
<entry>Compute the cosine</entry></row> |
| 228 |
|
| 229 |
<row><entry>&Shift; <guibutton>Cos</guibutton> or <guibutton>Acos</guibutton></entry> |
| 230 |
<entry>Compute the inverse cosine</entry></row> |
| 231 |
|
| 232 |
<row><entry><guibutton>Tan</guibutton></entry> |
| 233 |
<entry>Compute the tangent</entry></row> |
| 234 |
|
| 235 |
<row><entry>&Shift; <guibutton>Tan</guibutton> or <guibutton>Atan</guibutton></entry> |
| 236 |
<entry>Compute the inverse tangent</entry></row> |
| 237 |
|
| 238 |
<row><entry><guibutton>Log</guibutton></entry> |
| 239 |
<entry>Compute the Log base 10</entry></row> |
| 240 |
|
| 241 |
<row><entry>&Shift; <guibutton>Log</guibutton> or 10<superscript>x</superscript></entry> |
| 242 |
<entry>Compute 10 to the power of x</entry></row> |
| 243 |
|
| 244 |
<row><entry><guibutton>Ln</guibutton></entry> |
| 245 |
<entry>Compute the natural logarithm. That is the log to base e</entry></row> |
| 246 |
|
| 247 |
<row><entry>&Shift; <guibutton>Ln</guibutton> or e<superscript>x</superscript></entry> |
| 248 |
<entry>Compute e (the base of the natural logarithm) to the power of x</entry></row> |
| 249 |
|
| 250 |
</tbody></tgroup></informaltable> |
| 251 |
|
| 252 |
<para>The second column has buttons for algebraic functions:</para> |
| 253 |
|
| 254 |
<informaltable><tgroup cols="2"> |
| 255 |
<thead> |
| 256 |
<row><entry>Buttons</entry> |
| 257 |
<entry>Function</entry></row> |
| 258 |
</thead> |
| 259 |
<tbody> |
| 260 |
<row><entry><guibutton>Mod</guibutton></entry> |
| 261 |
<entry>Compute the remainder in Euclidean division</entry></row> |
| 262 |
|
| 263 |
<row><entry><guibutton>&Shift;</guibutton> <guibutton>Mod</guibutton> or <guibutton>IntDiv</guibutton></entry> |
| 264 |
<entry>Integer division (integer part of the quotient)</entry></row> |
| 265 |
|
| 266 |
<row><entry><guibutton>1/x</guibutton></entry> |
| 267 |
<entry>Compute the reciprocal for a number</entry></row> |
| 268 |
|
| 269 |
<row><entry><guibutton>&Shift;</guibutton> <guibutton>1/x</guibutton> or <guibutton>nCm</guibutton></entry> |
| 270 |
<entry>Compute the number of distinct second-operand-element subsets of it that can be formed for any set containing first operand elements (binomial coefficient)</entry></row> |
| 271 |
|
| 272 |
<row><entry><guibutton>x!</guibutton></entry> |
| 273 |
<entry>Compute the product of all positive integers less than or equal to the current integer operand (factorial)</entry></row> |
| 274 |
|
| 275 |
<row><entry><guibutton>x²</guibutton></entry> |
| 276 |
<entry>Compute the square of x</entry></row> |
| 277 |
|
| 278 |
<row><entry><guibutton>&Shift;</guibutton> <guibutton>x²</guibutton> or <guibutton>√x</guibutton></entry> |
| 279 |
<entry>Compute the square root of x</entry></row> |
| 280 |
|
| 281 |
<row><entry><guibutton>xʸ</guibutton></entry> |
| 282 |
<entry>x power y</entry></row> |
| 283 |
|
| 284 |
<row><entry>&Shift; x<superscript>y</superscript> or x<superscript>1/y</superscript></entry> |
| 285 |
<entry>x power 1/y</entry></row> |
| 286 |
|
| 287 |
<row><entry><guibutton>x³</guibutton></entry> |
| 288 |
<entry>Computes the third (cubic) power of x</entry></row> |
| 289 |
|
| 290 |
<row><entry><guibutton>&Shift;</guibutton> <guibutton>x³</guibutton> or <guibutton>∛x</guibutton></entry> |
| 291 |
<entry>Computes the third (cubic) root of x</entry></row> |
| 292 |
|
| 293 |
<row><entry><guibutton>x·10ʸ</guibutton></entry> |
| 294 |
<entry>Computes the product of the first operand and decimal exponent of the second operand</entry></row> |
| 295 |
|
| 296 |
</tbody></tgroup></informaltable> |
| 297 |
|
| 298 |
</sect1> |
| 299 |
|
| 300 |
|
| 301 |
<sect1 id="statistical-mode"> |
| 302 |
<title>Statistical Mode</title> |
| 303 |
|
| 304 |
<para>In this mode the left column of buttons is allocated to statistical |
| 305 |
functions:</para> |
| 306 |
<para> Most of the functionality in this mode is centered around the <guibutton>Dat</guibutton> |
| 307 |
button. To create a data list of numbers, enter a number into the calculator and press |
| 308 |
<guibutton>Dat</guibutton>. A sequentially increasing number is shown on the display indicating |
| 309 |
which position in the Data <quote>list</quote> the number occupies. A traditional calculator only |
| 310 |
stores three values for statistical functions: The number of discrete items in a list, the sum of |
| 311 |
the data items entered and the sum of the square of all data items in the list. &kcalc; differs by |
| 312 |
actually storing each discrete value, allowing you to calculate the median value of the data. |
| 313 |
</para> |
| 314 |
|
| 315 |
<informaltable><tgroup cols="2"> |
| 316 |
<thead> |
| 317 |
<row><entry>Buttons</entry> |
| 318 |
<entry>Function</entry></row></thead> |
| 319 |
|
| 320 |
<tbody> |
| 321 |
<row><entry><guibutton>N</guibutton></entry> |
| 322 |
<entry>Recall the number of data items entered</entry></row> |
| 323 |
|
| 324 |
<row><entry><guibutton>&Shift;</guibutton> <guibutton>N</guibutton> or <guibutton>&Sgr;x</guibutton></entry> |
| 325 |
<entry>Display the sum of all data items entered</entry></row> |
| 326 |
|
| 327 |
<row><entry><guibutton>Mea</guibutton></entry> |
| 328 |
<entry>Display the mean of the data items entered</entry></row> |
| 329 |
|
| 330 |
<row><entry><guibutton>&Shift;</guibutton> <guibutton>Mea</guibutton> or <guibutton>&Sgr;x²</guibutton></entry> |
| 331 |
<entry>Display the sum of the square of all data items entered</entry></row> |
| 332 |
|
| 333 |
<row><entry>&sgr;<subscript>N</subscript></entry> |
| 334 |
<entry>Display the standard deviation (n)</entry></row> |
| 335 |
|
| 336 |
<row><entry><guibutton>&Shift;</guibutton> &sgr;<subscript>N</subscript> or &sgr;<subscript>N-1</subscript> </entry> |
| 337 |
<entry>Display the population standard deviation (n-1)</entry></row> |
| 338 |
|
| 339 |
<row><entry><guibutton>Med</guibutton></entry> |
| 340 |
<entry>Display the median</entry></row> |
| 341 |
|
| 342 |
<row><entry><guibutton>Dat</guibutton></entry> |
| 343 |
<entry>Enter a data item</entry></row> |
| 344 |
|
| 345 |
<row><entry><guibutton>&Shift;</guibutton> <guibutton>Dat</guibutton> or <guibutton>CDat</guibutton></entry> |
| 346 |
<entry>Clear last data item entered</entry></row> |
| 347 |
|
| 348 |
<row><entry><guibutton>CSt</guibutton></entry> |
| 349 |
<entry>Clear the store of all data item entered</entry></row> |
| 350 |
|
| 351 |
</tbody></tgroup></informaltable> |
| 352 |
|
| 353 |
<para>The next two columns hold the buttons with trigonometric and algebraic functions described in the |
| 354 |
<link linkend="science-mode">Science</link> mode section.</para> |
| 355 |
|
| 356 |
</sect1> |
| 357 |
|
| 358 |
|
| 359 |
<sect1 id="numeral-system-mode"> |
| 360 |
<title>Numeral System Mode</title> |
| 361 |
<para>This mode contains buttons and functions to calculate in binary, hexadecimal, octal and decimal.</para> |
| 362 |
|
| 363 |
<para>You select the base from the dropdown menu on the left. To insert a hexadecimal number for example, |
| 364 |
just do the following: Select <guilabel>Hex</guilabel> from the dropdown menu. Then enter a number and note that you can |
| 365 |
use the letters <guibutton>A</guibutton> to <guibutton>F</guibutton> |
| 366 |
for digits larger than 9. In the numeral system view, you can see the number converted to decimal, octal and binary.</para> |
| 367 |
|
| 368 |
<para>Binary, octal and hexadecimal numbers can be displayed as groups of digits separated by whitespaces. Such grouping can improve readability of numbers. For example, hexadecimal number <emphasis>AF1C42</emphasis> can be displayed as <emphasis>AF 1C 42</emphasis> with separation every second digit. Grouping can be turned off or tweaked. Select <menuchoice><guimenu>Settings</guimenu><guimenuitem>Configure &kcalc;...</guimenuitem></menuchoice> to bring up the configuration dialog and change the setting on the <guilabel>General</guilabel> page as appropriate.</para> |
| 369 |
|
| 370 |
<para>You may want to select <guimenu>Show Bit Edit</guimenu> from the <guimenu>Settings</guimenu> menu to see selected bits.</para> |
| 371 |
|
| 372 |
<para>There are logic operators available in this mode. These operators are: |
| 373 |
<informaltable><tgroup cols="2"> |
| 374 |
<thead> |
| 375 |
<row><entry>Buttons</entry> |
| 376 |
<entry>Function</entry></row></thead> |
| 377 |
<tbody> |
| 378 |
<row><entry><guibutton>AND</guibutton></entry> |
| 379 |
<entry>Two numbers are logically anded</entry></row> |
| 380 |
|
| 381 |
<row><entry><guibutton>OR</guibutton></entry> |
| 382 |
<entry>Two numbers are logically ored</entry></row> |
| 383 |
|
| 384 |
<row><entry><guibutton>XOR</guibutton></entry> |
| 385 |
<entry>Two numbers are logically exclusive ored</entry></row> |
| 386 |
|
| 387 |
<row><entry><guibutton>Lsh</guibutton></entry> |
| 388 |
<entry>Left shift the value</entry></row> |
| 389 |
|
| 390 |
<row><entry><guibutton>Rsh</guibutton></entry> |
| 391 |
<entry>Right shift the value</entry></row> |
| 392 |
|
| 393 |
<row><entry><guibutton>Cmp</guibutton></entry> |
| 394 |
<entry>Perform a 1's complement</entry></row> |
| 395 |
|
| 396 |
</tbody></tgroup></informaltable> |
| 397 |
</para> |
| 398 |
|
| 399 |
<para>The second column holds the buttons with algebraic functions described in the |
| 400 |
<link linkend="science-mode">Science</link> mode section.</para> |
| 401 |
|
| 402 |
<para>The third column with the buttons <guibutton>A</guibutton> to <guibutton>F</guibutton> is |
| 403 |
enabled only in <guilabel>Hex</guilabel> mode. |
| 404 |
</para> |
| 405 |
</sect1> |
| 406 |
|
| 407 |
<!-- end of MODES --> |
| 408 |
|
| 409 |
|
| 410 |
<sect1 id="memory-operations"> |
| 411 |
<title>Memory Operations</title> |
| 412 |
|
| 413 |
<para>&kcalc; supports the memory operations given by standard |
| 414 |
calculators plus six slots to hold constants.</para> |
| 415 |
|
| 416 |
<sect2 id="standard_memory"> |
| 417 |
<title> Standard Memory Operations</title> |
| 418 |
|
| 419 |
<para>&kcalc; can remember results of operations for you, and re-use them in |
| 420 |
later calculations. You can access these functions via several buttons |
| 421 |
labeled <guibutton>MR</guibutton>, <guibutton>MS</guibutton>, |
| 422 |
<guibutton>M+</guibutton> and <guibutton>MC</guibutton>.</para> |
| 423 |
|
| 424 |
<variablelist> |
| 425 |
<varlistentry> |
| 426 |
<term><guibutton>MS</guibutton></term> |
| 427 |
<listitem><para>The <guibutton>MS</guibutton> button stores the currently |
| 428 |
displayed result in memory.</para></listitem> |
| 429 |
</varlistentry> |
| 430 |
|
| 431 |
<varlistentry> |
| 432 |
<term><guibutton>M+</guibutton></term> |
| 433 |
<listitem><para>The <guibutton>M+</guibutton> button adds the current result to the |
| 434 |
one in memory. So, if you had stored a 20, and the current result is a 5, |
| 435 |
your memory would contain 25 when you press it. If the memory is empty, it |
| 436 |
acts like <guibutton>MS</guibutton> and simply stores the |
| 437 |
result.</para></listitem> |
| 438 |
</varlistentry> |
| 439 |
|
| 440 |
<varlistentry> |
| 441 |
<term><guibutton>MR</guibutton></term> |
| 442 |
<listitem><para>The <guibutton>MR</guibutton> button gets the value stored |
| 443 |
in memory and puts it in the display.</para></listitem> |
| 444 |
</varlistentry> |
| 445 |
|
| 446 |
<varlistentry> |
| 447 |
<term><guibutton>MC</guibutton></term> |
| 448 |
<listitem><para>The <guibutton>MC</guibutton> button clears the |
| 449 |
memory.</para></listitem> |
| 450 |
</varlistentry> |
| 451 |
</variablelist> |
| 452 |
|
| 453 |
<para>If a value is stored in memory a <guilabel>M</guilabel> will appear in |
| 454 |
the status bar, next to the calculator mode indicator</para> |
| 455 |
</sect2> |
| 456 |
|
| 457 |
<sect2 id="constant_buttons"> |
| 458 |
<title>Constants</title> |
| 459 |
|
| 460 |
<para>The six constants buttons <guibutton>C1</guibutton> to |
| 461 |
<guibutton>C6</guibutton> will only be visible after activating the |
| 462 |
item <guilabel>Constants Buttons</guilabel> in the menu |
| 463 |
<guimenu>Settings</guimenu> of the menu bar. They are available in <guilabel>Science mode</guilabel> |
| 464 |
and <guilabel>Statistics mode</guilabel></para> |
| 465 |
|
| 466 |
<para>To see the value stored in each constant hover the button with the mouse pointer.</para> |
| 467 |
|
| 468 |
<para>To store the number shown in the &kcalc; display in one of the |
| 469 |
six constants, first press <guibutton>&Shift;</guibutton> followed |
| 470 |
by the desired button key <guibutton>C1</guibutton> up to |
| 471 |
<guibutton>C6</guibutton>.</para> |
| 472 |
|
| 473 |
<para>To use the value stored in any of the constants in a calculation, just |
| 474 |
press the desired button (<guibutton>C1</guibutton> to <guibutton>C6</guibutton>), |
| 475 |
and the corresponding number will appear in the display. </para> |
| 476 |
|
| 477 |
<para>It is possible to change the label of the constants button to make it easier |
| 478 |
to remember which button holds which constant. Click with the right mouse |
| 479 |
button on one of the buttons <guibutton>C1</guibutton> to <guibutton> |
| 480 |
C6</guibutton>. A popup menu appears, in which you select <guilabel> |
| 481 |
Set Name</guilabel>. </para> |
| 482 |
|
| 483 |
<para>There are many (mostly physical) predefined constants, which can |
| 484 |
be put on any of the six buttons <guibutton>C1</guibutton> - |
| 485 |
<guibutton>C6</guibutton> by selecting the desired constant in the |
| 486 |
popup menu that appears after right clicking on one of the constant |
| 487 |
buttons and selecting <guilabel>Choose from List</guilabel>. Though |
| 488 |
the predefined constants can also be accessed via the |
| 489 |
<guimenu>Constants</guimenu> in the menu bar, storing it on a |
| 490 |
constants button is very handy, if the number is used |
| 491 |
frequently.</para> |
| 492 |
|
| 493 |
</sect2> |
| 494 |
|
| 495 |
</sect1> |
| 496 |
|
| 497 |
<sect1 id="key-accels"> |
| 498 |
<title>Single Key Accelerators</title> |
| 499 |
|
| 500 |
<para>To simplify entering calculations from the keyboard &kcalc; has single key |
| 501 |
accelerators for most functions. For example entering <userinput>7R</userinput> |
| 502 |
or <userinput>7r</userinput> will calculate the reciprocal of 7 (1/7).</para> |
| 503 |
|
| 504 |
<para>During a computation, you can always press &Ctrl; to make each |
| 505 |
button display its key-binding.</para> |
| 506 |
<!-- Shift works like Caps Lock--> |
| 507 |
<informaltable><tgroup cols="3"> |
| 508 |
<thead> |
| 509 |
<row><entry>Key</entry> |
| 510 |
<entry>Function</entry> |
| 511 |
<entry>Notes</entry></row> |
| 512 |
</thead> |
| 513 |
<tbody> |
| 514 |
|
| 515 |
<row><entry><keycap>H</keycap></entry> |
| 516 |
<entry><guibutton>Hyp</guibutton></entry> |
| 517 |
<entry>Hyperbolic as in Hyp Sin, |
| 518 |
the sinh</entry></row> |
| 519 |
|
| 520 |
<row><entry><keycap>S</keycap></entry> |
| 521 |
<entry><guibutton>Sin</guibutton></entry> |
| 522 |
<entry></entry></row> |
| 523 |
|
| 524 |
<row><entry><keycap>C</keycap></entry> |
| 525 |
<entry><guibutton>Cos</guibutton></entry> |
| 526 |
<entry></entry></row> |
| 527 |
|
| 528 |
<row><entry><keycap>T</keycap></entry> |
| 529 |
<entry><guibutton>Tan</guibutton></entry> |
| 530 |
<entry></entry></row> |
| 531 |
|
| 532 |
<row><entry><keycap>N</keycap></entry> |
| 533 |
<entry><guibutton>Ln</guibutton></entry> |
| 534 |
<entry>log base e</entry></row> |
| 535 |
|
| 536 |
<row><entry><keycap>L</keycap></entry> |
| 537 |
<entry><guibutton>Log</guibutton></entry> |
| 538 |
<entry>log base 10</entry></row> |
| 539 |
|
| 540 |
<row><entry><keycap>Ctrl-2</keycap></entry> |
| 541 |
<entry> <guibutton>&Shift;</guibutton></entry> |
| 542 |
<entry>Second function for this button. ⪚ if |
| 543 |
you want arcsin type <userinput>Ctrl-2 s </userinput></entry></row> |
| 544 |
|
| 545 |
<row><entry><keysym>\</keysym></entry> |
| 546 |
<entry><guibutton>+/-</guibutton></entry> |
| 547 |
<entry>Change sign</entry></row> |
| 548 |
|
| 549 |
<row><entry><keysym>[</keysym></entry> |
| 550 |
<entry><guibutton>x^2</guibutton></entry> |
| 551 |
<entry></entry></row> |
| 552 |
|
| 553 |
<row><entry><keysym>^</keysym></entry> |
| 554 |
<entry><guibutton>x^y</guibutton></entry> |
| 555 |
<entry></entry></row> |
| 556 |
|
| 557 |
<row><entry><keysym>!</keysym></entry> |
| 558 |
<entry><guibutton>x!</guibutton></entry> |
| 559 |
<entry>Factorial</entry></row> |
| 560 |
|
| 561 |
<row><entry><keysym>E</keysym></entry> |
| 562 |
<entry>x10<superscript>y</superscript></entry> |
| 563 |
<entry>Exponent</entry></row> |
| 564 |
|
| 565 |
<row><entry><keysym><</keysym></entry> |
| 566 |
<entry><guibutton>Lsh</guibutton></entry> |
| 567 |
<entry>Left shift</entry></row> |
| 568 |
<!-- no "<" on Lsh key only ">" on Rsh key--> |
| 569 |
<row><entry><keysym>></keysym></entry> |
| 570 |
<entry><guibutton>Rsh</guibutton></entry> |
| 571 |
<entry>Right shift.</entry></row> |
| 572 |
<row><entry><keysym>&</keysym></entry> |
| 573 |
<entry><guibutton>AND</guibutton></entry> |
| 574 |
<entry>Logical AND</entry></row> |
| 575 |
|
| 576 |
<row><entry><keysym>x</keysym> or <keysym>*</keysym></entry> |
| 577 |
<entry><guibutton>X</guibutton></entry> |
| 578 |
<entry>Multiply</entry></row> |
| 579 |
|
| 580 |
<row><entry><keysym>/</keysym></entry> |
| 581 |
<entry><guibutton>/</guibutton></entry> |
| 582 |
<entry>Divide</entry></row> |
| 583 |
|
| 584 |
<row><entry><keycap>D</keycap></entry> |
| 585 |
<entry><guibutton>Dat</guibutton></entry> |
| 586 |
<entry>Enter data item in statistical mode</entry></row> |
| 587 |
|
| 588 |
<row><entry><keycap>|</keycap></entry> |
| 589 |
<entry><guibutton>OR</guibutton></entry> |
| 590 |
<entry>Logical OR. Note: <guibutton>&Shift;</guibutton> |
| 591 |
<guibutton>OR</guibutton> is XOR</entry></row> |
| 592 |
|
| 593 |
<row><entry><keycap>R</keycap></entry> |
| 594 |
<entry><guibutton>1/x</guibutton></entry> |
| 595 |
<entry>Reciprocal</entry></row> |
| 596 |
|
| 597 |
<row><entry>&Enter;</entry> |
| 598 |
<entry><guibutton>=</guibutton></entry> |
| 599 |
<entry></entry></row> |
| 600 |
|
| 601 |
<row><entry><keycap>Return</keycap></entry> |
| 602 |
<entry><guibutton>=</guibutton></entry> |
| 603 |
<entry></entry></row> |
| 604 |
|
| 605 |
<row><entry>&Backspace;</entry> |
| 606 |
<entry><guibutton><=</guibutton></entry> |
| 607 |
<entry>Delete last number</entry></row> |
| 608 |
|
| 609 |
<row><entry><keycap>PgUp</keycap></entry> |
| 610 |
<entry><guibutton>C</guibutton></entry> |
| 611 |
<entry>Clear</entry></row> |
| 612 |
|
| 613 |
<row><entry>&Esc;</entry> |
| 614 |
<entry><guibutton>C</guibutton></entry> |
| 615 |
<entry>Clear</entry></row> |
| 616 |
<!-- |
| 617 |
<row><entry><keycap>Prior</keycap></entry> |
| 618 |
<entry><guibutton>C</guibutton></entry> |
| 619 |
<entry>Clear</entry></row> |
| 620 |
--> |
| 621 |
<row><entry><keycap>PgDown</keycap></entry> |
| 622 |
<entry><guibutton>AC</guibutton></entry> |
| 623 |
<entry>Clear all</entry></row> |
| 624 |
<!-- |
| 625 |
<row><entry><keycap>Next</keycap></entry> |
| 626 |
<entry><guibutton>AC</guibutton></entry> |
| 627 |
<entry>Clear all</entry></row> |
| 628 |
--> |
| 629 |
<row><entry><keycap>Del</keycap></entry> |
| 630 |
<entry><guibutton>AC</guibutton></entry> |
| 631 |
<entry>Clear all</entry></row> |
| 632 |
|
| 633 |
<row><entry><keycap>:</keycap></entry> |
| 634 |
<entry><guibutton>Mod</guibutton></entry> |
| 635 |
<entry>remainder of dividing</entry></row> |
| 636 |
|
| 637 |
<row><entry>&Alt;+<keycap>1</keycap> to &Alt;+<keycap>6</keycap></entry> |
| 638 |
<entry><guibutton>C1</guibutton></entry> |
| 639 |
<entry>use the value stored in C1 to C6</entry></row> |
| 640 |
|
| 641 |
</tbody></tgroup></informaltable> |
| 642 |
|
| 643 |
</sect1> |
| 644 |
</chapter> |
| 645 |
|
| 646 |
<chapter id="comments-on-specific-functions"> |
| 647 |
<title>Comments on Specific Functions</title> |
| 648 |
|
| 649 |
<sect1 id="mod"> |
| 650 |
<title>Mod and IntDiv</title> |
| 651 |
|
| 652 |
<variablelist> |
| 653 |
<varlistentry> |
| 654 |
<term><guibutton>Mod</guibutton> gives the remainder of dividing the displayed |
| 655 |
number by the next input number.</term> |
| 656 |
<listitem><para><userinput>22 Mod 8 = </userinput> will give the result |
| 657 |
<emphasis>6</emphasis></para> |
| 658 |
<para><userinput>22.345 Mod 8 = </userinput> will give the result |
| 659 |
<emphasis>6.345</emphasis></para> |
| 660 |
</listitem></varlistentry> |
| 661 |
|
| 662 |
<varlistentry> |
| 663 |
<term><guibutton>&Shift;</guibutton> <guibutton>IntDiv</guibutton> does integer |
| 664 |
division of the displayed number by the next input number.</term> |
| 665 |
<listitem><para><userinput>22 Shift IntDiv 8 = </userinput> will give the result |
| 666 |
<emphasis>2</emphasis></para> |
| 667 |
<para><userinput>22.345 Shift IntDiv 8 = </userinput> also gives <emphasis>2</emphasis> |
| 668 |
</para></listitem></varlistentry> |
| 669 |
</variablelist> |
| 670 |
|
| 671 |
</sect1> |
| 672 |
|
| 673 |
|
| 674 |
<sect1 id="percent"> |
| 675 |
<title>%</title> |
| 676 |
|
| 677 |
<para>Used instead of the <guibutton>=</guibutton> key, |
| 678 |
<guibutton>%</guibutton> interprets the final operation carried out in the |
| 679 |
current calculation as follows:</para> |
| 680 |
|
| 681 |
<para><itemizedlist> |
| 682 |
<listitem> |
| 683 |
<para>If the final operator is + or - the second argument is interpreted as percentage of the first operand. |
| 684 |
</para> |
| 685 |
</listitem> |
| 686 |
<listitem> |
| 687 |
<para>If the final operator is * divide the result of the multiplication by 100. |
| 688 |
</para> |
| 689 |
</listitem> |
| 690 |
<listitem> |
| 691 |
<para>If the final operator is / give the left operand |
| 692 |
as a percentage of the right operand. |
| 693 |
</para> |
| 694 |
</listitem> |
| 695 |
<listitem> |
| 696 |
<para> In all other cases the % key gives identical results to the = key. |
| 697 |
</para> |
| 698 |
</listitem> |
| 699 |
</itemizedlist></para> |
| 700 |
|
| 701 |
<variablelist> |
| 702 |
<varlistentry> |
| 703 |
<term>Examples:</term> |
| 704 |
<listitem> |
| 705 |
<para><userinput>150 + 50 %</userinput> gives <emphasis>225</emphasis> (150 plus 50 percent of this amount)</para> |
| 706 |
<para><userinput>42 * 3 %</userinput> gives |
| 707 |
<emphasis>1.26</emphasis> (42 * 3 / 100)</para> |
| 708 |
<para><userinput>45 / 55 %</userinput> gives |
| 709 |
<emphasis>81.81...</emphasis> (45 is 81.81.. percent of 55)</para> |
| 710 |
</listitem> |
| 711 |
</varlistentry> |
| 712 |
</variablelist> |
| 713 |
|
| 714 |
</sect1> |
| 715 |
|
| 716 |
<sect1 id="lsh-rsh"> |
| 717 |
<title>Lsh and Rsh</title> |
| 718 |
<variablelist> |
| 719 |
<varlistentry> |
| 720 |
<term><guibutton>Lsh</guibutton> left shifts the integer part of the displayed |
| 721 |
value (multiplies it by 2) n times, where n is the next input number, and |
| 722 |
gives an integer result (base is set to <guibutton>Bin</guibutton>):</term> |
| 723 |
<listitem><para><userinput>10 Lsh 3 =</userinput> gives <emphasis>80</emphasis> |
| 724 |
(10 multiplied by 2 three times).</para> |
| 725 |
<para><userinput>10.345 Lsh 3 =</userinput> also gives |
| 726 |
<emphasis>80</emphasis>.</para></listitem> |
| 727 |
</varlistentry> |
| 728 |
|
| 729 |
<varlistentry> |
| 730 |
<term><guibutton>Rsh</guibutton> right shifts the |
| 731 |
value (performs an integer divide by 2) n times.</term> |
| 732 |
<listitem><para><userinput>16 Rsh 2 =</userinput> gives |
| 733 |
<emphasis>4</emphasis> (16 divided by 2 twice).</para> |
| 734 |
<para><userinput>16.999 Rsh 2 =</userinput> also gives |
| 735 |
<emphasis>4</emphasis>.</para> |
| 736 |
</listitem> |
| 737 |
</varlistentry> |
| 738 |
</variablelist> |
| 739 |
|
| 740 |
</sect1> |
| 741 |
|
| 742 |
<sect1 id="and-or-xor"> |
| 743 |
<title>Cmp, And, Or and Xor</title> |
| 744 |
|
| 745 |
<para>The <guibutton>Cmp</guibutton>, <guibutton>And</guibutton> and |
| 746 |
<guibutton>Or</guibutton> functions perform bitwise logical operations and |
| 747 |
therefore appear more meaningful if the base is set to |
| 748 |
<guilabel>Hex</guilabel>, <guilabel>Oct</guilabel> or <guilabel>Bin</guilabel> |
| 749 |
rather than <guilabel>Dec</guilabel>. In the following |
| 750 |
examples base is set to <guilabel>Bin</guilabel>.</para> |
| 751 |
|
| 752 |
<variablelist> |
| 753 |
<varlistentry> |
| 754 |
<term><guibutton>Cmp</guibutton> performs a 1's complement (inverts the |
| 755 |
bits).</term> |
| 756 |
<listitem><para><userinput>101 Cmp</userinput> gives |
| 757 |
<emphasis>111...111010</emphasis></para> </listitem> |
| 758 |
</varlistentry> |
| 759 |
|
| 760 |
<varlistentry> |
| 761 |
<term><guibutton>AND</guibutton> does a logical AND.</term> |
| 762 |
<listitem><para><userinput>101 AND 110 =</userinput> gives |
| 763 |
<emphasis>100</emphasis></para> </listitem> |
| 764 |
</varlistentry> |
| 765 |
|
| 766 |
<varlistentry> |
| 767 |
<term><guibutton>OR</guibutton> does the logical OR.</term> |
| 768 |
<listitem><para><userinput>101 OR 110 =</userinput> gives |
| 769 |
<emphasis>111</emphasis></para> </listitem> |
| 770 |
</varlistentry> |
| 771 |
|
| 772 |
<varlistentry> |
| 773 |
<term><guibutton>XOR</guibutton> performs the logical |
| 774 |
XOR (exclusive OR) operation.</term> |
| 775 |
<listitem><para><userinput>101 XOR 110 =</userinput> gives |
| 776 |
<emphasis>11</emphasis></para> </listitem> |
| 777 |
</varlistentry> |
| 778 |
|
| 779 |
</variablelist> |
| 780 |
</sect1> |
| 781 |
</chapter> |
| 782 |
|
| 783 |
|
| 784 |
<chapter id="questions-and-answers"> |
| 785 |
<title>Questions and Answers</title> |
| 786 |
|
| 787 |
<qandaset> |
| 788 |
|
| 789 |
|
| 790 |
<qandaentry> |
| 791 |
<question><para>How do I get e, the Euler number?</para></question> |
| 792 |
<answer><para>Press <userinput>1 Shift e<superscript>x</superscript></userinput> in the &kcalc; window, |
| 793 |
press <userinput>1 <keycombo action="simul">&Ctrl;<keycap>2</keycap></keycombo> <keycap>N</keycap></userinput> on the keyboard |
| 794 |
or use the <menuchoice><guimenu>Constants</guimenu><guimenuitem>Mathematics</guimenuitem> |
| 795 |
</menuchoice> menu.</para></answer> |
| 796 |
</qandaentry> |
| 797 |
|
| 798 |
<qandaentry> |
| 799 |
<question><para>How do I get two fixed digits after the period?</para></question> |
| 800 |
<answer><para>Select <menuchoice><guimenu>Settings</guimenu><guimenuitem> |
| 801 |
Configure &kcalc;...</guimenuitem></menuchoice> on the menu bar, this will |
| 802 |
bring up the configuration dialog. Check <guilabel>Set decimal |
| 803 |
precision</guilabel> and adjust the spin control so that it shows a |
| 804 |
2.</para></answer> </qandaentry> |
| 805 |
|
| 806 |
<qandaentry> |
| 807 |
<question><para>What about Precision?</para></question> |
| 808 |
<answer><para>The main factor determining the precision of &kcalc; is whether your libc and libmath |
| 809 |
supports the C data type <type>long double</type>. If this is the case, &kcalc; will detect this |
| 810 |
at compile time and use it as its fundamental data type to represent numbers. |
| 811 |
</para> |
| 812 |
|
| 813 |
<para>Adjust the <guilabel>Precision</guilabel> in &kcalc;'s |
| 814 |
<guibutton>Configure</guibutton> dialog so that the above computations |
| 815 |
work correctly. I recommend a precision of 14 if the fundamental data type |
| 816 |
for your copy of &kcalc; is <type>long double</type>, otherwise 8 or 10.</para> |
| 817 |
|
| 818 |
<para>Higher precision doesn't necessarily lead to better results. Play with |
| 819 |
the precision and you will see what I mean.</para> |
| 820 |
</answer> |
| 821 |
</qandaentry> |
| 822 |
|
| 823 |
</qandaset> |
| 824 |
</chapter> |
| 825 |
|
| 826 |
&commands; |
| 827 |
|
| 828 |
<chapter id="copyright"> |
| 829 |
<title>Credits and License</title> |
| 830 |
|
| 831 |
<para>&kcalc; Program Copyright ©:</para> |
| 832 |
<para>&Bernd.Johannes.Wuebben; 1996-2000</para> |
| 833 |
<para>The &kde; Team 2000-2008</para> |
| 834 |
<para>&Evan.Teran; 2008-2013</para> |
| 835 |
|
| 836 |
<itemizedlist> |
| 837 |
<listitem><para>&Bernd.Johannes.Wuebben; &Bernd.Johannes.Wuebben.mail;</para></listitem> |
| 838 |
<listitem><para>&Evan.Teran; &Evan.Teran.mail;</para></listitem> |
| 839 |
<listitem><para>&Espen.Sand; &Espen.Sand.mail;</para></listitem> |
| 840 |
<listitem><para>&Chris.Howells; &Chris.Howells.mail;</para></listitem> |
| 841 |
<listitem><para>&Aaron.J.Seigo; &Aaron.J.Seigo.mail;</para></listitem> |
| 842 |
<listitem><para>&Charles.Samuels; &Charles.Samuels.mail;</para></listitem> |
| 843 |
<listitem><para>&David.Johnson; &David.Johnson.mail;</para></listitem> |
| 844 |
</itemizedlist> |
| 845 |
|
| 846 |
<para>&kcalc; was inspired by <personname><firstname>Martin</firstname> <surname>Bartlett</surname></personname>'s <application>xfrmcalc</application>, |
| 847 |
whose stack engine is still part of &kcalc;.</para> |
| 848 |
|
| 849 |
<para>Documentation Copyright © 2001,2002,2005, 2006,2010:</para> |
| 850 |
<itemizedlist> |
| 851 |
<listitem><para>&Bernd.Johannes.Wuebben; &Bernd.Johannes.Wuebben.mail;</para></listitem> |
| 852 |
<listitem><para>&Pamela.Roberts; &Pamela.Roberts.mail;</para></listitem> |
| 853 |
<listitem><para>&J.Hall; &J.Hall.mail;</para></listitem> |
| 854 |
<listitem><para>&Anne-Marie.Mahfouf; &Anne-Marie.Mahfouf.mail;</para></listitem> |
| 855 |
<listitem><para><personname><firstname>Eike</firstname><surname>Krumbacher</surname></personname> |
| 856 |
<email>[email protected]</email></para></listitem> |
| 857 |
</itemizedlist> |
| 858 |
|
| 859 |
<!-- TRANS:CREDIT_FOR_TRANSLATORS --> |
| 860 |
&underFDL; |
| 861 |
&underGPL; |
| 862 |
|
| 863 |
</chapter> |
| 864 |
|
| 865 |
</book> |
| 866 |
|
| 867 |
<!-- |
| 868 |
Local Variables: |
| 869 |
mode: sgml |
| 870 |
sgml-minimize-attributes:nil |
| 871 |
sgml-general-insert-case:lower |
| 872 |
sgml-indent-step:0 |
| 873 |
sgml-indent-data:nil |
| 874 |
End: |
| 875 |
--> |