<?xml version="1.0" ?>
<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.1.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [
 <!ENTITY kappname "&kodo;">
 <!ENTITY package "kdetoys">
 <!ENTITY % addindex "IGNORE">
 <!ENTITY % Portuguese "INCLUDE">
]>

<book lang="&language;">
<bookinfo>
<title
>O Manual do &kodo;</title>
<authorgroup>
<author
> <firstname
>Armen</firstname
> <surname
>Nakashian</surname
> <affiliation
> <address
><email
>armen@tourismo.com</email
></address
> </affiliation
> </author>
<othercredit role="translator"
><firstname
>José</firstname
><surname
>Pires</surname
><affiliation
><address
><email
>jncp@netcabo.pt</email
></address
></affiliation
><contrib
>Tradução</contrib
></othercredit>
</authorgroup>

<copyright>
<year
>1999</year
><year
>2001</year>
<holder
>Armen Nakashian</holder>
</copyright>

<legalnotice
>&FDLNotice;</legalnotice>

<date
>2001-03-23</date>
<releaseinfo
>2.01.00</releaseinfo>

<abstract>
<para
>O &kodo; é um pequeno utilitário para medir a distância percorrida no teu ecrã</para>
</abstract>

<keywordset>
<keyword
>KDE</keyword>
<keyword
>KOdómetro</keyword>
<keyword
>odómetro</keyword>
<keyword
>rato</keyword>
<keyword
>distância</keyword>
</keywordset>
</bookinfo>

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

<sect1 id="whats-kodo">
<title
>O que é o &kodo;?</title>

<para
> O &kodo; <emphasis
>mede a distância percorrida no teu ecrã</emphasis
>. Regista o movimento do cursor do teu rato pelo ambiente de trabalho e representa-o em polegadas/pés/milhas! Também pode fazer cm/metros/km. A característica mais interessante é o tripómetro, e a sua óbvia inutilidade.</para>

<note
> <para
>A próxima versão irá ser ÚTIL!</para
> </note>

</sect1>

</chapter>

<chapter id="onscreen-operation">
<title
>Operação no ecrã</title>

<screenshot
> <screeninfo
>Uma imagem etiquetada do &kodo; em acção</screeninfo
> <mediaobject
> <imageobject
> <imagedata fileref="guide.png" format="PNG"/> </imageobject
> <textobject
> <phrase
>Uma imagem etiquetada do &kodo; em acção</phrase
></textobject
> <caption
><para
>Uma imagem. Repara na falta interessante duma barra de título.</para
></caption
> </mediaobject
> </screenshot>

<para
> O <guilabel
>Odómetro</guilabel
> é a distância total percorrida pelo rato desde a última reinicialização do odómetro. O <guilabel
>Tripómetro</guilabel
> é a distância percorrida pelo rato desde: </para>

<sect1 id="menu-options">
<title
>Opções do Menu</title>

<para
> Se chegaste a este ponto, provavelmente já sabes que existe um menu de contexto do botão direito do rato no &kodo;, que contém um conjunto de opções. </para>

<variablelist
> <varlistentry
> <term
><guimenuitem
>Activar</guimenuitem
></term
> <listitem
> <para
> Activa/desactiva o registo da distância. Isto é útil se quiseres fazer batota na distância. <emphasis
>Nota: Isto é ilegal na maioria dos países</emphasis
> </para
> </listitem
> </varlistentry
> <varlistentry
> <term
><guimenuitem
>Unidades Métricas</guimenuitem
></term
> <listitem
> <para
> Como o &kodo; foi feito por um americano, ele assume à partida que queres usar Polegadas/Pés/Milhas para a medição. Se vens de algum país moderno na Europa, para usares as unidades métricas, selecciona esta opção. </para
> </listitem
> </varlistentry
> <varlistentry
> <term
><guimenuitem
>Auto Reiniciar a Viagem</guimenuitem
></term
> <listitem
> <para
> Esta opção fará com que o &kodo; ponha o Tripómetro de novo a zero sempre que é arrancado. </para
> </listitem
> </varlistentry
> <varlistentry
> <term
><guimenuitem
>Reiniciar Viagem</guimenuitem
></term
> <listitem
> <para
> Põe o tripómetro a zero. </para
> </listitem
> </varlistentry
> <varlistentry
> <term
><guimenuitem
>Reiniciar o Contador</guimenuitem
></term
> <listitem
> <para
> Põe o odómetro de novo a zero. <emphasis
>Podes arranjar problemas com isto!</emphasis
></para
> </listitem
> </varlistentry
> <varlistentry
> <term
><guimenuitem
>Acerca do KOdómetro</guimenuitem
></term
> <listitem
> <para
> Mostra uma janela com alguma informação sobre quem deve ser culpado por este programa. </para
> </listitem
> </varlistentry
> <varlistentry
> <term
><guimenuitem
>Ajuda</guimenuitem
></term
> <listitem
> <para
> Esta opção do menu abre a ajuda do &kodo; - este mesmo documento. </para
> </listitem
> </varlistentry
> <varlistentry
> <term
><guimenuitem
>Sair</guimenuitem
></term
> <listitem
> <para
> Sai do &kodo; </para
> </listitem
> </varlistentry
> </variablelist>

</sect1>

</chapter>

<chapter id="how-it-works">
<title
>Como Funciona</title>

<para
>Os ecrãs no &X-Window; são normalmente configurados com uma variável com o tamanho do ecrã. Isto é, quão grande o teu ecrã é em medidas do mundo real, não em pixels. O &kodo; obtém este valor e usa-o em conjunto com o valor do &dpi; (dots per inch - pontos por polegada), para assim relacionar o número de pixels que percorreste com o número de polegadas que te moveste no ecrã.</para>

<para
>Mas sejamos sinceros! É incrivelmente <emphasis
>impreciso</emphasis
>. O &kodo; nem sequer pretende remotamente ser preciso. De facto, houve alguém que mediu o movimento do rato deles pelo ecrã com uma régua e descobriu que o algoritmo da distância tinha um erro de aproximadamente 25&percnt;! A resposta do autor original a esta queixa for <quote
>que é que isso interessa?</quote
>.</para>
</chapter>

<chapter id="license-and-credits">
<title
>Créditos e Licenças</title>

<para
>&kodo; copyright 1998-2001, Armen Nakashian.</para>

<para
>Documentação coypright 1998 Armen Nakashian, com pequenas alterações e limpeza do texto para o &kde; 2.2, Lauri Watts <email
>lauri@kde.org</email
> </para>

&underFDL;
&underGPL;

</chapter>

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

<sect1 id="how-to-obtain-kodo">
<title
>Como obter o &kodo;</title>

&install.intro.documentation;

</sect1>

<sect1 id="compilation-and-installation">
<title
>Compilação e Instalação</title>

&install.compile.documentation;

<para
>Se tiveres problemas comunica-os para o meu endereço de email <email
>armen@tourismo.com</email
>.</para>
</sect1>

</appendix>

</book>

<!--
Local Variables:
mode: sgml
sgml-minimize-attributes:nil
sgml-general-insert-case:lower
sgml-indent-step:0
sgml-indent-data:nil
End:

// vim:ts=0:sw=2:tw=78:noet
-->
