<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook V3.1-Based Variant V1.0//EN" [
 <!ENTITY kcalc "<application>kcalc</application>">
 <!ENTITY % addindex "IGNORE">
 <![ %addindex; [ <!ENTITY docindex SYSTEM "docindex.docbook"> ]]>
]>
<book lang="pt-BR">
<bookinfo>
<title>Manual do KCalc</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>20 Setembro 1997</date>
<releaseinfo>Versão 0.4</releaseinfo>
<abstract>
<para>Este Manual descreve o KCalc versão 0.4</para>
</abstract>
<keywordset>
<keyword>KDE</keyword>
<keyword>KCalc</keyword>
<keyword>scientific calculator</keyword>
</keywordset>
</bookinfo>

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

<para>Esta é a versão 0.4 do KCalc. KCalc é uma simples mas (espera-se)
bastante útil calculadora para o projeto KDE.</para>

<para>O KCalc oferece muito mais funções matemáticas do que parece à
primeira vista. Estude a seção de teclas de atalho e modos deste
manual para aprender mais sobre as várias funções disponíveis.</para>

<para>Em adição à funcionalidade usual oferecida pela maioria das
calculadoras científicas, o KCalc oferece alguns recursos que
achamos serem dignos de nota:</para>

<para><itemizedlist>
<listitem>
<para>KCalc tem modos trigonométrico e estatístico;</para>
</listitem>
<listitem>
<para>KCalc permite copiar e colar números de/para seu display;</para>
</listitem>
<listitem>
<para>KCalc possui uma pilha de resultados, que lhe permite
recuperar comodamente resultados de operações anteriores;</para>
</listitem>
<listitem>
<para>Você pode configurar o tipo de letra e as cores do KCalc;</para>
</listitem>
<listitem>
<para>Você pode configurar a precisão e o número de casas decimais
do KCalc;</para>
</listitem>
<listitem>
<para> KCalc oferece uma grande variedade de teclas de atalho,
o que torna fácil usá-lo mesmo que você não disponha de um 
mouse.</para>
</listitem>
</itemizedlist>
</para>

<para>Divirta-se 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="instalao">
<title>Instalação</title>

<para><emphasis remap="sf">N do T: provavelmente você obteve o KDE como uma distribuição ou
um pacote, que já vem com o KMix. Dificilmente você terá de compilá-lo
e instalá-lo isoladamente conforme descrito abaixo. Esta parte foi mantida
para manter a congruência com o documento original.</emphasis></para>

<sect1 id="como-obter-o-kcalc">
<title>Como obter o KCalc</title>

<para>O KCalc é parte do projeto KDE <ulink url="http://www.kde.org">http://www.kde.org</ulink>,
e pode ser encontrado em <ulink url="ftp://ftp.kde.org/pub/kde/">ftp://ftp.kde.org/pub/kde/</ulink>, 
o site principal do projeto KDE. Sua página Web específica é
<ulink url="http://math.cornell.edu/~wuebben/kde.html">http://math.cornell.edu/~wuebben/kde.html</ulink></para>
</sect1>

<sect1 id="pr-requisitos">
<title>Pré-requisitos</title>

<para>Para compilar o KCalc, você precisa possuir as últimas versões
de <literal remap="tt">libkdecore</literal> e <literal remap="tt">libkdeui</literal>. Todas as bibliotecas
requeridas bem como o KCalc em si podem ser encontrados em
<ulink url="ftp://ftp.kde.org/pub/kde/">ftp://ftp.kde.org/pub/kde/</ulink>. </para>
</sect1>

<sect1 id="compilao-e-instalao">
<title>Compilação e Instalação</title>

<para>O usual:</para>

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

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

<para><emphasis remap="bf">Como habilitar a precisão dupla para o KCalc:</emphasis></para>

<para>Se sua máquina suporta o tipo de número <emphasis>long double</emphasis> (duplo longo, 80 bits
de precisão) e você tem uma biblioteca C capaz de lidar com esse tipo de
número, você pode usar essa precisão no KCalc.</para>

<para><emphasis remap="sf"> Usuários do RedHat 5.0: a biblioteca glibc 2.0.5 presente
nessa distribuição do Linux é defeituosa no tratamento do
<emphasis>long double</emphasis>. Não usem essa precisão ou façam o upgrade da sua
biblioteca C. </emphasis></para>

<para>Eis o que fazer:</para>

