<?xml version="1.0" encoding="UTF-8"?>
<chapter id="firsttime">
<chapterinfo>
  <authorgroup>
    <author
>&Michael.T.Edwardes; &Michael.T.Edwardes.mail; </author>
</authorgroup
> <date
>2010-07-25</date
> <releaseinfo
>4.5</releaseinfo
> </chapterinfo>

<title
>Usando o &kappname; pela primeira vez</title>

<sect1 id="firstime-1">
<title
>Executando o &kappname; pela primeira vez</title>

<para
>Assim que o &kappname; tenha sido completamente carregado, serão abertas duas janelas. A janela de topo, a 'Dica do Dia', oferece uma série de informações rápidas importantes ou úteis sobre a aplicação. <screenshot>
	<screeninfo
>Dica do Dia</screeninfo>
	<mediaobject>
	<imageobject>
	<imagedata fileref="tipofday.png" format="PNG"/>
	</imageobject>
	<textobject>
	<phrase
>Dica do Dia</phrase>
	</textobject>
	</mediaobject>
  </screenshot>
</para>

<para
>É recomendável que você leia rapidamente estas dicas, clicando nos botões <guibutton
>Anterior</guibutton
> e <guibutton
>Próximo</guibutton
>, no fundo da janela. </para>

<para
>Assim que tenha lido as dicas, a janela poderá ser fechadas e será aberta de novo, sempre que o &kappname; for iniciado. Para interromper este comportamento padrão, desligue a opção apropriada na janela da Dica do Dia. </para>

<note>
  <para
>As dicas poderão ser lidas em qualquer momento, selecionando a opção <guimenuitem
>Mostrar a dica do dia</guimenuitem
> no menu <guimenu
>Ajuda</guimenu
>, dentro do &kappname;. </para>
</note>

<para
>Todas as dicas foram extraídas da FAQ (lista de perguntas mais frequentes) que oferece mais alguma ajuda detalhada, e que poderá ser encontrada na <ulink url="http://kmymoney2.sourceforge.net/faq.html"
>página Web</ulink
> e neste manual. </para>

<para
>Por favor, clique em <guibutton
>Fechar</guibutton
> para encerrar a janela da Dica do Dia. </para>
</sect1>

<sect1 id="firsttime.mainwindow">
<title
>A janela principal</title>

<para>
	<screenshot>
	<screeninfo
>A Janela Principal</screeninfo>
	<mediaobject>
	<imageobject>
	<imagedata fileref="mainwindow_numbered.png" format="PNG"/>
	</imageobject>
	<textobject>
	<phrase
>A Janela Principal</phrase>
	</textobject>
	</mediaobject>
	</screenshot>
</para>

<para
>A janela principal do &kappname; consiste em quatro partes importantes </para>

<itemizedlist>
  <listitem
><para
>A. A barra do menu</para
></listitem>
  <listitem
><para
>A. A barra de ferramentas</para
></listitem>
  <listitem
><para
>C. O seletor de áreas</para
></listitem>
  <listitem
><para
>D. A área selecionada</para
></listitem>
</itemizedlist>

<para
>O menu e as barras de ferramentas oferecem o acesso às funcionalidades do &kappname;, permitindo-lhe <link linkend="firsttime.3"
>Criar</link
> arquivos ou configurar o funcionamento do &kappname;. </para>

<para
>O seletor de áreas consiste em pelo menos onze ícones do lado esquerdo da janela principal, dependendo do 'software' fornecido pelo seu sistema. Você poderá adicionar mais ícones através de vários 'plugins'. Clicando num ícone, a janela da área do lado direito é carregada com a área apropriada a mostrar os seus dados financeiros. Cada área oferece uma vista única sobre a sua situação financeira e permite-lhe ver ou editar a informação apresentada. </para>

<para
>O seletor de áreas contém os seguintes ícones </para>

<itemizedlist>
  <listitem>
    <para
><guiicon
> <inlinemediaobject
> <imageobject
> <imagedata fileref="home_view.png" format="PNG"/> </imageobject
> <textobject
> <phrase
>Área Inicial</phrase
> </textobject
> </inlinemediaobject
> </guiicon
> Início: Uma visão geral configurável sobre a sua situação financeira atual (ou uma página introdutória, quando não existirem dados). </para>
  </listitem>

  <listitem>
    <para
