<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook V3.1-Based Variant V1.0//EN" [
 <!ENTITY kcalc "<application>kcalc</application>">
]>
<book lang="pt">
<bookinfo>
<title>Manual do KCalc - Calculadora</title>
<authorgroup>
<author>
<firstname>Bernd Johannes</firstname>
<surname>Wuebben</surname>
<affiliation><address><email><ulink url="mailto:wuebben@kde.org">wuebben@kde.org</ulink></email></address></affiliation>
</author>
</authorgroup>
<date>Versão 0.4, 10-03-2000</date>
<releaseinfo><!-- information about this particular version --></releaseinfo>
<abstract>
<para>Este manual descreve a versão 0.4 do KCalc</para>
<para>O Manual do KCalc</para><!-- Merge this with the previous paragraph; it comes from <META NAME="description" CONTENT="..."> --></abstract>
<keywordset>
<keyword>KDE</keyword>
<keyword>KCalc</keyword>
<keyword>calculadora</keyword>
</keywordset>
</bookinfo>

<chapter id="introduction">
<title>Introdução</title>

<para>Esta é a versão 0.4 do KCalc. O KCalc é uma calculadora científica simples e útil
para o projecto KDE. </para>

<para>O KCalc oferece muitas mais funções matemáticas do que pode parecer à primeira vista.
Por favor, estuda a secção de atalhos por teclado e aprende sobre as muitas funções disponíveis.</para>

<para>Em relação às funções normais de uma calculadora científica,
o KCalc oferece um número de características, das quais se destaca:</para>

<para><itemizedlist>
<listitem>
<para>O KCalc tem um modo trigonométrico e estatístico.</para>
</listitem>
<listitem>
<para>O KCalc permite que cortes e coles números
do/no mostrador.</para>
</listitem>
<listitem>
<para>O KCalc oferece uma 'pilha de resultados' que te permite
chamar resultados anteriores. </para>
</listitem>
<listitem>
<para>Podes
configurar as cores e o tipo de letra do mostrador do KCalc.</para>
</listitem>
<listitem>
<para>Podes configurar a precisão do KCalc e o número
de digitos decimais.</para>
</listitem>
<listitem>
<para> A Calculador oferece um grande número de atalhos de teclas úteis, que fazem com que não seja
necessário o uso do rato.</para>
</listitem>
</itemizedlist>
</para>

<para>Diverte-te com o KCalc!</para>

<para><literal remap="tt">Bernd Johannes Wuebben</literal></para>

<para><ulink url="mailto:wuebben@math.cornell.edu">wuebben@math.cornell.edu</ulink></para>
</chapter>

<chapter id="installation">
<title>Instalação</title>

<sect1 id="howtoobtainkcalc">
<title>Como obter o KCalc</title>

<para>O KCalc faz parte do projecto KDE <ulink url="http://www.kde.org">http://www.kde.org</ulink>.
O KCalc pode ser encontrado em <ulink url="ftp://ftp.kde.org/pub/kde/">ftp://ftp.kde.org/pub/kde/</ulink>, o site de ftp
do projecto KDE. A página do KCalc é
<ulink url="http://math.cornell.edu/~wuebben/kde.html">http://math.cornell.edu/~wuebben/kde.html</ulink></para>
</sect1>

<sect1 id="requirements">
<title>Requisitos</title>

<para>Para que possas compilar com sucesso o KCalc, precisas da última versão do <literal remap="tt"> libkdecore</literal> e do <literal remap="tt"> libkdeui</literal>. Todas estas bibliotecas necessárias, tal como o KCalc, podem ser encontradas
em <ulink url="ftp://ftp.kde.org/pub/kde/">ftp://ftp.kde.org/pub/kde/</ulink>. </para>
</sect1>

<sect1 id="compilationandinstallation">
<title>Compilação e Instalação</title>

<para>O habitual:</para>

<para><screen>% ./configure
% make
% make install
</screen>
</para>

<para><emphasis remap="bf">IMPORTANTE:</emphasis> </para>

<para><emphasis remap="bf">Como activar a precisão long double do KCalc:</emphasis></para>

<para>Se a tua máquina suporta 'long double' em C e se
estiveres a trabalhar em libc podes activar a precisão 'long double' do KCalc.</para>

<para>(Utilizadores do RedHat 5.0 estão sem sorte -- eu sugiro
que arrangem uma distribuição de Linux amiga do KDE
e que trabalhe em libc)</para>

<para>Aqui está como o podem fazer:</para>

<para><orderedlist><listitem>
<para> Verifica ../config.h e vê onde quer que HAVE&lowbar;LONG&lowbar;DOUBLE esteja definido, ex.:
devias encontrar uma linha a dizer:

<screen>#define HAVE_LONG_DOUBLE 1
</screen>


Se não conseguires encontrar esta linha é porque o teu sistema não suporta precisão long double IEEE.
</para>
</listitem>
<listitem>
<para> Edita o ficheiro kcalctype.h configdlg.cpp kcalc.cpp e kcalc&lowbar;core.cpp e remove as linhas:

<screen>#ifdef HAVE_LONG_DOUBLE
#undef HAVE_LONG_DOUBLE
#endif
</screen>

</para>
</listitem>
<listitem>
<para> recompila o KCalc.
</para>
</listitem>
</orderedlist>
</para>
</sect1>
</chapter>

<chapter id="usage">
<title>Utilização</title>

<para>A utilização é muito parecida, senão idêntica, a muitas calculadores científicas simples. Carrega no botão <emphasis remap="bf">kCalc</emphasis> para que a janela de configuração apareça.</para>

<sect1 id="resultstack">
<title>Pilha de Resultado</title>

<para>Cada vez que carregas nas teclas 'igual' ou 'Enter', o resultado que aparece no mostrador é escrito para a pilha de resultados do KCalc. Podes viajar na pilha de resultados carregando nas teclas de setas de cima e de baixo.</para>
</sect1>

<sect1 id="percentfunction">
<title>Função de Percentagem</title>

<para>A função de percentagem funciona de uma maneira um pouco diferente da maioria das calculadoras.
Contudo, uma vez entendida, é muito útil.
Vê a secção da função de percentagem nos "Comentários nas funções específicas" para uma explicação detalhada da funcionalidade da percentagem.</para>
</sect1>

<sect1 id="fixedprecision">
<title>Precisão Fixa</title>

<para>Carrega na "check-box" da precisão fixa na janela de configuração se quiseres
afixar o número de digitos que são mostrados à direita da vírgula.</para>
</sect1>

<sect1 id="cutandpaste">
<title>Cortar e Colar</title>

<para><itemizedlist>
<listitem>
<para>Carregando no botão esquerdo do rato sobre o mostrador do KCalc vai ser copiado o número do mostrador
para a área de transferência.</para>
</listitem>
<listitem>
<para>Carregando no botão direito ou no do meio sobre o mostrador do KCalc vai ser colado
o conteúdo da área de transferência para o mostrador, se for um número de vírgula flutuante válido.</para>
</listitem>
</itemizedlist>
</para>
</sect1>
</chapter>

<chapter id="modes">
<title>Modos</title>

<sect1 id="statisticalmode">
<title>Modo Estatístico</title>

<para>Carrega em F3 para trocares entre o modo estatístico e o trignométrico. Alternadamente podes configurá-lo através da janela de configurações carregando no botão KCalc ou
carregando no F2 para trocar para o modo estatístico.</para>

<para><variablelist>
<varlistentry>
<term>N</term>
<listitem>
<para>Chama o número de valores inseridos</para>
</listitem>
</varlistentry>
<varlistentry>
<term>INV N </term>
<listitem>
<para>Mostra a soma de todos os valores inseridos</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Mea </term>
<listitem>
<para>Mostra a média de todos os valores inseridos</para>
</listitem>
</varlistentry>
<varlistentry>
<term>INV Mea </term>
<listitem>
<para>Mostra a soma do quadrado de todos os valores inseridos</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Std </term>
<listitem>
<para>Mostra o desvio padrão (n)</para>
</listitem>
</varlistentry>
<varlistentry>
<term>INV Std </term>
<listitem>
<para>Mostra o desvio padrão da população (n-1)</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Med </term>
<listitem>
<para>Mostra a mediana</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Dat </term>
<listitem>
<para>Insere um valor</para>
</listitem>
</varlistentry>
<varlistentry>
<term>INV Dat </term>
<listitem>
<para>Apaga o último valor inserido</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Cst </term>
<listitem>
<para>Apaga todos os valores inseridos</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</sect1>

<sect1 id="trigonometricmode">
<title>Modo Trignométrico</title>

<para>Carrega no F3 para trocares entre o modo trignométrico. e o estatístico. Alternadamente podes configurá-lo através da janela de configurações carregando no botão kCalc ou 
carregando no F2 para trocar para o modo trignométrico</para> 