<para><orderedlist><listitem>
<para> Verifique o arquivo <literal remap="tt">../config.h</literal> e veja se o símbolo
<literal remap="tt">HAVE&lowbar;LONG&lowbar;DOUBLE</literal> está definido, ou seja, você deve encontrar uma
linha dizendo:

<screen>#define HAVE_LONG_DOUBLE 1
</screen>


Se você não encontrar essa linha em seu sistema, ele não suporta
o tipo a precisão IEEE <emphasis>long double</emphasis>.
</para>
</listitem>
<listitem>
<para> Edite os arquivos <literal remap="tt"> kcalctype.h, configdlg.cpp, kcalc.cpp,</literal> e <literal remap="tt">kcalc&lowbar;core.cpp</literal>, e remova as linhas

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

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

<chapter id="uso">
<title>Uso </title>

<para>O uso ordinário é direto e similar, se não idêntico, à uma calculadora
científica comum. Clique no botão <emphasis remap="bf">KCalc</emphasis> para mostrar a janela
de diálogo de configuração.</para>

<sect1 id="pilha-de-resultados">
<title>Pilha de resultados</title>

<para>Cada vez que você clica o botão Enter ou pressiona as teclas 'igual', 
'Enter' ou 'Return', o resultado do display é gravado na  pilha de
resultados do KCalc. Você pode navegar pela pilha de resultados pressionando
as flechas para cima e para baixo.</para>
</sect1>

<sect1 id="funo-de-porcentagem">
<title>Função de Porcentagem</title>

<para>A função de porcentagem funciona diferente da maioria das calculadoras.
No entando, uma vez entendida, sua funcionalidade avançada prova ser
muito útil. Veja a seção da função de porcentagem em "Comentários sobre
funções específicas" para uma explicação detalhada desta função.</para>
</sect1>

<sect1 id="preciso-fixa">
<title>Precisão Fixa</title>

<para>Habilite a opção de precisão fixa na caixa de diálogo de configuração
se você quer fixar o número de decimais mostrados.</para>
</sect1>

<sect1 id="cortar-e-colar">
<title>Cortar e Colar</title>

<para><itemizedlist>
<listitem>
<para>Pressionar o botão esquerdo do mouse no display do KCalc colocará
o número em voga na Área de Transferência (clipboard).
</para>
</listitem>
<listitem>
<para>Pressionar o botão da direita ou do meio do mouse no display do
KCalc irá trazer o conteúdo da Área de Transferência para o display,
se o conteúdo da Área for um número de ponto flutuante válido.
</para>
</listitem>
</itemizedlist>
</para>
</sect1>
</chapter>

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

<sect1 id="modo-estatstico">
<title>Modo Estatístico</title>

<para>Pressione F4 para comutar para o modo e estatístico.
Alternativamente, abra a caixa de diálogo de configuração (apertando
o botão KCalc) ou pressionando F2.</para>

<para><variablelist>
<varlistentry>
<term>N</term>
<listitem>
<para>Mostra o número de amostras digitado</para>
</listitem>
</varlistentry>
<varlistentry>
<term>INV N </term>
<listitem>
<para>Soma das amostras</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Mea </term>
<listitem>
<para>Média das amostras</para>
</listitem>
</varlistentry>
<varlistentry>
<term>INV Mea </term>
<listitem>
<para>Soma dos quadrados das amostras</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Std </term>
<listitem>
<para>Desvio padrão da amostra</para>
</listitem>
</varlistentry>
<varlistentry>
<term>INV Std </term>
<listitem>
<para>Desvio padrão da população (VERIFICAR ISSO)</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Med </term>
<listitem>
<para>Mediana</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Dat </term>
<listitem>
<para>Assimilar uma amostra digitada</para>
</listitem>
</varlistentry>
<varlistentry>
<term>INV Dat </term>
<listitem>
<para>Apaga a última amostra digitada</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Cst </term>
<listitem>
<para>Apaga tudo que já foi digitado</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</sect1>

<sect1 id="modo-trigonomtrico">
<title>Modo Trigonométrico</title>

<para>Pressione F3 para comutar para o modo trigonométrico.
Alternativamente, abra a caixa de diálogo de configuração (apertando
o botão KCalc) ou pressionando F2.</para>