><guiicon
> <inlinemediaobject
> <imageobject
> <imagedata fileref="institutions_view.png" format="PNG"/> </imageobject
> <textobject
> <phrase
>Área de Instituições</phrase
> </textobject
> </inlinemediaobject
> </guiicon
> Instituições: Todas as suas instituições e contas, apresentadas de forma hierárquica. </para>
  </listitem>

  <listitem>
    <para
><guiicon
> <inlinemediaobject
> <imageobject
> <imagedata fileref="accounts_view.png" format="PNG"/> </imageobject
> <textobject
> <phrase
>Área de Contas</phrase
> </textobject
> </inlinemediaobject
> </guiicon
> Contas: Todas as suas contas, apresentadas de forma hierárquica. </para>
  </listitem>

  <listitem>
    <para
><guiicon
> <inlinemediaobject
> <imageobject
> <imagedata fileref="schedule_view.png" format="PNG"/> </imageobject
> <textobject
> <phrase
>Área de Agendamentos</phrase
> </textobject
> </inlinemediaobject
> </guiicon
> Agendamentos: Os seus depósitos e movimentos recorrentes. </para>
  </listitem>

  <listitem>
    <para
><guiicon
> <inlinemediaobject
> <imageobject
> <imagedata fileref="categories_view.png" format="PNG"/> </imageobject
> <textobject
> <phrase
>Área de Categorias</phrase
> </textobject
> </inlinemediaobject
> </guiicon
> Categorias: Contas especiais que oferecem a possibilidade de agrupar as transações associadas. </para>
  </listitem>

  <listitem>
    <para
><guiicon
> <inlinemediaobject
> <imageobject
> <imagedata fileref="payees_view.png" format="PNG"/> </imageobject
> <textobject
> <phrase
>Área de Beneficiários</phrase
> </textobject
> </inlinemediaobject
> </guiicon
> Beneficiários: Todos os beneficiários usados pelo &kappname;. </para>
  </listitem>

  <listitem>
    <para
><guiicon
> <inlinemediaobject
> <imageobject
> <imagedata fileref="ledgers_view.png" format="PNG"/> </imageobject
> <textobject
> <phrase
>Área do Livro de Registros</phrase
> </textobject
> </inlinemediaobject
> </guiicon
> Livros de Registros: As suas transações na conta. </para>
  </listitem>

  <listitem>
    <para
><guiicon
> <inlinemediaobject
> <imageobject
> <imagedata fileref="investments_view.png" format="PNG"/> </imageobject
> <textobject
> <phrase
>Área de Investimentos</phrase
> </textobject
> </inlinemediaobject
> </guiicon
> Investimentos: O resumo do seu portfólio. </para>
  </listitem>

  <listitem>
    <para
><guiicon
> <inlinemediaobject
> <imageobject
> <imagedata fileref="reports_view.png" format="PNG"/> </imageobject
> <textobject
> <phrase
>Área de Relatórios</phrase
> </textobject
> </inlinemediaobject
> </guiicon
> Relatórios: Uma coleção de relatórios úteis, oferecendo vistas alternativas sobre os seus dados financeiros. </para>
  </listitem>

  <listitem>
    <para
><guiicon
> <inlinemediaobject
> <imageobject
> <imagedata fileref="budgets_view.png" format="PNG"/> </imageobject
> <textobject
> <phrase
>Área de Orçamentos</phrase
> </textobject
> </inlinemediaobject
> </guiicon
> Orçamentos: Os seus orçamentos </para>
  </listitem>

  <listitem>
    <para
><guiicon
> <inlinemediaobject
> <imageobject
> <imagedata fileref="forecast_view.png" format="PNG"/> </imageobject
> <textobject
> <phrase
>Área de Previsão</phrase
> </textobject
> </inlinemediaobject
> </guiicon
> Previsão: Esta vista oferece uma antevisão sobre as suas contas e categorias </para>
  </listitem>

  <listitem>
    <para
><guiicon
> <inlinemediaobject
> <imageobject
> <imagedata fileref="outbox_view.png" format="PNG"/> </imageobject
> <textobject
> <phrase
>Área de Saída</phrase
> </textobject
> </inlinemediaobject
> </guiicon
> Usada pelo módulo do banco 'online', de modo a oferecer o 'feedback' sobre os processos em execução. Esta é uma vista fornecida pelo 'plugin' KBanking e poderá não estar presente no seu sistema. </para>
  </listitem>
