Debian Codegraph @

doc/index.docbook

raw
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. &eg; 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>&lt;</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>&gt;</keysym></entry>
570 <entry><guibutton>Rsh</guibutton></entry>
571 <entry>Right shift.</entry></row>
572 <row><entry><keysym>&amp;</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>&lt;=</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>&percnt;</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 &percnt; 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 &copy;:</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 &copy; 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 -->