<para><variablelist>
<varlistentry>
<term>Hyp</term>
<listitem>
<para>Entra em modo hiperbólico. HYP SIN por exemplo é o seno
hiperbólico: sinh(x)</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Sin</term>
<listitem>
<para>Seno do valor no display</para>
</listitem>
</varlistentry>
<varlistentry>
<term>INV Sin</term>
<listitem>
<para>Arco-seno</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Cos</term>
<listitem>
<para>Cosseno</para>
</listitem>
</varlistentry>
<varlistentry>
<term>INV Cos</term>
<listitem>
<para>Arco-cosseno</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Tan</term>
<listitem>
<para>Tangente</para>
</listitem>
</varlistentry>
<varlistentry>
<term>INV Tan</term>
<listitem>
<para>Arco-tangente</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Log</term>
<listitem>
<para>Logaritmo decimal</para>
</listitem>
</varlistentry>
<varlistentry>
<term>INV Log</term>
<listitem>
<para>Calcular 10 elevado ao valor do display</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Ln</term>
<listitem>
<para>Logaritmo natural (base <emphasis>e</emphasis>)</para>
</listitem>
</varlistentry>
<varlistentry>
<term>INV Ln</term>
<listitem>
<para>Calcular <emphasis>e</emphasis> elevado ao valor do display</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</sect1>
</chapter>

<chapter id="teclas-de-atalho">
<title>Teclas de atalho</title>

<para>(PARA FAZER): Esta lista está provavelmente incompleta. Verificar!</para>

<para><screen>
F1                 Ajuda
F2                 Caixa de diálogo de configuração
F3                 Comuta para modo Trigonométrico
F4                 Comuta para modo Estatístico

Seta para cima     mostra elemento anterior da pilha de resultados
Seta para baixo    mostra elemento poserior da pilha de resultados
Page UP            Limpa
Seta à esquerda    Limpa
Page Down          Limpa Tudo
Seta à direita     Limpa Tudo

ALT + d            muda modo trigonomético para graus
ALT + r            muda modo trigonomético para radianos
ALT + g            muda modo trigonomético para grados
ALT + e            muda base numérica para hexadecimal
ALT + o            muda modo trigonomético para octal
ALT + b            muda modo trigonomético para binário