</itemizedlist>
</sect1>

<sect1 id="firsttime.3">
<title
>Criar um novo arquivo</title>

<para
>O &kappname; mantém todos os dados sobre as suas finanças num arquivo. Como foi definido em <link linkend="makingmostof.basicaccounting.personalaccounts"
>Definir as contas (registros pessoais)</link
>, você poderá manter mais de um conjunto de contas, mas os dados de cada um será guardado num arquivo separado, sendo que o &kappname; só pode ter um arquivo aberto de cada vez. Veja o capítulo sobre <link linkend="details.formats"
>Formatos de Arquivos</link
> para obter mais detalhes sobre os arquivos de dados do &kappname;. </para>

<para
>Para criar um novo arquivo, você poderá selecionar a opção <menuchoice
><guimenu
>Arquivo</guimenu
><guimenuitem
>Novo</guimenuitem
></menuchoice
> no menu ou escolher a opção <inlinemediaobject
><imageobject
><imagedata fileref="new.png"/></imageobject
><textobject
><phrase
>Novo</phrase
></textobject
></inlinemediaobject
> da barra de ferramentas. </para>

<para
>O &kappname; irá então abrir o <quote
>Assistente de Configuração dos Novos Arquivos</quote
>, que o guiará pelo processo de criação do arquivo. </para>

<para>
	<screenshot>
	<screeninfo
>Página de Dados Pessoais</screeninfo>
	<mediaobject>
	<imageobject>
	<imagedata fileref="newfile.png" format="PNG"/>
	</imageobject>
	<textobject>
	<phrase
>Página de Dados Pessoais</phrase>
	</textobject>
	</mediaobject>
	</screenshot>
</para>

<para
>Uma vez que todos os campos são opcionais, você poderá usar o &kappname; sem inserir qualquer informação agora. Toda a informação que for aqui inserida só é usada para personalizar o seu arquivo. No futuro, poderá ser usada em alguns relatórios e para o banco 'online'. Se o &kappname; necessitar de alguma informação pessoal nas versões futuras e não encontrar nada, será solicitada a inserção então dos dados relevantes. </para>

<para
>Insira por favor o seu nome e endereço, ou então não insira nada, e pressione <guibutton
>Próximo</guibutton
>. </para>

<para
>No caso de ter um endereço próprio registrado no &kaddressbook;, o botão <guibutton
>Carregar a Partir do Livro de Endereços</guibutton
> ficará ativo e, caso pressione ele, será importada toda a informação para o &kappname;. </para>

<para
>O &kappname; suporta várias moedas. Para definir a sua moeda base (a que você usa no dia-a-dia e que será usada para os seus relatórios), selecione o item apropriado na lista oferecida e pressione <guibutton
>Próximo</guibutton
>. Será selecionada uma por padrão do &kappname;, baseando-se na sua configuração regional. </para>

<para>
	<screenshot>
	<screeninfo
>Página de seleção da moeda base</screeninfo>
	<mediaobject>
	<imageobject>
	<imagedata fileref="newfile-2.png" format="PNG"/>
	</imageobject>
	<textobject>
	<phrase
>Página de seleção da moeda base</phrase>
	</textobject>
	</mediaobject>
	</screenshot>
</para>

<para
>A página seguinte permite-lhe criar uma conta inicial. Para o usuário típico do &kappname;, esta é uma conta corrente. </para>

<para>
	<screenshot>
	<screeninfo
>Página de criação de uma conta corrente</screeninfo>
	<mediaobject>
	<imageobject>
	<imagedata fileref="newfile-3.png" format="PNG"/>
	</imageobject>
	<textobject>
	<phrase
>Página de criação de uma conta corrente</phrase>
	</textobject>
	</mediaobject>
	</screenshot>
</para>

<para
>Insira o nome da conta e um possível número de referência, atribuído pela instituição que faz a gestão da conta. Indique a data de abertura da conta e o saldo inicial da mesma. Por exemplo, se você quiser usar o &kappname; para gerenciar todas as suas finanças desde 01-01-2008, indique então o saldo da conta no início dessa data. O número poderá ser obtido num extrato em papel. Indique depois o nome e o número da agência, ainda que esta informação só seja necessária para o banco 'online'. </para>