<para><variablelist>
<varlistentry>
<term>Hyp</term>
<listitem>
<para>Passa ao sub-modo Hiperbólico. HYP SIN por exemplo é o seno hiperbólico: sinh(x)</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Sin</term>
<listitem>
<para>Calcula o seno.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>INV Sin</term>
<listitem>
<para>Calcula o inverso do seno.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Cos</term>
<listitem>
<para>Calcula o coseno.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>INV Cos</term>
<listitem>
<para>Calcula o inverso do coseno.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Tan</term>
<listitem>
<para>Calcula a tangente.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>INV Tan</term>
<listitem>
<para>Calcula o inverso da tangente.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Log</term>
<listitem>
<para>Calcula o logaritmo de base 10 Log</para>
</listitem>
</varlistentry>
<varlistentry>
<term>INV Log</term>
<listitem>
<para>Calcula 10 levantado a x.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Ln</term>
<listitem>
<para>Calcula o logaritmo natural (que é o log com base e).</para>
</listitem>
</varlistentry>
<varlistentry>
<term>INV Ln</term>
<listitem>
<para>Calcula e levantado a x.</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</sect1>
</chapter>

<chapter id="keyaccels">
<title>Teclas de Atalho</title>

<para>(A Fazer): Esta lista está provavelmente incompleta: Verifica!</para>

<para><screen>
F1         Ajuda
F2         Janela de configurações
F3         Passar para o Modo Trigonométrico
F4         Passar para o Modo Estatístico

Up Key     Mostrar o elemento anterior do stack de resultados
Down Key   Mostrar o elemento seguinte do stack de resultados
Page UP    Apagar
Prior      Apagar
Page Down  Apagar Tudo
Next       Apagar Tudo

ALT + d    Pôr o modo-trig em graus
ALT + r    Pôr o modo-trig em rad
ALT + g    Pôr o modo-trig em grad
ALT + e    Pôr a base em decimal
ALT + o    Pôr a base em octal
ALT + b    Pôr a base em binário