s                  Seno
c                  Cosseno
t                  Tangente
n                  ln  = log base e
l                  log = log base 10
i                  INVerso, se você deseja arcsin(x) clique i s 
\                  +/- 
[                  eleva ao quadrado
^                  x elevado a y 
=                  = 
!                  fatorial
&lt;                  deslocamento à esquerda
&gt;                  deslocamento à direita
&                  operação booleana E
*                  multiplicar
/                  dividir

d                  digita amostra em modo estatístico

o                  operação booleana OU
INV o              operação booleana XOR
r                  1/x (recíproco)
Enter              = 
Return             = 
Backspace          Limpa tudo
Del                Limpa tudo
Esc                Limpa
h                  Hyp (Hiperbólico) como em Hyp Sin = sinh(x) 
</screen>
</para>
</chapter>

<chapter id="comentrios-sobre-funes-especficas">
<title>Comentários sobre funções específicas</title>

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

<para>Calcula o resto da divisão do número do display pelo próximo
número digitado.</para>
</sect1>

<sect1 id="inv-mod">
<title>Inv Mod</title>

<para>Divisão inteira do número do display pelo próximo número digitado.</para>
</sect1>

<sect1 id="index-0">
<title>&percnt;</title>

<para>Interpreta a operação final do cálculo em curso conforme segue:</para>

<para><itemizedlist>
<listitem>
<para>A função da tecla &percnt; é similar à encontrada nas calculadoras CASIO:
</para>
</listitem>
<listitem>
<para>Se o operador final é +, calcula a porcentagem do resultado
sobre o segundo operando.
</para>
</listitem>
<listitem>
<para> Se o operador final é -, calcula a queda de porcentagem do
resultado sobre o segundo operando.
</para>
</listitem>
<listitem>
<para>Se o operador final é *, calcula o segundo operando como uma
porcentagem do primeiro operando.
</para>
</listitem>
<listitem>
<para>Se o operador final é / ou Mod, calcula o primeiro operando
como uma porcentaem do segundo operando.
</para>
</listitem>
<listitem>
<para>Se o operador final é x elevado a y, calcula o primeiro operando 
elevado ao segundo operando dividido por 100.
</para>
</listitem>
<listitem>
<para> Em todos os outros casos a tecla &percnt; gera resultados idênticos
à tecla =.
</para>
</listitem>
</itemizedlist>
                              </para>

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

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

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

<sect1 id="lsh-rsh">
<title>Lsh (Rsh)</title>

<para>Deslocamento à esquerda (direita) por <emphasis>n</emphasis> vezes, onde <emphasis>n</emphasis> é o
próximo número digitado. Você obtém Rsh (deslocamento à direita)
pressionando INV Lsh.</para>
</sect1>
</chapter>

<chapter id="dicas-e-truques">
<title>Dicas e Truques</title>

<sect1 id="tipos-de-letra">
<title>Tipos de letra</title>

<para>Verifiquei que diversas distribuições não configuram direito o FontPath.
Não posso ajudá-lo a obter novas fontes para o X11, mas posso mostrar
como está o meu próprio FontPath está (dentro do arquivo /etc/XF86Config).
Isto pode ajudá-lo a obter melhores resultados com o xemacs e com o XCalc:</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="perguntas-e-respostas">
<title>Perguntas e Respostas</title>

<sect1 id="como-eu-obtenho-o-pi3.1415926...">
<title>Como eu obtenho o pi=3.1415926...?</title>

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

<sect1 id="como-eu-obtenho-o-nmero-de-euler-e">
<title>Como eu obtenho o número de Euler (<emphasis>e</emphasis>) ?</title>

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

<sect1 id="como-eu-obtenho-dois-dgitos-decimais-fixos">
<title>Como eu obtenho dois dígitos decimais fixos ?</title>

<para>Clique no botão KCalc, isto irá trazer a janela de configuração.
Habilite a opção "Colocar Precisão Fixa" e ajuste o controle
numérico de modo que ele mostre 2.</para>
</sect1>

<sect1 id="e-a-preciso">
<title>E a precisão ?</title>

<para>O fator principal que determina a precisão do KCalc é o fato de sua
biblioteca C suportar ou não o tipo de número <emphasis>long double</emphasis>. Se
é o seu caso, o KCalc detectará isso em tempo de compilação e usará
esse tipo de dado para representar números internamente. Verifique
na janela Sobre do KCalc para constatar que tipo de dado numérico
sua cópia de KCalc está usando.</para>

<para>A não ser que você tenha uma biblioteca C de qualidade excepcionalmente
alta, você poderá observar alguns resultados interessantes ao tentar 
executar cálculos como 123.22 - 123.21; 2.01 - 2; 123.88 - 123.87 e 
similares. No entanto, se você acha que isto é ruim, tente fazer as 
mesmas contas na Calculadora do Windows.</para>

<para>Ajuste a precisão na janela de configuração do KCalc, de modo que a
conta acima seja feita corretamente. Recomendo uma precisão de 14 se
o tipo de dado utilizado por você ao compilar o KCalc é o <emphasis>long
double</emphasis>, do contrário use precisão 8 ou 10.</para>

<para>Nota: Precisão mais alta não significa necessariamente um melhor
resultado. Faça alguns testes e você entenderá o que quero dizer.</para>
</sect1>
</chapter>

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

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

KCalc foi inspirado pelo programa xfrmcalc de Martin Barlett,
cuja rotina de pilha ainda é parte de KCalc.

Este programa é software gratuito; você pode redistribuí-lo e/ou
modificá-lo sob os  termos  da  GNU General Public License  como
publicado  pela Free Software Foundation;  qualquer uma das duas
versões de Licença, ou (em sua opinião) alguma versão anterior.

Este  programa é distribuído com  a esperança de que seja  útil,
mas SEM NENHUMA GARANTIA;  sem conformidade com implicações    e
garantias de ACEITAÇÃO NO MERCADO  ou  AJUSTES  PARA  PROPÓSITOS
PARTICULARES.   Veja  a  GNU  General  Public License para  mais
detalhes.

Você  deveria  ter  recebido  uma  cópia  da GNU  General Public
License junto com este programa; se não recebeu, escreva para  a
Free   Software  Foundation,  Inc.,   675  Mass Ave,  Cambridge, 
MA 02139, USA.

</screen>
</para>
</chapter>
<![ %addindex; [ &docindex; ]]>
</book>
<!--
Local Variables:
mode: sgml
sgml-omittag: nil
sgml-shorttag: t
sgml-general-insert-case: lower
End:
-->