<para
>Caso não queira configurar uma conta inicial, desligue por favor a opção </para>

<para
>Assim que terminar, pressione <guibutton
>Próximo</guibutton
> para prosseguir. </para>

<para>
	<screenshot>
	<screeninfo
>Página de seleção do modelo de contas</screeninfo>
	<mediaobject>
	<imageobject>
	<imagedata fileref="newfile-4.png" format="PNG"/>
	</imageobject>
	<textobject>
	<phrase
>Página de seleção do modelo de contas</phrase>
	</textobject>
	</mediaobject>
	</screenshot>
</para>


<para
>Escolha o país e modelos de conta apropriados. Você poderá selecionar vários modelos, incluindo de vários países, com uma combinação das teclas &Ctrl; e &Shift;, em conjunto com o botão esquerdo do mouse. A hierarquia de contas a configurar será apresentada numa área de previsão do assistente. No caso de não conseguir encontrar um modelo adequado às suas necessidades, não selecione nenhum modelo. </para>

<para
>Assim que terminar a seleção do modelo, pressione <guibutton
>Próximo</guibutton
> para prosseguir. </para>

<para
>A página seguinte do assistente permite-lhe configurar as preferências do usuário. Pressione <guibutton
>Próximo</guibutton
> se tiver terminado e quiser prosseguir. </para>

<para>
	<screenshot>
	<screeninfo
>Página de Preferências</screeninfo>
	<mediaobject>
	<imageobject>
	<imagedata fileref="newfile-5.png" format="PNG"/>
	</imageobject>
	<textobject>
	<phrase
>Página de preferências</phrase>
	</textobject>
	</mediaobject>
	</screenshot>
</para>

<para
>A última página do assistente permite-lhe selecionar o nome do arquivo que será usado para guardar os seus dados financeiros. Será criado um nome inicial para o arquivo, com base na sua pasta HOME e o seu nome de usuário. No caso do arquivo existir, será apresentado um aviso que lhe diz para selecionar o nome de um arquivo inexistente. </para>

<para>
	<screenshot>
	<screeninfo
>Página de seleção do nome do arquivo</screeninfo>
	<mediaobject>
	<imageobject>
	<imagedata fileref="newfile-6.png" format="PNG"/>
	</imageobject>
	<textobject>
	<phrase
>Página de seleção do nome do arquivo</phrase>
	</textobject>
	</mediaobject>
	</screenshot>
</para>

<para
>Agora que você terminou de inserir todas as informações relevantes para criar o arquivo, pressione <guibutton
>Terminar</guibutton
> para que o &kappname; crie o arquivo e o abra. </para>

<!--
<para
>After &kappname; has finished loading the default accounts your financial
summary will be displayed.  As you have defined no accounts to hold your
transactions this is currently empty.</para>
-->
</sect1>

<sect1 id="firsttime.4">
<title
>Criando contas</title>

<para
>Você poderá criar uma conta numa de duas formas, as quais são descritas aqui: </para>

<variablelist>
  <varlistentry>
    <term
>Usando o menu</term>
    <listitem>
      <para
>Para criar uma conta com o menu, selecione a opção <menuchoice
><guimenu
>Contas</guimenu
><guimenuitem
>Nova conta</guimenuitem
></menuchoice
>. </para>
    </listitem>
  </varlistentry>

  <varlistentry>
    <term
>Usando a área de contas</term>
    <listitem>
      <para
>Para criar uma conta com a área de contas, clique no ícone Contas no seletor de áreas e depois clique com o botão direito no ícone da árvore de Ativos, do lado direito, e escolha a opção <guimenuitem
>Nova conta</guimenuitem
> no menu de contexto. A árvore de Ativos mantém todas as as contas que sejam ativos. Os ativos, assim como todos os outros tipos de contas, serão discutidos em mais detalhes neste manual. </para>
    </listitem>
  </varlistentry>
</variablelist>

<tip>
  <para
>Repare que o &kappname; usa os menus de contexto de um modo geral em toda a aplicação. Se você não conseguir perceber como tentar fazer algo, tente clicar com o botão direito do mouse onde estaria esperando um determinada funcionalidade. </para>
</tip>