s          Sin 
c          Cos 
t          Tan
n          ln  = log base e
l          log = log base 10
i          Inv inverso, ex.: se queres arcsin(x), escreve i s 
\          +/- 
[          ^2 
^          x^y 
=          = 
!          factorial
&lt;          shift direito
&gt;          shift esquerdo
&          E
*          multiplicar
/          dividir

d          inserir valor estatistico (em modo estat)

o          OR
INV o      XOR
r          1/x r para reciproc 
Enter      = 
Return     = 
Backspace  Apagar Tudo
Del        Apagar Tudo
Esc        Apagar
h          Hyp (Hiperbólico) ex.: Hyp Sin é sinh(x) 
</screen>
</para>
</chapter>

<chapter id="commentsonspecificfunctions">
<title>Comentários das Funções Específicas</title>

<sect1 id="mod">
<title>Mod</title>

<para>Dá o quociente entre o número mostrado e o próximo número inserido.</para>
</sect1>

<sect1 id="invmod">
<title>Inv Mod</title>

<para>Mostra o quociente entre o número mostrado e o próximo número inserido.</para>
</sect1>

<sect1 id="percent">
<title>&percnt;</title>

<para>Interpreta a operação final efectuada na operação actual 
da seguinte maneira:</para>

<para><itemizedlist>
<listitem>
<para>A função da tecla &percnt; é similar às encontradas em algumas calculadoras CASIO:
</para>
</listitem>
<listitem>
<para>Se o operador final for + dá o aumento percentual do resultado sobre o segundo operando.
</para>
</listitem>
<listitem>
<para>Se o operador final for - dá a dimunição percentual do resultado sobre o segundo operando.
</para>
</listitem>
<listitem>
<para>Se o operador final for * dá o operando direito como uma percentagem do operando esquerdo.
</para>
</listitem>
<listitem>
<para>Se o operator final for / ou Mod, dá o operando 
esquerdo como uma percentagem do operando direito.
</para>
</listitem>
<listitem>
<para>Se o operador final for x**y dá o operando esquerdo levantado à potência de (operador direito / 100).
</para>
</listitem>
<listitem>
<para> Em todos os outros casos a tecla &percnt; dá um resultado identico à tecla = .
</para>
</listitem>
</itemizedlist>
                              </para>

<sect2 id="examples">
<title>Exemplos</title>

<para><programlisting>
Tipo:              45 / 55 %
Resposta Mostrada: 81.8181...
Explicação:        45 é 81.81...porcento de 55

Tipo:              11 + 89 %
Resposta Mostrada: 112.35.. 
Explicação:        89 + 11 = 100 e 100 é 112.35 porcento de 89. </programlisting>
</para>
</sect2>
</sect1>

<sect1 id="lshrsh">
<title>Lsh (Rsh)</title>

<para>Shift esquerdo (direito) desloca n vezes, onde n é o próximo valor entrado.
Obtens Rsh (shift direito)  carregando em INV Lsh.</para>
</sect1>
</chapter>

<chapter id="tipsandtricks">
<title>Pistas e Dicas</title>

<sect1 id="fonts">
<title>Fontes</title>

<para>Descobri que várias distribuições não sabiam configurar o FontPath direito,
nem que fontes haviam de instalar para poderem obterem fontes fixes para X11. Não 
te posso
ajudar a remediar isso, mas posso dizer-te como é o meu FontPath no
/etc/XF86Config -- isto levará a que tenhas melhores resultados com o xemacs e com
o kcalc:</para>

<para><screen>Section "Files"
   RgbPath    "/usr/X11R6/lib/X11/rgb"
   FontPath   "/usr/X11R6/lib/X11/fonts/misc:unscaled"
   FontPath   "/usr/X11R6/lib/X11/fonts/75dpi:unscaled"
   FontPath   "/usr/X11R6/lib/X11/fonts/100dpi:unscaled"
   FontPath   "/usr/X11R6/lib/X11/fonts/Type1"
   FontPath   "/usr/X11R6/lib/X11/fonts/Speedo"
   FontPath   "/usr/X11R6/lib/X11/fonts/misc"
   FontPath   "/usr/X11R6/lib/X11/fonts/75dpi"
   FontPath   "/usr/X11R6/lib/X11/fonts/100dpi"
   FontPath   "/usr/X11R6/lib/X11/fonts/cyrillic"
EndSection
</screen>
</para>
</sect1>
</chapter>

<chapter id="questionsandanswers">
<title>Perguntas e Respostas</title>

<sect1 id="howdoigetpi31415926">
<title>Como posso obter pi=3.1415926...?</title>

<para>Simplesmente digita INV EE.</para>
</sect1>

<sect1 id="howdoigetetheeulernumber">
<title>Como posso escrever e (o número Euler)?</title>

<para>Digita 1 INV ln.</para> 
</sect1> 

<sect1 id="howdoigettwofixeddigitsaftertheperiod">
<title>Como posso obter dois digitos fixos depois de uma vírgula?</title>

<para>Clica no botão KCalc, isto abrirá o diálogo de configuração.
Clicando em "Colocar Precisão Fi" e ajustando o valor para
2.</para>
</sect1>

<sect1 id="whataboutprecision">
<title>O que é a Precisão?</title>

<para>O factor principal da determinação da precisão do KCalc é se a tua libc e libmath têm suporte
para o tipo de dados de C <literal remap="tt">long double</literal>. Se este for o caso, o KCalc detecta-o
durante a compilação e usa-o como o seu tipo fundamental de tipo de dados na representação de números.
Verifica o diálogo de Acerca do KCalc para que possas saber qual o tipo de dados fundamental
da tua cópia do KCalc.</para>

<para>A não ser que tenhas um libc e libmath de excepcional qualidade, vais poder
observar alguns resultados "interessantes" quando tentares
executar cálculos como: 123.22 - 123.21; 2.01 - 2; 123.88 - 123.87 e
similares. Contudo se pensas que isto é mau, peço-te que faças a mesma computação na 
calculadora do windows.</para>

<para>Ajustar a precisão no diálogo de Configuração do KCalc para que os cálculos anteriores 
sejam feitos correctamente. Eu recomendo precisão de 14 se o tipo de dados fundamental
da tua cópia do KCalc for long double; em quase contrário recomendo 8 ou 10.</para>

<para>Nota: Precisão mais elevada não significa necessariamente melhores resultados. Brinca um bocado
com a precisão para perceberes o que eu estou a tentar dizer.</para>
</sect1>
</chapter>

<chapter id="copyright">
<title>Copyright</title>

<para><screen>
KCalc Copyright 1996,1997 Bernd Johannes Wuebben 
                          wuebben@math.cornell.edu

O KCalc inspirou-se no xfrmcalc por Martin Bartlett, cujo motor da pilha 
faz parte do KCalc.

Este programa é software gratuito. Pode ser redistribuído e/ou 
moficado ao abrigo da GNU General Public License, tal como 
está publicada pela Free Software Foundation, quer se trate da 
versão 2 da licença, ou (por opção do utilizador) de uma versão 
mais recente.

Este programa é distribuído com o propósito de vir a ser útil, mas 
SEM QUALQUER GARANTIA; nem mesmo as garantias implicitas 
de FORNECIMENTO DE COMPONENTES E/OU ACESSÓRIOS 
ou de AJUSTE PARA UM FIM ESPECÍFICO. Para mais 
pormenores, consultar a GNU General Public License.

Deverá ter sido distribuída uma cópia da GNU General Public 
License juntamente com este programa. Se não, contactar Free 
Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.

</screen>
</para> 

<para>
Tradução da documentação por Ricardo Cruz <email>rick2@ricjoa.fe.up.pt</email>
</para>

</chapter>
</book>
<!--
Local Variables:
mode: sgml
sgml-omittag: nil
sgml-shorttag: t
End:
-->
<!-- actualizado para a versão CVS :1.1: --> 