<para
>Ao criar uma conta nova, com qualquer um dos métodos, será aberto o <emphasis
>Assistente de Novas Contas</emphasis
>. Este assistente irá conduzi-lo, passo-a-passo, pelo processo de criação de uma conta, recolhendo as informações necessárias em cada passo. Para navegar pelas páginas, clique nos botões <guibutton
>Anterior</guibutton
> e <guibutton
>Próximo</guibutton
>. </para>

<para
>Crie uma conta com qualquer um dos dois métodos mencionados anteriormente para continuar. Você poderá encontrar uma descrição completa da criação de contas na seção de <link linkend="details.accounts"
>Contas</link
>. </para>

<para
>Agora que uma ou mais contas já existem no &kappname;, o seu resumo de contas aparece na área inicial. Você poderá criar transações manualmente na área do <link linkend="details.ledgers"
>Livro de Registros</link
> ou configurar as transações automáticas com a área de <link linkend="details.schedules"
>Agendamento</link
>. </para>
</sect1>

<sect1 id="firsttime.schedules">
<title
>Agendamentos</title>

<para
>Um <link linkend="details.schedules"
>Agendamento</link
> ou evento recorrente é uma transação que ocorre uma ou mais vezes, durante um determinado período de tempo. Algumas vezes chamadas de transações recorrentes, um exemplo típico é o cheque do seu salário, que recebe todos os meses ou semanas. Em vez de ter que inserir os detalhes da transação sempre que é pago, você poderá dizer ao &kappname; para criar um evento recorrente que irá inserir uma transação para você, quando for pago. </para>

<para
>Para fazer a manutenção dos <link linkend="details.schedules"
>agendamentos</link
>, clique no ícone <guiicon
><inlinemediaobject
><imageobject
><imagedata fileref="schedule_view.png"/></imageobject
></inlinemediaobject
>Agendamentos</guiicon
> no seletor de áreas. </para>
</sect1>

<sect1 id="firsttime.categories">
<title
>Categorias</title>

<para
>Para fazer a manutenção das <link linkend="details.categories"
>categorias</link
>, clique no ícone <guiicon
><inlinemediaobject
><imageobject
><imagedata fileref="categories_view.png"/></imageobject
></inlinemediaobject
>Categorias</guiicon
> no seletor de áreas. </para>

<para
>Você poderá encontrar uma descrição completa sobre este tópico na seção de <link linkend="details.categories"
>Categorias</link
>. </para>
</sect1>

<sect1 id="firsttime.payees">
<title
>Beneficiários</title>

<para
>Para manter a sua lista de beneficiários, clique no ícone de <guiicon
><inlinemediaobject
><imageobject
><imagedata fileref="payees_view.png"/></imageobject
></inlinemediaobject
>Beneficiários</guiicon
> no seletor de áreas. </para>

<para
>Você poderá encontrar uma descrição completa sobre este tópico na seção de <link linkend="details.payees"
>Beneficiários</link
>. </para>
</sect1>

<sect1 id="firsttime.import">
<title
>Importação do Formato de Intercâmbio do Quicken (QIF)</title>

<para
>Se você atualmente usar uma aplicação de gerenciamento financeiro, o &kappname; poderá então importar as transações de uma conta, desde que estejam no formato de intercâmbio do Quicken (QIF). A maioria dos programas financeiros poderá exportar para este formato, e os diferentes métodos das aplicações para exportar em QIF não são aqui explicados, de modo a não alongar este manual. </para>

<para
>Você poderá encontrar uma descrição completa sobre este tópico na seção de <link linkend="details.impexp.qifimp"
>Importação do QIF</link
>. </para>
</sect1>

<sect1 id="firsttime.find">
<title
>Procurando por transações</title>

<para
>O &kappname; oferece uma funcionalidade útil e poderosa de pesquisa de transações, sob a forma de uma janela de pesquisa. </para>

<para
>A janela de pesquisa poderá ser aberta na barra de ferramentas, usando o ícone <guiicon
><inlinemediaobject
><imageobject
><imagedata fileref="transaction_find.png"/></imageobject
></inlinemediaobject
>Procurar</guiicon
> ou selecionando a opção <guimenuitem
>Procurar a Transação</guimenuitem
> do menu <guimenu
>Editar</guimenu
>. </para>

<para
>Você poderá encontrar uma descrição completa sobre este tópico na seção <link linkend="details.search"
>Procurar</link
>. </para>

</sect1>

<sect1 id="firsttime.reconcile">
<title
>Reconciliação</title>

<para
>Em algum momento, você desejará reconciliar as transações que inseriu com as transações que constam num extrato, seja este um extrato bancário, do cartão de crédito, do financiamento ou outro qualquer. A reconciliação envolve fazer a correspondência do que inseriu com o que o extrato apresenta. Se existirem discrepâncias, então você ou a pessoa que criou o extrato cometeram um erro. </para>

<para
>Para reconciliar uma conta, selecione-a primeiro, quer na área de <guiicon
>Contas</guiicon
> quer na área de <guiicon
>Livros de Registros</guiicon
>. Depois, você poderá clicar no ícone <guiicon
>Reconciliar</guiicon
> da barra de ferramentas ou selecionar a opção <guimenuitem
>Reconciliar</guimenuitem
> do menu <guimenu
>Conta</guimenu
>. </para>

<para
>Você poderá encontrar uma descrição completa sobre este tópico na seção de <link linkend="details.reconcile"
>Reconciliação</link
>. </para>

</sect1>

<sect1 id="firsttime.backup">
<title
>Fazendo cópias de segurança</title>

<para
>Agora que você criou algumas contas e inseriu as transações, é uma boa ideia fazer uma cópia de segurança. Uma vez que o arquivo usado pelo &kappname; é um arquivo normal do Unix, você poderá simplesmente copiar o arquivo para outra localização, de modo a fazer uma cópia de segurança, ou usar a janela oferecida pelo &kappname;. O uso da janela é o método preferido, porque se o &kappname; começar a usar outros formatos de arquivos, como o SQL, seria então muito mais complicado copiar o arquivo manualmente. </para>

<para
>Para fazer uma cópia de segurança pelo &kappname;: Selecione a <guimenuitem
>Cópia de Segurança</guimenuitem
> no menu <guimenu
>Arquivo</guimenu
> e insira a pasta para onde deseja copiar o arquivo. Se a pasta precisar ser montada, e se tiver os privilégios suficientes, então assinale a opção chamada <guilabel
>Montar esta pasta antes de fazer a cópia de segurança</guilabel
> e clique em <guibutton
>OK</guibutton
>. </para>

<para
>O arquivo será copiado para a pasta indicada, com a data atual adicionada ao nome do arquivo, para que seja fácil de ver a data em que a cópia de segurança foi criada. </para>
</sect1>

<sect1 id="firsttime.launch">
<title
>Iniciando o &kappname;</title>

<para
>Normalmente, você lançará o &kappname; a partir de um ícone ou de menu do seu gerenciador de janelas. Neste caso, o comportamento padrão é que o &kappname; abrirá o último arquivo que você abriu. No entanto, em algumas situações, você desejará ou precisará iniciar o &kappname; a partir da linha de comando. </para>

<para
>Para uma descrição completa de todas as opções da linha de comando, veja a página do 'man' para o &kappname;. Contudo, existem dois casos especiais que serão aqui descritos. </para>

<formalpara
><title
><command
>kmymoney -n</command
></title>
  <para
>A opção '-n' diz ao &kappname; para não abrir o último arquivo aberto anteriormente. Isto pode ser útil se o programa estourar na inicialização. </para>
</formalpara>

<formalpara
><title
><command
>kmymoney &lt;caminho do arquivo&gt;</command
></title>
  <para
>Fornecer ao &kappname; um nome de arquivo na linha de comando faz com que este arquivo seja aberto ao invés do anterior. Você pode usar o nome de qualquer arquivo válido do &kappname;, como descrito no capítulo sobre <link linkend="details.formats"
>formatos de arquivo</link
>. Além disso, ele pode ser usado para importar um arquivo do <link linkend="details.impexp.gnucash"
>GnuCash</link
>. </para>
</formalpara>

</sect1>

<sect1 id="firsttime.contact">
<title
>Contactar os Programadores / Comunicar Erros</title>

<sect2>
<title
>Contactar os programadores</title>

<para
>Você poderá contactar os programadores, através da sua lista de correio &devlist;. </para>

<para
>Nós estamos ansiosos para ouvir as suas experiências com a utilização do &kappname;. </para>
</sect2>

<sect2>
<title
>Comunicar erros</title>

<para
>Para relatar um erro use por favor a interface fornecido pelo &kappname; selecionando <menuchoice
><guimenu
>Ajuda</guimenu
><guimenuitem
>Relatar erro</guimenuitem
></menuchoice
> e preenche as informações necessárias. No entanto, caso tenha dificuldades com este método, você pode relatar um erro (ou solicitar uma nova funcionalidade ou melhoria) diretamente na <ulink url="http://bugs.kde.org"
>página de reporte de erros do &kde;</ulink
>. Os relatórios devem ser preenchidos para o produto <quote
>kmymoney4</quote
>. O <quote
>kmymoney2</quote
> refere-se a erros nas versões 1.0.x do aplicativo. </para>

<para
>De qualquer modo, antes de relatar um erro, lei por favos a recomendações abaixo. Ao seguí-las será mais provável que os desenvolvedores sejam capazes de rapidamente identificar o problema sem ter que pedir mais informações. </para>

<sect3 id="firsttime.bugs.quality">
<title
>Criando Relatórios de Erros de Qualidade</title>

<para
>Encorajamos os usuários a gastarem algum tempo extra escrevendo relatórios de erros de qualidade, quando os enviarem. Isto reduz o esforço dispendido por ambas as partes, uma vez que o usuário que relata e o programador que irá corrigir irão trocar e-mails até toda esta informação estar realmente no lugar. </para>

<para
>Eli Goldberg escreveu as Recomendações de Escrita de Erros, disponível em <ulink url="http://issues.apache.org/bugwritinghelp.html"
>http://issues.apache.org/bugwritinghelp.html</ulink
>. De um modo geral, você ficará bem servido com estas recomendações: </para>

<formalpara
><title
>Inclua a informação do seu sistema</title>
  <para
>O menu <menuchoice
><guimenu
>Ajuda</guimenu
><guimenuitem
>Comunicar um Erro</guimenuitem
></menuchoice
> irá preencher isto automaticamente. Mas, se preferir não usar esta interface, teremos que saber a versão do &kappname; que você está rodando, a versão do &kde;, o nome e a versão da sua distribuição, bem como a versão do seu 'kernel'. </para>
</formalpara>

<formalpara
><title
>Incluir um registro de chamadas nos estouros</title>
  <para
>O registro de chamadas é normalmente a única e mais útil peça de informação na resolução de estouros. </para>
</formalpara>

<formalpara
><title
>Tentar reproduzi-lo</title>
  <para
>Deixe-nos saber se é capaz de fazer isso. É útil saber se o erro só ocorreu uma vez, e se não o consegue reproduzir de novo, ou se acontece sempre ou muitas vezes, mas não em outras. </para>
</formalpara>

<formalpara
><title
>Incluir passos específicos</title>
  <para
>Este é um mau relatório de erros: <quote
>Eu inseri uma transação, e o &kappname; estourou.</quote
> Um relatório de erros muito melhor é: <quote
>Ao usar o formulário da transação, inseri uma nova transação na minha conta de Cartão de Crédito. Selecionei a página de Transferências, inseri um montante, depois mudei para a página do Depósito e voltei à página de Transferência. Quando regressei à página de Transferência, o &kappname; estourou. Este erro pode ser completamente reproduzido por mim.</quote
> </para>
</formalpara>

<formalpara
><title
>Diga-nos o que esperava que acontecesse</title>
  <para
>Nos estouros, isso é óbvio, mas em alguns erros mais sutis, você poderá ver um relatório de erros onde não seja óbvio o que a pessoa que relatou o erro esperava que acontecesse. Diga-nos sempre o que estava esperando que tivesse acontecido. </para>
</formalpara>

<formalpara
><title
>Considere executá-lo com a depuração ativa</title>
  <para
>Ao compilar uma versão com a opção '--enable-debug=full', você poderá garantir que serão gerados os melhores registros de chamadas. Se encontrar um estouro, execute o &kappname; de novo dentro do 'gdb' e reproduza o estouro. Quando estourar, escreva <quote
>bt</quote
> para gerar um registro de chamadas. </para>
</formalpara>

<para
>Executar a aplicação desta forma é um pouco mais complicado, por isso não se espera que todos os usuários façam isto. Contudo, se você estiver interessado em ajudar o &kappname; a ficar o mais estável possível, esta é a melhor forma de o fazer para descobrir o erro no código e a enviar uma correção. </para>
</sect3>
</sect2>
</sect1>
</chapter>
