diff options
Diffstat (limited to 'tde-i18n-pt_BR/docs/tdesdk')
47 files changed, 3364 insertions, 14442 deletions
diff --git a/tde-i18n-pt_BR/docs/tdesdk/cervisia/index.docbook b/tde-i18n-pt_BR/docs/tdesdk/cervisia/index.docbook index 42e2b9423b1..7d53026f162 100644 --- a/tde-i18n-pt_BR/docs/tdesdk/cervisia/index.docbook +++ b/tde-i18n-pt_BR/docs/tdesdk/cervisia/index.docbook @@ -2,408 +2,182 @@ <!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [ <!ENTITY kappname "&cervisia;"> <!ENTITY package "tdesdk"> - <!ENTITY ssh "<command ->ssh</command ->"> - <!ENTITY rsh "<command ->rsh</command ->"> + <!ENTITY ssh "<command>ssh</command>"> + <!ENTITY rsh "<command>rsh</command>"> <!ENTITY % addindex "IGNORE"> - <!ENTITY % Brazilian-Portuguese "INCLUDE" -> <!-- Change language only here --> - <!ENTITY CVS "<application ->CVS</application ->"> + <!ENTITY % Brazilian-Portuguese "INCLUDE"> <!-- Change language only here --> + <!ENTITY CVS "<application>CVS</application>"> ]> <book lang="&language;"> <bookinfo> -<title ->Manual do &cervisia;</title> +<title>Manual do &cervisia;</title> <authorgroup> -<author -><firstname ->Bernd</firstname -><surname ->Gehrmann</surname -> <affiliation -><address -><email ->bernd@mail.berlios.de</email -></address -></affiliation> -</author -> -<author -><firstname ->Carlos</firstname -><surname ->Woelz</surname -> <affiliation -><address -><email ->carloswoelz@imap-mail.com</email -></address -></affiliation> -</author -> - - -<othercredit role="translator" -><firstname ->Marcus</firstname -><surname ->Gama</surname -><affiliation -><address -><email ->marcus.gama@gmail.com</email -></address -></affiliation -><contrib ->Tradução</contrib -></othercredit -> +<author><firstname>Bernd</firstname><surname>Gehrmann</surname> <affiliation><address><email>bernd@mail.berlios.de</email></address></affiliation> +</author> +<author><firstname>Carlos</firstname><surname>Woelz</surname> <affiliation><address><email>carloswoelz@imap-mail.com</email></address></affiliation> +</author> + + +<othercredit role="translator"><firstname>Marcus</firstname><surname>Gama</surname><affiliation><address><email>marcus.gama@gmail.com</email></address></affiliation><contrib>Tradução</contrib></othercredit> </authorgroup> <copyright> -<year ->1999</year> -<year ->2000</year> -<year ->2001</year> -<year ->2002</year> -<holder ->Bernd Gehrmann</holder> +<year>1999</year> +<year>2000</year> +<year>2001</year> +<year>2002</year> +<holder>Bernd Gehrmann</holder> </copyright> <copyright> -<year ->2004</year> -<holder ->Carlos Woelz</holder> +<year>2004</year> +<holder>Carlos Woelz</holder> </copyright> -<legalnotice ->&FDLNotice;</legalnotice> +<legalnotice>&FDLNotice;</legalnotice> -<date ->2004-06-06</date> -<releaseinfo ->2.01.90</releaseinfo> +<date>2004-06-06</date> +<releaseinfo>2.01.90</releaseinfo> <abstract> -<para ->O &cervisia; oferece uma visão gráfica do &CVS;.</para> +<para>O &cervisia; oferece uma visão gráfica do &CVS;.</para> </abstract> <keywordset> -<keyword ->KDE</keyword> -<keyword ->tdesdk</keyword> -<keyword ->Cervisia</keyword> -<keyword ->CVS</keyword> -<keyword ->controle de versão</keyword> -<keyword ->controle de revisão</keyword> +<keyword>KDE</keyword> +<keyword>tdesdk</keyword> +<keyword>Cervisia</keyword> +<keyword>CVS</keyword> +<keyword>controle de versão</keyword> +<keyword>controle de revisão</keyword> </keywordset> </bookinfo> <chapter id="introduction"> -<title ->Introdução</title> +<title>Introdução</title> -<para ->O <ulink url="http://www.kde.org/apps/cervisia/" ->&cervisia;</ulink -> é uma interface amigável com o usuário para o sistema de controle de versão. O objetivo é suportar o &CVS; e outros programas de sistemas de controle de versão em uma interface unificada, com recursos de resolução de conflitos, visualizadores de diferenças e histórico, estado para as cópias de trabalho dos arquivos, e suporte para maioria das funções de controle. Você pode obter o &cervisia; compilando o módulo do tdesdk ou instalando o pacote tdesdk fornecido por sua distribuição. Atualmente, somento o &CVS; é suportado, mas outros sistemas de controle de versão serão integrados no futuro. </para> +<para>O <ulink url="http://www.kde.org/apps/cervisia/">&cervisia;</ulink> é uma interface amigável com o usuário para o sistema de controle de versão. O objetivo é suportar o &CVS; e outros programas de sistemas de controle de versão em uma interface unificada, com recursos de resolução de conflitos, visualizadores de diferenças e histórico, estado para as cópias de trabalho dos arquivos, e suporte para maioria das funções de controle. Você pode obter o &cervisia; compilando o módulo do tdesdk ou instalando o pacote tdesdk fornecido por sua distribuição. Atualmente, somento o &CVS; é suportado, mas outros sistemas de controle de versão serão integrados no futuro. </para> -<para ->Um sistema de controle de versão é uma ferramenta para gravar, gerenciar e distribuir diferentes versões de arquivos. O &CVS; é um sistema de controle de versão. Ele permite compartilhar suas modificações facilmente, bem como que cada contribuidor possa trabalhar em sua cópia local ao mesmo tempo, sem medo de sobrescrever modificações feitas por outros. Ele permite a recuperação de versões antigas (útil para análise de erros), a criação de ramificações (para desenvolvimento experimental ou para lançamentos de código) e mais. </para> +<para>Um sistema de controle de versão é uma ferramenta para gravar, gerenciar e distribuir diferentes versões de arquivos. O &CVS; é um sistema de controle de versão. Ele permite compartilhar suas modificações facilmente, bem como que cada contribuidor possa trabalhar em sua cópia local ao mesmo tempo, sem medo de sobrescrever modificações feitas por outros. Ele permite a recuperação de versões antigas (útil para análise de erros), a criação de ramificações (para desenvolvimento experimental ou para lançamentos de código) e mais. </para> -<para ->O <firstterm ->repositório</firstterm -> principal normalmente mantém um projeto colaborativo (comercial ou não), mas você pode aproveitar as vantagens dos excelentes recursos de controle de revisão oferecidos pelo &CVS; também para um projeto desenvolvido exclusivamente por você. É fácil configurar um repositório local, e você terá a habilidade de rastrear as mudanças que causaram erros, reverter mudanças, prevenir perda acidental de informação, &etc; </para> +<para>O <firstterm>repositório</firstterm> principal normalmente mantém um projeto colaborativo (comercial ou não), mas você pode aproveitar as vantagens dos excelentes recursos de controle de revisão oferecidos pelo &CVS; também para um projeto desenvolvido exclusivamente por você. É fácil configurar um repositório local, e você terá a habilidade de rastrear as mudanças que causaram erros, reverter mudanças, prevenir perda acidental de informação, &etc; </para> -<para ->O repositório mantém os arquivos do projeto, e cada contribuidor mantém sua própria cópia local, chamada <firstterm ->cópia de trabalho</firstterm -> ou <firstterm ->área local</firstterm ->. Um contribuidor pode adicionar suas modificações no repositório principal (um processo chamado "envio") e/ou atualizar sua própria cópia para refletir as mudanças recentes feitas por outros contribuidores. </para> +<para>O repositório mantém os arquivos do projeto, e cada contribuidor mantém sua própria cópia local, chamada <firstterm>cópia de trabalho</firstterm> ou <firstterm>área local</firstterm>. Um contribuidor pode adicionar suas modificações no repositório principal (um processo chamado "envio") e/ou atualizar sua própria cópia para refletir as mudanças recentes feitas por outros contribuidores. </para> </chapter> <chapter id="getting-started"> -<title ->Iniciando</title> +<title>Iniciando</title> <sect1 id="accessing-repository"> -<title ->Acessando O Repositório</title> +<title>Acessando O Repositório</title> -<para ->Nesta seção, nós mostraremos como usar as funcionalidades básicas do sistema de controle de versão usando o &cervisia;, basicamente para copiar módulos do repositório e trabalhar com eles. Para fazer isto, você deve ter acesso ao repositório como um cliente, ou seja, alguém (provavelmente o administrador do repositório &CVS;) deve lhe fornecer uma conta na máquina servidora. Alternativamente, você pode facilmente criar um repositório local para seu próprio projeto. </para> +<para>Nesta seção, nós mostraremos como usar as funcionalidades básicas do sistema de controle de versão usando o &cervisia;, basicamente para copiar módulos do repositório e trabalhar com eles. Para fazer isto, você deve ter acesso ao repositório como um cliente, ou seja, alguém (provavelmente o administrador do repositório &CVS;) deve lhe fornecer uma conta na máquina servidora. Alternativamente, você pode facilmente criar um repositório local para seu próprio projeto. </para> -<tip -><para ->Se você planeja desenvolver um projeto complexo, é uma boa idéia usar os recursos do &CVS;, mesmo que você seja o único desenvolvedor. Você pode fazer todas as mudanças em sua cópia de trabalho e usar o &cervisia; (ou qualquer outra ferramenta &CVS;) para atualizar e enviar. Deste modo, você obterá a habilidade de rastrear mudanças que causem erros, reverter mudanças, evitar perda acidental de informação, &etc;. Usando o &cervisia; é simples criar um repositório local. </para> +<tip><para>Se você planeja desenvolver um projeto complexo, é uma boa idéia usar os recursos do &CVS;, mesmo que você seja o único desenvolvedor. Você pode fazer todas as mudanças em sua cópia de trabalho e usar o &cervisia; (ou qualquer outra ferramenta &CVS;) para atualizar e enviar. Deste modo, você obterá a habilidade de rastrear mudanças que causem erros, reverter mudanças, evitar perda acidental de informação, &etc;. Usando o &cervisia; é simples criar um repositório local. </para> <procedure> -<title ->Criando um Repositório Local</title> - -<step -><para ->Abra o diálogo <guilabel ->Criar Novo Repositório (cvs init)</guilabel -> escolhendo <menuchoice -><guimenu ->Repositório</guimenu -> <guimenuitem ->Criar...</guimenuitem -></menuchoice ->. </para -></step> - -<step -><para ->Pressione o botão <guilabel ->...</guilabel -> para selecionar a pasta onde você deseja criar o repositório, ou insira sua localização na caixa de texto. Por exemplo, se você deseja colocar o repositório na pasta <filename ->/home/usuario</filename ->, e nomeá-lo como <filename ->raizcvs</filename ->, você deve digitar <filename ->/home/usuario/raizcvs</filename -> na caixa de texto, ou selecionar a pasta <filename ->/home/usuario</filename -> usando o selecionador de arquivo e adicionar <filename ->raizcvs</filename ->. </para -></step> - -<step -><para ->Confirme pressionando o botão <guibutton ->OK</guibutton ->. O &cervisia; criará e inicializará a nova pasta do repositório. </para -></step> - -<step -><para ->Agora você pode importar seu trabalho atual para o repositório, ou simplesmente criar uma pasta no repositório para iniciar um novo módulo a partir do zero. </para -></step> +<title>Criando um Repositório Local</title> + +<step><para>Abra o diálogo <guilabel>Criar Novo Repositório (cvs init)</guilabel> escolhendo <menuchoice><guimenu>Repositório</guimenu> <guimenuitem>Criar...</guimenuitem></menuchoice>. </para></step> + +<step><para>Pressione o botão <guilabel>...</guilabel> para selecionar a pasta onde você deseja criar o repositório, ou insira sua localização na caixa de texto. Por exemplo, se você deseja colocar o repositório na pasta <filename>/home/usuario</filename>, e nomeá-lo como <filename>raizcvs</filename>, você deve digitar <filename>/home/usuario/raizcvs</filename> na caixa de texto, ou selecionar a pasta <filename>/home/usuario</filename> usando o selecionador de arquivo e adicionar <filename>raizcvs</filename>. </para></step> + +<step><para>Confirme pressionando o botão <guibutton>OK</guibutton>. O &cervisia; criará e inicializará a nova pasta do repositório. </para></step> + +<step><para>Agora você pode importar seu trabalho atual para o repositório, ou simplesmente criar uma pasta no repositório para iniciar um novo módulo a partir do zero. </para></step> </procedure> </tip> -<para ->O &cervisia; oferece uma interface integrada para gerenciar todas as localizações de seus repositórios, o diálogo <guilabel ->Configurar Acesso aos Repositórios</guilabel ->. Para exibí-lo, selecione o ítem de menu <menuchoice -><guimenu ->Repositório</guimenu -> <guimenuitem ->Repositórios...</guimenuitem -></menuchoice ->. </para> +<para>O &cervisia; oferece uma interface integrada para gerenciar todas as localizações de seus repositórios, o diálogo <guilabel>Configurar Acesso aos Repositórios</guilabel>. Para exibí-lo, selecione o ítem de menu <menuchoice><guimenu>Repositório</guimenu> <guimenuitem>Repositórios...</guimenuitem></menuchoice>. </para> <figure id="screenshot-repositories" float="1"> -<title ->Uma captura de tela da caixa de diálogo Configurar Acesso aos Repositórios do &cervisia;</title> +<title>Uma captura de tela da caixa de diálogo Configurar Acesso aos Repositórios do &cervisia;</title> <mediaobject> -<imageobject -><imagedata format="PNG" fileref="repositories.png"/></imageobject> -<textobject -><phrase ->Uma captura de tela da caixa de diálogo Configurar Acesso aos Repositórios do &cervisia;</phrase -></textobject> +<imageobject><imagedata format="PNG" fileref="repositories.png"/></imageobject> +<textobject><phrase>Uma captura de tela da caixa de diálogo Configurar Acesso aos Repositórios do &cervisia;</phrase></textobject> </mediaobject> </figure> -<para ->Existem diversos métodos de acesso a um repositório CVS. Ele pode ser acessado através de um autenticação por senha (:pserver:), shell seguro (usando :ext:), repositório local (:local:), &etc;. O formato para a localização do repositório é (ítens opcionais aparecem entre colchetes): </para> +<para>Existem diversos métodos de acesso a um repositório CVS. Ele pode ser acessado através de um autenticação por senha (:pserver:), shell seguro (usando :ext:), repositório local (:local:), &etc;. O formato para a localização do repositório é (ítens opcionais aparecem entre colchetes): </para> <para> -<filename ->[:método:][[usuário][:senha]@]nomemáquina[:[porta]]/caminho/para/repositório</filename> +<filename>[:método:][[usuário][:senha]@]nomemáquina[:[porta]]/caminho/para/repositório</filename> </para> -<para ->Nem todos os ítens (usuário, senha, nome da máquina, porta) são sempre necessários para acessar o repositório. As informações necessárias dependem do método de acesso usado, que pode ser categorizado como se segue: </para> +<para>Nem todos os ítens (usuário, senha, nome da máquina, porta) são sempre necessários para acessar o repositório. As informações necessárias dependem do método de acesso usado, que pode ser categorizado como se segue: </para> <variablelist> <varlistentry> -<term ->Local</term> +<term>Local</term> <listitem> -<para ->O método de acesso local é o método padrão usado pelo &CVS;. Logo, é opcional adicionar o método :local: à localização do repositório. Você pode inserir simplesmente o caminho para a pasta que armazena o repositório &CVS;, e é acessível de seu computador, como <filename class="directory" ->/caminho/para/repositório</filename -> ou para fornecer um exemplo da vida real, <filename class="directory" ->/home/cvs</filename ->.</para> - -<para ->Ela pode estar fisicamente em um disco que é montado via <acronym ->NFS</acronym ->, mas este é um detalhe irrelevante. Se você criar um repositório local, a localização será simplesmente o caminho para ele. </para> +<para>O método de acesso local é o método padrão usado pelo &CVS;. Logo, é opcional adicionar o método :local: à localização do repositório. Você pode inserir simplesmente o caminho para a pasta que armazena o repositório &CVS;, e é acessível de seu computador, como <filename class="directory">/caminho/para/repositório</filename> ou para fornecer um exemplo da vida real, <filename class="directory">/home/cvs</filename>.</para> + +<para>Ela pode estar fisicamente em um disco que é montado via <acronym>NFS</acronym>, mas este é um detalhe irrelevante. Se você criar um repositório local, a localização será simplesmente o caminho para ele. </para> </listitem> </varlistentry> <varlistentry id="rsh"> -<term ->rsh</term> +<term>rsh</term> <listitem> -<para ->A localização do repositório se parece com algo como <filename ->:ext:usuario@maquina.url.org:/caminho/para/repositorio</filename -> </para> - -<para ->Este método necessita que você tenha uma conta de usuário na máquina servidora (neste exemplo, <systemitem class="systemname" ->maquina.url.org</systemitem ->) e use um shell remoto para comunicação. Por padrão, o &CVS; usa o ↱ para esta finalidade, no entanto, o ↱ é considerado muito inseguro, e é freqüentemente substituído pelo &ssh;. </para> - -<para ->Se você usar o &ssh;, você deve configurar a variável de ambiente $<envar ->CVS_RSH</envar -> para &ssh; quando usar o cliente <command ->cvs</command ->. O &cervisia; suporta isto facilmente. </para> +<para>A localização do repositório se parece com algo como <filename>:ext:usuario@maquina.url.org:/caminho/para/repositorio</filename> </para> + +<para>Este método necessita que você tenha uma conta de usuário na máquina servidora (neste exemplo, <systemitem class="systemname">maquina.url.org</systemitem>) e use um shell remoto para comunicação. Por padrão, o &CVS; usa o ↱ para esta finalidade, no entanto, o ↱ é considerado muito inseguro, e é freqüentemente substituído pelo &ssh;. </para> + +<para>Se você usar o &ssh;, você deve configurar a variável de ambiente $<envar>CVS_RSH</envar> para &ssh; quando usar o cliente <command>cvs</command>. O &cervisia; suporta isto facilmente. </para> <!-- TODO: verify if the above still apply --> -<para ->Observe que o &cervisia; não pode responder a possíveis solicitações de senha da máquina servidora. Você deve certificar-se que um login remoto trabalhe sem requisitar que você insira a senha. Com o ↱, isto pode ser conseguido por exemplo criando um arquivo <filename ->.rhosts</filename -> em sua pasta pessoal com uma lista de máquinas confiáveis (veja o manual do ↱). </para> - -<para ->Com o &ssh;, isto pode ser conseguido copiando sua chave pública localizada no arquivo <filename ->identity.pub</filename ->, localizado na pasta <filename ->$<envar ->HOME</envar ->/.ssh</filename -> para o servidor. Neste caso, a chave não deve estar criptografada com a frase-senha (veja o manual do &ssh; e o <acronym ->FAQ</acronym -> do &CVS;/<acronym ->SSH</acronym -> no SourceForge). Se você não tem certeza de como fazer isso, pergunte ao seu administrador de sistema. </para> +<para>Observe que o &cervisia; não pode responder a possíveis solicitações de senha da máquina servidora. Você deve certificar-se que um login remoto trabalhe sem requisitar que você insira a senha. Com o ↱, isto pode ser conseguido por exemplo criando um arquivo <filename>.rhosts</filename> em sua pasta pessoal com uma lista de máquinas confiáveis (veja o manual do ↱). </para> + +<para>Com o &ssh;, isto pode ser conseguido copiando sua chave pública localizada no arquivo <filename>identity.pub</filename>, localizado na pasta <filename>$<envar>HOME</envar>/.ssh</filename> para o servidor. Neste caso, a chave não deve estar criptografada com a frase-senha (veja o manual do &ssh; e o <acronym>FAQ</acronym> do &CVS;/<acronym>SSH</acronym> no SourceForge). Se você não tem certeza de como fazer isso, pergunte ao seu administrador de sistema. </para> </listitem> </varlistentry> <varlistentry> -<term ->pserver</term> +<term>pserver</term> <listitem> -<para ->A localização do repositório se parece com algo como <filename ->:pserver:usuario@maquina.url.org:/caminho/para/repositorio</filename -> </para> +<para>A localização do repositório se parece com algo como <filename>:pserver:usuario@maquina.url.org:/caminho/para/repositorio</filename> </para> -<para ->Este método acessa o servidor através de um protocolo especial com um autenticação relativamente fraca (<literal ->pserver</literal -> pede por uma autenticação de senha). Antes de você poder usar um servidor, você precisa de um nome de usuário e senha fornecidos pelo administrador do servidor &CVS;, e deve realizar o login. Observe que seu nome de usuário e senha para o &CVS; não precisam necessariamente corresponder aos do sistema. Antes de acessar o servidor &CVS;, você precisará logar-se. </para> +<para>Este método acessa o servidor através de um protocolo especial com um autenticação relativamente fraca (<literal>pserver</literal> pede por uma autenticação de senha). Antes de você poder usar um servidor, você precisa de um nome de usuário e senha fornecidos pelo administrador do servidor &CVS;, e deve realizar o login. Observe que seu nome de usuário e senha para o &CVS; não precisam necessariamente corresponder aos do sistema. Antes de acessar o servidor &CVS;, você precisará logar-se. </para> -<para ->Projetos de código aberto oferecem tipicamente acesso por CVS Anônimo aos seus códigos. Isto significa que você pode facilmente obter os códigos mais atualizados, modificar e criar remendos (diferenças) com base no repositório sem necessitar de uma conta CVS. Como uma regra geral, o CVS Anônimo usa autenticação por senha (:pserver:), e é um repositório somente de leitura, não permitindo que você envie suas mudanças diretamente. </para> +<para>Projetos de código aberto oferecem tipicamente acesso por CVS Anônimo aos seus códigos. Isto significa que você pode facilmente obter os códigos mais atualizados, modificar e criar remendos (diferenças) com base no repositório sem necessitar de uma conta CVS. Como uma regra geral, o CVS Anônimo usa autenticação por senha (:pserver:), e é um repositório somente de leitura, não permitindo que você envie suas mudanças diretamente. </para> </listitem> </varlistentry> </variablelist> -<para ->Conhecendo o método de acesso e localização do repositório, você pode adicioná-lo à lista de repositórios do &cervisia;: </para> +<para>Conhecendo o método de acesso e localização do repositório, você pode adicioná-lo à lista de repositórios do &cervisia;: </para> <procedure> -<title ->Adicionando um Novo Repositório</title> - -<step -><para ->Abra o diálogo <guilabel ->Configurar Acesso aos Repositórios</guilabel -> selecionando o ítem de menu <menuchoice -><guimenu ->Repositório</guimenu -> <guimenuitem ->Repositórios...</guimenuitem -></menuchoice ->. </para -></step> - -<step -><para ->Pressione o botão <guilabel ->Adicionar...</guilabel -> para abrir o diálogo <guilabel ->Adicionar Repositório</guilabel ->. </para -></step> - -<step -><para ->Insira a localização do repositório na caixa de texto <guilabel ->Repositório:</guilabel ->. O &cervisia; automaticamente desabilitará áreas do diálogo que não são relevantes ao método de acesso inserido. </para -></step> - -<step -><para ->Se você estiver usando o método de acesso ext ao repositório, insira o shell remoto que deseja usar (⪚ &ssh;) na caixa de texto <guilabel ->Usar shell remoto (somente para repositórios :ext:):</guilabel ->. </para -></step> - -<step -><para ->Pressione <guibutton ->OK</guibutton ->. Você verá o repositório que acabou de inserir na lista de repositórios. </para -></step> - -<step -><para ->Se o método de acesso do repositório que você inseriu é autenticado por senha (pserver), você precisará logar-se antes de conectar ao servidor. Clique o repositório na lista para selecioná-lo, e pressione o botão <guilabel ->Login...</guilabel ->. Insira sua senha no diálogo que é exibido. </para> -<para ->Se você inserir com sucesso sua senha, a entrada de coluna <guilabel ->Estado</guilabel -> do repositório pserver mudará de <guilabel ->Não logado</guilabel -> para <guilabel ->Logado</guilabel ->. </para -></step> - -<step -><para ->Pressione <guibutton ->OK</guibutton -> para aplicar suas modificações, ou adicione outra localização à lista. O &cervisia; armazenará tantas localizações quanto desejar. </para -></step> +<title>Adicionando um Novo Repositório</title> + +<step><para>Abra o diálogo <guilabel>Configurar Acesso aos Repositórios</guilabel> selecionando o ítem de menu <menuchoice><guimenu>Repositório</guimenu> <guimenuitem>Repositórios...</guimenuitem></menuchoice>. </para></step> + +<step><para>Pressione o botão <guilabel>Adicionar...</guilabel> para abrir o diálogo <guilabel>Adicionar Repositório</guilabel>. </para></step> + +<step><para>Insira a localização do repositório na caixa de texto <guilabel>Repositório:</guilabel>. O &cervisia; automaticamente desabilitará áreas do diálogo que não são relevantes ao método de acesso inserido. </para></step> + +<step><para>Se você estiver usando o método de acesso ext ao repositório, insira o shell remoto que deseja usar (⪚ &ssh;) na caixa de texto <guilabel>Usar shell remoto (somente para repositórios :ext:):</guilabel>. </para></step> + +<step><para>Pressione <guibutton>OK</guibutton>. Você verá o repositório que acabou de inserir na lista de repositórios. </para></step> + +<step><para>Se o método de acesso do repositório que você inseriu é autenticado por senha (pserver), você precisará logar-se antes de conectar ao servidor. Clique o repositório na lista para selecioná-lo, e pressione o botão <guilabel>Login...</guilabel>. Insira sua senha no diálogo que é exibido. </para> +<para>Se você inserir com sucesso sua senha, a entrada de coluna <guilabel>Estado</guilabel> do repositório pserver mudará de <guilabel>Não logado</guilabel> para <guilabel>Logado</guilabel>. </para></step> + +<step><para>Pressione <guibutton>OK</guibutton> para aplicar suas modificações, ou adicione outra localização à lista. O &cervisia; armazenará tantas localizações quanto desejar. </para></step> </procedure> @@ -411,376 +185,150 @@ <sect1 id="importing"> -<title ->Importando um Módulo Para o Repositório</title> +<title>Importando um Módulo Para o Repositório</title> -<para ->Nesta seção, nós discutiremos como você pode colocar um novo projeto em um repositório &CVS;. Se você apenas deseja trabalhar com um projeto existente que já está em um repositório, você pode pular esta seção. </para> +<para>Nesta seção, nós discutiremos como você pode colocar um novo projeto em um repositório &CVS;. Se você apenas deseja trabalhar com um projeto existente que já está em um repositório, você pode pular esta seção. </para> -<para ->Existem duas maneiras de colocar um projeto em um &CVS;: </para> +<para>Existem duas maneiras de colocar um projeto em um &CVS;: </para> <itemizedlist> -<listitem -><para ->Importar os arquivos e pastas para um novo <firstterm ->módulo</firstterm ->, usando o diálogo de importação do &cervisia;. Módulos são pastas de nível superior na árvore de pastas do repositório &CVS;, e são usados para separar e organizar os diferentes projetos de software dentre do repositório. </para -></listitem> +<listitem><para>Importar os arquivos e pastas para um novo <firstterm>módulo</firstterm>, usando o diálogo de importação do &cervisia;. Módulos são pastas de nível superior na árvore de pastas do repositório &CVS;, e são usados para separar e organizar os diferentes projetos de software dentre do repositório. </para></listitem> -<listitem -><para ->Criar um módulo vazio e adicionar os novos arquivos e pastas manualmente. Você terá mais controle, mas isto provavelmente demorará um pouco mais. </para -></listitem> +<listitem><para>Criar um módulo vazio e adicionar os novos arquivos e pastas manualmente. Você terá mais controle, mas isto provavelmente demorará um pouco mais. </para></listitem> </itemizedlist> <important> -<para ->Tenha em mente que o &CVS; foi inicialmente desenhado para manipular aquivos texto. Muitos recursos, como mesclagem de revisão, criação de diferenças em uma forma legível, &etc;... somente são executados em arquivos texto. Isto não significa que você não possa usar o CVS para manter arquivos binários, isto somente significa que você deve <emphasis ->dizer explicitamente ao CVS se isto é um arquivo texto ou binário</emphasis ->. Se você declarar um tipo de arquivo errado, você experimentará problemas com a funcionalidade do &CVS; nestes arquivos, e eles podem ser corrompidos. </para> +<para>Tenha em mente que o &CVS; foi inicialmente desenhado para manipular aquivos texto. Muitos recursos, como mesclagem de revisão, criação de diferenças em uma forma legível, &etc;... somente são executados em arquivos texto. Isto não significa que você não possa usar o CVS para manter arquivos binários, isto somente significa que você deve <emphasis>dizer explicitamente ao CVS se isto é um arquivo texto ou binário</emphasis>. Se você declarar um tipo de arquivo errado, você experimentará problemas com a funcionalidade do &CVS; nestes arquivos, e eles podem ser corrompidos. </para> </important> -<para ->Importar um projeto (como um novo módulo) tem algumas vantagens: você importará todos os arquivos e pastas recursivamente, e o módulo automaticamente será criado para você. Isto torna a importação de grandes projetos existentes para o repositório mais fácil. No entanto, existem algumas desvantagens: você não pode usar o diálogo de importação do &cervisia; para adicionar arquivos aos módulos existentes, e você pode tanto importar os arquivos como arquivos texto ou binário. Você pode trabalhar esta limitação criando uma pasta com arquivos de somente um dos tipos, ou informando padrões dos arquivos que devem ser ignorados durante o processo de importação. </para> +<para>Importar um projeto (como um novo módulo) tem algumas vantagens: você importará todos os arquivos e pastas recursivamente, e o módulo automaticamente será criado para você. Isto torna a importação de grandes projetos existentes para o repositório mais fácil. No entanto, existem algumas desvantagens: você não pode usar o diálogo de importação do &cervisia; para adicionar arquivos aos módulos existentes, e você pode tanto importar os arquivos como arquivos texto ou binário. Você pode trabalhar esta limitação criando uma pasta com arquivos de somente um dos tipos, ou informando padrões dos arquivos que devem ser ignorados durante o processo de importação. </para> -<para ->Por exemplo, suponhamos que seu projeto contenha somente arquivos texto e algumas imagens PNG (arquivos binários). Você pode dizer ao &CVS; para ignorar todos os arquivos com o padrão <filename class="extension" ->*.png</filename -> enquanto importa qualquer outro arquivo como texto, ou você pode mover as imagens para uma pasta separada, e então importar os arquivos remanescentes (como arquivos texto). De qualquer modo, você terá que <link linkend="checkingout" ->baixar</link -> o novo módulo importado para uma nova cópia de trabalho, copiar os arquivos e pastas que faltam para ele, <link linkend="addingfiles" ->adicionar</link -> e <link linkend="committingfiles" ->enviar</link -> estes arquivos e pastas para o repositório para completar o processo de importação. </para> +<para>Por exemplo, suponhamos que seu projeto contenha somente arquivos texto e algumas imagens PNG (arquivos binários). Você pode dizer ao &CVS; para ignorar todos os arquivos com o padrão <filename class="extension">*.png</filename> enquanto importa qualquer outro arquivo como texto, ou você pode mover as imagens para uma pasta separada, e então importar os arquivos remanescentes (como arquivos texto). De qualquer modo, você terá que <link linkend="checkingout">baixar</link> o novo módulo importado para uma nova cópia de trabalho, copiar os arquivos e pastas que faltam para ele, <link linkend="addingfiles">adicionar</link> e <link linkend="committingfiles">enviar</link> estes arquivos e pastas para o repositório para completar o processo de importação. </para> -<para ->Como alternativa, você pode adicionar os arquivos e pastas manualmente, criando um módulo vazio para eles. Para adicionar um módulo vazio ao repositório, simplesmente crie uma nova pasta na pasta raiz do repositório &CVS;. O nome desta nova pasta será o nome do módulo. <link linkend="checkingout" ->Baixe</link -> o novo módulo vazio. Então copie os arquivos e pastas para a cópia de trabalho, <link linkend="addingfiles" ->adicione</link -> e <link linkend="committingfiles" ->envie</link -> estes arquivos e pastas para o repositório &CVS;. </para> +<para>Como alternativa, você pode adicionar os arquivos e pastas manualmente, criando um módulo vazio para eles. Para adicionar um módulo vazio ao repositório, simplesmente crie uma nova pasta na pasta raiz do repositório &CVS;. O nome desta nova pasta será o nome do módulo. <link linkend="checkingout">Baixe</link> o novo módulo vazio. Então copie os arquivos e pastas para a cópia de trabalho, <link linkend="addingfiles">adicione</link> e <link linkend="committingfiles">envie</link> estes arquivos e pastas para o repositório &CVS;. </para> <figure id="screenshot-import" float="1"> -<title ->Uma captura de tela do diálogo de importação do &cervisia;</title> +<title>Uma captura de tela do diálogo de importação do &cervisia;</title> <mediaobject> -<imageobject -><imagedata format="PNG" fileref="import.png"/></imageobject> -<textobject -><phrase ->Uma captura de tela do diálogo de importação do &cervisia;</phrase -></textobject> +<imageobject><imagedata format="PNG" fileref="import.png"/></imageobject> +<textobject><phrase>Uma captura de tela do diálogo de importação do &cervisia;</phrase></textobject> </mediaobject> </figure> -<para ->Em <xref linkend="screenshot-import"/> você pode ver o diálogo que o auxilia a <emphasis ->importar</emphasis -> um projeto como um módulo. Para acessar o diálogo de importação do &cervisia;, selecione o ítem de menu <menuchoice -><guimenu ->Repositório</guimenu -> <guimenuitem ->Importar...</guimenuitem -></menuchoice ->. </para> +<para>Em <xref linkend="screenshot-import"/> você pode ver o diálogo que o auxilia a <emphasis>importar</emphasis> um projeto como um módulo. Para acessar o diálogo de importação do &cervisia;, selecione o ítem de menu <menuchoice><guimenu>Repositório</guimenu> <guimenuitem>Importar...</guimenuitem></menuchoice>. </para> <variablelist> <varlistentry> -<term -><guilabel ->Repositório:</guilabel -> <xref linkend="co-repository"/></term> -<listitem -><para ->Insira ou seleciona na lista de caixa combinada o nome do repositório &CVS;, também conhecido como $<envar ->CVSROOT</envar ->. Você deve ter acesso de escrita nele, e o repositório deve ser iniciado corretamente. Se o repositório ainda não existir, você pode criar um selecionando o ítem de menu <menuchoice -> <guimenu ->Repositório</guimenu -> <guimenuitem ->Criar...</guimenuitem -> </menuchoice ->. </para> -<para ->A caixa cobinada mostra uma lista de repositórios que você inseriu previamente na caixa de diálogo <guilabel ->Configurar Acesso aos Repositórios</guilabel ->.Se o repositório é remoto, certifique-se de que a autenticação funciona. Veja em <xref linkend="accessing-repository"/> para mais informações. </para -></listitem> +<term><guilabel>Repositório:</guilabel> <xref linkend="co-repository"/></term> +<listitem><para>Insira ou seleciona na lista de caixa combinada o nome do repositório &CVS;, também conhecido como $<envar>CVSROOT</envar>. Você deve ter acesso de escrita nele, e o repositório deve ser iniciado corretamente. Se o repositório ainda não existir, você pode criar um selecionando o ítem de menu <menuchoice> <guimenu>Repositório</guimenu> <guimenuitem>Criar...</guimenuitem> </menuchoice>. </para> +<para>A caixa cobinada mostra uma lista de repositórios que você inseriu previamente na caixa de diálogo <guilabel>Configurar Acesso aos Repositórios</guilabel>.Se o repositório é remoto, certifique-se de que a autenticação funciona. Veja em <xref linkend="accessing-repository"/> para mais informações. </para></listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Módulo:</guilabel -> <xref linkend="co-module"/></term> -<listitem -><para ->O nome do módulo sob o qual o projeto será armazenado. Após a importação, o projeto pode ser verificado sob este nome. Veja <xref linkend="checkingout"/> para mais informações. Isto é também o nome da pasta correspondente no repositório. </para -></listitem> +<term><guilabel>Módulo:</guilabel> <xref linkend="co-module"/></term> +<listitem><para>O nome do módulo sob o qual o projeto será armazenado. Após a importação, o projeto pode ser verificado sob este nome. Veja <xref linkend="checkingout"/> para mais informações. Isto é também o nome da pasta correspondente no repositório. </para></listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Pasta de Trabalho:</guilabel -></term> -<listitem -><para ->Este é a pasta de nível superior do projeto que você deseja importar. A importação inicia a partir desta pasta e vai descendo recursivamente. </para -></listitem> +<term><guilabel>Pasta de Trabalho:</guilabel></term> +<listitem><para>Este é a pasta de nível superior do projeto que você deseja importar. A importação inicia a partir desta pasta e vai descendo recursivamente. </para></listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Tag do vendedor:</guilabel -> <xref linkend="co-vendortag"/></term> -<listitem -><para ->A tag do vendedor é historicamente usada para pesquisar por código de outros grupos. Apenas use seu nome de usuário se não tiver melhor idéias. Não faz muita diferença o que você insere aqui. </para -></listitem> +<term><guilabel>Tag do vendedor:</guilabel> <xref linkend="co-vendortag"/></term> +<listitem><para>A tag do vendedor é historicamente usada para pesquisar por código de outros grupos. Apenas use seu nome de usuário se não tiver melhor idéias. Não faz muita diferença o que você insere aqui. </para></listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Tag da versão:</guilabel -> <xref linkend="co-releasetag"/></term> -<listitem -><para ->Esta tag é também historicamente usada para importar diferentes versões de softwares de outros grupos. Se você não está fazendo isto, usa a palavra <literal ->start</literal -> ou um string <literal ->FOO_1_0</literal -> onde <literal ->FOO</literal -> é o nome do seu projeto e <literal ->1.0</literal -> é o número de versão do módulo importado. </para -></listitem> +<term><guilabel>Tag da versão:</guilabel> <xref linkend="co-releasetag"/></term> +<listitem><para>Esta tag é também historicamente usada para importar diferentes versões de softwares de outros grupos. Se você não está fazendo isto, usa a palavra <literal>start</literal> ou um string <literal>FOO_1_0</literal> onde <literal>FOO</literal> é o nome do seu projeto e <literal>1.0</literal> é o número de versão do módulo importado. </para></listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Ignorar arquivos:</guilabel -></term> -<listitem -><para ->Se você preencher este campo, uma opção adicional <option ->-I <replaceable ->nomes de arquivo</replaceable -></option -> é fornecida para o comando <command ->cvs import</command ->. Esta entrada é interpretada como uma lista separada por espaços em branco de padrões de nomes de arquivo que serão ignorados. Em geral, uma maneira limpa e menos suscetível a erros de controlar quais arquivos irão para o repositório é criar uma pasta somente com os arquivos que você deseja importar e iniciar a partir dela. No entanto, esta entrada pode ser útil se o projeto contém arquivos que serão ignorados por padrão pelo &CVS;, ⪚ arquivos com o nome <filename ->core</filename ->. Neste caso, simplesmente insira o caracter <literal ->!</literal -> neste campo. Isto sobrepõe-se as regras de esquema do &CVS; de arquivos ignorados, veja <xref linkend="ignoredfiles"/>. </para -></listitem> +<term><guilabel>Ignorar arquivos:</guilabel></term> +<listitem><para>Se você preencher este campo, uma opção adicional <option>-I <replaceable>nomes de arquivo</replaceable></option> é fornecida para o comando <command>cvs import</command>. Esta entrada é interpretada como uma lista separada por espaços em branco de padrões de nomes de arquivo que serão ignorados. Em geral, uma maneira limpa e menos suscetível a erros de controlar quais arquivos irão para o repositório é criar uma pasta somente com os arquivos que você deseja importar e iniciar a partir dela. No entanto, esta entrada pode ser útil se o projeto contém arquivos que serão ignorados por padrão pelo &CVS;, ⪚ arquivos com o nome <filename>core</filename>. Neste caso, simplesmente insira o caracter <literal>!</literal> neste campo. Isto sobrepõe-se as regras de esquema do &CVS; de arquivos ignorados, veja <xref linkend="ignoredfiles"/>. </para></listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Comentário:</guilabel -> <xref linkend="co-comment"/></term> -<listitem -><para ->Use este campo para gravar os comentários que você deseja fazer sobre o origem, usuário, desenvolvimento, &etc;, dos arquivos que você está importando. </para -></listitem> +<term><guilabel>Comentário:</guilabel> <xref linkend="co-comment"/></term> +<listitem><para>Use este campo para gravar os comentários que você deseja fazer sobre o origem, usuário, desenvolvimento, &etc;, dos arquivos que você está importando. </para></listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Importar como binários</guilabel -></term> -<listitem -><para ->Se você habilitar esta caixa, todos os arquivos serão importados no modo binário, por ex. um argumento <option ->-kb</option -> é fornecido ao <command ->cvs import</command ->. </para -></listitem> +<term><guilabel>Importar como binários</guilabel></term> +<listitem><para>Se você habilitar esta caixa, todos os arquivos serão importados no modo binário, por ex. um argumento <option>-kb</option> é fornecido ao <command>cvs import</command>. </para></listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Usar a modificação do arquivo como hora de importação</guilabel -></term> -<listitem -><para ->Se você habilitar esta caixa, a hora de importação será a hora de modificação do arquivo ao invés da hora de importação. </para -></listitem> +<term><guilabel>Usar a modificação do arquivo como hora de importação</guilabel></term> +<listitem><para>Se você habilitar esta caixa, a hora de importação será a hora de modificação do arquivo ao invés da hora de importação. </para></listitem> </varlistentry> </variablelist> -<para ->Após você ter preenchido este formulário e confirmado pressionando <guibutton ->OK</guibutton ->, o seguinte comando &CVS; é enviado:</para> - -<screen -><command ->cvs</command -> -d <co id="co-repository" -></co -><replaceable ->repositório</replaceable -> import -m "<co id="co-comment" -></co ->" <co id="co-module" -></co -><replaceable ->módulo</replaceable -> <co id="co-vendortag" -></co -><replaceable ->tagvendedor</replaceable -> <co id="co-releasetag" -></co -><replaceable ->tagversão</replaceable -></screen> +<para>Após você ter preenchido este formulário e confirmado pressionando <guibutton>OK</guibutton>, o seguinte comando &CVS; é enviado:</para> + +<screen><command>cvs</command> -d <co id="co-repository"></co><replaceable>repositório</replaceable> import -m "<co id="co-comment"></co>" <co id="co-module"></co><replaceable>módulo</replaceable> <co id="co-vendortag"></co><replaceable>tagvendedor</replaceable> <co id="co-releasetag"></co><replaceable>tagversão</replaceable></screen> </sect1> <sect1 id="checkingout"> -<title ->Baixar um Módulo do Repositório</title> -<para ->Agora que você definiu com sucesso sua localização do repositório, e importou os arquivos iniciais para o repositório, é hora de obter o módulo do repositório &CVS;, criando sua cópia de trabalho. </para> +<title>Baixar um Módulo do Repositório</title> +<para>Agora que você definiu com sucesso sua localização do repositório, e importou os arquivos iniciais para o repositório, é hora de obter o módulo do repositório &CVS;, criando sua cópia de trabalho. </para> -<para ->Você deve também saber o nome da <firstterm ->ramificação</firstterm -> ou <firstterm ->tag</firstterm -> que deseja usar. </para> +<para>Você deve também saber o nome da <firstterm>ramificação</firstterm> ou <firstterm>tag</firstterm> que deseja usar. </para> -<para ->Ramificações de um módulo são versões paralelas deste módulo. Um bom exemplo prático do uso deste recurso é o lançamento de um projeto de software. Após uma versão principal, existem erros no código que devem ser concertados, mas as pessoas desejam adicionar novos recursos ao aplicativo também. É muito difícil fazer as duas coisas ao mesmo tempo porque novos recursos normalmente introduzem novos erros, tornando difícil rastrear os antigos. Para resolver este dilema, o &CVS; permite que você crie uma versão paralela, que nós chamaremos de "ramificação da versão estável", onde você pode somente adicionar correções de erro, deixando a ramificação principal (HEAD) aberta para adição de novos recursos. </para> +<para>Ramificações de um módulo são versões paralelas deste módulo. Um bom exemplo prático do uso deste recurso é o lançamento de um projeto de software. Após uma versão principal, existem erros no código que devem ser concertados, mas as pessoas desejam adicionar novos recursos ao aplicativo também. É muito difícil fazer as duas coisas ao mesmo tempo porque novos recursos normalmente introduzem novos erros, tornando difícil rastrear os antigos. Para resolver este dilema, o &CVS; permite que você crie uma versão paralela, que nós chamaremos de "ramificação da versão estável", onde você pode somente adicionar correções de erro, deixando a ramificação principal (HEAD) aberta para adição de novos recursos. </para> -<para ->Tags são usadas para marcar uma versão do projeto. O &CVS; estampa uma versão de cada arquivo com a tag, de modo que quando você baixa ou atualiza para uma tag específica, você obterá as mesmas versões de arquivo. No entanto, ao contrário das ramificações, tags não são dinâmicas: você não pode desenvolver uma tag. Tags são úteis para marcar versões, grandes mudanças no código, &etc;. Usando tags, você pode facilmente retornar o projeto a um estado anterior, para reproduzir e rastrear erros, gerar o código de lançamento novamente, &etc;. </para> +<para>Tags são usadas para marcar uma versão do projeto. O &CVS; estampa uma versão de cada arquivo com a tag, de modo que quando você baixa ou atualiza para uma tag específica, você obterá as mesmas versões de arquivo. No entanto, ao contrário das ramificações, tags não são dinâmicas: você não pode desenvolver uma tag. Tags são úteis para marcar versões, grandes mudanças no código, &etc;. Usando tags, você pode facilmente retornar o projeto a um estado anterior, para reproduzir e rastrear erros, gerar o código de lançamento novamente, &etc;. </para> <figure id="screenshot-checkout" float="1"> -<title ->Uma captura de tela do diálogo de verificar do &cervisia;</title> +<title>Uma captura de tela do diálogo de verificar do &cervisia;</title> <mediaobject> -<imageobject -><imagedata format="PNG" fileref="checkout.png"/></imageobject> -<textobject -><phrase ->Uma captura de tela do diálogo de verificar do &cervisia;</phrase -></textobject> +<imageobject><imagedata format="PNG" fileref="checkout.png"/></imageobject> +<textobject><phrase>Uma captura de tela do diálogo de verificar do &cervisia;</phrase></textobject> </mediaobject> </figure> <variablelist> <varlistentry> -<term -><guilabel ->Repositório:</guilabel -></term> -<listitem -><para ->O nome do repositório &CVS;, também conhecido como <filename -><envar ->$CVSROOT</envar -></filename ->. A caixa combinada mostra uma lista dos repositórios que você inseriu previamente usando a caixa de diálogo <guilabel ->Configurar Acesso aos Repositórios</guilabel ->. Se o repositório é remoto, certifique-se de que a autenticação funciona. Veja <xref linkend="accessing-repository"/> para mais informações. </para -></listitem> +<term><guilabel>Repositório:</guilabel></term> +<listitem><para>O nome do repositório &CVS;, também conhecido como <filename><envar>$CVSROOT</envar></filename>. A caixa combinada mostra uma lista dos repositórios que você inseriu previamente usando a caixa de diálogo <guilabel>Configurar Acesso aos Repositórios</guilabel>. Se o repositório é remoto, certifique-se de que a autenticação funciona. Veja <xref linkend="accessing-repository"/> para mais informações. </para></listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Módulo:</guilabel -></term> -<listitem -><para ->O nome do módulo a ser baixado. Se você estiver trabalhando com um repositório existente, você provavelmente poderá obter este nome a partir do administrador do sistema, ou se ele é um repositório de código aberto, você pode obter os nomes dos módulos a partir das páginas web do projeto. Se você deseja criar um novo módulo a partir do zero usando um repositório local, simplesmente crie uma nova pasta na pasta raiz do repositório local. O nome da pasta será o mesmo do módulo vazio. </para> -<para ->Alternativamente, se o repositório possui um arquivo <filename -><envar ->$CVSROOT</envar ->/modules</filename ->, você pode obter uma lista dos módulos disponíveis clicando no botão <guibutton ->Obter lista</guibutton ->. </para> -<para ->Observe que é possível baixar qualquer subpasta existente do módulo, sem obter o resto do módulo. Simplesmente insira o caminho para a subpasta. Por exemplo, se você deseja obter somente a subpasta <filename class="directory" ->doc/cervisia</filename -> do módulo tdesdk, insira <filename class="directory" ->tdesdk/doc/cervisia</filename -> neste campo. </para -></listitem> +<term><guilabel>Módulo:</guilabel></term> +<listitem><para>O nome do módulo a ser baixado. Se você estiver trabalhando com um repositório existente, você provavelmente poderá obter este nome a partir do administrador do sistema, ou se ele é um repositório de código aberto, você pode obter os nomes dos módulos a partir das páginas web do projeto. Se você deseja criar um novo módulo a partir do zero usando um repositório local, simplesmente crie uma nova pasta na pasta raiz do repositório local. O nome da pasta será o mesmo do módulo vazio. </para> +<para>Alternativamente, se o repositório possui um arquivo <filename><envar>$CVSROOT</envar>/modules</filename>, você pode obter uma lista dos módulos disponíveis clicando no botão <guibutton>Obter lista</guibutton>. </para> +<para>Observe que é possível baixar qualquer subpasta existente do módulo, sem obter o resto do módulo. Simplesmente insira o caminho para a subpasta. Por exemplo, se você deseja obter somente a subpasta <filename class="directory">doc/cervisia</filename> do módulo tdesdk, insira <filename class="directory">tdesdk/doc/cervisia</filename> neste campo. </para></listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Ramificação/tag:</guilabel -></term> -<listitem -><para ->O nome da ramificação ou tag que você deseja baixar. Se você deixar este campo vazio, o &cervisia; obterá a ramificação principal (HEAD). </para -></listitem> +<term><guilabel>Ramificação/tag:</guilabel></term> +<listitem><para>O nome da ramificação ou tag que você deseja baixar. Se você deixar este campo vazio, o &cervisia; obterá a ramificação principal (HEAD). </para></listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Pasta de trabalho:</guilabel -></term> -<listitem -><para ->A pasta na qual o módulo deve ser baixado. Observe que a pasta de nível superior da cópia de trabalho é nomeada após o módulo que você está obtendo, a menos que você forneça um nome alternativo no campo <guilabel ->Baixar como:</guilabel ->. </para -></listitem> +<term><guilabel>Pasta de trabalho:</guilabel></term> +<listitem><para>A pasta na qual o módulo deve ser baixado. Observe que a pasta de nível superior da cópia de trabalho é nomeada após o módulo que você está obtendo, a menos que você forneça um nome alternativo no campo <guilabel>Baixar como:</guilabel>. </para></listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Baixar como:</guilabel -></term> -<listitem -><para ->Isto faz com que os arquivos da cópia de trabalho sejam baixados em uma pasta alternativa dentro da pasta de trabalho ao invés de usar a pasta com o nome do módulo. </para -></listitem> +<term><guilabel>Baixar como:</guilabel></term> +<listitem><para>Isto faz com que os arquivos da cópia de trabalho sejam baixados em uma pasta alternativa dentro da pasta de trabalho ao invés de usar a pasta com o nome do módulo. </para></listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Exportar somente</guilabel -></term> -<listitem -><para ->Se habilitar esta caixa, os arquivos serão exportados ao invés de atualizados. Exportar obtém uma cópia do código para o módulo sem as pastas administrativas do CVS. Por exemplo, exportar pode ser usado para preparar o código fonte para lançamento. </para -></listitem> +<term><guilabel>Exportar somente</guilabel></term> +<listitem><para>Se habilitar esta caixa, os arquivos serão exportados ao invés de atualizados. Exportar obtém uma cópia do código para o módulo sem as pastas administrativas do CVS. Por exemplo, exportar pode ser usado para preparar o código fonte para lançamento. </para></listitem> </varlistentry> </variablelist> @@ -789,238 +337,96 @@ <sect1 id="mainscreen"> -<title ->A Tela Principal, Visão do Estado do Arquivo e Atualização</title> -<para ->Quando você inicia o &cervisia; e abre uma cópia de trabalho selecionando <menuchoice -> <guimenu ->Arquivo</guimenu -> <guimenuitem ->Abrir Área Local...</guimenuitem -> </menuchoice -> você pode ver duas áreas principais na janela principal do &cervisia;: a superior é uma visão hierárquica (em árvore) da cópia de trabalho atual, e a inferior é usada para exibir os comandos &CVS; que o &cervisia; envia para realizar suas tarefas, bem como a saída gerada por estes comandos. </para> - -<para ->Por padrão o &cervisia; não exibe os arquivos contidos nas subpastas, de modo que você terá que clicar nas pastas se desejar vê-los. Para exibir todos os arquivos da cópia de trabalho, selecione <menuchoice -> <guimenu ->Ver</guimenu -> <guimenuitem ->Expandir a Árvore de Arquivos</guimenuitem -> </menuchoice ->. Para fechar todas as pastas de sua cópia de trabalho, selecione <menuchoice -> <guimenu ->Ver</guimenu -> <guimenuitem ->Recolher a Árvore de Arquivos</guimenuitem -> </menuchoice ->. </para> - -<para ->De acordo com as configurações de seu arquivo <filename ->.cvsignore</filename ->, os arquivos que você normalmente não quer incluir no repositório - como por exemplo arquivos de objeto - não são exibidos na visão em árvore. Para cada arquivo, você vê seu estado correspondente. Na configuração padrão, após abrir uma área local, ele é "Desconhecido" porque o &cervisia; aguarda para atualizar as informações até você selecionar os arquivos e pastas que deseja ver o estado ou atualizar e selecionar <menuchoice -> <guimenu ->Arquivo</guimenu -> <guimenuitem ->Atualizar</guimenuitem -> </menuchoice -> ou <menuchoice -> <guimenu ->Arquivo</guimenu -> <guimenuitem ->Estado</guimenuitem -> </menuchoice ->. Com este comportamento, você tem um mínimo de funcionalidade disponível caso você não tenha uma conexão permanente com o servidor &CVS;. </para> +<title>A Tela Principal, Visão do Estado do Arquivo e Atualização</title> +<para>Quando você inicia o &cervisia; e abre uma cópia de trabalho selecionando <menuchoice> <guimenu>Arquivo</guimenu> <guimenuitem>Abrir Área Local...</guimenuitem> </menuchoice> você pode ver duas áreas principais na janela principal do &cervisia;: a superior é uma visão hierárquica (em árvore) da cópia de trabalho atual, e a inferior é usada para exibir os comandos &CVS; que o &cervisia; envia para realizar suas tarefas, bem como a saída gerada por estes comandos. </para> + +<para>Por padrão o &cervisia; não exibe os arquivos contidos nas subpastas, de modo que você terá que clicar nas pastas se desejar vê-los. Para exibir todos os arquivos da cópia de trabalho, selecione <menuchoice> <guimenu>Ver</guimenu> <guimenuitem>Expandir a Árvore de Arquivos</guimenuitem> </menuchoice>. Para fechar todas as pastas de sua cópia de trabalho, selecione <menuchoice> <guimenu>Ver</guimenu> <guimenuitem>Recolher a Árvore de Arquivos</guimenuitem> </menuchoice>. </para> + +<para>De acordo com as configurações de seu arquivo <filename>.cvsignore</filename>, os arquivos que você normalmente não quer incluir no repositório - como por exemplo arquivos de objeto - não são exibidos na visão em árvore. Para cada arquivo, você vê seu estado correspondente. Na configuração padrão, após abrir uma área local, ele é "Desconhecido" porque o &cervisia; aguarda para atualizar as informações até você selecionar os arquivos e pastas que deseja ver o estado ou atualizar e selecionar <menuchoice> <guimenu>Arquivo</guimenu> <guimenuitem>Atualizar</guimenuitem> </menuchoice> ou <menuchoice> <guimenu>Arquivo</guimenu> <guimenuitem>Estado</guimenuitem> </menuchoice>. Com este comportamento, você tem um mínimo de funcionalidade disponível caso você não tenha uma conexão permanente com o servidor &CVS;. </para> <figure id="screenshot-mainview" float="1"> -<title ->Um captura de tela da janela principal do &cervisia;</title> +<title>Um captura de tela da janela principal do &cervisia;</title> <mediaobject> -<imageobject -><imagedata format="PNG" fileref="mainview.png"/></imageobject> -<textobject -><phrase ->Um captura de tela da janela principal do &cervisia;</phrase -></textobject> +<imageobject><imagedata format="PNG" fileref="mainview.png"/></imageobject> +<textobject><phrase>Um captura de tela da janela principal do &cervisia;</phrase></textobject> </mediaobject> </figure> -<para ->Os comandos no menu Arquivo normalmente agem somente nos arquivos que você tenha marcado. Você pode também marcar pastas. Agora escolha <menuchoice -><guimenu ->Arquivo</guimenu -> <guimenuitem ->Estado</guimenuitem -></menuchoice -> ou pressione <keycap ->F5</keycap ->. O &cervisia; envia um comando </para> +<para>Os comandos no menu Arquivo normalmente agem somente nos arquivos que você tenha marcado. Você pode também marcar pastas. Agora escolha <menuchoice><guimenu>Arquivo</guimenu> <guimenuitem>Estado</guimenuitem></menuchoice> ou pressione <keycap>F5</keycap>. O &cervisia; envia um comando </para> <para> -<screen -><command ->cvs update -n <replaceable ->nomes dos arquivos</replaceable -></command -></screen> +<screen><command>cvs update -n <replaceable>nomes dos arquivos</replaceable></command></screen> </para> -<para ->para obter informações de estado dos arquivos marcados. Observe que o &cervisia; age recursivamente nas subpastas somente se você tiver configurado esta opção no menu <guimenu ->Configurações</guimenu ->. De acordo com o respectivo estado do arquivo, você agora pode ver uma entrada na coluna <guilabel ->Estado</guilabel ->: </para> +<para>para obter informações de estado dos arquivos marcados. Observe que o &cervisia; age recursivamente nas subpastas somente se você tiver configurado esta opção no menu <guimenu>Configurações</guimenu>. De acordo com o respectivo estado do arquivo, você agora pode ver uma entrada na coluna <guilabel>Estado</guilabel>: </para> <variablelist> <varlistentry> -<term -><guilabel ->Modificado Localmente</guilabel -></term> -<listitem -><para ->Isto significa que você tem o arquivo modificado comparado com a versão do repositório. </para -></listitem> +<term><guilabel>Modificado Localmente</guilabel></term> +<listitem><para>Isto significa que você tem o arquivo modificado comparado com a versão do repositório. </para></listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Adicionado Localmente</guilabel -></term> -<listitem -><para ->Isto significa que o arquivo não existe no repositório, mas em sua cópia de trabalho e você deve agendá-lo para adição. A inserção atual no repositório somente acontecerá após um envio. </para -></listitem> +<term><guilabel>Adicionado Localmente</guilabel></term> +<listitem><para>Isto significa que o arquivo não existe no repositório, mas em sua cópia de trabalho e você deve agendá-lo para adição. A inserção atual no repositório somente acontecerá após um envio. </para></listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Removido Localmente</guilabel -></term> -<listitem -><para ->Isto significa que você tem agendado o arquivo para remoção, mas ele ainda existe no repositório. A remoção atual acontecerá somente após um envio. </para -></listitem> +<term><guilabel>Removido Localmente</guilabel></term> +<listitem><para>Isto significa que você tem agendado o arquivo para remoção, mas ele ainda existe no repositório. A remoção atual acontecerá somente após um envio. </para></listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Precisa de Atualização</guilabel -></term> -<listitem -><para ->Isto é mostrado se uma nova versão do arquivo existe no repositório, por exemplo porque alguém enviou uma modificação. Normalmente, você desejará atualizar este arquivo para que não tenha uma versão desatualizada em sua pasta. </para -></listitem> +<term><guilabel>Precisa de Atualização</guilabel></term> +<listitem><para>Isto é mostrado se uma nova versão do arquivo existe no repositório, por exemplo porque alguém enviou uma modificação. Normalmente, você desejará atualizar este arquivo para que não tenha uma versão desatualizada em sua pasta. </para></listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Precisa de Remendo</guilabel -></term> -<listitem -><para ->Isto é essencialmente o mesmo que o anterior; a diferença é que no caso de uma atualização, o servidor &CVS; transferirá somente um remendo ao invés de todo o arquivo para você. </para -></listitem> +<term><guilabel>Precisa de Remendo</guilabel></term> +<listitem><para>Isto é essencialmente o mesmo que o anterior; a diferença é que no caso de uma atualização, o servidor &CVS; transferirá somente um remendo ao invés de todo o arquivo para você. </para></listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Precisa Mesclar</guilabel -></term> -<listitem -><para ->Indica que uma mesclagem da revisão deste arquivo na sua cópia de trabalho com a versão no repositório é necessária. Isto tipicamente acontece caso você tenha feito modificações no arquivo enquanto alguém já tenha enviado suas próprias modificações. Se você escolher atualizar, as modificações no repositório serão mescladas em seu arquivo. No caso de conflito (por exemplo se alguém também modificou as mesmas linhas que você) o novo estado será então "Conflito". </para -></listitem> +<term><guilabel>Precisa Mesclar</guilabel></term> +<listitem><para>Indica que uma mesclagem da revisão deste arquivo na sua cópia de trabalho com a versão no repositório é necessária. Isto tipicamente acontece caso você tenha feito modificações no arquivo enquanto alguém já tenha enviado suas próprias modificações. Se você escolher atualizar, as modificações no repositório serão mescladas em seu arquivo. No caso de conflito (por exemplo se alguém também modificou as mesmas linhas que você) o novo estado será então "Conflito". </para></listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Atualizado</guilabel -></term> -<listitem -><para ->Indica que o arquivo é idêntico à versão do repositório. </para -></listitem> +<term><guilabel>Atualizado</guilabel></term> +<listitem><para>Indica que o arquivo é idêntico à versão do repositório. </para></listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Conflito</guilabel -></term> -<listitem -><para ->Isto é mostrado se o arquivo ainda possui conflitos marcados nele. Talvez você tenha previamente atualizado o arquivo e não resolvido os conflitos. </para -></listitem> +<term><guilabel>Conflito</guilabel></term> +<listitem><para>Isto é mostrado se o arquivo ainda possui conflitos marcados nele. Talvez você tenha previamente atualizado o arquivo e não resolvido os conflitos. </para></listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Não no CVS</guilabel -></term> -<listitem -><para ->Indica que o arquivo não está registrado no repositório &CVS;. Se você deseja torná-lo disponível para outros, você deve adicioná-lo ao repositório. Caso contrário, você deve considerar a adição dele ao seu arquivo <filename ->.cvsignore</filename ->. </para -></listitem> +<term><guilabel>Não no CVS</guilabel></term> +<listitem><para>Indica que o arquivo não está registrado no repositório &CVS;. Se você deseja torná-lo disponível para outros, você deve adicioná-lo ao repositório. Caso contrário, você deve considerar a adição dele ao seu arquivo <filename>.cvsignore</filename>. </para></listitem> </varlistentry> </variablelist> -<para ->Agora que você possui uma visão geral do estado atual do CVS, você pode querer realizar uma atualização. Marque alguns arquivos (ou a raiz da árvore de pastas o que é equivalente a marcar todos os arquivos nesta pasta). Agora escolha <menuchoice -><guimenu ->Arquivo</guimenu -> <guimenuitem ->Atualizar</guimenuitem -> </menuchoice -> (É claro, você pode já ter selecionado isto no início desta sessão). Para a maioria dos arquivos o estado deve mudar agora. Tipicamente, arquivos que "Precisam de Remendo" ou "Precisam Atualizar" serão atualizados. Logo os seguintes novos ítens são possíveis na coluna de estado: </para> +<para>Agora que você possui uma visão geral do estado atual do CVS, você pode querer realizar uma atualização. Marque alguns arquivos (ou a raiz da árvore de pastas o que é equivalente a marcar todos os arquivos nesta pasta). Agora escolha <menuchoice><guimenu>Arquivo</guimenu> <guimenuitem>Atualizar</guimenuitem> </menuchoice> (É claro, você pode já ter selecionado isto no início desta sessão). Para a maioria dos arquivos o estado deve mudar agora. Tipicamente, arquivos que "Precisam de Remendo" ou "Precisam Atualizar" serão atualizados. Logo os seguintes novos ítens são possíveis na coluna de estado: </para> <variablelist> <varlistentry> -<term -><guilabel ->Atualizado</guilabel -></term> -<listitem -><para ->Mostra se o arquivo foi atualizado a partir do repositório. </para -></listitem> +<term><guilabel>Atualizado</guilabel></term> +<listitem><para>Mostra se o arquivo foi atualizado a partir do repositório. </para></listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Remendado</guilabel -></term> -<listitem -><para ->Indica que o servidor &CVS; enviou um remendo para este arquivo e o remendo foi aplicado com sucesso. Se o remendo não foi aplicado com sucesso devido a um conflito entre suas modificações e as de alguém que já havia enviado para o repositório, o estado agora é<guilabel ->Conflito</guilabel ->. </para -></listitem> +<term><guilabel>Remendado</guilabel></term> +<listitem><para>Indica que o servidor &CVS; enviou um remendo para este arquivo e o remendo foi aplicado com sucesso. Se o remendo não foi aplicado com sucesso devido a um conflito entre suas modificações e as de alguém que já havia enviado para o repositório, o estado agora é<guilabel>Conflito</guilabel>. </para></listitem> </varlistentry> </variablelist> -<para ->Você deve ter observado que de acordo com o estado do arquivo, sua linha possui uma cor diferente. As cores são escolhidas de modo a refletir a prioridade do estado. Por exemplo, um arquivo com um conflito é marcado em vermelho para mostrar-lhe que deve resolver o conflito antes de continuar o trabalho com o arquivo. Se sua pasta contém um grande número de arquivos, você pode apesar disso perder da visão geral. Para obter informações mais concisas sobre quais arquivos possuem um estado incomum, simplesmente clique no cabeçalho da coluna <guilabel ->Estado</guilabel ->. A lista de arquivos é então ordenada por prioridade, de modo que você tenha todas informações importantes na parte superior da lista. Para retornar à visão ordenada alfabeticamente, clique no cabeçalho da coluna <guilabel ->Nome do arquivo</guilabel ->. </para> +<para>Você deve ter observado que de acordo com o estado do arquivo, sua linha possui uma cor diferente. As cores são escolhidas de modo a refletir a prioridade do estado. Por exemplo, um arquivo com um conflito é marcado em vermelho para mostrar-lhe que deve resolver o conflito antes de continuar o trabalho com o arquivo. Se sua pasta contém um grande número de arquivos, você pode apesar disso perder da visão geral. Para obter informações mais concisas sobre quais arquivos possuem um estado incomum, simplesmente clique no cabeçalho da coluna <guilabel>Estado</guilabel>. A lista de arquivos é então ordenada por prioridade, de modo que você tenha todas informações importantes na parte superior da lista. Para retornar à visão ordenada alfabeticamente, clique no cabeçalho da coluna <guilabel>Nome do arquivo</guilabel>. </para> </sect1> @@ -1028,402 +434,156 @@ <chapter id="workingwithfiles"> -<title ->Trabalhando Com Arquivos</title> - -<para ->Todas as funcionalidades normalmente usadas no &CVS; estão diretamente disponíveis na janela principal do &cervisia;. Comandos usualmente agem em diversos arquivos ao mesmo tempo, atingindo todos que estão selecionados atualmente. Se a seleção inclui pastas, esta interpretação depende das configurações feitas no menu <guimenu ->Configurações</guimenu ->. Por exemplo, se <menuchoice -><guimenu ->Configurações</guimenu -><guimenuitem ->Enviar e Remover Recursivamente</guimenuitem -></menuchoice -> estiver habilitado e você escolher <menuchoice -><guimenu ->Arquivo</guimenu -><guimenuitem ->Enviar...</guimenuitem -></menuchoice -> quando uma pasta estiver selecionada, então todos os arquivos na árvore sob esta pasta são atualizados. Caso contrário, somente os arquivos regulares na pasta serão afetados. </para> +<title>Trabalhando Com Arquivos</title> + +<para>Todas as funcionalidades normalmente usadas no &CVS; estão diretamente disponíveis na janela principal do &cervisia;. Comandos usualmente agem em diversos arquivos ao mesmo tempo, atingindo todos que estão selecionados atualmente. Se a seleção inclui pastas, esta interpretação depende das configurações feitas no menu <guimenu>Configurações</guimenu>. Por exemplo, se <menuchoice><guimenu>Configurações</guimenu><guimenuitem>Enviar e Remover Recursivamente</guimenuitem></menuchoice> estiver habilitado e você escolher <menuchoice><guimenu>Arquivo</guimenu><guimenuitem>Enviar...</guimenuitem></menuchoice> quando uma pasta estiver selecionada, então todos os arquivos na árvore sob esta pasta são atualizados. Caso contrário, somente os arquivos regulares na pasta serão afetados. </para> <figure id="screenshot-popup" float="1"> -<title ->Uma captura de tela do menu de contexto do &cervisia;</title> +<title>Uma captura de tela do menu de contexto do &cervisia;</title> <mediaobject> -<imageobject -><imagedata format="PNG" fileref="popup.png"/></imageobject> +<imageobject><imagedata format="PNG" fileref="popup.png"/></imageobject> </mediaobject> </figure> -<para ->A maioria das ações estão também disponíveis com um clique direito sobre os arquivos na visão em árvore, através do menu de contexto. <xref linkend="screenshot-popup"/> mostra o menu de contexo na janela principal do &cervisia;. </para> +<para>A maioria das ações estão também disponíveis com um clique direito sobre os arquivos na visão em árvore, através do menu de contexto. <xref linkend="screenshot-popup"/> mostra o menu de contexo na janela principal do &cervisia;. </para> -<para ->Você pode simplesmente editar um arquivo com um duplo-clique sobre ele ou selecionando-o e pressionando &Enter;. Isto inicia o aplicativo padrão que manipula aquele tipo de arquivo (o aplicativo padrão para cada tipo de arquivo é uma configuração geral do KDE). Se o aplicativo padrão não é o que você deseja usar, você pode dar um clique-direito sobre o arquivo e selecionar o submenu <menuchoice -> <guisubmenu ->Editar Com</guisubmenu -> </menuchoice ->, e selecionar um dos outros aplicativos que manipulam aquele tipo de arquivo. </para> +<para>Você pode simplesmente editar um arquivo com um duplo-clique sobre ele ou selecionando-o e pressionando &Enter;. Isto inicia o aplicativo padrão que manipula aquele tipo de arquivo (o aplicativo padrão para cada tipo de arquivo é uma configuração geral do KDE). Se o aplicativo padrão não é o que você deseja usar, você pode dar um clique-direito sobre o arquivo e selecionar o submenu <menuchoice> <guisubmenu>Editar Com</guisubmenu> </menuchoice>, e selecionar um dos outros aplicativos que manipulam aquele tipo de arquivo. </para> <sect1 id="addingfiles"> -<title ->Adicionando Arquivos</title> - -<para ->Para adicionar arquivos ao projeto são necessários dois passos: Primeiro, os arquivos devem ser registrados no &CVS;, ou em outras palavras, <emphasis ->adicionados ao repositório</emphasis ->. Isto é necessário, mas não o suficiente. Para colocar os arquivos no repositório, você deve também realizar um <emphasis ->envio</emphasis ->. Este procedimento tem uma importante vantagem. Você pode realizar um envio dos arquivos junto com modificações de outras partes do projeto. Quando fizer isto, você pode facilmente ver (⪚ nas mensagens de envio) que todas as mudanças são parte de um todo. </para> - -<para ->Para este fim, marque todos os arquivos a serem adicionados na janela principal do &cervisia;. Então, selecione <menuchoice -><guimenu ->Arquivo</guimenu -><guimenuitem ->Adicionar ao Repositório...</guimenuitem -></menuchoice ->, ou clique-direito nos arquivos marcados e selecione <guimenuitem ->Adicionar ao Repositório...</guimenuitem ->. O diálogo <guilabel ->Adicionar ao CVS</guilabel -> aparecerá, listando os arquivos que você marcou, e pedindo uma confirmação. Pressione <guibutton ->OK</guibutton ->. </para> - -<para ->O &cervisia; envia um comando</para> +<title>Adicionando Arquivos</title> + +<para>Para adicionar arquivos ao projeto são necessários dois passos: Primeiro, os arquivos devem ser registrados no &CVS;, ou em outras palavras, <emphasis>adicionados ao repositório</emphasis>. Isto é necessário, mas não o suficiente. Para colocar os arquivos no repositório, você deve também realizar um <emphasis>envio</emphasis>. Este procedimento tem uma importante vantagem. Você pode realizar um envio dos arquivos junto com modificações de outras partes do projeto. Quando fizer isto, você pode facilmente ver (⪚ nas mensagens de envio) que todas as mudanças são parte de um todo. </para> + +<para>Para este fim, marque todos os arquivos a serem adicionados na janela principal do &cervisia;. Então, selecione <menuchoice><guimenu>Arquivo</guimenu><guimenuitem>Adicionar ao Repositório...</guimenuitem></menuchoice>, ou clique-direito nos arquivos marcados e selecione <guimenuitem>Adicionar ao Repositório...</guimenuitem>. O diálogo <guilabel>Adicionar ao CVS</guilabel> aparecerá, listando os arquivos que você marcou, e pedindo uma confirmação. Pressione <guibutton>OK</guibutton>. </para> + +<para>O &cervisia; envia um comando</para> <para> -<screen -><command ->cvs add <replaceable ->nomes dos arquivos</replaceable -></command -></screen> +<screen><command>cvs add <replaceable>nomes dos arquivos</replaceable></command></screen> </para> -<para ->Se a operação tiver sucesso, a coluna de estado deverá possuir "Adicionado ao repositório" para os arquivos adicionados. </para> - -<warning -><para ->O &CVS; não foi desenvolvido para fornecer um significativo controle de revisão para arquivos binários. Por exemplo, mesclar arquivos binários normalmente não faz sentido. Além do mais, por padrão o &CVS; realiza expansão de palavras chave (⪚ no string <literal ->$Revision: 1.6 $</literal ->) quando um arquivo é enviado. Em arquivos binários, estas substituições podem corromper o arquivo e fazê-lo completamente inutilizável. </para -></warning> - -<para ->Para desabilitar este comportamento, você deve enviar arquivos binários (ou outros arquivos, como Postscript ou imagens PNG) selecionando <menuchoice -><guimenu ->Arquivo</guimenu -><guimenuitem ->Adicionar Binário...</guimenuitem -></menuchoice ->. O diálogo <guilabel ->Adicionar ao CVS</guilabel -> aparecerá, listando os arquivos binários que você marcou, e pedindo uma confirmação. Pressione <guibutton ->OK</guibutton ->. </para> - -<para ->O &cervisia; envia um comando </para> +<para>Se a operação tiver sucesso, a coluna de estado deverá possuir "Adicionado ao repositório" para os arquivos adicionados. </para> + +<warning><para>O &CVS; não foi desenvolvido para fornecer um significativo controle de revisão para arquivos binários. Por exemplo, mesclar arquivos binários normalmente não faz sentido. Além do mais, por padrão o &CVS; realiza expansão de palavras chave (⪚ no string <literal>$Revision: 1.6 $</literal>) quando um arquivo é enviado. Em arquivos binários, estas substituições podem corromper o arquivo e fazê-lo completamente inutilizável. </para></warning> + +<para>Para desabilitar este comportamento, você deve enviar arquivos binários (ou outros arquivos, como Postscript ou imagens PNG) selecionando <menuchoice><guimenu>Arquivo</guimenu><guimenuitem>Adicionar Binário...</guimenuitem></menuchoice>. O diálogo <guilabel>Adicionar ao CVS</guilabel> aparecerá, listando os arquivos binários que você marcou, e pedindo uma confirmação. Pressione <guibutton>OK</guibutton>. </para> + +<para>O &cervisia; envia um comando </para> <para> -<screen -><command ->cvs add -kb <replaceable ->nomes dos arquivos</replaceable -></command -></screen> +<screen><command>cvs add -kb <replaceable>nomes dos arquivos</replaceable></command></screen> </para> </sect1> <sect1 id="removingfiles"> -<title ->Removendo Arquivos</title> - -<para ->Como na adição de arquivos, a remoção de arquivos é feita em dois passos: Primeiro, os arquivos devem ser registrados como removidos selecionando <menuchoice -><guimenu ->Arquivo</guimenu -><guimenuitem ->Remover Do Repositório...</guimenuitem -></menuchoice -> ou clique-direito nos arquivos marcados e selecionando <guimenuitem ->Remover Do Repositório...</guimenuitem -> a partir do menu de contexto. O diálogo <guilabel ->Remover do CVS</guilabel -> aparecerá, listando os arquivos que você marcou, e pedindo por uma confirmação. Pressione <guibutton ->OK</guibutton ->. O &cervisia; envia o comando </para> +<title>Removendo Arquivos</title> + +<para>Como na adição de arquivos, a remoção de arquivos é feita em dois passos: Primeiro, os arquivos devem ser registrados como removidos selecionando <menuchoice><guimenu>Arquivo</guimenu><guimenuitem>Remover Do Repositório...</guimenuitem></menuchoice> ou clique-direito nos arquivos marcados e selecionando <guimenuitem>Remover Do Repositório...</guimenuitem> a partir do menu de contexto. O diálogo <guilabel>Remover do CVS</guilabel> aparecerá, listando os arquivos que você marcou, e pedindo por uma confirmação. Pressione <guibutton>OK</guibutton>. O &cervisia; envia o comando </para> <para> -<screen -><command ->cvs remove -f <replaceable ->nomes dos arquivos</replaceable -></command -></screen> +<screen><command>cvs remove -f <replaceable>nomes dos arquivos</replaceable></command></screen> </para> -<para ->Após isto, esta modificação para cópia local deve ser enviada, possivelmente junto com outras modificações ao projeto. </para> +<para>Após isto, esta modificação para cópia local deve ser enviada, possivelmente junto com outras modificações ao projeto. </para> -<note -><para ->O comando acima somente funciona se o arquivo estiver atualizado. Caso contrário, você obterá uma mensagem de erro. Este comportamento faz sentido: Se você tem um arquivo modificado em relação à versão do repositório, ou se outro alguém fez qualquer modificação, você desejará primeiro verificar se você realmente quer descartá-lo. </para -></note> +<note><para>O comando acima somente funciona se o arquivo estiver atualizado. Caso contrário, você obterá uma mensagem de erro. Este comportamento faz sentido: Se você tem um arquivo modificado em relação à versão do repositório, ou se outro alguém fez qualquer modificação, você desejará primeiro verificar se você realmente quer descartá-lo. </para></note> </sect1> <sect1 id="addingremovingdirs"> -<title ->Adicionando e Removendo Pastas</title> - -<para ->Pastas são manuseadas fundamentalmente de maneira diferente de arquivos ordinários pelo &CVS;. Elas não estão sob o controle de revisão, por exemplo você não pode dizer quais pastas existem no projeto em um certo momento. Além do mais, pastas nunca podem ser explicitamente removidas (exceto removendo-as diretamente no repositório). </para> - -<para ->Como um substituto o &CVS; segue a convenção que uma pasta é "não existente" em uma versão do projeto se ela está vazia. Esta convenção pode ser forçada usando a opção <option ->-P</option -> para o <command ->cvs update</command -> e <command ->cvs checkout</command ->. Esta opção pode ser configurada no menu <menuchoice -><guimenu ->Configurações</guimenu -><guimenuitem ->Excluir Pastas Vazias Ao Atualizar</guimenuitem -></menuchoice ->. </para> - -<para ->A pasta pode ser adicionanda ao repositório selecionando <menuchoice -><guimenu ->Arquivo</guimenu -><guimenuitem ->Adicionar ao Repositório...</guimenuitem -></menuchoice -> ou clique direito na pasta marcada e selecionando <guimenuitem ->Adicionar ao Repositório...</guimenuitem -> no menu de contexto. Observe que ao contrário da adição de arquivos, adicionar pastas não necessita de um envio posterior. O &cervisia; envia o comand </para> +<title>Adicionando e Removendo Pastas</title> + +<para>Pastas são manuseadas fundamentalmente de maneira diferente de arquivos ordinários pelo &CVS;. Elas não estão sob o controle de revisão, por exemplo você não pode dizer quais pastas existem no projeto em um certo momento. Além do mais, pastas nunca podem ser explicitamente removidas (exceto removendo-as diretamente no repositório). </para> + +<para>Como um substituto o &CVS; segue a convenção que uma pasta é "não existente" em uma versão do projeto se ela está vazia. Esta convenção pode ser forçada usando a opção <option>-P</option> para o <command>cvs update</command> e <command>cvs checkout</command>. Esta opção pode ser configurada no menu <menuchoice><guimenu>Configurações</guimenu><guimenuitem>Excluir Pastas Vazias Ao Atualizar</guimenuitem></menuchoice>. </para> + +<para>A pasta pode ser adicionanda ao repositório selecionando <menuchoice><guimenu>Arquivo</guimenu><guimenuitem>Adicionar ao Repositório...</guimenuitem></menuchoice> ou clique direito na pasta marcada e selecionando <guimenuitem>Adicionar ao Repositório...</guimenuitem> no menu de contexto. Observe que ao contrário da adição de arquivos, adicionar pastas não necessita de um envio posterior. O &cervisia; envia o comand </para> <para> -<screen -><command ->cvs add <replaceable ->nomedapasta</replaceable -></command -></screen> +<screen><command>cvs add <replaceable>nomedapasta</replaceable></command></screen> </para> </sect1> <sect1 id="committingfiles"> -<title ->Enviando Arquivos</title> - -<para ->Quando você realiza uma certa quantidade de mudanças em sua cópia de trabalho, e você deseja que outros desenvolvedores tenham acesso a elas, você as <emphasis ->envia</emphasis ->. Com um envio, você coloca suas versões de arquivos modificados como novas revisões no repositório. Uma atualização subseqüente por outro desenvolvedor trará suas modificações para a cópia de trabalho dele. </para> - -<para ->Para enviar um conjunto de arquivos, selecione-os na janela principal do &cervisia; e selecione <menuchoice -><guimenu ->Arquivo</guimenu -><guimenuitem ->Enviar...</guimenuitem -></menuchoice -> ou clique direito sobre os arquivos marcados e selecione <guimenuitem ->Enviar...</guimenuitem -> no menu de contexto. </para> +<title>Enviando Arquivos</title> + +<para>Quando você realiza uma certa quantidade de mudanças em sua cópia de trabalho, e você deseja que outros desenvolvedores tenham acesso a elas, você as <emphasis>envia</emphasis>. Com um envio, você coloca suas versões de arquivos modificados como novas revisões no repositório. Uma atualização subseqüente por outro desenvolvedor trará suas modificações para a cópia de trabalho dele. </para> + +<para>Para enviar um conjunto de arquivos, selecione-os na janela principal do &cervisia; e selecione <menuchoice><guimenu>Arquivo</guimenu><guimenuitem>Enviar...</guimenuitem></menuchoice> ou clique direito sobre os arquivos marcados e selecione <guimenuitem>Enviar...</guimenuitem> no menu de contexto. </para> <figure id="screenshot-commit" float="1"> -<title ->Uma captura de tela do diálogo de envio do &cervisia;</title> +<title>Uma captura de tela do diálogo de envio do &cervisia;</title> <mediaobject> -<imageobject -><imagedata format="PNG" fileref="commit.png"/></imageobject> +<imageobject><imagedata format="PNG" fileref="commit.png"/></imageobject> </mediaobject> </figure> -<para ->Você obtém um diálogo que mostra uma lista dos arquivos selecionados na seção superiot e uma mensagem de registro para suas mudanças abaixo. O &cervisia; lhe auxilia de diversas formas para encontrar um mensagem de registro significativa. Primeiro, na lista de arquivos você pode dar um duplo-clique em um arquivo ou pressionar <keycap ->Return</keycap -> para ver as mudanças que você realizou no arquivo. Em segundo, ele lhe oferece uma lista de mensagens de registro que você usou previamente em uma caixa combinada. Em terceiro, este diálogo é integrado com o editor de changelog do &cervisia; descrito abaixo. Quando você tiver terminado o diálogo, o comando </para> +<para>Você obtém um diálogo que mostra uma lista dos arquivos selecionados na seção superiot e uma mensagem de registro para suas mudanças abaixo. O &cervisia; lhe auxilia de diversas formas para encontrar um mensagem de registro significativa. Primeiro, na lista de arquivos você pode dar um duplo-clique em um arquivo ou pressionar <keycap>Return</keycap> para ver as mudanças que você realizou no arquivo. Em segundo, ele lhe oferece uma lista de mensagens de registro que você usou previamente em uma caixa combinada. Em terceiro, este diálogo é integrado com o editor de changelog do &cervisia; descrito abaixo. Quando você tiver terminado o diálogo, o comando </para> <para> -<screen -><command ->cvs commit -m <replaceable ->mensagem</replaceable -> <replaceable ->nomes dos arquivos</replaceable -></command -></screen> +<screen><command>cvs commit -m <replaceable>mensagem</replaceable> <replaceable>nomes dos arquivos</replaceable></command></screen> </para> -<para ->é usado. </para> +<para>é usado. </para> -<note -><para ->Um erro comum que você pode encontrar durante um envio é <errorname ->falha na verificação de atualização</errorname ->. Isto indica que alguém fez mudanças no repositório desde sua última atualização. Ou mais tecnicamente, que sua revisão <literal ->BASE</literal -> não é a mais nova do repositório. Neste caso o &CVS; recusa-se a mesclar suas modificações para o repositório. A solução é atualizar, resolver qualquer conflito e sincronizar novamente. É claro, se você está trabalhando no projeto de um software, isto é normalmente uma boa maneira de verificar se o programa ainda funciona após você tê-lo atualizado - além do mais, podem existir interações incorretas entre suas modificações e a de outros desenvolvedores causando uma quebra de código. </para -></note> +<note><para>Um erro comum que você pode encontrar durante um envio é <errorname>falha na verificação de atualização</errorname>. Isto indica que alguém fez mudanças no repositório desde sua última atualização. Ou mais tecnicamente, que sua revisão <literal>BASE</literal> não é a mais nova do repositório. Neste caso o &CVS; recusa-se a mesclar suas modificações para o repositório. A solução é atualizar, resolver qualquer conflito e sincronizar novamente. É claro, se você está trabalhando no projeto de um software, isto é normalmente uma boa maneira de verificar se o programa ainda funciona após você tê-lo atualizado - além do mais, podem existir interações incorretas entre suas modificações e a de outros desenvolvedores causando uma quebra de código. </para></note> <note> -<para ->Outro erro comum resulta na mensagem de erro <errorname ->Tag 'X' pregada para arquivo 'X' não está no repositório</errorname ->. Isto acontece se você tenta enviar um arquivo que foi trazido previamente para uma determinada revisão ou tag com o comando </para> +<para>Outro erro comum resulta na mensagem de erro <errorname>Tag 'X' pregada para arquivo 'X' não está no repositório</errorname>. Isto acontece se você tenta enviar um arquivo que foi trazido previamente para uma determinada revisão ou tag com o comando </para> <para> -<screen -><prompt ->%</prompt -><userinput ->cvs update -r X</userinput -></screen> +<screen><prompt>%</prompt><userinput>cvs update -r X</userinput></screen> </para> -<para ->(que é ⪚ usada pelo ítem de menu <menuchoice -><guimenu ->Avançado</guimenu -><guimenuitem ->Atualizar para Tag/Data...</guimenuitem -></menuchoice ->). Neste caso, a tag do arquivo foi pregada, e por isso atualizações posteriores não lhe trarão a revisão mais nova do repositório. Se você deseja enviar futuras revisões para o repositório, você deve atualizar a tag do repositório antes de sincronizações posteriores. </para> +<para>(que é ⪚ usada pelo ítem de menu <menuchoice><guimenu>Avançado</guimenu><guimenuitem>Atualizar para Tag/Data...</guimenuitem></menuchoice>). Neste caso, a tag do arquivo foi pregada, e por isso atualizações posteriores não lhe trarão a revisão mais nova do repositório. Se você deseja enviar futuras revisões para o repositório, você deve atualizar a tag do repositório antes de sincronizações posteriores. </para> </note> -<para ->Com o &cervisia;, é muito fácil manter um arquivo de ChangeLog que é compatível com a formatação das linhas guia de codificação GNU. Para usá-lo, selecione <menuchoice -><guimenu ->Arquivo</guimenu -><guimenuitem ->Inserir Entrada ChangeLog...</guimenuitem -></menuchoice ->. Se um arquivo com o nome <filename ->ChangeLog</filename -> existir na pasta de nível superior de sua cópia local, este arquivo será carregado e você terá a possibilidade de editá-lo. Para este fim, na parte superior do arquivo, uma entrada com a data atual e seu nome de usuário (que pode ser configurado como descrito em <xref linkend="customize-general"/>) é inserida. Quando você terminar este diálogo clicando <guibutton ->OK</guibutton ->, na próxima vez que abrir o diálogo de envio você terá uma mensagem de registro configurada para a mensagem que você inseriu por último no registro de mudanças. </para> +<para>Com o &cervisia;, é muito fácil manter um arquivo de ChangeLog que é compatível com a formatação das linhas guia de codificação GNU. Para usá-lo, selecione <menuchoice><guimenu>Arquivo</guimenu><guimenuitem>Inserir Entrada ChangeLog...</guimenuitem></menuchoice>. Se um arquivo com o nome <filename>ChangeLog</filename> existir na pasta de nível superior de sua cópia local, este arquivo será carregado e você terá a possibilidade de editá-lo. Para este fim, na parte superior do arquivo, uma entrada com a data atual e seu nome de usuário (que pode ser configurado como descrito em <xref linkend="customize-general"/>) é inserida. Quando você terminar este diálogo clicando <guibutton>OK</guibutton>, na próxima vez que abrir o diálogo de envio você terá uma mensagem de registro configurada para a mensagem que você inseriu por último no registro de mudanças. </para> </sect1> <sect1 id="resolvingconflicts"> -<title ->Resolvendo Conflitos</title> +<title>Resolvendo Conflitos</title> -<para ->Conflitos podem ocorrer sempre que você tenha feito mudanças em um arquivo que também foi modificado por outro desenvolvedor. O conflito é detectado pelo &CVS; quando você atualiza o arquivo modificado. O &CVS; então tenta mesclar as modificações enviadas por outro desenvolvedor em sua cópia local. A mesclagem falha se tanto a sua modificação como a do outro desenvolvedor estão em partes sobrepostas do arquivo, e o servidor &CVS; envia uma mensagem de erro. </para> +<para>Conflitos podem ocorrer sempre que você tenha feito mudanças em um arquivo que também foi modificado por outro desenvolvedor. O conflito é detectado pelo &CVS; quando você atualiza o arquivo modificado. O &CVS; então tenta mesclar as modificações enviadas por outro desenvolvedor em sua cópia local. A mesclagem falha se tanto a sua modificação como a do outro desenvolvedor estão em partes sobrepostas do arquivo, e o servidor &CVS; envia uma mensagem de erro. </para> -<para ->Na janela principal do &cervisia;, arquivos com conflitos são indicados com "Conflito" na coluna de estado e com uma cor vermelha. É seu trabalho agora resolver estes conflitos antes de enviar o arquivo. O &CVS; recusará enviar qualquer arquivo com conflitos até eles serem editados. A partir da janela principal, você pode resolver conflitos da maneira tradicional, é claro: apenas dê um duplo-clique no arquivo em questão e edite-o com seu editor favorito.</para> +<para>Na janela principal do &cervisia;, arquivos com conflitos são indicados com "Conflito" na coluna de estado e com uma cor vermelha. É seu trabalho agora resolver estes conflitos antes de enviar o arquivo. O &CVS; recusará enviar qualquer arquivo com conflitos até eles serem editados. A partir da janela principal, você pode resolver conflitos da maneira tradicional, é claro: apenas dê um duplo-clique no arquivo em questão e edite-o com seu editor favorito.</para> -<para ->O &CVS; marca as mudanças dos conflitos colocando marcas no meio dos arquivos da seguinte maneira:</para> +<para>O &CVS; marca as mudanças dos conflitos colocando marcas no meio dos arquivos da seguinte maneira:</para> -<screen -><<<<<<< +<screen><<<<<<< Mudanças em sua cópia de trabalho ======= Mudanças no repositório >>>>>>> número_revisão </screen> -<para ->Você deve substituir todo este bloco com uma nova versão meslclada.É claro, você tem uma grande liberdade para resolver um conjunto de conflitos: você pode para cada conflito decidir por uma das duas versões alternativas. Você pode também decidir que ambas as versões estão quebradas e reescrever toda a rotina ou o arquivo completo. </para> - -<para ->Felizmente, o &cervisia; oferece uma bela interface para manipular estes conflitos. Isto não significa que você nunca precisará editar manualmente os arquivos, mas pelo menos pode eliminar a necessidade de fazer isto para a resolução de conflitos triviais. Para usar o diálogo <guilabel ->Resolver CVS</guilabel -> do &cervisia; selecione <menuchoice -><guimenu ->Arquivo</guimenu -><guimenuitem ->Resolver...</guimenuitem -></menuchoice -> ou clique direito no arquivo marcado e selecione <guimenuitem ->Resolver...</guimenuitem -> no menu de contexto. </para> +<para>Você deve substituir todo este bloco com uma nova versão meslclada.É claro, você tem uma grande liberdade para resolver um conjunto de conflitos: você pode para cada conflito decidir por uma das duas versões alternativas. Você pode também decidir que ambas as versões estão quebradas e reescrever toda a rotina ou o arquivo completo. </para> + +<para>Felizmente, o &cervisia; oferece uma bela interface para manipular estes conflitos. Isto não significa que você nunca precisará editar manualmente os arquivos, mas pelo menos pode eliminar a necessidade de fazer isto para a resolução de conflitos triviais. Para usar o diálogo <guilabel>Resolver CVS</guilabel> do &cervisia; selecione <menuchoice><guimenu>Arquivo</guimenu><guimenuitem>Resolver...</guimenuitem></menuchoice> ou clique direito no arquivo marcado e selecione <guimenuitem>Resolver...</guimenuitem> no menu de contexto. </para> <figure id="screenshot-resolve" float="1"> -<title ->Uma captura de tela da caixa de diálogo resolver do &cervisia;</title> +<title>Uma captura de tela da caixa de diálogo resolver do &cervisia;</title> <mediaobject> -<imageobject -><imagedata format="PNG" fileref="resolve.png"/></imageobject> -<textobject -><phrase ->Uma captura de tela da caixa de diálogo resolver do &cervisia;</phrase -></textobject> +<imageobject><imagedata format="PNG" fileref="resolve.png"/></imageobject> +<textobject><phrase>Uma captura de tela da caixa de diálogo resolver do &cervisia;</phrase></textobject> </mediaobject> </figure> -<para ->No topo do diálogo, você vê <guilabel ->Sua versão (A)</guilabel -> do arquivo no lado esquerdo e a versão do repositório, <guilabel ->Outra versão (B)</guilabel ->, no lado direito. As diferenças entre elas estão marcadas com a cor vermelha. Abaixo destas duas versões, você pode ver a <guilabel ->Versão mesclada</guilabel ->. A versão mesclada reflete que seção estará em sua cópia de trabalho se você pressionar o botão <guibutton ->Salvar</guibutton ->. </para> - -<para ->Você pode alternar entre as diferentes seções conflitantes pressionando <guibutton -><<</guibutton -> e <guibutton ->>></guibutton ->. Na metade inferior do diálogo você pode ver qual seção está atualmente marcada. Por exemplo, <literal ->2 de 3</literal -> significa que você está atualmente na segunda seção de diferença de um total de 3. </para> - -<para ->Agora você pode decidir seção por seção qual das duas versões você deseja que esteja no arquivo mesclado. Pressionando <guibutton ->A</guibutton ->, você aceita a versão que você editou. Pressionando <guibutton ->B</guibutton ->, você aceita a versão do repositório. Pressionando <guibutton ->A+B</guibutton ->, ambas as versões serão adicionadas, e sua versão virá primeiro. O <guibutton ->B+A</guibutton -> obtém o mesmo resultado, mas a ordem será diferente: primeiro a versão do repositório, depois a sua. </para> - -<para ->Se você não estiver satisfeito com nenhuma destas versões, pressione <guibutton ->Editar</guibutton -> para abrir um editor de texto simples de onde você pode editar a seção. Quando você tiver terminado a edição, pressione <guibutton ->OK</guibutton -> para retornar ao diálogo <guilabel ->Resolver CVS</guilabel -> e terminar de resolver os conflitos. Você verá a seção que acabou de editar na <guilabel ->Versão mesclada</guilabel ->, com suas modificações. </para> - -<para ->Para salvar suas modificações, sobrescrevendo a versão da cópia de trabalho, pressione <guibutton ->Salvar</guibutton ->. Observe que isto salvará as escolhas nã somente da seção que você está atualmente vendo, mas de todas as seções no arquivo. Se você deseja salvar em outro arquivo, pressione <guibutton ->Salvar Como...</guibutton ->. Pressione <guibutton ->Fechar</guibutton -> para sair do diálogo. Se você fechar o diálogo sem salvar, as mudanças serão perdidas. </para> +<para>No topo do diálogo, você vê <guilabel>Sua versão (A)</guilabel> do arquivo no lado esquerdo e a versão do repositório, <guilabel>Outra versão (B)</guilabel>, no lado direito. As diferenças entre elas estão marcadas com a cor vermelha. Abaixo destas duas versões, você pode ver a <guilabel>Versão mesclada</guilabel>. A versão mesclada reflete que seção estará em sua cópia de trabalho se você pressionar o botão <guibutton>Salvar</guibutton>. </para> + +<para>Você pode alternar entre as diferentes seções conflitantes pressionando <guibutton><<</guibutton> e <guibutton>>></guibutton>. Na metade inferior do diálogo você pode ver qual seção está atualmente marcada. Por exemplo, <literal>2 de 3</literal> significa que você está atualmente na segunda seção de diferença de um total de 3. </para> + +<para>Agora você pode decidir seção por seção qual das duas versões você deseja que esteja no arquivo mesclado. Pressionando <guibutton>A</guibutton>, você aceita a versão que você editou. Pressionando <guibutton>B</guibutton>, você aceita a versão do repositório. Pressionando <guibutton>A+B</guibutton>, ambas as versões serão adicionadas, e sua versão virá primeiro. O <guibutton>B+A</guibutton> obtém o mesmo resultado, mas a ordem será diferente: primeiro a versão do repositório, depois a sua. </para> + +<para>Se você não estiver satisfeito com nenhuma destas versões, pressione <guibutton>Editar</guibutton> para abrir um editor de texto simples de onde você pode editar a seção. Quando você tiver terminado a edição, pressione <guibutton>OK</guibutton> para retornar ao diálogo <guilabel>Resolver CVS</guilabel> e terminar de resolver os conflitos. Você verá a seção que acabou de editar na <guilabel>Versão mesclada</guilabel>, com suas modificações. </para> + +<para>Para salvar suas modificações, sobrescrevendo a versão da cópia de trabalho, pressione <guibutton>Salvar</guibutton>. Observe que isto salvará as escolhas nã somente da seção que você está atualmente vendo, mas de todas as seções no arquivo. Se você deseja salvar em outro arquivo, pressione <guibutton>Salvar Como...</guibutton>. Pressione <guibutton>Fechar</guibutton> para sair do diálogo. Se você fechar o diálogo sem salvar, as mudanças serão perdidas. </para> </sect1> @@ -1431,638 +591,245 @@ Mudanças no repositório <chapter id="obtaininginformation"> -<title ->Obtendo informações Sobre os Arquivos e Criando Remendos</title> +<title>Obtendo informações Sobre os Arquivos e Criando Remendos</title> <sect1 id="diff"> -<title ->Encontrando Diferenças Entre Revisões</title> +<title>Encontrando Diferenças Entre Revisões</title> -<para ->Existem diversos locais no &cervisia; onde você pode pedir por uma janela mostrando as diferenças entre as revisões de um arquivo. </para> +<para>Existem diversos locais no &cervisia; onde você pode pedir por uma janela mostrando as diferenças entre as revisões de um arquivo. </para> <itemizedlist> -<listitem -><para ->Na visão principal, você pode selecionar <menuchoice -><guimenu ->Ver</guimenu -><guimenuitem ->Diferença para Repositório...</guimenuitem -></menuchoice ->. Isto é baseado no comando <command ->cvs diff</command -> e lhe mostra as diferenças entre a versão em sua cópia local e a versão de sua última atualização (também conhecida como <literal ->BASE</literal ->). Isto é particularmente útil apenas antes de você enviar um arquivo, de modo que você possa encontrar uma mensagem de registro apropriada. </para -></listitem> - -<listitem -><para ->Você pode ver as diferenças entra as versões em sua área local e a versão no ramo de desenvolvimento principal (também chamado <literal ->HEAD</literal ->) selecionando <menuchoice -><guimenu ->Ver</guimenu -> <guimenuitem ->Diferença para o Repositório (HEAD)...</guimenuitem -></menuchoice ->. </para -></listitem> - -<listitem -><para ->Você pode ver as diferenças entre as duas últimas revisões do arquivo selecionado escolhendo <menuchoice -><guimenu ->Ver</guimenu -> <guimenuitem ->Última Mudança...</guimenuitem -></menuchoice ->. </para -></listitem> - -<listitem -><para ->Você pode acessar os ítens de menu <guimenuitem ->Diferença para o Repositório (BASE)...</guimenuitem ->. <guimenuitem ->Diferença para o Repositório (HEAD)...</guimenuitem -> e <guimenuitem ->Última Mudança...</guimenuitem -> a partir do menu de contexto da visão principal, com um clique direito sobre o arquivo que deseja ver. </para -></listitem> - -<listitem -><para ->No diálogo que é mostrado quando você envia um conjunto de arquivos, você pode solicitar uma janela de diferenças selecionando um nome de arquivo na lista de seleção, seja através de um duplo-clique ou pressionando <keycap ->Return</keycap ->. Isto é idêntico ao uso do <menuchoice -><guimenu ->Ver</guimenu -><guimenuitem ->Diferença para Repositório (BASE)...</guimenuitem -></menuchoice -> com o respectivo arquivo na janela principal. </para -></listitem> - -<listitem -><para ->No diálogo do Navegador de registros, você pode marcar duas revisões de um arquivo e solicitar um diálogo que mostra as diferenças entre eles (veja em <xref linkend="browsinglogs"/>). </para -></listitem> +<listitem><para>Na visão principal, você pode selecionar <menuchoice><guimenu>Ver</guimenu><guimenuitem>Diferença para Repositório...</guimenuitem></menuchoice>. Isto é baseado no comando <command>cvs diff</command> e lhe mostra as diferenças entre a versão em sua cópia local e a versão de sua última atualização (também conhecida como <literal>BASE</literal>). Isto é particularmente útil apenas antes de você enviar um arquivo, de modo que você possa encontrar uma mensagem de registro apropriada. </para></listitem> + +<listitem><para>Você pode ver as diferenças entra as versões em sua área local e a versão no ramo de desenvolvimento principal (também chamado <literal>HEAD</literal>) selecionando <menuchoice><guimenu>Ver</guimenu> <guimenuitem>Diferença para o Repositório (HEAD)...</guimenuitem></menuchoice>. </para></listitem> + +<listitem><para>Você pode ver as diferenças entre as duas últimas revisões do arquivo selecionado escolhendo <menuchoice><guimenu>Ver</guimenu> <guimenuitem>Última Mudança...</guimenuitem></menuchoice>. </para></listitem> + +<listitem><para>Você pode acessar os ítens de menu <guimenuitem>Diferença para o Repositório (BASE)...</guimenuitem>. <guimenuitem>Diferença para o Repositório (HEAD)...</guimenuitem> e <guimenuitem>Última Mudança...</guimenuitem> a partir do menu de contexto da visão principal, com um clique direito sobre o arquivo que deseja ver. </para></listitem> + +<listitem><para>No diálogo que é mostrado quando você envia um conjunto de arquivos, você pode solicitar uma janela de diferenças selecionando um nome de arquivo na lista de seleção, seja através de um duplo-clique ou pressionando <keycap>Return</keycap>. Isto é idêntico ao uso do <menuchoice><guimenu>Ver</guimenu><guimenuitem>Diferença para Repositório (BASE)...</guimenuitem></menuchoice> com o respectivo arquivo na janela principal. </para></listitem> + +<listitem><para>No diálogo do Navegador de registros, você pode marcar duas revisões de um arquivo e solicitar um diálogo que mostra as diferenças entre eles (veja em <xref linkend="browsinglogs"/>). </para></listitem> </itemizedlist> -<para ->Como você deve esperar, o &cervisia; não apenas exibe a saída do comando <command ->diff</command -> em seu terminal, mas lhe mostra uma visão gráfica como vista em <xref linkend="screenshot-log"/>. </para> +<para>Como você deve esperar, o &cervisia; não apenas exibe a saída do comando <command>diff</command> em seu terminal, mas lhe mostra uma visão gráfica como vista em <xref linkend="screenshot-log"/>. </para> <figure id="screenshot-log" float="1"> -<title ->Uma captura de tela do diálogo de diferenças do &cervisia;</title> +<title>Uma captura de tela do diálogo de diferenças do &cervisia;</title> <mediaobject> -<imageobject -><imagedata format="PNG" fileref="diff.png"/></imageobject> -<textobject -><phrase ->Uma captura de tela do diálogo de diferenças do &cervisia;</phrase -></textobject> +<imageobject><imagedata format="PNG" fileref="diff.png"/></imageobject> +<textobject><phrase>Uma captura de tela do diálogo de diferenças do &cervisia;</phrase></textobject> </mediaobject> </figure> -<para ->O testo no diálogo é uma variante melhorada do texto obtido pelo comando diff com a opção <option ->-u</option ->. Você pode ver as diferentes versões em duas janelas, com linhas arranjadas de modo que você possa fazer uma comparação lado a lado. Quer dizer, onde o texto foi adicionado ou excluído, a janela respectiva mostra linhas vazias com a marca <literal ->+++++</literal -> no lado esquerdo. Na outra parte, você pode ver o número de execução de cada linha na coluna da esquerda. </para> - -<para ->Na segunda coluna da janela direita, você pode ver que tipo de mudança foi feita. Tipos possíveis são <literal ->Adicionado</literal ->, <literal ->Excluído</literal -> e <literal ->Mudado</literal ->. As linhas são marcadas respectivamente em azul, verde e vermelho. No meio do diálogo uma imagem comprimida dos marcadores coloridos é mostrada. Deste modo, você pode obter uma visão rápida de todas as mudanças do arquivo. Você pode também usar a posição das regiões coloridas na imagem comprimida como uma orientação de quando usar as barras de rolagem. </para> - -<para ->Normalmente, as barras de rolagem das janelas esquerda e direita são sincronizadas, isto é se você rolar no lado esquerdo, o lado direito é rolado da mesma maneira. Você pode mudar este comportamente habilitando a caixa <guibutton ->Sincronizar barras de rolagem</guibutton ->. </para> - -<para ->Para informações sobre como personalizar o diálogo de diferenças, veja <xref linkend="customize-diff"/>. </para> +<para>O testo no diálogo é uma variante melhorada do texto obtido pelo comando diff com a opção <option>-u</option>. Você pode ver as diferentes versões em duas janelas, com linhas arranjadas de modo que você possa fazer uma comparação lado a lado. Quer dizer, onde o texto foi adicionado ou excluído, a janela respectiva mostra linhas vazias com a marca <literal>+++++</literal> no lado esquerdo. Na outra parte, você pode ver o número de execução de cada linha na coluna da esquerda. </para> + +<para>Na segunda coluna da janela direita, você pode ver que tipo de mudança foi feita. Tipos possíveis são <literal>Adicionado</literal>, <literal>Excluído</literal> e <literal>Mudado</literal>. As linhas são marcadas respectivamente em azul, verde e vermelho. No meio do diálogo uma imagem comprimida dos marcadores coloridos é mostrada. Deste modo, você pode obter uma visão rápida de todas as mudanças do arquivo. Você pode também usar a posição das regiões coloridas na imagem comprimida como uma orientação de quando usar as barras de rolagem. </para> + +<para>Normalmente, as barras de rolagem das janelas esquerda e direita são sincronizadas, isto é se você rolar no lado esquerdo, o lado direito é rolado da mesma maneira. Você pode mudar este comportamente habilitando a caixa <guibutton>Sincronizar barras de rolagem</guibutton>. </para> + +<para>Para informações sobre como personalizar o diálogo de diferenças, veja <xref linkend="customize-diff"/>. </para> </sect1> <sect1 id="creatingpatches"> -<title ->Criando Remendos</title> - -<para ->Algumas vezes você pode oferecer suas modificações para revisão, antes de enviá-las, ou você não possui acesso de escrita ao repositório (logo você não pode enviar). O &CVS; oferece um formato padrão para compartilhar as modificações em sua cópia de trabalho, de modo que outras pessoas possam revisar suas mudanças, testá-las em suas cópias de trabalho e aplicá-las ao repositório &CVS;. Um arquivo contendo estas diferenças é chamado um <firstterm ->remendo</firstterm ->, e é gerado pelo comando <command ->cvs diff</command ->, da mesma maneira que as diferenças são geradas em <xref linkend="diff"/>. Compartilhar remendos ao invés de conjuntos de arquivos consome menos banda de rede, e remendos são mais fáceis de manipular, de modo que você pode enviar um único arquivo de remendo contendo todas as diferenças de diversos arquivos fonte. </para> - -<para ->O &cervisia;, oferece acesso a este recursos selecionado <menuchoice -><guimenu ->Avançado</guimenu -> <guimenuitem ->Criar Remendo Contra Repositório...</guimenuitem -></menuchoice ->. </para> - -<important -><para ->A ação <guimenuitem ->Criar Remendo Contra Repositório...</guimenuitem -> cria um remendo com todas as modificações em todos os arquivos em sua cópia de trabalho (área local) contra o repositório <literal ->BASE</literal ->. Logo, a seleção de arquivos na visão principal não afeta o remendo que será gerado. </para -></important> - -<para ->Outra possibilidade é selecionar um arquivo na visão principal e selecionar <guimenuitem ->Navegar Registro...</guimenuitem -> a partir do menu <guimenu ->Ver</guimenu -> ou clique direito no arquivo marcado e selecionar <guimenuitem ->Navegar Registro...</guimenuitem -> a partir do menu instantâneo, para abrir o <link linkend="browsinglogs" ->Diálogo do navegador de registro</link ->. Agora, selecione a versão contra a qual deseja criar um remendo, como a revisão "A" e pressione o botão <guilabel ->Criar Remendo...</guilabel ->. Isto irá gerar um remendo com as diferenças entre o <emphasis ->arquivo marcado</emphasis -> em sua cópia e a versão selecionada com a revisão "A". </para> - -<para ->Antes de gerar o remendo, o &cervisia; exibe um diálogo permitindo-lhe configurar o formato de saída. </para> +<title>Criando Remendos</title> + +<para>Algumas vezes você pode oferecer suas modificações para revisão, antes de enviá-las, ou você não possui acesso de escrita ao repositório (logo você não pode enviar). O &CVS; oferece um formato padrão para compartilhar as modificações em sua cópia de trabalho, de modo que outras pessoas possam revisar suas mudanças, testá-las em suas cópias de trabalho e aplicá-las ao repositório &CVS;. Um arquivo contendo estas diferenças é chamado um <firstterm>remendo</firstterm>, e é gerado pelo comando <command>cvs diff</command>, da mesma maneira que as diferenças são geradas em <xref linkend="diff"/>. Compartilhar remendos ao invés de conjuntos de arquivos consome menos banda de rede, e remendos são mais fáceis de manipular, de modo que você pode enviar um único arquivo de remendo contendo todas as diferenças de diversos arquivos fonte. </para> + +<para>O &cervisia;, oferece acesso a este recursos selecionado <menuchoice><guimenu>Avançado</guimenu> <guimenuitem>Criar Remendo Contra Repositório...</guimenuitem></menuchoice>. </para> + +<important><para>A ação <guimenuitem>Criar Remendo Contra Repositório...</guimenuitem> cria um remendo com todas as modificações em todos os arquivos em sua cópia de trabalho (área local) contra o repositório <literal>BASE</literal>. Logo, a seleção de arquivos na visão principal não afeta o remendo que será gerado. </para></important> + +<para>Outra possibilidade é selecionar um arquivo na visão principal e selecionar <guimenuitem>Navegar Registro...</guimenuitem> a partir do menu <guimenu>Ver</guimenu> ou clique direito no arquivo marcado e selecionar <guimenuitem>Navegar Registro...</guimenuitem> a partir do menu instantâneo, para abrir o <link linkend="browsinglogs">Diálogo do navegador de registro</link>. Agora, selecione a versão contra a qual deseja criar um remendo, como a revisão "A" e pressione o botão <guilabel>Criar Remendo...</guilabel>. Isto irá gerar um remendo com as diferenças entre o <emphasis>arquivo marcado</emphasis> em sua cópia e a versão selecionada com a revisão "A". </para> + +<para>Antes de gerar o remendo, o &cervisia; exibe um diálogo permitindo-lhe configurar o formato de saída. </para> <figure id="screenshot-patch" float="1"> -<title ->Uma captura de tela do diálogo de remendo do &cervisia;</title> +<title>Uma captura de tela do diálogo de remendo do &cervisia;</title> <mediaobject> -<imageobject -><imagedata format="PNG" fileref="patch.png"/></imageobject> -<textobject -><phrase ->Uma captura de tela do diálogo de remendo do &cervisia;</phrase -></textobject> +<imageobject><imagedata format="PNG" fileref="patch.png"/></imageobject> +<textobject><phrase>Uma captura de tela do diálogo de remendo do &cervisia;</phrase></textobject> </mediaobject> </figure> <variablelist> <varlistentry> -<term -><guilabel ->Formato de Saída</guilabel -></term> -<listitem -><para ->Existem três formatos de saída disponíveis: </para> -<para -><guilabel ->Normal</guilabel ->: um formato que pode ser usado para fazer com que o editor ed automaticamente crie outra cópia do arquivo antigo correspondendo ao novo arquivo. No formato de saída normal, os caracteres < e > marcam as mudanças, e não existe informação de contexto. </para> -<para -><guilabel ->Unificado</guilabel ->: o formato mais usado para troca de remendos. O formato unificado usa linhas de contexto em adição aos números de linha para gravar as diferenças. Isto torna o processo de aplicação de remendos mais robusto. Este formato exibe as diferenças em uma forma legível e compacta, com um cabeçalho para cada arquivo envolvido, e seções separadas (pedaços) para cada diferença. As linhas de contexto disponíveis para cada diferença torna a leitura das modificações mais fácil. No formato de saída unificado, os caracteres + e - marcam as mudanças. </para> -<para -><guilabel ->Contexto</guilabel ->, que representa a mesma informação do formato unificado, mas de uma maneira menos compacta. No formato de saída contexto, o caracter ! marca as mudanças. </para -></listitem> +<term><guilabel>Formato de Saída</guilabel></term> +<listitem><para>Existem três formatos de saída disponíveis: </para> +<para><guilabel>Normal</guilabel>: um formato que pode ser usado para fazer com que o editor ed automaticamente crie outra cópia do arquivo antigo correspondendo ao novo arquivo. No formato de saída normal, os caracteres < e > marcam as mudanças, e não existe informação de contexto. </para> +<para><guilabel>Unificado</guilabel>: o formato mais usado para troca de remendos. O formato unificado usa linhas de contexto em adição aos números de linha para gravar as diferenças. Isto torna o processo de aplicação de remendos mais robusto. Este formato exibe as diferenças em uma forma legível e compacta, com um cabeçalho para cada arquivo envolvido, e seções separadas (pedaços) para cada diferença. As linhas de contexto disponíveis para cada diferença torna a leitura das modificações mais fácil. No formato de saída unificado, os caracteres + e - marcam as mudanças. </para> +<para><guilabel>Contexto</guilabel>, que representa a mesma informação do formato unificado, mas de uma maneira menos compacta. No formato de saída contexto, o caracter ! marca as mudanças. </para></listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Número de linhas de contexto:</guilabel -></term> -<listitem -><para ->Configure aqui o número de linhas de contexto para os formatos unificado ou contexto. Esta opção não está disponível para o formato de saída normal, uma vez que neste formato nenhuma informação de contexto é gravada. Mais informações de contexto torna a leitura da saída gerada mais fácil, e a aplicação do remendo mais precisa, mas aumenta o tamanho do remendo. É recomendável usar pelo menos duas linhas de contexto para a operação de remendo apropriada. </para -></listitem> +<term><guilabel>Número de linhas de contexto:</guilabel></term> +<listitem><para>Configure aqui o número de linhas de contexto para os formatos unificado ou contexto. Esta opção não está disponível para o formato de saída normal, uma vez que neste formato nenhuma informação de contexto é gravada. Mais informações de contexto torna a leitura da saída gerada mais fácil, e a aplicação do remendo mais precisa, mas aumenta o tamanho do remendo. É recomendável usar pelo menos duas linhas de contexto para a operação de remendo apropriada. </para></listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Opções para Ignorar</guilabel -></term> -<listitem -><para ->Verifique aqui as mudanças que não devem ser consideradas como diferenças ao gerar o remendo. </para -></listitem> +<term><guilabel>Opções para Ignorar</guilabel></term> +<listitem><para>Verifique aqui as mudanças que não devem ser consideradas como diferenças ao gerar o remendo. </para></listitem> </varlistentry> </variablelist> -<para ->Após configurar o formato de saída, o &cervisia; gera o remendo e exibe o diálogo <guilabel ->Salvar Como</guilabel ->. Insira neste diálogo o nome do arquivo e localização do arquivo de remendo. </para> +<para>Após configurar o formato de saída, o &cervisia; gera o remendo e exibe o diálogo <guilabel>Salvar Como</guilabel>. Insira neste diálogo o nome do arquivo e localização do arquivo de remendo. </para> </sect1> <sect1 id="annotate"> -<title ->Procurando uma Visão Anotada de um Arquivo</title> - -<para ->Com o comando <command ->cvs annotate</command ->, o &CVS; oferece a possibilidade de ver - para cada linha no arquivo - quem modificou uma linha mais recentemente. Esta visão é útil para encontrar quem introduziu uma mudança no comportamento de um programa ou quem deve ser questionado sobre alguma mudança ou erro no código. </para> - -<para ->O &cervisia; lhe dá o acesso a este recurso, mas ele posteriormente enriquece as informações de uma maneira interativa. Você obtém uma visão anotada selecionando <menuchoice -><guimenu ->Ver</guimenu -><guimenuitem ->Anotação...</guimenuitem -></menuchoice ->. Outra possibilidade é pressionar o botão <guilabel ->Anotação</guilabel -> no <link linkend="browsinglogs" ->Diálogo de navegação de registro</link ->. Em <xref linkend="screenshot-annotate"/> você pode ver uma captura de tela do diálogo. </para> +<title>Procurando uma Visão Anotada de um Arquivo</title> + +<para>Com o comando <command>cvs annotate</command>, o &CVS; oferece a possibilidade de ver - para cada linha no arquivo - quem modificou uma linha mais recentemente. Esta visão é útil para encontrar quem introduziu uma mudança no comportamento de um programa ou quem deve ser questionado sobre alguma mudança ou erro no código. </para> + +<para>O &cervisia; lhe dá o acesso a este recurso, mas ele posteriormente enriquece as informações de uma maneira interativa. Você obtém uma visão anotada selecionando <menuchoice><guimenu>Ver</guimenu><guimenuitem>Anotação...</guimenuitem></menuchoice>. Outra possibilidade é pressionar o botão <guilabel>Anotação</guilabel> no <link linkend="browsinglogs">Diálogo de navegação de registro</link>. Em <xref linkend="screenshot-annotate"/> você pode ver uma captura de tela do diálogo. </para> <figure id="screenshot-annotate" float="1"> -<title ->Uma captura de tela do diálogo de anotação do &cervisia;</title> +<title>Uma captura de tela do diálogo de anotação do &cervisia;</title> <mediaobject> -<imageobject -><imagedata format="PNG" fileref="annotate.png"/></imageobject> -<textobject -><phrase ->Uma captura de tela do diálogo de anotação do &cervisia;</phrase -></textobject> +<imageobject><imagedata format="PNG" fileref="annotate.png"/></imageobject> +<textobject><phrase>Uma captura de tela do diálogo de anotação do &cervisia;</phrase></textobject> </mediaobject> </figure> -<para ->No diálogo de anotação, você pode ver em uma janela a última versão do arquivo selecionado (ou a versão da revisão "A", no caso de você ter lançado o diálogo de anotação a partir do <link linkend="browsinglogs" ->Diálogo do navegador de registro</link ->). Nas colunas antes do texto, você obtém algumas informações relacionadas à última mudança em cada linha. Na primeira coluna o número da linha é mostrado. Na segunda coluna você vê o nome do autor e o número da revisão. Finalmente, na terceira coluna você vê o conteúdo atual da linha. </para> +<para>No diálogo de anotação, você pode ver em uma janela a última versão do arquivo selecionado (ou a versão da revisão "A", no caso de você ter lançado o diálogo de anotação a partir do <link linkend="browsinglogs">Diálogo do navegador de registro</link>). Nas colunas antes do texto, você obtém algumas informações relacionadas à última mudança em cada linha. Na primeira coluna o número da linha é mostrado. Na segunda coluna você vê o nome do autor e o número da revisão. Finalmente, na terceira coluna você vê o conteúdo atual da linha. </para> -<para ->Conseqüentemente, quando uma determinada linha parecer estranha para você ou você encontrar um erro nela, você pode imediatamente ver quem é o responsável por aquela linha. Mas não é só isso, você pode também encontrar <emphasis ->porque</emphasis -> aquela linha foi mudada. Para isso, mova o cursor sobre o número de revisão respectivo. Então uma dica aparecerá que mostra a mensagem de log e a data da mudança. </para> +<para>Conseqüentemente, quando uma determinada linha parecer estranha para você ou você encontrar um erro nela, você pode imediatamente ver quem é o responsável por aquela linha. Mas não é só isso, você pode também encontrar <emphasis>porque</emphasis> aquela linha foi mudada. Para isso, mova o cursor sobre o número de revisão respectivo. Então uma dica aparecerá que mostra a mensagem de log e a data da mudança. </para> </sect1> <sect1 id="browsinglogs"> -<title ->Navegando nos Registros do &CVS;</title> - -<para ->Quando você marca um arquivo na visão principal e seleciona <guimenuitem ->Navegar Registro...</guimenuitem -> a partir do menu <guimenu ->Ver</guimenu -> ou clique direito no arquivo marcado e seleciona <guimenuitem ->Navegar Registro...</guimenuitem -> a partir do menu de contexto, o diálogo <guilabel ->Registro do CVS</guilabel -> é mostrado (se você marcar mais de um, nada acontexe, uma vez que o &cervisia; somente pode gerar e analisar o registro de um arquivo por vez). Este diálogo oferece funcionalidades que vão além da visualização do histórico do arquivo. Usando-o como uma navegador de versão você pode: </para> +<title>Navegando nos Registros do &CVS;</title> + +<para>Quando você marca um arquivo na visão principal e seleciona <guimenuitem>Navegar Registro...</guimenuitem> a partir do menu <guimenu>Ver</guimenu> ou clique direito no arquivo marcado e seleciona <guimenuitem>Navegar Registro...</guimenuitem> a partir do menu de contexto, o diálogo <guilabel>Registro do CVS</guilabel> é mostrado (se você marcar mais de um, nada acontexe, uma vez que o &cervisia; somente pode gerar e analisar o registro de um arquivo por vez). Este diálogo oferece funcionalidades que vão além da visualização do histórico do arquivo. Usando-o como uma navegador de versão você pode: </para> <itemizedlist> -<listitem -><para ->Ver a revisão, autor, data, ramificação, mensagem de envio, e tags para cada versão do arquivo marcado. </para -></listitem> +<listitem><para>Ver a revisão, autor, data, ramificação, mensagem de envio, e tags para cada versão do arquivo marcado. </para></listitem> -<listitem -><para ->Ver uma representação gráfica em árvore mostrando a ramificação e tags do arquivo marcado. </para -></listitem> +<listitem><para>Ver uma representação gráfica em árvore mostrando a ramificação e tags do arquivo marcado. </para></listitem> -<listitem -><para ->Ver qualquer versão do arquivo marcado (com o aplicativo padrão). </para -></listitem> +<listitem><para>Ver qualquer versão do arquivo marcado (com o aplicativo padrão). </para></listitem> -<listitem -><para ->Obter uma visão anotada de qualquer versão do arquivo marcado. </para -></listitem> +<listitem><para>Obter uma visão anotada de qualquer versão do arquivo marcado. </para></listitem> -<listitem -><para ->Ver as diferenças entre quaisquer par de versões do arquivo marcado, incluindo pares com a versão da cópia de trabalho atual do arquivo marcado. </para -></listitem> +<listitem><para>Ver as diferenças entre quaisquer par de versões do arquivo marcado, incluindo pares com a versão da cópia de trabalho atual do arquivo marcado. </para></listitem> -<listitem -><para ->Criar remendos contendo as diferenças entre quaisquer par de versões do arquivo marcado, incluindo pares com a versão da cópia de trabalho atual do arquivo marcado. </para -></listitem> +<listitem><para>Criar remendos contendo as diferenças entre quaisquer par de versões do arquivo marcado, incluindo pares com a versão da cópia de trabalho atual do arquivo marcado. </para></listitem> </itemizedlist> <figure float="1"> -<title ->Uma captura de tela do diálogo de navegação de registros do &cervisia;</title> +<title>Uma captura de tela do diálogo de navegação de registros do &cervisia;</title> <mediaobject> -<imageobject -><imagedata format="PNG" fileref="logtree.png"/></imageobject> -<textobject -><phrase ->Uma captura de tela do diálogo de navegação de registros do &cervisia;</phrase -></textobject> +<imageobject><imagedata format="PNG" fileref="logtree.png"/></imageobject> +<textobject><phrase>Uma captura de tela do diálogo de navegação de registros do &cervisia;</phrase></textobject> </mediaobject> </figure> -<para ->Você pode selecionar ver o histórico fornecido pelo comando <command ->cvs log</command -> (<guilabel ->Saída do CVS</guilabel ->), como uma <guilabel ->Árvore</guilabel -> ou na forma de <guilabel ->Lista</guilabel ->. O que você vai preferir, claro, é apenas um problema de gosto e depende de que informação você está interessado. A árvore é uma representação intuitiva do que foi feito em diferentes versões pelos autores. Como dica, você pode ver de acordo com suas mensagens de registro. A lista é de natureza linear e não oferece uma visão imediata das ramificações. Por outro lado, ela concentra mais informações relevantes em menor espaço de tela, citando a hora de cada mudança do arquivo e a primeira parte da mensagem de registro. As informações de saída do CVS são completas, mas longas e difíceis de ler. Para minimizar estes problemas, você pode buscar o texto na saída do CVS, pressionando o botão <guibutton ->Procurar...</guibutton ->. </para> - -<para ->Para obter mais informações sobre determinada revisão, você pode clicar nela tanto na visão em lista como na em árvore. Os campos no meio do diálogo são então preenchidos com as informações completas fornecidas pelo <command ->cvs log</command ->. Você pode marcar duas revisões, chamadas "A" e "B", que forem relevantes para fazer uso de outros recursos oferecidos pelos botões. A revisão "A" pode ser escolhida com o botão esquerdo do mouse, a revisão "B" com o do meio. Na visão em lista, você pode também navegar com suas teclas de cursor. Para marcar revisões "A" e "B", use as teclas de atalho <keycombo -><keycap ->Ctrl</keycap -><keycap ->A</keycap -></keycombo ->, <keycombo -><keycap ->Ctrl</keycap -><keycap ->B</keycap -></keycombo ->, respectivamente. Usando a visão de <guilabel ->Saída do CVS</guilabel ->, você pode clicar em <guilabel ->Selecionar para revisão A</guilabel -> e <guilabel ->Selecionar para revisão B</guilabel -> para marcar as revisões. </para> - -<para ->Se você pressionar o botão <guibutton ->Anotação</guibutton ->, você obterá um diálogo mostrando o texto do arquivo quando na revisão marcada como "A". Cada linha é precedida com a informação sobre quem editou a linha pela última vez, e em que revisão isto aconteceu. Você pode obter mais informações sobre as versões das visões anotadas em <xref linkend="annotate"/>. </para> - -<para ->Se você pressionar o botão <guibutton ->Diferença</guibutton ->, uma chamada <command ->cvs diff</command -> é enviada e você obterá um diálogo no qual todas as modificações entre as duas revisões marcadas serão mostradas. Se você marcar a revisão "A", mas não a revisão "B", o &cervisia; irá gerar as modificações entre a versão do arquivo marcada como revisão "A" e a versão da cópia de trabalho do arquivo. Isto permite ver as diferenças entre sua versão do arquivo e qualquer versão disponível no &CVS;. Para tornar fácil ver as mudanças, cores diferentes são usadas para marcar linhas que foram adicionadas, removidas ou simplesmente mudadas. Você pode obter mais informações sobre a visão das diferenças em <xref linkend="diff"/>. </para> - -<para ->Se você pressionar o botão <guibutton ->Criar Remendo...</guibutton ->, você obterá um diálogo no qual você pode configurar as opções de formato para gerar um arquivo conterá todas as modificações entre as duas revisões marcadas que estão sendo exibidas. Se você marcar a revisão "A", mas não a revisão "B", o &cervisia; irá gerar as modificações entre a revisão marcada como "A" e a versão da cópia de trabalho do arquivo. Isto permite gera um remendo, ou arquivo de diferenças, entre sua versão do arquivo e qualquer versão disponível no &CVS;. Após configurar o formato do remendo no diálogo, e pressionar <guibutton ->OK</guibutton ->, um comando <command ->cvs diff</command -> é enviado para gerar as diferenças do arquivo. Um diálogo <guilabel ->Salvar Como</guilabel -> aparecerá. Insira o nome do arquivo e localização do arquivo de remendo queo &cervisia; gerou, para salvá-lo. Você pode obter mais informações sobre como criar remendos, e sobre as opções de formato do remendo em <xref linkend="creatingpatches"/>. </para> - -<para ->Se você pressionar o botão <guibutton ->Ver</guibutton ->, o &cervisia; irá recuperar a revisão marcada como "A" e a exibirá usando o aplicativo padrão para este tipo de arquivo. </para> - -<para ->Pressione o botão <guibutton ->Fechar</guibutton -> para deixar o diálogo e retornar à visão principal. </para> - - -<para ->Para gerar o registro que é a base para o diálogo <guilabel ->Registro do CVS</guilabel ->, o &cervisia; envia o seguinte comando: </para> +<para>Você pode selecionar ver o histórico fornecido pelo comando <command>cvs log</command> (<guilabel>Saída do CVS</guilabel>), como uma <guilabel>Árvore</guilabel> ou na forma de <guilabel>Lista</guilabel>. O que você vai preferir, claro, é apenas um problema de gosto e depende de que informação você está interessado. A árvore é uma representação intuitiva do que foi feito em diferentes versões pelos autores. Como dica, você pode ver de acordo com suas mensagens de registro. A lista é de natureza linear e não oferece uma visão imediata das ramificações. Por outro lado, ela concentra mais informações relevantes em menor espaço de tela, citando a hora de cada mudança do arquivo e a primeira parte da mensagem de registro. As informações de saída do CVS são completas, mas longas e difíceis de ler. Para minimizar estes problemas, você pode buscar o texto na saída do CVS, pressionando o botão <guibutton>Procurar...</guibutton>. </para> + +<para>Para obter mais informações sobre determinada revisão, você pode clicar nela tanto na visão em lista como na em árvore. Os campos no meio do diálogo são então preenchidos com as informações completas fornecidas pelo <command>cvs log</command>. Você pode marcar duas revisões, chamadas "A" e "B", que forem relevantes para fazer uso de outros recursos oferecidos pelos botões. A revisão "A" pode ser escolhida com o botão esquerdo do mouse, a revisão "B" com o do meio. Na visão em lista, você pode também navegar com suas teclas de cursor. Para marcar revisões "A" e "B", use as teclas de atalho <keycombo><keycap>Ctrl</keycap><keycap>A</keycap></keycombo>, <keycombo><keycap>Ctrl</keycap><keycap>B</keycap></keycombo>, respectivamente. Usando a visão de <guilabel>Saída do CVS</guilabel>, você pode clicar em <guilabel>Selecionar para revisão A</guilabel> e <guilabel>Selecionar para revisão B</guilabel> para marcar as revisões. </para> + +<para>Se você pressionar o botão <guibutton>Anotação</guibutton>, você obterá um diálogo mostrando o texto do arquivo quando na revisão marcada como "A". Cada linha é precedida com a informação sobre quem editou a linha pela última vez, e em que revisão isto aconteceu. Você pode obter mais informações sobre as versões das visões anotadas em <xref linkend="annotate"/>. </para> + +<para>Se você pressionar o botão <guibutton>Diferença</guibutton>, uma chamada <command>cvs diff</command> é enviada e você obterá um diálogo no qual todas as modificações entre as duas revisões marcadas serão mostradas. Se você marcar a revisão "A", mas não a revisão "B", o &cervisia; irá gerar as modificações entre a versão do arquivo marcada como revisão "A" e a versão da cópia de trabalho do arquivo. Isto permite ver as diferenças entre sua versão do arquivo e qualquer versão disponível no &CVS;. Para tornar fácil ver as mudanças, cores diferentes são usadas para marcar linhas que foram adicionadas, removidas ou simplesmente mudadas. Você pode obter mais informações sobre a visão das diferenças em <xref linkend="diff"/>. </para> + +<para>Se você pressionar o botão <guibutton>Criar Remendo...</guibutton>, você obterá um diálogo no qual você pode configurar as opções de formato para gerar um arquivo conterá todas as modificações entre as duas revisões marcadas que estão sendo exibidas. Se você marcar a revisão "A", mas não a revisão "B", o &cervisia; irá gerar as modificações entre a revisão marcada como "A" e a versão da cópia de trabalho do arquivo. Isto permite gera um remendo, ou arquivo de diferenças, entre sua versão do arquivo e qualquer versão disponível no &CVS;. Após configurar o formato do remendo no diálogo, e pressionar <guibutton>OK</guibutton>, um comando <command>cvs diff</command> é enviado para gerar as diferenças do arquivo. Um diálogo <guilabel>Salvar Como</guilabel> aparecerá. Insira o nome do arquivo e localização do arquivo de remendo queo &cervisia; gerou, para salvá-lo. Você pode obter mais informações sobre como criar remendos, e sobre as opções de formato do remendo em <xref linkend="creatingpatches"/>. </para> + +<para>Se você pressionar o botão <guibutton>Ver</guibutton>, o &cervisia; irá recuperar a revisão marcada como "A" e a exibirá usando o aplicativo padrão para este tipo de arquivo. </para> + +<para>Pressione o botão <guibutton>Fechar</guibutton> para deixar o diálogo e retornar à visão principal. </para> + + +<para>Para gerar o registro que é a base para o diálogo <guilabel>Registro do CVS</guilabel>, o &cervisia; envia o seguinte comando: </para> <para> -<screen -><command ->cvs log <replaceable ->nome do arquivo</replaceable -></command -></screen> +<screen><command>cvs log <replaceable>nome do arquivo</replaceable></command></screen> </para> </sect1> <sect1 id="browsinghistory"> -<title ->Navegando o Histórico</title> +<title>Navegando o Histórico</title> -<para ->Se o repositório usado possui o logging habilitado o &cervisia; pode lhe apresentar um histórico de certos eventos como verificações, envios, rtags, atualizações e versões. Escolha <guimenuitem ->Histórico</guimenuitem -> no menu <guimenu ->Ver</guimenu ->, e o &cervisia; enviará o comando </para> +<para>Se o repositório usado possui o logging habilitado o &cervisia; pode lhe apresentar um histórico de certos eventos como verificações, envios, rtags, atualizações e versões. Escolha <guimenuitem>Histórico</guimenuitem> no menu <guimenu>Ver</guimenu>, e o &cervisia; enviará o comando </para> <para> -<screen -><command ->cvs history -e -a</command -></screen> +<screen><command>cvs history -e -a</command></screen> </para> -<note -><para ->Isto atualiza o arquivo completo de registro do servidor, incluindo uma lista de eventos para todos os usuários e todos os módulos. Isto pode ser uma grande quantidade de dados! </para -></note> +<note><para>Isto atualiza o arquivo completo de registro do servidor, incluindo uma lista de eventos para todos os usuários e todos os módulos. Isto pode ser uma grande quantidade de dados! </para></note> -<para ->Agora você pode ver a lista de eventos, ordenada por data. Na segunda coluna, o tipo de evento é mostrado: </para> +<para>Agora você pode ver a lista de eventos, ordenada por data. Na segunda coluna, o tipo de evento é mostrado: </para> <itemizedlist> -<listitem -><para ->Verificação - O usuário que é exibido na coluna 'Autor' fez uma verificação de um módulo </para -></listitem> - -<listitem -><para ->Tag - Um usuário fez uso do comando <command ->cvs rtag</command ->. Observe que o uso do <command ->cvs tag</command -> (como feito pelo comando <menuchoice -><guimenu ->Avançado</guimenu -><guimenuitem ->Tag/Repositório...</guimenuitem -></menuchoice -> do &cervisia;) não é gravado no banco de dados de histórico. Isto ocorre por razões históricas (veja a <acronym ->FAQ</acronym -> do &CVS;). </para -></listitem> - -<listitem -><para ->Versão - Um usuário lançou a versão de um módulo. Atualmente, este comando é raramente usado e não tem muito valor. </para -></listitem> - -<listitem -><para ->Atualizado, Excluído - Um usuário fez uma atualização de um arquivo que foi excluído do repositório. Como conseqüência, o arquivo foi excluído em sua cópia local. </para -></listitem> - -<listitem -><para ->Atualizado, Copiado - Um usuário fez uma atualização de um arquivo. Uma nova versão foi copiada para a cópia de trabalho. </para -></listitem> - -<listitem -><para ->Atualizado, Mesclado - Um usuário fez uma atualização de um arquivo. As modificações na versão do arquivo no repositório foram mescladas em sua cópia de trabalho. </para -></listitem> - -<listitem -><para ->Atualizado, Conflito - Um usuário fez uma atualização de um arquivo, e um conflito com suas modificações foi detectado. </para -></listitem> - -<listitem -><para ->Enviado, Modificado - Um usuário enviou um arquivo modificado. </para -></listitem> - -<listitem -><para ->Enviado, Adicionado - Um usuário adicionou um arquivo e enviou-o. </para -></listitem> - -<listitem -><para ->Enviado, Removido - Um usuário removeu um arquivo e enviou-o. </para -></listitem> +<listitem><para>Verificação - O usuário que é exibido na coluna 'Autor' fez uma verificação de um módulo </para></listitem> + +<listitem><para>Tag - Um usuário fez uso do comando <command>cvs rtag</command>. Observe que o uso do <command>cvs tag</command> (como feito pelo comando <menuchoice><guimenu>Avançado</guimenu><guimenuitem>Tag/Repositório...</guimenuitem></menuchoice> do &cervisia;) não é gravado no banco de dados de histórico. Isto ocorre por razões históricas (veja a <acronym>FAQ</acronym> do &CVS;). </para></listitem> + +<listitem><para>Versão - Um usuário lançou a versão de um módulo. Atualmente, este comando é raramente usado e não tem muito valor. </para></listitem> + +<listitem><para>Atualizado, Excluído - Um usuário fez uma atualização de um arquivo que foi excluído do repositório. Como conseqüência, o arquivo foi excluído em sua cópia local. </para></listitem> + +<listitem><para>Atualizado, Copiado - Um usuário fez uma atualização de um arquivo. Uma nova versão foi copiada para a cópia de trabalho. </para></listitem> + +<listitem><para>Atualizado, Mesclado - Um usuário fez uma atualização de um arquivo. As modificações na versão do arquivo no repositório foram mescladas em sua cópia de trabalho. </para></listitem> + +<listitem><para>Atualizado, Conflito - Um usuário fez uma atualização de um arquivo, e um conflito com suas modificações foi detectado. </para></listitem> + +<listitem><para>Enviado, Modificado - Um usuário enviou um arquivo modificado. </para></listitem> + +<listitem><para>Enviado, Adicionado - Um usuário adicionou um arquivo e enviou-o. </para></listitem> + +<listitem><para>Enviado, Removido - Um usuário removeu um arquivo e enviou-o. </para></listitem> </itemizedlist> <figure id="screenshot-history" float="1"> -<title ->Um captura de tela do diálogo de histórico do &cervisia;</title> +<title>Um captura de tela do diálogo de histórico do &cervisia;</title> <mediaobject> -<imageobject -><imagedata format="PNG" fileref="history.png"/></imageobject> -<textobject -><phrase ->Um captura de tela do diálogo de histórico do &cervisia;</phrase -></textobject> +<imageobject><imagedata format="PNG" fileref="history.png"/></imageobject> +<textobject><phrase>Um captura de tela do diálogo de histórico do &cervisia;</phrase></textobject> </mediaobject> </figure> -<para ->Você pode ordenar a lista por outro critério simplesmente clicando no respectivo cabeçalho da coluna. Para ordenar as entradas do histórico da maneira que você deseja, existem várias opções de filtros ativadas pelas caixas de checagem: </para> +<para>Você pode ordenar a lista por outro critério simplesmente clicando no respectivo cabeçalho da coluna. Para ordenar as entradas do histórico da maneira que você deseja, existem várias opções de filtros ativadas pelas caixas de checagem: </para> <itemizedlist> -<listitem -><para ->Mostrar eventos de envio - mostrar envios</para -></listitem> -<listitem -><para ->Mostrar eventos de verificação - mostrar verificações</para -></listitem> -<listitem -><para ->Mostrar eventos de tag - mostrar tags</para -></listitem> -<listitem -><para ->Mostrar outros eventos - mostrar eventos não incluídos acima</para -></listitem> -<listitem -><para ->Somente usuário - mostrar somente eventos causados por um determinado usuário</para -></listitem> -<listitem -><para ->Somente nomes de arquivo correspondentes - filtra os nomes de arquivo por uma expressão regular</para -></listitem> -<listitem -><para ->Somente nomes de pasta correspondentes - filtra os nomes de pasta por uma expressão regular</para -></listitem> +<listitem><para>Mostrar eventos de envio - mostrar envios</para></listitem> +<listitem><para>Mostrar eventos de verificação - mostrar verificações</para></listitem> +<listitem><para>Mostrar eventos de tag - mostrar tags</para></listitem> +<listitem><para>Mostrar outros eventos - mostrar eventos não incluídos acima</para></listitem> +<listitem><para>Somente usuário - mostrar somente eventos causados por um determinado usuário</para></listitem> +<listitem><para>Somente nomes de arquivo correspondentes - filtra os nomes de arquivo por uma expressão regular</para></listitem> +<listitem><para>Somente nomes de pasta correspondentes - filtra os nomes de pasta por uma expressão regular</para></listitem> </itemizedlist> -<para ->Caracteres especiais reconhecidos pelas expressões regulares de correspondência são: </para> +<para>Caracteres especiais reconhecidos pelas expressões regulares de correspondência são: </para> <itemizedlist> -<listitem -><para -><literal ->x*</literal -> corresponde a qualquer número de ocorrências do caracter <literal ->x</literal ->. </para -></listitem> - -<listitem -><para -><literal ->x+</literal -> corresponde a uma ou mais ocorrências do caracter <literal ->x</literal ->. </para -></listitem> - -<listitem -><para -><literal ->x?</literal -> corresponde a zero ou uma ocorrência do caracter <literal ->x</literal ->. </para -></listitem> - -<listitem -><para -><literal ->^</literal -> corresponde ao início do string. </para -></listitem> - -<listitem -><para -><literal ->$</literal -> corresponde ao final do string. </para -></listitem> - -<listitem -><para -><literal ->[a-cx-z]</literal -> corresponde ao conjunto de caracteres, ⪚ aqui a conjunto consiste de a,b,c,x,y,z. </para -></listitem> +<listitem><para><literal>x*</literal> corresponde a qualquer número de ocorrências do caracter <literal>x</literal>. </para></listitem> + +<listitem><para><literal>x+</literal> corresponde a uma ou mais ocorrências do caracter <literal>x</literal>. </para></listitem> + +<listitem><para><literal>x?</literal> corresponde a zero ou uma ocorrência do caracter <literal>x</literal>. </para></listitem> + +<listitem><para><literal>^</literal> corresponde ao início do string. </para></listitem> + +<listitem><para><literal>$</literal> corresponde ao final do string. </para></listitem> + +<listitem><para><literal>[a-cx-z]</literal> corresponde ao conjunto de caracteres, ⪚ aqui a conjunto consiste de a,b,c,x,y,z. </para></listitem> </itemizedlist> @@ -2072,477 +839,164 @@ Mudanças no repositório </chapter> <chapter id="advancedusage"> -<title ->Uso Avançado</title> +<title>Uso Avançado</title> <sect1 id="updatingto"> -<title ->Atualizando para Tag, Ramificação ou Data</title> +<title>Atualizando para Tag, Ramificação ou Data</title> -<para ->Ramificações de um módulo são versões paralelas deste módulo. Um bom exemplo prático do uso deste recurso é o lançamento de um projeto de software. Após uma versão principal, existem erros no código que devem ser concertados, mas as pessoas desejam adicionar novos recursos ao aplicativo também. É muito difícil fazer as duas coisas ao mesmo tempo porque novos recursos normalmente introduzem novos erros, tornando difícil rastrear os antigos. Para resolver este dilema, o &CVS; permite que você crie uma versão paralela, que nós chamaremos de "ramificação da versão estável", onde você pode somente adicionar correções de erro, deixando a ramificação principal (HEAD) aberta para adição de novos recursos. </para> +<para>Ramificações de um módulo são versões paralelas deste módulo. Um bom exemplo prático do uso deste recurso é o lançamento de um projeto de software. Após uma versão principal, existem erros no código que devem ser concertados, mas as pessoas desejam adicionar novos recursos ao aplicativo também. É muito difícil fazer as duas coisas ao mesmo tempo porque novos recursos normalmente introduzem novos erros, tornando difícil rastrear os antigos. Para resolver este dilema, o &CVS; permite que você crie uma versão paralela, que nós chamaremos de "ramificação da versão estável", onde você pode somente adicionar correções de erro, deixando a ramificação principal (HEAD) aberta para adição de novos recursos. </para> -<para ->Tags são usadas para marcar a versão de um projeto. O &CVS; estampa uma versão de cada arquivo com a tag, de modo que quando você importar ou atualizar para uma tag específica, você obterá sempre as mesmas versões de arquivo. Por outro lado, ao contrário das ramificações, tags não são dinâmicas: você não pode desenvolver uma tag. Tags são úteis para marcar lançamentos, grandes mudanças no código, &etc;. </para> +<para>Tags são usadas para marcar a versão de um projeto. O &CVS; estampa uma versão de cada arquivo com a tag, de modo que quando você importar ou atualizar para uma tag específica, você obterá sempre as mesmas versões de arquivo. Por outro lado, ao contrário das ramificações, tags não são dinâmicas: você não pode desenvolver uma tag. Tags são úteis para marcar lançamentos, grandes mudanças no código, &etc;. </para> -<para ->Quando você está desenvolvendo ou seguindo o desenvolvimento de um projeto de software, você não trabalha necessariamente com a ramificação principal sempre. Após um lançamento, você pode desejar permanecer com a ramificação do lançamento por um tempo, para verificar sua relativa estabilidade, corrigir erros, traduzir as fontes, &etc;. Para fazer tudo isto, você deve atualizar para a ramificação de lançamento. Todos os seus arquivos serão atualizados para o última versão dos arquivos na ramificação. Após a atualização, todos os seus novos envios serão remetidos para a nova ramificação. </para> +<para>Quando você está desenvolvendo ou seguindo o desenvolvimento de um projeto de software, você não trabalha necessariamente com a ramificação principal sempre. Após um lançamento, você pode desejar permanecer com a ramificação do lançamento por um tempo, para verificar sua relativa estabilidade, corrigir erros, traduzir as fontes, &etc;. Para fazer tudo isto, você deve atualizar para a ramificação de lançamento. Todos os seus arquivos serão atualizados para o última versão dos arquivos na ramificação. Após a atualização, todos os seus novos envios serão remetidos para a nova ramificação. </para> -<para ->Além disso, se você deseja rastrear um erro que foi reportado em uma versão com tag anterior, o &CVS; oferece a possibilidade de recuperar o software como ele foi lançado, atualizado para a tag. Ao lado disso, se você deseja buscar uma versão passada do seu projeto, você pode atualizar sua cópia de trabalho para uma data específica. Isto pode ser útil se um erro foi introduzido no projeto entre dois lançamentos, e você tem uma idéia de quando ele ocorreu. Quando você atualiza para uma data ou tag, as versões de seus arquivos serão as mesmas das versões naquela data específica ou das versões estampadas pela tag. </para> +<para>Além disso, se você deseja rastrear um erro que foi reportado em uma versão com tag anterior, o &CVS; oferece a possibilidade de recuperar o software como ele foi lançado, atualizado para a tag. Ao lado disso, se você deseja buscar uma versão passada do seu projeto, você pode atualizar sua cópia de trabalho para uma data específica. Isto pode ser útil se um erro foi introduzido no projeto entre dois lançamentos, e você tem uma idéia de quando ele ocorreu. Quando você atualiza para uma data ou tag, as versões de seus arquivos serão as mesmas das versões naquela data específica ou das versões estampadas pela tag. </para> -<warning -><para ->Antes de atualizar para uma ramificação diferente ou tag, certifique-se de que você enviou todas as suas mudanças para a ramificação que você está trabalhando. Se você não estiver pronto para enviar suas mudanças, mas não quer descartá-las, não atualize para a nova ramificação, ou perderá todo o seu trabalho. Como uma alternativa, você pode fazer uma nova <link linkend="checkingout" ->verificação</link ->, para trabalhar em paralelo com ambas as versões. </para -></warning> +<warning><para>Antes de atualizar para uma ramificação diferente ou tag, certifique-se de que você enviou todas as suas mudanças para a ramificação que você está trabalhando. Se você não estiver pronto para enviar suas mudanças, mas não quer descartá-las, não atualize para a nova ramificação, ou perderá todo o seu trabalho. Como uma alternativa, você pode fazer uma nova <link linkend="checkingout">verificação</link>, para trabalhar em paralelo com ambas as versões. </para></warning> <figure id="screenshot-updatetag" float="1"> -<title ->Uma captura de tela do diálogo de atualização de tag do &cervisia;</title> +<title>Uma captura de tela do diálogo de atualização de tag do &cervisia;</title> <mediaobject> -<imageobject -><imagedata format="PNG" fileref="updatetag.png"/></imageobject> -<textobject -><phrase ->Uma captura de tela do diálogo de atualização de tag do &cervisia;</phrase -></textobject> +<imageobject><imagedata format="PNG" fileref="updatetag.png"/></imageobject> +<textobject><phrase>Uma captura de tela do diálogo de atualização de tag do &cervisia;</phrase></textobject> </mediaobject> </figure> <variablelist> <varlistentry> -<term -><guilabel ->Atualizar para ramificação</guilabel -></term> -<listitem -><para ->Selecione esta opção para atualizar para uma ramificação. Insira o nome da ramificação na caixa de texto combinada (ou pressione o botão <guilabel ->Obter Lista</guilabel -> para recuperar a lista de ramificações a partir do servidor &CVS;, e selecione a que você deseja na lista combinada). </para -></listitem> +<term><guilabel>Atualizar para ramificação</guilabel></term> +<listitem><para>Selecione esta opção para atualizar para uma ramificação. Insira o nome da ramificação na caixa de texto combinada (ou pressione o botão <guilabel>Obter Lista</guilabel> para recuperar a lista de ramificações a partir do servidor &CVS;, e selecione a que você deseja na lista combinada). </para></listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Atualizar para tag</guilabel -></term> -<listitem -><para ->Selecione esta opção para atualizar para uma tag. Insira o nome da tag na caixa de texto combinada (ou pressione o botão <guilabel ->Obter Lista</guilabel -> para recuperar a lista de ramificações a partir do servidor &CVS;, e selecione a que você deseja na lista combinada). </para -></listitem> +<term><guilabel>Atualizar para tag</guilabel></term> +<listitem><para>Selecione esta opção para atualizar para uma tag. Insira o nome da tag na caixa de texto combinada (ou pressione o botão <guilabel>Obter Lista</guilabel> para recuperar a lista de ramificações a partir do servidor &CVS;, e selecione a que você deseja na lista combinada). </para></listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Atualizar para data</guilabel -></term> -<listitem -><para ->Selecione esta opção para atualizar para uma data. No campo abaixo, você pode inserir uma grande variedade de formatos de data. Um formato possível é <literal ->aaaa-mm-dd</literal -> onde <literal ->aaaa</literal -> é o ano, <literal ->mm</literal -> é o mês (numérico) e <literal ->dd</literal -> é o dia. Alternativas são algumas frases em inglês como <literal ->yesterday</literal -> ou <literal ->2 weeks ago</literal ->. </para -></listitem> +<term><guilabel>Atualizar para data</guilabel></term> +<listitem><para>Selecione esta opção para atualizar para uma data. No campo abaixo, você pode inserir uma grande variedade de formatos de data. Um formato possível é <literal>aaaa-mm-dd</literal> onde <literal>aaaa</literal> é o ano, <literal>mm</literal> é o mês (numérico) e <literal>dd</literal> é o dia. Alternativas são algumas frases em inglês como <literal>yesterday</literal> ou <literal>2 weeks ago</literal>. </para></listitem> </varlistentry> </variablelist> -<note -><para ->Atualizar para uma tag ou data faz com que a cópia de trabalho seja 'pregada', &ie;, você não pode enviar futuras modificações nestes arquivos (ao menos que a tag seja uma tag de ramificação). Para retornar à ramificação principal, use o ítem de menu <menuchoice -><guimenu ->Avançado</guimenu -><guimenuitem ->Atualizar para HEAD</guimenuitem -></menuchoice ->. </para -></note> - -<para ->O comando enviado para atualizar para uma ramificação ou tag é: <screen -><command ->cvs update -r <replaceable ->tag</replaceable -></command -></screen> +<note><para>Atualizar para uma tag ou data faz com que a cópia de trabalho seja 'pregada', &ie;, você não pode enviar futuras modificações nestes arquivos (ao menos que a tag seja uma tag de ramificação). Para retornar à ramificação principal, use o ítem de menu <menuchoice><guimenu>Avançado</guimenu><guimenuitem>Atualizar para HEAD</guimenuitem></menuchoice>. </para></note> + +<para>O comando enviado para atualizar para uma ramificação ou tag é: <screen><command>cvs update -r <replaceable>tag</replaceable></command></screen> </para> -<para ->O comando enviado para atualizar para uma data é: <screen -><command ->cvs update -D <replaceable ->data</replaceable -></command -></screen> +<para>O comando enviado para atualizar para uma data é: <screen><command>cvs update -D <replaceable>data</replaceable></command></screen> </para> -<para ->O comando enviado para atualizar para a ramificação principal (HEAD) é: <screen -><command ->cvs update <option ->-A</option -></command -></screen> +<para>O comando enviado para atualizar para a ramificação principal (HEAD) é: <screen><command>cvs update <option>-A</option></command></screen> </para> </sect1> <sect1 id="taggingbranching"> -<title ->Tags e Ramificações</title> - -<para ->Nós discutiremos aqui somente aspectos de tags e ramificações. Se você é somente um <emphasis ->usuário</emphasis ->, e não o administrador do repositório, você provavelmente não será confrontado com o problema. Se no entanto você é seu próprio administrador, você deve primeiro ler sobre problemas não técnicos que acompanham as ramificações, para ter uma idéia de quanto tempo se gasta e quantos erros ocorrem por causa da manutenção de diferentes ramificações de um projeto. O apêndice inclui algumas referências sobre este tópico. </para> - -<para ->Tag simples é algo que usualmente é feito quando uma revisão é executada, de modo que você possa a qualquer momento facilmente voltar para o estado de um projeto no tempo. Tags comumente fornecem um nome consistindo do nome do projeto e o número de revisão. Por exemplo, o &cervisia; 1.0 está disponível sob a tag <literal ->CERVISIA_1_0</literal ->. O &cervisia; força regras estritas do &CVS; sobre o que constitui um nome válido de tag. Ele deve iniciar com uma letra e pode conter letras, dígitos, hífens e sublinhados. </para> - -<para ->Normalmente, você desejará uma tag para todo o projeto (apesar do &CVS; permitir uma tag para um sub-conjunto somente). Para este fim, marque a pasta de nível superior na janela e escolha <menuchoice -><guimenu ->Avançado</guimenu -><guimenuitem ->Tag/Ramificação</guimenuitem -></menuchoice ->. Agora insira o nome da tag, pressione <keycap ->Return</keycap -> e está feito! </para> - -<para ->Criar uma ramificação não é significativamente mais difícil. No diálogo de tag, habilite a caixa <guibutton ->Criar ramificação com esta tag</guibutton ->. Você pode também excluir uma tag existente: Selecione <menuchoice -><guimenu ->Avançado</guimenu -><guimenuitem ->Excluir Tag</guimenuitem -></menuchoice -> na janela principal. </para> - -<para ->Outro aspecto da ramificação é a mesclagem de modificações de uma ramificação para a ramificação atual. Se você está fazendo isso, escolha <menuchoice -><guimenu ->Avançado</guimenu -><guimenuitem ->Mesclar...</guimenuitem -></menuchoice ->. O diálogo que aparece agora lhe oferece duas opções: </para> - -<para ->Você pode mesclar todas as modificações feitas na ramificação para a ramificação atual. Neste caso, habilite a caixa de checagem <guibutton ->Mesclar a partir da ramificação</guibutton -> e preencha a ramificação a partir da qual mesclar. O &cervisia; então executará o comando </para> +<title>Tags e Ramificações</title> + +<para>Nós discutiremos aqui somente aspectos de tags e ramificações. Se você é somente um <emphasis>usuário</emphasis>, e não o administrador do repositório, você provavelmente não será confrontado com o problema. Se no entanto você é seu próprio administrador, você deve primeiro ler sobre problemas não técnicos que acompanham as ramificações, para ter uma idéia de quanto tempo se gasta e quantos erros ocorrem por causa da manutenção de diferentes ramificações de um projeto. O apêndice inclui algumas referências sobre este tópico. </para> + +<para>Tag simples é algo que usualmente é feito quando uma revisão é executada, de modo que você possa a qualquer momento facilmente voltar para o estado de um projeto no tempo. Tags comumente fornecem um nome consistindo do nome do projeto e o número de revisão. Por exemplo, o &cervisia; 1.0 está disponível sob a tag <literal>CERVISIA_1_0</literal>. O &cervisia; força regras estritas do &CVS; sobre o que constitui um nome válido de tag. Ele deve iniciar com uma letra e pode conter letras, dígitos, hífens e sublinhados. </para> + +<para>Normalmente, você desejará uma tag para todo o projeto (apesar do &CVS; permitir uma tag para um sub-conjunto somente). Para este fim, marque a pasta de nível superior na janela e escolha <menuchoice><guimenu>Avançado</guimenu><guimenuitem>Tag/Ramificação</guimenuitem></menuchoice>. Agora insira o nome da tag, pressione <keycap>Return</keycap> e está feito! </para> + +<para>Criar uma ramificação não é significativamente mais difícil. No diálogo de tag, habilite a caixa <guibutton>Criar ramificação com esta tag</guibutton>. Você pode também excluir uma tag existente: Selecione <menuchoice><guimenu>Avançado</guimenu><guimenuitem>Excluir Tag</guimenuitem></menuchoice> na janela principal. </para> + +<para>Outro aspecto da ramificação é a mesclagem de modificações de uma ramificação para a ramificação atual. Se você está fazendo isso, escolha <menuchoice><guimenu>Avançado</guimenu><guimenuitem>Mesclar...</guimenuitem></menuchoice>. O diálogo que aparece agora lhe oferece duas opções: </para> + +<para>Você pode mesclar todas as modificações feitas na ramificação para a ramificação atual. Neste caso, habilite a caixa de checagem <guibutton>Mesclar a partir da ramificação</guibutton> e preencha a ramificação a partir da qual mesclar. O &cervisia; então executará o comando </para> <para> -<screen -><command ->cvs update <option ->-j</option -> <replaceable ->tagramificação</replaceable -></command -></screen> +<screen><command>cvs update <option>-j</option> <replaceable>tagramificação</replaceable></command></screen> </para> -<para ->A outra possibilidade é que você deseja mesclar somente as modificações feitas entre duas tags em uma ramificação. Isto usualmente acontece quando você mescla a partir da mesma ramificação para o tronco diversas vezes. Neste caso, habilite a caixa <guibutton ->Mesclar modificações</guibutton -> e insira (na ordem correta) as duas tags relevantes. Isto resultará em um comando </para> +<para>A outra possibilidade é que você deseja mesclar somente as modificações feitas entre duas tags em uma ramificação. Isto usualmente acontece quando você mescla a partir da mesma ramificação para o tronco diversas vezes. Neste caso, habilite a caixa <guibutton>Mesclar modificações</guibutton> e insira (na ordem correta) as duas tags relevantes. Isto resultará em um comando </para> <para> -<screen -><command ->cvs update <option ->-j</option -> <replaceable ->tagramificação1</replaceable -> <option ->-j</option -> <replaceable ->tagramificação2</replaceable -></command -></screen> +<screen><command>cvs update <option>-j</option> <replaceable>tagramificação1</replaceable> <option>-j</option> <replaceable>tagramificação2</replaceable></command></screen> </para> </sect1> <sect1 id="watches"> -<title ->Usando Monitores</title> - -<para ->Um monitor é o nome convencional para a característica do &CVS; de notificar usuários do repositório sempre que um arquivo for mudado ou um desenvolvedor iniciar a edição de um arquivo. O uso de monitores requer que o arquivo <filename -><envar ->$CVSROOT</envar ->/CVSROOT/notify</filename -> tenha sido configurado corretamente. Isto não será discutido aqui, se você necessitar de mais informações sobre a configuração de pontos de monitoramento, leia um dos livros listados no apêndice. </para> - -<para ->O principal suporte de monitores do &cervisia; possui seis ítens de menu. </para> - -<para ->Para adicionar um monitor para um ou diversos arquivos, use <menuchoice -><guimenu ->Avançado</guimenu -><guimenuitem ->Adicionar Monitor...</guimenuitem -></menuchoice ->. No diálogo obtido, você pode selecionar para quais tipos de eventos que o &CVS; suporta você deseja receber uma notificação. Por exemplo, se você somente quer receber notificações quando um arquivo é enviado, habilite as caixas <guibutton ->Somente</guibutton -> e <guibutton ->Envios</guibutton ->. Se você deseja obter notificações sobre qualquer evento relacionado aos arquivos marcados, habilite a caixa <guibutton ->Todos</guibutton ->. A linha de comando usada quando você aceita este diálogo é </para> +<title>Usando Monitores</title> + +<para>Um monitor é o nome convencional para a característica do &CVS; de notificar usuários do repositório sempre que um arquivo for mudado ou um desenvolvedor iniciar a edição de um arquivo. O uso de monitores requer que o arquivo <filename><envar>$CVSROOT</envar>/CVSROOT/notify</filename> tenha sido configurado corretamente. Isto não será discutido aqui, se você necessitar de mais informações sobre a configuração de pontos de monitoramento, leia um dos livros listados no apêndice. </para> + +<para>O principal suporte de monitores do &cervisia; possui seis ítens de menu. </para> + +<para>Para adicionar um monitor para um ou diversos arquivos, use <menuchoice><guimenu>Avançado</guimenu><guimenuitem>Adicionar Monitor...</guimenuitem></menuchoice>. No diálogo obtido, você pode selecionar para quais tipos de eventos que o &CVS; suporta você deseja receber uma notificação. Por exemplo, se você somente quer receber notificações quando um arquivo é enviado, habilite as caixas <guibutton>Somente</guibutton> e <guibutton>Envios</guibutton>. Se você deseja obter notificações sobre qualquer evento relacionado aos arquivos marcados, habilite a caixa <guibutton>Todos</guibutton>. A linha de comando usada quando você aceita este diálogo é </para> <para> -<screen -><command ->cvs watch add -a commit <replaceable ->nomes dos arquivos</replaceable -></command -></screen> +<screen><command>cvs watch add -a commit <replaceable>nomes dos arquivos</replaceable></command></screen> </para> -<para ->ou com uma opção similar, dependendo dos eventos que você escolher monitorar. </para> +<para>ou com uma opção similar, dependendo dos eventos que você escolher monitorar. </para> -<para ->Se você não está mais interessado em alguns arquivos, você pode remover os monitores deles. Para isto, use <menuchoice -><guimenu ->Avançado</guimenu -><guimenuitem ->Remover Monitor...</guimenuitem -></menuchoice ->. No diálogo obtido aqui, as mesmas opções no formulário preenchido para adição são oferecidas. Quando você confirmar este diálogo, o &cervisia; enviará o comando </para> +<para>Se você não está mais interessado em alguns arquivos, você pode remover os monitores deles. Para isto, use <menuchoice><guimenu>Avançado</guimenu><guimenuitem>Remover Monitor...</guimenuitem></menuchoice>. No diálogo obtido aqui, as mesmas opções no formulário preenchido para adição são oferecidas. Quando você confirmar este diálogo, o &cervisia; enviará o comando </para> <para> -<screen -><command ->cvs watch remove <replaceable ->nomes dos arquivos</replaceable -></command -></screen> +<screen><command>cvs watch remove <replaceable>nomes dos arquivos</replaceable></command></screen> </para> -<para ->possivelmente com uma opção <option ->-a</option -> para a escolha dos eventos. </para> +<para>possivelmente com uma opção <option>-a</option> para a escolha dos eventos. </para> -<para ->Finalmente, você pode obter uma lista das pessoas que estão monitorando um conjunto de arquivos. Escolha <menuchoice -><guimenu ->Avançado</guimenu -><guimenuitem ->Mostrar Monitores</guimenuitem -></menuchoice ->. Usar este ítem de menu resultará em um comando </para> +<para>Finalmente, você pode obter uma lista das pessoas que estão monitorando um conjunto de arquivos. Escolha <menuchoice><guimenu>Avançado</guimenu><guimenuitem>Mostrar Monitores</guimenuitem></menuchoice>. Usar este ítem de menu resultará em um comando </para> <para> -<screen -><command ->cvs watchers <replaceable ->nomes dos arquivos</replaceable -></command -></screen> +<screen><command>cvs watchers <replaceable>nomes dos arquivos</replaceable></command></screen> </para> -<para ->No cenário normal de utilização do &CVS;, cada desenvolvedor trabalha separadamente em sua cópia local sincronizada. Quando ele deseja modificar algum arquivo, ele pode apenas abrí-lo em seu editor e iniciar seu trabalho. Ninguém saberá sobre este trabalho até o arquivo ser enviado. </para> +<para>No cenário normal de utilização do &CVS;, cada desenvolvedor trabalha separadamente em sua cópia local sincronizada. Quando ele deseja modificar algum arquivo, ele pode apenas abrí-lo em seu editor e iniciar seu trabalho. Ninguém saberá sobre este trabalho até o arquivo ser enviado. </para> -<para ->Para alguns grupos de desenvolvedores, este não é o modelo preferido de cooperação. Eles preferem ser notificados sobre alguém trabalhando em um arquivo <emphasis ->tão logo</emphasis -> ele inicie. Isto pode ser obtido por alguns comando &CVS; posteriores. Antes de você iniciar a edição de um arquivo, selecione-o na janela principal do &cervisia; e escolha <menuchoice -><guimenu ->Avançado</guimenu -><guimenuitem ->Editar</guimenuitem -></menuchoice ->. Isto executará o comando </para> +<para>Para alguns grupos de desenvolvedores, este não é o modelo preferido de cooperação. Eles preferem ser notificados sobre alguém trabalhando em um arquivo <emphasis>tão logo</emphasis> ele inicie. Isto pode ser obtido por alguns comando &CVS; posteriores. Antes de você iniciar a edição de um arquivo, selecione-o na janela principal do &cervisia; e escolha <menuchoice><guimenu>Avançado</guimenu><guimenuitem>Editar</guimenuitem></menuchoice>. Isto executará o comando </para> <para> -<screen -><command ->cvs edit <replaceable ->nomes dos arquivos</replaceable -></command -></screen> +<screen><command>cvs edit <replaceable>nomes dos arquivos</replaceable></command></screen> </para> -<para ->Isto enviará uma notificação para todos que tem configurado um monitor de <literal ->edição</literal -> no arquivo. Isto também registrará também você como um <emphasis ->editor</emphasis -> do arquivo. Você pode obter uma lista de todos os editores de um determinado arquivo usando <menuchoice -><guimenu ->Avançado</guimenu -><guimenuitem ->Mostrar Editores</guimenuitem -></menuchoice ->. Isto é equivalente a digitar na linha de comando </para> +<para>Isto enviará uma notificação para todos que tem configurado um monitor de <literal>edição</literal> no arquivo. Isto também registrará também você como um <emphasis>editor</emphasis> do arquivo. Você pode obter uma lista de todos os editores de um determinado arquivo usando <menuchoice><guimenu>Avançado</guimenu><guimenuitem>Mostrar Editores</guimenuitem></menuchoice>. Isto é equivalente a digitar na linha de comando </para> <para> -<screen -><command ->cvs editors <replaceable ->nomes dos arquivos</replaceable -></command -></screen> +<screen><command>cvs editors <replaceable>nomes dos arquivos</replaceable></command></screen> </para> -<para ->Uma sessão de edição é automaticamente terminada quando você envia o arquivo afetado. Neste momento, uma notificação de <literal ->cancelar edição</literal -> é enviado para todas as pessoas que tem registrado o respectivo monitor no arquivo. É claro, algumas vezes você pode não desejar sincronizar o arquivo, mas aborta a sessão de edição e reverte para a versão anterior do arquivo. Isto é feito usando <menuchoice -><guimenu ->Avançado</guimenu -><guimenuitem ->Cancelar edição</guimenuitem -></menuchoice ->. Observe que o &cervisia; não lhe pedirá por uma confirmação! Isto significa que se você usar este ítem de menu, todo seu trabalho feito desde o uso do <menuchoice -><guimenu ->Avançado</guimenu -><guimenuitem ->Editar</guimenuitem -></menuchoice -> será perdido. Precisamente, o &cervisia; usa a linha de comando </para> +<para>Uma sessão de edição é automaticamente terminada quando você envia o arquivo afetado. Neste momento, uma notificação de <literal>cancelar edição</literal> é enviado para todas as pessoas que tem registrado o respectivo monitor no arquivo. É claro, algumas vezes você pode não desejar sincronizar o arquivo, mas aborta a sessão de edição e reverte para a versão anterior do arquivo. Isto é feito usando <menuchoice><guimenu>Avançado</guimenu><guimenuitem>Cancelar edição</guimenuitem></menuchoice>. Observe que o &cervisia; não lhe pedirá por uma confirmação! Isto significa que se você usar este ítem de menu, todo seu trabalho feito desde o uso do <menuchoice><guimenu>Avançado</guimenu><guimenuitem>Editar</guimenuitem></menuchoice> será perdido. Precisamente, o &cervisia; usa a linha de comando </para> <para> -<screen -><command ->echo y | cvs unedit <replaceable ->nomes dos arquivos</replaceable -></command -></screen> +<screen><command>echo y | cvs unedit <replaceable>nomes dos arquivos</replaceable></command></screen> </para> -<para ->Nós temos somente o caso discutido onde edição e cancelamento de edição são usados voluntariamente pelos desenvolvedores. Adicionalmente o &CVS; suporta um modelo que <emphasis ->força</emphasis -> o uso destes comandos. O comando responsável por alternar para este modelo é <command ->cvs watch on</command -> que nós não iremos explanar posteriormente porque ele é mais usado pelo administrador do repositório. No entanto, o ponto importante do ponto de vista dos desenvolvedores é que quando o projeto força edições, as cópias de trabalho são verificadas <emphasis ->somente leitura</emphasis ->. Isto significa que você não pode editar um arquivo por padrão (a menos que você use coisas como <command ->chmod</command ->). Somente quando você usa <menuchoice -><guimenu ->Avançado</guimenu -><guimenuitem ->Editar</guimenuitem -></menuchoice ->, o arquivo se torna gravável. Ele é tornado somente leitura novamente quando você envia o arquivo ou usa <menuchoice -><guimenu ->Avançado</guimenu -><guimenuitem ->Cancelar edição</guimenuitem -></menuchoice ->. </para> - -<para ->A interface do editor do &cervisia; lhe auxilia com projetos que forçam monitores também de diferentes maneiras. Se você apenas iniciou um editor com um arquivo apenas para leitura com um duplo-clique nele ou usando <menuchoice -><guimenu ->Arquivo</guimenu -><guimenuitem ->Editar</guimenuitem -></menuchoice ->, você pode não ser capaz de salvar suas modificações posteriormente. Isto tem sua própria razão. Sempre que você deseja mudar um arquivo, você deve executar <command ->cvs edit</command -> antes, de modo que todas as pessoas monitorando o arquivo recebem uma notificação que você está trabalhando nele. </para> - -<para ->Neste caso, é conveniente habilitar a opção <menuchoice -><guimenu ->Configurações</guimenu -><guimenuitem ->Executar cvs edit Automaticamente Quando Necessário</guimenuitem -></menuchoice ->. Agora, sempre que você editar um arquivo com um duplo clique nele, o &cervisia; executará <command ->cvs edit</command -> antes do editor ser executado. Então você poderá editar seu arquivo normalmente. Quando tiver terminado seu trabalho, envie seus arquivos, e os arquivos enviados serão somente leitura novamente. </para> +<para>Nós temos somente o caso discutido onde edição e cancelamento de edição são usados voluntariamente pelos desenvolvedores. Adicionalmente o &CVS; suporta um modelo que <emphasis>força</emphasis> o uso destes comandos. O comando responsável por alternar para este modelo é <command>cvs watch on</command> que nós não iremos explanar posteriormente porque ele é mais usado pelo administrador do repositório. No entanto, o ponto importante do ponto de vista dos desenvolvedores é que quando o projeto força edições, as cópias de trabalho são verificadas <emphasis>somente leitura</emphasis>. Isto significa que você não pode editar um arquivo por padrão (a menos que você use coisas como <command>chmod</command>). Somente quando você usa <menuchoice><guimenu>Avançado</guimenu><guimenuitem>Editar</guimenuitem></menuchoice>, o arquivo se torna gravável. Ele é tornado somente leitura novamente quando você envia o arquivo ou usa <menuchoice><guimenu>Avançado</guimenu><guimenuitem>Cancelar edição</guimenuitem></menuchoice>. </para> + +<para>A interface do editor do &cervisia; lhe auxilia com projetos que forçam monitores também de diferentes maneiras. Se você apenas iniciou um editor com um arquivo apenas para leitura com um duplo-clique nele ou usando <menuchoice><guimenu>Arquivo</guimenu><guimenuitem>Editar</guimenuitem></menuchoice>, você pode não ser capaz de salvar suas modificações posteriormente. Isto tem sua própria razão. Sempre que você deseja mudar um arquivo, você deve executar <command>cvs edit</command> antes, de modo que todas as pessoas monitorando o arquivo recebem uma notificação que você está trabalhando nele. </para> + +<para>Neste caso, é conveniente habilitar a opção <menuchoice><guimenu>Configurações</guimenu><guimenuitem>Executar cvs edit Automaticamente Quando Necessário</guimenuitem></menuchoice>. Agora, sempre que você editar um arquivo com um duplo clique nele, o &cervisia; executará <command>cvs edit</command> antes do editor ser executado. Então você poderá editar seu arquivo normalmente. Quando tiver terminado seu trabalho, envie seus arquivos, e os arquivos enviados serão somente leitura novamente. </para> </sect1> <sect1 id="locking"> -<title ->Travando</title> - -<para ->O modelo de desenvolvimento seguido quando o &CVS; é usado é chamado <emphasis ->verificações não reservadas</emphasis ->. Cada desenvolvedor tem sua própria cópia local onde ele pode editar arquivos como desejar. Quando as características de monitoramento - como <command ->cvs edit</command -> - são usada, múltiplos desenvolvedores podem trabalhar em arquivos sincronizadamente. Mudanças feitas por um desenvolvedor diferente são mescladas para sua cópia local quando uma atualização é executada. </para> - -<para ->Outros sistemas de controle de revisão - como <acronym ->RCS</acronym -> e <application ->SourceSafe</application -> usam um modelo diferente. Quando um desenvolvedor deseja editar um arquivo, ele deve <emphasis ->travá-</emphasis ->lo. Somente um desenvolvedor pode travar um arquivo por vez. Quando ele terminou a edição, a trava é desfeita. Por um lado, com este modelo, conflitos podem nunca acontecer. Por outro lado, dois desenvolvedores não podem trabalhar no mesmo arquivo ao mesmo tempo, mesmo se suas mudanças não conflitarem. Isto pode ser um estrangulamento. Nós não vamos discutir os benefícios organizacionais de ambas as abordagens. Nós apenas iremos mencionar que apesar do &CVS; ter algum suporte para travamento, esta não é a melhor maneira de trabalhar com o &CVS;. Você não deve usar estas características a menos que tenha certeza que seu gerenciador de projeto as permita. </para> - -<para ->Com o &cervisia;, você trava arquivos como se segue. Selecione os arquivos desejados na janela principal. Então escolha <menuchoice -><guimenu ->Avançado</guimenu -><guimenuitem ->Travar</guimenuitem -></menuchoice ->. Isto executa o comando </para> +<title>Travando</title> + +<para>O modelo de desenvolvimento seguido quando o &CVS; é usado é chamado <emphasis>verificações não reservadas</emphasis>. Cada desenvolvedor tem sua própria cópia local onde ele pode editar arquivos como desejar. Quando as características de monitoramento - como <command>cvs edit</command> - são usada, múltiplos desenvolvedores podem trabalhar em arquivos sincronizadamente. Mudanças feitas por um desenvolvedor diferente são mescladas para sua cópia local quando uma atualização é executada. </para> + +<para>Outros sistemas de controle de revisão - como <acronym>RCS</acronym> e <application>SourceSafe</application> usam um modelo diferente. Quando um desenvolvedor deseja editar um arquivo, ele deve <emphasis>travá-</emphasis>lo. Somente um desenvolvedor pode travar um arquivo por vez. Quando ele terminou a edição, a trava é desfeita. Por um lado, com este modelo, conflitos podem nunca acontecer. Por outro lado, dois desenvolvedores não podem trabalhar no mesmo arquivo ao mesmo tempo, mesmo se suas mudanças não conflitarem. Isto pode ser um estrangulamento. Nós não vamos discutir os benefícios organizacionais de ambas as abordagens. Nós apenas iremos mencionar que apesar do &CVS; ter algum suporte para travamento, esta não é a melhor maneira de trabalhar com o &CVS;. Você não deve usar estas características a menos que tenha certeza que seu gerenciador de projeto as permita. </para> + +<para>Com o &cervisia;, você trava arquivos como se segue. Selecione os arquivos desejados na janela principal. Então escolha <menuchoice><guimenu>Avançado</guimenu><guimenuitem>Travar</guimenuitem></menuchoice>. Isto executa o comando </para> <para> -<screen -><command ->cvs admin -l <replaceable ->nomes dos arquivos</replaceable -></command -></screen> +<screen><command>cvs admin -l <replaceable>nomes dos arquivos</replaceable></command></screen> </para> -<para ->O efeito reverso é obtido usando <menuchoice -><guimenu ->Avançado</guimenu -><guimenuitem ->Destravar</guimenuitem -></menuchoice ->. Isto executa o comando</para> +<para>O efeito reverso é obtido usando <menuchoice><guimenu>Avançado</guimenu><guimenuitem>Destravar</guimenuitem></menuchoice>. Isto executa o comando</para> <para> -<screen -><command ->cvs admin -u <replaceable ->nomes dos arquivos</replaceable -></command -></screen> +<screen><command>cvs admin -u <replaceable>nomes dos arquivos</replaceable></command></screen> </para> </sect1> @@ -2551,57 +1005,24 @@ Mudanças no repositório <chapter id="customization"> -<title ->Personalizando o &cervisia;</title> +<title>Personalizando o &cervisia;</title> -<para ->O &cervisia; pode ser personalizado de diversas maneiras para suas necessidades e preferências. Algumas opções que você pode desejar mudar regularmente estão disponíveis diretamente no menu <guimenu ->Configurações</guimenu ->. Outras estão unificadas em um diálogo comum que está disponível via <menuchoice -><guimenu ->Opções</guimenu -><guimenuitem ->Configurações...</guimenuitem -></menuchoice ->. </para> +<para>O &cervisia; pode ser personalizado de diversas maneiras para suas necessidades e preferências. Algumas opções que você pode desejar mudar regularmente estão disponíveis diretamente no menu <guimenu>Configurações</guimenu>. Outras estão unificadas em um diálogo comum que está disponível via <menuchoice><guimenu>Opções</guimenu><guimenuitem>Configurações...</guimenuitem></menuchoice>. </para> <sect1 id="customize-general"> -<title ->Geral</title> +<title>Geral</title> <variablelist> <varlistentry id="customize-username"> -<term -><guilabel ->Nome de usuário para o editor de ChangeLog:</guilabel -></term> -<listitem -><para ->Sempre que você usa o ítem de menu <menuchoice -><guimenu ->Arquivo</guimenu -><guimenuitem ->Inserir Entrada ChangeLog...</guimenuitem -></menuchoice ->, uma nova entrada no ChangeLog é gerada com a data atual e seu nome de usuário. Normalmente, é considerado um bom estilo inserir seu nome completo e seu endereço eletrônico em cada uma de suas entradas no ChangeLog. O &cervisia; adiciona automaticamente o nome completo e enderço eletrônico inseridos aqui. </para -></listitem> +<term><guilabel>Nome de usuário para o editor de ChangeLog:</guilabel></term> +<listitem><para>Sempre que você usa o ítem de menu <menuchoice><guimenu>Arquivo</guimenu><guimenuitem>Inserir Entrada ChangeLog...</guimenuitem></menuchoice>, uma nova entrada no ChangeLog é gerada com a data atual e seu nome de usuário. Normalmente, é considerado um bom estilo inserir seu nome completo e seu endereço eletrônico em cada uma de suas entradas no ChangeLog. O &cervisia; adiciona automaticamente o nome completo e enderço eletrônico inseridos aqui. </para></listitem> </varlistentry> <varlistentry id="customize-cvspath"> -<term -><guilabel ->Caminho para o executável do cvs, ou 'cvs':</guilabel -></term> -<listitem -><para ->Aqui você pode configurar o nome (ou caminho) para o cliente de linha de comando <command ->cvs</command ->. Por padrão, o executável do &CVS; encontrado em seu<envar ->$PATH</envar -> é usado pelo &cervisia;. </para -></listitem> +<term><guilabel>Caminho para o executável do cvs, ou 'cvs':</guilabel></term> +<listitem><para>Aqui você pode configurar o nome (ou caminho) para o cliente de linha de comando <command>cvs</command>. Por padrão, o executável do &CVS; encontrado em seu<envar>$PATH</envar> é usado pelo &cervisia;. </para></listitem> </varlistentry> </variablelist> @@ -2609,81 +1030,28 @@ Mudanças no repositório </sect1> <sect1 id="customize-diff"> -<title ->Visualizador de Diferenças</title> +<title>Visualizador de Diferenças</title> <variablelist> <varlistentry id="customize-context"> -<term -><guilabel ->Número das linhas de contexto no diálogo de diferenças:</guilabel -></term> -<listitem -><para ->Para o diálogo de diferenças o &cervisia; usa a opção <option ->-U</option -> para o <command ->diff</command ->. Isto faz com que o <command ->diff</command -> mostre somente um número limitado de linhas ao redor de cada região de diferença (linhas de contexto). Aqui você pode configurar o argumento para o <option ->-U</option ->. </para -></listitem> +<term><guilabel>Número das linhas de contexto no diálogo de diferenças:</guilabel></term> +<listitem><para>Para o diálogo de diferenças o &cervisia; usa a opção <option>-U</option> para o <command>diff</command>. Isto faz com que o <command>diff</command> mostre somente um número limitado de linhas ao redor de cada região de diferença (linhas de contexto). Aqui você pode configurar o argumento para o <option>-U</option>. </para></listitem> </varlistentry> <varlistentry id="customize-diffopt"> -<term -><guilabel ->Opções adicionais para o cvs diff:</guilabel -></term> -<listitem -><para ->Aqui você pode adicionar argumentos suplementares ao <command ->diff</command ->. Um exemplo popular é <option ->-b</option -> que faz com que o <command ->diff</command -> ignore mudanças na quantidade de espaços em branco. </para -></listitem> +<term><guilabel>Opções adicionais para o cvs diff:</guilabel></term> +<listitem><para>Aqui você pode adicionar argumentos suplementares ao <command>diff</command>. Um exemplo popular é <option>-b</option> que faz com que o <command>diff</command> ignore mudanças na quantidade de espaços em branco. </para></listitem> </varlistentry> <varlistentry id="customize-tabwidth"> -<term -><guilabel ->Largura da tabulação no diálogo de diferenças:</guilabel -></term> -<listitem -><para ->No diálogo de diferenças, caracteres de tabulação presentes em seu arquivo ou na saída do comando <command ->diff</command -> são expandidos para um número fixo de caracteres de espaço. Por padrão, cada tabulação é substituída por oito espaços, mas aqui você pode configurar um número diferente. </para -></listitem> +<term><guilabel>Largura da tabulação no diálogo de diferenças:</guilabel></term> +<listitem><para>No diálogo de diferenças, caracteres de tabulação presentes em seu arquivo ou na saída do comando <command>diff</command> são expandidos para um número fixo de caracteres de espaço. Por padrão, cada tabulação é substituída por oito espaços, mas aqui você pode configurar um número diferente. </para></listitem> </varlistentry> <varlistentry id="customize-difffrontend"> -<term -><guilabel ->Interface externa do diff:</guilabel -></term> -<listitem -><para ->Quando você usa qualquer dos recursos mostrados no diálogo de diferenças, como <menuchoice -><guimenu ->Ver</guimenu -><guimenuitem ->Diferenças para Repositório...</guimenuitem -></menuchoice ->, o &cervisia; invoca seu aplicativo interno de interface com o diff. Se você preferir um diferente, como o <application ->Kompare</application ->, <application ->TkDiff</application ->, ou <application ->xxdiff</application ->, insira o nome e caminho do arquivo aqui. </para -></listitem> +<term><guilabel>Interface externa do diff:</guilabel></term> +<listitem><para>Quando você usa qualquer dos recursos mostrados no diálogo de diferenças, como <menuchoice><guimenu>Ver</guimenu><guimenuitem>Diferenças para Repositório...</guimenuitem></menuchoice>, o &cervisia; invoca seu aplicativo interno de interface com o diff. Se você preferir um diferente, como o <application>Kompare</application>, <application>TkDiff</application>, ou <application>xxdiff</application>, insira o nome e caminho do arquivo aqui. </para></listitem> </varlistentry> </variablelist> @@ -2691,43 +1059,18 @@ Mudanças no repositório </sect1> <sect1 id="customize-status"> -<title ->Estado</title> +<title>Estado</title> <variablelist> <varlistentry id="customize-startstatus-remote"> -<term -><guilabel ->Ao abrir uma área local de um repositório remoto, iniciar um comando Arquivo->Estado automaticamente</guilabel -></term> -<listitem -><para ->Quando você habilita esta opção, o comando <menuchoice -><guimenu ->Arquivo</guimenu -><guimenuitem ->Estado</guimenuitem -></menuchoice -> é iniciado sempre que você abre uma área local de um repositório remoto. Este comando pode demorar algum tempo e também necessita de uma conexão com o servidor para repositórios remotos (tornando-o indisponível para uso off-line). </para -></listitem> +<term><guilabel>Ao abrir uma área local de um repositório remoto, iniciar um comando Arquivo->Estado automaticamente</guilabel></term> +<listitem><para>Quando você habilita esta opção, o comando <menuchoice><guimenu>Arquivo</guimenu><guimenuitem>Estado</guimenuitem></menuchoice> é iniciado sempre que você abre uma área local de um repositório remoto. Este comando pode demorar algum tempo e também necessita de uma conexão com o servidor para repositórios remotos (tornando-o indisponível para uso off-line). </para></listitem> </varlistentry> <varlistentry id="customize-startstatus-local"> -<term -><guilabel ->Ao abrir uma área local de um repositório local, iniciar um comando Arquivo->Estado automaticamente</guilabel -></term> -<listitem -><para ->Quando você habilita esta opção, o comando <menuchoice -><guimenu ->Arquivo</guimenu -><guimenuitem ->Estado</guimenuitem -></menuchoice -> é iniciado sempre que você abre uma área local de um repositório local. </para -></listitem> +<term><guilabel>Ao abrir uma área local de um repositório local, iniciar um comando Arquivo->Estado automaticamente</guilabel></term> +<listitem><para>Quando você habilita esta opção, o comando <menuchoice><guimenu>Arquivo</guimenu><guimenuitem>Estado</guimenuitem></menuchoice> é iniciado sempre que você abre uma área local de um repositório local. </para></listitem> </varlistentry> </variablelist> @@ -2735,62 +1078,23 @@ Mudanças no repositório </sect1> <sect1 id="customize-advanced"> -<title ->Avançado</title> +<title>Avançado</title> <variablelist> <varlistentry id="customize-timeout"> -<term -><guilabel ->Tempo limite após o qual um diálogo de progresso aparece (em ms):</guilabel -></term> -<listitem -><para ->Praticamente todos os comando &CVS; iniciados em uma cópia local que se estendem a um repositório remoto necessitam de uma conexão para o servidor &CVS;. Isto é afetado pelos retardos da conexão da rede ou uma sobrecarga no servidor. Por esta razão, para comandos como <menuchoice -><guimenu ->Ver</guimenu -><guimenuitem ->Diferença para Repositório...</guimenuitem -></menuchoice -> o &cervisia; abre um diálogo que indica que o comando ainda está rodando e que lhe permite abortá-lo. Além disso, este diálogo é usado para mostrar mensagens de erro do &CVS;. Com este diálogo deve aparecer após algum tempo, ele é mostrado somente após um determinado limite de tempo que é de 4 segundos por padrão. Aqui você pode mudar este valor. </para -></listitem> +<term><guilabel>Tempo limite após o qual um diálogo de progresso aparece (em ms):</guilabel></term> +<listitem><para>Praticamente todos os comando &CVS; iniciados em uma cópia local que se estendem a um repositório remoto necessitam de uma conexão para o servidor &CVS;. Isto é afetado pelos retardos da conexão da rede ou uma sobrecarga no servidor. Por esta razão, para comandos como <menuchoice><guimenu>Ver</guimenu><guimenuitem>Diferença para Repositório...</guimenuitem></menuchoice> o &cervisia; abre um diálogo que indica que o comando ainda está rodando e que lhe permite abortá-lo. Além disso, este diálogo é usado para mostrar mensagens de erro do &CVS;. Com este diálogo deve aparecer após algum tempo, ele é mostrado somente após um determinado limite de tempo que é de 4 segundos por padrão. Aqui você pode mudar este valor. </para></listitem> </varlistentry> <varlistentry id="customize-compression"> -<term -><guilabel ->Nível de compressão padrão:</guilabel -></term> -<listitem -><para ->O cliente <command ->cvs</command -> comprime arquivos e remendos quando eles são transferidos pela rede. Com a opção de linha de comando <option ->-z</option ->, o nível de compressão pode ser configurado. Você pode configurar o &cervisia; para usar esta opção na configuração do nível. O valor configurado aqui é usado somente como padrão; adicionalmente existe uma configuração por repositório disponível em <menuchoice -><guimenu ->Repositório</guimenu -><guimenuitem ->Repositórios...</guimenuitem -></menuchoice ->. </para -></listitem> +<term><guilabel>Nível de compressão padrão:</guilabel></term> +<listitem><para>O cliente <command>cvs</command> comprime arquivos e remendos quando eles são transferidos pela rede. Com a opção de linha de comando <option>-z</option>, o nível de compressão pode ser configurado. Você pode configurar o &cervisia; para usar esta opção na configuração do nível. O valor configurado aqui é usado somente como padrão; adicionalmente existe uma configuração por repositório disponível em <menuchoice><guimenu>Repositório</guimenu><guimenuitem>Repositórios...</guimenuitem></menuchoice>. </para></listitem> </varlistentry> <varlistentry id="customize-sshagent"> -<term -><guilabel ->Utilizar um processo de agente ssh em execução ou iniciar um novo</guilabel -></term> -<listitem -><para ->Habilite isto se você usa <link linkend="rsh" ->repositórios ext (rsh)</link ->, o shell remoto &ssh; para comunicar-se com o repositório e o <application ->ssh-agent</application -> para gerenciar suas chaves. </para -></listitem> +<term><guilabel>Utilizar um processo de agente ssh em execução ou iniciar um novo</guilabel></term> +<listitem><para>Habilite isto se você usa <link linkend="rsh">repositórios ext (rsh)</link>, o shell remoto &ssh; para comunicar-se com o repositório e o <application>ssh-agent</application> para gerenciar suas chaves. </para></listitem> </varlistentry> </variablelist> @@ -2799,90 +1103,33 @@ Mudanças no repositório <sect1 id="customize-look"> -<title ->Aparência</title> +<title>Aparência</title> <variablelist> <varlistentry id="customize-protocolfont"> -<term -><guilabel ->Fonte para janela de protocolo...</guilabel -></term> -<listitem -><para ->Pressione este botão para abrir o diálogo <guilabel ->Configurar Fonte</guilabel ->, para configurar a fonte usada na janela de protocolo (esta é a janela que mostra a saída do cliente <command ->cvs</command ->). </para -></listitem> +<term><guilabel>Fonte para janela de protocolo...</guilabel></term> +<listitem><para>Pressione este botão para abrir o diálogo <guilabel>Configurar Fonte</guilabel>, para configurar a fonte usada na janela de protocolo (esta é a janela que mostra a saída do cliente <command>cvs</command>). </para></listitem> </varlistentry> <varlistentry id="customize-annotatefont"> -<term -><guilabel ->Fonte para visão anotada...</guilabel -></term> -<listitem -><para ->Pressione este botão para abrir o diálogo <guilabel ->Configurar Fonte</guilabel ->, para configurar a fonte usada na <link linkend="annotate" ->visão anotada</link ->. </para -></listitem> +<term><guilabel>Fonte para visão anotada...</guilabel></term> +<listitem><para>Pressione este botão para abrir o diálogo <guilabel>Configurar Fonte</guilabel>, para configurar a fonte usada na <link linkend="annotate">visão anotada</link>. </para></listitem> </varlistentry> <varlistentry id="customize-difffont"> -<term -><guilabel ->Fonte para visão das diferenças...</guilabel -></term> -<listitem -><para ->Pressione este botão para abrir o diálogo <guilabel ->Configurar Fonte</guilabel ->, para configurar a fonte usada no <link linkend="diff" ->diálogo de diferenças</link ->. </para -></listitem> +<term><guilabel>Fonte para visão das diferenças...</guilabel></term> +<listitem><para>Pressione este botão para abrir o diálogo <guilabel>Configurar Fonte</guilabel>, para configurar a fonte usada no <link linkend="diff">diálogo de diferenças</link>. </para></listitem> </varlistentry> <varlistentry id="customize-colors"> -<term -><guilabel ->Cores</guilabel -></term> -<listitem -><para ->Pressione os botões coloridos para abrir o diálogo <guilabel ->Selecionar Cor</guilabel ->, para configurar a cor usada para <guilabel ->Conflito</guilabel ->, <guilabel ->Mudado Localmente</guilabel ->, ou <guilabel ->Mudado Remotamente</guilabel -> na visão principal ou <guilabel ->Diferença de mudança</guilabel ->, <guilabel ->Diferença de inserção</guilabel -> ou <guilabel ->Diferença de exclusão</guilabel -> na interface embutida do &cervisia; para o diff. </para -></listitem> +<term><guilabel>Cores</guilabel></term> +<listitem><para>Pressione os botões coloridos para abrir o diálogo <guilabel>Selecionar Cor</guilabel>, para configurar a cor usada para <guilabel>Conflito</guilabel>, <guilabel>Mudado Localmente</guilabel>, ou <guilabel>Mudado Remotamente</guilabel> na visão principal ou <guilabel>Diferença de mudança</guilabel>, <guilabel>Diferença de inserção</guilabel> ou <guilabel>Diferença de exclusão</guilabel> na interface embutida do &cervisia; para o diff. </para></listitem> </varlistentry> <varlistentry id="customize-splitter"> -<term -><guilabel ->Dividir janela principal horizontalmente</guilabel -></term> -<listitem -><para ->A janela principal do &cervisia; é normalmente dividida verticalmente em uma janela com a árvore de arquivos e uma com a saída do &CVS;. Alternativamente, você pode arranjá-las horizontalmente. </para -></listitem> +<term><guilabel>Dividir janela principal horizontalmente</guilabel></term> +<listitem><para>A janela principal do &cervisia; é normalmente dividida verticalmente em uma janela com a árvore de arquivos e uma com a saída do &CVS;. Alternativamente, você pode arranjá-las horizontalmente. </para></listitem> </varlistentry> </variablelist> @@ -2892,123 +1139,44 @@ Mudanças no repositório <chapter id="appendix"> -<title ->Apêndice</title> +<title>Apêndice</title> <sect1 id="ignoredfiles"> -<title ->Arquivos Ignorados</title> +<title>Arquivos Ignorados</title> -<para ->Na sua árvore de arquivos, o &cervisia; não exibe todos os arquivos que estão atualmente lá. Isto é análogo ao próprio <command ->cvs</command -> e auxilia a evitar a sobrecarga causada por material desnecessário como arquivos de objeto. O &cervisia; tenta emular o comportamento do <command ->cvs</command -> tanto quanto possível, isto é, obtém uma lista de arquivos a ignorar das seguintes fontes: </para> +<para>Na sua árvore de arquivos, o &cervisia; não exibe todos os arquivos que estão atualmente lá. Isto é análogo ao próprio <command>cvs</command> e auxilia a evitar a sobrecarga causada por material desnecessário como arquivos de objeto. O &cervisia; tenta emular o comportamento do <command>cvs</command> tanto quanto possível, isto é, obtém uma lista de arquivos a ignorar das seguintes fontes: </para> <itemizedlist> -<listitem -><para ->Um lista estática de entradas que incluem coisas como <literal role="extension" ->*.o</literal -> e <filename ->core</filename ->. Para detalhes, veja a documentação do &CVS;. </para -></listitem> -<listitem -><para ->O arquivo <filename -><envar ->$HOME</envar ->/.cvsignore</filename ->. </para -></listitem> - -<listitem -><para ->A variável de ambiente <envar ->$CVSIGNORE</envar ->. </para -></listitem> -<listitem -><para ->O arquivo <filename ->.cvsignore</filename -> na respectiva pasta. </para -></listitem> +<listitem><para>Um lista estática de entradas que incluem coisas como <literal role="extension">*.o</literal> e <filename>core</filename>. Para detalhes, veja a documentação do &CVS;. </para></listitem> +<listitem><para>O arquivo <filename><envar>$HOME</envar>/.cvsignore</filename>. </para></listitem> + +<listitem><para>A variável de ambiente <envar>$CVSIGNORE</envar>. </para></listitem> +<listitem><para>O arquivo <filename>.cvsignore</filename> na respectiva pasta. </para></listitem> </itemizedlist> -<para ->O próprio <command ->cvs</command -> adicionalmente procura por entradas em <filename -><envar ->$CVSROOT</envar ->/CVSROOT/cvsignore</filename ->, mas este é um arquivo do servidor, e o &cervisia; pode não ser capaz de iniciá-lo estando offline. Se você estiver trabalhando com um grupo que prefere usar uma lista de arquivos para ignorar no servidor, é provavelmente uma boa idéia dar uma olhada em quais padrões estão listados nele e colocá-los no arquivo <filename ->.cvsignore</filename -> em sua pasta pessoal. </para> +<para>O próprio <command>cvs</command> adicionalmente procura por entradas em <filename><envar>$CVSROOT</envar>/CVSROOT/cvsignore</filename>, mas este é um arquivo do servidor, e o &cervisia; pode não ser capaz de iniciá-lo estando offline. Se você estiver trabalhando com um grupo que prefere usar uma lista de arquivos para ignorar no servidor, é provavelmente uma boa idéia dar uma olhada em quais padrões estão listados nele e colocá-los no arquivo <filename>.cvsignore</filename> em sua pasta pessoal. </para> </sect1> <sect1 id="information"> -<title ->Informações Adicionais e Suporte</title> +<title>Informações Adicionais e Suporte</title> <itemizedlist> -<listitem -><para ->O &CVS; vem com um conjunto completo de documentação na forma de páginas de informação, conhecidas como "O Cederquivista". Se ele estiver corretamente instalado, você poderá navegá-lo digitando <userinput ->info:/cvs</userinput -> na barra de localização do <application ->kdehelp</application ->, <application ->khelpcenter</application -> respectivamente. Alternativamente, você pode apenas escolher <menuchoice -><guimenu ->Ajuda</guimenu -><guimenuitem ->Informações do CVS</guimenuitem -></menuchoice -> no &cervisia;. Uma versão HTML online do Cederquivista está disponível <ulink url="http://cvshome.org/docs/manual/cvs.html" ->na web</ulink ->. </para> - -<para ->Como este livro é mantido junto com o &CVS;, ele é normalmente a referência mais atualizada. No entanto eu recomendo considerar outras documentações para aprender a usar o &CVS;, particularmente as seguintes. </para -></listitem> - -<listitem -><para ->Karl Fogel escreveu um excelente livro <ulink url="http://cvsbook.red-bean.com/index.html" ->Desenvolvimento Open Source com o CVS</ulink ->. Metade deste livro é sobre o processo de desenvolvimento de software Open Source. A outra metade é uma documentação técnica do &CVS;. Felizmente, a parte técnica do livro é livre e redistribuível sob a GPL, logo você pode baixar uma versão HTML dela. Uma lista de erratas está disponível na página web mencionada acima. </para -></listitem> - -<listitem -><para ->Versões &CVS; são discutidas em uma <ulink url="http://mail.gnu.org/mailman/listinfo/info-cvs" ->lista de correio</ulink -> dedicada. </para -></listitem> - -<listitem -><para ->Existe um grupo USENET <literal ->comp.software.config-mgmt</literal -> dedicado ao gerenciamento da configuração em geral. O &CVS; é somente um tópico marginal neste grupo, mas ao menos pode ser interessante para discutir os méritos de vários sistemas de controle de revisão comparados ao &CVS;. </para -></listitem> - -<listitem -><para ->Por fim, mas não menos importante, existe uma (de baixo tráfico) <ulink url="http://lists.sourceforge.net/mailman/listinfo/cervisia-user" ->lista de correio do &cervisia;</ulink ->. </para -></listitem> +<listitem><para>O &CVS; vem com um conjunto completo de documentação na forma de páginas de informação, conhecidas como "O Cederquivista". Se ele estiver corretamente instalado, você poderá navegá-lo digitando <userinput>info:/cvs</userinput> na barra de localização do <application>kdehelp</application>, <application>khelpcenter</application> respectivamente. Alternativamente, você pode apenas escolher <menuchoice><guimenu>Ajuda</guimenu><guimenuitem>Informações do CVS</guimenuitem></menuchoice> no &cervisia;. Uma versão HTML online do Cederquivista está disponível <ulink url="http://cvshome.org/docs/manual/cvs.html">na web</ulink>. </para> + +<para>Como este livro é mantido junto com o &CVS;, ele é normalmente a referência mais atualizada. No entanto eu recomendo considerar outras documentações para aprender a usar o &CVS;, particularmente as seguintes. </para></listitem> + +<listitem><para>Karl Fogel escreveu um excelente livro <ulink url="http://cvsbook.red-bean.com/index.html">Desenvolvimento Open Source com o CVS</ulink>. Metade deste livro é sobre o processo de desenvolvimento de software Open Source. A outra metade é uma documentação técnica do &CVS;. Felizmente, a parte técnica do livro é livre e redistribuível sob a GPL, logo você pode baixar uma versão HTML dela. Uma lista de erratas está disponível na página web mencionada acima. </para></listitem> + +<listitem><para>Versões &CVS; são discutidas em uma <ulink url="http://mail.gnu.org/mailman/listinfo/info-cvs">lista de correio</ulink> dedicada. </para></listitem> + +<listitem><para>Existe um grupo USENET <literal>comp.software.config-mgmt</literal> dedicado ao gerenciamento da configuração em geral. O &CVS; é somente um tópico marginal neste grupo, mas ao menos pode ser interessante para discutir os méritos de vários sistemas de controle de revisão comparados ao &CVS;. </para></listitem> + +<listitem><para>Por fim, mas não menos importante, existe uma (de baixo tráfico) <ulink url="http://lists.sourceforge.net/mailman/listinfo/cervisia-user">lista de correio do &cervisia;</ulink>. </para></listitem> </itemizedlist> @@ -3016,252 +1184,80 @@ Mudanças no repositório <sect1 id="commandreference"> -<title ->Referência de Comandos</title> +<title>Referência de Comandos</title> <!-- File Menu --> <sect2 id="menufile"> -<title ->O Menu Arquivo</title> +<title>O Menu Arquivo</title> <variablelist> <varlistentry> -<term -><menuchoice -><guimenu ->Arquivo</guimenu -><guimenuitem ->Abrir Cópia Local...</guimenuitem -> </menuchoice -></term> -<listitem -><para ->Abre uma área local na janela principal. Veja <xref linkend="mainscreen"/>. </para -></listitem> +<term><menuchoice><guimenu>Arquivo</guimenu><guimenuitem>Abrir Cópia Local...</guimenuitem> </menuchoice></term> +<listitem><para>Abre uma área local na janela principal. Veja <xref linkend="mainscreen"/>. </para></listitem> </varlistentry> <varlistentry> -<term -><menuchoice -><guimenu ->Arquivo</guimenu -><guimenuitem ->Cópias locais recentes</guimenuitem -> </menuchoice -></term> -<listitem -><para ->Abre uma das cópias locais que foi usada recentemente. </para -></listitem> +<term><menuchoice><guimenu>Arquivo</guimenu><guimenuitem>Cópias locais recentes</guimenuitem> </menuchoice></term> +<listitem><para>Abre uma das cópias locais que foi usada recentemente. </para></listitem> </varlistentry> <varlistentry> -<term -><menuchoice -><guimenu ->Arquivo</guimenu -><guimenuitem ->Inserir Entrada ChangeLog...</guimenuitem -> </menuchoice -></term> -<listitem -><para ->Abre o editor de ChangeLog, preparado de modo que você possa adicionar uma nova entrada com a data atual. Veja <xref linkend="committingfiles"/>. </para -></listitem> +<term><menuchoice><guimenu>Arquivo</guimenu><guimenuitem>Inserir Entrada ChangeLog...</guimenuitem> </menuchoice></term> +<listitem><para>Abre o editor de ChangeLog, preparado de modo que você possa adicionar uma nova entrada com a data atual. Veja <xref linkend="committingfiles"/>. </para></listitem> </varlistentry> <varlistentry> -<term -><menuchoice -><shortcut -><keycombo -><keycap ->&Ctrl;</keycap -><keycap ->U</keycap -></keycombo -></shortcut -> <guimenu ->Arquivo</guimenu -><guimenuitem ->Atualizar</guimenuitem -> </menuchoice -></term> -<listitem -><para ->Executa um 'cvs update' nos arquivos selecionados e muda o estado e número de revisão na lista de acordo. Veja <xref linkend="mainscreen"/>. </para -></listitem> +<term><menuchoice><shortcut><keycombo><keycap>&Ctrl;</keycap><keycap>U</keycap></keycombo></shortcut> <guimenu>Arquivo</guimenu><guimenuitem>Atualizar</guimenuitem> </menuchoice></term> +<listitem><para>Executa um 'cvs update' nos arquivos selecionados e muda o estado e número de revisão na lista de acordo. Veja <xref linkend="mainscreen"/>. </para></listitem> </varlistentry> <varlistentry> -<term -><menuchoice -><shortcut -><keycap ->F5</keycap -></shortcut -> <guimenu ->Arquivo</guimenu -><guimenuitem ->Estado</guimenuitem -> </menuchoice -></term> -<listitem -><para ->Executa um 'cvs update' nos arquivos selecionados e muda o estado e número de revisão na lista de acordo. Veja <xref linkend="mainscreen"/>. </para -></listitem> +<term><menuchoice><shortcut><keycap>F5</keycap></shortcut> <guimenu>Arquivo</guimenu><guimenuitem>Estado</guimenuitem> </menuchoice></term> +<listitem><para>Executa um 'cvs update' nos arquivos selecionados e muda o estado e número de revisão na lista de acordo. Veja <xref linkend="mainscreen"/>. </para></listitem> </varlistentry> <varlistentry> -<term -><menuchoice -><guimenu ->Arquivo</guimenu -><guimenuitem ->Editar</guimenuitem -> </menuchoice -></term> -<listitem -><para ->Abre o arquivo selecionado no editor padrão do KDE para o respectivo tipo de arquivo. </para -></listitem> +<term><menuchoice><guimenu>Arquivo</guimenu><guimenuitem>Editar</guimenuitem> </menuchoice></term> +<listitem><para>Abre o arquivo selecionado no editor padrão do KDE para o respectivo tipo de arquivo. </para></listitem> </varlistentry> <varlistentry> -<term -><menuchoice -><guimenu ->Arquivo</guimenu -><guimenuitem ->Resolver...</guimenuitem -> </menuchoice -></term> -<listitem -><para ->Abre um diálogo para o arquivo selecionado que lhe permite resolver conflitos de mesclagem existentes. Veja <xref linkend="resolvingconflicts"/>. </para -></listitem> +<term><menuchoice><guimenu>Arquivo</guimenu><guimenuitem>Resolver...</guimenuitem> </menuchoice></term> +<listitem><para>Abre um diálogo para o arquivo selecionado que lhe permite resolver conflitos de mesclagem existentes. Veja <xref linkend="resolvingconflicts"/>. </para></listitem> </varlistentry> <varlistentry> -<term -><menuchoice -><shortcut -><keycap ->#</keycap -></shortcut -> <guimenu ->Arquivo</guimenu -><guimenuitem ->Enviar...</guimenuitem -> </menuchoice -></term> -<listitem -><para ->Permite-lhe enviar os arquivos selecionados. Veja <xref linkend="committingfiles"/>. </para -></listitem> +<term><menuchoice><shortcut><keycap>#</keycap></shortcut> <guimenu>Arquivo</guimenu><guimenuitem>Enviar...</guimenuitem> </menuchoice></term> +<listitem><para>Permite-lhe enviar os arquivos selecionados. Veja <xref linkend="committingfiles"/>. </para></listitem> </varlistentry> <varlistentry> -<term -><menuchoice -><shortcut -><keycap ->+</keycap -></shortcut -> <guimenu ->Arquivo</guimenu -><guimenuitem ->Adicionar ao Repositório...</guimenuitem -> </menuchoice -></term> -<listitem -><para ->Permite-lhe adicionar os arquivos selecionados ao repositório. Veja <xref linkend="addingfiles"/>. </para -></listitem> +<term><menuchoice><shortcut><keycap>+</keycap></shortcut> <guimenu>Arquivo</guimenu><guimenuitem>Adicionar ao Repositório...</guimenuitem> </menuchoice></term> +<listitem><para>Permite-lhe adicionar os arquivos selecionados ao repositório. Veja <xref linkend="addingfiles"/>. </para></listitem> </varlistentry> <varlistentry> -<term -><menuchoice -><guimenu ->Arquivo</guimenu -><guimenuitem ->Adicionar Binário...</guimenuitem -> </menuchoice -></term> -<listitem -><para ->Permite-lhe adicionar os arquivos selecionados ao repositório como binários (<command ->cvs add<option ->-kb</option -></command ->). Veja <xref linkend="addingfiles"/>. </para -></listitem> +<term><menuchoice><guimenu>Arquivo</guimenu><guimenuitem>Adicionar Binário...</guimenuitem> </menuchoice></term> +<listitem><para>Permite-lhe adicionar os arquivos selecionados ao repositório como binários (<command>cvs add<option>-kb</option></command>). Veja <xref linkend="addingfiles"/>. </para></listitem> </varlistentry> <varlistentry> -<term -><menuchoice -><shortcut -><keycap ->-</keycap -></shortcut -> <guimenu ->Arquivo</guimenu -><guimenuitem ->Remover do Repositório...</guimenuitem -> </menuchoice -></term> -<listitem -><para ->Permite-lhe remover os arquivos selecionados do repositório. Veja <xref linkend="removingfiles"/>. </para -></listitem> +<term><menuchoice><shortcut><keycap>-</keycap></shortcut> <guimenu>Arquivo</guimenu><guimenuitem>Remover do Repositório...</guimenuitem> </menuchoice></term> +<listitem><para>Permite-lhe remover os arquivos selecionados do repositório. Veja <xref linkend="removingfiles"/>. </para></listitem> </varlistentry> <!--TODO: add the revert action to the working with files chapter --> <varlistentry> -<term -><menuchoice -><guimenu ->Arquivo</guimenu -><guimenuitem ->Reverter</guimenuitem -> </menuchoice -></term> -<listitem -><para ->Descarta qualquer mudança local que você tenha feito nos arquivos selecionados e reverte para a versão do repositório (Opção <option ->-C</option -> para o <command ->cvs update</command ->). </para -></listitem> +<term><menuchoice><guimenu>Arquivo</guimenu><guimenuitem>Reverter</guimenuitem> </menuchoice></term> +<listitem><para>Descarta qualquer mudança local que você tenha feito nos arquivos selecionados e reverte para a versão do repositório (Opção <option>-C</option> para o <command>cvs update</command>). </para></listitem> </varlistentry> <varlistentry> -<term -><menuchoice -><shortcut -><keycombo -><keycap ->&Ctrl;</keycap -><keycap ->Q</keycap -></keycombo -></shortcut -> <guimenu ->Arquivo</guimenu -><guimenuitem ->Sair</guimenuitem -> </menuchoice -></term> -<listitem -><para ->Sai do &cervisia;. </para -></listitem> +<term><menuchoice><shortcut><keycombo><keycap>&Ctrl;</keycap><keycap>Q</keycap></keycombo></shortcut> <guimenu>Arquivo</guimenu><guimenuitem>Sair</guimenuitem> </menuchoice></term> +<listitem><para>Sai do &cervisia;. </para></listitem> </varlistentry> </variablelist> @@ -3271,258 +1267,81 @@ Mudanças no repositório <!-- View Menu --> <sect2 id="menuview"> -<title ->O Menu Ver</title> +<title>O Menu Ver</title> <variablelist> <varlistentry> -<term -><menuchoice -><shortcut -><keycap ->Escape</keycap -></shortcut -> <guimenu ->Ver</guimenu -><guimenuitem ->Parar</guimenuitem -> </menuchoice -></term> -<listitem -><para ->Aborta qualquer sub-processo em execução. </para -></listitem> +<term><menuchoice><shortcut><keycap>Escape</keycap></shortcut> <guimenu>Ver</guimenu><guimenuitem>Parar</guimenuitem> </menuchoice></term> +<listitem><para>Aborta qualquer sub-processo em execução. </para></listitem> </varlistentry> <varlistentry> -<term -><menuchoice -><shortcut -><keycombo -><keycap ->&Ctrl;</keycap -><keycap ->L</keycap -></keycombo -></shortcut -> <guimenu ->Ver</guimenu -><guimenuitem ->Navegar Log...</guimenuitem -> </menuchoice -></term> -<listitem -><para ->Mostra o navegador de registro das versões do arquivo selecionado. Veja <xref linkend="browsinglogs"/>. </para -></listitem> +<term><menuchoice><shortcut><keycombo><keycap>&Ctrl;</keycap><keycap>L</keycap></keycombo></shortcut> <guimenu>Ver</guimenu><guimenuitem>Navegar Log...</guimenuitem> </menuchoice></term> +<listitem><para>Mostra o navegador de registro das versões do arquivo selecionado. Veja <xref linkend="browsinglogs"/>. </para></listitem> </varlistentry> <varlistentry> -<term -><menuchoice -><shortcut -><keycombo -><keycap ->&Ctrl;</keycap -><keycap ->A</keycap -></keycombo -></shortcut -> <guimenu ->Ver</guimenu -><guimenuitem ->Anotações...</guimenuitem -> </menuchoice -></term> -<listitem -><para ->Mostra uma visão anotada do arquivo selecionado, ou seja, uma visão onde você pode ver para cada linha qual autor a modificou por último. Veja <xref linkend="annotate"/>. </para -></listitem> +<term><menuchoice><shortcut><keycombo><keycap>&Ctrl;</keycap><keycap>A</keycap></keycombo></shortcut> <guimenu>Ver</guimenu><guimenuitem>Anotações...</guimenuitem> </menuchoice></term> +<listitem><para>Mostra uma visão anotada do arquivo selecionado, ou seja, uma visão onde você pode ver para cada linha qual autor a modificou por último. Veja <xref linkend="annotate"/>. </para></listitem> </varlistentry> <varlistentry> -<term -><menuchoice -><shortcut -><keycombo -><keycap ->&Ctrl;</keycap -><keycap ->D</keycap -></keycombo -></shortcut -> <guimenu ->Ver</guimenu -><guimenuitem ->Diferença para Repositório (BASE)...</guimenuitem -> </menuchoice -></term> -<listitem -><para ->Mostra as diferenças entre o arquivo selecionado na cópia local e a revisão da última atualização (BASE). Veja <xref linkend="diff"/>. </para -></listitem> +<term><menuchoice><shortcut><keycombo><keycap>&Ctrl;</keycap><keycap>D</keycap></keycombo></shortcut> <guimenu>Ver</guimenu><guimenuitem>Diferença para Repositório (BASE)...</guimenuitem> </menuchoice></term> +<listitem><para>Mostra as diferenças entre o arquivo selecionado na cópia local e a revisão da última atualização (BASE). Veja <xref linkend="diff"/>. </para></listitem> </varlistentry> <varlistentry> -<term -><menuchoice -><shortcut -><keycombo -><keycap ->&Ctrl;</keycap -><keycap ->H</keycap -></keycombo -></shortcut -> <guimenu ->Ver</guimenu -><guimenuitem ->Diferença para Repositório (HEAD)...</guimenuitem -> </menuchoice -></term> -<listitem -><para ->Mostra as diferenças entre o arquivo selecionado na cópia local e a revisão da última atualização (HEAD). Veja <xref linkend="diff"/>. </para -></listitem> +<term><menuchoice><shortcut><keycombo><keycap>&Ctrl;</keycap><keycap>H</keycap></keycombo></shortcut> <guimenu>Ver</guimenu><guimenuitem>Diferença para Repositório (HEAD)...</guimenuitem> </menuchoice></term> +<listitem><para>Mostra as diferenças entre o arquivo selecionado na cópia local e a revisão da última atualização (HEAD). Veja <xref linkend="diff"/>. </para></listitem> </varlistentry> <varlistentry> -<term -><menuchoice -><guimenu ->Ver</guimenu -><guimenuitem ->Última Mudança...</guimenuitem -> </menuchoice -></term> -<listitem -><para ->Mostra as diferenças entre a revisão do arquivo selecionado que você atualizou por último (BASE) e a revisão anterior. Veja <xref linkend="diff"/>. </para -></listitem> +<term><menuchoice><guimenu>Ver</guimenu><guimenuitem>Última Mudança...</guimenuitem> </menuchoice></term> +<listitem><para>Mostra as diferenças entre a revisão do arquivo selecionado que você atualizou por último (BASE) e a revisão anterior. Veja <xref linkend="diff"/>. </para></listitem> </varlistentry> <varlistentry> -<term -><menuchoice -><guimenu ->Ver</guimenu -><guimenuitem ->Histórico...</guimenuitem -> </menuchoice -></term> -<listitem -><para ->Mostra o histórico &CVS; como reportado pelo servidor. Veja <xref linkend="browsinghistory"/>. </para -></listitem> +<term><menuchoice><guimenu>Ver</guimenu><guimenuitem>Histórico...</guimenuitem> </menuchoice></term> +<listitem><para>Mostra o histórico &CVS; como reportado pelo servidor. Veja <xref linkend="browsinghistory"/>. </para></listitem> </varlistentry> <!--TODO: add hide menus to mainscreen section--> <varlistentry> -<term -><menuchoice -><guimenu ->Ver</guimenu -><guimenuitem ->Ocultar Todos Arquivos</guimenuitem -> </menuchoice -></term> -<listitem -><para ->Determina se somente pastas são mostradas na visão em árvore principal. Veja <xref linkend="mainscreen"/>. </para -></listitem> +<term><menuchoice><guimenu>Ver</guimenu><guimenuitem>Ocultar Todos Arquivos</guimenuitem> </menuchoice></term> +<listitem><para>Determina se somente pastas são mostradas na visão em árvore principal. Veja <xref linkend="mainscreen"/>. </para></listitem> </varlistentry> <varlistentry> -<term -><menuchoice -><guimenu ->Ver</guimenu -><guimenuitem ->Ocultar Arquivos Não Modificados</guimenuitem -> </menuchoice -></term> -<listitem -><para ->Determina se arquivos desconhecidos e atualizados são ocultos na visão em árvore principal. Veja <xref linkend="mainscreen"/>. </para -></listitem> +<term><menuchoice><guimenu>Ver</guimenu><guimenuitem>Ocultar Arquivos Não Modificados</guimenuitem> </menuchoice></term> +<listitem><para>Determina se arquivos desconhecidos e atualizados são ocultos na visão em árvore principal. Veja <xref linkend="mainscreen"/>. </para></listitem> </varlistentry> <varlistentry> -<term -><menuchoice -><guimenu ->Ver</guimenu -><guimenuitem ->Ocultar Arquivos Removidos</guimenuitem -> </menuchoice -></term> -<listitem -><para ->Determina se os arquivos removidos são ocultos na visão em árvore principal. Veja <xref linkend="mainscreen"/>. </para -></listitem> +<term><menuchoice><guimenu>Ver</guimenu><guimenuitem>Ocultar Arquivos Removidos</guimenuitem> </menuchoice></term> +<listitem><para>Determina se os arquivos removidos são ocultos na visão em árvore principal. Veja <xref linkend="mainscreen"/>. </para></listitem> </varlistentry> <varlistentry> -<term -><menuchoice -><guimenu ->Ver</guimenu -><guimenuitem ->Ocultar Arquivos Não-CVS</guimenuitem -> </menuchoice -></term> -<listitem -><para ->Determina se os arquivos que não estão no CVS são ocultos na visão em árvore principal. Veja <xref linkend="mainscreen"/>. </para -></listitem> +<term><menuchoice><guimenu>Ver</guimenu><guimenuitem>Ocultar Arquivos Não-CVS</guimenuitem> </menuchoice></term> +<listitem><para>Determina se os arquivos que não estão no CVS são ocultos na visão em árvore principal. Veja <xref linkend="mainscreen"/>. </para></listitem> </varlistentry> <varlistentry> -<term -><menuchoice -><guimenu ->Ver</guimenu -><guimenuitem ->Ocultar Pastas Vazias</guimenuitem -> </menuchoice -></term> -<listitem -><para ->Determina se pastas sem entradas visíveis são ocultas na visão em árvore principal. Veja <xref linkend="mainscreen"/>. </para -></listitem> +<term><menuchoice><guimenu>Ver</guimenu><guimenuitem>Ocultar Pastas Vazias</guimenuitem> </menuchoice></term> +<listitem><para>Determina se pastas sem entradas visíveis são ocultas na visão em árvore principal. Veja <xref linkend="mainscreen"/>. </para></listitem> </varlistentry> <varlistentry> -<term -><menuchoice -><guimenu ->Ver</guimenu -><guimenuitem ->Expandir Árvore de Arquivos</guimenuitem -> </menuchoice -></term> -<listitem -><para ->Abre todos os níveis na árvore de arquivos de modo que você possa ver todos os arquivos e pastas. Veja <xref linkend="mainscreen"/>. </para -></listitem> +<term><menuchoice><guimenu>Ver</guimenu><guimenuitem>Expandir Árvore de Arquivos</guimenuitem> </menuchoice></term> +<listitem><para>Abre todos os níveis na árvore de arquivos de modo que você possa ver todos os arquivos e pastas. Veja <xref linkend="mainscreen"/>. </para></listitem> </varlistentry> <varlistentry> -<term -><menuchoice -><guimenu ->Ver</guimenu -><guimenuitem ->Colapsar Árvore de Arquivos</guimenuitem -> </menuchoice -></term> -<listitem -><para ->Fecha todas as ramificações na árvore de arquivos. Veja <xref linkend="mainscreen"/>. </para -></listitem> +<term><menuchoice><guimenu>Ver</guimenu><guimenuitem>Colapsar Árvore de Arquivos</guimenuitem> </menuchoice></term> +<listitem><para>Fecha todas as ramificações na árvore de arquivos. Veja <xref linkend="mainscreen"/>. </para></listitem> </varlistentry> </variablelist> @@ -3532,224 +1351,77 @@ Mudanças no repositório <!-- Advanced Menu --> <sect2 id="menuadvanced"> -<title ->O Menu Avançado</title> +<title>O Menu Avançado</title> <variablelist> <varlistentry> -<term -><menuchoice -><guimenu ->Avançado</guimenu -><guimenuitem ->Tag/Ramificação...</guimenuitem -> </menuchoice -></term> -<listitem -><para ->Cria tags ou ramificações para os arquivos selecionados. Veja <xref linkend="taggingbranching"/>. </para -></listitem> +<term><menuchoice><guimenu>Avançado</guimenu><guimenuitem>Tag/Ramificação...</guimenuitem> </menuchoice></term> +<listitem><para>Cria tags ou ramificações para os arquivos selecionados. Veja <xref linkend="taggingbranching"/>. </para></listitem> </varlistentry> <varlistentry> -<term -><menuchoice -><guimenu ->Avançado</guimenu -><guimenuitem ->Excluir Tag...</guimenuitem -> </menuchoice -></term> -<listitem -><para ->Remove uma tag fornecida dos arquivos selecionados. Veja <xref linkend="taggingbranching"/>. </para -></listitem> +<term><menuchoice><guimenu>Avançado</guimenu><guimenuitem>Excluir Tag...</guimenuitem> </menuchoice></term> +<listitem><para>Remove uma tag fornecida dos arquivos selecionados. Veja <xref linkend="taggingbranching"/>. </para></listitem> </varlistentry> <varlistentry> -<term -><menuchoice -><guimenu ->Avançado</guimenu -><guimenuitem ->Atualizar para Tag/Data...</guimenuitem -> </menuchoice -></term> -<listitem -><para ->Traz os arquivos selecionados para uma tag ou data fornecida, pregando-os. Veja <xref linkend="updatingto"/>. </para -></listitem> +<term><menuchoice><guimenu>Avançado</guimenu><guimenuitem>Atualizar para Tag/Data...</guimenuitem> </menuchoice></term> +<listitem><para>Traz os arquivos selecionados para uma tag ou data fornecida, pregando-os. Veja <xref linkend="updatingto"/>. </para></listitem> </varlistentry> <varlistentry> -<term -><menuchoice -><guimenu ->Avançado</guimenu -><guimenuitem ->Atualizar para HEAD...</guimenuitem -> </menuchoice -></term> -<listitem -><para ->Traz os arquivos selecionados para a revisão HEAD respectiva. Veja <xref linkend="updatingto"/>. </para -></listitem> +<term><menuchoice><guimenu>Avançado</guimenu><guimenuitem>Atualizar para HEAD...</guimenuitem> </menuchoice></term> +<listitem><para>Traz os arquivos selecionados para a revisão HEAD respectiva. Veja <xref linkend="updatingto"/>. </para></listitem> </varlistentry> <varlistentry> -<term -><menuchoice -><guimenu ->Avançado</guimenu -><guimenuitem ->Mesclar...</guimenuitem -> </menuchoice -></term> -<listitem -><para ->Mescla uma ramificação fornecida ou as modificações entre duas tags nos arquivos selecionados. Veja <xref linkend="taggingbranching"/>. </para -></listitem> +<term><menuchoice><guimenu>Avançado</guimenu><guimenuitem>Mesclar...</guimenuitem> </menuchoice></term> +<listitem><para>Mescla uma ramificação fornecida ou as modificações entre duas tags nos arquivos selecionados. Veja <xref linkend="taggingbranching"/>. </para></listitem> </varlistentry> <varlistentry> -<term -><menuchoice -><guimenu ->Avançado</guimenu -><guimenuitem ->Adicionar Monitor...</guimenuitem -> </menuchoice -></term> -<listitem -><para ->Adiciona um monitor para um conjunto de eventos dos arquivos selecionados. Veja <xref linkend="watches"/>. </para -></listitem> +<term><menuchoice><guimenu>Avançado</guimenu><guimenuitem>Adicionar Monitor...</guimenuitem> </menuchoice></term> +<listitem><para>Adiciona um monitor para um conjunto de eventos dos arquivos selecionados. Veja <xref linkend="watches"/>. </para></listitem> </varlistentry> <varlistentry> -<term -><menuchoice -><guimenu ->Avançado</guimenu -><guimenuitem ->Remover Monitor...</guimenuitem -> </menuchoice -></term> -<listitem -><para ->Remove um monitor para um conjunto de eventos dos arquivos selecionados. Veja <xref linkend="watches"/>. </para -></listitem> +<term><menuchoice><guimenu>Avançado</guimenu><guimenuitem>Remover Monitor...</guimenuitem> </menuchoice></term> +<listitem><para>Remove um monitor para um conjunto de eventos dos arquivos selecionados. Veja <xref linkend="watches"/>. </para></listitem> </varlistentry> <varlistentry> -<term -><menuchoice -><guimenu ->Avançado</guimenu -><guimenuitem ->Mostrar Monitores</guimenuitem -> </menuchoice -></term> -<listitem -><para ->Lista os monitores dos arquivos selecionados. Veja <xref linkend="watches"/>. </para -></listitem> +<term><menuchoice><guimenu>Avançado</guimenu><guimenuitem>Mostrar Monitores</guimenuitem> </menuchoice></term> +<listitem><para>Lista os monitores dos arquivos selecionados. Veja <xref linkend="watches"/>. </para></listitem> </varlistentry> <varlistentry> -<term -><menuchoice -><guimenu ->Avançado</guimenu -><guimenuitem ->Editar</guimenuitem -> </menuchoice -></term> -<listitem -><para ->Executa um <command ->cvs edit</command -> nos arquivos selecionados. Veja <xref linkend="watches"/>. </para -></listitem> +<term><menuchoice><guimenu>Avançado</guimenu><guimenuitem>Editar</guimenuitem> </menuchoice></term> +<listitem><para>Executa um <command>cvs edit</command> nos arquivos selecionados. Veja <xref linkend="watches"/>. </para></listitem> </varlistentry> <varlistentry> -<term -><menuchoice -><guimenu ->Avançado</guimenu -><guimenuitem ->Cancelar edição</guimenuitem -> </menuchoice -></term> -<listitem -><para ->Executa um <command ->cvs unedit</command -> nos arquivos selecionados. Veja <xref linkend="watches"/>. </para -></listitem> +<term><menuchoice><guimenu>Avançado</guimenu><guimenuitem>Cancelar edição</guimenuitem> </menuchoice></term> +<listitem><para>Executa um <command>cvs unedit</command> nos arquivos selecionados. Veja <xref linkend="watches"/>. </para></listitem> </varlistentry> <varlistentry> -<term -><menuchoice -><guimenu ->Avançado</guimenu -><guimenuitem ->Mostrar Editores</guimenuitem -> </menuchoice -></term> -<listitem -><para ->Executa um <command ->cvs editors</command -> nos arquivos selecionados. Veja <xref linkend="watches"/>. </para -></listitem> +<term><menuchoice><guimenu>Avançado</guimenu><guimenuitem>Mostrar Editores</guimenuitem> </menuchoice></term> +<listitem><para>Executa um <command>cvs editors</command> nos arquivos selecionados. Veja <xref linkend="watches"/>. </para></listitem> </varlistentry> <varlistentry> -<term -><menuchoice -><guimenu ->Avançado</guimenu -><guimenuitem ->Travar</guimenuitem -> </menuchoice -></term> -<listitem -><para ->Trava os arquivos selecionados. Veja <xref linkend="locking"/>. </para -></listitem> +<term><menuchoice><guimenu>Avançado</guimenu><guimenuitem>Travar</guimenuitem> </menuchoice></term> +<listitem><para>Trava os arquivos selecionados. Veja <xref linkend="locking"/>. </para></listitem> </varlistentry> <varlistentry> -<term -><menuchoice -><guimenu ->Avançado</guimenu -><guimenuitem ->Destravar</guimenuitem -> </menuchoice -></term> -<listitem -><para ->Destrava os arquivos selecionados. Veja <xref linkend="locking"/>. </para -></listitem> +<term><menuchoice><guimenu>Avançado</guimenu><guimenuitem>Destravar</guimenuitem> </menuchoice></term> +<listitem><para>Destrava os arquivos selecionados. Veja <xref linkend="locking"/>. </para></listitem> </varlistentry> <varlistentry> -<term -><menuchoice -><guimenu ->Avançado</guimenu -><guimenuitem ->Criar Remendo Contra Repositório...</guimenuitem -> </menuchoice -></term> -<listitem -><para ->Cria um remendo a partir das modificações em sua cópia local. Veja <xref linkend="creatingpatches"/>. </para -></listitem> +<term><menuchoice><guimenu>Avançado</guimenu><guimenuitem>Criar Remendo Contra Repositório...</guimenuitem> </menuchoice></term> +<listitem><para>Cria um remendo a partir das modificações em sua cópia local. Veja <xref linkend="creatingpatches"/>. </para></listitem> </varlistentry> </variablelist> @@ -3759,69 +1431,28 @@ Mudanças no repositório <!-- Repository Menu --> <sect2 id="menurepository"> -<title ->O Menu Repositório</title> +<title>O Menu Repositório</title> <variablelist> <varlistentry> -<term -><menuchoice -><guimenu ->Repositório</guimenu -><guimenuitem ->Criar...</guimenuitem -> </menuchoice -></term> -<listitem -><para ->Abre um diálogo que lhe permite criar um novo repositório local. Veja <xref linkend="accessing-repository"/>. </para -></listitem> +<term><menuchoice><guimenu>Repositório</guimenu><guimenuitem>Criar...</guimenuitem> </menuchoice></term> +<listitem><para>Abre um diálogo que lhe permite criar um novo repositório local. Veja <xref linkend="accessing-repository"/>. </para></listitem> </varlistentry> <varlistentry> -<term -><menuchoice -><guimenu ->Repositório</guimenu -><guimenuitem ->Verificar...</guimenuitem -> </menuchoice -></term> -<listitem -><para ->Abre um diálogo que lhe permite verificar um módulo a partir de um repositório. Veja <xref linkend="checkingout"/>. </para -></listitem> +<term><menuchoice><guimenu>Repositório</guimenu><guimenuitem>Verificar...</guimenuitem> </menuchoice></term> +<listitem><para>Abre um diálogo que lhe permite verificar um módulo a partir de um repositório. Veja <xref linkend="checkingout"/>. </para></listitem> </varlistentry> <varlistentry> -<term -><menuchoice -><guimenu ->Repositório</guimenu -><guimenuitem ->Importar...</guimenuitem -> </menuchoice -></term> -<listitem -><para ->Abre um diálogo que lhe permite importar um pacote para o repositório. Veja <xref linkend="importing"/>. </para -></listitem> +<term><menuchoice><guimenu>Repositório</guimenu><guimenuitem>Importar...</guimenuitem> </menuchoice></term> +<listitem><para>Abre um diálogo que lhe permite importar um pacote para o repositório. Veja <xref linkend="importing"/>. </para></listitem> </varlistentry> <varlistentry> -<term -><menuchoice -><guimenu ->Repositório</guimenu -><guimenuitem ->Repositórios...</guimenuitem -> </menuchoice -></term> -<listitem -><para ->Configura uma lista de repositórios que você freqüentemente usa e como acessá-los. Veja <xref linkend="accessing-repository"/>. </para -></listitem> +<term><menuchoice><guimenu>Repositório</guimenu><guimenuitem>Repositórios...</guimenuitem> </menuchoice></term> +<listitem><para>Configura uma lista de repositórios que você freqüentemente usa e como acessá-los. Veja <xref linkend="accessing-repository"/>. </para></listitem> </varlistentry> </variablelist> @@ -3830,164 +1461,53 @@ Mudanças no repositório <!-- Settings Menu --> <sect2 id="menuoptions"> -<title ->O Menu Configurações</title> +<title>O Menu Configurações</title> <variablelist> <varlistentry> -<term -><menuchoice -><guimenu ->Configurações</guimenu -><guimenuitem ->Mostrar Barra de Ferramentas</guimenuitem -> </menuchoice -></term> -<listitem -><para ->Determina se a barra de ferramentas é exibida. </para -></listitem> +<term><menuchoice><guimenu>Configurações</guimenu><guimenuitem>Mostrar Barra de Ferramentas</guimenuitem> </menuchoice></term> +<listitem><para>Determina se a barra de ferramentas é exibida. </para></listitem> </varlistentry> <varlistentry> -<term -><menuchoice -><guimenu ->Configurações</guimenu -><guimenuitem ->Criar Pastas ao Atualizar</guimenuitem -> </menuchoice -></term> -<listitem -><para ->Determina se atualizações criam pastas na cópia local quando elas ainda não existirem (Opção <option ->-d</option -> do <command ->cvs update</command ->). </para -></listitem> +<term><menuchoice><guimenu>Configurações</guimenu><guimenuitem>Criar Pastas ao Atualizar</guimenuitem> </menuchoice></term> +<listitem><para>Determina se atualizações criam pastas na cópia local quando elas ainda não existirem (Opção <option>-d</option> do <command>cvs update</command>). </para></listitem> </varlistentry> <varlistentry> -<term -><menuchoice -><guimenu ->Configurações</guimenu -><guimenuitem ->Excluir Pastas Vazias ao Atualizar</guimenuitem -> </menuchoice -></term> -<listitem -><para ->Determina se atualizações removem pastas vazias na cópia local (Opção <option ->-P</option -> do <command ->cvs update</command ->). </para -></listitem> +<term><menuchoice><guimenu>Configurações</guimenu><guimenuitem>Excluir Pastas Vazias ao Atualizar</guimenuitem> </menuchoice></term> +<listitem><para>Determina se atualizações removem pastas vazias na cópia local (Opção <option>-P</option> do <command>cvs update</command>). </para></listitem> </varlistentry> <varlistentry> -<term -><menuchoice -><guimenu ->Configurações</guimenu -><guimenuitem ->Atualizar Recursivamente</guimenuitem -> </menuchoice -></term> -<listitem -><para ->Determina se atualizações são recursivas (Opção <option ->-r</option -> do <command ->cvs update</command ->). </para -></listitem> +<term><menuchoice><guimenu>Configurações</guimenu><guimenuitem>Atualizar Recursivamente</guimenuitem> </menuchoice></term> +<listitem><para>Determina se atualizações são recursivas (Opção <option>-r</option> do <command>cvs update</command>). </para></listitem> </varlistentry> <varlistentry> -<term -><menuchoice -><guimenu ->Configurações</guimenu -><guimenuitem ->Enviar e Remover Recursivamente</guimenuitem -> </menuchoice -></term> -<listitem -><para ->Determina se os envios e exclusões são recursivos (Opção <option ->-r</option -> do <command ->cvs add</command ->, <command ->cvs remove</command -> respectivamente.). </para -></listitem> +<term><menuchoice><guimenu>Configurações</guimenu><guimenuitem>Enviar e Remover Recursivamente</guimenuitem> </menuchoice></term> +<listitem><para>Determina se os envios e exclusões são recursivos (Opção <option>-r</option> do <command>cvs add</command>, <command>cvs remove</command> respectivamente.). </para></listitem> </varlistentry> <varlistentry> -<term -><menuchoice -><guimenu ->Configurações</guimenu -><guimenuitem ->Executar cvs edit Automaticamente Quando Necessário</guimenuitem -> </menuchoice -></term> -<listitem -><para ->Determina se o <command ->cvs edit</command -> é executado automaticamente sempre que você edita um arquivo. </para -></listitem> +<term><menuchoice><guimenu>Configurações</guimenu><guimenuitem>Executar cvs edit Automaticamente Quando Necessário</guimenuitem> </menuchoice></term> +<listitem><para>Determina se o <command>cvs edit</command> é executado automaticamente sempre que você edita um arquivo. </para></listitem> </varlistentry> <varlistentry> -<term -><menuchoice -><guimenu ->Configurações</guimenu -><guimenuitem ->Configurar Atalhos...</guimenuitem -> </menuchoice -></term> -<listitem -><para ->Abre um diálogo para configurar atalhos de teclado. </para -></listitem> +<term><menuchoice><guimenu>Configurações</guimenu><guimenuitem>Configurar Atalhos...</guimenuitem> </menuchoice></term> +<listitem><para>Abre um diálogo para configurar atalhos de teclado. </para></listitem> </varlistentry> <varlistentry> -<term -><menuchoice -><guimenu ->Configurações</guimenu -><guimenuitem ->Configurar Barras de Ferramentas...</guimenuitem -> </menuchoice -></term> -<listitem -><para ->Abre um diálogo para configuração das barras de ferramentas do &cervisia;. </para -></listitem> +<term><menuchoice><guimenu>Configurações</guimenu><guimenuitem>Configurar Barras de Ferramentas...</guimenuitem> </menuchoice></term> +<listitem><para>Abre um diálogo para configuração das barras de ferramentas do &cervisia;. </para></listitem> </varlistentry> <varlistentry> -<term -><menuchoice -><guimenu ->Configurações</guimenu -><guimenuitem ->Configurar o Cervisia...</guimenuitem -> </menuchoice -></term> -<listitem -><para ->Abre um diálogo para personalização do &cervisia;. </para -></listitem> +<term><menuchoice><guimenu>Configurações</guimenu><guimenuitem>Configurar o Cervisia...</guimenuitem> </menuchoice></term> +<listitem><para>Abre um diálogo para personalização do &cervisia;. </para></listitem> </varlistentry> </variablelist> @@ -3996,88 +1516,33 @@ Mudanças no repositório <!-- Help --> <sect2 id="menuhelp"> -<title ->O Menu Ajuda</title> +<title>O Menu Ajuda</title> <variablelist> <varlistentry> -<term -><menuchoice -><shortcut -><keycap ->F1</keycap -></shortcut -> <guimenu ->Ajuda</guimenu -><guimenuitem ->Manual do Cervisia</guimenuitem -> </menuchoice -></term> -<listitem -><para ->Invoca o sistema de ajuda do KDE iniciando as páginas de ajuda do &cervisia; (este documento). </para -></listitem> +<term><menuchoice><shortcut><keycap>F1</keycap></shortcut> <guimenu>Ajuda</guimenu><guimenuitem>Manual do Cervisia</guimenuitem> </menuchoice></term> +<listitem><para>Invoca o sistema de ajuda do KDE iniciando as páginas de ajuda do &cervisia; (este documento). </para></listitem> </varlistentry> <varlistentry> -<term -><menuchoice -><guimenu ->Ajuda</guimenu -><guimenuitem ->Reportar Erro...</guimenuitem -> </menuchoice -></term> -<listitem -><para ->Abre um diálogo de relatório de Erro. </para -></listitem> +<term><menuchoice><guimenu>Ajuda</guimenu><guimenuitem>Reportar Erro...</guimenuitem> </menuchoice></term> +<listitem><para>Abre um diálogo de relatório de Erro. </para></listitem> </varlistentry> <varlistentry> -<term -><menuchoice -><guimenu ->Ajuda</guimenu -> <guimenuitem ->Sobre o &cervisia;</guimenuitem -> </menuchoice -></term> -<listitem -><para ->Isto exibirá informações sobre a versão e o autor. </para -></listitem> +<term><menuchoice><guimenu>Ajuda</guimenu> <guimenuitem>Sobre o &cervisia;</guimenuitem> </menuchoice></term> +<listitem><para>Isto exibirá informações sobre a versão e o autor. </para></listitem> </varlistentry> <varlistentry> -<term -><menuchoice -><guimenu ->Ajuda</guimenu -><guimenuitem ->Sobre o KDE</guimenuitem -> </menuchoice -></term> -<listitem -><para ->Isto exibe a versão do KDE e outras informações básicas. </para -></listitem> +<term><menuchoice><guimenu>Ajuda</guimenu><guimenuitem>Sobre o KDE</guimenuitem> </menuchoice></term> +<listitem><para>Isto exibe a versão do KDE e outras informações básicas. </para></listitem> </varlistentry> <varlistentry> -<term -><menuchoice -><guimenu ->Ajuda</guimenu -><guimenuitem ->Manual do CVS</guimenuitem -> </menuchoice -></term> -<listitem -><para ->Abre as páginas de informação do &CVS; no sistema de ajuda do KDE. </para -></listitem> +<term><menuchoice><guimenu>Ajuda</guimenu><guimenuitem>Manual do CVS</guimenuitem> </menuchoice></term> +<listitem><para>Abre as páginas de informação do &CVS; no sistema de ajuda do KDE. </para></listitem> </varlistentry> </variablelist> @@ -4090,7 +1555,6 @@ Mudanças no repositório <chapter id="credits-and-licenses"> -<title ->Créditos E Licenças</title> +<title>Créditos E Licenças</title> &underFDL; &underGPL; </chapter> </book> diff --git a/tde-i18n-pt_BR/docs/tdesdk/kapptemplate/man-kapptemplate.1.docbook b/tde-i18n-pt_BR/docs/tdesdk/kapptemplate/man-kapptemplate.1.docbook index f0017aa8034..33dddc7b69f 100644 --- a/tde-i18n-pt_BR/docs/tdesdk/kapptemplate/man-kapptemplate.1.docbook +++ b/tde-i18n-pt_BR/docs/tdesdk/kapptemplate/man-kapptemplate.1.docbook @@ -5,174 +5,70 @@ <refentry lang="&language;"> <refentryinfo> -<author -><personname -><firstname ->Ben</firstname -><surname ->Burton</surname -></personname -> <email -></email -></author> -<date ->12 de Abril de 2003</date> +<author><personname><firstname>Ben</firstname><surname>Burton</surname></personname> <email></email></author> +<date>12 de Abril de 2003</date> </refentryinfo> <refmeta> -<refentrytitle -><command ->kapptemplate</command -></refentrytitle> -<manvolnum ->1</manvolnum> +<refentrytitle><command>kapptemplate</command></refentrytitle> +<manvolnum>1</manvolnum> </refmeta> <refnamediv> -<refname -><command ->kapptemplate</command -></refname> -<refpurpose ->Cria a infra-estrutura para desenvolver um aplicativo para o KDE</refpurpose> +<refname><command>kapptemplate</command></refname> +<refpurpose>Cria a infra-estrutura para desenvolver um aplicativo para o KDE</refpurpose> </refnamediv> <refsynopsisdiv> -<cmdsynopsis -><command ->kapptemplate</command -> <group -><option ->--noinit</option -></group -> <group -><option ->--default</option -></group -> <group -><option ->--full-app</option -></group -> <group -><option ->--kpart-app</option -></group -> <group -><option ->--kpart-plugin</option -></group -> <group -><option ->--existing</option -></group -> <group -><option ->--help</option -></group -> </cmdsynopsis> +<cmdsynopsis><command>kapptemplate</command> <group><option>--noinit</option></group> <group><option>--default</option></group> <group><option>--full-app</option></group> <group><option>--kpart-app</option></group> <group><option>--kpart-plugin</option></group> <group><option>--existing</option></group> <group><option>--help</option></group> </cmdsynopsis> </refsynopsisdiv> <refsect1> -<title ->Descrição</title> +<title>Descrição</title> -<para ->O <command ->kapptemplate</command -> é um programa para console que irá criar a infra-estrutura necessária para desenvolver vários aplicativos do &kde;. Ele toma conta do código do autoconf/automake, assim como fornece um esqueleto e um exemplo de como ficará o código, tipicamente. </para> +<para>O <command>kapptemplate</command> é um programa para console que irá criar a infra-estrutura necessária para desenvolver vários aplicativos do &kde;. Ele toma conta do código do autoconf/automake, assim como fornece um esqueleto e um exemplo de como ficará o código, tipicamente. </para> -<para ->Este utilitário faz parte do Kit de Desenvolvimento de Software (SDK) do &kde;. </para> +<para>Este utilitário faz parte do Kit de Desenvolvimento de Software (SDK) do &kde;. </para> </refsect1> <refsect1> -<title ->Opções</title> +<title>Opções</title> <variablelist> -<title ->Opções Gerais</title> +<title>Opções Gerais</title> <varlistentry> -<term -><option ->--help</option -></term> -<listitem -><para ->Mostra um resumo completo das opções. </para -></listitem> +<term><option>--help</option></term> +<listitem><para>Mostra um resumo completo das opções. </para></listitem> </varlistentry> <varlistentry> -<term -><option ->--no-init</option -></term> -<listitem -><para ->Não executa o <command ->make</command -> <option ->-f</option -> <parameter ->Makefile.cvs</parameter -></para> +<term><option>--no-init</option></term> +<listitem><para>Não executa o <command>make</command> <option>-f</option> <parameter>Makefile.cvs</parameter></para> </listitem> </varlistentry> <varlistentry> -<term -><option ->--default</option -></term> -<listitem -><para ->Usa os valores padrão em vez de perguntá-los.</para -></listitem> +<term><option>--default</option></term> +<listitem><para>Usa os valores padrão em vez de perguntá-los.</para></listitem> </varlistentry> </variablelist> <variablelist> -<title ->Tipos de Infra-Estruturas</title> +<title>Tipos de Infra-Estruturas</title> <varlistentry> -<term -><option ->--full-app</option -></term> -<listitem -><para ->Cria um aplicativo completo do KDE. </para -></listitem> +<term><option>--full-app</option></term> +<listitem><para>Cria um aplicativo completo do KDE. </para></listitem> </varlistentry> <varlistentry> -<term -><option ->--kpart-app</option -></term> -<listitem -><para ->Cria um aplicativo KPart completo.</para -></listitem> +<term><option>--kpart-app</option></term> +<listitem><para>Cria um aplicativo KPart completo.</para></listitem> </varlistentry> <varlistentry> -<term -><option ->--kpart-plugin</option -></term> -<listitem -><para ->Cria a infra-estrutura para um plugin do KPart.</para -></listitem> +<term><option>--kpart-plugin</option></term> +<listitem><para>Cria a infra-estrutura para um plugin do KPart.</para></listitem> </varlistentry> <varlistentry> -<term -><option ->--existing</option -></term> -<listitem -><para ->Converte o código existente para uma infra-estrutura do KDE baseada no automake/autoconf.</para -></listitem> +<term><option>--existing</option></term> +<listitem><para>Converte o código existente para uma infra-estrutura do KDE baseada no automake/autoconf.</para></listitem> </varlistentry> </variablelist> </refsect1> @@ -181,53 +77,29 @@ applicable. --> <refsect1> -<title ->Arquivos</title> +<title>Arquivos</title> <variablelist> <varlistentry> -<term -><filename ->~/.kapptemplate</filename -></term> -<listitem -><para ->Guarda os valores padrão</para -></listitem> +<term><filename>~/.kapptemplate</filename></term> +<listitem><para>Guarda os valores padrão</para></listitem> </varlistentry> </variablelist> </refsect1> <refsect1> -<title ->Veja Também</title> +<title>Veja Também</title> -<para -><filename ->$PREFIX/share/doc/kapptemplate</filename -></para> +<para><filename>$PREFIX/share/doc/kapptemplate</filename></para> </refsect1> <refsect1> -<title ->Autores</title> - -<para ->O <command ->kapptemplate</command -> foi criado por &Kurt.Granroth; &Kurt.Granroth.mail;</para> -<para ->Esta página de manual foi preparada por <personname -><firstname ->Ben</firstname -><surname ->Burton</surname -></personname -><email ->bab@debian.org</email -></para> +<title>Autores</title> + +<para>O <command>kapptemplate</command> foi criado por &Kurt.Granroth; &Kurt.Granroth.mail;</para> +<para>Esta página de manual foi preparada por <personname><firstname>Ben</firstname><surname>Burton</surname></personname><email>bab@debian.org</email></para> </refsect1> </refentry> diff --git a/tde-i18n-pt_BR/docs/tdesdk/kbabel/catman.docbook b/tde-i18n-pt_BR/docs/tdesdk/kbabel/catman.docbook index 8ff69ae2927..a43800e90af 100644 --- a/tde-i18n-pt_BR/docs/tdesdk/kbabel/catman.docbook +++ b/tde-i18n-pt_BR/docs/tdesdk/kbabel/catman.docbook @@ -1,6 +1,5 @@ <!-- <?xml version="1.0" ?> -<!DOCTYPE chapter PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" -> --> +<!DOCTYPE chapter PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd"> --> <!-- Uncomment the previous two lines to validate this document --> <!-- standalone. Be sure to recomment them before attempting to --> <!-- process index.docbook --> @@ -11,79 +10,30 @@ <!-- Fill in this section if this document has a different author --> <authorgroup> <author> -<personname -><firstname -></firstname -><surname -></surname -></personname> +<personname><firstname></firstname><surname></surname></personname> </author> </authorgroup> -<othercredit role="translator" -><firstname ->Marcus</firstname -><surname ->Gama</surname -><affiliation -><address -><email ->marcus.gama@gmail.com</email -></address -></affiliation -><contrib ->Tradução</contrib -></othercredit -> +<othercredit role="translator"><firstname>Marcus</firstname><surname>Gama</surname><affiliation><address><email>marcus.gama@gmail.com</email></address></affiliation><contrib>Tradução</contrib></othercredit> </chapterinfo> -<title ->Usando o &catalogmanager;</title> +<title>Usando o &catalogmanager;</title> <anchor id="catalogmanager"/> <screenshot> -<screeninfo ->Captura de tela do &catalogmanager;</screeninfo> +<screeninfo>Captura de tela do &catalogmanager;</screeninfo> <mediaobject> <imageobject> <imagedata fileref="snap_catalogmanager.png" format="PNG"/> </imageobject> -<textobject -><phrase ->Captura de tela do &catalogmanager;</phrase -></textobject> +<textobject><phrase>Captura de tela do &catalogmanager;</phrase></textobject> </mediaobject> </screenshot> -<para ->O Gerenciador de Catálogo mescla duas pastas numa árvore e exibe todos os arquivos <acronym ->PO</acronym -> e <acronym ->POT</acronym -> destas pastas. A exibição permite-lhe facilmente ver se um novo modelo foi adicionado ou um arquivo antigo foi removido. Algumas informações são mostradas ao lado de cada nome de arquivo: número total de entradas, número de entradas aproximadas, número de entradas não traduzidas, a data da última revisão e o último tradutor do arquivo. </para> - -<important -><para ->O Gerenciador de Catálogos do KBabel foi criado para ser usado em projetos estruturados, como o KDE, em que os arquivos <acronym ->POT</acronym -> e <acronym ->PO</acronym -> compartilham o mesmo nome, excetuando as extensões. Contudo, este não é o caso dos projetos da &GNU; e de muitos outros projetos estruturados como os da &GNU;. Tipicamente, nesses projetos, o arquivo <acronym ->PO</acronym -> tem o nome do código do idioma e, como tal, é muito diferente do nome dos arquivos <acronym ->POT</acronym ->. Também esses projetos possuem um arquivo <acronym ->POT</acronym -> que compartilha a mesma pasta que todos os seus arquivos <acronym ->PO</acronym -> traduzidos. Infelizmente, todas estas razões servem para explicar porque o Gerenciador de Catálogos <emphasis ->não</emphasis -> é adequado para esses projetos. (Veja o <ulink url="http://bugs.kde.org/show_bug.cgi?id=76495" ->Bug #76495 do KDE</ulink ->.) </para -></important> - -<para ->Para tornar fácil para você encontrar arquivos que necessitam de trabalho ou que estão faltando, o estado de cada arquivo é também exibido usando um ícone: </para> +<para>O Gerenciador de Catálogo mescla duas pastas numa árvore e exibe todos os arquivos <acronym>PO</acronym> e <acronym>POT</acronym> destas pastas. A exibição permite-lhe facilmente ver se um novo modelo foi adicionado ou um arquivo antigo foi removido. Algumas informações são mostradas ao lado de cada nome de arquivo: número total de entradas, número de entradas aproximadas, número de entradas não traduzidas, a data da última revisão e o último tradutor do arquivo. </para> + +<important><para>O Gerenciador de Catálogos do KBabel foi criado para ser usado em projetos estruturados, como o KDE, em que os arquivos <acronym>POT</acronym> e <acronym>PO</acronym> compartilham o mesmo nome, excetuando as extensões. Contudo, este não é o caso dos projetos da &GNU; e de muitos outros projetos estruturados como os da &GNU;. Tipicamente, nesses projetos, o arquivo <acronym>PO</acronym> tem o nome do código do idioma e, como tal, é muito diferente do nome dos arquivos <acronym>POT</acronym>. Também esses projetos possuem um arquivo <acronym>POT</acronym> que compartilha a mesma pasta que todos os seus arquivos <acronym>PO</acronym> traduzidos. Infelizmente, todas estas razões servem para explicar porque o Gerenciador de Catálogos <emphasis>não</emphasis> é adequado para esses projetos. (Veja o <ulink url="http://bugs.kde.org/show_bug.cgi?id=76495">Bug #76495 do KDE</ulink>.) </para></important> + +<para>Para tornar fácil para você encontrar arquivos que necessitam de trabalho ou que estão faltando, o estado de cada arquivo é também exibido usando um ícone: </para> <itemizedlist> <listitem> @@ -92,8 +42,7 @@ <imageobject> <imagedata fileref="catalogmanager_ok.png" format="PNG"/> </imageobject> -</inlinemediaobject -> Todas as mensagens neste arquivo estão traduzidas.</para> +</inlinemediaobject> Todas as mensagens neste arquivo estão traduzidas.</para> </listitem> <listitem> <para> @@ -101,8 +50,7 @@ <imageobject> <imagedata fileref="catalogmanager_needwork.png" format="PNG"/> </imageobject> -</inlinemediaobject -> Algumas mensagens neste arquivos são aproximadas ou não traduzidas </para> +</inlinemediaobject> Algumas mensagens neste arquivos são aproximadas ou não traduzidas </para> </listitem> <listitem> <para> @@ -110,10 +58,7 @@ <imageobject> <imagedata fileref="catalogmanager_missing.png" format="PNG"/> </imageobject> -</inlinemediaobject -> Este arquivo não existe na pasta de arquivos <acronym ->PO</acronym ->. </para> +</inlinemediaobject> Este arquivo não existe na pasta de arquivos <acronym>PO</acronym>. </para> </listitem> <listitem> <para> @@ -121,8 +66,7 @@ <imageobject> <imagedata fileref="catalogmanager_broken.png" format="PNG"/> </imageobject> -</inlinemediaobject -> Este arquivo contém erros de sintaxe. </para> +</inlinemediaobject> Este arquivo contém erros de sintaxe. </para> </listitem> <listitem> <para> @@ -130,107 +74,44 @@ <imageobject> <imagedata fileref="catalogmanager_reload.png" format="PNG"/> </imageobject> -</inlinemediaobject -> Informações sobre este arquivo estão atualmente sendo atualizadas. Quando a atualização terminar, aparecerá um dos ícones listados abaixo para refletir seu estado. </para> +</inlinemediaobject> Informações sobre este arquivo estão atualmente sendo atualizadas. Quando a atualização terminar, aparecerá um dos ícones listados abaixo para refletir seu estado. </para> </listitem> </itemizedlist> -<para ->Se um ícone é marcado com este ícone <inlinemediaobject -> <imageobject -> <imagedata fileref="catalogmanager_nopot.png" format="PNG"/> </imageobject -> </inlinemediaobject ->, como <inlinemediaobject -> <imageobject -> <imagedata fileref="catalogmanager_nopot_ok.png" format="PNG"/> </imageobject -> </inlinemediaobject ->, isto indica que este arquivo ou pasta não existe na pasta de arquivos <acronym ->POT</acronym ->.</para> - -<para ->Você pode marcar ou desmarcar um arquivo selecionando <guimenuitem ->Alternar Marca</guimenuitem -> no menu de contexto de um arquivo.</para> - -<para ->Se você deseja alternar ou remover todas as marcas numa pasta, pressione o botão direito do mouse sobre a pasta e selecione <guimenuitem ->Alternar Marcas</guimenuitem -> ou <guimenuitem ->Remover Marcas</guimenuitem ->. As marcas serão automaticamente salvas quando sair do &kbabel;.</para> - -<para ->Para abrir um arquivo você pode dar um duplo-clique nele, selecionar <menuchoice -><guimenuitem ->Abrir</guimenuitem -></menuchoice -> no menu de contexto, pressionar <keycap ->Return</keycap -> ou <keycombo action="simul" ->&Ctrl;<keycap ->O</keycap -> </keycombo ->.</para> - -<para ->Você poderá configurar o &catalogmanager; em <menuchoice -><guimenu ->Projeto</guimenu -><guimenuitem -> Configurar...</guimenuitem -></menuchoice ->. Veja a seção <link linkend="preferences-project-settings" ->Configuração do Projeto</link -> para mais detalhes.</para> +<para>Se um ícone é marcado com este ícone <inlinemediaobject> <imageobject> <imagedata fileref="catalogmanager_nopot.png" format="PNG"/> </imageobject> </inlinemediaobject>, como <inlinemediaobject> <imageobject> <imagedata fileref="catalogmanager_nopot_ok.png" format="PNG"/> </imageobject> </inlinemediaobject>, isto indica que este arquivo ou pasta não existe na pasta de arquivos <acronym>POT</acronym>.</para> + +<para>Você pode marcar ou desmarcar um arquivo selecionando <guimenuitem>Alternar Marca</guimenuitem> no menu de contexto de um arquivo.</para> + +<para>Se você deseja alternar ou remover todas as marcas numa pasta, pressione o botão direito do mouse sobre a pasta e selecione <guimenuitem>Alternar Marcas</guimenuitem> ou <guimenuitem>Remover Marcas</guimenuitem>. As marcas serão automaticamente salvas quando sair do &kbabel;.</para> + +<para>Para abrir um arquivo você pode dar um duplo-clique nele, selecionar <menuchoice><guimenuitem>Abrir</guimenuitem></menuchoice> no menu de contexto, pressionar <keycap>Return</keycap> ou <keycombo action="simul">&Ctrl;<keycap>O</keycap> </keycombo>.</para> + +<para>Você poderá configurar o &catalogmanager; em <menuchoice><guimenu>Projeto</guimenu><guimenuitem> Configurar...</guimenuitem></menuchoice>. Veja a seção <link linkend="preferences-project-settings">Configuração do Projeto</link> para mais detalhes.</para> <sect1 id="catman-features"> -<title ->Recursos do &catalogmanager;</title> -<para ->Além do principal recurso de abrir os arquivos no &kbabel; o &catalogmanager; suporta diversos outros recursos para manter uma árvore de arquivos <acronym ->PO</acronym ->. </para> +<title>Recursos do &catalogmanager;</title> +<para>Além do principal recurso de abrir os arquivos no &kbabel; o &catalogmanager; suporta diversos outros recursos para manter uma árvore de arquivos <acronym>PO</acronym>. </para> <sect2 id="catman-find"> -<title ->Procurar e substituir em múltiplos arquivos</title> -<para ->Uma das características mais requisitadas para o &kbabel; foi a possibilidade de procurar e substituir em múltiplos arquivos ao mesmo tempo. O &catalogmanager; suporta este recurso com uma completa integração com o &kbabel; </para> +<title>Procurar e substituir em múltiplos arquivos</title> +<para>Uma das características mais requisitadas para o &kbabel; foi a possibilidade de procurar e substituir em múltiplos arquivos ao mesmo tempo. O &catalogmanager; suporta este recurso com uma completa integração com o &kbabel; </para> </sect2> <sect2 id="catman-statistics"> -<title ->Estatísticas</title> -<para ->O &catalogmanager; pode lhe mostrar um grande número de estatísticas sobre um arquivo simples ou sobre pastas inteiras. As estatísticas contém números de arquivos, quantos arquivos possuem seus modelos, quantos não possuem. Elas também contam o número de mensagens nos arquivos e mostram o percentual de mensagens traduzidas, aproximadas e não traduzidas. </para> +<title>Estatísticas</title> +<para>O &catalogmanager; pode lhe mostrar um grande número de estatísticas sobre um arquivo simples ou sobre pastas inteiras. As estatísticas contém números de arquivos, quantos arquivos possuem seus modelos, quantos não possuem. Elas também contam o número de mensagens nos arquivos e mostram o percentual de mensagens traduzidas, aproximadas e não traduzidas. </para> </sect2> <sect2 id="catman-syntax"> -<title ->Verificando a sintaxe</title> -<para ->Isto lhe permite verificar a sintaxe de múltiplos arquivos <acronym ->PO</acronym -> usando o <command ->msgfmt</command ->. Se um arquivo falhar nesta checagem, ele não pode ser usado para gerar um arquivo <acronym ->MO</acronym -> para distribuição binária. Como um arquivo incorreto tipicamente resultará numa compilação falha do arquivo <acronym ->PO</acronym -> a partir dele. </para> +<title>Verificando a sintaxe</title> +<para>Isto lhe permite verificar a sintaxe de múltiplos arquivos <acronym>PO</acronym> usando o <command>msgfmt</command>. Se um arquivo falhar nesta checagem, ele não pode ser usado para gerar um arquivo <acronym>MO</acronym> para distribuição binária. Como um arquivo incorreto tipicamente resultará numa compilação falha do arquivo <acronym>PO</acronym> a partir dele. </para> </sect2> <sect2 id="catman-commands"> -<title ->Comandos definidos pelo usuário</title> -<para ->Devido ao &catalogmanager; não fornecer todas as funcionalidades que você gostaria de usar, você pode estendê-lo definindo seus próprios comandos. </para> +<title>Comandos definidos pelo usuário</title> +<para>Devido ao &catalogmanager; não fornecer todas as funcionalidades que você gostaria de usar, você pode estendê-lo definindo seus próprios comandos. </para> <!-- ### TODO: we should lik to preferences-project-file-commands too --> -<para ->Existem dois conjuntos de comandos; um para as pastas e outro para os arquivos isolados. Você poderá configurá-los na <link linkend="preferences-project-folder-commands" ->janela de configuração</link -> e acessá-los, clicando com o &RMB; num ítem da lista de arquivos.</para> +<para>Existem dois conjuntos de comandos; um para as pastas e outro para os arquivos isolados. Você poderá configurá-los na <link linkend="preferences-project-folder-commands">janela de configuração</link> e acessá-los, clicando com o &RMB; num ítem da lista de arquivos.</para> </sect2> </sect1> diff --git a/tde-i18n-pt_BR/docs/tdesdk/kbabel/dictionaries.docbook b/tde-i18n-pt_BR/docs/tdesdk/kbabel/dictionaries.docbook index 00585d1f6ef..782c157707d 100644 --- a/tde-i18n-pt_BR/docs/tdesdk/kbabel/dictionaries.docbook +++ b/tde-i18n-pt_BR/docs/tdesdk/kbabel/dictionaries.docbook @@ -1,6 +1,5 @@ <!-- <?xml version="1.0" ?> -<!DOCTYPE chapter PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" -> --> +<!DOCTYPE chapter PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd"> --> <!-- Uncomment the previous two lines to validate this document --> <!-- standalone. Be sure to recomment them before attempting to --> <!-- process index.docbook --> @@ -11,624 +10,287 @@ <!-- Fill in this section if this document has a different author --> <authorgroup> <author> -<personname -><firstname -></firstname -><surname -></surname -></personname> +<personname><firstname></firstname><surname></surname></personname> </author> </authorgroup> -<othercredit role="translator" -><firstname ->Marcus</firstname -><surname ->Gama</surname -><affiliation -><address -><email ->marcus.gama@gmail.com</email -></address -></affiliation -><contrib ->Tradução</contrib -></othercredit -> +<othercredit role="translator"><firstname>Marcus</firstname><surname>Gama</surname><affiliation><address><email>marcus.gama@gmail.com</email></address></affiliation><contrib>Tradução</contrib></othercredit> </chapterinfo> -<title ->Dicionários</title> +<title>Dicionários</title> -<para ->O &kbabel; possui 3 modos que podem ser usados para procurar por strings de mensagens <acronym ->PO</acronym -> traduzidos:</para> +<para>O &kbabel; possui 3 modos que podem ser usados para procurar por strings de mensagens <acronym>PO</acronym> traduzidos:</para> <itemizedlist> <listitem> - <para ->Procurar traduções usando um banco de dados de traduções </para> + <para>Procurar traduções usando um banco de dados de traduções </para> </listitem> <listitem> - <para ->Tradução aproximada </para> + <para>Tradução aproximada </para> </listitem> <listitem> - <para ->&kbabeldict; </para> + <para>&kbabeldict; </para> </listitem> </itemizedlist> <sect1 id="database"> <!-- FIXME: settings --> -<title ->Banco de dados de traduções</title> +<title>Banco de dados de traduções</title> <!-- ### TODO: only *one* file? Seems more to be four... --> -<para ->O banco de dados de traduções lhe permite armazenar traduções num banco de dados baseado no Banco de Dados Berkeley IV, &ie; elas são armazenadas num arquivo binário em seu disco. O banco de dados garante um busca rápida num grande número de traduções.</para> +<para>O banco de dados de traduções lhe permite armazenar traduções num banco de dados baseado no Banco de Dados Berkeley IV, &ie; elas são armazenadas num arquivo binário em seu disco. O banco de dados garante um busca rápida num grande número de traduções.</para> -<para ->Este modo é o mais bem integrado ao &kbabel;. Além da busca e tradução aproximada ele também suporta os seguintes recursos:</para> +<para>Este modo é o mais bem integrado ao &kbabel;. Além da busca e tradução aproximada ele também suporta os seguintes recursos:</para> <itemizedlist> <listitem> -<para ->Cada nova tradução digitada no editor do &kbabel; pode ser automaticamente armazenada no banco de dados.</para> +<para>Cada nova tradução digitada no editor do &kbabel; pode ser automaticamente armazenada no banco de dados.</para> </listitem> <listitem> -<para ->Este banco de dados pode ser usado para <quote ->diferenciar</quote -> <acronym ->msgid</acronym ->.</para> +<para>Este banco de dados pode ser usado para <quote>diferenciar</quote> <acronym>msgid</acronym>.</para> </listitem> </itemizedlist> -<para ->É claro, quanto mais traduções são armazenadas no banco de dados, mais produtivo você pode ser. Para preencher o banco de dados, você pode usar a aba <guilabel ->Banco de Dados</guilabel -> no diálogo de preferências ou você pode habilitar a adição automática de cada mensagem traduzida nessa mesma aba.</para> +<para>É claro, quanto mais traduções são armazenadas no banco de dados, mais produtivo você pode ser. Para preencher o banco de dados, você pode usar a aba <guilabel>Banco de Dados</guilabel> no diálogo de preferências ou você pode habilitar a adição automática de cada mensagem traduzida nessa mesma aba.</para> <sect2 id="database-settings"> -<title ->Configurações</title> -<para ->Você pode configurar este modo de busca e como ele deverá ser usado selecionando <menuchoice -> <guisubmenu ->Configurações</guisubmenu -> <guisubmenu ->Configurar Dicionário</guisubmenu -> <guimenuitem ->Banco de Dados de Traduções</guimenuitem -> </menuchoice -> no menu do &kbabel;. </para> -<para ->A aba <guilabel ->Genérico</guilabel -> contém configurações gerais para busca no banco de dados. </para> +<title>Configurações</title> +<para>Você pode configurar este modo de busca e como ele deverá ser usado selecionando <menuchoice> <guisubmenu>Configurações</guisubmenu> <guisubmenu>Configurar Dicionário</guisubmenu> <guimenuitem>Banco de Dados de Traduções</guimenuitem> </menuchoice> no menu do &kbabel;. </para> +<para>A aba <guilabel>Genérico</guilabel> contém configurações gerais para busca no banco de dados. </para> <variablelist> <varlistentry> - <term -><guilabel ->Procurar em todo o banco de dados (lento)</guilabel -></term> + <term><guilabel>Procurar em todo o banco de dados (lento)</guilabel></term> <listitem> - <para ->Não usa <quote ->boas chaves</quote ->, busca em todo o banco de dados. Isto é lento, mas retornará os resultados mais precisos. </para> + <para>Não usa <quote>boas chaves</quote>, busca em todo o banco de dados. Isto é lento, mas retornará os resultados mais precisos. </para> </listitem> </varlistentry> <varlistentry> - <term -><guilabel ->Procurar na lista de "boas chaves" (melhor)</guilabel -></term> + <term><guilabel>Procurar na lista de "boas chaves" (melhor)</guilabel></term> <listitem> - <para ->Usa a estratégia de <quote ->boas chaves</quote ->. Esta opção lhe fornecerá o melhor desempenho entre velocidade e correspondência exata. </para> + <para>Usa a estratégia de <quote>boas chaves</quote>. Esta opção lhe fornecerá o melhor desempenho entre velocidade e correspondência exata. </para> </listitem> </varlistentry> <varlistentry> - <term -><guilabel ->Retorna a lista de "boas chaves" (rápido)</guilabel -></term> + <term><guilabel>Retorna a lista de "boas chaves" (rápido)</guilabel></term> <listitem> - <para ->Apenas retorna <quote ->boas chaves</quote ->, não tenta eliminar qualquer texto a mais. Este é o método mais rápido, mas pode fornecer um grande número de correspondências imprecisas. </para> + <para>Apenas retorna <quote>boas chaves</quote>, não tenta eliminar qualquer texto a mais. Este é o método mais rápido, mas pode fornecer um grande número de correspondências imprecisas. </para> </listitem> </varlistentry> <varlistentry> - <term -><guibutton ->Sensível à caixa</guibutton -></term> + <term><guibutton>Sensível à caixa</guibutton></term> <listitem> - <para ->Distingue a caixa das letras na busca de texto. </para> + <para>Distingue a caixa das letras na busca de texto. </para> </listitem> </varlistentry> <varlistentry> - <term -><guibutton ->Normaliza espaços em branco</guibutton -></term> + <term><guibutton>Normaliza espaços em branco</guibutton></term> <listitem> - <para ->Pula espaços em branco desnecessários nos textos, de modo que a busca ignore pequenas diferenças de espaço em branco, ⪚ número de espaços no texto. </para> + <para>Pula espaços em branco desnecessários nos textos, de modo que a busca ignore pequenas diferenças de espaço em branco, ⪚ número de espaços no texto. </para> </listitem> </varlistentry> <varlistentry> - <term -><guibutton ->Remover comentário de contexto</guibutton -></term> + <term><guibutton>Remover comentário de contexto</guibutton></term> <listitem> - <para ->Não inclui comentário de contexto na busca. Você desejará que isto esteja habilitado. </para> + <para>Não inclui comentário de contexto na busca. Você desejará que isto esteja habilitado. </para> </listitem> </varlistentry> <varlistentry> - <term -><guilabel ->Caracter a ser ignorado</guilabel -></term> + <term><guilabel>Caracter a ser ignorado</guilabel></term> <listitem> - <para ->Aqui você pode inserir caracteres que devem ser ignorados durante a busca. Um exemplo típico pode ser a marca de acelerador &ie; & para textos &kde;. </para> + <para>Aqui você pode inserir caracteres que devem ser ignorados durante a busca. Um exemplo típico pode ser a marca de acelerador &ie; & para textos &kde;. </para> </listitem> </varlistentry> </variablelist> -<para ->A aba <guilabel ->Procurar</guilabel -> contém especificações detalhadas para procura de texto. Você pode definir como procurar e também permitir o uso de outro modo especial de procura chamado <emphasis -><guilabel ->Substituição de palavra</guilabel -></emphasis ->. Substituindo uma ou duas palavras o texto aproximado pode ser encontrado. Por exemplo, imagine que você está tentando encontrar o texto <userinput ->Meu nome é Andréia</userinput ->. </para> +<para>A aba <guilabel>Procurar</guilabel> contém especificações detalhadas para procura de texto. Você pode definir como procurar e também permitir o uso de outro modo especial de procura chamado <emphasis><guilabel>Substituição de palavra</guilabel></emphasis>. Substituindo uma ou duas palavras o texto aproximado pode ser encontrado. Por exemplo, imagine que você está tentando encontrar o texto <userinput>Meu nome é Andréia</userinput>. </para> <variablelist> <varlistentry> - <term -><guilabel ->Igual</guilabel -></term> + <term><guilabel>Igual</guilabel></term> <listitem> - <para ->O texto do banco de dados corresponde se ele for o mesmo de string procurado. Em nosso exemplo, ele pode ser <emphasis ->Meu nome é &Andréia</emphasis -> (se & tiver sido configurado como caracter ignorado em <guilabel ->Caracteres a serem ignorados</guilabel -> na aba <guilabel ->Genérico</guilabel ->). </para> + <para>O texto do banco de dados corresponde se ele for o mesmo de string procurado. Em nosso exemplo, ele pode ser <emphasis>Meu nome é &Andréia</emphasis> (se & tiver sido configurado como caracter ignorado em <guilabel>Caracteres a serem ignorados</guilabel> na aba <guilabel>Genérico</guilabel>). </para> </listitem> </varlistentry> <varlistentry> - <term -><guilabel ->Consulta está contida</guilabel -></term> + <term><guilabel>Consulta está contida</guilabel></term> <listitem> - <para ->O texto do banco de dados corresponde se o string procurado estiver contido nele. Para o nosso exemplo ele pode ser <emphasis ->Meu nome é Andréia, você sabia?</emphasis ->. </para> + <para>O texto do banco de dados corresponde se o string procurado estiver contido nele. Para o nosso exemplo ele pode ser <emphasis>Meu nome é Andréia, você sabia?</emphasis>. </para> </listitem> </varlistentry> <varlistentry> - <term -><guilabel ->Consulta contém</guilabel -></term> + <term><guilabel>Consulta contém</guilabel></term> <listitem> - <para ->O texto do banco de dados corresponde se o string procurado o contém. Para o nosso exemplo ele pode ser <emphasis ->Andréia</emphasis ->. Você pode usar isto para enumerar as possibilidades a serem encontradas. </para> + <para>O texto do banco de dados corresponde se o string procurado o contém. Para o nosso exemplo ele pode ser <emphasis>Andréia</emphasis>. Você pode usar isto para enumerar as possibilidades a serem encontradas. </para> </listitem> </varlistentry> <varlistentry> - <term -><guibutton ->Expressão Regular</guibutton -></term> + <term><guibutton>Expressão Regular</guibutton></term> <listitem> - <para ->Considere o texto procurado como uma expressão regular. Isto é principalmente usado para o &kbabeldict;. Você pode procurar com base em expressões regulares nos arquivos PO. </para> + <para>Considere o texto procurado como uma expressão regular. Isto é principalmente usado para o &kbabeldict;. Você pode procurar com base em expressões regulares nos arquivos PO. </para> </listitem> </varlistentry> <varlistentry> - <term -><guibutton ->Use uma substituição de palavra</guibutton -></term> + <term><guibutton>Use uma substituição de palavra</guibutton></term> <listitem> - <para ->Se o texto de consulta contém menos palavras que as especificadas abaixo, ele também tenta substituir uma das palavras na consulta. Em nosso exemplo ele procurará por <emphasis ->Seu nome é Andréia</emphasis -> também. </para> + <para>Se o texto de consulta contém menos palavras que as especificadas abaixo, ele também tenta substituir uma das palavras na consulta. Em nosso exemplo ele procurará por <emphasis>Seu nome é Andréia</emphasis> também. </para> </listitem> </varlistentry> <varlistentry> - <term -><guibutton ->Máximo número de palavras na consulta</guibutton -></term> + <term><guibutton>Máximo número de palavras na consulta</guibutton></term> <listitem> - <para ->Número máximo de palavras numa consulta para habilitar a substituição de uma palavra. </para> + <para>Número máximo de palavras numa consulta para habilitar a substituição de uma palavra. </para> </listitem> </varlistentry> <varlistentry> - <term -><guilabel ->Caracteres locais para expressões regulares</guilabel -></term> + <term><guilabel>Caracteres locais para expressões regulares</guilabel></term> <listitem> - <para ->Caracteres a serem considerados parte de expressões regulares. </para> + <para>Caracteres a serem considerados parte de expressões regulares. </para> </listitem> </varlistentry> </variablelist> <note> -<para ->Substituição de duas palavras ainda não foi implementada. </para> +<para>Substituição de duas palavras ainda não foi implementada. </para> </note> </sect2> <sect2 id="database-fill"> -<title ->Preenchendo o banco de dados</title> -<para ->A aba <guilabel ->Banco de Dados</guilabel -> permite definir onde está armazenado o banco de dados no disco (<guilabel ->Pasta do Banco de Dados</guilabel ->) e se ele deve ser usado para armazenamento automático de novas traduções (<guibutton ->Auto-adicionar entrada ao banco de dados</guibutton ->). Neste caso você deve especificar o autor da nova tradução em <guilabel ->Autor da entrada adicionada automaticamente</guilabel ->. </para> -<para ->O resto da aba permite preencher o banco de dados a partir de arquivos PO já existentes. Use um dos botões do meio da caixa de diálogo. O progresso do carregamento de arquivos será mostrado através de barra de progresso abaixo dos botões. O botão <guilabel ->Strings repetidos</guilabel -> deve ser usado no caso especial de um string traduzido estiver repetido muitas vezes, caso você não queira armazenar muitos deles. Aqui você pode limitar os strings armazenados. </para> +<title>Preenchendo o banco de dados</title> +<para>A aba <guilabel>Banco de Dados</guilabel> permite definir onde está armazenado o banco de dados no disco (<guilabel>Pasta do Banco de Dados</guilabel>) e se ele deve ser usado para armazenamento automático de novas traduções (<guibutton>Auto-adicionar entrada ao banco de dados</guibutton>). Neste caso você deve especificar o autor da nova tradução em <guilabel>Autor da entrada adicionada automaticamente</guilabel>. </para> +<para>O resto da aba permite preencher o banco de dados a partir de arquivos PO já existentes. Use um dos botões do meio da caixa de diálogo. O progresso do carregamento de arquivos será mostrado através de barra de progresso abaixo dos botões. O botão <guilabel>Strings repetidos</guilabel> deve ser usado no caso especial de um string traduzido estiver repetido muitas vezes, caso você não queira armazenar muitos deles. Aqui você pode limitar os strings armazenados. </para> <screenshot> -<screeninfo ->Preenchendo o banco de dados</screeninfo> +<screeninfo>Preenchendo o banco de dados</screeninfo> <mediaobject> <imageobject> <imagedata fileref="dbcan.png" format="PNG"/> </imageobject> -<textobject -><phrase ->Preenchendo o banco de dados com arquivos PO existentes</phrase -></textobject> +<textobject><phrase>Preenchendo o banco de dados com arquivos PO existentes</phrase></textobject> </mediaobject> -</screenshot -></sect2> +</screenshot></sect2> <sect2 id="database-goodkeys"> -<title ->Definindo boas chaves</title> -<para ->Na aba <guilabel ->Boas chaves</guilabel -> estão as regras para especificar como preencher a lista de chaves boas. <guilabel ->Número mínimo de palavras da consulta na chave (%)</guilabel -> especifique exatamente que o texto precisará conter somente este percentual de palavras para se qualificar como uma boa chave. O oposto pode ser especificado via <guilabel ->Número mínimo de palavras da chave também na consulta (%)</guilabel ->. O tamanho das palavras pode ser configurado na caixa de número <guilabel ->Tamanho máximo</guilabel ->. </para> -<para ->O texto procurado tipicamente contém diversas palavras genéricas, ⪚ artigos. Você pode eliminar as palavras baseado na freqüência. Você pode descartá-las com <guilabel ->Discartar palavras mais freqüentes que</guilabel -> ou considerar com sempre presente com <guilabel ->palavras freqüentes são consideradas em toda chave</guilabel ->. Deste modo as palavras freqüentes serão invisíveis para as consultas. </para> +<title>Definindo boas chaves</title> +<para>Na aba <guilabel>Boas chaves</guilabel> estão as regras para especificar como preencher a lista de chaves boas. <guilabel>Número mínimo de palavras da consulta na chave (%)</guilabel> especifique exatamente que o texto precisará conter somente este percentual de palavras para se qualificar como uma boa chave. O oposto pode ser especificado via <guilabel>Número mínimo de palavras da chave também na consulta (%)</guilabel>. O tamanho das palavras pode ser configurado na caixa de número <guilabel>Tamanho máximo</guilabel>. </para> +<para>O texto procurado tipicamente contém diversas palavras genéricas, ⪚ artigos. Você pode eliminar as palavras baseado na freqüência. Você pode descartá-las com <guilabel>Discartar palavras mais freqüentes que</guilabel> ou considerar com sempre presente com <guilabel>palavras freqüentes são consideradas em toda chave</guilabel>. Deste modo as palavras freqüentes serão invisíveis para as consultas. </para> </sect2> </sect1> <sect1 id="auxiliary"> -<title ->Arquivo auxiliar PO</title> - -<para ->Este modo de busca é baseado na correspondência do mesmo texto original em Inglês (o msgid) traduzido para outro idioma num arquivo auxiliar <acronym ->PO</acronym ->. Isto é muito comum para idiomas romanos que possuem palavras similares, como por exemplo o anglo-saxão e o eslavo.</para> - -<para ->Por exemplo, digamos que eu queira traduzir a palavra <quote ->on</quote ->, do <filename ->tdelibs.po</filename ->, para o Romeno mas eu não tenho nenhuma referência. Eu olho no mesmo arquivo para o Francês e encontro <quote ->actif</quote ->, e em Espanhol encontro <quote ->activado</quote ->. Logo, eu concluo que o melhor em Romeno será <quote ->active</quote ->. (Obviamente, em Inglês ao invés de <quote ->on</quote -> a palavra usada poderia ser <quote ->active</quote -> ou <quote ->activated</quote ->, o que teria feito o processo de tradução mais fácil.) O &kbabel; automatiza esta tarefa. Atualmente você pode definir somente um arquivo auxiliar para procurar. </para> +<title>Arquivo auxiliar PO</title> + +<para>Este modo de busca é baseado na correspondência do mesmo texto original em Inglês (o msgid) traduzido para outro idioma num arquivo auxiliar <acronym>PO</acronym>. Isto é muito comum para idiomas romanos que possuem palavras similares, como por exemplo o anglo-saxão e o eslavo.</para> + +<para>Por exemplo, digamos que eu queira traduzir a palavra <quote>on</quote>, do <filename>tdelibs.po</filename>, para o Romeno mas eu não tenho nenhuma referência. Eu olho no mesmo arquivo para o Francês e encontro <quote>actif</quote>, e em Espanhol encontro <quote>activado</quote>. Logo, eu concluo que o melhor em Romeno será <quote>active</quote>. (Obviamente, em Inglês ao invés de <quote>on</quote> a palavra usada poderia ser <quote>active</quote> ou <quote>activated</quote>, o que teria feito o processo de tradução mais fácil.) O &kbabel; automatiza esta tarefa. Atualmente você pode definir somente um arquivo auxiliar para procurar. </para> <sect2 id="auxiliary-settings"> -<title ->Configurações</title> -<para ->Você pode configurar este modo de procura selecionando <menuchoice -> <guisubmenu ->Configurações</guisubmenu -> <guisubmenu ->Configurar Dicionário</guisubmenu -> <guimenuitem ->PO Auxiliar</guimenuitem -> </menuchoice -> no menu do &kbabel;.</para> - -<para ->No diálogo <guilabel ->Configurar Dicionário PO Auxiliar</guilabel -> você pode selecionar o caminho para o arquivo <acronym ->PO</acronym -> auxiliar. Para automatizar alternância do arquivo <acronym ->PO</acronym ->-quando você muda o arquivo atualmente editado existem muitas variáveis delimitadas pelo caracter <literal ->@</literal -> que serão substituídas pelos valores apropriados.</para> +<title>Configurações</title> +<para>Você pode configurar este modo de procura selecionando <menuchoice> <guisubmenu>Configurações</guisubmenu> <guisubmenu>Configurar Dicionário</guisubmenu> <guimenuitem>PO Auxiliar</guimenuitem> </menuchoice> no menu do &kbabel;.</para> + +<para>No diálogo <guilabel>Configurar Dicionário PO Auxiliar</guilabel> você pode selecionar o caminho para o arquivo <acronym>PO</acronym> auxiliar. Para automatizar alternância do arquivo <acronym>PO</acronym>-quando você muda o arquivo atualmente editado existem muitas variáveis delimitadas pelo caracter <literal>@</literal> que serão substituídas pelos valores apropriados.</para> <variablelist> <varlistentry> - <term ->@PACKAGE@</term> - <listitem -><para ->O nome do aplicativo ou pacote atualmente sendo traduzido. Por exemplo, ele pode expandir para kbabel,. tdelibs, konqueror e assim por diante. </para -></listitem> + <term>@PACKAGE@</term> + <listitem><para>O nome do aplicativo ou pacote atualmente sendo traduzido. Por exemplo, ele pode expandir para kbabel,. tdelibs, konqueror e assim por diante. </para></listitem> </varlistentry> <varlistentry> - <term ->@LANG@</term> - <listitem -><para ->O código do idioma. Por exemplo pode ser expandido para: de, ro, fr, etc. </para -></listitem> + <term>@LANG@</term> + <listitem><para>O código do idioma. Por exemplo pode ser expandido para: de, ro, fr, etc. </para></listitem> </varlistentry> <varlistentry> - <term ->@DIRn@</term> - <listitem -><para ->onde <quote ->n</quote -> é um inteiro positivo. Isto expande para a <quote ->enésima</quote -> pasta contada a partir do nome do arquivo (direita para esquerda). </para -></listitem> + <term>@DIRn@</term> + <listitem><para>onde <quote>n</quote> é um inteiro positivo. Isto expande para a <quote>enésima</quote> pasta contada a partir do nome do arquivo (direita para esquerda). </para></listitem> </varlistentry> </variablelist> -<para ->A linha de edição exibe o caminho atual para o arquivo auxiliar <acronym ->PO</acronym -> . Apesar de ser preferível usar a variável fornecida no caminho é possível escolher um caminho absoluto para um arquivo <acronym ->PO</acronym -> existente. Vejamos um exemplo.</para> +<para>A linha de edição exibe o caminho atual para o arquivo auxiliar <acronym>PO</acronym> . Apesar de ser preferível usar a variável fornecida no caminho é possível escolher um caminho absoluto para um arquivo <acronym>PO</acronym> existente. Vejamos um exemplo.</para> -<para ->Eu sou Romeno e eu tenho algum conhecimento do idioma Francês e eu trabalho na tradução do &kde;.</para> +<para>Eu sou Romeno e eu tenho algum conhecimento do idioma Francês e eu trabalho na tradução do &kde;.</para> <!-- ### TODO: check URL, especially the kde-l10n part --> -<para ->O primeiro passo é baixar o mais recente <filename ->kde-l10n-fr.tar.bz2</filename -> no <ulink url="ftp://ftp.kde.org/pub/kde/snapshots/kde-l10n" ->&FTP; do &kde;</ulink -> ou usar o sistema <acronym ->CVS</acronym -> para colocar em meu disco rígido uma árvore de tradução do idioma Francês. Eu faço isso em <filename ->/home/clau/cvs-cvs.kde.org/kde-l10n/fr</filename ->.</para> - -<para ->Minha pasta de fontes <acronym ->PO</acronym -> está em <filename ->/home/clau/cvs-cvs.kde.org/kde-l10n/ro</filename ->. Não se esqueça de selecionar o <guilabel ->PO Auxiliar</guilabel -> como dicionário padrão e habilitar <guilabel ->Iniciar busca automaticamente</guilabel -> na aba <guilabel ->Procurar</guilabel -> do diálogo de <guilabel ->Preferências</guilabel ->do &kbabel;. </para> +<para>O primeiro passo é baixar o mais recente <filename>kde-l10n-fr.tar.bz2</filename> no <ulink url="ftp://ftp.kde.org/pub/kde/snapshots/kde-l10n">&FTP; do &kde;</ulink> ou usar o sistema <acronym>CVS</acronym> para colocar em meu disco rígido uma árvore de tradução do idioma Francês. Eu faço isso em <filename>/home/clau/cvs-cvs.kde.org/kde-l10n/fr</filename>.</para> + +<para>Minha pasta de fontes <acronym>PO</acronym> está em <filename>/home/clau/cvs-cvs.kde.org/kde-l10n/ro</filename>. Não se esqueça de selecionar o <guilabel>PO Auxiliar</guilabel> como dicionário padrão e habilitar <guilabel>Iniciar busca automaticamente</guilabel> na aba <guilabel>Procurar</guilabel> do diálogo de <guilabel>Preferências</guilabel>do &kbabel;. </para> </sect2> </sect1> <sect1 id="compendium"> <!-- FIXME: examples --> -<title ->Compêndio PO</title> - -<para ->Um compêndio é um arquivo contendo uma coleção de todas as mensagens traduzidas (pares de <acronym ->msgid</acronym -> e <acronym ->msgstr</acronym ->) num projeto, ⪚ em &kde;. Tipicamente, um compêndio para um idioma determinado é criado pela concatenação de todos os arquivos <acronym ->PO</acronym -> do projeto para o idioma. O compêndio pode conter mensagens traduzidas, não traduzidas e aproximadas. Mensagens não traduzidas são ignoradas por este módulo. </para> - -<para ->Semelhante ao <acronym ->PO</acronym -> Auxiliar, este modo de busca é baseado na correspondência do <quote ->mesmo</quote -> string original (<acronym ->msgid</acronym ->) num compêndio. Atualmente você pode definir somente um arquivo de compêndio para pesquisar. </para> - -<para ->Este modo é muito útil se você não está usando o banco de dados de traduções e você deseja obter uma tradução consistente com outras traduções. Deste modo, arquivos compêndio são mais fáceis para compartilhar com outros tradutores e outros projetos de tradução porque eles podem ser gerados por todos. </para> +<title>Compêndio PO</title> + +<para>Um compêndio é um arquivo contendo uma coleção de todas as mensagens traduzidas (pares de <acronym>msgid</acronym> e <acronym>msgstr</acronym>) num projeto, ⪚ em &kde;. Tipicamente, um compêndio para um idioma determinado é criado pela concatenação de todos os arquivos <acronym>PO</acronym> do projeto para o idioma. O compêndio pode conter mensagens traduzidas, não traduzidas e aproximadas. Mensagens não traduzidas são ignoradas por este módulo. </para> + +<para>Semelhante ao <acronym>PO</acronym> Auxiliar, este modo de busca é baseado na correspondência do <quote>mesmo</quote> string original (<acronym>msgid</acronym>) num compêndio. Atualmente você pode definir somente um arquivo de compêndio para pesquisar. </para> + +<para>Este modo é muito útil se você não está usando o banco de dados de traduções e você deseja obter uma tradução consistente com outras traduções. Deste modo, arquivos compêndio são mais fáceis para compartilhar com outros tradutores e outros projetos de tradução porque eles podem ser gerados por todos. </para> <sect2 id="compendium-settings"> -<title ->Configurações</title> - -<para ->Você pode configurar este modo de busca selecionando <menuchoice -> <guisubmenu ->Configurações</guisubmenu -> <guisubmenu ->Configurar Dicionário</guisubmenu -> <guimenuitem ->Compêndio PO</guimenuitem -> </menuchoice -> no menu do &kbabel;. </para> - -<para ->No diálogo <guilabel ->Configurar Dicionário Compêndio PO</guilabel -> você pode selecionar o caminho para um arquivo de compêndio. Para automatizar a alternância do arquivo de compêndio quando você muda o idioma de tradução, existe uma variável delimitada por caracteres <literal ->@</literal -> que será substituída pelo valor apropriado.</para> +<title>Configurações</title> + +<para>Você pode configurar este modo de busca selecionando <menuchoice> <guisubmenu>Configurações</guisubmenu> <guisubmenu>Configurar Dicionário</guisubmenu> <guimenuitem>Compêndio PO</guimenuitem> </menuchoice> no menu do &kbabel;. </para> + +<para>No diálogo <guilabel>Configurar Dicionário Compêndio PO</guilabel> você pode selecionar o caminho para um arquivo de compêndio. Para automatizar a alternância do arquivo de compêndio quando você muda o idioma de tradução, existe uma variável delimitada por caracteres <literal>@</literal> que será substituída pelo valor apropriado.</para> <variablelist> <varlistentry> - <term ->@LANG@</term> - <listitem -><para ->O código do idioma. Por exemplo pode ser expandido para: de, ro, fr, etc. </para -></listitem> + <term>@LANG@</term> + <listitem><para>O código do idioma. Por exemplo pode ser expandido para: de, ro, fr, etc. </para></listitem> </varlistentry> </variablelist> -<para ->Na linha de edição é exibido o caminho atual para o arquivo <acronym ->PO</acronym ->. Apesar de ser melhor usar a variável fornecida no caminho, é possível escolher um caminho absoluto para um arquivo <acronym ->PO</acronym -> a ser usado como um compêndio.</para> +<para>Na linha de edição é exibido o caminho atual para o arquivo <acronym>PO</acronym>. Apesar de ser melhor usar a variável fornecida no caminho, é possível escolher um caminho absoluto para um arquivo <acronym>PO</acronym> a ser usado como um compêndio.</para> <!-- ### TODO: check URL, especially the kde-l10n part --> -<para ->O compêndio mais recente para traduções &kde; para o ⪚ Francês pode ser baixado de <filename ->fr.messages.bz2</filename -> do <ulink url="ftp://ftp.kde.org/pub/kde/snapshots/kde-l10n" ->&FTP; do &kde;</ulink ->. </para> +<para>O compêndio mais recente para traduções &kde; para o ⪚ Francês pode ser baixado de <filename>fr.messages.bz2</filename> do <ulink url="ftp://ftp.kde.org/pub/kde/snapshots/kde-l10n">&FTP; do &kde;</ulink>. </para> -<para ->Você pode definir como procurar no compêndio usando as opções abaixo do caminho. Elas estão divididas em dois grupos: opções de correspondência de texto, onde você pode especificar como o texto é comparado e se deve ignorar traduções aproximadas, e opções de correspondência de mensagens, que determina se a tradução do compêndio pode ser um sub-string da mensagem procurada ou vice-versa.</para> +<para>Você pode definir como procurar no compêndio usando as opções abaixo do caminho. Elas estão divididas em dois grupos: opções de correspondência de texto, onde você pode especificar como o texto é comparado e se deve ignorar traduções aproximadas, e opções de correspondência de mensagens, que determina se a tradução do compêndio pode ser um sub-string da mensagem procurada ou vice-versa.</para> <variablelist> <varlistentry> - <term -><guilabel ->Sensível à caixa</guilabel -></term> + <term><guilabel>Sensível à caixa</guilabel></term> <listitem> - <para ->Se a correspondência de mensagem no compêndio deve distinguir entre letras maiúsculas e minúsculas. </para> + <para>Se a correspondência de mensagem no compêndio deve distinguir entre letras maiúsculas e minúsculas. </para> </listitem> </varlistentry> <varlistentry> - <term -><guilabel ->Ignorar string aproximado</guilabel -></term> + <term><guilabel>Ignorar string aproximado</guilabel></term> <listitem> - <para ->Se as mensagens aproximadas no compêndio devem ser ignoradas na procura. O compêndio pode conter mensagens aproximadas, uma vez que elas são tipicamente criadas pela concatenação de arquivos <acronym ->PO</acronym -> do projeto que podem incluir mensagens aproximadas. Mensagens não traduzidas são sempre ignoradas (Você não pode procurar por um tradução em mensagens não traduzidas, certo?).</para> + <para>Se as mensagens aproximadas no compêndio devem ser ignoradas na procura. O compêndio pode conter mensagens aproximadas, uma vez que elas são tipicamente criadas pela concatenação de arquivos <acronym>PO</acronym> do projeto que podem incluir mensagens aproximadas. Mensagens não traduzidas são sempre ignoradas (Você não pode procurar por um tradução em mensagens não traduzidas, certo?).</para> </listitem> </varlistentry> <varlistentry> - <term -><guilabel ->Somente palavras inteiras</guilabel -></term> + <term><guilabel>Somente palavras inteiras</guilabel></term> <listitem> - <para ->Se o texto correspondente deve iniciar e terminar com as palavras originais. </para> + <para>Se o texto correspondente deve iniciar e terminar com as palavras originais. </para> </listitem> </varlistentry> <varlistentry> - <term ->Um texto corresponde se ele <guilabel ->é igual ao texto procurado</guilabel -></term -> + <term>Um texto corresponde se ele <guilabel>é igual ao texto procurado</guilabel></term> <listitem> - <para ->Um texto no compêndio correspode ao texto procurado somente se ele é exatamente o mesmo (claro usando as opções acima). </para> + <para>Um texto no compêndio correspode ao texto procurado somente se ele é exatamente o mesmo (claro usando as opções acima). </para> </listitem> </varlistentry> <varlistentry> - <term ->Um texto corresponde se ele <guilabel ->é parecido com o texto procurado</guilabel -></term> + <term>Um texto corresponde se ele <guilabel>é parecido com o texto procurado</guilabel></term> <listitem> - <para ->Um texto no compêndio corresponde ao texto procurando se ele é <quote ->parecido</quote ->. Ambos os textos são comparados por pequenos pedaços de letras (<quote ->3-grams</quote ->) e pelo menos metade de todos os pedaços são iguais. </para> + <para>Um texto no compêndio corresponde ao texto procurando se ele é <quote>parecido</quote>. Ambos os textos são comparados por pequenos pedaços de letras (<quote>3-grams</quote>) e pelo menos metade de todos os pedaços são iguais. </para> </listitem> </varlistentry> <varlistentry> - <term ->Um texto corresponde se ele <guilabel ->contém o texto procurado</guilabel -></term> + <term>Um texto corresponde se ele <guilabel>contém o texto procurado</guilabel></term> <listitem> - <para ->Um texto no compêndio corresponde se ele contém o texto procurado.</para> + <para>Um texto no compêndio corresponde se ele contém o texto procurado.</para> </listitem> </varlistentry> <varlistentry> - <term ->Um texto corresponde se ele <guilabel ->está contido no texto procurado</guilabel -></term> + <term>Um texto corresponde se ele <guilabel>está contido no texto procurado</guilabel></term> <listitem> - <para ->Um texto no compêndio corresponde se ele está contido no texto procurado. </para> + <para>Um texto no compêndio corresponde se ele está contido no texto procurado. </para> </listitem> </varlistentry> <varlistentry> - <term ->Um texto corresponde se ele <guilabel ->contém uma palavra do texto procurado</guilabel -></term> + <term>Um texto corresponde se ele <guilabel>contém uma palavra do texto procurado</guilabel></term> <listitem> - <para ->Os textos são divididos em palavras e um texto no compêndio corresponde ao texto procurado somente se ele contém algumas palavras do texto procurado. </para> + <para>Os textos são divididos em palavras e um texto no compêndio corresponde ao texto procurado somente se ele contém algumas palavras do texto procurado. </para> </listitem> </varlistentry> </variablelist> diff --git a/tde-i18n-pt_BR/docs/tdesdk/kbabel/faq.docbook b/tde-i18n-pt_BR/docs/tdesdk/kbabel/faq.docbook index c35f5b5e0bc..ac24946b9b1 100644 --- a/tde-i18n-pt_BR/docs/tdesdk/kbabel/faq.docbook +++ b/tde-i18n-pt_BR/docs/tdesdk/kbabel/faq.docbook @@ -1,6 +1,5 @@ <!-- <?xml version="1.0" ?> -<!DOCTYPE chapter PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" -> --> +<!DOCTYPE chapter PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd"> --> <!-- Uncomment the previous two lines to validate this document --> <!-- standalone. Be sure to recomment them before attempting to --> <!-- process index.docbook --> @@ -10,69 +9,32 @@ <!-- Fill in this section if this document has a different author --> <authorgroup> <author> -<personname -><firstname -></firstname -><surname -></surname -></personname> +<personname><firstname></firstname><surname></surname></personname> </author> </authorgroup> -<othercredit role="translator" -><firstname ->Marcus</firstname -><surname ->Gama</surname -><affiliation -><address -><email ->marcus.gama@gmail.com</email -></address -></affiliation -><contrib ->Tradução</contrib -></othercredit -> +<othercredit role="translator"><firstname>Marcus</firstname><surname>Gama</surname><affiliation><address><email>marcus.gama@gmail.com</email></address></affiliation><contrib>Tradução</contrib></othercredit> </chapterinfo> -<title ->Perguntas e Respostas</title> +<title>Perguntas e Respostas</title> <qandaset> <!-- ### FIXME: describe better the situation of Qt3. (This text sounds like being for Qt2.) --> <qandaentry> <question> - <para ->Porque o &kbabel; mostra marcas de questionamento ao invés de caracteres específicos do idioma após carregar um arquivo <acronym ->PO</acronym ->?</para> + <para>Porque o &kbabel; mostra marcas de questionamento ao invés de caracteres específicos do idioma após carregar um arquivo <acronym>PO</acronym>?</para> </question> <answer> - <para ->O texto contém caracteres que podem não ser exibidos com sua fonte de sistema. Se você tem certeza que o texto não contém nenhum destes caracteres, o arquivo pode estar corrompido. Neste caso, marque um marca de questionamento e pressione <keycombo action="simul" ->&Ctrl;<keycap ->F</keycap -></keycombo -> para encontrar todos os caracteres corrompidos e substitua-os. <note -> <para -> Não procure por marcas de questionamento propriamente, porque estes caracteres são apenas exibidos com tal, mas internamente eles são caracteres diferentes. </para -> </note -> Você também pode querer instalar uma fonte Unicode, que contém todos os caracteres necessários. </para> + <para>O texto contém caracteres que podem não ser exibidos com sua fonte de sistema. Se você tem certeza que o texto não contém nenhum destes caracteres, o arquivo pode estar corrompido. Neste caso, marque um marca de questionamento e pressione <keycombo action="simul">&Ctrl;<keycap>F</keycap></keycombo> para encontrar todos os caracteres corrompidos e substitua-os. <note> <para> Não procure por marcas de questionamento propriamente, porque estes caracteres são apenas exibidos com tal, mas internamente eles são caracteres diferentes. </para> </note> Você também pode querer instalar uma fonte Unicode, que contém todos os caracteres necessários. </para> </answer> </qandaentry> <qandaentry> <question> -<para ->Como eu posso traduzir o &kde;? </para> +<para>Como eu posso traduzir o &kde;? </para> </question> <answer> -<para ->Você pode procurar por informações sobre como traduzir o KDE no <ulink url="http://i18n.kde.org/translation-howto/" ->HOWTO de Tradução do KDE</ulink -> </para> +<para>Você pode procurar por informações sobre como traduzir o KDE no <ulink url="http://i18n.kde.org/translation-howto/">HOWTO de Tradução do KDE</ulink> </para> </answer> -</qandaentry -> +</qandaentry> </qandaset> </chapter> <!-- diff --git a/tde-i18n-pt_BR/docs/tdesdk/kbabel/glossary.docbook b/tde-i18n-pt_BR/docs/tdesdk/kbabel/glossary.docbook index 2b9cd5051f3..6d2d050f8e8 100644 --- a/tde-i18n-pt_BR/docs/tdesdk/kbabel/glossary.docbook +++ b/tde-i18n-pt_BR/docs/tdesdk/kbabel/glossary.docbook @@ -1,6 +1,5 @@ <!-- <?xml version="1.0" ?> -<!DOCTYPE glossary PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" -> --> +<!DOCTYPE glossary PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd"> --> <!-- Uncomment the previous two lines to validate this document --> <!-- standalone. Be sure to recomment them before attempting to --> <!-- process index.docbook --> @@ -10,249 +9,83 @@ <!-- Fill in this section if this document has a different author --> <authorgroup> <author> -<personname -><firstname -></firstname -><surname -></surname -></personname> +<personname><firstname></firstname><surname></surname></personname> </author> </authorgroup> -<othercredit role="translator" -><firstname ->Marcus</firstname -><surname ->Gama</surname -><affiliation -><address -><email ->marcus.gama@gmail.com</email -></address -></affiliation -><contrib ->Tradução</contrib -></othercredit -> +<othercredit role="translator"><firstname>Marcus</firstname><surname>Gama</surname><affiliation><address><email>marcus.gama@gmail.com</email></address></affiliation><contrib>Tradução</contrib></othercredit> </glossaryinfo> -<title ->Glossário</title> +<title>Glossário</title> -<glossdiv -><title ->A</title> +<glossdiv><title>A</title> <glossentry id="gloss-auxiliary"> - <glossterm ->Arquivo auxiliar</glossterm> + <glossterm>Arquivo auxiliar</glossterm> <glossdef> - <para ->é um volume específico do &kbabel;. Ele é uma opção para o usuário configurar um arquivo <acronym ->PO</acronym -> para procurar por mensagens originais. Por exemplo, se você é um membro da equipe francesa e tem algum conhecimento de espanhol ou italiano você pode obter e configurar um arquivo auxiliar <acronym ->PO</acronym -> em espanhol associado com o arquivo que está atualmente sendo traduzido. </para> + <para>é um volume específico do &kbabel;. Ele é uma opção para o usuário configurar um arquivo <acronym>PO</acronym> para procurar por mensagens originais. Por exemplo, se você é um membro da equipe francesa e tem algum conhecimento de espanhol ou italiano você pode obter e configurar um arquivo auxiliar <acronym>PO</acronym> em espanhol associado com o arquivo que está atualmente sendo traduzido. </para> </glossdef> </glossentry> </glossdiv> -<glossdiv -><title ->C</title> +<glossdiv><title>C</title> <glossentry id="gloss-compendium"> - <glossterm ->Compêndio</glossterm> + <glossterm>Compêndio</glossterm> <glossdef> - <para ->é uma coleção de todas as traduções para um idioma. Este grande arquivo <acronym ->PO</acronym -> é feito de mensagens únicas de todos os arquivos <acronym ->PO</acronym -> dos aplicativos. Ele pode ser usado para preencher um string já traduzido, não traduzido ou parcialmente traduzido num arquivo <acronym ->PO</acronym ->. O &kbabel; use este arquivo no mecanismo de busca do <quote ->Compêndio PO</quote ->. </para> + <para>é uma coleção de todas as traduções para um idioma. Este grande arquivo <acronym>PO</acronym> é feito de mensagens únicas de todos os arquivos <acronym>PO</acronym> dos aplicativos. Ele pode ser usado para preencher um string já traduzido, não traduzido ou parcialmente traduzido num arquivo <acronym>PO</acronym>. O &kbabel; use este arquivo no mecanismo de busca do <quote>Compêndio PO</quote>. </para> </glossdef> </glossentry> </glossdiv> -<glossdiv -><title ->F</title> +<glossdiv><title>F</title> <glossentry id="fuzzy"> - <glossterm ->Fuzzy (Aproximado)</glossterm> + <glossterm>Fuzzy (Aproximado)</glossterm> <glossdef> - <para ->Isto é um sinalizador gerado, em geral, pelo <command ->msgmerge</command ->. Ele mostra que um string <acronym ->msgstr</acronym -> pode não estar corretamente traduzido. O tradutor deve ver e fazer as modificações no string se necessário e então remover o sinalizador <quote ->aproximado</quote -> dos comentários da mensagem. </para> + <para>Isto é um sinalizador gerado, em geral, pelo <command>msgmerge</command>. Ele mostra que um string <acronym>msgstr</acronym> pode não estar corretamente traduzido. O tradutor deve ver e fazer as modificações no string se necessário e então remover o sinalizador <quote>aproximado</quote> dos comentários da mensagem. </para> </glossdef> </glossentry> </glossdiv> -<glossdiv -><title ->I</title> - <glossentry id="i18n" -><glossterm ->Internacionalização</glossterm -> <acronym ->i18n</acronym -> <glossdef> - <para ->é a operação na qual um aplicativo é tornado apto a suportar múltiplos idiomas. A palavra <quote ->internationalization</quote -> (internacionalização no idioma inglês) possui 20 caracteres então, para encurtá-la, pessoas começaram a escrever somente o primeiro e último caracter e entre eles escreveram o número de caracteres intermediários (18) formando a conhecida abreviatura <acronym ->i18n</acronym ->. </para> - <glossseealso otherterm="l10n" -></glossseealso> +<glossdiv><title>I</title> + <glossentry id="i18n"><glossterm>Internacionalização</glossterm> <acronym>i18n</acronym> <glossdef> + <para>é a operação na qual um aplicativo é tornado apto a suportar múltiplos idiomas. A palavra <quote>internationalization</quote> (internacionalização no idioma inglês) possui 20 caracteres então, para encurtá-la, pessoas começaram a escrever somente o primeiro e último caracter e entre eles escreveram o número de caracteres intermediários (18) formando a conhecida abreviatura <acronym>i18n</acronym>. </para> + <glossseealso otherterm="l10n"></glossseealso> </glossdef> </glossentry> </glossdiv> -<glossdiv -><title ->L</title> - <glossentry id="l10n" -><glossterm ->Localização</glossterm -> <acronym ->l10n</acronym -> <glossdef> - <para ->é a operação na qual num aplicativo já internacionalizado é feita para processar entradas e saídas num modelo ideal para cultura e idioma de habitantes locais. A palavra <quote ->localization</quote -> (localização no idioma inglês) possui 12 caracteres então, para encurtá-la, pessoas começaram a escrever somente o primeiro e último caracter e entre eles escreveram o número de caracteres intermediários (10) formando a conhecida abreviatura <acronym ->l10n</acronym ->. </para> - <glossseealso otherterm="i18n" -></glossseealso> +<glossdiv><title>L</title> + <glossentry id="l10n"><glossterm>Localização</glossterm> <acronym>l10n</acronym> <glossdef> + <para>é a operação na qual num aplicativo já internacionalizado é feita para processar entradas e saídas num modelo ideal para cultura e idioma de habitantes locais. A palavra <quote>localization</quote> (localização no idioma inglês) possui 12 caracteres então, para encurtá-la, pessoas começaram a escrever somente o primeiro e último caracter e entre eles escreveram o número de caracteres intermediários (10) formando a conhecida abreviatura <acronym>l10n</acronym>. </para> + <glossseealso otherterm="i18n"></glossseealso> </glossdef> </glossentry> </glossdiv> -<glossdiv -><title ->M</title> - <glossentry id="mofile" -><glossterm ->MO</glossterm -> <acronym ->arquivo MO</acronym -> <glossdef> - <para -><acronym ->MO</acronym -> significa <quote ->Machine Object</quote -> (Objeto de Máquina). Um arquivo <acronym ->MO</acronym -> contém dados binários legíveis pelos computadores. O conteúdo de um arquivo <acronym ->MO</acronym -> é organizado como um banco de dados para minimizar o tempo de busca por strings traduzidos. Arquivos <acronym ->MO</acronym -> são obtidos compilando arquivos <acronym ->PO</acronym -> usando <command ->msgfmt</command ->. </para> -<glossseealso otherterm="pofile" -></glossseealso -> <glossseealso otherterm="potfile" -></glossseealso -> </glossdef> +<glossdiv><title>M</title> + <glossentry id="mofile"><glossterm>MO</glossterm> <acronym>arquivo MO</acronym> <glossdef> + <para><acronym>MO</acronym> significa <quote>Machine Object</quote> (Objeto de Máquina). Um arquivo <acronym>MO</acronym> contém dados binários legíveis pelos computadores. O conteúdo de um arquivo <acronym>MO</acronym> é organizado como um banco de dados para minimizar o tempo de busca por strings traduzidos. Arquivos <acronym>MO</acronym> são obtidos compilando arquivos <acronym>PO</acronym> usando <command>msgfmt</command>. </para> +<glossseealso otherterm="pofile"></glossseealso> <glossseealso otherterm="potfile"></glossseealso> </glossdef> </glossentry> - <glossentry id="msgid" -><glossterm ->Message ID (ID da Mensagem)</glossterm -> <acronym ->msgid</acronym -> <glossdef> - <para -><acronym ->msgid</acronym -> é a palavra chave que inicia um string original no arquivo <acronym ->PO</acronym ->. Ele é seguido por um string estilo C que se estende por uma ou mais linhas. </para> - <glossseealso otherterm="msgstr" -></glossseealso> + <glossentry id="msgid"><glossterm>Message ID (ID da Mensagem)</glossterm> <acronym>msgid</acronym> <glossdef> + <para><acronym>msgid</acronym> é a palavra chave que inicia um string original no arquivo <acronym>PO</acronym>. Ele é seguido por um string estilo C que se estende por uma ou mais linhas. </para> + <glossseealso otherterm="msgstr"></glossseealso> </glossdef> </glossentry> - <glossentry id="msgstr" -><glossterm ->Message String (String de Mensagem)</glossterm -> <acronym ->msgstr</acronym -> <glossdef> - <para -><acronym ->msgstr</acronym -> é a palavra chave que inicia o string traduzido no arquivo <acronym ->PO</acronym ->. Ele é seguido por um string no estilo C que se estende por uma ou múltiplas linhas. </para> - <glossseealso otherterm="msgid" -></glossseealso> + <glossentry id="msgstr"><glossterm>Message String (String de Mensagem)</glossterm> <acronym>msgstr</acronym> <glossdef> + <para><acronym>msgstr</acronym> é a palavra chave que inicia o string traduzido no arquivo <acronym>PO</acronym>. Ele é seguido por um string no estilo C que se estende por uma ou múltiplas linhas. </para> + <glossseealso otherterm="msgid"></glossseealso> </glossdef> </glossentry> </glossdiv> -<glossdiv -><title ->P</title> - <glossentry id="pofile" -><glossterm ->PO</glossterm -> <acronym ->arquivo PO</acronym -> <glossdef> - <para -><acronym ->PO</acronym -> significa, do inglês <quote ->Objeto Portável</quote ->. Arquivos <acronym ->PO</acronym -> contém um conjunto de strings que associam cada string traduzível com sua tradução num idioma específico. Um simples arquivo <acronym ->PO</acronym -> relaciona-se somente com um idioma. Um arquivo <acronym ->PO</acronym -> é derivado de um arquivo <acronym ->POT</acronym -> e é editado tanto manualmente ou usando o &kbabel;. </para> -<glossseealso otherterm="potfile" -></glossseealso -> <glossseealso otherterm="mofile" -></glossseealso -> </glossdef> +<glossdiv><title>P</title> + <glossentry id="pofile"><glossterm>PO</glossterm> <acronym>arquivo PO</acronym> <glossdef> + <para><acronym>PO</acronym> significa, do inglês <quote>Objeto Portável</quote>. Arquivos <acronym>PO</acronym> contém um conjunto de strings que associam cada string traduzível com sua tradução num idioma específico. Um simples arquivo <acronym>PO</acronym> relaciona-se somente com um idioma. Um arquivo <acronym>PO</acronym> é derivado de um arquivo <acronym>POT</acronym> e é editado tanto manualmente ou usando o &kbabel;. </para> +<glossseealso otherterm="potfile"></glossseealso> <glossseealso otherterm="mofile"></glossseealso> </glossdef> </glossentry> - <glossentry id="potfile" -><glossterm ->POT</glossterm -> <acronym ->arquivo POT</acronym -> <glossdef> - <para -><acronym ->POT</acronym -> significa <quote ->Portable Object Template</quote -> (Modelo de Objeto Portável). Um arquivo <quote ->POT</quote -> é construído extraindo todos os strings traduzíveis dos arquivos fonte de um aplicativo. Um arquivo <quote ->POT</quote -> não contém traduções para nenhum idioma em particular — ele é usado pelos tradutores como um modelo. </para> -<glossseealso otherterm="pofile" -></glossseealso -> <glossseealso otherterm="mofile" -></glossseealso -> </glossdef> + <glossentry id="potfile"><glossterm>POT</glossterm> <acronym>arquivo POT</acronym> <glossdef> + <para><acronym>POT</acronym> significa <quote>Portable Object Template</quote> (Modelo de Objeto Portável). Um arquivo <quote>POT</quote> é construído extraindo todos os strings traduzíveis dos arquivos fonte de um aplicativo. Um arquivo <quote>POT</quote> não contém traduções para nenhum idioma em particular — ele é usado pelos tradutores como um modelo. </para> +<glossseealso otherterm="pofile"></glossseealso> <glossseealso otherterm="mofile"></glossseealso> </glossdef> </glossentry> </glossdiv> diff --git a/tde-i18n-pt_BR/docs/tdesdk/kbabel/index.docbook b/tde-i18n-pt_BR/docs/tdesdk/kbabel/index.docbook index e0f8a45672b..0469fe26d43 100644 --- a/tde-i18n-pt_BR/docs/tdesdk/kbabel/index.docbook +++ b/tde-i18n-pt_BR/docs/tdesdk/kbabel/index.docbook @@ -11,104 +11,52 @@ <!ENTITY kappname "&kbabel;"> <!ENTITY package "tdesdk"> <!ENTITY % addindex "IGNORE"> - <!ENTITY % Brazilian-Portuguese "INCLUDE" -> <!-- change language only here --> + <!ENTITY % Brazilian-Portuguese "INCLUDE"> <!-- change language only here --> ]> <book lang="&language;"> <bookinfo> -<title ->O Manual do &kbabel;</title> +<title>O Manual do &kbabel;</title> <authorgroup> -<author ->&Stanislav.Visnovsky; &Stanislav.Visnovsky.mail; </author> -<author ->&Matthias.Kiefer; </author> -<author -><firstname ->Nicolas</firstname -> <surname ->Goutte</surname -> <email ->goutte@kde.org</email -> </author> -<othercredit role="translator" -><firstname ->Marcus</firstname -><surname ->Gama</surname -><affiliation -><address -><email ->marcus.gama@gmail.com</email -></address -></affiliation -><contrib ->Tradução</contrib -></othercredit -> +<author>&Stanislav.Visnovsky; &Stanislav.Visnovsky.mail; </author> +<author>&Matthias.Kiefer; </author> +<author><firstname>Nicolas</firstname> <surname>Goutte</surname> <email>goutte@kde.org</email> </author> +<othercredit role="translator"><firstname>Marcus</firstname><surname>Gama</surname><affiliation><address><email>marcus.gama@gmail.com</email></address></affiliation><contrib>Tradução</contrib></othercredit> </authorgroup> -<date ->2005-12-29</date> -<releaseinfo ->3.5.1.03</releaseinfo> +<date>2005-12-29</date> +<releaseinfo>3.5.1.03</releaseinfo> <abstract> -<para ->O &kbabel; é uma suíte composta de um avançado e fácil de usar editor de arquivos PO &kbabel;, um &catalogmanager; multi-funcional e um dicionário para tradutores &kbabeldict;. Ele suporta muitas características avançadas e permite-lhe personalizar muitas opções. </para> +<para>O &kbabel; é uma suíte composta de um avançado e fácil de usar editor de arquivos PO &kbabel;, um &catalogmanager; multi-funcional e um dicionário para tradutores &kbabeldict;. Ele suporta muitas características avançadas e permite-lhe personalizar muitas opções. </para> </abstract> <keywordset> -<keyword ->KDE</keyword> -<keyword ->KBabel</keyword> -<keyword ->gerenciadorcatálogo</keyword> -<keyword ->tdesdk</keyword> -<keyword ->gettext</keyword> -<keyword ->tradução</keyword> -<keyword ->i18n</keyword> -<keyword ->internacionalização</keyword> -<keyword ->l10n</keyword> -<keyword ->localização</keyword> +<keyword>KDE</keyword> +<keyword>KBabel</keyword> +<keyword>gerenciadorcatálogo</keyword> +<keyword>tdesdk</keyword> +<keyword>gettext</keyword> +<keyword>tradução</keyword> +<keyword>i18n</keyword> +<keyword>internacionalização</keyword> +<keyword>l10n</keyword> +<keyword>localização</keyword> </keywordset> </bookinfo> <chapter id="introduction"> -<title ->Introdução</title> - -<important -><para ->No seu estado atual, esta documentação do KBabel está parcialmente desatualizada. A documentação básica foi criada para o KDE 3.2, enquanto as correções dizem respeito ao KBabel 1.11.1 do KDE 3.5.1. </para -></important> - -<para ->O &kbabel; é um editor de arquivos <acronym ->PO</acronym -> (catálogo de mensagens &GNU; gettext) avançado e fácil de usar. Ele possui muitos recursos que tornam a edição e gerenciamento de seus arquivos <acronym ->PO</acronym -> muito fácil. Isto inclui completa capacidade de navegação, extensiva funcionalidade de edição, funções de busca, verificação de sintaxe e funções estatísticas. O &catalogmanager; é um gerenciador de arquivos que lhe auxilia a manter uma visão sobre seus arquivos <acronym ->PO</acronym ->. O &kbabeldict; possibilita traduzir qualquer texto usando os recursos do &kbabel; de tradução automática. A suíte &kbabel; lhe auxiliará a traduzir rapidamente e também manter as traduções consistentes. </para> - -<para ->Com o crescimento contínuo do projeto &kde; o número de mensagens <acronym ->PO</acronym -> atualmente é de mais de 47000 quando da escrita desta documentação (mais outras 20000 mensagens usadas para tradução da documentação dos aplicativos). Existe uma necessidade de manter organizadas e consistentes todas as traduções. </para> +<title>Introdução</title> + +<important><para>No seu estado atual, esta documentação do KBabel está parcialmente desatualizada. A documentação básica foi criada para o KDE 3.2, enquanto as correções dizem respeito ao KBabel 1.11.1 do KDE 3.5.1. </para></important> + +<para>O &kbabel; é um editor de arquivos <acronym>PO</acronym> (catálogo de mensagens &GNU; gettext) avançado e fácil de usar. Ele possui muitos recursos que tornam a edição e gerenciamento de seus arquivos <acronym>PO</acronym> muito fácil. Isto inclui completa capacidade de navegação, extensiva funcionalidade de edição, funções de busca, verificação de sintaxe e funções estatísticas. O &catalogmanager; é um gerenciador de arquivos que lhe auxilia a manter uma visão sobre seus arquivos <acronym>PO</acronym>. O &kbabeldict; possibilita traduzir qualquer texto usando os recursos do &kbabel; de tradução automática. A suíte &kbabel; lhe auxiliará a traduzir rapidamente e também manter as traduções consistentes. </para> + +<para>Com o crescimento contínuo do projeto &kde; o número de mensagens <acronym>PO</acronym> atualmente é de mais de 47000 quando da escrita desta documentação (mais outras 20000 mensagens usadas para tradução da documentação dos aplicativos). Existe uma necessidade de manter organizadas e consistentes todas as traduções. </para> </chapter> @@ -122,62 +70,37 @@ <chapter id="credits"> -<title ->Créditos e Licença</title> - -<para ->&kbabel; </para> -<para ->Direitos de cópia do programa © 1999-2000 &Matthias.Kiefer; &Matthias.Kiefer.mail; </para> -<para ->Contribuidores: <itemizedlist> -<listitem -><para ->&Thomas.Diehl; &Thomas.Diehl.mail;</para> +<title>Créditos e Licença</title> + +<para>&kbabel; </para> +<para>Direitos de cópia do programa © 1999-2000 &Matthias.Kiefer; &Matthias.Kiefer.mail; </para> +<para>Contribuidores: <itemizedlist> +<listitem><para>&Thomas.Diehl; &Thomas.Diehl.mail;</para> </listitem> -<listitem -><para ->&Stephan.Kulow; &Stephan.Kulow.mail;</para> +<listitem><para>&Stephan.Kulow; &Stephan.Kulow.mail;</para> </listitem> </itemizedlist> </para> -<para ->Direitos de cópia da Documentação © 2000 &Claudiu.Costin; &Claudiu.Costin.mail; and &Matthias.Kiefer; &Matthias.Kiefer.mail;</para> +<para>Direitos de cópia da Documentação © 2000 &Claudiu.Costin; &Claudiu.Costin.mail; and &Matthias.Kiefer; &Matthias.Kiefer.mail;</para> -<para ->Direitos de cópia da Atualização para o &kde; 3.0 © 2002 &Stanislav.Visnovsky; &Stanislav.Visnovsky.mail;</para> +<para>Direitos de cópia da Atualização para o &kde; 3.0 © 2002 &Stanislav.Visnovsky; &Stanislav.Visnovsky.mail;</para> -<para ->Atualização para o &kde; 3.5.1 Direitos autorais © 2005 Nicolas Goutte <email ->goutte@kde.org</email -></para> +<para>Atualização para o &kde; 3.5.1 Direitos autorais © 2005 Nicolas Goutte <email>goutte@kde.org</email></para> -<para ->Tradução de Marcus Gama <email ->marcus.gama@gmail.com</email -></para -> +<para>Tradução de Marcus Gama <email>marcus.gama@gmail.com</email></para> &underFDL; &underGPL; </chapter> &glossary; <appendix id="mailing-list"> -<title ->Lista de Correio do KBabel</title> +<title>Lista de Correio do KBabel</title> -<para ->Existe uma lista de correio para o KBabel chamada 'kbabel'. É uma lista mista para os programadores e para os usuários do KBabel. </para> +<para>Existe uma lista de correio para o KBabel chamada 'kbabel'. É uma lista mista para os programadores e para os usuários do KBabel. </para> -<para ->Você poderá inscrever-se inscrever nela na <ulink url="http://mail.kde.org/mailman/listinfo/kbabel/" ->interface do Mailman</ulink ->. </para> +<para>Você poderá inscrever-se inscrever nela na <ulink url="http://mail.kde.org/mailman/listinfo/kbabel/">interface do Mailman</ulink>. </para> -<para ->A lista de correio tem um <ulink url="http://mail.kde.org/pipermail/kbabel/" ->arquivo público</ulink ->. </para> +<para>A lista de correio tem um <ulink url="http://mail.kde.org/pipermail/kbabel/">arquivo público</ulink>. </para> </appendix> diff --git a/tde-i18n-pt_BR/docs/tdesdk/kbabel/kbabeldict.docbook b/tde-i18n-pt_BR/docs/tdesdk/kbabel/kbabeldict.docbook index 6e4da6af1e4..0a87a6ac422 100644 --- a/tde-i18n-pt_BR/docs/tdesdk/kbabel/kbabeldict.docbook +++ b/tde-i18n-pt_BR/docs/tdesdk/kbabel/kbabeldict.docbook @@ -1,6 +1,5 @@ <!-- <?xml version="1.0" ?> -<!DOCTYPE chapter PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" -> --> +<!DOCTYPE chapter PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd"> --> <!-- Uncomment the previous two lines to validate this document --> <!-- standalone. Be sure to recomment them before attempting to --> <!-- process index.docbook --> @@ -12,82 +11,39 @@ So if you change this id attribute, the name *must* be changed in KBabelDict's s <!-- Fill in this section if this document has a different author --> <authorgroup> <author> -<personname -><firstname -></firstname -><surname -></surname -></personname> +<personname><firstname></firstname><surname></surname></personname> </author> </authorgroup> -<othercredit role="translator" -><firstname ->Marcus</firstname -><surname ->Gama</surname -><affiliation -><address -><email ->marcus.gama@gmail.com</email -></address -></affiliation -><contrib ->Tradução</contrib -></othercredit -> +<othercredit role="translator"><firstname>Marcus</firstname><surname>Gama</surname><affiliation><address><email>marcus.gama@gmail.com</email></address></affiliation><contrib>Tradução</contrib></othercredit> </chapterinfo> -<title ->Usando o &kbabeldict;</title> +<title>Usando o &kbabeldict;</title> <anchor id="kbabeldict"/> -<para ->O &kbabeldict; é uma interface simples para tradução de módulos para o &kbabel;. Ele lhe permite procurar por traduções. </para> +<para>O &kbabeldict; é uma interface simples para tradução de módulos para o &kbabel;. Ele lhe permite procurar por traduções. </para> <screenshot> -<screeninfo ->Captura de tela do &kbabeldict;</screeninfo> +<screeninfo>Captura de tela do &kbabeldict;</screeninfo> <mediaobject> <imageobject> <imagedata fileref="snap_kbabeldict.png" format="PNG"/> </imageobject> -<textobject -><phrase ->Captura de tela do &kbabeldict;</phrase -></textobject> +<textobject><phrase>Captura de tela do &kbabeldict;</phrase></textobject> </mediaobject> </screenshot> -<para ->A captura de tela acima não contém as configurações para o módulo selecionado. Você pode mostrá-las usando <guibutton ->Mostrar Configurações</guibutton ->. As preferências para o módulo selecionado serão mostradas no lado direito da janela. O janela do &kbabeldict; então se parecerá com isso: </para> +<para>A captura de tela acima não contém as configurações para o módulo selecionado. Você pode mostrá-las usando <guibutton>Mostrar Configurações</guibutton>. As preferências para o módulo selecionado serão mostradas no lado direito da janela. O janela do &kbabeldict; então se parecerá com isso: </para> <screenshot> -<screeninfo ->Captura de tela do &kbabeldict;</screeninfo> +<screeninfo>Captura de tela do &kbabeldict;</screeninfo> <mediaobject> <imageobject> <imagedata fileref="snap_kbabeldict2.png" format="PNG"/> </imageobject> -<textobject -><phrase ->Captura de tela do &kbabeldict; com as configurações mostradas</phrase -></textobject> +<textobject><phrase>Captura de tela do &kbabeldict; com as configurações mostradas</phrase></textobject> </mediaobject> </screenshot> -<para ->O uso é muito simples. Você seleciona um módulo na caixa combinada <guilabel ->Procurar no módulo</guilabel ->. Então você insere a frase a ser procurada e pressiona <guibutton ->Iniciar Procura</guibutton ->. Todas as mensagens encontradas serão mostradas na lista abaixo, da mesma maneira que a ferramenta da janela principal do &kbabel;. A busca pode ser interrompida pressionando <guilabel ->Parar</guilabel ->.No caso de você desejar procurar no texto traduzido e não na mensagem original em inglês, você deve usar <guilabel ->Procurar nas traduções</guilabel ->. </para> -<para ->Os botões na parte inferior da janela podem ser usados para fechar o &kbabeldict;, mostrar/ocultar as configurações do módulo ou exibir um diálogo com créditos para o &kbabeldict; e os módulos propriamente ditos. </para> +<para>O uso é muito simples. Você seleciona um módulo na caixa combinada <guilabel>Procurar no módulo</guilabel>. Então você insere a frase a ser procurada e pressiona <guibutton>Iniciar Procura</guibutton>. Todas as mensagens encontradas serão mostradas na lista abaixo, da mesma maneira que a ferramenta da janela principal do &kbabel;. A busca pode ser interrompida pressionando <guilabel>Parar</guilabel>.No caso de você desejar procurar no texto traduzido e não na mensagem original em inglês, você deve usar <guilabel>Procurar nas traduções</guilabel>. </para> +<para>Os botões na parte inferior da janela podem ser usados para fechar o &kbabeldict;, mostrar/ocultar as configurações do módulo ou exibir um diálogo com créditos para o &kbabeldict; e os módulos propriamente ditos. </para> <note> -<para ->Para descrição dos módulos padrão e suas mensagens veja <xref linkend="dictionaries"/>. </para> +<para>Para descrição dos módulos padrão e suas mensagens veja <xref linkend="dictionaries"/>. </para> </note> </chapter> <!-- diff --git a/tde-i18n-pt_BR/docs/tdesdk/kbabel/man-catalogmanager.1.docbook b/tde-i18n-pt_BR/docs/tdesdk/kbabel/man-catalogmanager.1.docbook index e7d71ac430f..87f6cfd5991 100644 --- a/tde-i18n-pt_BR/docs/tdesdk/kbabel/man-catalogmanager.1.docbook +++ b/tde-i18n-pt_BR/docs/tdesdk/kbabel/man-catalogmanager.1.docbook @@ -5,83 +5,41 @@ <refentry lang="&language;"> <refentryinfo> -<date ->07-03-2003</date> +<date>07-03-2003</date> </refentryinfo> <refmeta> -<refentrytitle -><command ->gerenciador de catálogos</command -></refentrytitle> -<manvolnum ->1</manvolnum> +<refentrytitle><command>gerenciador de catálogos</command></refentrytitle> +<manvolnum>1</manvolnum> </refmeta> <refnamediv> -<refname -><command ->gerenciador de catálogos</command -></refname> -<refpurpose ->Um gerenciador de catálogos avançado para o &kbabel;</refpurpose> +<refname><command>gerenciador de catálogos</command></refname> +<refpurpose>Um gerenciador de catálogos avançado para o &kbabel;</refpurpose> </refnamediv> <refsynopsisdiv> -<cmdsynopsis -><command ->catalogmanager</command -> <group -><option ->--project</option -> <replaceable ->arquivo-configuração</replaceable -></group -> <group -><option ->Opções Genéricas do KDE</option -></group -> <group -><option ->Opções Genéricas do Qt</option -></group -> </cmdsynopsis> +<cmdsynopsis><command>catalogmanager</command> <group><option>--project</option> <replaceable>arquivo-configuração</replaceable></group> <group><option>Opções Genéricas do KDE</option></group> <group><option>Opções Genéricas do Qt</option></group> </cmdsynopsis> </refsynopsisdiv> <refsect1> -<title ->Descrição</title> - -<para ->O CatalogManager faz parte de um conjunto de programas para editar os arquivos de mensagens do 'gettext' (arquivos PO). Este pacote está desenhado para ajudá-lo a traduzir rapida e consistentemente.</para> - -<para ->Este pacote contém o &kbabel;, o <application ->CatalogManager</application -> e o &kbabeldict;. O &kbabel; é um editor de arquivos avançado e fácil de usar, com capacidades de navegação e edição avançadas, verificação da sintaxe e estatísticas. O <application ->CatalogManager</application -> (este programa) é um gerenciador de catálogos multi-função que lhe permite manter um registro de vários arquivos PO ao mesmo tempo. O &kbabeldict; é um dicionário para os tradutores.</para> -<para ->Este utilitário faz parte do Kit de Desenvolvimento de Software (SDK) do &kde;.</para -> +<title>Descrição</title> + +<para>O CatalogManager faz parte de um conjunto de programas para editar os arquivos de mensagens do 'gettext' (arquivos PO). Este pacote está desenhado para ajudá-lo a traduzir rapida e consistentemente.</para> + +<para>Este pacote contém o &kbabel;, o <application>CatalogManager</application> e o &kbabeldict;. O &kbabel; é um editor de arquivos avançado e fácil de usar, com capacidades de navegação e edição avançadas, verificação da sintaxe e estatísticas. O <application>CatalogManager</application> (este programa) é um gerenciador de catálogos multi-função que lhe permite manter um registro de vários arquivos PO ao mesmo tempo. O &kbabeldict; é um dicionário para os tradutores.</para> +<para>Este utilitário faz parte do Kit de Desenvolvimento de Software (SDK) do &kde;.</para> </refsect1> <refsect1> -<title ->Opções</title> +<title>Opções</title> <variablelist> <varlistentry> -<term -><option ->--project</option -> <replaceable ->arquivo-configuração</replaceable -></term> +<term><option>--project</option> <replaceable>arquivo-configuração</replaceable></term> <listitem> -<para ->Carrega a configuração a partir do arquivo indicado.</para> +<para>Carrega a configuração a partir do arquivo indicado.</para> </listitem> </varlistentry> </variablelist> @@ -89,24 +47,11 @@ </refsect1> <refsect1> -<title ->Veja Também</title> - -<para ->kbabel(1) kbabeldict(1)</para> - -<para ->Uma documentação do usuário mais detalhada está disponível em <ulink url="help:/kbabel" ->help:/kbabel</ulink -> (tanto poderá inserir este <acronym ->URL</acronym -> no &konqueror;, como executar o <userinput -><command ->khelpcenter</command -> <parameter ->help:/kbabel</parameter -></userinput ->).</para> +<title>Veja Também</title> + +<para>kbabel(1) kbabeldict(1)</para> + +<para>Uma documentação do usuário mais detalhada está disponível em <ulink url="help:/kbabel">help:/kbabel</ulink> (tanto poderá inserir este <acronym>URL</acronym> no &konqueror;, como executar o <userinput><command>khelpcenter</command> <parameter>help:/kbabel</parameter></userinput>).</para> </refsect1> diff --git a/tde-i18n-pt_BR/docs/tdesdk/kbabel/menu.docbook b/tde-i18n-pt_BR/docs/tdesdk/kbabel/menu.docbook index 42f23972e00..241e2fa4a57 100644 --- a/tde-i18n-pt_BR/docs/tdesdk/kbabel/menu.docbook +++ b/tde-i18n-pt_BR/docs/tdesdk/kbabel/menu.docbook @@ -1,6 +1,5 @@ <!-- <?xml version="1.0" ?> -<!DOCTYPE chapter PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" -> --> +<!DOCTYPE chapter PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd"> --> <!-- Uncomment the previous two lines to validate this document --> <!-- standalone. Be sure to recomment them before attempting to --> <!-- process index.docbook --> @@ -11,218 +10,116 @@ <!-- Fill in this section if this document has a different author --> <authorgroup> <author> -<personname -><firstname -></firstname -><surname -></surname -></personname> +<personname><firstname></firstname><surname></surname></personname> </author> </authorgroup> -<othercredit role="translator" -><firstname ->Marcus</firstname -><surname ->Gama</surname -><affiliation -><address -><email ->marcus.gama@gmail.com</email -></address -></affiliation -><contrib ->Tradução</contrib -></othercredit -> +<othercredit role="translator"><firstname>Marcus</firstname><surname>Gama</surname><affiliation><address><email>marcus.gama@gmail.com</email></address></affiliation><contrib>Tradução</contrib></othercredit> </chapterinfo> -<title ->Referência de Comandos</title> +<title>Referência de Comandos</title> <sect1 id="kbabel-menu"> -<title ->O menu do &kbabel;</title> +<title>O menu do &kbabel;</title> <sect2> -<title ->O Menu Arquivo</title> +<title>O Menu Arquivo</title> <variablelist> <varlistentry> <term> - <menuchoice -><shortcut -> <keycombo action="simul" -> &Ctrl;<keycap ->O</keycap -> </keycombo -> </shortcut -> <guimenu ->Arquivo</guimenu -> <guimenuitem ->Abrir</guimenuitem -> </menuchoice> + <menuchoice><shortcut> <keycombo action="simul"> &Ctrl;<keycap>O</keycap> </keycombo> </shortcut> <guimenu>Arquivo</guimenu> <guimenuitem>Abrir</guimenuitem> </menuchoice> </term> <listitem> <para> - <action ->Abre um arquivo PO. Se o arquivo atual foi modificado você será questionado se deseja salvá-lo primeiro. </action> + <action>Abre um arquivo PO. Se o arquivo atual foi modificado você será questionado se deseja salvá-lo primeiro. </action> </para> </listitem> </varlistentry> <varlistentry> <term> - <menuchoice -><guimenu ->Arquivo</guimenu -> <guimenuitem ->Abrir Recente</guimenuitem -> </menuchoice> + <menuchoice><guimenu>Arquivo</guimenu> <guimenuitem>Abrir Recente</guimenuitem> </menuchoice> </term> <listitem> <para> - <action ->Abre um arquivo PO recentemente editado a partir do menu dos documentos recentemente usados </action> + <action>Abre um arquivo PO recentemente editado a partir do menu dos documentos recentemente usados </action> </para> </listitem> </varlistentry> <varlistentry> <term> - <menuchoice -><shortcut -> <keycombo action="simul" -> &Ctrl;<keycap ->S</keycap -> </keycombo -> </shortcut -> <guimenu ->Arquivo</guimenu -> <guimenuitem ->Salvar</guimenuitem -> </menuchoice> + <menuchoice><shortcut> <keycombo action="simul"> &Ctrl;<keycap>S</keycap> </keycombo> </shortcut> <guimenu>Arquivo</guimenu> <guimenuitem>Salvar</guimenuitem> </menuchoice> </term> <listitem> <para> - <action ->Salva o arquivo PO atual. Se ele não foi modificado, nenhuma ação é realizada. </action> + <action>Salva o arquivo PO atual. Se ele não foi modificado, nenhuma ação é realizada. </action> </para> </listitem> </varlistentry> <varlistentry> <term> - <menuchoice -><guimenu ->Arquivo</guimenu -> <guimenuitem ->Salvar Como</guimenuitem -> </menuchoice> + <menuchoice><guimenu>Arquivo</guimenu> <guimenuitem>Salvar Como</guimenuitem> </menuchoice> </term> <listitem> <para> - <action ->Salva o arquivo PO atual com um novo nome </action> + <action>Salva o arquivo PO atual com um novo nome </action> </para> </listitem> </varlistentry> <varlistentry> <term> - <menuchoice -><guimenu ->Arquivo</guimenu -> <guimenuitem ->Salvar Especial</guimenuitem -> </menuchoice> + <menuchoice><guimenu>Arquivo</guimenu> <guimenuitem>Salvar Especial</guimenuitem> </menuchoice> </term> <listitem> <para> - <action ->Exibe o diálogo de Configurações de Salvar e então salva o arquivo PO atual com um novo nome </action> + <action>Exibe o diálogo de Configurações de Salvar e então salva o arquivo PO atual com um novo nome </action> </para> </listitem> </varlistentry> <varlistentry> <term> - <menuchoice -><guimenu ->Arquivo</guimenu -> <guimenuitem ->Reverter</guimenuitem -> </menuchoice> + <menuchoice><guimenu>Arquivo</guimenu> <guimenuitem>Reverter</guimenuitem> </menuchoice> </term> <listitem> <para> - <action ->Carrega a última versão salva do arquivo PO atual </action> + <action>Carrega a última versão salva do arquivo PO atual </action> </para> </listitem> </varlistentry> <varlistentry> <term> - <menuchoice -><guimenu ->Arquivo</guimenu -> <guimenuitem ->Enviar por correio</guimenuitem -> </menuchoice> + <menuchoice><guimenu>Arquivo</guimenu> <guimenuitem>Enviar por correio</guimenuitem> </menuchoice> </term> <listitem> <para> - <action ->Pede por um nome de arquivo no qual salvar o arquivo PO atual e então abre a janela do compositor de mensagem eletrônica com o arquivo como anexo </action> + <action>Pede por um nome de arquivo no qual salvar o arquivo PO atual e então abre a janela do compositor de mensagem eletrônica com o arquivo como anexo </action> </para> </listitem> </varlistentry> <varlistentry> <term> - <menuchoice -><guimenu ->Arquivo</guimenu -> <guimenuitem ->Nova Visão</guimenuitem -> </menuchoice> + <menuchoice><guimenu>Arquivo</guimenu> <guimenuitem>Nova Visão</guimenuitem> </menuchoice> </term> <listitem> - <para -><action -> Abre uma nova janela com o arquivo atualmente aberto. </action -> Muito útil se você tem que traduzir arquivos muito grandes e você precisa ficar de olho em alguns trechos de texto. </para> + <para><action> Abre uma nova janela com o arquivo atualmente aberto. </action> Muito útil se você tem que traduzir arquivos muito grandes e você precisa ficar de olho em alguns trechos de texto. </para> </listitem> </varlistentry> <varlistentry> <term> - <menuchoice -><guimenu ->Arquivo</guimenu -> <guimenuitem ->Nova Janela</guimenuitem -> </menuchoice> + <menuchoice><guimenu>Arquivo</guimenu> <guimenuitem>Nova Janela</guimenuitem> </menuchoice> </term> <listitem> <para> - <action ->Abre uma nova janela vazia </action> + <action>Abre uma nova janela vazia </action> </para> </listitem> </varlistentry> <varlistentry> <term> - <menuchoice -><shortcut -> <keycombo action="simul" -> &Ctrl;<keycap ->Q</keycap -> </keycombo -> </shortcut -> <guimenu ->Arquivo</guimenu -> <guimenuitem ->Sair</guimenuitem -> </menuchoice> + <menuchoice><shortcut> <keycombo action="simul"> &Ctrl;<keycap>Q</keycap> </keycombo> </shortcut> <guimenu>Arquivo</guimenu> <guimenuitem>Sair</guimenuitem> </menuchoice> </term> <listitem> <para> - <action ->Sai do editor do &kbabel; </action> + <action>Sai do editor do &kbabel; </action> </para> </listitem> </varlistentry> @@ -230,345 +127,162 @@ </sect2> <sect2> -<title ->O Menu Editar</title> +<title>O Menu Editar</title> <variablelist> <varlistentry> <term> - <menuchoice -><shortcut -> <keycombo action="simul" -> &Ctrl;<keycap ->Z</keycap -> </keycombo -> </shortcut -> <guimenu ->Editar</guimenu -> <guimenuitem ->Desfazer</guimenuitem -> </menuchoice> + <menuchoice><shortcut> <keycombo action="simul"> &Ctrl;<keycap>Z</keycap> </keycombo> </shortcut> <guimenu>Editar</guimenu> <guimenuitem>Desfazer</guimenuitem> </menuchoice> </term> <listitem> <para> - <action ->Desfaz a última ação de edição na caixa de edição de tradução </action> + <action>Desfaz a última ação de edição na caixa de edição de tradução </action> </para> </listitem> </varlistentry> <varlistentry> <term> - <menuchoice -><shortcut -> <keycombo action="simul" -> &Ctrl;&Shift;<keycap ->Z</keycap -> </keycombo -> </shortcut -> <guimenu ->Editar</guimenu -> <guimenuitem ->Refazer</guimenuitem -> </menuchoice> + <menuchoice><shortcut> <keycombo action="simul"> &Ctrl;&Shift;<keycap>Z</keycap> </keycombo> </shortcut> <guimenu>Editar</guimenu> <guimenuitem>Refazer</guimenuitem> </menuchoice> </term> <listitem> <para> - <action ->Refaz a última ação de edição desfeita na caixa de edição de tradução </action> + <action>Refaz a última ação de edição desfeita na caixa de edição de tradução </action> </para> </listitem> </varlistentry> <varlistentry> <term> - <menuchoice -><shortcut -> <keycombo action="simul" -> &Ctrl;<keycap ->X</keycap -> </keycombo -> </shortcut -> <guimenu ->Editar</guimenu -> <guimenuitem ->Cortar</guimenuitem -> </menuchoice> + <menuchoice><shortcut> <keycombo action="simul"> &Ctrl;<keycap>X</keycap> </keycombo> </shortcut> <guimenu>Editar</guimenu> <guimenuitem>Cortar</guimenuitem> </menuchoice> </term> <listitem> <para> - <action ->Corta o texto selecionado e move-o para a área de transferência </action> + <action>Corta o texto selecionado e move-o para a área de transferência </action> </para> </listitem> </varlistentry> <varlistentry> <term> - <menuchoice -><shortcut -> <keycombo action="simul" -> &Ctrl;<keycap ->C</keycap -> </keycombo -> </shortcut -> <guimenu ->Editar</guimenu -> <guimenuitem ->Copiar</guimenuitem -> </menuchoice> + <menuchoice><shortcut> <keycombo action="simul"> &Ctrl;<keycap>C</keycap> </keycombo> </shortcut> <guimenu>Editar</guimenu> <guimenuitem>Copiar</guimenuitem> </menuchoice> </term> <listitem> <para> - <action ->Copia o texto selecionado para a área de transferência </action> + <action>Copia o texto selecionado para a área de transferência </action> </para> </listitem> </varlistentry> <varlistentry> <term> - <menuchoice -><shortcut -> <keycombo action="simul" -> &Ctrl;<keycap ->V</keycap -> </keycombo -> </shortcut -> <guimenu ->Editar</guimenu -> <guimenuitem ->Colar</guimenuitem -> </menuchoice> + <menuchoice><shortcut> <keycombo action="simul"> &Ctrl;<keycap>V</keycap> </keycombo> </shortcut> <guimenu>Editar</guimenu> <guimenuitem>Colar</guimenuitem> </menuchoice> </term> <listitem> <para> - <action ->Cola o conteúdo da área de transferência na posição atual do cursor na caixa de edição da tradução. </action> + <action>Cola o conteúdo da área de transferência na posição atual do cursor na caixa de edição da tradução. </action> </para> </listitem> </varlistentry> <varlistentry> <term> - <menuchoice -><guimenu ->Editar</guimenu -> <guimenuitem ->Selecionar Tudo</guimenuitem -> </menuchoice> + <menuchoice><guimenu>Editar</guimenu> <guimenuitem>Selecionar Tudo</guimenuitem> </menuchoice> </term> <listitem> <para> - <action ->Seleciona todo o texto da caixa de edição da tradução </action> + <action>Seleciona todo o texto da caixa de edição da tradução </action> </para> </listitem> </varlistentry> <varlistentry> <term> - <menuchoice -><shortcut -> <keycombo action="simul" -> &Ctrl;<keycap ->F</keycap -> </keycombo -> </shortcut -> <guimenu ->Editar</guimenu -> <guimenuitem ->Procurar...</guimenuitem -> </menuchoice> + <menuchoice><shortcut> <keycombo action="simul"> &Ctrl;<keycap>F</keycap> </keycombo> </shortcut> <guimenu>Editar</guimenu> <guimenuitem>Procurar...</guimenuitem> </menuchoice> </term> <listitem> <para> - <action ->Abre o diálogo Procurar para procurar strings no arquivo PO atual </action> + <action>Abre o diálogo Procurar para procurar strings no arquivo PO atual </action> </para> </listitem> </varlistentry> <varlistentry> <term> - <menuchoice -><shortcut -> <keycap ->F3</keycap -> </shortcut -> <guimenu ->Editar</guimenu -> <guimenuitem ->Procurar Próximo</guimenuitem -> </menuchoice> + <menuchoice><shortcut> <keycap>F3</keycap> </shortcut> <guimenu>Editar</guimenu> <guimenuitem>Procurar Próximo</guimenuitem> </menuchoice> </term> <listitem> <para> - <action ->Procura a próxima ocorrência do string da ação anterior de procura </action> + <action>Procura a próxima ocorrência do string da ação anterior de procura </action> </para> </listitem> </varlistentry> <varlistentry> <term> - <menuchoice -><shortcut -> <keycombo action="simul" -> &Ctrl;<keycap ->R</keycap -> </keycombo -> </shortcut -> <guimenu ->Editar</guimenu -> <guimenuitem ->Substituir...</guimenuitem -> </menuchoice> + <menuchoice><shortcut> <keycombo action="simul"> &Ctrl;<keycap>R</keycap> </keycombo> </shortcut> <guimenu>Editar</guimenu> <guimenuitem>Substituir...</guimenuitem> </menuchoice> </term> <listitem> <para> - <action ->Abre o diálogo Substituir para procurar e substituir strings no arquivo PO atual </action> + <action>Abre o diálogo Substituir para procurar e substituir strings no arquivo PO atual </action> </para> </listitem> </varlistentry> <varlistentry> <term> - <menuchoice -><shortcut -> <keycombo action="simul" -> &Ctrl;<keycap ->Delete</keycap -> </keycombo -> </shortcut -> <guimenu ->Editar</guimenu -> <guimenuitem ->Limpar</guimenuitem -> </menuchoice> + <menuchoice><shortcut> <keycombo action="simul"> &Ctrl;<keycap>Delete</keycap> </keycombo> </shortcut> <guimenu>Editar</guimenu> <guimenuitem>Limpar</guimenuitem> </menuchoice> </term> <listitem> <para> - <action ->Limpa a tradução da msgid atual </action> + <action>Limpa a tradução da msgid atual </action> </para> </listitem> </varlistentry> <varlistentry> <term> - <menuchoice -><shortcut -> <keycombo action="simul" -> &Ctrl;<keycap ->Space</keycap -> </keycombo -> </shortcut -> <guimenu ->Editar</guimenu -> <guimenuitem ->Copiar Msgid para Msgstr</guimenuitem -> </menuchoice> + <menuchoice><shortcut> <keycombo action="simul"> &Ctrl;<keycap>Space</keycap> </keycombo> </shortcut> <guimenu>Editar</guimenu> <guimenuitem>Copiar Msgid para Msgstr</guimenuitem> </menuchoice> </term> <listitem> <para> - <action ->O string original em Inglês é copiado para a caixa de edição de tradução. Isto é útil quando você não precisa fazer nenhuma mudança (ou apenas pequenas) no texto original em Inglês (msgstr). </action> + <action>O string original em Inglês é copiado para a caixa de edição de tradução. Isto é útil quando você não precisa fazer nenhuma mudança (ou apenas pequenas) no texto original em Inglês (msgstr). </action> </para> </listitem> </varlistentry> <varlistentry> <term> - <menuchoice -><shortcut -> <keycombo action="simul" -> &Ctrl;&Alt;<keycap ->Space</keycap -> </keycombo -> </shortcut -> <guimenu ->Editar</guimenu -> <guimenuitem ->Copiar resultado da procura para msgstr</guimenuitem -> </menuchoice> + <menuchoice><shortcut> <keycombo action="simul"> &Ctrl;&Alt;<keycap>Space</keycap> </keycombo> </shortcut> <guimenu>Editar</guimenu> <guimenuitem>Copiar resultado da procura para msgstr</guimenuitem> </menuchoice> </term> <listitem> <para> - <action ->Copia o string encontrado após o procura de tradução na caixa de edição do msgstr. Isto é muito útil se você não deseja trabalhar na tradução de uma mesma mensagem repetidamente. </action> + <action>Copia o string encontrado após o procura de tradução na caixa de edição do msgstr. Isto é muito útil se você não deseja trabalhar na tradução de uma mesma mensagem repetidamente. </action> </para> </listitem> </varlistentry> <varlistentry> <term> - <menuchoice -><shortcut -> <keycombo action="simul" -> &Ctrl;<keycap ->U</keycap -> </keycombo -> </shortcut -> <guimenu ->Editar</guimenu -> <guimenuitem ->Alternar Estado Aproximado</guimenuitem -> </menuchoice> + <menuchoice><shortcut> <keycombo action="simul"> &Ctrl;<keycap>U</keycap> </keycombo> </shortcut> <guimenu>Editar</guimenu> <guimenuitem>Alternar Estado Aproximado</guimenuitem> </menuchoice> </term> <listitem> - <para -><action -> Alterna o estado aproximado para a entrada atual.</action -> Isto pode ser útil para tornar o aproximado ligado, ⪚ para marcar a tradução para outra revisão. </para> + <para><action> Alterna o estado aproximado para a entrada atual.</action> Isto pode ser útil para tornar o aproximado ligado, ⪚ para marcar a tradução para outra revisão. </para> </listitem> </varlistentry> <varlistentry> <term> - <menuchoice -><shortcut -> <keycombo action="simul" -> &Ctrl;&Alt;<keycap ->N</keycap -> </keycombo -> </shortcut -> <guimenu ->Editar</guimenu -> <guimenuitem ->Inserir Próxima Marca</guimenuitem -> </menuchoice> + <menuchoice><shortcut> <keycombo action="simul"> &Ctrl;&Alt;<keycap>N</keycap> </keycombo> </shortcut> <guimenu>Editar</guimenu> <guimenuitem>Inserir Próxima Marca</guimenuitem> </menuchoice> </term> <listitem> <para> - <action ->Insere a próxima tag encontrada no msgid na tradução, se o texto original em Inglês contém tags de marcação </action> + <action>Insere a próxima tag encontrada no msgid na tradução, se o texto original em Inglês contém tags de marcação </action> </para> </listitem> </varlistentry> <varlistentry> <term> - <menuchoice -><shortcut -> <keycombo action="simul" ->&Ctrl;&Alt;<keycap ->N</keycap -></keycombo -> </shortcut -> <guimenu ->Editar</guimenu -> <guisubmenu ->Inserir Marca</guisubmenu -> </menuchoice> + <menuchoice><shortcut> <keycombo action="simul">&Ctrl;&Alt;<keycap>N</keycap></keycombo> </shortcut> <guimenu>Editar</guimenu> <guisubmenu>Inserir Marca</guisubmenu> </menuchoice> </term> <listitem> <para> - <action ->Este sub-menu contém todas as marcações encontradas no string original em inglês. Selecionando uma delas você pode inserí-la na posição atual do cursor no texto traduzido. </action> + <action>Este sub-menu contém todas as marcações encontradas no string original em inglês. Selecionando uma delas você pode inserí-la na posição atual do cursor no texto traduzido. </action> </para> </listitem> </varlistentry> <varlistentry> <term> - <menuchoice -><guimenu ->Editar</guimenu -> <guimenuitem ->Editar Cabeçalho...</guimenuitem -> </menuchoice> + <menuchoice><guimenu>Editar</guimenu> <guimenuitem>Editar Cabeçalho...</guimenuitem> </menuchoice> </term> <listitem> - <para -><action -> Edita o cabeçalho do arquivo PO.</action -> Atualmente existem muitas linhas de cabeçalho que mantém a última data de tradução, nome do tradutor e e-mail, idioma e codificação do texto traduzido &etc;. </para> + <para><action> Edita o cabeçalho do arquivo PO.</action> Atualmente existem muitas linhas de cabeçalho que mantém a última data de tradução, nome do tradutor e e-mail, idioma e codificação do texto traduzido &etc;. </para> </listitem> </varlistentry> </variablelist> @@ -576,318 +290,152 @@ <sect2> -<title ->O Menu Ir</title> +<title>O Menu Ir</title> <variablelist> <varlistentry> <term> - <menuchoice -><shortcut -> <keycap ->Page Up</keycap -> </shortcut -> <guimenu ->Ir</guimenu -> <guimenuitem ->Anterior</guimenuitem -> </menuchoice> + <menuchoice><shortcut> <keycap>Page Up</keycap> </shortcut> <guimenu>Ir</guimenu> <guimenuitem>Anterior</guimenuitem> </menuchoice> </term> <listitem> <para> - <action ->Pula para a entrada anterior no arquivo PO. </action> + <action>Pula para a entrada anterior no arquivo PO. </action> </para> </listitem> </varlistentry> <varlistentry> <term> - <menuchoice -><shortcut -> <keycap ->Page Down</keycap -> </shortcut -> <guimenu ->Ir</guimenu -> <guimenuitem ->Próxima</guimenuitem -> </menuchoice> + <menuchoice><shortcut> <keycap>Page Down</keycap> </shortcut> <guimenu>Ir</guimenu> <guimenuitem>Próxima</guimenuitem> </menuchoice> </term> <listitem> <para> - <action ->Pula para a próxima entrada no arquivo PO. </action -> + <action>Pula para a próxima entrada no arquivo PO. </action> </para> </listitem> </varlistentry> <varlistentry> <term> - <menuchoice -><guimenu ->Ir</guimenu -> <guimenuitem ->Ir para...</guimenuitem -> </menuchoice> + <menuchoice><guimenu>Ir</guimenu> <guimenuitem>Ir para...</guimenuitem> </menuchoice> </term> <listitem> <para> - <action ->Abre um diálogo para saltar para um número de entrada especificado do arquivo PO. </action -> + <action>Abre um diálogo para saltar para um número de entrada especificado do arquivo PO. </action> </para> </listitem> </varlistentry> <varlistentry> <term> - <menuchoice -><guimenu ->Ir</guimenu -> <guimenuitem ->Primeira Entrada</guimenuitem -> </menuchoice> + <menuchoice><guimenu>Ir</guimenu> <guimenuitem>Primeira Entrada</guimenuitem> </menuchoice> </term> <listitem> <para> - <action ->Pula para a primeira entrada no arquivo PO. </action -> + <action>Pula para a primeira entrada no arquivo PO. </action> </para> </listitem> </varlistentry> <varlistentry> <term> - <menuchoice -><guimenu ->Ir</guimenu -> <guimenuitem ->Última Entrada</guimenuitem -> </menuchoice> + <menuchoice><guimenu>Ir</guimenu> <guimenuitem>Última Entrada</guimenuitem> </menuchoice> </term> <listitem> <para> - <action ->Pula para a última entrada no arquivo PO. </action> + <action>Pula para a última entrada no arquivo PO. </action> </para> </listitem> </varlistentry> <varlistentry> <term> - <menuchoice -><shortcut -> <keycombo action="simul" -> &Ctrl;&Shift;<keycap ->Page Up</keycap -> </keycombo -> </shortcut -> <guimenu ->Ir</guimenu -> <guimenuitem ->Aproximada ou Não Traduzida Anterior</guimenuitem -> </menuchoice> + <menuchoice><shortcut> <keycombo action="simul"> &Ctrl;&Shift;<keycap>Page Up</keycap> </keycombo> </shortcut> <guimenu>Ir</guimenu> <guimenuitem>Aproximada ou Não Traduzida Anterior</guimenuitem> </menuchoice> </term> <listitem> <para> - <action ->Salta para a entrada anterior que não foi traduzida ou está marcada como aproximada. </action> + <action>Salta para a entrada anterior que não foi traduzida ou está marcada como aproximada. </action> </para> </listitem> </varlistentry> <varlistentry> <term> - <menuchoice -><shortcut -> <keycombo action="simul" -> &Ctrl;&Shift;<keycap ->Page Down</keycap -> </keycombo -> </shortcut -> <guimenu ->Ir</guimenu -> <guimenuitem ->Aproximada ou Não Traduzida Seguinte</guimenuitem -> </menuchoice> + <menuchoice><shortcut> <keycombo action="simul"> &Ctrl;&Shift;<keycap>Page Down</keycap> </keycombo> </shortcut> <guimenu>Ir</guimenu> <guimenuitem>Aproximada ou Não Traduzida Seguinte</guimenuitem> </menuchoice> </term> <listitem> <para> - <action ->Salta para a próxima entrada que não foi traduzida ou está marcada como aproximada. </action> + <action>Salta para a próxima entrada que não foi traduzida ou está marcada como aproximada. </action> </para> </listitem> </varlistentry> <varlistentry> <term> - <menuchoice -><shortcut -> <keycombo action="simul" -> &Ctrl;<keycap ->PgUp</keycap -> </keycombo -> </shortcut -> <guimenu ->Ir</guimenu -> <guimenuitem ->Aproximada Anterior</guimenuitem -> </menuchoice> + <menuchoice><shortcut> <keycombo action="simul"> &Ctrl;<keycap>PgUp</keycap> </keycombo> </shortcut> <guimenu>Ir</guimenu> <guimenuitem>Aproximada Anterior</guimenuitem> </menuchoice> </term> <listitem> <para> - <action ->Salta para a entrada anterior que está marcada como aproximada. </action> + <action>Salta para a entrada anterior que está marcada como aproximada. </action> </para> </listitem> </varlistentry> <varlistentry> <term> - <menuchoice -><shortcut -> <keycombo action="simul" -> &Ctrl;<keycap ->Page Down</keycap -> </keycombo -> </shortcut -> <guimenu ->Ir</guimenu -> <guimenuitem ->Aproximada Seguinte</guimenuitem -> </menuchoice> + <menuchoice><shortcut> <keycombo action="simul"> &Ctrl;<keycap>Page Down</keycap> </keycombo> </shortcut> <guimenu>Ir</guimenu> <guimenuitem>Aproximada Seguinte</guimenuitem> </menuchoice> </term> <listitem> <para> - <action ->Salta para a entrada seguinte que está marcada como aproximada. </action> + <action>Salta para a entrada seguinte que está marcada como aproximada. </action> </para> </listitem> </varlistentry> <varlistentry> <term> - <menuchoice -><shortcut -> <keycombo action="simul" -> &Alt;<keycap ->Page Up</keycap -> </keycombo -> </shortcut -> <guimenu ->Ir</guimenu -> <guimenuitem ->Não Traduzida Anterior</guimenuitem -> </menuchoice> + <menuchoice><shortcut> <keycombo action="simul"> &Alt;<keycap>Page Up</keycap> </keycombo> </shortcut> <guimenu>Ir</guimenu> <guimenuitem>Não Traduzida Anterior</guimenuitem> </menuchoice> </term> <listitem> <para> - <action ->Salta para entrada anterior que está marcada como não traduzida. </action> + <action>Salta para entrada anterior que está marcada como não traduzida. </action> </para> </listitem> </varlistentry> <varlistentry> <term> - <menuchoice -><shortcut -> <keycombo action="simul" -> &Alt;<keycap ->Page Down</keycap -> </keycombo -> </shortcut -> <guimenu ->Ir</guimenu -> <guimenuitem ->Não Traduzida Seguinte</guimenuitem -> </menuchoice> + <menuchoice><shortcut> <keycombo action="simul"> &Alt;<keycap>Page Down</keycap> </keycombo> </shortcut> <guimenu>Ir</guimenu> <guimenuitem>Não Traduzida Seguinte</guimenuitem> </menuchoice> </term> <listitem> <para> - <action ->Salta para entrada seguinte que está marcada como não traduzida. </action> + <action>Salta para entrada seguinte que está marcada como não traduzida. </action> </para> </listitem> </varlistentry> <varlistentry> <term> - <menuchoice -><shortcut -> <keycombo action="simul" -> &Shift;<keycap ->Page Up</keycap -> </keycombo -> </shortcut -> <guimenu ->Ir</guimenu -> <guimenuitem ->Erro Anterior</guimenuitem -> </menuchoice> + <menuchoice><shortcut> <keycombo action="simul"> &Shift;<keycap>Page Up</keycap> </keycombo> </shortcut> <guimenu>Ir</guimenu> <guimenuitem>Erro Anterior</guimenuitem> </menuchoice> </term> <listitem> <para> - <action ->Salta para a entrada anterior que possui erro. O erro normalmente acontece quando você se esquece de escapar aspas duplos ou o string original termina em "novalinha" caracter (\n) e o string traduzido não (e vice versa). </action> + <action>Salta para a entrada anterior que possui erro. O erro normalmente acontece quando você se esquece de escapar aspas duplos ou o string original termina em "novalinha" caracter (\n) e o string traduzido não (e vice versa). </action> </para> </listitem> </varlistentry> <varlistentry> <term> - <menuchoice -><shortcut -> <keycombo action="simul" -> &Shift;<keycap ->Page Down</keycap -> </keycombo -> </shortcut -> <guimenu ->Ir</guimenu -> <guimenuitem ->Erro Seguinte</guimenuitem -> </menuchoice> + <menuchoice><shortcut> <keycombo action="simul"> &Shift;<keycap>Page Down</keycap> </keycombo> </shortcut> <guimenu>Ir</guimenu> <guimenuitem>Erro Seguinte</guimenuitem> </menuchoice> </term> <listitem> <para> - <action ->Salta para a próxima entrada com um erro. </action> + <action>Salta para a próxima entrada com um erro. </action> </para> </listitem> </varlistentry> <varlistentry> <term> - <menuchoice -><shortcut -> <keycombo action="simul" -> &Alt;<keycap ->Left Arrow</keycap -> </keycombo -> </shortcut -> <guimenu ->Ir</guimenu -> <guimenuitem ->Voltar</guimenuitem -> </menuchoice> + <menuchoice><shortcut> <keycombo action="simul"> &Alt;<keycap>Left Arrow</keycap> </keycombo> </shortcut> <guimenu>Ir</guimenu> <guimenuitem>Voltar</guimenuitem> </menuchoice> </term> <listitem> - <para -><action -> Salta para a última entrada visitada</action -> do arquivo PO. </para> + <para><action> Salta para a última entrada visitada</action> do arquivo PO. </para> </listitem> </varlistentry> <varlistentry> <term> - <menuchoice -><shortcut -> <keycombo action="simul" -> &Alt;<keycap ->Right Arrow</keycap -> </keycombo -> </shortcut -> <guimenu ->Ir</guimenu -> <guimenuitem ->Avançar</guimenuitem -> </menuchoice> + <menuchoice><shortcut> <keycombo action="simul"> &Alt;<keycap>Right Arrow</keycap> </keycombo> </shortcut> <guimenu>Ir</guimenu> <guimenuitem>Avançar</guimenuitem> </menuchoice> </term> <listitem> - <para -><action -> Salta para a entrada anteriormente visitada</action -> do arquivo PO. </para> + <para><action> Salta para a entrada anteriormente visitada</action> do arquivo PO. </para> </listitem> </varlistentry> </variablelist> @@ -895,138 +443,70 @@ <sect2> -<title ->O Meu Dicionários</title> -<para ->Observe que este menu é dinâmico. ele depende dos plugins de dicionários instalados. Por padrão são três. </para> +<title>O Meu Dicionários</title> +<para>Observe que este menu é dinâmico. ele depende dos plugins de dicionários instalados. Por padrão são três. </para> <variablelist> <varlistentry> <term> - <menuchoice -><guimenu ->Dicionários</guimenu -> <guimenuitem ->Procurar Texto</guimenuitem -> <guimenuitem ->Mecanismo de Busca de Banco de Dados do KDE</guimenuitem -> </menuchoice> + <menuchoice><guimenu>Dicionários</guimenu> <guimenuitem>Procurar Texto</guimenuitem> <guimenuitem>Mecanismo de Busca de Banco de Dados do KDE</guimenuitem> </menuchoice> </term> <listitem> - <para -><action -> Inicia a busca da tradução para a mensagem atual original em Inglês</action -> usando o Mecanismo de Busca de Banco de Dados do &kde;. </para> + <para><action> Inicia a busca da tradução para a mensagem atual original em Inglês</action> usando o Mecanismo de Busca de Banco de Dados do &kde;. </para> </listitem> </varlistentry> <varlistentry> <term> - <menuchoice -><guimenu ->Dicionários</guimenu -> <guimenuitem ->Procurar Texto</guimenuitem -> <guimenuitem ->PO Auxiliar</guimenuitem -> </menuchoice> + <menuchoice><guimenu>Dicionários</guimenu> <guimenuitem>Procurar Texto</guimenuitem> <guimenuitem>PO Auxiliar</guimenuitem> </menuchoice> </term> <listitem> - <para -><action -> Inicia a busca da tradução para a mensagem atual original em Inglês</action -> no arquivo <acronym ->PO</acronym -> definido pelo usuário. </para> + <para><action> Inicia a busca da tradução para a mensagem atual original em Inglês</action> no arquivo <acronym>PO</acronym> definido pelo usuário. </para> </listitem> </varlistentry> <varlistentry> <term> - <menuchoice -><guimenu ->Dicionários</guimenu -> <guimenuitem ->Procurar Texto</guimenuitem -> <guimenuitem ->Compêndio PO</guimenuitem -> </menuchoice> + <menuchoice><guimenu>Dicionários</guimenu> <guimenuitem>Procurar Texto</guimenuitem> <guimenuitem>Compêndio PO</guimenuitem> </menuchoice> </term> <listitem> <para> - <action ->Inicia a busca da tradução para a mensagem atual original em Inglês no arquivo de compêndio (feito pela mesclagem de todas as mensagens traduzidas para um idioma). </action> + <action>Inicia a busca da tradução para a mensagem atual original em Inglês no arquivo de compêndio (feito pela mesclagem de todas as mensagens traduzidas para um idioma). </action> </para> </listitem> </varlistentry> <varlistentry> <term> - <menuchoice -><guimenu ->Dicionários</guimenu -> <guimenuitem ->Procurar Texto Selecionado</guimenuitem -> <guimenuitem ->Mecanismo de Busca de Banco de Dados do KDE</guimenuitem -> </menuchoice> + <menuchoice><guimenu>Dicionários</guimenu> <guimenuitem>Procurar Texto Selecionado</guimenuitem> <guimenuitem>Mecanismo de Busca de Banco de Dados do KDE</guimenuitem> </menuchoice> </term> <listitem> - <para -><action -> Inicia a busca do texto selecionado</action -> usando o Mecanismo de Busca de Banco de Dados do &kde;. </para> + <para><action> Inicia a busca do texto selecionado</action> usando o Mecanismo de Busca de Banco de Dados do &kde;. </para> </listitem> </varlistentry> <varlistentry> <term> - <menuchoice -><guimenu ->Dicionários</guimenu -> <guimenuitem ->Procurar Texto Selecionado</guimenuitem -> <guimenuitem ->PO Auxiliar</guimenuitem -> </menuchoice> + <menuchoice><guimenu>Dicionários</guimenu> <guimenuitem>Procurar Texto Selecionado</guimenuitem> <guimenuitem>PO Auxiliar</guimenuitem> </menuchoice> </term> <listitem> <para> - <action ->Inicia a busca do texto selecionado usando o arquivo definido pelo usuário. </action> + <action>Inicia a busca do texto selecionado usando o arquivo definido pelo usuário. </action> </para> </listitem> </varlistentry> <varlistentry> <term> - <menuchoice -><guimenu ->Dicionários</guimenu -> <guimenuitem ->Procurar Texto Selecionado</guimenuitem -> <guimenuitem ->Compêndio PO</guimenuitem -> </menuchoice> + <menuchoice><guimenu>Dicionários</guimenu> <guimenuitem>Procurar Texto Selecionado</guimenuitem> <guimenuitem>Compêndio PO</guimenuitem> </menuchoice> </term> <listitem> <para> - <action ->Inicia a busca do texto selecionado usando o arquivo de compêndio com todas as mensagens traduzidas de um idioma. </action> + <action>Inicia a busca do texto selecionado usando o arquivo de compêndio com todas as mensagens traduzidas de um idioma. </action> </para> </listitem> </varlistentry> <varlistentry> <term> - <menuchoice -><guimenu ->Dicionários</guimenu -> <guimenuitem ->Editar Dicionário</guimenuitem -> </menuchoice> + <menuchoice><guimenu>Dicionários</guimenu> <guimenuitem>Editar Dicionário</guimenuitem> </menuchoice> </term> <listitem> - <para -><action -> Permite-lhe editar o conteúdo do dicionário atual. Útil se você encontrou erros no dicionário e não quer que erros sejam reportados ao procurar e substituir strings. </action -> <emphasis ->(Não implementado ainda)</emphasis -> </para> + <para><action> Permite-lhe editar o conteúdo do dicionário atual. Útil se você encontrou erros no dicionário e não quer que erros sejam reportados ao procurar e substituir strings. </action> <emphasis>(Não implementado ainda)</emphasis> </para> </listitem> </varlistentry> </variablelist> @@ -1035,725 +515,352 @@ <sect2> -<title ->O Menu Ferramentas</title> +<title>O Menu Ferramentas</title> <variablelist> <varlistentry> <term> - <menuchoice -><guimenu ->Ferramentas</guimenu -> <guimenuitem ->Ortografia</guimenuitem -> <guimenuitem ->Verificar ortografia...</guimenuitem -> </menuchoice> + <menuchoice><guimenu>Ferramentas</guimenu> <guimenuitem>Ortografia</guimenuitem> <guimenuitem>Verificar ortografia...</guimenuitem> </menuchoice> </term> <listitem> - <para -><action -> Exibe o diálogo de configuração de verificação ortográfica.</action -> Após você selecionar as opções desejadas clique <guibutton ->OK</guibutton -> e o diálogo normal de verificação ortográfica aparecerá. </para> + <para><action> Exibe o diálogo de configuração de verificação ortográfica.</action> Após você selecionar as opções desejadas clique <guibutton>OK</guibutton> e o diálogo normal de verificação ortográfica aparecerá. </para> </listitem> </varlistentry> <varlistentry> <term> - <menuchoice -><guimenu ->Ferramentas</guimenu -> <guimenuitem ->Ortografia</guimenuitem -> <guimenuitem ->Verificar Tudo...</guimenuitem -> </menuchoice> + <menuchoice><guimenu>Ferramentas</guimenu> <guimenuitem>Ortografia</guimenuitem> <guimenuitem>Verificar Tudo...</guimenuitem> </menuchoice> </term> <listitem> - <para -><action -> Inicia a verificação ortográfica de todas as palavras</action -> do arquivo <acronym ->PO</acronym -> aberto. </para> + <para><action> Inicia a verificação ortográfica de todas as palavras</action> do arquivo <acronym>PO</acronym> aberto. </para> </listitem> </varlistentry> <varlistentry> <term> - <menuchoice -><guimenu ->Ferramentas</guimenu -> <guimenuitem ->Ortografia</guimenuitem -> <guimenuitem ->Verificar A Partir Da Posição do Cursor...</guimenuitem -> </menuchoice> + <menuchoice><guimenu>Ferramentas</guimenu> <guimenuitem>Ortografia</guimenuitem> <guimenuitem>Verificar A Partir Da Posição do Cursor...</guimenuitem> </menuchoice> </term> <listitem> <para> - <action ->Inicia a verificação ortográfica a partir da posição do cursor. </action> + <action>Inicia a verificação ortográfica a partir da posição do cursor. </action> </para> </listitem> </varlistentry> <varlistentry> <term> - <menuchoice -><guimenu ->Ferramentas</guimenu -> <guimenuitem ->Ortografia</guimenuitem -> <guimenuitem ->Verificar Atual...</guimenuitem -> </menuchoice> + <menuchoice><guimenu>Ferramentas</guimenu> <guimenuitem>Ortografia</guimenuitem> <guimenuitem>Verificar Atual...</guimenuitem> </menuchoice> </term> <listitem> - <para -><action -> Verifica a ortografia somente da entrada atual</action -> do arquivo <acronym ->PO</acronym ->. </para> + <para><action> Verifica a ortografia somente da entrada atual</action> do arquivo <acronym>PO</acronym>. </para> </listitem> </varlistentry> <varlistentry> <term> - <menuchoice -><guimenu ->Ferramentas</guimenu -> <guimenuitem ->Ortografia</guimenuitem -> <guimenuitem ->Verificar Texto Selecionado</guimenuitem -> </menuchoice> + <menuchoice><guimenu>Ferramentas</guimenu> <guimenuitem>Ortografia</guimenuitem> <guimenuitem>Verificar Texto Selecionado</guimenuitem> </menuchoice> </term> <listitem> <para> - <action ->Verifica somente o texto selecionado na caixa de edição do MsgStr. </action> + <action>Verifica somente o texto selecionado na caixa de edição do MsgStr. </action> </para> </listitem> </varlistentry> <varlistentry> <term> - <menuchoice -><shortcut -> <keycombo action="simul" -> &Ctrl;<keycap ->T</keycap -> </keycombo -> </shortcut -> <guimenu ->Ferramentas</guimenu -> <guimenuitem ->Validação</guimenuitem -> <guimenuitem ->Verificar Sintaxe</guimenuitem -> </menuchoice> + <menuchoice><shortcut> <keycombo action="simul"> &Ctrl;<keycap>T</keycap> </keycombo> </shortcut> <guimenu>Ferramentas</guimenu> <guimenuitem>Validação</guimenuitem> <guimenuitem>Verificar Sintaxe</guimenuitem> </menuchoice> </term> <listitem> - <para -><action -> Verifica a sintaxe</action -> do arquivo <acronym ->PO</acronym -> atual. Erros podem aparecer de um mesclagem <acronym ->CVS</acronym -> ou erros de usuário quando o processo de tradução é feito manualmente. </para> + <para><action> Verifica a sintaxe</action> do arquivo <acronym>PO</acronym> atual. Erros podem aparecer de um mesclagem <acronym>CVS</acronym> ou erros de usuário quando o processo de tradução é feito manualmente. </para> </listitem> </varlistentry> <varlistentry> <term> - <menuchoice -><shortcut -> <keycombo action="simul" -> &Ctrl;<keycap ->D</keycap -> </keycombo -> </shortcut -> <guimenu ->Ferramentas</guimenu -> <guimenuitem ->Validação</guimenuitem -> <guimenuitem ->Verificar Argumentos</guimenuitem -> </menuchoice> + <menuchoice><shortcut> <keycombo action="simul"> &Ctrl;<keycap>D</keycap> </keycombo> </shortcut> <guimenu>Ferramentas</guimenu> <guimenuitem>Validação</guimenuitem> <guimenuitem>Verificar Argumentos</guimenuitem> </menuchoice> </term> <listitem> <para> - <action ->Quando esta opção é selecionada, strings no formato C no texto original e na tradução são verificados para certificar que o número de seqüências de formatação e a ordem estão consistentes. </action> + <action>Quando esta opção é selecionada, strings no formato C no texto original e na tradução são verificados para certificar que o número de seqüências de formatação e a ordem estão consistentes. </action> </para> </listitem> </varlistentry> <varlistentry> <term> - <menuchoice -><shortcut -> <keycombo action="simul" -> &Ctrl;<keycap ->H</keycap -> </keycombo -> </shortcut -> <guimenu ->Ferramentas</guimenu -> <guimenuitem ->Validação</guimenuitem -> <guimenuitem ->Verificar Aceleradores</guimenuitem -> </menuchoice> + <menuchoice><shortcut> <keycombo action="simul"> &Ctrl;<keycap>H</keycap> </keycombo> </shortcut> <guimenu>Ferramentas</guimenu> <guimenuitem>Validação</guimenuitem> <guimenuitem>Verificar Aceleradores</guimenuitem> </menuchoice> </term> <listitem> - <para ->Quando esta opção é selecionada o &kbabel; <action ->verifica se o número de caracteres aceleradores é idêntico tanto na mensagem original como na traduzida.</action -> Observe que a marca de acelerador é o & no &kde; (mas não em todos os kits de ferramentas de programação). Veja a seção <link linkend="preferences-project-miscellaneous" ->Diversos</link -> abaixo para descobrir como mudar o acelerador de teclado. </para> + <para>Quando esta opção é selecionada o &kbabel; <action>verifica se o número de caracteres aceleradores é idêntico tanto na mensagem original como na traduzida.</action> Observe que a marca de acelerador é o & no &kde; (mas não em todos os kits de ferramentas de programação). Veja a seção <link linkend="preferences-project-miscellaneous">Diversos</link> abaixo para descobrir como mudar o acelerador de teclado. </para> </listitem> </varlistentry> <varlistentry> <term> - <menuchoice -><shortcut -> <keycombo action="simul" -> &Ctrl;<keycap ->K</keycap -> </keycombo -> </shortcut -> <guimenu ->Ferramentas</guimenu -> <guimenuitem ->Validação</guimenuitem -> <guimenuitem ->Procurar por Informações de Contexto Traduzidas</guimenuitem -> </menuchoice> + <menuchoice><shortcut> <keycombo action="simul"> &Ctrl;<keycap>K</keycap> </keycombo> </shortcut> <guimenu>Ferramentas</guimenu> <guimenuitem>Validação</guimenuitem> <guimenuitem>Procurar por Informações de Contexto Traduzidas</guimenuitem> </menuchoice> </term> <listitem> - <para ->Algumas mensagens são marcadas com informações de contexto para marcá-las como sendo únicas se elas representam a mesma palavra. Isto é porque muitas palavras simples, como <quote ->Salvar</quote ->, são traduzidas em muitos idiomas. Informação de contexto é marcada com <literal ->_:</literal ->. Muitos tradutores inexperientes traduzem a informação de contexto e preenchem os seus arquivos <quote ->PO</quote -> com lixo. <action ->Habilite esta caixa para certificar-se que você será avisado sobre estes erros num arquivo.</action -> </para> + <para>Algumas mensagens são marcadas com informações de contexto para marcá-las como sendo únicas se elas representam a mesma palavra. Isto é porque muitas palavras simples, como <quote>Salvar</quote>, são traduzidas em muitos idiomas. Informação de contexto é marcada com <literal>_:</literal>. Muitos tradutores inexperientes traduzem a informação de contexto e preenchem os seus arquivos <quote>PO</quote> com lixo. <action>Habilite esta caixa para certificar-se que você será avisado sobre estes erros num arquivo.</action> </para> </listitem> </varlistentry> <varlistentry> <term> - <menuchoice -><guimenu ->Ferramental</guimenu -> <guimenuitem ->Validação</guimenuitem -> <guimenuitem ->Verificar Formas Plurais (somente KDE)</guimenuitem -> </menuchoice> + <menuchoice><guimenu>Ferramental</guimenu> <guimenuitem>Validação</guimenuitem> <guimenuitem>Verificar Formas Plurais (somente KDE)</guimenuitem> </menuchoice> </term> <listitem> - <para ->Verifica se o arquivo <acronym ->PO</acronym -> <action ->contém o número correto de traduções</action -> para cada mensagem no plural específica do &kde;. </para> + <para>Verifica se o arquivo <acronym>PO</acronym> <action>contém o número correto de traduções</action> para cada mensagem no plural específica do &kde;. </para> </listitem> </varlistentry> <varlistentry> <term> - <menuchoice -><shortcut -> <keycombo action="simul" -> &Ctrl;<keycap ->J</keycap -> </keycombo -> </shortcut -> <guimenu ->Ferramentas</guimenu -> <guimenuitem ->Validação</guimenuitem -> <guimenuitem ->Verificar Equações</guimenuitem -> </menuchoice> + <menuchoice><shortcut> <keycombo action="simul"> &Ctrl;<keycap>J</keycap> </keycombo> </shortcut> <guimenu>Ferramentas</guimenu> <guimenuitem>Validação</guimenuitem> <guimenuitem>Verificar Equações</guimenuitem> </menuchoice> </term> <listitem> <para> - <action ->Verifica se o lado esquerdo de um string traduzido corresponde ao lado esquerdo do string original. Lados são delimitados pelo caracter do sinal de igualdade. </action> + <action>Verifica se o lado esquerdo de um string traduzido corresponde ao lado esquerdo do string original. Lados são delimitados pelo caracter do sinal de igualdade. </action> </para> </listitem> </varlistentry> <varlistentry> <term> - <menuchoice -><shortcut -> <keycombo -> <keycap ->F5</keycap -> </keycombo -> </shortcut -> <guimenu ->Ferramentas</guimenu -> <guimenuitem ->Diferenças</guimenuitem -> <guimenuitem ->Mostrar Diferenças</guimenuitem -> </menuchoice> + <menuchoice><shortcut> <keycombo> <keycap>F5</keycap> </keycombo> </shortcut> <guimenu>Ferramentas</guimenu> <guimenuitem>Diferenças</guimenuitem> <guimenuitem>Mostrar Diferenças</guimenuitem> </menuchoice> </term> <listitem> <para> - <action ->Mostra as diferenças encontradas para a mensagem original traduzida. </action> + <action>Mostra as diferenças encontradas para a mensagem original traduzida. </action> </para> </listitem> </varlistentry> <varlistentry> <term> - <menuchoice -><shortcut -> <keycombo -> <keycap ->F6</keycap -> </keycombo -> </shortcut -> <guimenu ->Ferramentas</guimenu -> <guimenuitem ->Diferenças</guimenuitem -> <guimenuitem ->Mostrar Texto Original</guimenuitem -> </menuchoice> + <menuchoice><shortcut> <keycombo> <keycap>F6</keycap> </keycombo> </shortcut> <guimenu>Ferramentas</guimenu> <guimenuitem>Diferenças</guimenuitem> <guimenuitem>Mostrar Texto Original</guimenuitem> </menuchoice> </term> <listitem> <para> - <action ->Oculta marcas de diferença e mostra somente a msgid. </action> + <action>Oculta marcas de diferença e mostra somente a msgid. </action> </para> </listitem> </varlistentry> <varlistentry> <term> - <menuchoice -><guimenu ->Ferramentas</guimenu -> <guimenuitem ->Diferenças</guimenuitem -> <guimenuitem ->Abrir Arquivo para Diferenciar</guimenuitem -> </menuchoice> + <menuchoice><guimenu>Ferramentas</guimenu> <guimenuitem>Diferenças</guimenuitem> <guimenuitem>Abrir Arquivo para Diferenciar</guimenuitem> </menuchoice> </term> <listitem> <para> - <action ->Abre o arquivo a ser usado para diferenciar a aparência. </action> + <action>Abre o arquivo a ser usado para diferenciar a aparência. </action> </para> </listitem> </varlistentry> <varlistentry> <term> - <menuchoice -><guimenu ->Ferramentas</guimenu -> <guimenuitem ->Diferenças</guimenuitem -> <guimenuitem ->Modo Diferenças</guimenuitem -> </menuchoice> + <menuchoice><guimenu>Ferramentas</guimenu> <guimenuitem>Diferenças</guimenuitem> <guimenuitem>Modo Diferenças</guimenuitem> </menuchoice> </term> <listitem> <para> - <action ->Alterna modo de diferenças. </action> + <action>Alterna modo de diferenças. </action> </para> </listitem> </varlistentry> <varlistentry> <term> - <menuchoice -><guimenu ->Ferramentas</guimenu -> <guimenuitem ->Tradução Aproximada...</guimenuitem -> </menuchoice> + <menuchoice><guimenu>Ferramentas</guimenu> <guimenuitem>Tradução Aproximada...</guimenuitem> </menuchoice> </term> <listitem> <para> - <action ->Invoca o diálogo de tradução aproximada para tradução automática. </action> + <action>Invoca o diálogo de tradução aproximada para tradução automática. </action> </para> </listitem> </varlistentry> <varlistentry> <term> - <menuchoice -><guimenu ->Ferramentas</guimenu -> <guimenuitem ->Gerenciador de Catálogos...</guimenuitem -> </menuchoice> + <menuchoice><guimenu>Ferramentas</guimenu> <guimenuitem>Gerenciador de Catálogos...</guimenuitem> </menuchoice> </term> <listitem> - <para ->Abre o &catalogmanager;. Leia a seção <link linkend="using-catalogmanager" ->&catalogmanager;</link -> para maiores detalhes. </para> + <para>Abre o &catalogmanager;. Leia a seção <link linkend="using-catalogmanager">&catalogmanager;</link> para maiores detalhes. </para> </listitem> </varlistentry> </variablelist> </sect2> <sect2> -<title ->O Menu Configurações</title> +<title>O Menu Configurações</title> <variablelist> <varlistentry> <term> - <menuchoice -><guimenu ->Configurações</guimenu -> <guimenuitem ->Mostrar Barra de Ferramentas</guimenuitem -> </menuchoice> + <menuchoice><guimenu>Configurações</guimenu> <guimenuitem>Mostrar Barra de Ferramentas</guimenuitem> </menuchoice> </term> <listitem> <para> - <action ->Quando habilitado, a barra de ferramentas padrão é exibida. </action> + <action>Quando habilitado, a barra de ferramentas padrão é exibida. </action> </para> </listitem> </varlistentry> <varlistentry> <term> - <menuchoice -><guimenu ->Configurações</guimenu -> <guimenuitem ->Mostrar Barra de Estado</guimenuitem -> </menuchoice> + <menuchoice><guimenu>Configurações</guimenu> <guimenuitem>Mostrar Barra de Estado</guimenuitem> </menuchoice> </term> <listitem> <para> - <action ->Quando habilitado, a barra de estado inferior é exibida. </action> + <action>Quando habilitado, a barra de estado inferior é exibida. </action> </para> </listitem> </varlistentry> <varlistentry> <term> - <menuchoice -><guimenu ->Configurações</guimenu -> <guimenuitem ->Mostrar Barra de Navegação</guimenuitem -> </menuchoice> + <menuchoice><guimenu>Configurações</guimenu> <guimenuitem>Mostrar Barra de Navegação</guimenuitem> </menuchoice> </term> <listitem> <para> - <action ->Quando habilitado, a barra de navegação é exibida. </action> + <action>Quando habilitado, a barra de navegação é exibida. </action> </para> </listitem> </varlistentry> <varlistentry> <term> - <menuchoice -><guimenu ->Configurações</guimenu -> <guimenuitem ->Mostrar Comentários</guimenuitem -> </menuchoice> + <menuchoice><guimenu>Configurações</guimenu> <guimenuitem>Mostrar Comentários</guimenuitem> </menuchoice> </term> <listitem> <para> - <action ->Quando habilitado, a parte superior direita da janela principal que contém os comentários da entrada atual será exibida. </action> + <action>Quando habilitado, a parte superior direita da janela principal que contém os comentários da entrada atual será exibida. </action> </para> </listitem> </varlistentry> <varlistentry> <term> - <menuchoice -><guimenu ->Configurações</guimenu -> <guimenuitem ->Mostrar Ferramentas</guimenuitem -> </menuchoice> + <menuchoice><guimenu>Configurações</guimenu> <guimenuitem>Mostrar Ferramentas</guimenuitem> </menuchoice> </term> <listitem> <para> - <action ->Quando habilitado, a parte inferior direita da janela principal que contém os resultados procurados no dicionário será exibida. </action> + <action>Quando habilitado, a parte inferior direita da janela principal que contém os resultados procurados no dicionário será exibida. </action> </para> </listitem> </varlistentry> <varlistentry> <term> - <menuchoice -><guimenu ->Configurações</guimenu -> <guimenuitem ->Configurar Atalhos...</guimenuitem -> </menuchoice> + <menuchoice><guimenu>Configurações</guimenu> <guimenuitem>Configurar Atalhos...</guimenuitem> </menuchoice> </term> <listitem> <para> - <action ->Abre o diálogo de configuração para atalhos de teclado. Isto lhe permitirá personalizar atalhos padrão para atender suas necessidades. </action> + <action>Abre o diálogo de configuração para atalhos de teclado. Isto lhe permitirá personalizar atalhos padrão para atender suas necessidades. </action> </para> </listitem> </varlistentry> <varlistentry> <term> - <menuchoice -><guimenu ->Configurações</guimenu -> <guimenuitem ->Configurar Barras de Ferramentas...</guimenuitem -> </menuchoice> + <menuchoice><guimenu>Configurações</guimenu> <guimenuitem>Configurar Barras de Ferramentas...</guimenuitem> </menuchoice> </term> <listitem> <para> - <action ->O diálogo padrão de configuração de barras de ferramentas será aberto. Você pode escolher que ações poderão ser executadas a partir das barras de ferramentas e quais barras de ferramentas você irá personalizar. </action> + <action>O diálogo padrão de configuração de barras de ferramentas será aberto. Você pode escolher que ações poderão ser executadas a partir das barras de ferramentas e quais barras de ferramentas você irá personalizar. </action> </para> </listitem> </varlistentry> <varlistentry> <term> - <menuchoice -><guimenu ->Configurações</guimenu -> <guimenuitem ->Configurar Kbabel...</guimenuitem -> </menuchoice> + <menuchoice><guimenu>Configurações</guimenu> <guimenuitem>Configurar Kbabel...</guimenuitem> </menuchoice> </term> <listitem> - <para ->Todas as configurações específicas do &kbabel; estão aqui. Por favor leia a seção <link linkend="preferences-global" ->Configurações Globais do &kbabel;</link -> para tópicos específicos. </para> + <para>Todas as configurações específicas do &kbabel; estão aqui. Por favor leia a seção <link linkend="preferences-global">Configurações Globais do &kbabel;</link> para tópicos específicos. </para> </listitem> </varlistentry> <varlistentry> <term> - <menuchoice -><guimenu ->Configurações</guimenu -> <guimenuitem ->Configurar Dicionário</guimenuitem -> <guimenuitem ->Mecanismo de Busca de Banco de Dados do KDE</guimenuitem -> </menuchoice> + <menuchoice><guimenu>Configurações</guimenu> <guimenuitem>Configurar Dicionário</guimenuitem> <guimenuitem>Mecanismo de Busca de Banco de Dados do KDE</guimenuitem> </menuchoice> </term> <listitem> - <para ->Abre diálogo para configuração do Mecanismo de Busca de Banco de Dados do &kde;. </para> + <para>Abre diálogo para configuração do Mecanismo de Busca de Banco de Dados do &kde;. </para> </listitem> </varlistentry> <varlistentry> <term> - <menuchoice -><guimenu ->Configurações</guimenu -> <guimenuitem ->Configurar Dicionário</guimenuitem -> <guimenuitem ->PO Auxiliar</guimenuitem -> </menuchoice> + <menuchoice><guimenu>Configurações</guimenu> <guimenuitem>Configurar Dicionário</guimenuitem> <guimenuitem>PO Auxiliar</guimenuitem> </menuchoice> </term> <listitem> - <para -><action -> Abre diálogo</action -> para configuração do arquivo <acronym ->PO</acronym -> auxiliar. </para> + <para><action> Abre diálogo</action> para configuração do arquivo <acronym>PO</acronym> auxiliar. </para> </listitem> </varlistentry> <varlistentry> <term> - <menuchoice -><guimenu ->Configurações</guimenu -> <guimenuitem ->Configurar Dicionário</guimenuitem -> <guimenuitem ->Compêndio PO</guimenuitem -> </menuchoice> + <menuchoice><guimenu>Configurações</guimenu> <guimenuitem>Configurar Dicionário</guimenuitem> <guimenuitem>Compêndio PO</guimenuitem> </menuchoice> </term> <listitem> - <para -><action -> Abre diálogo</action -> para configuração do arquivo de compêndio <acronym ->PO</acronym ->. </para> + <para><action> Abre diálogo</action> para configuração do arquivo de compêndio <acronym>PO</acronym>. </para> </listitem> </varlistentry> </variablelist> </sect2> <sect2> -<title ->O Menu Ajuda</title> +<title>O Menu Ajuda</title> <variablelist> <varlistentry> <term> - <menuchoice -><shortcut -> <keycap ->F1</keycap -> </shortcut -> <guimenu ->Ajuda</guimenu -> <guimenuitem ->Conteúdo</guimenuitem -> </menuchoice> + <menuchoice><shortcut> <keycap>F1</keycap> </shortcut> <guimenu>Ajuda</guimenu> <guimenuitem>Conteúdo</guimenuitem> </menuchoice> </term> <listitem> - <para ->Abre o manual do &kbabel;. Isto é o que você está lendo agora. </para> + <para>Abre o manual do &kbabel;. Isto é o que você está lendo agora. </para> </listitem> </varlistentry> <varlistentry> <term> - <menuchoice -><shortcut -> <keycombo -> &Shift;<keycap ->F1</keycap -> </keycombo -> </shortcut -> <guimenu ->Ajuda</guimenu -> <guimenuitem ->O que é isto?</guimenuitem -> </menuchoice> + <menuchoice><shortcut> <keycombo> &Shift;<keycap>F1</keycap> </keycombo> </shortcut> <guimenu>Ajuda</guimenu> <guimenuitem>O que é isto?</guimenuitem> </menuchoice> </term> <listitem> <para> - <action ->O cursor muda para uma seta com um ponto de interrogação e você pode clicar com ele em vários elementos da janela principal. Uma ajuda rápida será aberta. </action> + <action>O cursor muda para uma seta com um ponto de interrogação e você pode clicar com ele em vários elementos da janela principal. Uma ajuda rápida será aberta. </action> </para> </listitem> </varlistentry> <varlistentry> <term> - <menuchoice -><guimenu ->Ajuda</guimenu -> <guimenuitem ->Informações do Gettext</guimenuitem -> </menuchoice> + <menuchoice><guimenu>Ajuda</guimenu> <guimenuitem>Informações do Gettext</guimenuitem> </menuchoice> </term> <listitem> - <para -><action -> Abre a página do manual do gettext</action -> no Centro de Ajuda do &kde;. Este pacote de ferramentas auxilia no processo de manipulação de arquivos <acronym ->POT</acronym -> e <acronym ->PO</acronym ->. </para> + <para><action> Abre a página do manual do gettext</action> no Centro de Ajuda do &kde;. Este pacote de ferramentas auxilia no processo de manipulação de arquivos <acronym>POT</acronym> e <acronym>PO</acronym>. </para> </listitem> </varlistentry> <varlistentry> <term> - <menuchoice -><guimenu ->Ajuda</guimenu -> <guimenuitem ->Relatar Erro...</guimenuitem -> </menuchoice> + <menuchoice><guimenu>Ajuda</guimenu> <guimenuitem>Relatar Erro...</guimenuitem> </menuchoice> </term> <listitem> - <para -><action -> Isto abrirá um diálogo padrão de relatório de erro</action -> para o &kde; útil se você observou um comportamento anormal do &kbabel;. Os desenvolvedores do &kbabel; ficarão gratos por receber qualquer comentário, sugestões e relatórios de erro. </para> + <para><action> Isto abrirá um diálogo padrão de relatório de erro</action> para o &kde; útil se você observou um comportamento anormal do &kbabel;. Os desenvolvedores do &kbabel; ficarão gratos por receber qualquer comentário, sugestões e relatórios de erro. </para> </listitem> </varlistentry> <varlistentry> <term> - <menuchoice -><guimenu ->Ajuda</guimenu -> <guimenuitem ->Sobre o KBabel...</guimenuitem -> </menuchoice> + <menuchoice><guimenu>Ajuda</guimenu> <guimenuitem>Sobre o KBabel...</guimenuitem> </menuchoice> </term> <listitem> - <para ->Abre uma caixa de mensagem que lhe informa sobre a versão do &kbabel;, o nome do desenvolvedor e o endereço de e-mail. </para> + <para>Abre uma caixa de mensagem que lhe informa sobre a versão do &kbabel;, o nome do desenvolvedor e o endereço de e-mail. </para> </listitem> </varlistentry> <varlistentry> <term> - <menuchoice -><guimenu ->Ajuda</guimenu -> <guimenuitem ->Sobre o KDE...</guimenuitem -> </menuchoice> + <menuchoice><guimenu>Ajuda</guimenu> <guimenuitem>Sobre o KDE...</guimenuitem> </menuchoice> </term> <listitem> - <para ->Abre uma caixa de mensagem que lhe informa sobre o projeto &kde;, informações de contato e como você pode relatar erros e sugestões. </para> + <para>Abre uma caixa de mensagem que lhe informa sobre o projeto &kde;, informações de contato e como você pode relatar erros e sugestões. </para> </listitem> </varlistentry> <varlistentry> <term> - <menuchoice -><guimenu ->Ajuda</guimenu -> <guimenuitem ->Sobre o Dicionário</guimenuitem -> <guimenuitem ->Mecanismo de Procura de Banco de Dados do KDE</guimenuitem -> </menuchoice> + <menuchoice><guimenu>Ajuda</guimenu> <guimenuitem>Sobre o Dicionário</guimenuitem> <guimenuitem>Mecanismo de Procura de Banco de Dados do KDE</guimenuitem> </menuchoice> </term> <listitem> - <para ->Mostra uma caixa de mensagem com informações sobre as pessoas que fizeram o Mecanismo de Busca de Banco de Dados do &kde;. </para> + <para>Mostra uma caixa de mensagem com informações sobre as pessoas que fizeram o Mecanismo de Busca de Banco de Dados do &kde;. </para> </listitem> </varlistentry> <varlistentry> <term> - <menuchoice -><guimenu ->Ajuda</guimenu -> <guimenuitem ->Sobre o Dicionário</guimenuitem -> <guimenuitem ->PO Auxiliar</guimenuitem -> </menuchoice> + <menuchoice><guimenu>Ajuda</guimenu> <guimenuitem>Sobre o Dicionário</guimenuitem> <guimenuitem>PO Auxiliar</guimenuitem> </menuchoice> </term> <listitem> <para> - <action ->Mostra uma caixa de mensagem com informações sobre as pessoas que tornaram a busca em arquivo auxiliar possível. </action> + <action>Mostra uma caixa de mensagem com informações sobre as pessoas que tornaram a busca em arquivo auxiliar possível. </action> </para> </listitem> </varlistentry> <varlistentry> <term> - <menuchoice -><guimenu ->Ajuda</guimenu -> <guimenuitem ->Sobre o Dicionário</guimenuitem -> <guimenuitem ->Compêndio PO</guimenuitem -> </menuchoice> + <menuchoice><guimenu>Ajuda</guimenu> <guimenuitem>Sobre o Dicionário</guimenuitem> <guimenuitem>Compêndio PO</guimenuitem> </menuchoice> </term> <listitem> <para> - <action ->Mostra uma caixa de mensagem com informações sobre as pessoas que tornaram a busca em arquivo compêndio possível. </action> + <action>Mostra uma caixa de mensagem com informações sobre as pessoas que tornaram a busca em arquivo compêndio possível. </action> </para> </listitem> </varlistentry> @@ -1762,12 +869,10 @@ </sect1> <sect1 id="kbabel-toolbars"> -<title ->As barras de ferramentas do &kbabel;</title> +<title>As barras de ferramentas do &kbabel;</title> <sect2 id="standard-toolbar"> -<title ->Barra de Ferramentas Padrão</title> +<title>Barra de Ferramentas Padrão</title> <variablelist> <varlistentry> <term> @@ -1775,13 +880,9 @@ <imageobject> <imagedata fileref="fileopen.png" format="PNG"/> </imageobject> -</inlinemediaobject -> Abrir </term> +</inlinemediaobject> Abrir </term> <listitem> - <para ->Carregar um arquivo <acronym ->PO</acronym -> no &kbabel; para edição.</para> + <para>Carregar um arquivo <acronym>PO</acronym> no &kbabel; para edição.</para> </listitem> </varlistentry> <varlistentry> @@ -1790,13 +891,9 @@ <imageobject> <imagedata fileref="filesave.png" format="PNG"/> </imageobject> -</inlinemediaobject -> Salvar </term> +</inlinemediaobject> Salvar </term> <listitem> - <para ->Salva o arquivo <acronym ->PO</acronym -> atual se ele foi modificado.</para> + <para>Salva o arquivo <acronym>PO</acronym> atual se ele foi modificado.</para> </listitem> </varlistentry> <varlistentry> @@ -1805,11 +902,9 @@ <imageobject> <imagedata fileref="undo.png" format="PNG"/> </imageobject> -</inlinemediaobject -> Desfazer </term> +</inlinemediaobject> Desfazer </term> <listitem> - <para ->Desfaz a última operação.</para> + <para>Desfaz a última operação.</para> </listitem> </varlistentry> <varlistentry> @@ -1818,11 +913,9 @@ <imageobject> <imagedata fileref="redo.png" format="PNG"/> </imageobject> -</inlinemediaobject -> Refazer </term> +</inlinemediaobject> Refazer </term> <listitem> - <para ->Refaz a última operação.</para> + <para>Refaz a última operação.</para> </listitem> </varlistentry> <varlistentry> @@ -1831,11 +924,9 @@ <imageobject> <imagedata fileref="editcut.png" format="PNG"/> </imageobject> -</inlinemediaobject -> Cortar </term> +</inlinemediaobject> Cortar </term> <listitem> - <para ->Corta o texto selecionado e move-o para a área de transferência.</para> + <para>Corta o texto selecionado e move-o para a área de transferência.</para> </listitem> </varlistentry> <varlistentry> @@ -1844,11 +935,9 @@ <imageobject> <imagedata fileref="editcopy.png" format="PNG"/> </imageobject> -</inlinemediaobject -> Copiar </term> +</inlinemediaobject> Copiar </term> <listitem> - <para ->Copia o texto selecionado para a área de transferência.</para> + <para>Copia o texto selecionado para a área de transferência.</para> </listitem> </varlistentry> <varlistentry> @@ -1857,11 +946,9 @@ <imageobject> <imagedata fileref="editpaste.png" format="PNG"/> </imageobject> -</inlinemediaobject -> Colar </term> +</inlinemediaobject> Colar </term> <listitem> - <para ->Cola o texto da área de transferência na posição atual do cursor.</para> + <para>Cola o texto da área de transferência na posição atual do cursor.</para> </listitem> </varlistentry> <varlistentry> @@ -1870,11 +957,9 @@ <imageobject> <imagedata fileref="find.png" format="PNG"/> </imageobject> -</inlinemediaobject -> Procurar </term> +</inlinemediaobject> Procurar </term> <listitem> - <para ->Procura um string especificado no arquivo PO atual.</para> + <para>Procura um string especificado no arquivo PO atual.</para> </listitem> </varlistentry> <varlistentry> @@ -1883,11 +968,9 @@ <imageobject> <imagedata fileref="previous.png" format="PNG"/> </imageobject> -</inlinemediaobject -> Anterior </term> +</inlinemediaobject> Anterior </term> <listitem> - <para ->Pula para a entrada anterior no arquivo PO.</para> + <para>Pula para a entrada anterior no arquivo PO.</para> </listitem> </varlistentry> <varlistentry> @@ -1896,13 +979,9 @@ <imageobject> <imagedata fileref="next.png" format="PNG"/> </imageobject> -</inlinemediaobject -> Próxima </term> +</inlinemediaobject> Próxima </term> <listitem> - <para ->Pula para a próxima entrada no arquivo <acronym ->PO</acronym ->.</para> + <para>Pula para a próxima entrada no arquivo <acronym>PO</acronym>.</para> </listitem> </varlistentry> <varlistentry> @@ -1911,15 +990,9 @@ <imageobject> <imagedata fileref="msgid2msgstr.png" format="PNG"/> </imageobject> -</inlinemediaobject -> Copiar <acronym ->msgid</acronym -> para <acronym ->msgstr</acronym -> </term> +</inlinemediaobject> Copiar <acronym>msgid</acronym> para <acronym>msgstr</acronym> </term> <listitem> - <para ->Copia o string original para a caixa de edição do string traduzido.</para> + <para>Copia o string original para a caixa de edição do string traduzido.</para> </listitem> </varlistentry> <varlistentry> @@ -1928,15 +1001,9 @@ <imageobject> <imagedata fileref="transsearch.png" format="PNG"/> </imageobject> -</inlinemediaobject -> Procurar Traduções </term> +</inlinemediaobject> Procurar Traduções </term> <listitem> - <para ->Caixa combinada da barra de ferramentas para procurar o texto selecionado usando: Mecanismo de Busca de Bando de Dados do &kde;, arquivo <acronym ->PO</acronym -> auxiliar, compêndio <acronym ->PO</acronym -> e outros plugins de dicionário se disponíveis.</para> + <para>Caixa combinada da barra de ferramentas para procurar o texto selecionado usando: Mecanismo de Busca de Bando de Dados do &kde;, arquivo <acronym>PO</acronym> auxiliar, compêndio <acronym>PO</acronym> e outros plugins de dicionário se disponíveis.</para> </listitem> </varlistentry> <varlistentry> @@ -1945,11 +1012,9 @@ <imageobject> <imagedata fileref="stop.png" format="PNG"/> </imageobject> -</inlinemediaobject -> Parar </term> +</inlinemediaobject> Parar </term> <listitem> - <para ->Para a busca atual em progresso.</para> + <para>Para a busca atual em progresso.</para> </listitem> </varlistentry> <varlistentry> @@ -1958,19 +1023,16 @@ <imageobject> <imagedata fileref="catalogmanager.png" format="PNG"/> </imageobject> -</inlinemediaobject -> Gerenciador de Catálogo </term> +</inlinemediaobject> Gerenciador de Catálogo </term> <listitem> - <para ->Abre a janela do Gerenciador de Catálogo.</para> + <para>Abre a janela do Gerenciador de Catálogo.</para> </listitem> </varlistentry> </variablelist> </sect2> <sect2 id="navigation-toolbar"> -<title ->Barra de Ferramentas de Navegação</title> +<title>Barra de Ferramentas de Navegação</title> <variablelist> <varlistentry> <term> @@ -1978,13 +1040,9 @@ <imageobject> <imagedata fileref="previous.png" format="PNG"/> </imageobject> -</inlinemediaobject -> Anterior </term> +</inlinemediaobject> Anterior </term> <listitem> - <para ->Pula para a entrada anterior no arquivo <acronym ->PO</acronym ->.</para> + <para>Pula para a entrada anterior no arquivo <acronym>PO</acronym>.</para> </listitem> </varlistentry> <varlistentry> @@ -1993,13 +1051,9 @@ <imageobject> <imagedata fileref="next.png" format="PNG"/> </imageobject> -</inlinemediaobject -> Próxima </term> +</inlinemediaobject> Próxima </term> <listitem> - <para ->Pula para a próxima entrada no arquivo <acronym ->PO</acronym ->.</para> + <para>Pula para a próxima entrada no arquivo <acronym>PO</acronym>.</para> </listitem> </varlistentry> <varlistentry> @@ -2008,13 +1062,9 @@ <imageobject> <imagedata fileref="top.png" format="PNG"/> </imageobject> -</inlinemediaobject -> Primeira Entrada </term> +</inlinemediaobject> Primeira Entrada </term> <listitem> - <para ->Pula para a primeira entrada no arquivo <acronym ->PO</acronym ->.</para> + <para>Pula para a primeira entrada no arquivo <acronym>PO</acronym>.</para> </listitem> </varlistentry> <varlistentry> @@ -2023,13 +1073,9 @@ <imageobject> <imagedata fileref="bottom.png" format="PNG"/> </imageobject> -</inlinemediaobject -> Última Entrada </term> +</inlinemediaobject> Última Entrada </term> <listitem> - <para ->Pula para a última entrada no arquivo <acronym ->PO</acronym ->.</para> + <para>Pula para a última entrada no arquivo <acronym>PO</acronym>.</para> </listitem> </varlistentry> <varlistentry> @@ -2038,13 +1084,9 @@ <imageobject> <imagedata fileref="prevfuzzyuntrans.png" format="PNG"/> </imageobject> -</inlinemediaobject -> Aproximada ou não traduzida anterior </term> +</inlinemediaobject> Aproximada ou não traduzida anterior </term> <listitem> - <para ->Pula para a entrada aproximada ou não traduzida no arquivo <acronym ->PO</acronym ->.</para> + <para>Pula para a entrada aproximada ou não traduzida no arquivo <acronym>PO</acronym>.</para> </listitem> </varlistentry> <varlistentry> @@ -2053,13 +1095,9 @@ <imageobject> <imagedata fileref="nextfuzzyuntrans.png" format="PNG"/> </imageobject> -</inlinemediaobject -> Próxima aproximada ou não traduzida </term> +</inlinemediaobject> Próxima aproximada ou não traduzida </term> <listitem> - <para ->Pula para a próxima entrada aproximada ou não traduzida no arquivo <acronym ->PO</acronym ->.</para> + <para>Pula para a próxima entrada aproximada ou não traduzida no arquivo <acronym>PO</acronym>.</para> </listitem> </varlistentry> <varlistentry> @@ -2068,13 +1106,9 @@ <imageobject> <imagedata fileref="prevfuzzy.png" format="PNG"/> </imageobject> -</inlinemediaobject -> Aproximada anterior </term> +</inlinemediaobject> Aproximada anterior </term> <listitem> - <para ->Pula para a entrada aproximada anterior no arquivo <acronym ->PO</acronym ->.</para> + <para>Pula para a entrada aproximada anterior no arquivo <acronym>PO</acronym>.</para> </listitem> </varlistentry> <varlistentry> @@ -2083,13 +1117,9 @@ <imageobject> <imagedata fileref="nextfuzzy.png" format="PNG"/> </imageobject> -</inlinemediaobject -> Próxima aproximada </term> +</inlinemediaobject> Próxima aproximada </term> <listitem> - <para ->Pula para a próxima entrada aproximada no arquivo <acronym ->PO</acronym ->.</para> + <para>Pula para a próxima entrada aproximada no arquivo <acronym>PO</acronym>.</para> </listitem> </varlistentry> <varlistentry> @@ -2098,13 +1128,9 @@ <imageobject> <imagedata fileref="prevuntranslated.png" format="PNG"/> </imageobject> -</inlinemediaobject -> Não traduzida anterior </term> +</inlinemediaobject> Não traduzida anterior </term> <listitem> - <para ->Pula para a entrada não traduzida anterior no arquivo <acronym ->PO</acronym ->.</para> + <para>Pula para a entrada não traduzida anterior no arquivo <acronym>PO</acronym>.</para> </listitem> </varlistentry> <varlistentry> @@ -2113,13 +1139,9 @@ <imageobject> <imagedata fileref="nextuntranslated.png" format="PNG"/> </imageobject> -</inlinemediaobject -> Próxima não traduzida </term> +</inlinemediaobject> Próxima não traduzida </term> <listitem> - <para ->Pula para a próxima entrada não traduzida no arquivo <acronym ->PO</acronym ->.</para> + <para>Pula para a próxima entrada não traduzida no arquivo <acronym>PO</acronym>.</para> </listitem> </varlistentry> <varlistentry> @@ -2128,13 +1150,9 @@ <imageobject> <imagedata fileref="preverror.png" format="PNG"/> </imageobject> -</inlinemediaobject -> Erro anterior </term> +</inlinemediaobject> Erro anterior </term> <listitem> - <para ->Pula para o erro anterior no arquivo <acronym ->PO</acronym ->.</para> + <para>Pula para o erro anterior no arquivo <acronym>PO</acronym>.</para> </listitem> </varlistentry> <varlistentry> @@ -2143,13 +1161,9 @@ <imageobject> <imagedata fileref="nexterror.png" format="PNG"/> </imageobject> -</inlinemediaobject -> Próximo erro </term> +</inlinemediaobject> Próximo erro </term> <listitem> - <para ->Pula para o próximo erro no arquivo <acronym ->PO</acronym ->.</para> + <para>Pula para o próximo erro no arquivo <acronym>PO</acronym>.</para> </listitem> </varlistentry> <varlistentry> @@ -2158,13 +1172,9 @@ <imageobject> <imagedata fileref="back.png" format="PNG"/> </imageobject> -</inlinemediaobject -> Voltar </term> +</inlinemediaobject> Voltar </term> <listitem> - <para ->Pula para o última entrada visitada no arquivo <acronym ->PO</acronym ->.</para> + <para>Pula para o última entrada visitada no arquivo <acronym>PO</acronym>.</para> </listitem> </varlistentry> <varlistentry> @@ -2173,80 +1183,57 @@ <imageobject> <imagedata fileref="forward.png" format="PNG"/> </imageobject> -</inlinemediaobject -> Para frente </term> +</inlinemediaobject> Para frente </term> <listitem> - <para ->Pula para a entrada anteriormente visitada no arquivo <acronym ->PO</acronym ->.</para> + <para>Pula para a entrada anteriormente visitada no arquivo <acronym>PO</acronym>.</para> </listitem> </varlistentry> </variablelist> </sect2> <sect2 id="status-bar"> -<title ->Barra de Estado</title> +<title>Barra de Estado</title> <variablelist> <varlistentry> - <term ->Atual</term> + <term>Atual</term> <listitem> - <para ->Mensagem atual no arquivo <acronym ->PO</acronym -> editado.</para> + <para>Mensagem atual no arquivo <acronym>PO</acronym> editado.</para> </listitem> </varlistentry> <varlistentry> - <term ->Total</term> + <term>Total</term> <listitem> - <para ->Número total de mensagens no arquivo <acronym ->PO</acronym ->.</para> + <para>Número total de mensagens no arquivo <acronym>PO</acronym>.</para> </listitem> </varlistentry> <varlistentry> - <term ->Aproximada</term> + <term>Aproximada</term> <listitem> - <para ->Número de mensagens marcadas como aproximadas. Elas devem ser revisadas e traduzidas se necessário.</para> + <para>Número de mensagens marcadas como aproximadas. Elas devem ser revisadas e traduzidas se necessário.</para> </listitem> </varlistentry> <varlistentry> - <term ->Não traduzida</term> + <term>Não traduzida</term> <listitem> - <para ->Número de mensagens ainda não traduzidas.</para> + <para>Número de mensagens ainda não traduzidas.</para> </listitem> </varlistentry> <varlistentry> - <term ->Estado do Editor</term> + <term>Estado do Editor</term> <listitem> - <para ->INS - inserir, e OVR - overwrite (sobrescrever). Mesmo significado que qualquer outro editor de texto ordinário. </para> + <para>INS - inserir, e OVR - overwrite (sobrescrever). Mesmo significado que qualquer outro editor de texto ordinário. </para> </listitem> </varlistentry> <varlistentry> - <term ->Estado do arquivo PO</term> + <term>Estado do arquivo PO</term> <listitem> - <para ->RO - arquivo read-only (somente leitura), RW - acesso read-write (leitura-escrita) ao arquivo. Quando o arquivo está somente leitura você não pode modificar entradas no editor. </para> + <para>RO - arquivo read-only (somente leitura), RW - acesso read-write (leitura-escrita) ao arquivo. Quando o arquivo está somente leitura você não pode modificar entradas no editor. </para> </listitem> </varlistentry> <varlistentry> - <term ->Barra de progresso</term> + <term>Barra de progresso</term> <listitem> - <para ->Normalmente, esta barra é oculta. Ela é exibida somente quando um salvamento é feito ou você procura mensagens num arquivo PO, compêndio ou outra fonte. </para> + <para>Normalmente, esta barra é oculta. Ela é exibida somente quando um salvamento é feito ou você procura mensagens num arquivo PO, compêndio ou outra fonte. </para> </listitem> </varlistentry> </variablelist> @@ -2255,32 +1242,18 @@ </sect1> <sect1 id="catalogmanager-menu"> -<title ->O menu &catalogmanager;</title> +<title>O menu &catalogmanager;</title> <sect2> -<title ->O Menu Arquivo</title> +<title>O Menu Arquivo</title> <variablelist> <varlistentry> <term> - <menuchoice -><shortcut -> <keycombo action="simul" -> &Ctrl;<keycap ->Q</keycap -> </keycombo -> </shortcut -> <guimenu ->Arquivo</guimenu -> <guimenuitem ->Sair</guimenuitem -> </menuchoice> + <menuchoice><shortcut> <keycombo action="simul"> &Ctrl;<keycap>Q</keycap> </keycombo> </shortcut> <guimenu>Arquivo</guimenu> <guimenuitem>Sair</guimenuitem> </menuchoice> </term> <listitem> <para> - <action ->Sair do &catalogmanager;</action> + <action>Sair do &catalogmanager;</action> </para> </listitem> </varlistentry> @@ -2288,142 +1261,75 @@ </sect2> <sect2> -<title ->O Menu Editar</title> +<title>O Menu Editar</title> <variablelist> <varlistentry> <term> - <menuchoice -><shortcut -> <keycombo action="simul" -> &Ctrl;<keycap ->F</keycap -> </keycombo -> </shortcut -> <guimenu ->Editar</guimenu -> <guimenuitem ->Procurar nos Arquivos...</guimenuitem -> </menuchoice> + <menuchoice><shortcut> <keycombo action="simul"> &Ctrl;<keycap>F</keycap> </keycombo> </shortcut> <guimenu>Editar</guimenu> <guimenuitem>Procurar nos Arquivos...</guimenuitem> </menuchoice> </term> <listitem> <para> - <action ->Abre o diálogo de procura por strings num conjunto de arquivos PO. </action> + <action>Abre o diálogo de procura por strings num conjunto de arquivos PO. </action> </para> </listitem> </varlistentry> <varlistentry> <term> - <menuchoice -><shortcut -> <keycombo action="simul" -> &Ctrl;<keycap ->R</keycap -> </keycombo -> </shortcut -> <guimenu ->Editar</guimenu -> <guimenuitem ->Substituir nos Arquivos...</guimenuitem -> </menuchoice> + <menuchoice><shortcut> <keycombo action="simul"> &Ctrl;<keycap>R</keycap> </keycombo> </shortcut> <guimenu>Editar</guimenu> <guimenuitem>Substituir nos Arquivos...</guimenuitem> </menuchoice> </term> <listitem> <para> - <action ->Abre o diálogo de procura e substituição de strings num conjunto de arquivos PO. </action> + <action>Abre o diálogo de procura e substituição de strings num conjunto de arquivos PO. </action> </para> </listitem> </varlistentry> <varlistentry> <term> - <menuchoice -><shortcut -> <keycombo -> <keycap ->Escape</keycap -> </keycombo -> </shortcut -> <guimenu ->Editar</guimenu -> <guimenuitem ->Parar a Procura</guimenuitem -> </menuchoice> + <menuchoice><shortcut> <keycombo> <keycap>Escape</keycap> </keycombo> </shortcut> <guimenu>Editar</guimenu> <guimenuitem>Parar a Procura</guimenuitem> </menuchoice> </term> <listitem> <para> - <action ->Para a operação atual de procura/substituição. </action> + <action>Para a operação atual de procura/substituição. </action> </para> </listitem> </varlistentry> <varlistentry> <term> - <menuchoice -><shortcut -> <keycombo action="simul" -> &Ctrl;<keycap ->M</keycap -> </keycombo -> </shortcut -> <guimenu ->Editar</guimenu -> <guimenuitem ->Alternar Marcação</guimenuitem -> </menuchoice> + <menuchoice><shortcut> <keycombo action="simul"> &Ctrl;<keycap>M</keycap> </keycombo> </shortcut> <guimenu>Editar</guimenu> <guimenuitem>Alternar Marcação</guimenuitem> </menuchoice> </term> <listitem> <para> - <action ->Alterna marca para o arquivo selecionado. </action> + <action>Alterna marca para o arquivo selecionado. </action> </para> </listitem> </varlistentry> <varlistentry> <term> - <menuchoice -><guimenu ->Editar</guimenu -> <guimenuitem ->Remover Marcação</guimenuitem -> </menuchoice> + <menuchoice><guimenu>Editar</guimenu> <guimenuitem>Remover Marcação</guimenuitem> </menuchoice> </term> <listitem> <para> - <action ->Remove marcas para os arquivos ou pastas selecionados. </action> + <action>Remove marcas para os arquivos ou pastas selecionados. </action> </para> </listitem> </varlistentry> <varlistentry> <term> - <menuchoice -><guimenu ->Editar</guimenu -> <guimenuitem ->Alternar Todas Marcações</guimenuitem -> </menuchoice> + <menuchoice><guimenu>Editar</guimenu> <guimenuitem>Alternar Todas Marcações</guimenuitem> </menuchoice> </term> <listitem> <para> - <action ->Alterna marcas para o arquivo ou pasta selecionado (recursivamente). </action> + <action>Alterna marcas para o arquivo ou pasta selecionado (recursivamente). </action> </para> </listitem> </varlistentry> <varlistentry> <term> - <menuchoice -><guimenu ->Editar</guimenu -> <guimenuitem ->Remover Todas Marcações</guimenuitem -> </menuchoice> + <menuchoice><guimenu>Editar</guimenu> <guimenuitem>Remover Todas Marcações</guimenuitem> </menuchoice> </term> <listitem> <para> - <action ->Remove marcas para o arquivo ou pasta selecionado (recursivamente). </action> + <action>Remove marcas para o arquivo ou pasta selecionado (recursivamente). </action> </para> </listitem> </varlistentry> @@ -2431,50 +1337,25 @@ </sect2> <sect2> -<title ->O Menu Ferramentas</title> +<title>O Menu Ferramentas</title> <variablelist> <varlistentry> <term> - <menuchoice -><shortcut -> <keycombo action="simul" -> &Ctrl;<keycap ->S</keycap -> </keycombo -> </shortcut -> <guimenu ->Ferramentas</guimenu -> <guimenuitem ->Estatísticas</guimenuitem -> </menuchoice> + <menuchoice><shortcut> <keycombo action="simul"> &Ctrl;<keycap>S</keycap> </keycombo> </shortcut> <guimenu>Ferramentas</guimenu> <guimenuitem>Estatísticas</guimenuitem> </menuchoice> </term> <listitem> <para> - <action ->Mostra estatísticas sobre o número de mensagens traduzidas/não traduzidas/aproximadas para o arquivo selecionado ou sub-árvore. </action> + <action>Mostra estatísticas sobre o número de mensagens traduzidas/não traduzidas/aproximadas para o arquivo selecionado ou sub-árvore. </action> </para> </listitem> </varlistentry> <varlistentry> <term> - <menuchoice -><shortcut -> <keycombo action="simul" -> &Ctrl;<keycap ->Y</keycap -> </keycombo -> </shortcut -> <guimenu ->Ferramentas</guimenu -> <guimenuitem ->Verificar Sintaxe</guimenuitem -> </menuchoice> + <menuchoice><shortcut> <keycombo action="simul"> &Ctrl;<keycap>Y</keycap> </keycombo> </shortcut> <guimenu>Ferramentas</guimenu> <guimenuitem>Verificar Sintaxe</guimenuitem> </menuchoice> </term> <listitem> <para> - <action ->Verifica a sintaxe para o arquivo selecionado ou sub-árvore usando msgfmt. </action> + <action>Verifica a sintaxe para o arquivo selecionado ou sub-árvore usando msgfmt. </action> </para> </listitem> </varlistentry> @@ -2482,70 +1363,45 @@ </sect2> <sect2> -<title ->O Menu Configurações</title> +<title>O Menu Configurações</title> <variablelist> <varlistentry> <term> - <menuchoice -><guimenu ->Configurações</guimenu -> <guimenuitem ->Mostrar Barra de Ferramentas</guimenuitem -> </menuchoice> + <menuchoice><guimenu>Configurações</guimenu> <guimenuitem>Mostrar Barra de Ferramentas</guimenuitem> </menuchoice> </term> <listitem> <para> - <action ->Quando habilitado, a barra de ferramentas padrão é exibida. </action> + <action>Quando habilitado, a barra de ferramentas padrão é exibida. </action> </para> </listitem> </varlistentry> <varlistentry> <term> - <menuchoice -><guimenu ->Configurações</guimenu -> <guimenuitem ->Mostrar Barra de Estado</guimenuitem -> </menuchoice> + <menuchoice><guimenu>Configurações</guimenu> <guimenuitem>Mostrar Barra de Estado</guimenuitem> </menuchoice> </term> <listitem> <para> - <action ->Quando habilitado, a barra de estado inferior é exibida. </action> + <action>Quando habilitado, a barra de estado inferior é exibida. </action> </para> </listitem> </varlistentry> <varlistentry> <term> - <menuchoice -><guimenu ->Configurações</guimenu -> <guimenuitem ->Configurar Atalhos...</guimenuitem -> </menuchoice> + <menuchoice><guimenu>Configurações</guimenu> <guimenuitem>Configurar Atalhos...</guimenuitem> </menuchoice> </term> <listitem> <para> - <action ->Abre o diálogo de configuração para atalhos de teclado. Isto lhe permitirá personalizar atalhos padrão para atender suas necessidades. </action> + <action>Abre o diálogo de configuração para atalhos de teclado. Isto lhe permitirá personalizar atalhos padrão para atender suas necessidades. </action> </para> </listitem> </varlistentry> <varlistentry> <term> - <menuchoice -><guimenu ->Configurações</guimenu -> <guimenuitem ->Configurar Barras de Ferramentas...</guimenuitem -> </menuchoice> + <menuchoice><guimenu>Configurações</guimenu> <guimenuitem>Configurar Barras de Ferramentas...</guimenuitem> </menuchoice> </term> <listitem> <para> - <action ->O diálogo padrão de configuração de barras de ferramentas será aberto. Você pode escolher que ações poderão ser executadas a partir das barras de ferramentas e quais barras de ferramentas você irá personalizar. </action> + <action>O diálogo padrão de configuração de barras de ferramentas será aberto. Você pode escolher que ações poderão ser executadas a partir das barras de ferramentas e quais barras de ferramentas você irá personalizar. </action> </para> </listitem> </varlistentry> @@ -2553,12 +1409,10 @@ </sect2> <sect2> -<title ->O Menu Ajuda</title> +<title>O Menu Ajuda</title> &help.menu.documentation; </sect2> -</sect1 -></chapter> +</sect1></chapter> <!-- Local Variables: mode: xml diff --git a/tde-i18n-pt_BR/docs/tdesdk/kbabel/preferences.docbook b/tde-i18n-pt_BR/docs/tdesdk/kbabel/preferences.docbook index 3df9a7c2210..a830a78f347 100644 --- a/tde-i18n-pt_BR/docs/tdesdk/kbabel/preferences.docbook +++ b/tde-i18n-pt_BR/docs/tdesdk/kbabel/preferences.docbook @@ -1,6 +1,5 @@ <!-- <?xml version="1.0" ?> -<!DOCTYPE chapter PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" -> --> +<!DOCTYPE chapter PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd"> --> <!-- Uncomment the previous two lines to validate this document --> <!-- standalone. Be sure to recomment them before attempting to --> <!-- process index.docbook --> @@ -11,270 +10,121 @@ <!-- Fill in this section if this document has a different author --> <authorgroup> <author> -<personname -><firstname -></firstname -><surname -></surname -></personname> +<personname><firstname></firstname><surname></surname></personname> </author> </authorgroup> -<othercredit role="translator" -><firstname ->Marcus</firstname -><surname ->Gama</surname -><affiliation -><address -><email ->marcus.gama@gmail.com</email -></address -></affiliation -><contrib ->Tradução</contrib -></othercredit -> +<othercredit role="translator"><firstname>Marcus</firstname><surname>Gama</surname><affiliation><address><email>marcus.gama@gmail.com</email></address></affiliation><contrib>Tradução</contrib></othercredit> </chapterinfo> -<title ->Preferências</title> +<title>Preferências</title> <sect1 id="preferences-overview"> -<title ->Configurações globais e do projeto</title> +<title>Configurações globais e do projeto</title> -<para ->Desde o KBabel 1.10 (KDE 3.4), o KBabel passou a ter o conceito de projetos e, como tal, as configurações foram divididas em duas categorias: as configurações globais e as configurações do projeto. </para> +<para>Desde o KBabel 1.10 (KDE 3.4), o KBabel passou a ter o conceito de projetos e, como tal, as configurações foram divididas em duas categorias: as configurações globais e as configurações do projeto. </para> -<important -><para ->O 'gettext' da &GNU; usa um termo chamado "projeto", que não tem nada a ver com os projetos do KBabel. O 'gettext' da &GNU; entende como projeto uma aplicação relacionada com o arquivo <acronym ->PO</acronym ->. No caso do KBabel, um projeto é bem maior. Poderá significar um conjunto de aplicações, como o &kde;. </para -></important> +<important><para>O 'gettext' da &GNU; usa um termo chamado "projeto", que não tem nada a ver com os projetos do KBabel. O 'gettext' da &GNU; entende como projeto uma aplicação relacionada com o arquivo <acronym>PO</acronym>. No caso do KBabel, um projeto é bem maior. Poderá significar um conjunto de aplicações, como o &kde;. </para></important> -<para ->O KBabel tem <emphasis ->sempre</emphasis -> um projeto atual, mesmo que seja o projeto padrão. O KBabel não possui nenhum modo sem projeto. Um projeto funciona sempre para o editor e o gerenciador de catálogos do KBabel. </para> +<para>O KBabel tem <emphasis>sempre</emphasis> um projeto atual, mesmo que seja o projeto padrão. O KBabel não possui nenhum modo sem projeto. Um projeto funciona sempre para o editor e o gerenciador de catálogos do KBabel. </para> <sect2 id="preferences-limitations"> -<title ->Limitações conhecidas da implementação atual</title> +<title>Limitações conhecidas da implementação atual</title> -<para ->Infelizmente, a implementação atual dos projetos possui alguns problemas conhecidos. </para> +<para>Infelizmente, a implementação atual dos projetos possui alguns problemas conhecidos. </para> -<para ->Um exemplo é que, nas configurações globais, não há uma configuração para o usuário padrão, seu idioma padrão e outros dados importantes do usuário a nível global. Isso significa que esses dados terão de ser inseridos novamente, sempre que é criado um novo projeto. </para> +<para>Um exemplo é que, nas configurações globais, não há uma configuração para o usuário padrão, seu idioma padrão e outros dados importantes do usuário a nível global. Isso significa que esses dados terão de ser inseridos novamente, sempre que é criado um novo projeto. </para> -<para ->Outro problema é o assistente de novos projetos. Ele não solicita informações suficientes, especialmente no que diz respeito ao endereço de e-mail da equipe. Assim, recomenda-se que verifique a configuração do projeto após ter executado o assistente. </para> +<para>Outro problema é o assistente de novos projetos. Ele não solicita informações suficientes, especialmente no que diz respeito ao endereço de e-mail da equipe. Assim, recomenda-se que verifique a configuração do projeto após ter executado o assistente. </para> -<tip -><para ->Atualmente, você não pode copiar os projetos de dentro do KBabel, assim você não poderá compartilhar de forma simples as configurações adequadas. Contudo, você está livre para copiar o projeto fora do KBabel e carregar o projeto copiado para o KBabel. </para -></tip> +<tip><para>Atualmente, você não pode copiar os projetos de dentro do KBabel, assim você não poderá compartilhar de forma simples as configurações adequadas. Contudo, você está livre para copiar o projeto fora do KBabel e carregar o projeto copiado para o KBabel. </para></tip> </sect2> <sect2 id="preferences-non-kde-projects"> -<title ->Usando o KBabel em projetos não-&kde;</title> - -<para ->Embora a configuração padrão do &kbabel; esteja orientada para ser usada no &kde;, o &kbabel; pode ser usado para traduzir os arquivos <acronym ->PO</acronym -> de outros projetos. Contudo, você terá que ajustar a configuração de acordo com as necessidades do seu projeto. Isto é especialmente verdadeiro para os projetos da &GNU; e compatíveis com a &GNU;, que necessitam de opções bem diferentes das do &kde;. </para> - -<para ->Um problema é que o &kbabel; é relativamente agressivo ao salvar os arquivos <acronym ->PO</acronym -> e substitui a configuração dos arquivos <acronym ->PO</acronym -> por configurações dos projetos, se não for dito nada em contrário. Isto poderá ser altamente estranho para alguém que não esteja habituado ao &kde;. Contudo, o &kde; tem mais de 900 arquivos <acronym ->POT</acronym -> para traduzir, somente para as mensagens da <acronym ->GUI</acronym ->. Assim, para uma tarefa desse tipo, é desejável alguma automação. O tempo levado para configurar um projeto é bastante menor em comparação com o tempo que se ganha posteriormente. Obviamente, como não-usuário do &kde;, você poderá ter menos sorte. Terá que fazer mais configurações, uma vez que os padrões não são completamente adequados e não irá ganhar muito se fizer muitas traduções, uma vez que os projetos da &GNU; só possuem tipicamente um arquivo <acronym ->POT</acronym -> para traduzir. </para> +<title>Usando o KBabel em projetos não-&kde;</title> + +<para>Embora a configuração padrão do &kbabel; esteja orientada para ser usada no &kde;, o &kbabel; pode ser usado para traduzir os arquivos <acronym>PO</acronym> de outros projetos. Contudo, você terá que ajustar a configuração de acordo com as necessidades do seu projeto. Isto é especialmente verdadeiro para os projetos da &GNU; e compatíveis com a &GNU;, que necessitam de opções bem diferentes das do &kde;. </para> + +<para>Um problema é que o &kbabel; é relativamente agressivo ao salvar os arquivos <acronym>PO</acronym> e substitui a configuração dos arquivos <acronym>PO</acronym> por configurações dos projetos, se não for dito nada em contrário. Isto poderá ser altamente estranho para alguém que não esteja habituado ao &kde;. Contudo, o &kde; tem mais de 900 arquivos <acronym>POT</acronym> para traduzir, somente para as mensagens da <acronym>GUI</acronym>. Assim, para uma tarefa desse tipo, é desejável alguma automação. O tempo levado para configurar um projeto é bastante menor em comparação com o tempo que se ganha posteriormente. Obviamente, como não-usuário do &kde;, você poderá ter menos sorte. Terá que fazer mais configurações, uma vez que os padrões não são completamente adequados e não irá ganhar muito se fizer muitas traduções, uma vez que os projetos da &GNU; só possuem tipicamente um arquivo <acronym>POT</acronym> para traduzir. </para> </sect2> </sect1> <sect1 id="preferences-global"> -<title ->Configurações globais do &kbabel;</title> - -<para ->Para mostrar o diálogo de preferências selecione <menuchoice -><guimenu ->Configurações</guimenu -> <guimenuitem ->Configurar KBabel...</guimenuitem -></menuchoice -> no menu do &kbabel;. Ele usa um estruturado diálogo de configuração que torna muito fácil encontrar uma opção se ter que realizar uma intensa busca por ela. </para> +<title>Configurações globais do &kbabel;</title> + +<para>Para mostrar o diálogo de preferências selecione <menuchoice><guimenu>Configurações</guimenu> <guimenuitem>Configurar KBabel...</guimenuitem></menuchoice> no menu do &kbabel;. Ele usa um estruturado diálogo de configuração que torna muito fácil encontrar uma opção se ter que realizar uma intensa busca por ela. </para> <sect2 id="preferences-editor"> -<title ->Editar</title> -<para ->A categoria de preferências do editor é dividia em duas sub-janelas: <guilabel ->Geral</guilabel ->, <guilabel ->Aparência</guilabel ->, <guilabel ->Ortografia</guilabel -> e <guilabel ->Fontes</guilabel ->. Todas estas configurações personalizam como o editor se comporta e parece. </para> +<title>Editar</title> +<para>A categoria de preferências do editor é dividia em duas sub-janelas: <guilabel>Geral</guilabel>, <guilabel>Aparência</guilabel>, <guilabel>Ortografia</guilabel> e <guilabel>Fontes</guilabel>. Todas estas configurações personalizam como o editor se comporta e parece. </para> <sect3 id="preferences-editor-general"> -<title ->Geral</title> +<title>Geral</title> <screenshot> -<screeninfo ->Janela Geral de Edição</screeninfo> +<screeninfo>Janela Geral de Edição</screeninfo> <mediaobject> <imageobject> <imagedata fileref="pref_edit_general.png" format="PNG"/> </imageobject> -<textobject -><phrase ->Janela Geral de Edição</phrase -></textobject> +<textobject><phrase>Janela Geral de Edição</phrase></textobject> </mediaobject> </screenshot> -<para ->Esta seção contém um conjunto de caixas de verificação.</para> - -<para ->A primeira caixa de verificação no lado superior é se o estado aproximado é desligado automaticamente quando um caracter é inserido no editor de MsgStr. Quando esta opção estiver desabilitada você terá que selecionar manualmente <menuchoice -><guimenu ->Editar</guimenu -><guimenuitem ->Desligar Estado Aproximado </guimenuitem -></menuchoice -> ou usar o atalho <keycombo action="simul" ->&Ctrl;<keycap ->U</keycap -></keycombo ->. Observe que isto significa que o string <literal ->, fuzzy</literal -> é removido da entrada do comentário.</para> - -<para ->A próxima opção lhe permite habilitar a edição <quote ->inteligente</quote ->, quando o editor automaticamente insere caracteres especiais escapados corretamente, ⪚ <literal ->\t</literal -> após pressionar <keycap ->Tab</keycap -> e isto permite manipulação especial do <keycap ->Enter</keycap ->.</para> - -<para ->As caixas de verificação inferiores são muito úteis para verificação, não para correção das traduções, se o string a ser traduzido é uma substituição apropriada para o original. Por exemplo, muitas mensagens representam ítens de menu com atalhos de teclado e strings formatados no estilo-C cuja estrutura deve permanecer intacta uma vez traduzida. </para> +<para>Esta seção contém um conjunto de caixas de verificação.</para> + +<para>A primeira caixa de verificação no lado superior é se o estado aproximado é desligado automaticamente quando um caracter é inserido no editor de MsgStr. Quando esta opção estiver desabilitada você terá que selecionar manualmente <menuchoice><guimenu>Editar</guimenu><guimenuitem>Desligar Estado Aproximado </guimenuitem></menuchoice> ou usar o atalho <keycombo action="simul">&Ctrl;<keycap>U</keycap></keycombo>. Observe que isto significa que o string <literal>, fuzzy</literal> é removido da entrada do comentário.</para> + +<para>A próxima opção lhe permite habilitar a edição <quote>inteligente</quote>, quando o editor automaticamente insere caracteres especiais escapados corretamente, ⪚ <literal>\t</literal> após pressionar <keycap>Tab</keycap> e isto permite manipulação especial do <keycap>Enter</keycap>.</para> + +<para>As caixas de verificação inferiores são muito úteis para verificação, não para correção das traduções, se o string a ser traduzido é uma substituição apropriada para o original. Por exemplo, muitas mensagens representam ítens de menu com atalhos de teclado e strings formatados no estilo-C cuja estrutura deve permanecer intacta uma vez traduzida. </para> <variablelist> <varlistentry> - <term -><guilabel ->Verificar Argumentos</guilabel -></term> + <term><guilabel>Verificar Argumentos</guilabel></term> <listitem> - <para ->Quando esta opção estiver selecionada, strings no estilo-C no original e a tradução são verificados para certificar-se de que o número de seqüências formatadas e a ordem são consistentes. </para> + <para>Quando esta opção estiver selecionada, strings no estilo-C no original e a tradução são verificados para certificar-se de que o número de seqüências formatadas e a ordem são consistentes. </para> </listitem> </varlistentry> <varlistentry> - <term -><guilabel ->Verificar Acelerador</guilabel -></term> + <term><guilabel>Verificar Acelerador</guilabel></term> <listitem> -<para ->Quando esta opção é selecionada, o &kbabel; verifica se a quantidade de caracteres aceleradores é idêntica, tanto na mensagem original como na traduzida. Observe que o caracter de aceleração é o & no &kde; (mas não em todas as ferramentas de programação). Veja a seção de <link linkend="preferences-project-miscellaneous" ->Diversos</link -> abaixo, para saber como alterar um acelerador de teclado.</para> +<para>Quando esta opção é selecionada, o &kbabel; verifica se a quantidade de caracteres aceleradores é idêntica, tanto na mensagem original como na traduzida. Observe que o caracter de aceleração é o & no &kde; (mas não em todas as ferramentas de programação). Veja a seção de <link linkend="preferences-project-miscellaneous">Diversos</link> abaixo, para saber como alterar um acelerador de teclado.</para> </listitem> </varlistentry> <varlistentry> - <term -><guilabel ->Verificar Equação</guilabel -></term> + <term><guilabel>Verificar Equação</guilabel></term> <listitem> - <para ->Este é um recurso de desenvolvimento do projeto &kde;. Arquivos <filename ->.desktop</filename -> são simplesmente arquivos de texto que armazenam diversos parâmetros no formato <literal ->valor=chave</literal ->. Algumas dessas <literal ->chaves</literal -> são traduzíveis. A única imposição é manter o lado esquerdo da igualdade imutável. Verificar equação lhe permite ressaltar diversos erros determinados pelo algoritmo de aproximado do <command ->msgmerge</command ->. Observe que existem situações em que esta função gera erros falsos em alguns arquivos PO. </para> + <para>Este é um recurso de desenvolvimento do projeto &kde;. Arquivos <filename>.desktop</filename> são simplesmente arquivos de texto que armazenam diversos parâmetros no formato <literal>valor=chave</literal>. Algumas dessas <literal>chaves</literal> são traduzíveis. A única imposição é manter o lado esquerdo da igualdade imutável. Verificar equação lhe permite ressaltar diversos erros determinados pelo algoritmo de aproximado do <command>msgmerge</command>. Observe que existem situações em que esta função gera erros falsos em alguns arquivos PO. </para> </listitem> </varlistentry> <varlistentry> - <term -><guilabel ->Procurar por Informações de Contexto Traduzidas</guilabel -></term> + <term><guilabel>Procurar por Informações de Contexto Traduzidas</guilabel></term> <listitem> -<para ->Algumas mensagens originais contém informações de contexto para delimitar o contexto em que o string original deve ser traduzido. Isto é para evitar que muitas palavras simples, como <quote ->Salvar</quote ->, sejam traduzidas incorretamente em função de seu sentido amplo em muitos idiomas. Informação de contexto é marcada com <literal ->_:</literal ->. Muitos tradutores inexperientes traduzem informações de contexto e enchem seus arquivos PO com lixo. Habilite esta caixa para certificar-se que você será alertado sobre estes erros no arquivo.</para> +<para>Algumas mensagens originais contém informações de contexto para delimitar o contexto em que o string original deve ser traduzido. Isto é para evitar que muitas palavras simples, como <quote>Salvar</quote>, sejam traduzidas incorretamente em função de seu sentido amplo em muitos idiomas. Informação de contexto é marcada com <literal>_:</literal>. Muitos tradutores inexperientes traduzem informações de contexto e enchem seus arquivos PO com lixo. Habilite esta caixa para certificar-se que você será alertado sobre estes erros no arquivo.</para> </listitem> </varlistentry> <varlistentry> - <term -><guilabel ->Verificar Formas Plurais</guilabel -></term> + <term><guilabel>Verificar Formas Plurais</guilabel></term> <listitem> - <para ->Se você estiver traduzindo o projeto do &kde;, ele usa uma forma especial de indicar as formas plurais das mensagens. Esta verificação conta automaticamente o número de formas no <acronym ->msgstr</acronym -> e compara-o com o número indicado na página de <link linkend="preferences-project-identity" -><guilabel ->Identidade</guilabel -></link ->. Um número incorreto de formas plurais poderá resultar no estouro de uma aplicação. </para> + <para>Se você estiver traduzindo o projeto do &kde;, ele usa uma forma especial de indicar as formas plurais das mensagens. Esta verificação conta automaticamente o número de formas no <acronym>msgstr</acronym> e compara-o com o número indicado na página de <link linkend="preferences-project-identity"><guilabel>Identidade</guilabel></link>. Um número incorreto de formas plurais poderá resultar no estouro de uma aplicação. </para> </listitem> </varlistentry> <varlistentry> - <term -><guilabel ->Beep no erro</guilabel -></term> + <term><guilabel>Beep no erro</guilabel></term> <listitem> - <para ->Sua campainha de sistema tocará quando você sair de entradas com erros como os descritos acima. </para> + <para>Sua campainha de sistema tocará quando você sair de entradas com erros como os descritos acima. </para> </listitem> </varlistentry> <varlistentry> - <term -><guilabel ->Mudar cor do texto no erro</guilabel -></term> + <term><guilabel>Mudar cor do texto no erro</guilabel></term> <listitem> - <para ->Este é outro tipo de alerta sobre erros na mensagem atual. É uma boa solução para quem tem problemas de audição ou não gostam do barulho da campainha. Veja também a aba <link linkend="preferences-editor-appearance" ->Aparência</link -> para ver como mudar a cor do texto em erros. </para> + <para>Este é outro tipo de alerta sobre erros na mensagem atual. É uma boa solução para quem tem problemas de audição ou não gostam do barulho da campainha. Veja também a aba <link linkend="preferences-editor-appearance">Aparência</link> para ver como mudar a cor do texto em erros. </para> </listitem> </varlistentry> </variablelist> @@ -282,546 +132,257 @@ </sect3> <sect3 id="preferences-editor-appearance"> -<title ->Aparência</title> +<title>Aparência</title> <screenshot> -<screeninfo ->Janela de Aparência da Edição</screeninfo> +<screeninfo>Janela de Aparência da Edição</screeninfo> <mediaobject> <imageobject> <imagedata fileref="pref_edit_appearance.png" format="PNG"/> </imageobject> -<textobject -><phrase ->Janela de Aparência da Edição</phrase -></textobject> +<textobject><phrase>Janela de Aparência da Edição</phrase></textobject> </mediaobject> </screenshot> -<para ->Estas opções lhe permitem configurar a aparência do editor de mensagem. Na parte superior existem 4 caixas de verificação: </para> +<para>Estas opções lhe permitem configurar a aparência do editor de mensagem. Na parte superior existem 4 caixas de verificação: </para> <variablelist> <varlistentry> - <term -><guibutton ->Destaque de sintaxe</guibutton -></term> - <listitem -><para ->Configurar esta opção habilitará o destaque de sintaxe para caracteres especiais, aceleradores e o texto de fundo no visor de msgid e no editor de msgstr. Se você não possui um monitor monocromático ou não possua defeito visual, você deve habilitar esta opção. </para -></listitem> + <term><guibutton>Destaque de sintaxe</guibutton></term> + <listitem><para>Configurar esta opção habilitará o destaque de sintaxe para caracteres especiais, aceleradores e o texto de fundo no visor de msgid e no editor de msgstr. Se você não possui um monitor monocromático ou não possua defeito visual, você deve habilitar esta opção. </para></listitem> </varlistentry> <varlistentry> - <term -><guibutton ->Destaque de fundo</guibutton -></term> - <listitem -><para ->O fundo é destacado somente para os caracteres existentes no msgid e msgstr. Isto inclui espaços. Isto é útil se você não quer ver as aspas envolventes (veja abaixo) para a entrada <acronym ->PO</acronym ->, e você quer ainda observar espaços iniciais e finais numa linha de texto. </para -></listitem> + <term><guibutton>Destaque de fundo</guibutton></term> + <listitem><para>O fundo é destacado somente para os caracteres existentes no msgid e msgstr. Isto inclui espaços. Isto é útil se você não quer ver as aspas envolventes (veja abaixo) para a entrada <acronym>PO</acronym>, e você quer ainda observar espaços iniciais e finais numa linha de texto. </para></listitem> </varlistentry> <varlistentry> - <term -><guibutton ->Marcar espaços em branco com pontos</guibutton -></term> - <listitem -><para ->Quando você sentir a necessidade de contar espaços e não gostar de usar o destaque de fundo então você pode habilitar esta opção para ter um pequeno ponto desenhado no meio dos caracteres de espaço em branco. Observe que o ponto é um sinal de ponto no centro da caixa do caractere e não é um ponto decimal. </para -></listitem> + <term><guibutton>Marcar espaços em branco com pontos</guibutton></term> + <listitem><para>Quando você sentir a necessidade de contar espaços e não gostar de usar o destaque de fundo então você pode habilitar esta opção para ter um pequeno ponto desenhado no meio dos caracteres de espaço em branco. Observe que o ponto é um sinal de ponto no centro da caixa do caractere e não é um ponto decimal. </para></listitem> </varlistentry> <varlistentry> - <term -><guibutton ->Mostrar aspas envolventes</guibutton -></term> - <listitem -><para ->Se você achar que ver os caracteres de terminação numa linha de texto de um msgstr ou msgid é preferível então habilite esta opção para ver as aspas envolventes em cada linha de texto.</para> - <para ->Se você está acostumado a editar arquivos <acronym ->PO</acronym -> com editores de texto simples você pode sentir-se mais seguro se você pode ver as aspas iniciais e finais nas linhas de entrada do <acronym ->PO</acronym ->. </para -></listitem> + <term><guibutton>Mostrar aspas envolventes</guibutton></term> + <listitem><para>Se você achar que ver os caracteres de terminação numa linha de texto de um msgstr ou msgid é preferível então habilite esta opção para ver as aspas envolventes em cada linha de texto.</para> + <para>Se você está acostumado a editar arquivos <acronym>PO</acronym> com editores de texto simples você pode sentir-se mais seguro se você pode ver as aspas iniciais e finais nas linhas de entrada do <acronym>PO</acronym>. </para></listitem> </varlistentry> </variablelist> -<para ->Para os diferentes ítens no texto editado aqui existem diferentes escolhas de cor para tornar a edição mais fácil. As cores podem ser mudadas clicando nos botões de seleção de cor. No diálogo 'selecionar cor' você pode escolher uma das cores padronizadas, cores personalizadas ou simplesmente obter uma cor de qualquer parte de sua tela. </para> +<para>Para os diferentes ítens no texto editado aqui existem diferentes escolhas de cor para tornar a edição mais fácil. As cores podem ser mudadas clicando nos botões de seleção de cor. No diálogo 'selecionar cor' você pode escolher uma das cores padronizadas, cores personalizadas ou simplesmente obter uma cor de qualquer parte de sua tela. </para> <variablelist> <varlistentry> - <term -><guilabel ->Cor de fundo</guilabel -></term> - <listitem -><para ->Isto configura a cor de fundo para caracteres no visor da MsgID e no editor de MsgStr. Para mudar a cor de fundo geral da caixa de edição você deve usar o &kcontrolcenter;. </para -></listitem> + <term><guilabel>Cor de fundo</guilabel></term> + <listitem><para>Isto configura a cor de fundo para caracteres no visor da MsgID e no editor de MsgStr. Para mudar a cor de fundo geral da caixa de edição você deve usar o &kcontrolcenter;. </para></listitem> </varlistentry> <varlistentry> - <term -><guilabel ->Cor dos caracteres escapados</guilabel -></term> - <listitem -><para ->Aqui você pode ajustar a cor de caracteres escapados como (<literal ->\"</literal ->) aspas duplas ou (<literal ->\n</literal ->) nova linha. </para -></listitem> + <term><guilabel>Cor dos caracteres escapados</guilabel></term> + <listitem><para>Aqui você pode ajustar a cor de caracteres escapados como (<literal>\"</literal>) aspas duplas ou (<literal>\n</literal>) nova linha. </para></listitem> </varlistentry> <varlistentry> - <term -><guilabel ->Cor para erros de sintaxe</guilabel -></term> - <listitem -><para ->Esta é a cor para toda a entrada de texto se erros são detectados quando você tenta salvar o arquivo <acronym ->PO</acronym ->. Erros são provocados por terminações não idênticas tanto do <acronym ->msgid</acronym -> como do <acronym ->msgstr</acronym ->, ou caracteres escapados incorretamente. </para -></listitem> + <term><guilabel>Cor para erros de sintaxe</guilabel></term> + <listitem><para>Esta é a cor para toda a entrada de texto se erros são detectados quando você tenta salvar o arquivo <acronym>PO</acronym>. Erros são provocados por terminações não idênticas tanto do <acronym>msgid</acronym> como do <acronym>msgstr</acronym>, ou caracteres escapados incorretamente. </para></listitem> </varlistentry> <varlistentry> - <term -><guilabel ->Cor para caracteres estilo-c</guilabel -></term> - <listitem -><para ->Isto configura a cor para um seqüência de caracteres no estilo das funções <function ->printf</function -> ou <function ->scanf</function -> da linguagem C. Geralmente eles iniciam com (<literal ->%</literal ->) caracter de percentual e são continuados por um caracter. </para -></listitem> + <term><guilabel>Cor para caracteres estilo-c</guilabel></term> + <listitem><para>Isto configura a cor para um seqüência de caracteres no estilo das funções <function>printf</function> ou <function>scanf</function> da linguagem C. Geralmente eles iniciam com (<literal>%</literal>) caracter de percentual e são continuados por um caracter. </para></listitem> </varlistentry> <varlistentry> - <term -><guilabel ->Cor para aceleradores de teclado</guilabel -></term> - <listitem -><para ->Os atalhos de teclado começam com um <quote ->E comercial</quote -> (&) no &kde;, mas se você estiver traduzindo outros projetos, poderá existir um caracter diferente marcando a tecla do acelerador. Veja a seção de <link linkend="preferences-project-miscellaneous" ->Diversos</link -> abaixo, para saber como alterar um acelerador de teclado. </para -></listitem> + <term><guilabel>Cor para aceleradores de teclado</guilabel></term> + <listitem><para>Os atalhos de teclado começam com um <quote>E comercial</quote> (&) no &kde;, mas se você estiver traduzindo outros projetos, poderá existir um caracter diferente marcando a tecla do acelerador. Veja a seção de <link linkend="preferences-project-miscellaneous">Diversos</link> abaixo, para saber como alterar um acelerador de teclado. </para></listitem> </varlistentry> </variablelist> -<para ->O estado da entrada atualmente editada é marcado por três <acronym ->LED</acronym ->s. Para sua conveniência você pode escolher onde colocar estes <acronym ->LED</acronym ->s—se na barra de estado ou na seção do editor (entre a entrada msgid e msgstr). Se tiver dificuldade de ver algumas cores ou se deseja ser capaz de acompanhar a mudança de estado do <acronym ->LED</acronym -> facilmente sem mover seus olhos você pode selecionar a cor desejada usando o botão selecionador de cores. </para> +<para>O estado da entrada atualmente editada é marcado por três <acronym>LED</acronym>s. Para sua conveniência você pode escolher onde colocar estes <acronym>LED</acronym>s—se na barra de estado ou na seção do editor (entre a entrada msgid e msgstr). Se tiver dificuldade de ver algumas cores ou se deseja ser capaz de acompanhar a mudança de estado do <acronym>LED</acronym> facilmente sem mover seus olhos você pode selecionar a cor desejada usando o botão selecionador de cores. </para> </sect3> </sect2> <sect2 id="preferences-search"> -<title ->Procurar</title> +<title>Procurar</title> <screenshot> -<screeninfo ->Janela de Procura</screeninfo> +<screeninfo>Janela de Procura</screeninfo> <mediaobject> <imageobject> <imagedata fileref="pref_search.png" format="PNG"/> </imageobject> -<textobject -><phrase ->Janela de Procura</phrase -></textobject> +<textobject><phrase>Janela de Procura</phrase></textobject> </mediaobject> </screenshot> -<para ->A seção procurar lhe permite personalizar várias configurações para procura em strings previamente traduzidos. </para> - -<para ->Configurações gerais são comuns para todos os tipos de busca. Se você habilitar a opção <guibutton ->Iniciar automaticamente a busca</guibutton -> então a busca é automaticamente iniciada sempre que você alterna para outra entrada no editor. Atualmente existem três possibilidades que você pode escolher, mas uma vez que o &kbabel; pode usar plugins de dicionário os dicionários disponíveis dependem da sua instalação. Usando <menuchoice -><guimenuitem ->Configurações</guimenuitem -> <guimenuitem ->Configurar Dicionário</guimenuitem -> <guimenuitem ->...</guimenuitem -></menuchoice -> você pode configurar cada plugin de procura.</para> - -<para ->Os plugins de dicionário instalados por padrão são:</para> +<para>A seção procurar lhe permite personalizar várias configurações para procura em strings previamente traduzidos. </para> + +<para>Configurações gerais são comuns para todos os tipos de busca. Se você habilitar a opção <guibutton>Iniciar automaticamente a busca</guibutton> então a busca é automaticamente iniciada sempre que você alterna para outra entrada no editor. Atualmente existem três possibilidades que você pode escolher, mas uma vez que o &kbabel; pode usar plugins de dicionário os dicionários disponíveis dependem da sua instalação. Usando <menuchoice><guimenuitem>Configurações</guimenuitem> <guimenuitem>Configurar Dicionário</guimenuitem> <guimenuitem>...</guimenuitem></menuchoice> você pode configurar cada plugin de procura.</para> + +<para>Os plugins de dicionário instalados por padrão são:</para> <variablelist> <varlistentry> -<term ->Motor de Busca de Banco de Dados do &kde;</term> +<term>Motor de Busca de Banco de Dados do &kde;</term> <listitem> -<para ->Este novo método está ainda em estágio alfa de desenvolvimento e é baseado no &kbabeldict; que acompanha o &kbabel;. Veja a documentação do &kbabeldict; para mais informações sobre a configuração deste motor de busca. </para -></listitem> +<para>Este novo método está ainda em estágio alfa de desenvolvimento e é baseado no &kbabeldict; que acompanha o &kbabel;. Veja a documentação do &kbabeldict; para mais informações sobre a configuração deste motor de busca. </para></listitem> </varlistentry> <varlistentry> -<term ->Compêndio PO</term> -<listitem -><para ->O compêndio é um arquivo <acronym ->PO</acronym -> normal, que deve conter uma lista de traduções padrão da sua equipe de tradução. Se você não possui um, você pode também usar um arquivo que contenha todas as traduções de sua equipe (⪚ o arquivo <filename ->$lang.messages</filename -> do Projeto &kde; pode ser encontrado em <ulink url="http://i18n.kde.org/po_overview/" ->i18n.kde.org</ulink ->). </para -></listitem> +<term>Compêndio PO</term> +<listitem><para>O compêndio é um arquivo <acronym>PO</acronym> normal, que deve conter uma lista de traduções padrão da sua equipe de tradução. Se você não possui um, você pode também usar um arquivo que contenha todas as traduções de sua equipe (⪚ o arquivo <filename>$lang.messages</filename> do Projeto &kde; pode ser encontrado em <ulink url="http://i18n.kde.org/po_overview/">i18n.kde.org</ulink>). </para></listitem> </varlistentry> <varlistentry> -<term ->PO Auxiliar</term> -<listitem -><para ->O auxiliar deve ajudá-lo a encontrar o contexto da tradução procurando a mesma mensagem num catálogo de mensagens do mesmo pacote mas traduzido para outro idioma. Esta é uma maneira de você dar uma olhada em como esta mensagem foi traduzida em outro idioma. </para -></listitem> +<term>PO Auxiliar</term> +<listitem><para>O auxiliar deve ajudá-lo a encontrar o contexto da tradução procurando a mesma mensagem num catálogo de mensagens do mesmo pacote mas traduzido para outro idioma. Esta é uma maneira de você dar uma olhada em como esta mensagem foi traduzida em outro idioma. </para></listitem> </varlistentry> </variablelist> -<para ->Você pode também iniciar a busca manualmente escolhendo uma entrada no menu que aparece, seja clicando em <menuchoice -> <guimenu ->Dicionários</guimenu -><guimenuitem ->Procurar Texto</guimenuitem -> <guimenuitem ->Compêndio PO</guimenuitem -></menuchoice -> ou mantendo o botão de procurar pressionado na barra de ferramentas por algum tempo. </para> +<para>Você pode também iniciar a busca manualmente escolhendo uma entrada no menu que aparece, seja clicando em <menuchoice> <guimenu>Dicionários</guimenu><guimenuitem>Procurar Texto</guimenuitem> <guimenuitem>Compêndio PO</guimenuitem></menuchoice> ou mantendo o botão de procurar pressionado na barra de ferramentas por algum tempo. </para> </sect2> <sect2 id="preferences-diffmode"> -<title ->Diferenças</title> +<title>Diferenças</title> <screenshot> -<screeninfo ->Janela de Diferenças</screeninfo> +<screeninfo>Janela de Diferenças</screeninfo> <mediaobject> <imageobject> <imagedata fileref="pref_diff.png" format="PNG"/> </imageobject> -<textobject -><phrase ->Janela de Diferenças</phrase -></textobject> +<textobject><phrase>Janela de Diferenças</phrase></textobject> </mediaobject> </screenshot> -<para ->A seção <guilabel ->Diferenças</guilabel -> mantém configurações sobre como exibir diferenças nas msgids. </para> - -<para ->Cada diferença pode ser exibida tanto o texto adicionado como os caracteres removidos do texto. Para ambas você pode especificar o método de exibição e a cor que será usada. <guilabel ->Destacada</guilabel -> significa que o fundo dos caracteres correspondentes serão mostrados na cor selecionada, enquanto <guilabel ->Sublinhado</guilabel -> (para caracteres adicionados) ou <guilabel ->Riscado</guilabel -> (para caracteres removidos) mostrará as partes mudadas com linhas coloridas. </para> -<para ->Os modos de diferença precisam encontrar a <acronym ->msgid</acronym -> original para compará-las. Para esta finalidade, o &kbabel; pode usar o <link linkend="database" ->banco de dados de tradução</link -> se você ligá-lo em <guilabel ->Usar mensagens do Banco de Dados de Traduções</guilabel ->. Uma segunda possibilidade é usar uma árvore dos arquivos PO originais e especificar a raiz da árvore em <guilabel ->Pasta base para diferença dos arquivos</guilabel ->. </para> +<para>A seção <guilabel>Diferenças</guilabel> mantém configurações sobre como exibir diferenças nas msgids. </para> + +<para>Cada diferença pode ser exibida tanto o texto adicionado como os caracteres removidos do texto. Para ambas você pode especificar o método de exibição e a cor que será usada. <guilabel>Destacada</guilabel> significa que o fundo dos caracteres correspondentes serão mostrados na cor selecionada, enquanto <guilabel>Sublinhado</guilabel> (para caracteres adicionados) ou <guilabel>Riscado</guilabel> (para caracteres removidos) mostrará as partes mudadas com linhas coloridas. </para> +<para>Os modos de diferença precisam encontrar a <acronym>msgid</acronym> original para compará-las. Para esta finalidade, o &kbabel; pode usar o <link linkend="database">banco de dados de tradução</link> se você ligá-lo em <guilabel>Usar mensagens do Banco de Dados de Traduções</guilabel>. Uma segunda possibilidade é usar uma árvore dos arquivos PO originais e especificar a raiz da árvore em <guilabel>Pasta base para diferença dos arquivos</guilabel>. </para> </sect2> <sect2 id="preferences-fonts"> -<title ->Fontes</title> +<title>Fontes</title> <screenshot> -<screeninfo ->Janela de Fontes</screeninfo> +<screeninfo>Janela de Fontes</screeninfo> <mediaobject> <imageobject> <imagedata fileref="pref_fonts.png" format="PNG"/> </imageobject> -<textobject -><phrase ->Janela de Fontes</phrase -></textobject> +<textobject><phrase>Janela de Fontes</phrase></textobject> </mediaobject> </screenshot> -<para ->Este é um diálogo padrão de escolha de fontes do &kde; com uma pequena adição. Você pode selecionar ver somente fontes fixas habilitando a opção <guibutton ->Mostrar somente fontes fixas</guibutton ->. Isto é altamente recomendável para uma fácil tradução. O diálogo de fonte lhe permite configurar a família da fonte, estilo, tamanho e codificação. A caixa inferior mostra uma previsão da fonte atual para sua conveniência. </para> +<para>Este é um diálogo padrão de escolha de fontes do &kde; com uma pequena adição. Você pode selecionar ver somente fontes fixas habilitando a opção <guibutton>Mostrar somente fontes fixas</guibutton>. Isto é altamente recomendável para uma fácil tradução. O diálogo de fonte lhe permite configurar a família da fonte, estilo, tamanho e codificação. A caixa inferior mostra uma previsão da fonte atual para sua conveniência. </para> </sect2> </sect1> <sect1 id="preferences-project-wizard"> -<title ->Assistente de Novo Projeto</title> +<title>Assistente de Novo Projeto</title> <sect2 id="preferences-project-wizard-basic"> -<title ->Página 1</title> +<title>Página 1</title> <screenshot> -<screeninfo ->Página 1 do Assistente de Projetos</screeninfo> +<screeninfo>Página 1 do Assistente de Projetos</screeninfo> <mediaobject> <imageobject> <imagedata fileref="pref_wizard_page1.png" format="PNG"/> </imageobject> -<textobject -><phrase ->Página 1 do Assistente de Projetos</phrase -></textobject> +<textobject><phrase>Página 1 do Assistente de Projetos</phrase></textobject> </mediaobject> </screenshot> -<para ->A primeira página do assistente solicita-lhe os dados básicos do projeto. </para> +<para>A primeira página do assistente solicita-lhe os dados básicos do projeto. </para> <variablelist> <varlistentry> -<term -><guilabel ->Nome do projeto</guilabel -></term> -<listitem -><para ->Insira aqui o nome do projeto, como será apresentado no menu do &kbabel;. </para -></listitem> +<term><guilabel>Nome do projeto</guilabel></term> +<listitem><para>Insira aqui o nome do projeto, como será apresentado no menu do &kbabel;. </para></listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Nome do arquivo de configuração</guilabel -></term> -<listitem -><para ->Selecione aqui um arquivo para guardar a configuração do seu projeto. </para -></listitem> +<term><guilabel>Nome do arquivo de configuração</guilabel></term> +<listitem><para>Selecione aqui um arquivo para guardar a configuração do seu projeto. </para></listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Idioma</guilabel -></term> -<listitem -><para ->Selecione ou insira aqui o nome do idioma usado por este projeto. </para -></listitem> +<term><guilabel>Idioma</guilabel></term> +<listitem><para>Selecione ou insira aqui o nome do idioma usado por este projeto. </para></listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Tipo de projeto</guilabel -></term> -<listitem -><para ->Selecione aqui o tipo do seu projeto. </para -></listitem> +<term><guilabel>Tipo de projeto</guilabel></term> +<listitem><para>Selecione aqui o tipo do seu projeto. </para></listitem> </varlistentry> </variablelist> </sect2> <sect2 id="preferences-project-wizard-catman"> -<title ->Página 2</title> +<title>Página 2</title> <screenshot> -<screeninfo ->Página 2 do Assistente de Projetos</screeninfo> +<screeninfo>Página 2 do Assistente de Projetos</screeninfo> <mediaobject> <imageobject> <imagedata fileref="pref_wizard_page2.png" format="PNG"/> </imageobject> -<textobject -><phrase ->Página 2 do Assistente de Projetos</phrase -></textobject> +<textobject><phrase>Página 2 do Assistente de Projetos</phrase></textobject> </mediaobject> </screenshot> -<para ->A segunda página do assistente solicita as configurações relacionadas com o gerenciador de Catálogos. </para> +<para>A segunda página do assistente solicita as configurações relacionadas com o gerenciador de Catálogos. </para> <variablelist> <varlistentry> -<term -><guilabel ->Pasta base dos arquivos PO</guilabel -></term> -<listitem -><para ->Selecione a pasta base onde se encontram os seus arquivos PO. </para -></listitem> +<term><guilabel>Pasta base dos arquivos PO</guilabel></term> +<listitem><para>Selecione a pasta base onde se encontram os seus arquivos PO. </para></listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Pasta base para os arquivos POT</guilabel -></term> -<listitem -><para ->Selecione a pasta base onde se encontram os seus arquivos POT. </para -></listitem> +<term><guilabel>Pasta base para os arquivos POT</guilabel></term> +<listitem><para>Selecione a pasta base onde se encontram os seus arquivos POT. </para></listitem> </varlistentry> </variablelist> -<para ->Digite as pastas que contém todos os seus arquivos <acronym ->PO</acronym -> e os respectivos <acronym ->POT</acronym ->. Os arquivos e as pastas dentro dessas pastas serão então mesclados em uma árvore da janela do &catalogmanager;. </para> +<para>Digite as pastas que contém todos os seus arquivos <acronym>PO</acronym> e os respectivos <acronym>POT</acronym>. Os arquivos e as pastas dentro dessas pastas serão então mesclados em uma árvore da janela do &catalogmanager;. </para> </sect2> <sect2> -<title ->Verificando as Configurações do Projeto</title> - -<important -><para ->Como foi escrito anteriormente neste capítulo, infelizmente, o assistente é muito simples e, como tal, não solicita algumas informações importantes. </para -></important> - -<para ->Agora que você <quote ->terminou</quote -> o seu projeto novo, deverá verificar as configurações principais em <menuchoice -><guimenu ->Projeto</guimenu -> <guimenuitem ->Configurar...</guimenuitem -></menuchoice ->. Em especial, selecione a pasta de <guilabel ->Identidade</guilabel -> e corrija o endereço de e-mail da equipe na <guilabel ->Lista de correio do idioma</guilabel ->. (A que é criada por padrão no assistente só é útil se fizer parte de um projeto da &GNU;.) </para> - -<para ->Se o projeto não for o KDE, é recomendável que você verifique a página <guilabel ->Salvar</guilabel -> e verifique as suas opções. </para> +<title>Verificando as Configurações do Projeto</title> + +<important><para>Como foi escrito anteriormente neste capítulo, infelizmente, o assistente é muito simples e, como tal, não solicita algumas informações importantes. </para></important> + +<para>Agora que você <quote>terminou</quote> o seu projeto novo, deverá verificar as configurações principais em <menuchoice><guimenu>Projeto</guimenu> <guimenuitem>Configurar...</guimenuitem></menuchoice>. Em especial, selecione a pasta de <guilabel>Identidade</guilabel> e corrija o endereço de e-mail da equipe na <guilabel>Lista de correio do idioma</guilabel>. (A que é criada por padrão no assistente só é útil se fizer parte de um projeto da &GNU;.) </para> + +<para>Se o projeto não for o KDE, é recomendável que você verifique a página <guilabel>Salvar</guilabel> e verifique as suas opções. </para> </sect2> </sect1> <sect1 id="preferences-project-settings"> -<title ->Configurações do Projeto</title> - -<para ->Para mostrar a janela de configurações escolha a opção <menuchoice -><guimenu ->Projeto</guimenu -> <guimenuitem ->Configurar...</guimenuitem -></menuchoice -> do menu do &kbabel;. Ele usa uma janela de configuração estruturada que torna muito fácil encontrar uma opção sem ter que fazer uma pesquisa intensiva por ela.</para> - -<para ->O lado esquerdo do diálogo de preferências lista as categorias dos ítens personalizáveis e o lado direito mostra a correspondente aba para a categoria selecionada. O &kbabel; mantém as modificações se você mover-se entre as categorias, logo quando você estiver finalmente satisfeito clique no botão <guibutton ->OK</guibutton ->. A qualquer momento você pode usar a ajuda rápida — basta clicar no ponto de interrogação da barra de título e, após o cursor mudar de uma seta para uma seta com um ponto de interrogação, clicar num botão, rótulo, ou entrada de preferência para encontrar mais informações sobre ela.</para> - -<note -><para ->As páginas de configuração do &kbabel; (o editor) e do &catalogmanager; estão na lista. </para -></note> +<title>Configurações do Projeto</title> + +<para>Para mostrar a janela de configurações escolha a opção <menuchoice><guimenu>Projeto</guimenu> <guimenuitem>Configurar...</guimenuitem></menuchoice> do menu do &kbabel;. Ele usa uma janela de configuração estruturada que torna muito fácil encontrar uma opção sem ter que fazer uma pesquisa intensiva por ela.</para> + +<para>O lado esquerdo do diálogo de preferências lista as categorias dos ítens personalizáveis e o lado direito mostra a correspondente aba para a categoria selecionada. O &kbabel; mantém as modificações se você mover-se entre as categorias, logo quando você estiver finalmente satisfeito clique no botão <guibutton>OK</guibutton>. A qualquer momento você pode usar a ajuda rápida — basta clicar no ponto de interrogação da barra de título e, após o cursor mudar de uma seta para uma seta com um ponto de interrogação, clicar num botão, rótulo, ou entrada de preferência para encontrar mais informações sobre ela.</para> + +<note><para>As páginas de configuração do &kbabel; (o editor) e do &catalogmanager; estão na lista. </para></note> <sect2 id="preferences-project-identity"> -<title ->Identidade</title> - -<para ->Esta configuração diz respeito ao &kbabel;.</para> - -<para ->Esta seção permite-lhe definir os campos padrão para cada arquivo <acronym ->PO</acronym -> traduzido. Eles são o nome, o endereço de e-mail, o nome completo do idioma, o endereço de e-mail de sua equipe de traduções. Existe também um campo de fuso-horário que lhe permite registrar a sua <quote ->hora da última modificação</quote -> para os arquivos <acronym ->PO</acronym ->. Você poderá indicá-lo como uma seqüência de texto do tipo <acronym ->EEST</acronym -> ou um deslocamento em relação ao <acronym ->GMT</acronym -> do tipo -0300 (&ie; para o Brasil). Esta informação é usada ao atualizar os cabeçalhos dos arquivos. Você poderá encontrar as opções que controlam os campos do cabeçalho que deverão ser atualizados na seção <link linkend="preferences-project-save" ->Salvar</link -> da janela de Preferências.</para> - -<warning -><para ->As seqüências de caracteres para os fusos-horários não são padronizadas. Por isso, você não deverá usar o texto aqui para a especificação da hora de salvamento na página <link linkend="preferences-project-save" ->Salvar</link ->. Você deverá usar o <literal ->%z</literal -> nesse caso.</para -></warning> +<title>Identidade</title> + +<para>Esta configuração diz respeito ao &kbabel;.</para> + +<para>Esta seção permite-lhe definir os campos padrão para cada arquivo <acronym>PO</acronym> traduzido. Eles são o nome, o endereço de e-mail, o nome completo do idioma, o endereço de e-mail de sua equipe de traduções. Existe também um campo de fuso-horário que lhe permite registrar a sua <quote>hora da última modificação</quote> para os arquivos <acronym>PO</acronym>. Você poderá indicá-lo como uma seqüência de texto do tipo <acronym>EEST</acronym> ou um deslocamento em relação ao <acronym>GMT</acronym> do tipo -0300 (&ie; para o Brasil). Esta informação é usada ao atualizar os cabeçalhos dos arquivos. Você poderá encontrar as opções que controlam os campos do cabeçalho que deverão ser atualizados na seção <link linkend="preferences-project-save">Salvar</link> da janela de Preferências.</para> + +<warning><para>As seqüências de caracteres para os fusos-horários não são padronizadas. Por isso, você não deverá usar o texto aqui para a especificação da hora de salvamento na página <link linkend="preferences-project-save">Salvar</link>. Você deverá usar o <literal>%z</literal> nesse caso.</para></warning> <variablelist> <varlistentry> -<term -><guilabel ->Número de formas de singular/plural</guilabel -></term> +<term><guilabel>Número de formas de singular/plural</guilabel></term> <listitem> -<para ->Use isto para configurar o número de formas de plural para seu idioma. Por exemplo, isto é 2 para o Português Brasileiro (uma para a forma singular e uma para a forma plural).</para> - -<note -><para ->Este recurso só está implementado atualmente para o formato das formas plurais usado no &kde;. Não funciona com as formas plurais do 'gettext' da &GNU;.</para -></note -> +<para>Use isto para configurar o número de formas de plural para seu idioma. Por exemplo, isto é 2 para o Português Brasileiro (uma para a forma singular e uma para a forma plural).</para> + +<note><para>Este recurso só está implementado atualmente para o formato das formas plurais usado no &kde;. Não funciona com as formas plurais do 'gettext' da &GNU;.</para></note> </listitem> </varlistentry> </variablelist> @@ -829,796 +390,298 @@ </sect2> <sect2 id="preferences-project-save"> -<title ->Salvar</title> +<title>Salvar</title> -<para ->Esta configuração diz respeito ao &kbabel;.</para> +<para>Esta configuração diz respeito ao &kbabel;.</para> -<para -><remark ->POR FAZER Isto parece documentar apenas a página "Geral", mas não as do "Cabeçalho" e "Direitos Autorais" </remark -></para> +<para><remark>POR FAZER Isto parece documentar apenas a página "Geral", mas não as do "Cabeçalho" e "Direitos Autorais" </remark></para> -<para ->Esta seção lhe permite editar as opções para salvamento de arquivos <acronym ->PO</acronym ->. O primeiro grupo de caixas de verificação controla o comportamento geral para as ações executadas no salvamento do arquivo <acronym ->PO</acronym ->. </para> +<para>Esta seção lhe permite editar as opções para salvamento de arquivos <acronym>PO</acronym>. O primeiro grupo de caixas de verificação controla o comportamento geral para as ações executadas no salvamento do arquivo <acronym>PO</acronym>. </para> <variablelist> <varlistentry> - <term -><guibutton ->Atualizar cabeçalho quando salvar</guibutton -></term> - <listitem -><para ->Habilite este botão para atualizar as informações de cabeçalho do arquivo cada vez que ele for salvo. O cabeçalho normalmente mantém informações sobre a data e hora que o arquivo foi atualizado, o último tradutor, etc. Você pode escolher quais informações você deseja atualizar na área de caixas de verificação <guilabel ->Campos a atualizar</guilabel -> abaixo. Campos que não existem podem ser adicionados ao cabeçalho. Se você deseja adicionar campos ao cabeçalho você pode editar o cabeçalho manualmente escolhendo <menuchoice -><guimenu ->Editar</guimenu -> <guimenuitem ->Editar Cabeçalho</guimenuitem -></menuchoice -> na janela do editor. </para -></listitem> + <term><guibutton>Atualizar cabeçalho quando salvar</guibutton></term> + <listitem><para>Habilite este botão para atualizar as informações de cabeçalho do arquivo cada vez que ele for salvo. O cabeçalho normalmente mantém informações sobre a data e hora que o arquivo foi atualizado, o último tradutor, etc. Você pode escolher quais informações você deseja atualizar na área de caixas de verificação <guilabel>Campos a atualizar</guilabel> abaixo. Campos que não existem podem ser adicionados ao cabeçalho. Se você deseja adicionar campos ao cabeçalho você pode editar o cabeçalho manualmente escolhendo <menuchoice><guimenu>Editar</guimenu> <guimenuitem>Editar Cabeçalho</guimenuitem></menuchoice> na janela do editor. </para></listitem> </varlistentry> <varlistentry> - <term -><guibutton ->Verificar sintaxe do arquivo ao salvar</guibutton -></term> - <listitem -><para ->Assinale esta opção para verificar automaticamente a sintaxe do arquivo ao salvar, utilizando <userinput -><command ->msgfmt</command -> --statistics</userinput ->. Você só receberá uma mensagem se ocorrer um erro. Você deve manter esta validação ativa a não ser que saiba o que está fazendo. </para -></listitem> + <term><guibutton>Verificar sintaxe do arquivo ao salvar</guibutton></term> + <listitem><para>Assinale esta opção para verificar automaticamente a sintaxe do arquivo ao salvar, utilizando <userinput><command>msgfmt</command> --statistics</userinput>. Você só receberá uma mensagem se ocorrer um erro. Você deve manter esta validação ativa a não ser que saiba o que está fazendo. </para></listitem> </varlistentry> </variablelist> -<para ->Se você não quiser mexer em alguns dos campos do cabeçalho do arquivo <acronym ->PO</acronym ->, ou se quiser forçar a atualização de alguns campos específicos, existem cinco opções que controlam isso: a data da revisão, o idioma do arquivo <acronym ->PO</acronym ->, a codificação do texto, o nome do último tradutor e a codificação. Se um dos campos não existir, será adicionado ao cabeçalho. Se você quiser adicionar outras informações ao cabeçalho, você terá de editá-lo manualmente, escolhendo para isso a opção <menuchoice -><guimenu ->Editar</guimenu -><guimenuitem ->Editar Cabeçalho</guimenuitem -></menuchoice -> na janela do editor. Desative a opção <guibutton ->atualizar o cabeçalho ao salvar</guibutton -> acima, se não quiser que o cabeçalho seja atualizado.</para> - -<para ->Para a data e hora do campo do cabeçalho <emphasis ->PO-Revision-Date</emphasis -> (Data de Revisão do PO), você poderá escolher um dos formatos: <guilabel ->Padrão</guilabel ->, <guilabel ->Local</guilabel ->, <guilabel ->Personalizado</guilabel ->.</para> - -<important -><para ->Você deverá manter a configuração <guilabel ->Padrão</guilabel ->. As outras duas opções fazem com que o arquivo <acronym ->PO</acronym -> gerado não seja mais um arquivo <acronym ->PO</acronym -> normal do 'gettext' da &GNU;, assim isto deverá ser evitado. </para -></important> +<para>Se você não quiser mexer em alguns dos campos do cabeçalho do arquivo <acronym>PO</acronym>, ou se quiser forçar a atualização de alguns campos específicos, existem cinco opções que controlam isso: a data da revisão, o idioma do arquivo <acronym>PO</acronym>, a codificação do texto, o nome do último tradutor e a codificação. Se um dos campos não existir, será adicionado ao cabeçalho. Se você quiser adicionar outras informações ao cabeçalho, você terá de editá-lo manualmente, escolhendo para isso a opção <menuchoice><guimenu>Editar</guimenu><guimenuitem>Editar Cabeçalho</guimenuitem></menuchoice> na janela do editor. Desative a opção <guibutton>atualizar o cabeçalho ao salvar</guibutton> acima, se não quiser que o cabeçalho seja atualizado.</para> + +<para>Para a data e hora do campo do cabeçalho <emphasis>PO-Revision-Date</emphasis> (Data de Revisão do PO), você poderá escolher um dos formatos: <guilabel>Padrão</guilabel>, <guilabel>Local</guilabel>, <guilabel>Personalizado</guilabel>.</para> + +<important><para>Você deverá manter a configuração <guilabel>Padrão</guilabel>. As outras duas opções fazem com que o arquivo <acronym>PO</acronym> gerado não seja mais um arquivo <acronym>PO</acronym> normal do 'gettext' da &GNU;, assim isto deverá ser evitado. </para></important> <itemizedlist> - <listitem -><para -><guilabel ->Padrão</guilabel -> é o formato normalmente usado em arquivos <acronym ->PO</acronym ->. </para -></listitem> - <listitem -><para -><guilabel ->Local</guilabel -> é o formato especificado para seu país. </para -></listitem> - <listitem -><para -><guilabel ->Personalizado</guilabel -> lhe permite definir seu próprio formato, onde você pode usar os seguintes strings no formato do estilo-C: <table> - <title ->Ano</title> + <listitem><para><guilabel>Padrão</guilabel> é o formato normalmente usado em arquivos <acronym>PO</acronym>. </para></listitem> + <listitem><para><guilabel>Local</guilabel> é o formato especificado para seu país. </para></listitem> + <listitem><para><guilabel>Personalizado</guilabel> lhe permite definir seu próprio formato, onde você pode usar os seguintes strings no formato do estilo-C: <table> + <title>Ano</title> <tgroup cols="3"> <thead> <row> - <entry ->Formato</entry -><entry ->Significado</entry -><entry ->Intervalo</entry> + <entry>Formato</entry><entry>Significado</entry><entry>Intervalo</entry> </row> </thead> <tbody> <row> - <entry ->%a</entry -><entry ->ano</entry -><entry ->00 à 99</entry> + <entry>%a</entry><entry>ano</entry><entry>00 à 99</entry> </row> <row> - <entry ->%A</entry -><entry ->ano</entry -><entry ->0001 à 9999</entry> + <entry>%A</entry><entry>ano</entry><entry>0001 à 9999</entry> </row> </tbody> </tgroup> </table> <table> - <title ->Mês</title> + <title>Mês</title> <tgroup cols="3"> <thead> <row> - <entry ->Formato</entry -><entry ->Significado</entry -><entry ->Intervalo</entry> + <entry>Formato</entry><entry>Significado</entry><entry>Intervalo</entry> </row> </thead> <tbody> <row> - <entry ->%m</entry -><entry ->mês do ano</entry -><entry ->01 à 12</entry> + <entry>%m</entry><entry>mês do ano</entry><entry>01 à 12</entry> </row> <row> - <entry ->%f</entry -><entry ->mês do ano</entry -><entry ->1 à 12</entry> + <entry>%f</entry><entry>mês do ano</entry><entry>1 à 12</entry> </row> <row> - <entry ->%b,%h</entry -><entry ->abreviatura do mês</entry -><entry ->Jan à Dez</entry> + <entry>%b,%h</entry><entry>abreviatura do mês</entry><entry>Jan à Dez</entry> </row> </tbody> </tgroup> </table> <table> - <title ->Dia</title> + <title>Dia</title> <tgroup cols="3"> <thead> <row> - <entry ->Formato</entry -><entry ->Significado</entry -><entry ->Intervalo</entry> + <entry>Formato</entry><entry>Significado</entry><entry>Intervalo</entry> </row> </thead> <tbody> <row> - <entry ->%j</entry -><entry ->dia do ano</entry -><entry ->001 à 366</entry> + <entry>%j</entry><entry>dia do ano</entry><entry>001 à 366</entry> </row> <row> - <entry ->%d</entry -><entry ->dia do mês</entry -><entry ->01 à 31</entry> + <entry>%d</entry><entry>dia do mês</entry><entry>01 à 31</entry> </row> <row> - <entry ->%e</entry -><entry ->dia do mês</entry -><entry ->1 à 31</entry> + <entry>%e</entry><entry>dia do mês</entry><entry>1 à 31</entry> </row> <row> - <entry ->%a</entry -><entry ->abreviatura do dia da semana</entry -><entry ->Dom à Sab</entry> + <entry>%a</entry><entry>abreviatura do dia da semana</entry><entry>Dom à Sab</entry> </row> </tbody> </tgroup> </table> <table> - <title ->Hora</title> + <title>Hora</title> <tgroup cols="3"> <thead> <row> - <entry ->Formato</entry -><entry ->Significado</entry -><entry ->Intervalo</entry> + <entry>Formato</entry><entry>Significado</entry><entry>Intervalo</entry> </row> </thead> <tbody> <row> - <entry ->%H</entry -><entry ->hora</entry -><entry ->00 à 23</entry> + <entry>%H</entry><entry>hora</entry><entry>00 à 23</entry> </row> <row> - <entry ->%k</entry -><entry ->hora</entry -><entry ->0 à 23</entry> + <entry>%k</entry><entry>hora</entry><entry>0 à 23</entry> </row> <row> - <entry ->%i</entry -><entry ->hora</entry -><entry ->1 à 12</entry> + <entry>%i</entry><entry>hora</entry><entry>1 à 12</entry> </row> <row> - <entry ->%I</entry -><entry ->hora</entry -><entry ->01 à 12</entry> + <entry>%I</entry><entry>hora</entry><entry>01 à 12</entry> </row> <row> - <entry ->%p</entry -><entry -></entry -><entry ->AM ou PM</entry> + <entry>%p</entry><entry></entry><entry>AM ou PM</entry> </row> </tbody> </tgroup> </table> <table> - <title ->Minuto, Segundo, Fuso Horário</title> + <title>Minuto, Segundo, Fuso Horário</title> <tgroup cols="3"> <thead> <row> - <entry ->Formato</entry -><entry ->Significado</entry -><entry ->Intervalo</entry> + <entry>Formato</entry><entry>Significado</entry><entry>Intervalo</entry> </row> </thead> <tbody> <row> - <entry ->%M</entry -><entry ->minuto</entry -><entry ->00 à 59</entry> + <entry>%M</entry><entry>minuto</entry><entry>00 à 59</entry> </row> <row> - <entry ->%S</entry -><entry ->segundo</entry -><entry ->00 à 59</entry> + <entry>%S</entry><entry>segundo</entry><entry>00 à 59</entry> </row> <row> - <entry ->%Z</entry -><entry ->fuso horário</entry -><entry ->(fornecido nas configurações de identidade)</entry> + <entry>%Z</entry><entry>fuso horário</entry><entry>(fornecido nas configurações de identidade)</entry> </row> <row> - <entry ->%z</entry -><entry ->fuso horário</entry -><entry ->(diferença numérica como especificada pelas configurações do sistema)</entry> + <entry>%z</entry><entry>fuso horário</entry><entry>(diferença numérica como especificada pelas configurações do sistema)</entry> </row> </tbody> </tgroup> </table> - </para -></listitem> + </para></listitem> </itemizedlist> -<note -><para ->A opção para selecionar o formato de datas para o arquivo <acronym ->PO</acronym -> considera-se desatualizada e, provavelmente, será removida numa versão futura do KBabel. </para -></note> - -<para ->O grupo inferior cobre as opções do arquivo <acronym ->PO</acronym -> ao salvar. Se você estiver trabalhando no projeto do &kde;, você precisa saber que pelo menos o arquivo <filename ->desktop.po</filename -> <emphasis ->precisa</emphasis -> de estar codificado em UTF-8. A lista permite-lhe selecionar a codificação das mensagens. Pelo menos, terá de constar a configuração referente ao seu idioma e o UTF-8. Se, por alguma razão, você não quiser mudar acidentalmente a codificação do arquivo PO, ative a opção <guibutton ->Manter a codificação do arquivo</guibutton ->.</para> - -<caution -><para ->Por razões de intercâmbio de informação, o 'gettext' da &GNU; limita as codificações permitidas para um arquivo <acronym ->PO</acronym ->. O &kbabel; ignora esta restrição, assim a codificação correspondente ao seu local poderá não ser adequada. (O UTF-8 é sempre suportado pelo 'gettext' da &GNU;.) </para -></caution> +<note><para>A opção para selecionar o formato de datas para o arquivo <acronym>PO</acronym> considera-se desatualizada e, provavelmente, será removida numa versão futura do KBabel. </para></note> + +<para>O grupo inferior cobre as opções do arquivo <acronym>PO</acronym> ao salvar. Se você estiver trabalhando no projeto do &kde;, você precisa saber que pelo menos o arquivo <filename>desktop.po</filename> <emphasis>precisa</emphasis> de estar codificado em UTF-8. A lista permite-lhe selecionar a codificação das mensagens. Pelo menos, terá de constar a configuração referente ao seu idioma e o UTF-8. Se, por alguma razão, você não quiser mudar acidentalmente a codificação do arquivo PO, ative a opção <guibutton>Manter a codificação do arquivo</guibutton>.</para> + +<caution><para>Por razões de intercâmbio de informação, o 'gettext' da &GNU; limita as codificações permitidas para um arquivo <acronym>PO</acronym>. O &kbabel; ignora esta restrição, assim a codificação correspondente ao seu local poderá não ser adequada. (O UTF-8 é sempre suportado pelo 'gettext' da &GNU;.) </para></caution> </sect2> <sect2 id="preferences-project-spellcheck"> -<title ->Ortografia</title> +<title>Ortografia</title> -<para ->Esta configuração diz respeito ao &kbabel;.</para> +<para>Esta configuração diz respeito ao &kbabel;.</para> -<para ->Aqui você pode configurar suas preferências de ortografia. Isto é para o caso de você ter um arquivo de dicionário para seu idioma de tradução. Abaixo estão os ítens para a configuração considerada:</para> +<para>Aqui você pode configurar suas preferências de ortografia. Isto é para o caso de você ter um arquivo de dicionário para seu idioma de tradução. Abaixo estão os ítens para a configuração considerada:</para> <variablelist> <varlistentry> - <term -><guibutton ->Criar combinações de raiz/afixo não existentes no dicionário</guibutton -></term> - <listitem -><para ->Para novas palavras adicionadas ao seu dicionário pessoal, o motor de verificação ortográfica criará combinações de raiz/afixo para corresponder mais de uma palavra (variações). </para -></listitem> + <term><guibutton>Criar combinações de raiz/afixo não existentes no dicionário</guibutton></term> + <listitem><para>Para novas palavras adicionadas ao seu dicionário pessoal, o motor de verificação ortográfica criará combinações de raiz/afixo para corresponder mais de uma palavra (variações). </para></listitem> </varlistentry> <varlistentry> - <term -><guibutton ->Considerar palavras juntas como erros ortográficos</guibutton -></term> - <listitem -><para ->Se isto estiver ligado, palavras juntas são tratadas como erros. No entanto, algumas palavras são muito comuns no idioma Alemão, que possuem um grande número de palavras componentes, logo isto deve ser deixado desligado neste caso. </para -></listitem> + <term><guibutton>Considerar palavras juntas como erros ortográficos</guibutton></term> + <listitem><para>Se isto estiver ligado, palavras juntas são tratadas como erros. No entanto, algumas palavras são muito comuns no idioma Alemão, que possuem um grande número de palavras componentes, logo isto deve ser deixado desligado neste caso. </para></listitem> </varlistentry> <varlistentry> - <term -><guilabel ->Dicionário</guilabel -></term> - <listitem -><para ->Na lista você pode escolher qual dicionário usar. Observe que você deve instalar um dicionário apropriado para seu idioma. Verifique sua distribuição do ispell ou aspell para saber se existe um. </para -></listitem> + <term><guilabel>Dicionário</guilabel></term> + <listitem><para>Na lista você pode escolher qual dicionário usar. Observe que você deve instalar um dicionário apropriado para seu idioma. Verifique sua distribuição do ispell ou aspell para saber se existe um. </para></listitem> </varlistentry> <varlistentry> - <term -><guilabel ->Codificação</guilabel -></term> + <term><guilabel>Codificação</guilabel></term> <listitem> -<para ->Aqui você escolhe a codificação para seu texto. Esta opção é passada para o verificador ortográfico, e é usada como a codificação para seu dicionário de palavras. Veja a documentação do <ulink url="help:/tdespell" ->tdespell</ulink -> para mais detalhes. </para> -<note -><para ->A codificação aqui selecionada não está associada às codificações dos arquivos <acronym ->PO</acronym ->. Dependendo do verificador ortográfico (especialmente no caso do <command ->ispell</command ->), você poderá não ter grandes escolhas para a codificação. (Por exemplo, alguns idiomas da Europa Ocidental só poderão funcionar com o <command ->ispell</command ->, ao usar o ISO-8859-1.) </para -></note> +<para>Aqui você escolhe a codificação para seu texto. Esta opção é passada para o verificador ortográfico, e é usada como a codificação para seu dicionário de palavras. Veja a documentação do <ulink url="help:/tdespell">tdespell</ulink> para mais detalhes. </para> +<note><para>A codificação aqui selecionada não está associada às codificações dos arquivos <acronym>PO</acronym>. Dependendo do verificador ortográfico (especialmente no caso do <command>ispell</command>), você poderá não ter grandes escolhas para a codificação. (Por exemplo, alguns idiomas da Europa Ocidental só poderão funcionar com o <command>ispell</command>, ao usar o ISO-8859-1.) </para></note> </listitem> </varlistentry> <varlistentry> - <term -><guilabel ->Cliente</guilabel -></term> - <listitem -><para ->Programa de backend para usar na verificação ortográfico. Atualmente pode ser tanto o <command ->ispell</command -> (International Ispell) ou o aspell. </para -></listitem> + <term><guilabel>Cliente</guilabel></term> + <listitem><para>Programa de backend para usar na verificação ortográfico. Atualmente pode ser tanto o <command>ispell</command> (International Ispell) ou o aspell. </para></listitem> </varlistentry> <varlistentry> - <term -><guibutton ->Lembrar palavras ignoradas</guibutton -></term> - <listitem -><para ->Mantém uma memória das palavras ignoradas pelo usuário durante a verificação ortográfica dos arquivos <acronym ->PO</acronym ->. Isto é muito conveniente para ignorar as abreviaturas ou combinações estranhas de letras que você encontra em interfaces &GUI;. </para -></listitem> + <term><guibutton>Lembrar palavras ignoradas</guibutton></term> + <listitem><para>Mantém uma memória das palavras ignoradas pelo usuário durante a verificação ortográfica dos arquivos <acronym>PO</acronym>. Isto é muito conveniente para ignorar as abreviaturas ou combinações estranhas de letras que você encontra em interfaces &GUI;. </para></listitem> </varlistentry> <varlistentry> - <term -><guilabel ->Arquivo para armazenar as palavras ignoradas</guilabel -></term> - <listitem -><para ->Aqui você poderá indicar a localização do arquivo com as palavras ignoradas. Clique no ícone da pasta à direita do campo de texto. O valor padrão é o <filename ->$<envar ->HOME</envar ->/.trinity/share/apps/kbabel/spellignores</filename ->, em que a <filename ->$<envar ->HOME</envar -></filename -> é a sua pasta pessoal. </para -></listitem> + <term><guilabel>Arquivo para armazenar as palavras ignoradas</guilabel></term> + <listitem><para>Aqui você poderá indicar a localização do arquivo com as palavras ignoradas. Clique no ícone da pasta à direita do campo de texto. O valor padrão é o <filename>$<envar>HOME</envar>/.trinity/share/apps/kbabel/spellignores</filename>, em que a <filename>$<envar>HOME</envar></filename> é a sua pasta pessoal. </para></listitem> </varlistentry> </variablelist> </sect2> <sect2 id="preferences-project-source"> -<title ->Referência de origem</title> +<title>Referência de origem</title> -<para ->Esta configuração diz respeito ao &kbabel;.</para> +<para>Esta configuração diz respeito ao &kbabel;.</para> <screenshot> -<screeninfo ->Configurações do Projeto, referência da origem</screeninfo> +<screeninfo>Configurações do Projeto, referência da origem</screeninfo> <mediaobject> <imageobject> <imagedata fileref="pref_proj_source.png" format="PNG"/> </imageobject> -<textobject -><phrase ->Configurações do Projeto, referência da origem</phrase -></textobject> +<textobject><phrase>Configurações do Projeto, referência da origem</phrase></textobject> </mediaobject> </screenshot> -<para ->Esta janela serve para configurar a forma como o KBabel deverá construir a localização completa para cada referência de origem, referência essa que está descrita no comentário de cada item de um arquivo <acronym ->PO</acronym ->. </para> +<para>Esta janela serve para configurar a forma como o KBabel deverá construir a localização completa para cada referência de origem, referência essa que está descrita no comentário de cada item de um arquivo <acronym>PO</acronym>. </para> <sect3> -<title ->Elementos da janela</title> - -<para ->No campo de texto <guilabel ->Pasta base do código-fonte</guilabel ->, você poderá definir uma pasta base onde se encontra o código-fonte do seu projeto. Isto define o valor da variável <userinput ->@CODEROOT@</userinput ->, que está descrito abaixo. </para> - -<para ->No grupo de <guilabel ->Padrões de Localização</guilabel ->, você poderá definir padrões ou regras para construir as localizações, com a ajuda de algumas variáveis: a <userinput ->@CODEROOT@</userinput ->, a <userinput ->@PACKAGEDIR@</userinput ->, a <userinput ->@PACKAGE@</userinput ->, a <userinput ->@COMMENTPATH@</userinput ->, a <userinput ->@POFILEDIR@</userinput ->, que estão descritas abaixo. </para> - -<note -><para ->A variável <userinput ->@PODIRFILE@</userinput -> foi introduzida no &kbabel; versão 1.11.1 (para o &kde; 3.5.1). </para -></note> - -<para ->Com o botão <guibutton ->Adicionar</guibutton ->, você poderá acrescentar a linha do campo de texto à lista de padrões usados. Com o botão <guibutton ->Remover</guibutton ->, poderá retirar o padrão selecionado da lista. Com os botões <guibutton ->Subir</guibutton -> e <guibutton ->Descer</guibutton ->, você poderá alterar a prioridade dos padrões de localizações. </para> +<title>Elementos da janela</title> + +<para>No campo de texto <guilabel>Pasta base do código-fonte</guilabel>, você poderá definir uma pasta base onde se encontra o código-fonte do seu projeto. Isto define o valor da variável <userinput>@CODEROOT@</userinput>, que está descrito abaixo. </para> + +<para>No grupo de <guilabel>Padrões de Localização</guilabel>, você poderá definir padrões ou regras para construir as localizações, com a ajuda de algumas variáveis: a <userinput>@CODEROOT@</userinput>, a <userinput>@PACKAGEDIR@</userinput>, a <userinput>@PACKAGE@</userinput>, a <userinput>@COMMENTPATH@</userinput>, a <userinput>@POFILEDIR@</userinput>, que estão descritas abaixo. </para> + +<note><para>A variável <userinput>@PODIRFILE@</userinput> foi introduzida no &kbabel; versão 1.11.1 (para o &kde; 3.5.1). </para></note> + +<para>Com o botão <guibutton>Adicionar</guibutton>, você poderá acrescentar a linha do campo de texto à lista de padrões usados. Com o botão <guibutton>Remover</guibutton>, poderá retirar o padrão selecionado da lista. Com os botões <guibutton>Subir</guibutton> e <guibutton>Descer</guibutton>, você poderá alterar a prioridade dos padrões de localizações. </para> </sect3> <sect3> -<title ->As variáveis</title> +<title>As variáveis</title> <itemizedlist> -<listitem -><para -><userinput ->@CODEROOT@</userinput ->: A pasta base do código-fonte. </para -></listitem> -<listitem -><para -><userinput ->@PACKAGEDIR@</userinput ->: A pasta do pacote (i.e., do arquivo <acronym ->PO</acronym ->). </para -></listitem> -<listitem -><para -><userinput ->@PACKAGE@</userinput ->: O nome do pacote (i.e. nome do arquivo <acronym ->PO</acronym -> sem extensão). </para -></listitem> -<listitem -><para -><userinput ->@POFILEDIR@</userinput ->: A pasta do arquivo <acronym ->PO</acronym ->. </para -></listitem> -<listitem -><para -><userinput ->@COMMENTPATH@</userinput ->: O local relativo, dado como referência de origem no comentário de um item do arquivo <acronym ->PO</acronym ->. </para -></listitem> +<listitem><para><userinput>@CODEROOT@</userinput>: A pasta base do código-fonte. </para></listitem> +<listitem><para><userinput>@PACKAGEDIR@</userinput>: A pasta do pacote (i.e., do arquivo <acronym>PO</acronym>). </para></listitem> +<listitem><para><userinput>@PACKAGE@</userinput>: O nome do pacote (i.e. nome do arquivo <acronym>PO</acronym> sem extensão). </para></listitem> +<listitem><para><userinput>@POFILEDIR@</userinput>: A pasta do arquivo <acronym>PO</acronym>. </para></listitem> +<listitem><para><userinput>@COMMENTPATH@</userinput>: O local relativo, dado como referência de origem no comentário de um item do arquivo <acronym>PO</acronym>. </para></listitem> </itemizedlist> -<important -><para ->As variáveis <userinput ->@PACKAGEDIR@</userinput -> e <userinput ->@POFILEDIR@</userinput -> possuem um significado semelhante, mas nem sempre o mesmo resultado. A variável <userinput ->@POFILEDIR@</userinput -> terá sempre a pasta do arquivo <acronym ->PO</acronym ->, enquanto o <userinput ->@PACKAGEDIR@</userinput -> poderá não ter. Se o arquivo <acronym ->PO</acronym -> foi carregado com a ajuda do &catalogmanager;, o <userinput ->@PACKAGEDIR@</userinput -> terá só a parte da pasta, com base na pasta de base do <acronym ->PO</acronym ->, definida para o &catalogmanager; <link linkend="preferences-project-folders" ->(veja abaixo)</link ->. </para -></important> - -<note -><para ->As variáveis <userinput ->@CODEROOT@</userinput -> e <userinput ->@POFILEDIR@</userinput -> só poderão ser usados no início de um padrão para serem úteis. A variável <userinput ->@COMMENTPATH@</userinput -> só poderá ser usada no fim de um padrão, e é praticamente obrigatória. As variáveis <userinput ->@PACKAGEDIR@</userinput -> e <userinput ->@POFILEDIR@</userinput -> não deverão ser usadas no mesmo padrão. As variáveis <userinput ->@CODEROOT@</userinput -> e <userinput ->@POFILEDIR@</userinput -> também não deverão ser usados no mesmo padrão. </para -></note> +<important><para>As variáveis <userinput>@PACKAGEDIR@</userinput> e <userinput>@POFILEDIR@</userinput> possuem um significado semelhante, mas nem sempre o mesmo resultado. A variável <userinput>@POFILEDIR@</userinput> terá sempre a pasta do arquivo <acronym>PO</acronym>, enquanto o <userinput>@PACKAGEDIR@</userinput> poderá não ter. Se o arquivo <acronym>PO</acronym> foi carregado com a ajuda do &catalogmanager;, o <userinput>@PACKAGEDIR@</userinput> terá só a parte da pasta, com base na pasta de base do <acronym>PO</acronym>, definida para o &catalogmanager; <link linkend="preferences-project-folders">(veja abaixo)</link>. </para></important> + +<note><para>As variáveis <userinput>@CODEROOT@</userinput> e <userinput>@POFILEDIR@</userinput> só poderão ser usados no início de um padrão para serem úteis. A variável <userinput>@COMMENTPATH@</userinput> só poderá ser usada no fim de um padrão, e é praticamente obrigatória. As variáveis <userinput>@PACKAGEDIR@</userinput> e <userinput>@POFILEDIR@</userinput> não deverão ser usadas no mesmo padrão. As variáveis <userinput>@CODEROOT@</userinput> e <userinput>@POFILEDIR@</userinput> também não deverão ser usados no mesmo padrão. </para></note> </sect3> <sect3> -<title ->Os padrões de localizações pré-definidos</title> +<title>Os padrões de localizações pré-definidos</title> -<para ->Desde o &kbabel; 1.11.1 (do &kde; 3.5.1), passaram a existir cinco padrões de localizações pré-definidos: </para> +<para>Desde o &kbabel; 1.11.1 (do &kde; 3.5.1), passaram a existir cinco padrões de localizações pré-definidos: </para> <itemizedlist> -<listitem -><para -><userinput ->@PACKAGEDIR@</userinput ->/<userinput ->@PACKAGE@</userinput ->/<userinput ->@COMMENTPATH@</userinput -> </para -></listitem> -<listitem -><para -><userinput ->@CODEROOT@</userinput ->/<userinput ->@PACKAGEDIR@</userinput ->/<userinput ->@PACKAGE@</userinput ->/<userinput ->@COMMENTPATH@</userinput -> </para -></listitem> -<listitem -><para -><userinput ->@CODEROOT@</userinput ->/<userinput ->@PACKAGE@</userinput ->/<userinput ->@COMMENTPATH@</userinput -> </para -></listitem> -<listitem -><para -><userinput ->@POFILEDIR@</userinput ->/<userinput ->@COMMENTPATH@</userinput -> </para -></listitem> -<listitem -><para -><userinput ->@POFILEDIR@</userinput ->/../<userinput ->@COMMENTPATH@</userinput -> </para -></listitem> +<listitem><para><userinput>@PACKAGEDIR@</userinput>/<userinput>@PACKAGE@</userinput>/<userinput>@COMMENTPATH@</userinput> </para></listitem> +<listitem><para><userinput>@CODEROOT@</userinput>/<userinput>@PACKAGEDIR@</userinput>/<userinput>@PACKAGE@</userinput>/<userinput>@COMMENTPATH@</userinput> </para></listitem> +<listitem><para><userinput>@CODEROOT@</userinput>/<userinput>@PACKAGE@</userinput>/<userinput>@COMMENTPATH@</userinput> </para></listitem> +<listitem><para><userinput>@POFILEDIR@</userinput>/<userinput>@COMMENTPATH@</userinput> </para></listitem> +<listitem><para><userinput>@POFILEDIR@</userinput>/../<userinput>@COMMENTPATH@</userinput> </para></listitem> </itemizedlist> -<note -><para ->Os projetos do &kde; necessitam tipicamente do terceiro padrão. O último padrão é típico dos projetos da &GNU;, onde as referências de origem são relacionadas com o pai da pasta em que se encontra o arquivo PO. </para -></note> +<note><para>Os projetos do &kde; necessitam tipicamente do terceiro padrão. O último padrão é típico dos projetos da &GNU;, onde as referências de origem são relacionadas com o pai da pasta em que se encontra o arquivo PO. </para></note> </sect3> <sect3> -<title ->Criando Novos Padrões de Localização</title> - -<para ->Na maioria dos casos, os padrões de localização pré-definidos deverão ser suficientes, quer o projeto seja para o KDE (assumindo que tenha definido a pasta de base correta) quer se for um da &GNU; (ou com uma estrutura de projeto da &GNU;). </para> - -<note -><para ->No caso do &kde;, alguns arquivos <acronym ->PO</acronym -> não possuem informações suficientes (incluindo o local e o nome do arquivo) do &kbabel; para encontrar o arquivo de origem correto que supostamente referencia. Para corrigir isso, você precisará de padrões de localizações precisos para esses arquivos, o que é praticamente impossível de definir, pela quantidade destes arquivos no &kde;. Mas se lidar freqüentemente com um desses arquivos, poderá valer a pena definir um padrão de localização explicitamente para suportar esse arquivo <acronym ->PO</acronym ->. </para -></note> - -<para ->Para criar os seus próprios padrões de localizações, você poderá usar as variáveis definidas acima, se bem que, fora o <userinput ->@COMMENTPATH@</userinput ->, não existem mais variáveis obrigatórias. Para ser mais exato, o <userinput ->@COMMENTPATH@</userinput -> também não é obrigatório, mas se não usá-lo, provavelmente não irá obter resultados.) </para> - -<para ->Um exemplo de padrões de localizações poderá ocorrer quando você desejar mostrar a referência de origem do arquivo do &kde; 'desktop_tdebase.po'. No caso de necessitar de um padrão de localizações do tipo: <userinput ->@CODEROOT@</userinput ->/<userinput ->@PACKAGEDIR@</userinput ->/tdebase/<userinput ->@COMMENTPATH@</userinput -> (em comparação com um dos padrões de localização pré-definidos, a seqüência <userinput ->@PACKAGE@</userinput -> foi substituída por 'tdebase'). </para> - -<para ->No caso de problemas realmente complexos você poderá, obviamente, definir uma localização absoluta sem quaisquer variáveis, além da <userinput ->@COMMENTPATH@</userinput ->, como por exemplo: '/home/usuario/codigo-kde/tdebase/<userinput ->@COMMENTPATH@</userinput ->', assumindo que a '/home/usuario/codigo-kde/tdebase' é o local onde o módulo de código 'tdebase' se encontra. </para> +<title>Criando Novos Padrões de Localização</title> + +<para>Na maioria dos casos, os padrões de localização pré-definidos deverão ser suficientes, quer o projeto seja para o KDE (assumindo que tenha definido a pasta de base correta) quer se for um da &GNU; (ou com uma estrutura de projeto da &GNU;). </para> + +<note><para>No caso do &kde;, alguns arquivos <acronym>PO</acronym> não possuem informações suficientes (incluindo o local e o nome do arquivo) do &kbabel; para encontrar o arquivo de origem correto que supostamente referencia. Para corrigir isso, você precisará de padrões de localizações precisos para esses arquivos, o que é praticamente impossível de definir, pela quantidade destes arquivos no &kde;. Mas se lidar freqüentemente com um desses arquivos, poderá valer a pena definir um padrão de localização explicitamente para suportar esse arquivo <acronym>PO</acronym>. </para></note> + +<para>Para criar os seus próprios padrões de localizações, você poderá usar as variáveis definidas acima, se bem que, fora o <userinput>@COMMENTPATH@</userinput>, não existem mais variáveis obrigatórias. Para ser mais exato, o <userinput>@COMMENTPATH@</userinput> também não é obrigatório, mas se não usá-lo, provavelmente não irá obter resultados.) </para> + +<para>Um exemplo de padrões de localizações poderá ocorrer quando você desejar mostrar a referência de origem do arquivo do &kde; 'desktop_tdebase.po'. No caso de necessitar de um padrão de localizações do tipo: <userinput>@CODEROOT@</userinput>/<userinput>@PACKAGEDIR@</userinput>/tdebase/<userinput>@COMMENTPATH@</userinput> (em comparação com um dos padrões de localização pré-definidos, a seqüência <userinput>@PACKAGE@</userinput> foi substituída por 'tdebase'). </para> + +<para>No caso de problemas realmente complexos você poderá, obviamente, definir uma localização absoluta sem quaisquer variáveis, além da <userinput>@COMMENTPATH@</userinput>, como por exemplo: '/home/usuario/codigo-kde/tdebase/<userinput>@COMMENTPATH@</userinput>', assumindo que a '/home/usuario/codigo-kde/tdebase' é o local onde o módulo de código 'tdebase' se encontra. </para> </sect3> </sect2> <sect2 id="preferences-project-miscellaneous"> -<title ->Miscelânea</title> +<title>Miscelânea</title> -<para ->Esta configuração diz respeito ao &kbabel;.</para> +<para>Esta configuração diz respeito ao &kbabel;.</para> -<para ->A seção <guilabel ->Diversos</guilabel -> contém as opções do &kbabel; que não se encaixam em mais nenhum lugar. </para> +<para>A seção <guilabel>Diversos</guilabel> contém as opções do &kbabel; que não se encaixam em mais nenhum lugar. </para> <variablelist> <varlistentry> - <term -><guilabel ->Marca do acelerador de teclado</guilabel -></term> - <listitem -><para ->Aqui você pode selecionar seu próprio caracter para servir como indicador de acelerador de teclado numa &GUI;. Por padrão é o & (ampersand), mas em algumas ferramentas de programação isto pode variar. Por exemplo, nas traduções Gnome/GTK o caracter sublinhado <quote ->_</quote -> é a marca para o acelerador de teclado. </para -></listitem> + <term><guilabel>Marca do acelerador de teclado</guilabel></term> + <listitem><para>Aqui você pode selecionar seu próprio caracter para servir como indicador de acelerador de teclado numa &GUI;. Por padrão é o & (ampersand), mas em algumas ferramentas de programação isto pode variar. Por exemplo, nas traduções Gnome/GTK o caracter sublinhado <quote>_</quote> é a marca para o acelerador de teclado. </para></listitem> </varlistentry> <varlistentry> - <term -><guilabel ->Expressão regular para informação de contexto</guilabel -></term> - <listitem -><para ->Para usuários inexperientes "expressão regular" pode soar estranho. No entanto, você será alertado para mudar o valor padrão somente se você souber o que está fazendo. Algumas ferramentas de programação de &GUI; fornecem seus próprios métodos de descrição de informações de contexto. Consulte um desenvolvedor experiente se você traduz arquivos <acronym ->PO</acronym -> diferentes dos arquivos &kde; padrão. Para ser mais exato eu "traduzirei" para você o que a expressão regular padrão significa: "o texto corresponde se ele inicia com _: e é seguido por um ou mais caracteres e termina com uma nova linha". </para -></listitem> + <term><guilabel>Expressão regular para informação de contexto</guilabel></term> + <listitem><para>Para usuários inexperientes "expressão regular" pode soar estranho. No entanto, você será alertado para mudar o valor padrão somente se você souber o que está fazendo. Algumas ferramentas de programação de &GUI; fornecem seus próprios métodos de descrição de informações de contexto. Consulte um desenvolvedor experiente se você traduz arquivos <acronym>PO</acronym> diferentes dos arquivos &kde; padrão. Para ser mais exato eu "traduzirei" para você o que a expressão regular padrão significa: "o texto corresponde se ele inicia com _: e é seguido por um ou mais caracteres e termina com uma nova linha". </para></listitem> </varlistentry> </variablelist> </sect2> @@ -1626,317 +689,122 @@ <!-- Catalog Manager project settings --> <sect2 id="preferences-project-folders"> -<title ->Pastas do projeto</title> +<title>Pastas do projeto</title> -<para ->Esta configuração diz respeito ao &catalogmanager;.</para> +<para>Esta configuração diz respeito ao &catalogmanager;.</para> -<para ->Aqui estão dois campos de texto com botões de pastas. Indique as pastas que contém todos os seus arquivos <acronym ->PO</acronym -> e os respectivos <acronym ->POT</acronym ->. Os arquivos e as pastas dentro dessas pastas serão então mesclados em uma árvore da janela do gerenciador de Catálogo. </para> +<para>Aqui estão dois campos de texto com botões de pastas. Indique as pastas que contém todos os seus arquivos <acronym>PO</acronym> e os respectivos <acronym>POT</acronym>. Os arquivos e as pastas dentro dessas pastas serão então mesclados em uma árvore da janela do gerenciador de Catálogo. </para> -<para ->Abaixo você pode tanto desligar como ligar: </para> +<para>Abaixo você pode tanto desligar como ligar: </para> <variablelist> <varlistentry> - <term -><guibutton ->Abrir arquivos numa nova janela</guibutton -></term> - <listitem -><para ->Se isto estiver ativado todos os arquivos que serão abertos a partir do Gerenciador de Catálogo serão abertos numa nova janela. </para -></listitem> + <term><guibutton>Abrir arquivos numa nova janela</guibutton></term> + <listitem><para>Se isto estiver ativado todos os arquivos que serão abertos a partir do Gerenciador de Catálogo serão abertos numa nova janela. </para></listitem> </varlistentry> <varlistentry> - <term -><guibutton ->Matar processos ao sair</guibutton -></term> - <listitem -><para ->Se você habilitar isto o &kbabel; tenta matar os processos que não foram terminados quando o programa fechar, enviando um sinal de kill para eles. <note -><para ->Isto não é uma garantia que os processos serão mortos. </para -></note> - </para -></listitem> + <term><guibutton>Matar processos ao sair</guibutton></term> + <listitem><para>Se você habilitar isto o &kbabel; tenta matar os processos que não foram terminados quando o programa fechar, enviando um sinal de kill para eles. <note><para>Isto não é uma garantia que os processos serão mortos. </para></note> + </para></listitem> </varlistentry> <varlistentry> - <term -><guibutton ->Criar índice para o conteúdo do arquivo</guibutton -></term> - <listitem -><para ->Se você habilitar isto o &kbabel; criará um índice para cada arquivo na árvore. Este índice é então usado nas operações de procura/substituição. <warning -><para ->Há uma grande velocidade nestas operações. Se você habilitar <guibutton ->Criar índice para conteúdo do arquivo</guibutton ->, a atualização das informações dos arquivos será bem menor. Por outro lado, as operações de procura/substituição aumentam de velocidade consideravelmente.</para -></warning> - </para -></listitem> + <term><guibutton>Criar índice para o conteúdo do arquivo</guibutton></term> + <listitem><para>Se você habilitar isto o &kbabel; criará um índice para cada arquivo na árvore. Este índice é então usado nas operações de procura/substituição. <warning><para>Há uma grande velocidade nestas operações. Se você habilitar <guibutton>Criar índice para conteúdo do arquivo</guibutton>, a atualização das informações dos arquivos será bem menor. Por outro lado, as operações de procura/substituição aumentam de velocidade consideravelmente.</para></warning> + </para></listitem> </varlistentry> </variablelist> </sect2> <sect2 id="preferences-project-folder-commands"> -<title ->Comandos de Pasta</title> +<title>Comandos de Pasta</title> -<para ->Esta configuração diz respeito ao &catalogmanager;.</para> +<para>Esta configuração diz respeito ao &catalogmanager;.</para> <screenshot> -<screeninfo ->Configurações do Projeto, comandos de pastas</screeninfo> +<screeninfo>Configurações do Projeto, comandos de pastas</screeninfo> <mediaobject> <imageobject> <imagedata fileref="pref_proj_folder_commands.png" format="PNG"/> </imageobject> -<textobject -><phrase ->Configurações do Projeto, comandos de pastas</phrase -></textobject> +<textobject><phrase>Configurações do Projeto, comandos de pastas</phrase></textobject> </mediaobject> </screenshot> -<para ->Aqui você pode inserir comandos que você deseja executar nas pastas do Gerenciador de Catálogo. Os comandos são mostrados no submenu <menuchoice -><guimenuitem ->Comandos</guimenuitem -></menuchoice -> no menu de contexto do Gerenciador de Catálogo. </para -><para ->Insira no campo <guilabel ->Legenda do Comando</guilabel -> o nome do comando. O nome poderá ser escolhido livremente e só é usado para ser apresentado no menu. No campo <guilabel ->Comando</guilabel ->, insira o comando que você deseja executar quando selecionar o item de menu correspondente. Clique depois no botão <guibutton ->Adicionar</guibutton -> para adicionar o comando aos já disponíveis. Para editar um comando, selecione-o, clique em <guibutton ->Editar</guibutton -> e depois em <guibutton ->Adicionar</guibutton ->, depois de ter terminado. Para remover um comando, selecione-o na lista e clique no botão <guibutton ->Remover</guibutton ->. Se você quiser uma ordem diferente no sub-menu de contexto, você poderá usar os botões para subir e descer. </para -><para ->O comando é executado pelo seu shell padrão, logo você pode executar comandos múltiplos ao mesmo tempo separando-os com um ponto e vírgula, e você pode configurar variáveis de ambiente, se necessário. Os comandos são executados na pasta (de arquivo <acronym ->PO</acronym ->) pasta que você selecionar no Gerenciador de Catálogo. </para -><para ->Os seguintes strings serão substituídos num comando: </para> +<para>Aqui você pode inserir comandos que você deseja executar nas pastas do Gerenciador de Catálogo. Os comandos são mostrados no submenu <menuchoice><guimenuitem>Comandos</guimenuitem></menuchoice> no menu de contexto do Gerenciador de Catálogo. </para><para>Insira no campo <guilabel>Legenda do Comando</guilabel> o nome do comando. O nome poderá ser escolhido livremente e só é usado para ser apresentado no menu. No campo <guilabel>Comando</guilabel>, insira o comando que você deseja executar quando selecionar o item de menu correspondente. Clique depois no botão <guibutton>Adicionar</guibutton> para adicionar o comando aos já disponíveis. Para editar um comando, selecione-o, clique em <guibutton>Editar</guibutton> e depois em <guibutton>Adicionar</guibutton>, depois de ter terminado. Para remover um comando, selecione-o na lista e clique no botão <guibutton>Remover</guibutton>. Se você quiser uma ordem diferente no sub-menu de contexto, você poderá usar os botões para subir e descer. </para><para>O comando é executado pelo seu shell padrão, logo você pode executar comandos múltiplos ao mesmo tempo separando-os com um ponto e vírgula, e você pode configurar variáveis de ambiente, se necessário. Os comandos são executados na pasta (de arquivo <acronym>PO</acronym>) pasta que você selecionar no Gerenciador de Catálogo. </para><para>Os seguintes strings serão substituídos num comando: </para> <itemizedlist> - <listitem -><para -><userinput ->@PACKAGE@</userinput ->: O nome da pasta sem caminho </para -></listitem> - <listitem -><para -><userinput ->@PODIR@</userinput ->: O nome da pasta <userinput ->PO</userinput -> com caminho </para -></listitem> - <listitem -><para -><userinput ->@POTDIR@</userinput ->: O nome da pasta de modelos com caminho </para -></listitem> + <listitem><para><userinput>@PACKAGE@</userinput>: O nome da pasta sem caminho </para></listitem> + <listitem><para><userinput>@PODIR@</userinput>: O nome da pasta <userinput>PO</userinput> com caminho </para></listitem> + <listitem><para><userinput>@POTDIR@</userinput>: O nome da pasta de modelos com caminho </para></listitem> </itemizedlist> -<para ->Por exemplo: Se você deseja executar <command ->make</command -> e então <command ->make install</command -> você pode inserir <userinput ->Make install</userinput -> no campo <guilabel ->Nome</guilabel ->, e <userinput ->make; make install</userinput -> no campo <guilabel ->Comando</guilabel ->. Se você então selecionar <menuchoice -><guimenuitem ->Comandos</guimenuitem -><guimenuitem ->Make install</guimenuitem -></menuchoice -> no menu de contexto para uma pasta, o comando listado acima será executado nesta pasta. </para> +<para>Por exemplo: Se você deseja executar <command>make</command> e então <command>make install</command> você pode inserir <userinput>Make install</userinput> no campo <guilabel>Nome</guilabel>, e <userinput>make; make install</userinput> no campo <guilabel>Comando</guilabel>. Se você então selecionar <menuchoice><guimenuitem>Comandos</guimenuitem><guimenuitem>Make install</guimenuitem></menuchoice> no menu de contexto para uma pasta, o comando listado acima será executado nesta pasta. </para> </sect2> <sect2 id="preferences-project-file-commands"> -<title ->Comandos de Arquivo</title> +<title>Comandos de Arquivo</title> -<para ->Esta configuração diz respeito ao &catalogmanager;.</para> +<para>Esta configuração diz respeito ao &catalogmanager;.</para> <screenshot> -<screeninfo ->Configurações do Projeto, comandos de arquivos</screeninfo> +<screeninfo>Configurações do Projeto, comandos de arquivos</screeninfo> <mediaobject> <imageobject> <imagedata fileref="pref_proj_file_commands.png" format="PNG"/> </imageobject> -<textobject -><phrase ->Configurações do Projeto, comandos de arquivos</phrase -></textobject> +<textobject><phrase>Configurações do Projeto, comandos de arquivos</phrase></textobject> </mediaobject> </screenshot> -<para ->Aqui você pode inserir os comandos que você deseja executar em arquivos a partir do Gerenciador de Catálogo. Os comandos são então mostrados no submenu <menuchoice -><guimenuitem ->Comandos</guimenuitem -></menuchoice -> no menu de contexto do Gerenciador de Catálogo. </para> - -<para ->Insira no campo <guilabel ->Legenda do Comando</guilabel -> o nome do comando. O nome poderá ser escolhido livremente e só é usado para ser apresentado no menu. No campo <guilabel ->Comando</guilabel ->, introduza o comando que você deseja executar quando selecionar o item de menu correspondente. Clique depois no botão <guibutton ->Adicionar</guibutton -> para adicionar o comando aos já disponíveis. Para editar um comando, selecione-o, clique em <guibutton ->Editar</guibutton -> e depois em <guibutton ->Adicionar</guibutton ->, depois de ter terminado. Para remover um comando, selecione-o na lista e clique no botão <guibutton ->Remover</guibutton ->. Se você quiser uma ordem diferente no menu de contexto, você poderá usar os botões para subir e descer. </para -><para ->O comando é executado pelo seu shell padrão, logo você pode executar comandos múltiplos ao mesmo tempo separando-os com um ponto e vírgula, e você pode configurar variáveis de ambiente, se necessário. Os comandos são executados na pasta (de arquivo <acronym ->PO</acronym ->) que você selecionar no Gerenciador de Catálogo. </para -><para ->Os seguintes strings serão substituídos num comando: </para> +<para>Aqui você pode inserir os comandos que você deseja executar em arquivos a partir do Gerenciador de Catálogo. Os comandos são então mostrados no submenu <menuchoice><guimenuitem>Comandos</guimenuitem></menuchoice> no menu de contexto do Gerenciador de Catálogo. </para> + +<para>Insira no campo <guilabel>Legenda do Comando</guilabel> o nome do comando. O nome poderá ser escolhido livremente e só é usado para ser apresentado no menu. No campo <guilabel>Comando</guilabel>, introduza o comando que você deseja executar quando selecionar o item de menu correspondente. Clique depois no botão <guibutton>Adicionar</guibutton> para adicionar o comando aos já disponíveis. Para editar um comando, selecione-o, clique em <guibutton>Editar</guibutton> e depois em <guibutton>Adicionar</guibutton>, depois de ter terminado. Para remover um comando, selecione-o na lista e clique no botão <guibutton>Remover</guibutton>. Se você quiser uma ordem diferente no menu de contexto, você poderá usar os botões para subir e descer. </para><para>O comando é executado pelo seu shell padrão, logo você pode executar comandos múltiplos ao mesmo tempo separando-os com um ponto e vírgula, e você pode configurar variáveis de ambiente, se necessário. Os comandos são executados na pasta (de arquivo <acronym>PO</acronym>) que você selecionar no Gerenciador de Catálogo. </para><para>Os seguintes strings serão substituídos num comando: </para> <itemizedlist> - <listitem -><para -><userinput ->@PACKAGE@</userinput ->: O nome do arquivo sem caminho e extensão </para -></listitem> - <listitem -><para -><userinput ->@POFILE@</userinput ->: O nome do arquivo <userinput ->PO</userinput -> com caminho e extensão </para -></listitem> - <listitem -><para -><userinput ->@POTFILE@</userinput ->: O nome do arquivo de modelo correspondente com caminho e extensão </para -></listitem> - <listitem -><para -><userinput ->@PODIR@</userinput ->: O nome da pasta, onde arquivo <userinput ->PO</userinput -> está, com caminho </para -></listitem> - <listitem -><para -><userinput ->@POTDIR@</userinput ->: O nome da pasta, onde o arquivo modelo está, com caminho </para -></listitem> + <listitem><para><userinput>@PACKAGE@</userinput>: O nome do arquivo sem caminho e extensão </para></listitem> + <listitem><para><userinput>@POFILE@</userinput>: O nome do arquivo <userinput>PO</userinput> com caminho e extensão </para></listitem> + <listitem><para><userinput>@POTFILE@</userinput>: O nome do arquivo de modelo correspondente com caminho e extensão </para></listitem> + <listitem><para><userinput>@PODIR@</userinput>: O nome da pasta, onde arquivo <userinput>PO</userinput> está, com caminho </para></listitem> + <listitem><para><userinput>@POTDIR@</userinput>: O nome da pasta, onde o arquivo modelo está, com caminho </para></listitem> </itemizedlist> -<para ->Por exemplo, se você deseja mesclar o arquivo modelo em seu arquivo <acronym ->PO</acronym -> você pode inserir no campo <guilabel ->Nome</guilabel -> <userinput ->Mesclar</userinput -> e no campo <guilabel ->Comando</guilabel -> <userinput ->msgmerge @POFILE@ @POTFILE@ > @PACKAGE@.new && mv @PACKAGE@.new "@PACKAGE@.po</userinput ->. Se você então selecionar <menuchoice -><guimenuitem ->Comandos</guimenuitem -><guimenuitem ->Mesclar</guimenuitem -></menuchoice -> no menu de contexto do arquivo, o arquivo <acronym ->PO</acronym -> será mesclado com seu arquivo de modelo. </para> +<para>Por exemplo, se você deseja mesclar o arquivo modelo em seu arquivo <acronym>PO</acronym> você pode inserir no campo <guilabel>Nome</guilabel> <userinput>Mesclar</userinput> e no campo <guilabel>Comando</guilabel> <userinput>msgmerge @POFILE@ @POTFILE@ > @PACKAGE@.new && mv @PACKAGE@.new "@PACKAGE@.po</userinput>. Se você então selecionar <menuchoice><guimenuitem>Comandos</guimenuitem><guimenuitem>Mesclar</guimenuitem></menuchoice> no menu de contexto do arquivo, o arquivo <acronym>PO</acronym> será mesclado com seu arquivo de modelo. </para> </sect2> <sect2 id="preferences-project-catalog-manager"> -<title ->Gerenciador de Catálogos</title> +<title>Gerenciador de Catálogos</title> -<para ->Esta configuração diz respeito ao &catalogmanager;.</para> +<para>Esta configuração diz respeito ao &catalogmanager;.</para> <screenshot> -<screeninfo ->Configurações do Projeto, &catalogmanager;</screeninfo> +<screeninfo>Configurações do Projeto, &catalogmanager;</screeninfo> <mediaobject> <imageobject> <imagedata fileref="pref_proj_catman.png" format="PNG"/> </imageobject> -<textobject -><phrase ->Configurações do Projeto, &catalogmanager;</phrase -></textobject> +<textobject><phrase>Configurações do Projeto, &catalogmanager;</phrase></textobject> </mediaobject> </screenshot> -<para ->As opções ativam ou desativam a coluna correspondente à área do &catalogmanager;.</para> +<para>As opções ativam ou desativam a coluna correspondente à área do &catalogmanager;.</para> </sect2> <sect2 id="preferences-project-diff"> -<title ->Diferenças</title> +<title>Diferenças</title> -<para ->Esta configuração diz respeito ao &catalogmanager;.</para> +<para>Esta configuração diz respeito ao &catalogmanager;.</para> <screenshot> -<screeninfo ->Configurações do Projeto, diferenças</screeninfo> +<screeninfo>Configurações do Projeto, diferenças</screeninfo> <mediaobject> <imageobject> <imagedata fileref="pref_proj_diff.png" format="PNG"/> </imageobject> -<textobject -><phrase ->Configurações do Projeto, diferenças</phrase -></textobject> +<textobject><phrase>Configurações do Projeto, diferenças</phrase></textobject> </mediaobject> </screenshot> -<para -><remark ->A FAZER</remark -></para> +<para><remark>A FAZER</remark></para> </sect2> diff --git a/tde-i18n-pt_BR/docs/tdesdk/kbabel/using.docbook b/tde-i18n-pt_BR/docs/tdesdk/kbabel/using.docbook index 757315f8b2e..b8f0e2ed583 100644 --- a/tde-i18n-pt_BR/docs/tdesdk/kbabel/using.docbook +++ b/tde-i18n-pt_BR/docs/tdesdk/kbabel/using.docbook @@ -1,6 +1,5 @@ <!-- <?xml version="1.0" ?> -<!DOCTYPE chapter PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" -> --> +<!DOCTYPE chapter PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd"> --> <!-- Uncomment the previous two lines to validate this document --> <!-- standalone. Be sure to recomment them before attempting to --> <!-- process index.docbook --> @@ -10,420 +9,160 @@ <!-- Fill in this section if this document has a different author --> <authorgroup> <author> -<personname -><firstname -></firstname -><surname -></surname -></personname> +<personname><firstname></firstname><surname></surname></personname> </author> </authorgroup> -<othercredit role="translator" -><firstname ->Marcus</firstname -><surname ->Gama</surname -><affiliation -><address -><email ->marcus.gama@gmail.com</email -></address -></affiliation -><contrib ->Tradução</contrib -></othercredit -> +<othercredit role="translator"><firstname>Marcus</firstname><surname>Gama</surname><affiliation><address><email>marcus.gama@gmail.com</email></address></affiliation><contrib>Tradução</contrib></othercredit> </chapterinfo> -<title ->Usando o &kbabel;</title> +<title>Usando o &kbabel;</title> <sect1 id="using-introduction"> -<title ->Introdução</title> +<title>Introdução</title> -<para ->Normalmente, as mensagens e a documentação do programa são escritas em inglês. Usando uma plataforma composta por um conjunto de ferramentas e bibliotecas, é possível ter as suas aplicações favoritas falando a sua língua não-inglesa nativa. Este processo de adaptar uma aplicação a um idioma específico é conhecido por 'localização'. O processo de localização inclui a tradução das interfaces e da documentação do programa para os vários idiomas que o usuário precisa e, em alguns países e regiões, adaptar os métodos de entrada e saída de dados para convenções especiais. O &kbabel; é uma ferramenta que o ajudará no processo de internacionalização para fazer com que a interface de uma aplicação fale várias línguas.</para> +<para>Normalmente, as mensagens e a documentação do programa são escritas em inglês. Usando uma plataforma composta por um conjunto de ferramentas e bibliotecas, é possível ter as suas aplicações favoritas falando a sua língua não-inglesa nativa. Este processo de adaptar uma aplicação a um idioma específico é conhecido por 'localização'. O processo de localização inclui a tradução das interfaces e da documentação do programa para os vários idiomas que o usuário precisa e, em alguns países e regiões, adaptar os métodos de entrada e saída de dados para convenções especiais. O &kbabel; é uma ferramenta que o ajudará no processo de internacionalização para fazer com que a interface de uma aplicação fale várias línguas.</para> -<para ->Cada aplicativo apto à internacionalização torna disponível para a tradução um ou mais arquivos de catálogos de mensagens. A extensão destes arquivo é <literal role="extension" ->.pot</literal ->. <acronym ->POT</acronym -> é um acrônimo para <quote ->Portable Object Template</quote -> (Modelo de Objeto Portável).</para> +<para>Cada aplicativo apto à internacionalização torna disponível para a tradução um ou mais arquivos de catálogos de mensagens. A extensão destes arquivo é <literal role="extension">.pot</literal>. <acronym>POT</acronym> é um acrônimo para <quote>Portable Object Template</quote> (Modelo de Objeto Portável).</para> -<para ->Cada tradutor retira uma cópia de um desses modelos <acronym ->POT</acronym -> e começa a preencher as mensagens em branco: cada mensagem é traduzida no idioma desejado. O arquivo que contém o texto traduzido é referido como sendo um arquivo <acronym ->PO</acronym -> (Portable Object - Objeto Portável). </para> +<para>Cada tradutor retira uma cópia de um desses modelos <acronym>POT</acronym> e começa a preencher as mensagens em branco: cada mensagem é traduzida no idioma desejado. O arquivo que contém o texto traduzido é referido como sendo um arquivo <acronym>PO</acronym> (Portable Object - Objeto Portável). </para> -<para ->Logo que todas as mensagens tenham sido traduzidas, o arquivo <acronym ->PO</acronym -> é compilado para um formato binário, conhecido como um arquivo <acronym ->MO</acronym -> (Machine Object - Objeto da Máquina). Estes arquivos, que serão salvos com uma extensão <literal role="extension" ->.mo</literal -> (ou uma extensão <literal role="extension" ->.gmo</literal ->), para mostrar que foram processados pelo 'gettext' da &GNU;), atuam como uma base de dados para minimizar o tempo ocupado pelas aplicações para procurar cada mensagem traduzida. </para> +<para>Logo que todas as mensagens tenham sido traduzidas, o arquivo <acronym>PO</acronym> é compilado para um formato binário, conhecido como um arquivo <acronym>MO</acronym> (Machine Object - Objeto da Máquina). Estes arquivos, que serão salvos com uma extensão <literal role="extension">.mo</literal> (ou uma extensão <literal role="extension">.gmo</literal>), para mostrar que foram processados pelo 'gettext' da &GNU;), atuam como uma base de dados para minimizar o tempo ocupado pelas aplicações para procurar cada mensagem traduzida. </para> -<para ->Isto leva a uma pergunta: eu preciso saber o que existe dentro de um arquivo <acronym ->PO</acronym ->, mesmo tendo o &kbabel;? A resposta é, sem dúvida, sim. Existem situações em que o catálogo de mensagens pode ficar corrompido e tenha de ser corrigido manualmente. A maioria destes problemas são os odiosos conflitos do <acronym ->CVS</acronym -> ou <acronym ->SVN</acronym -> que ocorrem quando um processo de tradução é coordenado por um sistema concorrente de controle de versões, como o <acronym ->CVS</acronym -> ou o Subversion (<acronym ->SVN</acronym ->). O &kbabel; não poderá ajudá-lo muito, se um destes problemas ocorrer, de modo que um editor de texto e algum conhecimento sobre os arquivos <acronym ->PO</acronym -> serão necessários. Vamos ver como se cria um arquivo <acronym ->PO</acronym ->.</para> +<para>Isto leva a uma pergunta: eu preciso saber o que existe dentro de um arquivo <acronym>PO</acronym>, mesmo tendo o &kbabel;? A resposta é, sem dúvida, sim. Existem situações em que o catálogo de mensagens pode ficar corrompido e tenha de ser corrigido manualmente. A maioria destes problemas são os odiosos conflitos do <acronym>CVS</acronym> ou <acronym>SVN</acronym> que ocorrem quando um processo de tradução é coordenado por um sistema concorrente de controle de versões, como o <acronym>CVS</acronym> ou o Subversion (<acronym>SVN</acronym>). O &kbabel; não poderá ajudá-lo muito, se um destes problemas ocorrer, de modo que um editor de texto e algum conhecimento sobre os arquivos <acronym>PO</acronym> serão necessários. Vamos ver como se cria um arquivo <acronym>PO</acronym>.</para> -<para ->Arquivos <acronym ->PO</acronym -> consistem de pares de mensagens—um <emphasis ->msgid</emphasis -> e um <emphasis ->msgstr</emphasis ->. A msgid é o texto em Inglês e a msgstr é o texto traduzido para o idioma apropriado. O texto que acompanha cada msgid e msgstr é colocado entre aspas duplas no estilo C. Um exemplo, obtido de um arquivo <acronym ->PO</acronym -> para o &noatun;, é <literal ->msgid "Open a Playlist"</literal -> </para> +<para>Arquivos <acronym>PO</acronym> consistem de pares de mensagens—um <emphasis>msgid</emphasis> e um <emphasis>msgstr</emphasis>. A msgid é o texto em Inglês e a msgstr é o texto traduzido para o idioma apropriado. O texto que acompanha cada msgid e msgstr é colocado entre aspas duplas no estilo C. Um exemplo, obtido de um arquivo <acronym>PO</acronym> para o &noatun;, é <literal>msgid "Open a Playlist"</literal> </para> <!-- ### TODO: we would need an example of an entry --> -<para ->As linhas em branco e as que começam por <literal ->#</literal -> são ignoradas. As linhas que começam por # representam comentários e são formas úteis de fornecer uma nota que detalhe o arquivo em que esta mensagem será usada e, no caso dos criadores das aplicações, para fornecer comentários adicionais para ajudar na tradução. O &kbabel; mostra estas linhas de comentários para cada mensagem.</para> +<para>As linhas em branco e as que começam por <literal>#</literal> são ignoradas. As linhas que começam por # representam comentários e são formas úteis de fornecer uma nota que detalhe o arquivo em que esta mensagem será usada e, no caso dos criadores das aplicações, para fornecer comentários adicionais para ajudar na tradução. O &kbabel; mostra estas linhas de comentários para cada mensagem.</para> -<para ->Em muitos casos o primeiro par de msgid-msgstr no arquivo <acronym ->PO</acronym -> é uma entrada falsa (agindo como um cabeçalho do arquivo <acronym ->PO</acronym ->) que contém várias informações sobre o arquivo <acronym ->PO</acronym -> traduzido, como o nome do aplicativo, data de tradução, nome do tradutor e assim por diante.</para> +<para>Em muitos casos o primeiro par de msgid-msgstr no arquivo <acronym>PO</acronym> é uma entrada falsa (agindo como um cabeçalho do arquivo <acronym>PO</acronym>) que contém várias informações sobre o arquivo <acronym>PO</acronym> traduzido, como o nome do aplicativo, data de tradução, nome do tradutor e assim por diante.</para> -<para ->Uma funcionalidade útil de internacionalização é chamada de <emphasis ->formas plurais</emphasis ->. O Inglês (e o Português) só usam o singular e uma única forma plural de nomes, ⪚ <quote ->1 arquivo </quote -> e <quote ->10 arquivos</quote ->. Isto leva a que muitos programadores pensem que o mundo é assim simples e que poderão usar mensagens do tipo <quote ->Do you want to delete %1 file(s)?</quote ->, onde o <literal ->%1</literal -> representa um conjunto de arquivos a remover. Isto é completamente errado. Na tradução para Eslovaco (por exemplo), você precisa de 3 formas diferentes da mensagem. Este número é diferente para os diferentes idiomas e mesmo quando o número é o mesmo, ⪚ o Checo usa também 3 formas, a regra que decide a forma a usar poderá ser muito diferente. As formas plurais nos arquivos <acronym ->PO</acronym -> estão aqui para ajudar. </para> +<para>Uma funcionalidade útil de internacionalização é chamada de <emphasis>formas plurais</emphasis>. O Inglês (e o Português) só usam o singular e uma única forma plural de nomes, ⪚ <quote>1 arquivo </quote> e <quote>10 arquivos</quote>. Isto leva a que muitos programadores pensem que o mundo é assim simples e que poderão usar mensagens do tipo <quote>Do you want to delete %1 file(s)?</quote>, onde o <literal>%1</literal> representa um conjunto de arquivos a remover. Isto é completamente errado. Na tradução para Eslovaco (por exemplo), você precisa de 3 formas diferentes da mensagem. Este número é diferente para os diferentes idiomas e mesmo quando o número é o mesmo, ⪚ o Checo usa também 3 formas, a regra que decide a forma a usar poderá ser muito diferente. As formas plurais nos arquivos <acronym>PO</acronym> estão aqui para ajudar. </para> -<note -><para ->Os programadores do &kde; escolheram uma implementação diferente para as formas plurais, em relação ao <application ->gettext da &GNU;</application -> e, por isso, introduziram o seu próprio formato e modo de tratamento das mensagens. Está planejado o uso das formas plurais do &GNU; gettext para o &kde; em sua versão 4. </para -></note> +<note><para>Os programadores do &kde; escolheram uma implementação diferente para as formas plurais, em relação ao <application>gettext da &GNU;</application> e, por isso, introduziram o seu próprio formato e modo de tratamento das mensagens. Está planejado o uso das formas plurais do &GNU; gettext para o &kde; em sua versão 4. </para></note> </sect1> <sect1 id="using-editor"> -<title ->Editor</title> +<title>Editor</title> -<para ->Aqui está uma imagem do &kbabel;.</para> +<para>Aqui está uma imagem do &kbabel;.</para> <screenshot> -<screeninfo ->Captura de tela do &kbabel;</screeninfo> +<screeninfo>Captura de tela do &kbabel;</screeninfo> <mediaobject> <imageobject> <imagedata fileref="snap1.png" format="PNG"/> </imageobject> -<textobject -><phrase ->Captura de tela do &kbabel;</phrase -></textobject> +<textobject><phrase>Captura de tela do &kbabel;</phrase></textobject> </mediaobject> </screenshot> -<para ->Por questões de conveniência, o &kbabel; possui barras de ferramentas para acelerar várias operações e, para os usuários ocupados, existem muitos atalhos de teclado. A janela principal divide-se em quatro partes. </para> +<para>Por questões de conveniência, o &kbabel; possui barras de ferramentas para acelerar várias operações e, para os usuários ocupados, existem muitos atalhos de teclado. A janela principal divide-se em quatro partes. </para> -<para ->A caixa de edição <emphasis ->superior-esquerda</emphasis -> é somente de leitura e contém o campo msgid atual do arquivo PO aberto e seu texto em Inglês.</para> +<para>A caixa de edição <emphasis>superior-esquerda</emphasis> é somente de leitura e contém o campo msgid atual do arquivo PO aberto e seu texto em Inglês.</para> -<para ->A caixa de edição <emphasis ->inferior-esquerda</emphasis -> contém o campo msgstr correspondente ao msgid mostrado e nela você pode editar o texto traduzido.</para> +<para>A caixa de edição <emphasis>inferior-esquerda</emphasis> contém o campo msgstr correspondente ao msgid mostrado e nela você pode editar o texto traduzido.</para> -<para ->A parte <emphasis ->superior-direita</emphasis -> da janela é um painel de comentários onde você pode ver os comentários adicionados para a entrada atualmente sendo editada.</para> +<para>A parte <emphasis>superior-direita</emphasis> da janela é um painel de comentários onde você pode ver os comentários adicionados para a entrada atualmente sendo editada.</para> -<para ->Ele pode ser usado:</para> +<para>Ele pode ser usado:</para> <itemizedlist> -<listitem -><para ->para descobrir como a mensagem atual é tratada pelo aplicativo (no estilo C ou simples) </para -></listitem> -<listitem -><para ->em alguns casos, para ler comentários úteis adicionados pelo desenvolvedor do aplicativo para auxiliar os tradutores em seu trabalho— por exemplo, podem ser dicas técnicas (usadas com grande efeito no projeto <application ->LyX</application ->) </para -></listitem> -<listitem -><para ->quando você precisa saber de qual arquivo uma mensagem vem porque você deseja informar um erro de ortografia no string original em Inglês. </para -></listitem> +<listitem><para>para descobrir como a mensagem atual é tratada pelo aplicativo (no estilo C ou simples) </para></listitem> +<listitem><para>em alguns casos, para ler comentários úteis adicionados pelo desenvolvedor do aplicativo para auxiliar os tradutores em seu trabalho— por exemplo, podem ser dicas técnicas (usadas com grande efeito no projeto <application>LyX</application>) </para></listitem> +<listitem><para>quando você precisa saber de qual arquivo uma mensagem vem porque você deseja informar um erro de ortografia no string original em Inglês. </para></listitem> </itemizedlist> -<para ->A janela do editor (na parte inferior direita) é a parte mais sofisticada da janela principal do &kbabel;. Seu tamanho pode ser ajustado usando a linha divisória entre ele e o painel de comentário (na parte superior direita). A janela do editor possui dois painéis de aba—essencialmente é uma pequena 'fotografia' do arquivo PO. Durante a tradução, é muito comum que strings de mensagem estejam relacionados com as mensagens anterior e posterior, logo o painel de contexto é útil para dar uma olhada nas mensagens próximas para obter uma dica de como a mensagem atual pode ser melhor traduzida. A tradução de interface de diálogo é um bom exemplo, ou widgets com seu texto associado e mensagem "o que é isso". </para> +<para>A janela do editor (na parte inferior direita) é a parte mais sofisticada da janela principal do &kbabel;. Seu tamanho pode ser ajustado usando a linha divisória entre ele e o painel de comentário (na parte superior direita). A janela do editor possui dois painéis de aba—essencialmente é uma pequena 'fotografia' do arquivo PO. Durante a tradução, é muito comum que strings de mensagem estejam relacionados com as mensagens anterior e posterior, logo o painel de contexto é útil para dar uma olhada nas mensagens próximas para obter uma dica de como a mensagem atual pode ser melhor traduzida. A tradução de interface de diálogo é um bom exemplo, ou widgets com seu texto associado e mensagem "o que é isso". </para> <sect2 id="more-kbabel-features"> -<title ->Mais Recursos do &kbabel;</title> +<title>Mais Recursos do &kbabel;</title> -<para ->Cada entrada msgid pode estar em três estados: </para> +<para>Cada entrada msgid pode estar em três estados: </para> <variablelist> <varlistentry> - <term ->não traduzido</term> + <term>não traduzido</term> <listitem> - <para ->não existe nenhum texto traduzido atualmente associado com o msgstr </para> + <para>não existe nenhum texto traduzido atualmente associado com o msgstr </para> </listitem> </varlistentry> <varlistentry> - <term ->aproximado</term> + <term>aproximado</term> <listitem> - <para -><command ->msgmerge</command -> tentou corresponder um string traduzido procurando nas entradas do arquivo PO restantes. Isto não funcionou perfeitamente e você deve editar o texto traduzido para corresponder ao texto atual em Inglês. </para> + <para><command>msgmerge</command> tentou corresponder um string traduzido procurando nas entradas do arquivo PO restantes. Isto não funcionou perfeitamente e você deve editar o texto traduzido para corresponder ao texto atual em Inglês. </para> </listitem> </varlistentry> <varlistentry> - <term ->traduzido</term> + <term>traduzido</term> <listitem> - <para ->a msgid é forma traduzida final da msgstr </para> + <para>a msgid é forma traduzida final da msgstr </para> </listitem> </varlistentry> </variablelist> -<para ->O estado da entrada atual é indicada por dois <acronym ->LED</acronym ->s. Dependendo de sua configuração eles podem estar tanto na barra de estado como acima da caixa de edição <guilabel ->string traduzido</guilabel ->. Ambos possuem uma cor personalizável (para refletir suas necessidades visuais ou gosto). Por favor leia a seção <link linkend="preferences" ->Preferências</link -> para ver como você pode ajustar estas configurações.</para> +<para>O estado da entrada atual é indicada por dois <acronym>LED</acronym>s. Dependendo de sua configuração eles podem estar tanto na barra de estado como acima da caixa de edição <guilabel>string traduzido</guilabel>. Ambos possuem uma cor personalizável (para refletir suas necessidades visuais ou gosto). Por favor leia a seção <link linkend="preferences">Preferências</link> para ver como você pode ajustar estas configurações.</para> </sect2> </sect1> <sect1 id="kbabel-features"> -<title ->Tradução Avançada</title> +<title>Tradução Avançada</title> -<para ->Agora você já tem uma idéia de como traduzir um arquivo PO. Nesta seção nós seguiremos com o modo padrão de traduzir novos arquivos PO usando os recursos avançados do &kbabel;. Nós assumiremos que você já abriu um arquivo-modelo POT e salvou-o como arquivo PO. </para> +<para>Agora você já tem uma idéia de como traduzir um arquivo PO. Nesta seção nós seguiremos com o modo padrão de traduzir novos arquivos PO usando os recursos avançados do &kbabel;. Nós assumiremos que você já abriu um arquivo-modelo POT e salvou-o como arquivo PO. </para> <sect2 id="kbabel-navigation"> -<title ->Navegando no arquivo PO</title> -<para ->O &kbabel; lhe permite navegar facilmente pelo arquivo de acordo com o estado de sua tradução. O estado não traduzido/aproximado já foi apresentado. Um mensagem pode ser marcada como erro como um resultado do <link linkend="kbabel-validation" ->verificar validação</link -> ou da validação feita pelo <command ->msgfmt</command ->. E, é claro, o &kbabel; suporta navegação do histórico com <guilabel ->Avançar</guilabel ->/<guilabel ->Voltar</guilabel ->, como no &konqueror;.</para> -<para ->Todos os comandos de navegação estão no menu <menuchoice -><guimenu ->Ir</guimenu -></menuchoice ->. </para> +<title>Navegando no arquivo PO</title> +<para>O &kbabel; lhe permite navegar facilmente pelo arquivo de acordo com o estado de sua tradução. O estado não traduzido/aproximado já foi apresentado. Um mensagem pode ser marcada como erro como um resultado do <link linkend="kbabel-validation">verificar validação</link> ou da validação feita pelo <command>msgfmt</command>. E, é claro, o &kbabel; suporta navegação do histórico com <guilabel>Avançar</guilabel>/<guilabel>Voltar</guilabel>, como no &konqueror;.</para> +<para>Todos os comandos de navegação estão no menu <menuchoice><guimenu>Ir</guimenu></menuchoice>. </para> <informaltable> <tgroup cols="2"> <tbody> <row> -<entry -><para -><keycombo action="simul" -><keycap ->Page Up</keycap -></keycombo -></para -></entry> -<entry -><para ->Move para a mensagem anterior </para -></entry> +<entry><para><keycombo action="simul"><keycap>Page Up</keycap></keycombo></para></entry> +<entry><para>Move para a mensagem anterior </para></entry> </row> <row> -<entry -><para -><keycombo action="simul" -><keycap ->Page Down</keycap -></keycombo -></para -></entry> -<entry -><para ->Move para a próxima mensagem</para -></entry> +<entry><para><keycombo action="simul"><keycap>Page Down</keycap></keycombo></para></entry> +<entry><para>Move para a próxima mensagem</para></entry> </row> <row> -<entry -><para -><keycombo action="simul" ->&Ctrl;<keycap ->Page Up</keycap -></keycombo -></para -></entry> -<entry -><para ->Move para a mensagem aproximada anterior</para -></entry> +<entry><para><keycombo action="simul">&Ctrl;<keycap>Page Up</keycap></keycombo></para></entry> +<entry><para>Move para a mensagem aproximada anterior</para></entry> </row> <row> -<entry -><para -><keycombo action="simul" ->&Ctrl;<keycap ->Page Down</keycap -></keycombo -></para -></entry> -<entry -><para ->Move para a próxima mensagem aproximada</para -></entry> +<entry><para><keycombo action="simul">&Ctrl;<keycap>Page Down</keycap></keycombo></para></entry> +<entry><para>Move para a próxima mensagem aproximada</para></entry> </row> <row> -<entry -><para -><keycombo action="simul" ->&Alt;<keycap ->Page Up</keycap -></keycombo -></para -></entry> -<entry -><para ->Move para a mensagem não traduzida anterior</para -></entry> +<entry><para><keycombo action="simul">&Alt;<keycap>Page Up</keycap></keycombo></para></entry> +<entry><para>Move para a mensagem não traduzida anterior</para></entry> </row> <row> -<entry -><para -><keycombo action="simul" ->&Alt;<keycap ->Page Down</keycap -></keycombo -></para -></entry> -<entry -><para ->Move para a próxima mensagem não traduzida</para -></entry> +<entry><para><keycombo action="simul">&Alt;<keycap>Page Down</keycap></keycombo></para></entry> +<entry><para>Move para a próxima mensagem não traduzida</para></entry> </row> <row> -<entry -><para -><keycombo action="simul" ->&Shift;<keycap ->Page Up</keycap -></keycombo -></para -></entry> -<entry -><para ->Move para a mensagem com erro anterior</para -></entry> +<entry><para><keycombo action="simul">&Shift;<keycap>Page Up</keycap></keycombo></para></entry> +<entry><para>Move para a mensagem com erro anterior</para></entry> </row> <row> -<entry -><para -><keycombo action="simul" ->&Shift;<keycap ->Page Down</keycap -></keycombo -></para -></entry> -<entry -><para ->Move para a próxima mensagem com erro</para -></entry> +<entry><para><keycombo action="simul">&Shift;<keycap>Page Down</keycap></keycombo></para></entry> +<entry><para>Move para a próxima mensagem com erro</para></entry> </row> <row> -<entry -><para -><keycombo action="simul" ->&Ctrl;&Shift;<keycap ->Page Up</keycap -></keycombo -></para -></entry> -<entry -><para ->Move para a mensagem aproximada ou não traduzida anterior</para -></entry> +<entry><para><keycombo action="simul">&Ctrl;&Shift;<keycap>Page Up</keycap></keycombo></para></entry> +<entry><para>Move para a mensagem aproximada ou não traduzida anterior</para></entry> </row> <row> -<entry -><para -><keycombo action="simul" ->&Ctrl;&Shift;<keycap ->Page Down</keycap -></keycombo -></para -></entry> -<entry -><para ->Move para a próxima mensagem aproximada ou não traduzida</para -></entry> +<entry><para><keycombo action="simul">&Ctrl;&Shift;<keycap>Page Down</keycap></keycombo></para></entry> +<entry><para>Move para a próxima mensagem aproximada ou não traduzida</para></entry> </row> </tbody> </tgroup> @@ -431,138 +170,47 @@ </sect2> <sect2 id="kbabel-cleveredit"> -<title ->Edição inteligente</title> -<para -><emphasis ->Edição inteligente</emphasis -> significa que o editor lhe auxiliará na edição da tradução levando em conta características especiais do formato do PO. Ele <quote ->escapará</quote -> corretamente os caracteres quando necessário.</para> -<para ->Ele também suporta mais de um modo para inserção de fim de linha. Isto é muito útil devido a maneira que o gettext manipula o fim de linha. Ele simplesmente o ignora. (Você pode imaginar que todo o texto no <acronym ->msgstr</acronym -> é uma linha simples.) Se você deseja inserir um fim de linha <quote ->real</quote ->, você precisa inserir <userinput ->\n</userinput ->. Mas a maioria dos tradutores não o fazem, de modo que uma nova linha no <acronym ->msgstr</acronym -> não adiciona nenhum espaço entre as linhas. Isto pode ser facilmente resolvido adicionando um espaço no final de cada linha. Mas você pode facilmente esquecer disso, então a edição inteligente faz isso automaticamente para você. </para> -<para ->A tabela abaixo resume os recursos de edição inteligente. </para> +<title>Edição inteligente</title> +<para><emphasis>Edição inteligente</emphasis> significa que o editor lhe auxiliará na edição da tradução levando em conta características especiais do formato do PO. Ele <quote>escapará</quote> corretamente os caracteres quando necessário.</para> +<para>Ele também suporta mais de um modo para inserção de fim de linha. Isto é muito útil devido a maneira que o gettext manipula o fim de linha. Ele simplesmente o ignora. (Você pode imaginar que todo o texto no <acronym>msgstr</acronym> é uma linha simples.) Se você deseja inserir um fim de linha <quote>real</quote>, você precisa inserir <userinput>\n</userinput>. Mas a maioria dos tradutores não o fazem, de modo que uma nova linha no <acronym>msgstr</acronym> não adiciona nenhum espaço entre as linhas. Isto pode ser facilmente resolvido adicionando um espaço no final de cada linha. Mas você pode facilmente esquecer disso, então a edição inteligente faz isso automaticamente para você. </para> +<para>A tabela abaixo resume os recursos de edição inteligente. </para> <informaltable> <tgroup cols="2"> <tbody> <row> -<entry -><para -><keycombo action="simul" -><keycap ->Tab</keycap -></keycombo -></para -></entry> -<entry -><para ->Insere <emphasis ->\t</emphasis -></para -></entry> +<entry><para><keycombo action="simul"><keycap>Tab</keycap></keycombo></para></entry> +<entry><para>Insere <emphasis>\t</emphasis></para></entry> </row> <row> -<entry -><para -><keycombo action="simul" -><keycap ->"</keycap -></keycombo -></para -></entry> -<entry -><para ->Insere <emphasis ->\"</emphasis -></para -></entry> +<entry><para><keycombo action="simul"><keycap>"</keycap></keycombo></para></entry> +<entry><para>Insere <emphasis>\"</emphasis></para></entry> </row> <row> -<entry -><para -><keycombo action="simul" -><keycap ->Enter</keycap -></keycombo -></para -></entry> -<entry -><para ->Se o último caracter antes do cursor não é um espaço, insere um espaço. Então inicia uma nova linha.</para -></entry> -</row -><row> -<entry -><para -><keycombo action="simul" ->&Ctrl;<keycap ->Enter</keycap -></keycombo -></para -></entry> -<entry -><para ->Inicia uma nova linha sem nenhuma adição lógica</para -></entry> +<entry><para><keycombo action="simul"><keycap>Enter</keycap></keycombo></para></entry> +<entry><para>Se o último caracter antes do cursor não é um espaço, insere um espaço. Então inicia uma nova linha.</para></entry> +</row><row> +<entry><para><keycombo action="simul">&Ctrl;<keycap>Enter</keycap></keycombo></para></entry> +<entry><para>Inicia uma nova linha sem nenhuma adição lógica</para></entry> </row> <row> -<entry -><para -><keycombo action="simul" ->&Shift;<keycap ->Enter</keycap -></keycombo -></para -></entry> -<entry -><para ->Insere <emphasis ->\n</emphasis -> e inicia uma nova linha</para -></entry> +<entry><para><keycombo action="simul">&Shift;<keycap>Enter</keycap></keycombo></para></entry> +<entry><para>Insere <emphasis>\n</emphasis> e inicia uma nova linha</para></entry> </row> </tbody> </tgroup> </informaltable> <note> -<para ->Se você quiser ver onde estão os espaços, você poderá ativar o <guibutton ->Realçar fundo</guibutton -> e/ou <guibutton ->Marcar espaços com pontos</guibutton -> na janela de configuração, na página <guilabel ->Editar</guilabel -> <guilabel ->Aparência</guilabel ->. </para> +<para>Se você quiser ver onde estão os espaços, você poderá ativar o <guibutton>Realçar fundo</guibutton> e/ou <guibutton>Marcar espaços com pontos</guibutton> na janela de configuração, na página <guilabel>Editar</guilabel> <guilabel>Aparência</guilabel>. </para> </note> </sect2> <sect2 id="kbabel-roughtranslation"> -<title ->Tradução automática</title> -<para ->Como um primeiro passo ao iniciar uma nova tradução, o &kbabel; oferece uma função para automaticamente traduzir as mensagens a partir de traduções antigas. Escolha <menuchoice -><guimenu ->Ferramentas</guimenu -><guimenuitem ->Tradução Aproximada</guimenuitem -></menuchoice -> e o &kbabel; lhe apresentará o seguinte diálogo: </para> +<title>Tradução automática</title> +<para>Como um primeiro passo ao iniciar uma nova tradução, o &kbabel; oferece uma função para automaticamente traduzir as mensagens a partir de traduções antigas. Escolha <menuchoice><guimenu>Ferramentas</guimenu><guimenuitem>Tradução Aproximada</guimenuitem></menuchoice> e o &kbabel; lhe apresentará o seguinte diálogo: </para> <para> <screenshot> -<screeninfo ->Diálogo de tradução aproximada</screeninfo> +<screeninfo>Diálogo de tradução aproximada</screeninfo> <mediaobject> <imageobject> <imagedata fileref="roughtranslation.png" format="PNG"/> @@ -570,300 +218,122 @@ </mediaobject> </screenshot> </para> -<para ->No diálogo, você deve especificar o que traduzir e escolher as fontes para as traduções antigas. </para> -<para ->No topo do quadro <guilabel ->O que traduzir</guilabel -> estão três caixas de verificação (<guilabel ->Entradas não traduzidas</guilabel ->, <guilabel ->Entradas aproximadas</guilabel ->, <guilabel ->Entradas traduzidas</guilabel ->) para especificar que tipo de mensagens você deseja traduzir. Entradas não traduzidas e aproximadas são escolhas naturais para tradução automática, mas você pode mudar mensagens traduzidas também. </para> -<para ->A correspondência exata para as <acronym ->msgid</acronym ->s será sempre usada para tradução aproximada. No entanto, você pode adicionar mais estratégias, &ie; <guilabel ->Permitir tradução aproximada (lento)</guilabel -> e <guilabel ->Permitir tradução de palavras simples</guilabel ->. Ambas são estratégias adicionais que devem ser suportadas pelas fontes usadas (veja abaixo). Não há nenhuma especificação do que <quote ->tradução aproximada</quote -> significa, mas o propósito é bem óbvio. <quote ->Tradução de palavras simples</quote -> é aplicável somente para alguns idiomas. O &kbabel; tentará traduzir cada palavra no <acronym ->msgid</acronym -> separadamente e então colocar as palavras traduzidas (ou frases) na mesma ordem no <acronym ->msgstr</acronym ->. </para> -<para ->Como uma fonte da tradução aproximada, qualquer módulo de dicionário disponível pode ser usado. Existe uma lista dos módulos <guilabel ->Não usar</guilabel -> e dos módulos <guilabel ->Usar</guilabel ->. Módulos são usados na ordem da lista <guilabel ->Usar</guilabel ->. O primeiro módulo é requisitado para tradução. Se nada for encontrado nele, o próximo módulo da lista é usado e assim por diante. Você pode usar os botões com setas para mover os módulos entre as listas. Não esqueça de mudar a ordem para atender as suas necessidades através dos botões <guibutton ->Mover Acima</guibutton -> e <guibutton ->Mover Abaixo</guibutton ->. </para> -<para ->Normalmente o &kbabel; marcará cada mensagem aproximadamente traduzida como aproximada, porque ele assume que qualquer tradução automática necessita de ser revisada por um tradutor. Se você estiver 100% certo de que a tradução automática estará correta, ou se você revisará toda a tradução de qualquer modo, <guilabel ->Marcar entradas mudadas como aproximada</guilabel -> lhe permite desligar esta marcação automática de aproximado, mas você precisará confirmar isto. </para> -<para ->Se você tiver configurado todas as opções de acordo com sua necessidade, pressione <guibutton ->Iniciar</guibutton -> para automaticamente traduzir as mensagens. Você pode acompanhar a barra de progresso e se for o caso, existe sempre o botão <guibutton ->Parar</guibutton ->. </para> +<para>No diálogo, você deve especificar o que traduzir e escolher as fontes para as traduções antigas. </para> +<para>No topo do quadro <guilabel>O que traduzir</guilabel> estão três caixas de verificação (<guilabel>Entradas não traduzidas</guilabel>, <guilabel>Entradas aproximadas</guilabel>, <guilabel>Entradas traduzidas</guilabel>) para especificar que tipo de mensagens você deseja traduzir. Entradas não traduzidas e aproximadas são escolhas naturais para tradução automática, mas você pode mudar mensagens traduzidas também. </para> +<para>A correspondência exata para as <acronym>msgid</acronym>s será sempre usada para tradução aproximada. No entanto, você pode adicionar mais estratégias, &ie; <guilabel>Permitir tradução aproximada (lento)</guilabel> e <guilabel>Permitir tradução de palavras simples</guilabel>. Ambas são estratégias adicionais que devem ser suportadas pelas fontes usadas (veja abaixo). Não há nenhuma especificação do que <quote>tradução aproximada</quote> significa, mas o propósito é bem óbvio. <quote>Tradução de palavras simples</quote> é aplicável somente para alguns idiomas. O &kbabel; tentará traduzir cada palavra no <acronym>msgid</acronym> separadamente e então colocar as palavras traduzidas (ou frases) na mesma ordem no <acronym>msgstr</acronym>. </para> +<para>Como uma fonte da tradução aproximada, qualquer módulo de dicionário disponível pode ser usado. Existe uma lista dos módulos <guilabel>Não usar</guilabel> e dos módulos <guilabel>Usar</guilabel>. Módulos são usados na ordem da lista <guilabel>Usar</guilabel>. O primeiro módulo é requisitado para tradução. Se nada for encontrado nele, o próximo módulo da lista é usado e assim por diante. Você pode usar os botões com setas para mover os módulos entre as listas. Não esqueça de mudar a ordem para atender as suas necessidades através dos botões <guibutton>Mover Acima</guibutton> e <guibutton>Mover Abaixo</guibutton>. </para> +<para>Normalmente o &kbabel; marcará cada mensagem aproximadamente traduzida como aproximada, porque ele assume que qualquer tradução automática necessita de ser revisada por um tradutor. Se você estiver 100% certo de que a tradução automática estará correta, ou se você revisará toda a tradução de qualquer modo, <guilabel>Marcar entradas mudadas como aproximada</guilabel> lhe permite desligar esta marcação automática de aproximado, mas você precisará confirmar isto. </para> +<para>Se você tiver configurado todas as opções de acordo com sua necessidade, pressione <guibutton>Iniciar</guibutton> para automaticamente traduzir as mensagens. Você pode acompanhar a barra de progresso e se for o caso, existe sempre o botão <guibutton>Parar</guibutton>. </para> </sect2> <sect2 id="kbabel-validation"> -<title ->Validar sua tradução</title> -<para ->Todos cometem erros. Logo o &kbabel; suporta um número de verificações para problemas típicos nas traduções. Estas verificações (não verificação de sintaxe) pode ser realizada basicamente de duas maneiras.</para> -<para ->Verificações podem ser feitas para cada mudança no texto traduzido. Elas são chamadas verificações <emphasis ->automáticas</emphasis -> e elas podem ser ligadas no <link linkend="preferences-editor" ->diálogo de configuração do &kbabel;.</link ->. A verificação automática da sintaxe é possível a cada salvamento do arquivo. </para> -<para ->As verificações automáticas podem tornar o &kbabel; lento. Se você possui um computador lento, você pode desligar as verificações automáticas e usar somente a segunda possibilidade. Você pode invocar todo tipo de verificação a partir do <menuchoice -><guimenu ->Ferramentas</guimenu -> <guisubmenu ->Validação</guisubmenu -></menuchoice ->. Então a verificação é executada para todas as mensagens no arquivo e as falhas são marcadas como erros. </para> +<title>Validar sua tradução</title> +<para>Todos cometem erros. Logo o &kbabel; suporta um número de verificações para problemas típicos nas traduções. Estas verificações (não verificação de sintaxe) pode ser realizada basicamente de duas maneiras.</para> +<para>Verificações podem ser feitas para cada mudança no texto traduzido. Elas são chamadas verificações <emphasis>automáticas</emphasis> e elas podem ser ligadas no <link linkend="preferences-editor">diálogo de configuração do &kbabel;.</link>. A verificação automática da sintaxe é possível a cada salvamento do arquivo. </para> +<para>As verificações automáticas podem tornar o &kbabel; lento. Se você possui um computador lento, você pode desligar as verificações automáticas e usar somente a segunda possibilidade. Você pode invocar todo tipo de verificação a partir do <menuchoice><guimenu>Ferramentas</guimenu> <guisubmenu>Validação</guisubmenu></menuchoice>. Então a verificação é executada para todas as mensagens no arquivo e as falhas são marcadas como erros. </para> <variablelist> <varlistentry> - <term -><guimenuitem ->Verificar Sintaxe</guimenuitem -></term> + <term><guimenuitem>Verificar Sintaxe</guimenuitem></term> <listitem> - <para ->Isto invoca o <command ->msgfmt</command -> para verificar a validade do arquivo PO, como é permitido pelo pacote do 'gettext' da &GNU;. Isto irá mostrar o resultado do comando e marcar os <acronym ->msgstr</acronym ->s errados. </para> + <para>Isto invoca o <command>msgfmt</command> para verificar a validade do arquivo PO, como é permitido pelo pacote do 'gettext' da &GNU;. Isto irá mostrar o resultado do comando e marcar os <acronym>msgstr</acronym>s errados. </para> </listitem> </varlistentry> <varlistentry> - <term -><guimenuitem ->Verificar Argumentos</guimenuitem -></term> + <term><guimenuitem>Verificar Argumentos</guimenuitem></term> <listitem> - <para ->Traduções incorretas podem travar o aplicativo. As partes mais perigosas da tradução são os argumentos, ⪚ para funções tipo printf. Esta verificação compara o número e tipo de argumentos no <acronym ->msgid</acronym -> e <acronym ->msgstr</acronym ->. Eles devem corresponder. </para> + <para>Traduções incorretas podem travar o aplicativo. As partes mais perigosas da tradução são os argumentos, ⪚ para funções tipo printf. Esta verificação compara o número e tipo de argumentos no <acronym>msgid</acronym> e <acronym>msgstr</acronym>. Eles devem corresponder. </para> </listitem> </varlistentry> <varlistentry> - <term -><guimenuitem ->Verificar Aceleradores</guimenuitem -></term> + <term><guimenuitem>Verificar Aceleradores</guimenuitem></term> <listitem> - <para ->O texto da &GUI; comumente contém aceleradores, &ie; letras que podem ser usadas para um rápido acesso aos elementos da &GUI; através do teclado. Eles são marcados por um caracter especial, ⪚ & no &kde;. Um requisito típico da tradução é que o texto traduzido deve conter o acelerador do texto original. Esta verificação informa este problema para você. O caracter acelerador pode ser especificado nas <guilabel ->Preferências</guilabel -> na aba <guilabel ->Miscelânea</guilabel ->. </para> + <para>O texto da &GUI; comumente contém aceleradores, &ie; letras que podem ser usadas para um rápido acesso aos elementos da &GUI; através do teclado. Eles são marcados por um caracter especial, ⪚ & no &kde;. Um requisito típico da tradução é que o texto traduzido deve conter o acelerador do texto original. Esta verificação informa este problema para você. O caracter acelerador pode ser especificado nas <guilabel>Preferências</guilabel> na aba <guilabel>Miscelânea</guilabel>. </para> </listitem> </varlistentry> <varlistentry> - <term -><guimenuitem ->Procurar por Informações de Contexto Traduzidas</guimenuitem -></term> + <term><guimenuitem>Procurar por Informações de Contexto Traduzidas</guimenuitem></term> <listitem> - <para ->Você provavelmente precisará disto para traduções do &kde;. Alguns textos que são muito comuns precisam ser traduzidos diferentemente em diferentes contextos. No &kde; este contexto é descrito no início da <acronym ->msgid</acronym -> após a seqüência especial <userinput ->:_</userinput ->. Mas se alguns tradutores podem não estar cientes desta convenção e tentar traduzir a informação de contexto também. Esta verificação tenta encontrar este erro. Se ele encontrar informações de contexto traduzidas, você deve removê-las. </para> + <para>Você provavelmente precisará disto para traduções do &kde;. Alguns textos que são muito comuns precisam ser traduzidos diferentemente em diferentes contextos. No &kde; este contexto é descrito no início da <acronym>msgid</acronym> após a seqüência especial <userinput>:_</userinput>. Mas se alguns tradutores podem não estar cientes desta convenção e tentar traduzir a informação de contexto também. Esta verificação tenta encontrar este erro. Se ele encontrar informações de contexto traduzidas, você deve removê-las. </para> </listitem> </varlistentry> <varlistentry> - <term -><guimenuitem ->Verificar Formas Plurais</guimenuitem -></term> + <term><guimenuitem>Verificar Formas Plurais</guimenuitem></term> <listitem> - <para ->Se a <acronym ->msgid</acronym -> é especificada como uma <quote ->forma plural</quote ->, a tradução deve conter o número correto de traduções separadas por <userinput ->\n</userinput ->. O número correto depende do idioma da tradução e é especificado na aba <guilabel ->Identidade</guilabel -> no diálogo <guilabel ->Preferências</guilabel ->. Esta implementação, até agora, ocorre somente para o &kde;. </para> + <para>Se a <acronym>msgid</acronym> é especificada como uma <quote>forma plural</quote>, a tradução deve conter o número correto de traduções separadas por <userinput>\n</userinput>. O número correto depende do idioma da tradução e é especificado na aba <guilabel>Identidade</guilabel> no diálogo <guilabel>Preferências</guilabel>. Esta implementação, até agora, ocorre somente para o &kde;. </para> </listitem> </varlistentry> <varlistentry> - <term -><guimenuitem ->Verificar Equações</guimenuitem -></term> + <term><guimenuitem>Verificar Equações</guimenuitem></term> <listitem> - <para ->As equações são um formato especial do <acronym ->msgid</acronym -> que é usado tipicamente nos arquivos <filename ->.desktop</filename ->. Uma vez que as suas traduções irão ser mescladas nestes arquivos, o <acronym ->msgstr</acronym -> precisa também usar este formato especial. Isto significa que a tradução deverá ter início (até à primeira ocorrência do <literal ->=</literal -> com o mesmo texto que a mensagem original, ⪚ <userinput ->Name=</userinput ->. </para> + <para>As equações são um formato especial do <acronym>msgid</acronym> que é usado tipicamente nos arquivos <filename>.desktop</filename>. Uma vez que as suas traduções irão ser mescladas nestes arquivos, o <acronym>msgstr</acronym> precisa também usar este formato especial. Isto significa que a tradução deverá ter início (até à primeira ocorrência do <literal>=</literal> com o mesmo texto que a mensagem original, ⪚ <userinput>Name=</userinput>. </para> </listitem> </varlistentry> </variablelist> </sect2> <sect2 id="kbabel-spellcheck"> -<title ->Verificação ortográfica da tradução</title> -<para ->Como sempre, é muito importante verificar ortograficamente a sua tradução antes de usar o seu resultado. Desta forma, você sempre poderá encontrar erros tipográficos ou outros problemas na sua tradução. O &kbabel; usa a biblioteca-padrão do &kde; para fazer a verificação ortográfica e as suas opções normais poderão ser encontradas na <link linkend="preferences-project-spellcheck" ->janela de configuração do &kbabel;</link ->. A verificação ortográfica em si poderá ser acessada em <menuchoice -><guimenu ->Ferramentas</guimenu -><guisubmenu ->Verificação Ortográfica</guisubmenu -> </menuchoice ->. Você poderá usar um conjunto de modos na verificação ortográfica: </para> +<title>Verificação ortográfica da tradução</title> +<para>Como sempre, é muito importante verificar ortograficamente a sua tradução antes de usar o seu resultado. Desta forma, você sempre poderá encontrar erros tipográficos ou outros problemas na sua tradução. O &kbabel; usa a biblioteca-padrão do &kde; para fazer a verificação ortográfica e as suas opções normais poderão ser encontradas na <link linkend="preferences-project-spellcheck">janela de configuração do &kbabel;</link>. A verificação ortográfica em si poderá ser acessada em <menuchoice><guimenu>Ferramentas</guimenu><guisubmenu>Verificação Ortográfica</guisubmenu> </menuchoice>. Você poderá usar um conjunto de modos na verificação ortográfica: </para> <variablelist> <varlistentry> - <term -><guimenuitem ->Verificar ortografia...</guimenuitem -></term> + <term><guimenuitem>Verificar ortografia...</guimenuitem></term> <listitem> - <para ->Esta é uma invocação genérica de um diálogo, de onde você pode escolher o modo de verificação ortográfica e configurar um modo padrão. Este será invocado pressionando <keycombo action="simul" ->&Ctrl;<keycap ->I</keycap -></keycombo ->. </para> + <para>Esta é uma invocação genérica de um diálogo, de onde você pode escolher o modo de verificação ortográfica e configurar um modo padrão. Este será invocado pressionando <keycombo action="simul">&Ctrl;<keycap>I</keycap></keycombo>. </para> </listitem> </varlistentry> <varlistentry> - <term -><guimenuitem ->Verificar Tudo...</guimenuitem -></term> + <term><guimenuitem>Verificar Tudo...</guimenuitem></term> <listitem> - <para ->Verifica todas as mensagens no arquivo. </para> + <para>Verifica todas as mensagens no arquivo. </para> </listitem> </varlistentry> <varlistentry> - <term -><guimenuitem ->Verificar da Posição do Cursor...</guimenuitem -></term> + <term><guimenuitem>Verificar da Posição do Cursor...</guimenuitem></term> <listitem> - <para ->Inicia a verificação ortográfica na posição da mensagem atual e continua em direção ao fim do arquivo. </para> + <para>Inicia a verificação ortográfica na posição da mensagem atual e continua em direção ao fim do arquivo. </para> </listitem> </varlistentry> <varlistentry> - <term -><guimenuitem ->Verificar Atual...</guimenuitem -></term> + <term><guimenuitem>Verificar Atual...</guimenuitem></term> <listitem> - <para ->Verifica a ortografia somente da mensagem atual. </para> + <para>Verifica a ortografia somente da mensagem atual. </para> </listitem> </varlistentry> <varlistentry> - <term -><guimenuitem ->Verificar Texto Selecionado...</guimenuitem -></term> + <term><guimenuitem>Verificar Texto Selecionado...</guimenuitem></term> <listitem> - <para ->Se existir um texto selecionado no editor de <acronym ->msgstr</acronym ->, esta opção estará disponível e a verificação ortográfica será apenas deste texto. </para> + <para>Se existir um texto selecionado no editor de <acronym>msgstr</acronym>, esta opção estará disponível e a verificação ortográfica será apenas deste texto. </para> </listitem> </varlistentry> </variablelist> </sect2> <sect2 id="kbabel-tags"> -<title ->Traduzir &XML;, <acronym ->HTML</acronym ->, ...</title> -<para ->Linguagens de marcação são usadas cada vez mais em &GUI;. O projeto &kde; também usa arquivos <acronym ->PO</acronym -> para tradução de arquivos de documentação DocBook (que é também uma linguagem de marcação). O &kbabel; contém muitas funcionalidades para suportar esta tendência. </para> +<title>Traduzir &XML;, <acronym>HTML</acronym>, ...</title> +<para>Linguagens de marcação são usadas cada vez mais em &GUI;. O projeto &kde; também usa arquivos <acronym>PO</acronym> para tradução de arquivos de documentação DocBook (que é também uma linguagem de marcação). O &kbabel; contém muitas funcionalidades para suportar esta tendência. </para> <note> -<para ->Aqui, nós descreveremos somente funções relacionadas às tags usadas por marcações propriamente ditas. O outro problema introduzido pelo uso de linguagens de marcação é a tradução de textos longos. Isto é endereçado pelo recurso <emphasis ->diff</emphasis -> descrito na <link linkend="kbabel-diff" ->seção seguinte</link ->. </para> +<para>Aqui, nós descreveremos somente funções relacionadas às tags usadas por marcações propriamente ditas. O outro problema introduzido pelo uso de linguagens de marcação é a tradução de textos longos. Isto é endereçado pelo recurso <emphasis>diff</emphasis> descrito na <link linkend="kbabel-diff">seção seguinte</link>. </para> </note> -<para ->A versão atual do &kbabel; é capaz de encontrar quais tags são usadas no <acronym ->msgid</acronym -> e fornecer um acesso fácil a elas usando as seguintes ações no <guimenu ->Editar</guimenu ->. </para> +<para>A versão atual do &kbabel; é capaz de encontrar quais tags são usadas no <acronym>msgid</acronym> e fornecer um acesso fácil a elas usando as seguintes ações no <guimenu>Editar</guimenu>. </para> <variablelist> <varlistentry> <term> - <guimenuitem ->Inserir Próxima Tag</guimenuitem> + <guimenuitem>Inserir Próxima Tag</guimenuitem> </term> <listitem> <para> - <action ->Isto insere a próxima tag encontrada no msgid para a tradução. O &kbabel; encontra a tag a ser inserida contando o números de tags a partir do início da tradução. </action> + <action>Isto insere a próxima tag encontrada no msgid para a tradução. O &kbabel; encontra a tag a ser inserida contando o números de tags a partir do início da tradução. </action> </para> </listitem> </varlistentry> <varlistentry> <term> - <menuchoice -><guimenu ->Editar</guimenu -><guisubmenu ->Inserir Tag</guisubmenu -> </menuchoice> + <menuchoice><guimenu>Editar</guimenu><guisubmenu>Inserir Tag</guisubmenu> </menuchoice> </term> <listitem> <para> - <action ->Este submenu contém todos as diferentes tags de marcação encontradas no string original em inglês. Selecionando uma delas você pode inseri-la na posição do cursor no texto traduzido. </action> + <action>Este submenu contém todos as diferentes tags de marcação encontradas no string original em inglês. Selecionando uma delas você pode inseri-la na posição do cursor no texto traduzido. </action> </para> </listitem> </varlistentry> @@ -871,156 +341,55 @@ </sect2> <sect2 id="kbabel-diff"> -<title ->Mostrar a diferença</title> -<para ->Como já explanado, aplicativos atuais, tentando ser amigáveis com o usuário, contém uma grande quantidade de texto descritivo, incluindo marcações. Se o desenvolvedor muda uma parte do texto, o sistema &GNU; gettext irá, na melhor hipótese, manter a tradução antiga e marcá-la como aproximada. (Na pior hipótese você perderá a tradução completamente, dependendo do tamanho do texto mudado). Isto funciona bem se um <acronym ->msgid</acronym -> é curto, porque você poderá encontrar as mudanças rapidamente. Mas se o texto é longo o bastante, você terá que se esforçar para descobrir o que mudou (Por exemplo, pode ser somente um artigo mudado pela equipe de leitura.) </para> -<para ->Para auxiliar, o &kbabel; pode ser solicitado a procurar a <acronym ->msgid</acronym -> original e mostrar a diferença. As mudanças serão exibidas graficamente no editor do <guilabel ->String Original</guilabel ->. O modo exato pode ser configurado no <link linkend="preferences-editor-appearance" ->diálogo de configuração do &kbabel;</link ->. O <menuchoice -><guimenu ->Ferramentas</guimenu -> <guisubmenu ->Diferença</guisubmenu -> <guimenuitem ->Mostrar Diferença</guimenuitem -></menuchoice -> mostrará as diferenças encontradas. Para ver o texto atual sem a mistura com o texto original, use <menuchoice -><guimenu ->Ferramentas</guimenu -><guisubmenu ->Diferença</guisubmenu -> <guimenuitem ->Mostrar Texto Original</guimenuitem -></menuchoice ->. </para> -<para ->Você pode ligar ou desligar a procura automática por diferenças escolhendo <menuchoice -><guimenu ->Ferramentas</guimenu -> <guisubmenu ->Diferença</guisubmenu -> <guimenuitem ->Modo de Diferenças</guimenuitem -></menuchoice ->. Quando o modo de diferença estiver ligado, a busca por diferenças inicia quando você vai para outra mensagem. </para> -<para ->Como sempre, você pode usar fontes de diferenças para encontrar a versão antiga do texto, tudo sendo configurado no <link linkend="preferences-diffmode" ->diálogo de configuração do &kbabel;</link ->: </para> +<title>Mostrar a diferença</title> +<para>Como já explanado, aplicativos atuais, tentando ser amigáveis com o usuário, contém uma grande quantidade de texto descritivo, incluindo marcações. Se o desenvolvedor muda uma parte do texto, o sistema &GNU; gettext irá, na melhor hipótese, manter a tradução antiga e marcá-la como aproximada. (Na pior hipótese você perderá a tradução completamente, dependendo do tamanho do texto mudado). Isto funciona bem se um <acronym>msgid</acronym> é curto, porque você poderá encontrar as mudanças rapidamente. Mas se o texto é longo o bastante, você terá que se esforçar para descobrir o que mudou (Por exemplo, pode ser somente um artigo mudado pela equipe de leitura.) </para> +<para>Para auxiliar, o &kbabel; pode ser solicitado a procurar a <acronym>msgid</acronym> original e mostrar a diferença. As mudanças serão exibidas graficamente no editor do <guilabel>String Original</guilabel>. O modo exato pode ser configurado no <link linkend="preferences-editor-appearance">diálogo de configuração do &kbabel;</link>. O <menuchoice><guimenu>Ferramentas</guimenu> <guisubmenu>Diferença</guisubmenu> <guimenuitem>Mostrar Diferença</guimenuitem></menuchoice> mostrará as diferenças encontradas. Para ver o texto atual sem a mistura com o texto original, use <menuchoice><guimenu>Ferramentas</guimenu><guisubmenu>Diferença</guisubmenu> <guimenuitem>Mostrar Texto Original</guimenuitem></menuchoice>. </para> +<para>Você pode ligar ou desligar a procura automática por diferenças escolhendo <menuchoice><guimenu>Ferramentas</guimenu> <guisubmenu>Diferença</guisubmenu> <guimenuitem>Modo de Diferenças</guimenuitem></menuchoice>. Quando o modo de diferença estiver ligado, a busca por diferenças inicia quando você vai para outra mensagem. </para> +<para>Como sempre, você pode usar fontes de diferenças para encontrar a versão antiga do texto, tudo sendo configurado no <link linkend="preferences-diffmode">diálogo de configuração do &kbabel;</link>: </para> <variablelist> <varlistentry> - <term ->Banco de Dados de Traduções</term> + <term>Banco de Dados de Traduções</term> <listitem> - <para ->Você pode usar o Banco de Dados de Traduções para procura por diferenças. Nós recomendamos fortemente habilitar o armazenamento automático das mensagens traduzidas para o Banco de Dados de Traduções no <link linkend="database-fill" ->diálogo de configuração do Banco de Dados de Traduções</link ->. Este modo pode ser ligado pelo <guilabel ->Usar mensagens do Banco de Dados de Traduções</guilabel ->. </para> + <para>Você pode usar o Banco de Dados de Traduções para procura por diferenças. Nós recomendamos fortemente habilitar o armazenamento automático das mensagens traduzidas para o Banco de Dados de Traduções no <link linkend="database-fill">diálogo de configuração do Banco de Dados de Traduções</link>. Este modo pode ser ligado pelo <guilabel>Usar mensagens do Banco de Dados de Traduções</guilabel>. </para> </listitem> </varlistentry> <varlistentry> - <term ->Árvore de arquivos antigos</term> + <term>Árvore de arquivos antigos</term> <listitem> - <para ->Isto será usado somente se a procura no Banco de Dados de Traduções estiver desligada. Configurando o <guilabel ->Pasta base para diferença de arquivos</guilabel -> você pode informar ao &kbabel; qual arquivo usar para diferenças. Ele obtém o caminho relativo do arquivo aberto e usa este caminho na pasta especificada aqui. Se existir um arquivo correspondente, ele será usado. Para usar este modo, você deve fazer uma cópia dos arquivos antigos antes de cada atualização. </para> + <para>Isto será usado somente se a procura no Banco de Dados de Traduções estiver desligada. Configurando o <guilabel>Pasta base para diferença de arquivos</guilabel> você pode informar ao &kbabel; qual arquivo usar para diferenças. Ele obtém o caminho relativo do arquivo aberto e usa este caminho na pasta especificada aqui. Se existir um arquivo correspondente, ele será usado. Para usar este modo, você deve fazer uma cópia dos arquivos antigos antes de cada atualização. </para> </listitem> </varlistentry> <varlistentry> - <term ->Escolher manualmente o arquivo</term> + <term>Escolher manualmente o arquivo</term> <listitem> - <para ->Se a possibilidade anterior não funcionar corretamente, você pode sempre configurar um arquivo para diferenças manualmente selecionando <menuchoice -><guimenu ->Ferramentas</guimenu -> <guisubmenu ->Diferença</guisubmenu -> <guimenuitem ->Abrir Arquivo para Diferença</guimenuitem -></menuchoice ->. </para> + <para>Se a possibilidade anterior não funcionar corretamente, você pode sempre configurar um arquivo para diferenças manualmente selecionando <menuchoice><guimenu>Ferramentas</guimenu> <guisubmenu>Diferença</guisubmenu> <guimenuitem>Abrir Arquivo para Diferença</guimenuitem></menuchoice>. </para> </listitem> </varlistentry> </variablelist> <note> -<para ->A procura por diferença nem sempre é precisa, porque o arquivo <acronym ->PO</acronym -> não contém nenhum referência à mensagem original. </para> +<para>A procura por diferença nem sempre é precisa, porque o arquivo <acronym>PO</acronym> não contém nenhum referência à mensagem original. </para> </note> </sect2> </sect1> <sect1 id="kbabel-pluralforms"> -<title ->Formas Plurais</title> -<para ->Uma vez que as formas plurais são um assunto bastante complicado, é dedicada uma seção especial ao suporte delas no &kbabel;. </para> +<title>Formas Plurais</title> +<para>Uma vez que as formas plurais são um assunto bastante complicado, é dedicada uma seção especial ao suporte delas no &kbabel;. </para> -<note -><para ->Esta seção lida com as formas plurais do &kde; (para ser mais preciso, para o &kde; versão 3). Desde o &kbabel; versão 1.11 (KDE 3.5) em diante, o &kbabel; também é capaz de ler, editar e salvar as formas plurais do 'gettext' da &GNU;. </para -></note> +<note><para>Esta seção lida com as formas plurais do &kde; (para ser mais preciso, para o &kde; versão 3). Desde o &kbabel; versão 1.11 (KDE 3.5) em diante, o &kbabel; também é capaz de ler, editar e salvar as formas plurais do 'gettext' da &GNU;. </para></note> -<para ->Cada idioma em que o &kde; está traduzido precisa ter um número correto de formas plurais. Isto é feito ao traduzir um item no <filename ->tdelibs.po</filename ->. O número é definido ao selecionar o nome de um idioma, que usa o mesmo número e <emphasis ->regras</emphasis -> para procurar a forma plural correta. A lista atualizada dos valores possíveis poderá ser encontrada no código-fonte do 'tdelibs', no arquivo <filename ->tdecore/tdelocale.cpp</filename ->. </para> +<para>Cada idioma em que o &kde; está traduzido precisa ter um número correto de formas plurais. Isto é feito ao traduzir um item no <filename>tdelibs.po</filename>. O número é definido ao selecionar o nome de um idioma, que usa o mesmo número e <emphasis>regras</emphasis> para procurar a forma plural correta. A lista atualizada dos valores possíveis poderá ser encontrada no código-fonte do 'tdelibs', no arquivo <filename>tdecore/tdelocale.cpp</filename>. </para> -<note -><para ->O 'gettext' da &GNU; permite definir o número e tipo de formas plurais, através de uma fórmula, e definir esta fórmula de forma independente para cada arquivo PO. O &kde; só pode definir o número e tipo de formas plurais uma vez no 'tdelibs'. </para -></note> +<note><para>O 'gettext' da &GNU; permite definir o número e tipo de formas plurais, através de uma fórmula, e definir esta fórmula de forma independente para cada arquivo PO. O &kde; só pode definir o número e tipo de formas plurais uma vez no 'tdelibs'. </para></note> -<para ->As formas plurais do &kde; são demarcadas com o comentário <userinput ->_n:</userinput ->, o qual contém o argumento <literal ->%n</literal ->. Este argumento é então usado na mensagem em si e controla qual a forma plural do seu idioma deverá ser usada, dependendo das regras do seu idioma. </para> -<para ->A tradução de uma mensagem de uma forma plural terá de ter um formato especial. Deverá conter o número correto de traduções (uma por cada forma plural), separadas por um fim-de-linha <literal ->\n</literal ->, <emphasis ->sem</emphasis -> a seqüência <userinput ->_n:</userinput -> (e o espaço). Por exemplo, o <quote ->_n: Selected1 file\nSelected %n files</quote ->, traduzido para Português, ficaria: </para> -<programlisting ->Vybraný %n súbor\n +<para>As formas plurais do &kde; são demarcadas com o comentário <userinput>_n:</userinput>, o qual contém o argumento <literal>%n</literal>. Este argumento é então usado na mensagem em si e controla qual a forma plural do seu idioma deverá ser usada, dependendo das regras do seu idioma. </para> +<para>A tradução de uma mensagem de uma forma plural terá de ter um formato especial. Deverá conter o número correto de traduções (uma por cada forma plural), separadas por um fim-de-linha <literal>\n</literal>, <emphasis>sem</emphasis> a seqüência <userinput>_n:</userinput> (e o espaço). Por exemplo, o <quote>_n: Selected1 file\nSelected %n files</quote>, traduzido para Português, ficaria: </para> +<programlisting>Vybraný %n súbor\n Vybrané %n súbory\n Vybraných %n súborov </programlisting> -<para ->marcus.gama@gmail.comPara verificar se sua tradução contém o número correto de formas plurais, use o menu <menuchoice -><guimenu ->Ferramentas</guimenu -> <guisubmenu ->Validação</guisubmenu -> <guimenuitem ->Verificar Formas Plurais (somente KDE)</guimenuitem -></menuchoice ->. </para> +<para>marcus.gama@gmail.comPara verificar se sua tradução contém o número correto de formas plurais, use o menu <menuchoice><guimenu>Ferramentas</guimenu> <guisubmenu>Validação</guisubmenu> <guimenuitem>Verificar Formas Plurais (somente KDE)</guimenuitem></menuchoice>. </para> </sect1> </chapter> diff --git a/tde-i18n-pt_BR/docs/tdesdk/kbugbuster/index.docbook b/tde-i18n-pt_BR/docs/tdesdk/kbugbuster/index.docbook index 89f9d04193e..36cd79b0a0e 100644 --- a/tde-i18n-pt_BR/docs/tdesdk/kbugbuster/index.docbook +++ b/tde-i18n-pt_BR/docs/tdesdk/kbugbuster/index.docbook @@ -9,43 +9,16 @@ <book lang="&language;"> <bookinfo> -<title ->O Manual do &kbugbuster;</title> +<title>O Manual do &kbugbuster;</title> <authorgroup> -<author -><firstname -></firstname -> <othername -></othername -> <surname -></surname -> <affiliation -> <address -><email -></email -></address> +<author><firstname></firstname> <othername></othername> <surname></surname> <affiliation> <address><email></email></address> </affiliation> </author> -<othercredit role="translator" -><firstname ->Marcus</firstname -><surname ->Gama</surname -><affiliation -><address -><email ->marcus_gama@uol.com.br</email -></address -></affiliation -><contrib ->Tradução</contrib -></othercredit -> +<othercredit role="translator"><firstname>Marcus</firstname><surname>Gama</surname><affiliation><address><email>marcus_gama@uol.com.br</email></address></affiliation><contrib>Tradução</contrib></othercredit> </authorgroup> -<legalnotice ->&FDLNotice;</legalnotice> +<legalnotice>&FDLNotice;</legalnotice> <!-- Date and version information of the documentation Don't forget to include this last date and this last revision number, we @@ -53,44 +26,24 @@ need them for translation coordination ! Please respect the format of the date (DD/MM/YYYY) and of the version (Major.minor.lesser), it could be used by automation scripts --> -<date ->2002-03-31</date> -<releaseinfo ->0.00.00</releaseinfo> +<date>2002-03-31</date> +<releaseinfo>0.00.00</releaseinfo> <!-- Abstract about this handbook --> <abstract> -<para ->O &kbugbuster; é parte do pacote tdesdk. </para> +<para>O &kbugbuster; é parte do pacote tdesdk. </para> </abstract> <keywordset> -<keyword ->KDE</keyword> -<keyword ->kbugbuster</keyword> +<keyword>KDE</keyword> +<keyword>kbugbuster</keyword> </keywordset> </bookinfo> -<chapter id="introduction" -> <title ->Introdução</title -> <para ->A documentação para o &kappname; ainda não foi terminada quando o &kde; foi instalado em seu computador.</para -> <para ->Se você precisa de ajuda, por favor verifique <ulink url="http://www.kde.org" ->A Página Web do &kde;</ulink -> por atualizações, ou submeta sua pergunta na <ulink url="mailto:kde-user@kde.org" ->A Lista de Correio de Usuários do &kde;</ulink ->.</para -> <para -><emphasis ->A Equipe do &kde;</emphasis -></para -> &underFDL; </chapter> +<chapter id="introduction"> <title>Introdução</title> <para>A documentação para o &kappname; ainda não foi terminada quando o &kde; foi instalado em seu computador.</para> <para>Se você precisa de ajuda, por favor verifique <ulink url="http://www.kde.org">A Página Web do &kde;</ulink> por atualizações, ou submeta sua pergunta na <ulink url="mailto:kde-user@kde.org">A Lista de Correio de Usuários do &kde;</ulink>.</para> <para><emphasis>A Equipe do &kde;</emphasis></para> &underFDL; </chapter> &documentation.index; </book> diff --git a/tde-i18n-pt_BR/docs/tdesdk/kompare/index.docbook b/tde-i18n-pt_BR/docs/tdesdk/kompare/index.docbook index b33b8010843..56109e3f7e2 100644 --- a/tde-i18n-pt_BR/docs/tdesdk/kompare/index.docbook +++ b/tde-i18n-pt_BR/docs/tdesdk/kompare/index.docbook @@ -10,501 +10,232 @@ <book lang="&language;"> <bookinfo> - <title ->O Manual do &kompare;</title> + <title>O Manual do &kompare;</title> <authorgroup> -<author -><firstname ->Sean</firstname -><surname ->Wheller</surname -><email ->sean@inwords.co.za</email -></author> - <othercredit role="translator" -><firstname ->Marcus</firstname -><surname ->Gama</surname -><affiliation -><address -><email ->marcus.gama@gmail.com</email -></address -></affiliation -><contrib ->Tradução</contrib -></othercredit -> +<author><firstname>Sean</firstname><surname>Wheller</surname><email>sean@inwords.co.za</email></author> + <othercredit role="translator"><firstname>Marcus</firstname><surname>Gama</surname><affiliation><address><email>marcus.gama@gmail.com</email></address></affiliation><contrib>Tradução</contrib></othercredit> </authorgroup> <copyright> -<year ->2007</year> -<holder ->Sean Wheller</holder> +<year>2007</year> +<holder>Sean Wheller</holder> </copyright> - <legalnotice ->&FDLNotice;</legalnotice> + <legalnotice>&FDLNotice;</legalnotice> -<date ->2007-01-20</date> -<releaseinfo ->3.4</releaseinfo> +<date>2007-01-20</date> +<releaseinfo>3.4</releaseinfo> <!-- Abstract about this handbook --> <abstract> -<para ->O &kompare; é um programa &GUI; que permite ver e reunir as diferenças entre os arquivos de código. O &kompare; pode ser usado para comparar as diferenças entre arquivos ou entre o conteúdo de pastas. O &kompare; suporta uma grande variedade de formatos do 'diff' e oferece várias opções para personalizar o nível de informação que é apresentado.</para> -<para ->Este documento descreve o &kompare; na versão &version;.</para> +<para>O &kompare; é um programa &GUI; que permite ver e reunir as diferenças entre os arquivos de código. O &kompare; pode ser usado para comparar as diferenças entre arquivos ou entre o conteúdo de pastas. O &kompare; suporta uma grande variedade de formatos do 'diff' e oferece várias opções para personalizar o nível de informação que é apresentado.</para> +<para>Este documento descreve o &kompare; na versão &version;.</para> </abstract> <keywordset> -<keyword ->KDE</keyword> -<keyword ->Kompare</keyword> -<keyword ->Diff</keyword> -<keyword ->Mesclar</keyword> -<keyword ->Modificação</keyword> -<keyword ->Bloco</keyword> +<keyword>KDE</keyword> +<keyword>Kompare</keyword> +<keyword>Diff</keyword> +<keyword>Mesclar</keyword> +<keyword>Modificação</keyword> +<keyword>Bloco</keyword> </keywordset> </bookinfo> <chapter id="introduction"> -<title ->Introdução</title -> +<title>Introdução</title> -<para ->Quando duas ou mais pessoas estiverem trabalhando em um arquivo e trocam esta arquivo entre si, torna-se difícil saber que modificações foram feitas em cada versão do arquivo. Abrir a cópia nova e o original, lado-a-lado, na aplicação usada para criá-los, é uma solução possível mas trabalhosa, lenta e sujeita a erros. Esta situação é uma em que é necessário e útil um programa para mostrar as diferenças.</para> +<para>Quando duas ou mais pessoas estiverem trabalhando em um arquivo e trocam esta arquivo entre si, torna-se difícil saber que modificações foram feitas em cada versão do arquivo. Abrir a cópia nova e o original, lado-a-lado, na aplicação usada para criá-los, é uma solução possível mas trabalhosa, lenta e sujeita a erros. Esta situação é uma em que é necessário e útil um programa para mostrar as diferenças.</para> -<para ->Como seria de se esperar, um nome apropriado para um programa destes seria "diff" (diminutivo de diferença em inglês). Normalmente, o programa 'diff' está instalado na maioria dos sistemas baseados em &Linux; e é usado exatamente para este fim. Os programadores usam normalmente o 'diff', como ferramenta da linha de comando, para mostrar as diferenças entre versões de arquivos de código. Contudo, a utilização do 'diff' não está limitada à apresentação das diferenças nos arquivos de código-fonte, podendo ser usada em vários tipos de arquivos baseados em texto.</para> +<para>Como seria de se esperar, um nome apropriado para um programa destes seria "diff" (diminutivo de diferença em inglês). Normalmente, o programa 'diff' está instalado na maioria dos sistemas baseados em &Linux; e é usado exatamente para este fim. Os programadores usam normalmente o 'diff', como ferramenta da linha de comando, para mostrar as diferenças entre versões de arquivos de código. Contudo, a utilização do 'diff' não está limitada à apresentação das diferenças nos arquivos de código-fonte, podendo ser usada em vários tipos de arquivos baseados em texto.</para> -<para ->O uso do 'diff' na linha de comando poderá ser confusa, a aprendizagem da sintaxe e a decodificação do resultado poderão assustar a maioria das pessoas. Aí é onde o &kompare; entra em jogo. Ao oferecer uma interface gráfica para o programa 'diff', o programa mostra os arquivos de origem e destino lado-a-lado, com todas as diferenças realçadas automaticamente. A partir deste ponto, as alterações num arquivo poderão ser aplicadas seqüencialmente ao outro, usando uma base seletiva e controlada. Nem todas as alterações precisam de ser aplicadas e, se você não quiser aplicar uma alteração, ela poderá sempre ser 'anulada'. Quando todas as alterações necessárias tiverem sido aplicadas, elas poderão ser gravadas e aparecerão de forma normal, como acontece na aplicação usada para criar o arquivo.</para> +<para>O uso do 'diff' na linha de comando poderá ser confusa, a aprendizagem da sintaxe e a decodificação do resultado poderão assustar a maioria das pessoas. Aí é onde o &kompare; entra em jogo. Ao oferecer uma interface gráfica para o programa 'diff', o programa mostra os arquivos de origem e destino lado-a-lado, com todas as diferenças realçadas automaticamente. A partir deste ponto, as alterações num arquivo poderão ser aplicadas seqüencialmente ao outro, usando uma base seletiva e controlada. Nem todas as alterações precisam de ser aplicadas e, se você não quiser aplicar uma alteração, ela poderá sempre ser 'anulada'. Quando todas as alterações necessárias tiverem sido aplicadas, elas poderão ser gravadas e aparecerão de forma normal, como acontece na aplicação usada para criar o arquivo.</para> -<para ->Além de mostrar as diferenças entre um arquivo de origem e um de destino, o &kompare; pode ser usado para criar e ver um arquivo especial, chamado arquivo 'diff'. Este arquivo captura as diferenças entre as duas fontes para um único arquivo, que poderá então ser usado para ver e aplicar as alterações a outra cópia qualquer do arquivo. Por exemplo, se duas pessoas estiverem editando um documento, a primeira pessoa quer fazer alterações e enviar apenas essas alterações à segunda pessoa. Normalmente, a primeira pessoa iria enviar uma cópia completa do documento modificado para a segunda pessoa, que teria depois de comparar o documento modificado, lado-a-lado com a versão não-modificada. O processo é muito semelhante ao descrito nos parágrafos anteriores. Com o &kompare;, a primeira pessoa iria fazer uma cópia local do arquivo a ser modificado, faria as alterações e depois iria comparar o original e a cópia modificada. Agora, ao usar o &kompare;, poderá criar um arquivo 'diff' que captura apenas as alterações feitas. Ele poderá ser enviado para a segunda pessoa, em vez de enviar um arquivo inteiro com os dados e as alterações.</para> +<para>Além de mostrar as diferenças entre um arquivo de origem e um de destino, o &kompare; pode ser usado para criar e ver um arquivo especial, chamado arquivo 'diff'. Este arquivo captura as diferenças entre as duas fontes para um único arquivo, que poderá então ser usado para ver e aplicar as alterações a outra cópia qualquer do arquivo. Por exemplo, se duas pessoas estiverem editando um documento, a primeira pessoa quer fazer alterações e enviar apenas essas alterações à segunda pessoa. Normalmente, a primeira pessoa iria enviar uma cópia completa do documento modificado para a segunda pessoa, que teria depois de comparar o documento modificado, lado-a-lado com a versão não-modificada. O processo é muito semelhante ao descrito nos parágrafos anteriores. Com o &kompare;, a primeira pessoa iria fazer uma cópia local do arquivo a ser modificado, faria as alterações e depois iria comparar o original e a cópia modificada. Agora, ao usar o &kompare;, poderá criar um arquivo 'diff' que captura apenas as alterações feitas. Ele poderá ser enviado para a segunda pessoa, em vez de enviar um arquivo inteiro com os dados e as alterações.</para> -<para ->Usando o &kompare;, a segunda pessoa poderá ver o arquivo 'diff', compará-lo com a cópia local do documento e aplicar as alterações feitas pela primeira pessoa. Assim, o processo poderá funcionar para várias versões do documento, onde cada pessoa faz as alterações, cria os arquivos 'diff', distribui-os e aplica-os. Este processo é conhecido em inglês como "patching", um termo retirado do programa "patch", que é outra ferramenta da linha de comando, desenhada especificamente para aplicar os arquivos do 'diff'.</para> +<para>Usando o &kompare;, a segunda pessoa poderá ver o arquivo 'diff', compará-lo com a cópia local do documento e aplicar as alterações feitas pela primeira pessoa. Assim, o processo poderá funcionar para várias versões do documento, onde cada pessoa faz as alterações, cria os arquivos 'diff', distribui-os e aplica-os. Este processo é conhecido em inglês como "patching", um termo retirado do programa "patch", que é outra ferramenta da linha de comando, desenhada especificamente para aplicar os arquivos do 'diff'.</para> -<para ->Algumas vezes pode ocorrer que existam várias pessoas editando um arquivo ao mesmo tempo. Nesta situação, é provável que as pessoas façam alterações no documento exatamente na mesma linha. Isto gera um problema porque, sem o devido cuidado, as pessoas poderão estar sobrepondo o trabalho das outras, à medida que se aplicam os arquivos de 'diff' que recebem. Felizmente, os programadores dos programas 'diff' e 'patch' levaram isso em conta e, deste modo, estas ferramentas não irão aplicar essas alterações sem alguma intervenção manual. Quando se atinge este estado, isto é referido como um "conflito". O &kompare; irá mostrar os conflitos, de modo que você possa resolvê-los manualmente, decidindo as alterações que deverão ser aplicadas a um determinado arquivo.</para> +<para>Algumas vezes pode ocorrer que existam várias pessoas editando um arquivo ao mesmo tempo. Nesta situação, é provável que as pessoas façam alterações no documento exatamente na mesma linha. Isto gera um problema porque, sem o devido cuidado, as pessoas poderão estar sobrepondo o trabalho das outras, à medida que se aplicam os arquivos de 'diff' que recebem. Felizmente, os programadores dos programas 'diff' e 'patch' levaram isso em conta e, deste modo, estas ferramentas não irão aplicar essas alterações sem alguma intervenção manual. Quando se atinge este estado, isto é referido como um "conflito". O &kompare; irá mostrar os conflitos, de modo que você possa resolvê-los manualmente, decidindo as alterações que deverão ser aplicadas a um determinado arquivo.</para> -<para ->O &kompare; também é um ótimo programa para comparar as alterações de arquivos ao nível da pasta. Quando for usado para comparar pastas, o &kompare; examina recursivamente as sub-pastas e o conteúdo dos seus arquivos, à procura de diferenças. Neste caso, cada um dos arquivos em que foram encontradas diferenças é aberto automaticamente e listado pelo &kompare;, onde é possível navegar facilmente pelos vários arquivos.</para> +<para>O &kompare; também é um ótimo programa para comparar as alterações de arquivos ao nível da pasta. Quando for usado para comparar pastas, o &kompare; examina recursivamente as sub-pastas e o conteúdo dos seus arquivos, à procura de diferenças. Neste caso, cada um dos arquivos em que foram encontradas diferenças é aberto automaticamente e listado pelo &kompare;, onde é possível navegar facilmente pelos vários arquivos.</para> </chapter> <chapter id="using"> -<title ->Usando o &kompare;</title> +<title>Usando o &kompare;</title> <sect1 id="getting-started"> -<title ->Começando</title> +<title>Começando</title> -<para ->Esta seção fornece instruções para iniciar o &kompare; e oferece um rápido passeio pela interface principal do &kompare;.</para> +<para>Esta seção fornece instruções para iniciar o &kompare; e oferece um rápido passeio pela interface principal do &kompare;.</para> <sect2 id="starting-kompare"> -<title ->Iniciando o &kompare;</title> - -<para ->Um atalho para iniciar o &kompare; poderá ser encontrado no menu K, no grupo de Desenvolvimento, em <menuchoice -><guimenu ->Desenvolvimento</guimenu -><guimenuitem ->Kompare</guimenuitem -></menuchoice ->.</para> - -<para ->Quando o &kompare; se inicia, a primeira coisa que faz é mostrar uma janela, na qual poderá selecionar os arquivos que deseja comparar. As opções especiais de propriedades do 'diff', bem como a aparência, poderão também ser aqui selecionadas. No formulário do arquivo, selecione a origem e o destino a comparar. Estes poderão ser dois arquivos, pastas ou um &URL; e um arquivo. Logo que a origem e o destino estejam selecionados, clique no botão <guibutton ->Comparar</guibutton ->.</para> - -<para ->Logo que o &kompare; tenha descoberto as diferenças, ele irá mostrar a interface principal. Ao comparar dois arquivos, ou um URL e um arquivo, o processo levará apenas alguns segundos. Contudo, ao comparar pastas com diversas sub-pastas e arquivos, este processo poderá levar mais tempo.</para> - -<para ->Para uma explicação das opções disponíveis do 'diff', bem como os formatos de aparência, veja a seção <xref linkend="configure-preferences"/>.</para> +<title>Iniciando o &kompare;</title> + +<para>Um atalho para iniciar o &kompare; poderá ser encontrado no menu K, no grupo de Desenvolvimento, em <menuchoice><guimenu>Desenvolvimento</guimenu><guimenuitem>Kompare</guimenuitem></menuchoice>.</para> + +<para>Quando o &kompare; se inicia, a primeira coisa que faz é mostrar uma janela, na qual poderá selecionar os arquivos que deseja comparar. As opções especiais de propriedades do 'diff', bem como a aparência, poderão também ser aqui selecionadas. No formulário do arquivo, selecione a origem e o destino a comparar. Estes poderão ser dois arquivos, pastas ou um &URL; e um arquivo. Logo que a origem e o destino estejam selecionados, clique no botão <guibutton>Comparar</guibutton>.</para> + +<para>Logo que o &kompare; tenha descoberto as diferenças, ele irá mostrar a interface principal. Ao comparar dois arquivos, ou um URL e um arquivo, o processo levará apenas alguns segundos. Contudo, ao comparar pastas com diversas sub-pastas e arquivos, este processo poderá levar mais tempo.</para> + +<para>Para uma explicação das opções disponíveis do 'diff', bem como os formatos de aparência, veja a seção <xref linkend="configure-preferences"/>.</para> </sect2> <sect2 id="main-interface"> -<title ->A Janela Principal</title> +<title>A Janela Principal</title> -<para ->Esta seção oferece um rápido passeio pela janela principal, composta pelas seguintes áreas:</para> +<para>Esta seção oferece um rápido passeio pela janela principal, composta pelas seguintes áreas:</para> <itemizedlist> -<listitem -><para ->Menus</para -></listitem> -<listitem -><para ->Barra de Ferramentas</para -></listitem> -<listitem -><para ->Pastas de Origem e Destino</para -></listitem> -<listitem -><para ->Arquivos de Origem e Destino</para -></listitem> -<listitem -><para ->Mudanças de Linha na Origem e no Destino</para -></listitem> -<listitem -><para ->Área de Texto da Origem e do Destino</para -></listitem> -<listitem -><para ->Barra de Estado</para -></listitem> +<listitem><para>Menus</para></listitem> +<listitem><para>Barra de Ferramentas</para></listitem> +<listitem><para>Pastas de Origem e Destino</para></listitem> +<listitem><para>Arquivos de Origem e Destino</para></listitem> +<listitem><para>Mudanças de Linha na Origem e no Destino</para></listitem> +<listitem><para>Área de Texto da Origem e do Destino</para></listitem> +<listitem><para>Barra de Estado</para></listitem> </itemizedlist> <sect3 id="menus"> -<title ->Menus</title> -<para ->O &kompare; oferece uma interface baseada em menus. Está disponível uma explicação para os itens do menu e as suas opções em <xref linkend="command-reference"/>.</para> +<title>Menus</title> +<para>O &kompare; oferece uma interface baseada em menus. Está disponível uma explicação para os itens do menu e as suas opções em <xref linkend="command-reference"/>.</para> </sect3> <sect3 id="toolbar"> -<title ->Barra de Ferramentas</title> -<para ->A barra de ferramentas do &kompare; oferece atalhos para as operações de diferenças e mesclagem usadas com maior freqüência. A orientação da barra de ferramentas, a posição do texto, as propriedades do tamanho dos ícones e a visibilidade dos ícones de atalho poderão ser personalizadas no menu de contexto da barra de ferramentas, ao clicar com o botão direito do mouse na barra de ferramentas. O menu de contexto da barra de ferramentas também permite ocultar a barra de ferramentas. Se ela ficar oculta e você desejar torná-la visível novamente, selecione a opção do menu <menuchoice -><guimenu ->Configurações</guimenu -><guimenuitem ->Mostrar a Barra de Ferramentas</guimenuitem -></menuchoice ->.</para> +<title>Barra de Ferramentas</title> +<para>A barra de ferramentas do &kompare; oferece atalhos para as operações de diferenças e mesclagem usadas com maior freqüência. A orientação da barra de ferramentas, a posição do texto, as propriedades do tamanho dos ícones e a visibilidade dos ícones de atalho poderão ser personalizadas no menu de contexto da barra de ferramentas, ao clicar com o botão direito do mouse na barra de ferramentas. O menu de contexto da barra de ferramentas também permite ocultar a barra de ferramentas. Se ela ficar oculta e você desejar torná-la visível novamente, selecione a opção do menu <menuchoice><guimenu>Configurações</guimenu><guimenuitem>Mostrar a Barra de Ferramentas</guimenuitem></menuchoice>.</para> </sect3> <sect3 id="source-destination-folders"> -<title ->Pastas de Origem e Destino</title> -<para ->A área das pastas de origem e destino mostram as pastas nas quais se encontram os arquivos comparados. Quando estiverem incluídas várias pastas na comparação, então a seleção de uma pasta irá mostrar o primeiro documento nessa pasta onde foi encontrada uma diferença entre a origem e o destino.</para> +<title>Pastas de Origem e Destino</title> +<para>A área das pastas de origem e destino mostram as pastas nas quais se encontram os arquivos comparados. Quando estiverem incluídas várias pastas na comparação, então a seleção de uma pasta irá mostrar o primeiro documento nessa pasta onde foi encontrada uma diferença entre a origem e o destino.</para> </sect3> <sect3 id="source-destination-files"> -<title ->Arquivos de Origem e Destino</title> -<para ->A área dos arquivos de origem e destino mostram os arquivos em que foram encontradas diferenças, tanto para a pasta de origem como a de destino. Quando uma determinada pasta tiver vários documentos com diferenças, serão apresentados todos os documentos com diferenças. O documento que estiver selecionado nesta área estará visível.</para> +<title>Arquivos de Origem e Destino</title> +<para>A área dos arquivos de origem e destino mostram os arquivos em que foram encontradas diferenças, tanto para a pasta de origem como a de destino. Quando uma determinada pasta tiver vários documentos com diferenças, serão apresentados todos os documentos com diferenças. O documento que estiver selecionado nesta área estará visível.</para> </sect3> <sect3 id="source-destination-lines"> -<title ->Mudanças de Linha na Origem e Destino</title> -<para ->A área das mudanças de linhas da origem e destino resumem as diferenças encontradas entre os documentos de origem e de destino. Se selecionar um registro nessa área, irá realçar e selecionar a diferença. Esta é uma forma útil de navegar e inspecionar os documentos grandes com muitas diferenças.</para> +<title>Mudanças de Linha na Origem e Destino</title> +<para>A área das mudanças de linhas da origem e destino resumem as diferenças encontradas entre os documentos de origem e de destino. Se selecionar um registro nessa área, irá realçar e selecionar a diferença. Esta é uma forma útil de navegar e inspecionar os documentos grandes com muitas diferenças.</para> </sect3> <sect3 id="source-destination-view"> -<title ->Área de Origem e de Destino</title> -<para ->A área de origem e destino é o espaço de trabalho principal do &kompare;. O conteúdo e as diferenças realçadas, para o arquivo de origem e destino selecionado atualmente, aparecem aqui com os números de linha.</para> +<title>Área de Origem e de Destino</title> +<para>A área de origem e destino é o espaço de trabalho principal do &kompare;. O conteúdo e as diferenças realçadas, para o arquivo de origem e destino selecionado atualmente, aparecem aqui com os números de linha.</para> </sect3> <sect3 id="text-view"> -<title ->Área do Texto</title> -<para ->A <guilabel ->Área de Texto</guilabel -> não aparece por padrão. Esta poderá ser aberta selecionando a opção <menuchoice -><guimenu ->Configurações</guimenu -><guimenuitem ->Mostrar Área de Texto</guimenuitem -></menuchoice ->.</para> +<title>Área do Texto</title> +<para>A <guilabel>Área de Texto</guilabel> não aparece por padrão. Esta poderá ser aberta selecionando a opção <menuchoice><guimenu>Configurações</guimenu><guimenuitem>Mostrar Área de Texto</guimenuitem></menuchoice>.</para> <!-- Other than a notepad, what is this text view good for? --> </sect3> <sect3 id="statusbar"> -<title ->Barra de Estado</title> -<para ->A barra de estado oferece um resumo do arquivo ou pasta de origem e de destino a serem comparados. A barra de estado apresenta também o número alterações encontradas no documento atual e conta as diferenças que foram aplicadas. Além disso, a barra de estado mostra o número global de documentos que contém diferenças, bem como o número do documento atualmente selecionado neste conjunto. Por exemplo, uma comparação efetuada sobre duas pastas poderá devolver 1890 arquivos com diferenças. O documento atualmente selecionado é o número 18 de 1890.</para> +<title>Barra de Estado</title> +<para>A barra de estado oferece um resumo do arquivo ou pasta de origem e de destino a serem comparados. A barra de estado apresenta também o número alterações encontradas no documento atual e conta as diferenças que foram aplicadas. Além disso, a barra de estado mostra o número global de documentos que contém diferenças, bem como o número do documento atualmente selecionado neste conjunto. Por exemplo, uma comparação efetuada sobre duas pastas poderá devolver 1890 arquivos com diferenças. O documento atualmente selecionado é o número 18 de 1890.</para> </sect3> </sect2> </sect1> <sect1 id="viewing-differences"> -<title ->Vendo as Diferenças</title> +<title>Vendo as Diferenças</title> <sect2 id="managing-screen-real-estate"> -<title ->Gerenciado o Espaço Livre da Tela</title> -<para ->O &kompare; mostra o arquivo de origem e de destino com uma percentagem igual à área de trabalho da interface principal. Esta área de visualização oferece algumas funcionalidades que ajudam a otimizar a utilização do espaço livre da tela, enquanto você vê as diferenças, incluindo:</para> +<title>Gerenciado o Espaço Livre da Tela</title> +<para>O &kompare; mostra o arquivo de origem e de destino com uma percentagem igual à área de trabalho da interface principal. Esta área de visualização oferece algumas funcionalidades que ajudam a otimizar a utilização do espaço livre da tela, enquanto você vê as diferenças, incluindo:</para> <variablelist> <varlistentry> -<term ->Barras de Rolagem Duplas</term> -<listitem -><para ->A funcionalidade mais óbvia é que as barras de rolagem aparecem ambas nas pontas direita e inferior da área de visualização. Com as barras de rolagem, é possível percorrer rapidamente a comparação.</para -></listitem> +<term>Barras de Rolagem Duplas</term> +<listitem><para>A funcionalidade mais óbvia é que as barras de rolagem aparecem ambas nas pontas direita e inferior da área de visualização. Com as barras de rolagem, é possível percorrer rapidamente a comparação.</para></listitem> </varlistentry> <varlistentry> -<term ->Pega de Divisão Compartilhada</term> -<listitem -><para ->O espaço vertical entre a visão da origem e do destino não só possibilita a visualização clara do início e fim da linhas em cada uma das áreas, assim como é também uma pega que permite o ajuste da percentagem ocupada pelas áreas de origem e destino que compõem a área de visualização. Para mudar o tamanho de uma das áreas, passe o cursor do mouse pela pega e mantenha o botão do mouse pressionado, deslocando depois o mouse para a esquerda ou para a direita. Naturalmente, aumentar a área de uma dessas zonas, irá diminuir a área disponível para a área oposta, dentro da área de visualização.</para -></listitem> +<term>Pega de Divisão Compartilhada</term> +<listitem><para>O espaço vertical entre a visão da origem e do destino não só possibilita a visualização clara do início e fim da linhas em cada uma das áreas, assim como é também uma pega que permite o ajuste da percentagem ocupada pelas áreas de origem e destino que compõem a área de visualização. Para mudar o tamanho de uma das áreas, passe o cursor do mouse pela pega e mantenha o botão do mouse pressionado, deslocando depois o mouse para a esquerda ou para a direita. Naturalmente, aumentar a área de uma dessas zonas, irá diminuir a área disponível para a área oposta, dentro da área de visualização.</para></listitem> </varlistentry> <varlistentry> -<term ->Acoplagem</term> -<listitem -><para ->O espaço de trabalho principal poderá ser desacoplado da interface principal, clicando-se no botão <guibutton ->desacoplar</guibutton ->, que aparece no canto superior direito do painel principal do espaço de trabalho. Este botão abre o espaço de trabalho principal numa janela própria, permitindo-lhe ser maximizado e dimensionado na tela.</para -></listitem> +<term>Acoplagem</term> +<listitem><para>O espaço de trabalho principal poderá ser desacoplado da interface principal, clicando-se no botão <guibutton>desacoplar</guibutton>, que aparece no canto superior direito do painel principal do espaço de trabalho. Este botão abre o espaço de trabalho principal numa janela própria, permitindo-lhe ser maximizado e dimensionado na tela.</para></listitem> </varlistentry> <varlistentry> -<term ->Comutar a Barra de Estado</term> +<term>Comutar a Barra de Estado</term> <listitem> -<para ->A barra de estado do painel de visualização poderá ser comutada selecionando-se a opção <menuchoice -><guimenu ->Configurações</guimenu -><guimenuitem ->Ocultar/Mostrar a Barra de Estado</guimenuitem -></menuchoice ->.</para> +<para>A barra de estado do painel de visualização poderá ser comutada selecionando-se a opção <menuchoice><guimenu>Configurações</guimenu><guimenuitem>Ocultar/Mostrar a Barra de Estado</guimenuitem></menuchoice>.</para> </listitem> </varlistentry> </variablelist> </sect2> <sect2 id="switching-source-and-destination-view"> -<title ->Alternando entre as Janelas de Origem e Destino</title> - -<para ->Algumas vezes poderá ser útil considerar que o arquivo onde serão aplicadas as diferenças passe a ser o original. Por exemplo, ao comparar duas versões modificadas de um arquivo, e se descobrir que um arquivo tem muitas mais alterações que o outro. O arquivo com mais alterações será melhor como original, uma vez que serão necessárias menos aplicações de diferenças.</para> -<para ->Neste caso, selecione a opção <menuchoice -><guimenu ->Arquivo</guimenu -><guimenuitem ->Trocar a Origem com o Destino</guimenuitem -></menuchoice ->. Isto irá trocar os arquivos que aparecem nos painéis do &kompare;.</para> +<title>Alternando entre as Janelas de Origem e Destino</title> + +<para>Algumas vezes poderá ser útil considerar que o arquivo onde serão aplicadas as diferenças passe a ser o original. Por exemplo, ao comparar duas versões modificadas de um arquivo, e se descobrir que um arquivo tem muitas mais alterações que o outro. O arquivo com mais alterações será melhor como original, uma vez que serão necessárias menos aplicações de diferenças.</para> +<para>Neste caso, selecione a opção <menuchoice><guimenu>Arquivo</guimenu><guimenuitem>Trocar a Origem com o Destino</guimenuitem></menuchoice>. Isto irá trocar os arquivos que aparecem nos painéis do &kompare;.</para> </sect2> <sect2 id="display-difference-statistics"> -<title ->Mostrando as Estatísticas das Diferenças</title> -<para ->Para uma visão geral das diferenças, selecione a opção <menuchoice -><guimenu ->Arquivo</guimenu -><guimenuitem ->Mostrar Estatísticas</guimenuitem -></menuchoice ->. Isto irá mostrar a janela de <guilabel ->Estatísticas das Diferenças</guilabel ->. Aparecerá então a seguinte informação:</para> +<title>Mostrando as Estatísticas das Diferenças</title> +<para>Para uma visão geral das diferenças, selecione a opção <menuchoice><guimenu>Arquivo</guimenu><guimenuitem>Mostrar Estatísticas</guimenuitem></menuchoice>. Isto irá mostrar a janela de <guilabel>Estatísticas das Diferenças</guilabel>. Aparecerá então a seguinte informação:</para> <variablelist> <varlistentry> -<term -><guilabel ->Arquivo antigo:</guilabel -></term> -<listitem -><para ->O nome do arquivo normalmente usado como destino ou o arquivo que não foi modificado, sobre o qual serão aplicadas as diferenças.</para -></listitem> +<term><guilabel>Arquivo antigo:</guilabel></term> +<listitem><para>O nome do arquivo normalmente usado como destino ou o arquivo que não foi modificado, sobre o qual serão aplicadas as diferenças.</para></listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Arquivo novo:</guilabel -></term> -<listitem -><para ->O nome do arquivo que é normalmente o arquivo de origem ou o arquivo que foi modificado.</para -></listitem> +<term><guilabel>Arquivo novo:</guilabel></term> +<listitem><para>O nome do arquivo que é normalmente o arquivo de origem ou o arquivo que foi modificado.</para></listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Formato:</guilabel -></term> -<listitem -><para ->O formato de diferenças que é usado para mostrar as diferenças (veja em <xref linkend="diff-format"/>).</para -></listitem> +<term><guilabel>Formato:</guilabel></term> +<listitem><para>O formato de diferenças que é usado para mostrar as diferenças (veja em <xref linkend="diff-format"/>).</para></listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Número de blocos:</guilabel -></term> +<term><guilabel>Número de blocos:</guilabel></term> <listitem> -<para ->O número de blocos que foram encontrados na diferença.</para> -<para ->Um bloco é um <quote ->conjunto</quote -> de linhas que foram marcadas como diferentes, entre a origem e o destino, e que poderão incluir as linhas de contexto, dependendo do valor das <guilabel ->Linhas de Contexto</guilabel -> do formato de diferenças (veja em <xref linkend="diff-format"/>).</para -></listitem> +<para>O número de blocos que foram encontrados na diferença.</para> +<para>Um bloco é um <quote>conjunto</quote> de linhas que foram marcadas como diferentes, entre a origem e o destino, e que poderão incluir as linhas de contexto, dependendo do valor das <guilabel>Linhas de Contexto</guilabel> do formato de diferenças (veja em <xref linkend="diff-format"/>).</para></listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Número de diferenças</guilabel -></term> -<listitem -><para ->O número atual de diferenças encontradas, não os blocos. Um bloco poderá conter uma ou mais diferenças, quando a mudança de linhas e as linhas de contexto de duas ou mais alterações se sobrepõem.</para -></listitem> +<term><guilabel>Número de diferenças</guilabel></term> +<listitem><para>O número atual de diferenças encontradas, não os blocos. Um bloco poderá conter uma ou mais diferenças, quando a mudança de linhas e as linhas de contexto de duas ou mais alterações se sobrepõem.</para></listitem> </varlistentry> </variablelist> </sect2> <sect2 id="navigating-the-difference-view"> -<title ->Navegando na Área de Diferenças</title> -<para ->O &kompare; ativa a navegação rápida das diferenças, a nível do arquivo, e de vários arquivos com diferenças, ao comparar árvores de pastas.</para> +<title>Navegando na Área de Diferenças</title> +<para>O &kompare; ativa a navegação rápida das diferenças, a nível do arquivo, e de vários arquivos com diferenças, ao comparar árvores de pastas.</para> <sect3 id="selecting-a-difference"> -<title ->Selecionando uma Diferença</title> -<para ->Uma diferença poderá ser selecionada das seguintes maneiras:</para> +<title>Selecionando uma Diferença</title> +<para>Uma diferença poderá ser selecionada das seguintes maneiras:</para> <itemizedlist> -<listitem -><para ->clicando numa linha da área de Mudanças de Linha na Origem e no Destino (canto superior direito da janela principal).</para -></listitem> -<listitem -><para ->clicando na diferença selecionada, na área de Visualização.</para -></listitem> -<listitem -><para ->percorrendo as diferenças listadas numa comparação (ver em <xref linkend="traversing-differences"/>).</para -></listitem> +<listitem><para>clicando numa linha da área de Mudanças de Linha na Origem e no Destino (canto superior direito da janela principal).</para></listitem> +<listitem><para>clicando na diferença selecionada, na área de Visualização.</para></listitem> +<listitem><para>percorrendo as diferenças listadas numa comparação (ver em <xref linkend="traversing-differences"/>).</para></listitem> </itemizedlist> -<para ->Quando for selecionada uma diferença, considera-se que ela fica <quote ->em primeiro plano</quote ->, aparecendo com uma cor mais clara que as diferenças não selecionadas.</para> +<para>Quando for selecionada uma diferença, considera-se que ela fica <quote>em primeiro plano</quote>, aparecendo com uma cor mais clara que as diferenças não selecionadas.</para> </sect3> <sect3 id="traversing-differences"> -<title ->Percorrendo as Diferenças</title> -<para ->Quando uma comparação descobrir diversas diferenças, uma das melhores formas de revê-las é percorrer as diferenças em uma ordem lógica, normalmente de cima para baixo.</para> -<para ->Por padrão, o &kompare; seleciona a primeira diferença encontrada numa comparação. Ao selecionar a opção <menuchoice -><guimenu ->Diferença</guimenu -><guimenuitem ->Diferença Seguinte</guimenuitem -></menuchoice -> (<keycombo action="simul" ->&Ctrl;<keycap ->Baixo</keycap -></keycombo ->), a diferença subseqüente à seleção atual ficará em primeiro plano. Para selecionar a diferença anterior à atual, selecione a opção <menuchoice -><guimenu ->Diferença</guimenu -><guimenuitem ->Diferença Anterior</guimenuitem -></menuchoice -> (<keycombo action="simul" ->&Ctrl;<keycap ->Cima</keycap -></keycombo ->).</para> -<para ->Desta forma, é possível percorrer as diferenças de forma ordenada, aplicando e revogando as diferenças em revisão.</para> +<title>Percorrendo as Diferenças</title> +<para>Quando uma comparação descobrir diversas diferenças, uma das melhores formas de revê-las é percorrer as diferenças em uma ordem lógica, normalmente de cima para baixo.</para> +<para>Por padrão, o &kompare; seleciona a primeira diferença encontrada numa comparação. Ao selecionar a opção <menuchoice><guimenu>Diferença</guimenu><guimenuitem>Diferença Seguinte</guimenuitem></menuchoice> (<keycombo action="simul">&Ctrl;<keycap>Baixo</keycap></keycombo>), a diferença subseqüente à seleção atual ficará em primeiro plano. Para selecionar a diferença anterior à atual, selecione a opção <menuchoice><guimenu>Diferença</guimenu><guimenuitem>Diferença Anterior</guimenuitem></menuchoice> (<keycombo action="simul">&Ctrl;<keycap>Cima</keycap></keycombo>).</para> +<para>Desta forma, é possível percorrer as diferenças de forma ordenada, aplicando e revogando as diferenças em revisão.</para> </sect3> <sect3 id="switching-between-files"> -<title ->Alternando entre Arquivos</title> -<para ->Quando for efetuada uma comparação a nível de uma pasta, poderão aparecer diversos arquivos com diferenças. Aparecerá então uma lista completa dos arquivos comparados, com as diferenças encontradas aparecendo em <quote ->Pastas de Origem e Destino</quote -> e nos <quote ->Arquivos de Origem e Destino</quote ->. Contudo, o &kompare; mostra as diferenças entre a origem e o destino, com uma comparação de cada vez.</para> -<para ->Para mudar de documento, neste cenário, estão disponíveis as seguintes opções:</para> +<title>Alternando entre Arquivos</title> +<para>Quando for efetuada uma comparação a nível de uma pasta, poderão aparecer diversos arquivos com diferenças. Aparecerá então uma lista completa dos arquivos comparados, com as diferenças encontradas aparecendo em <quote>Pastas de Origem e Destino</quote> e nos <quote>Arquivos de Origem e Destino</quote>. Contudo, o &kompare; mostra as diferenças entre a origem e o destino, com uma comparação de cada vez.</para> +<para>Para mudar de documento, neste cenário, estão disponíveis as seguintes opções:</para> <itemizedlist> -<listitem -><para ->Selecione a área de <quote ->Pastas de Origem e Destino</quote -> para mostrar as diferenças de arquivos que aparecem na área de <quote ->Arquivos de Origem e Destino</quote ->, selecionando depois um arquivo.</para -></listitem> -<listitem -><para ->Selecione a opção <menuchoice -><guimenu ->Diferença</guimenu -><guimenuitem ->Arquivo Anterior</guimenuitem -></menuchoice -> (<keycombo action="simul" ->&Ctrl;<keycap ->PageUp</keycap -></keycombo ->) ou <menuchoice -><guimenu ->Diferença</guimenu -><guimenuitem ->Arquivo Seguinte</guimenuitem -></menuchoice -> (<keycombo action="simul" ->&Ctrl;<keycap ->PageDown</keycap -></keycombo ->) para mostrar o arquivo com diferenças anterior ou seguinte, na área de <quote ->Arquivos de Origem e Destino</quote ->.</para> +<listitem><para>Selecione a área de <quote>Pastas de Origem e Destino</quote> para mostrar as diferenças de arquivos que aparecem na área de <quote>Arquivos de Origem e Destino</quote>, selecionando depois um arquivo.</para></listitem> +<listitem><para>Selecione a opção <menuchoice><guimenu>Diferença</guimenu><guimenuitem>Arquivo Anterior</guimenuitem></menuchoice> (<keycombo action="simul">&Ctrl;<keycap>PageUp</keycap></keycombo>) ou <menuchoice><guimenu>Diferença</guimenu><guimenuitem>Arquivo Seguinte</guimenuitem></menuchoice> (<keycombo action="simul">&Ctrl;<keycap>PageDown</keycap></keycombo>) para mostrar o arquivo com diferenças anterior ou seguinte, na área de <quote>Arquivos de Origem e Destino</quote>.</para> </listitem> </itemizedlist> </sect3> @@ -512,677 +243,324 @@ </sect1> <sect1 id="merging-differences"> -<title ->Mesclando Diferenças</title> +<title>Mesclando Diferenças</title> -<para ->O &kompare; torna a tarefa de aplicação e anulação das diferenças tão simples como 'apontar e clicar'. Você poderá efetuar várias operações de aplicação e anulação de diferenças, uma vez que todas as operações são efetuadas em memória e não são gravadas nos arquivos em disco, até que a operação de gravação seja efetuada.</para> +<para>O &kompare; torna a tarefa de aplicação e anulação das diferenças tão simples como 'apontar e clicar'. Você poderá efetuar várias operações de aplicação e anulação de diferenças, uma vez que todas as operações são efetuadas em memória e não são gravadas nos arquivos em disco, até que a operação de gravação seja efetuada.</para> <sect2 id="applying-a-difference"> -<title ->Aplicando uma Diferença</title> -<para ->Para aplicar uma diferença, clique na região realçada da diferença, selecionando depois a opção <menuchoice -><guimenu ->Diferença</guimenu -><guimenuitem ->Aplicar a Diferença</guimenuitem -></menuchoice -> (<keycombo -><keycap ->Espaço</keycap -></keycombo ->).</para> +<title>Aplicando uma Diferença</title> +<para>Para aplicar uma diferença, clique na região realçada da diferença, selecionando depois a opção <menuchoice><guimenu>Diferença</guimenu><guimenuitem>Aplicar a Diferença</guimenuitem></menuchoice> (<keycombo><keycap>Espaço</keycap></keycombo>).</para> </sect2> <sect2 id="unapplying-a-difference"> -<title ->Anulando a Aplicação de uma Diferença</title> -<para ->Para cancelar a aplicação de uma diferença, clique na região previamente selecionada para aplicação e escolha depois a opção <menuchoice -><guimenu ->Diferença</guimenu -><guimenuitem ->Ignorar a Diferença</guimenuitem -></menuchoice -> (<keycombo -><keycap ->Backspace</keycap -></keycombo ->).</para> +<title>Anulando a Aplicação de uma Diferença</title> +<para>Para cancelar a aplicação de uma diferença, clique na região previamente selecionada para aplicação e escolha depois a opção <menuchoice><guimenu>Diferença</guimenu><guimenuitem>Ignorar a Diferença</guimenuitem></menuchoice> (<keycombo><keycap>Backspace</keycap></keycombo>).</para> </sect2> <sect2 id="applying-all-differences"> -<title ->Aplicando Todas as Diferenças</title> -<para ->Depois de rever as diferenças entre arquivos e de ter considerado todas as diferenças aceitáveis, é possível aplicá-las todas com uma única operação, selecionando a opção <menuchoice -><guimenu ->Diferença</guimenu -><guimenuitem ->Aplicar Tudo</guimenuitem -></menuchoice -> (<keycombo action="simul" ->&Ctrl;<keycap ->A</keycap -></keycombo ->).</para> +<title>Aplicando Todas as Diferenças</title> +<para>Depois de rever as diferenças entre arquivos e de ter considerado todas as diferenças aceitáveis, é possível aplicá-las todas com uma única operação, selecionando a opção <menuchoice><guimenu>Diferença</guimenu><guimenuitem>Aplicar Tudo</guimenuitem></menuchoice> (<keycombo action="simul">&Ctrl;<keycap>A</keycap></keycombo>).</para> </sect2> <sect2 id="unapplying-all-differences"> -<title ->Ignorando Todas as Diferenças</title> -<para ->Para as diferenças que tenham sido aplicadas, selecione a opção <menuchoice -><guimenu ->Diferença</guimenu -><guimenuitem ->Ignorar Tudo</guimenuitem -></menuchoice -> (<keycombo action="simul" ->&Ctrl;<keycap ->U</keycap -></keycombo ->).</para> +<title>Ignorando Todas as Diferenças</title> +<para>Para as diferenças que tenham sido aplicadas, selecione a opção <menuchoice><guimenu>Diferença</guimenu><guimenuitem>Ignorar Tudo</guimenuitem></menuchoice> (<keycombo action="simul">&Ctrl;<keycap>U</keycap></keycombo>).</para> </sect2> <sect2 id="saving-changes"> -<title ->Salvando Alterações</title> -<para ->Logo que as diferenças tenham sido aplicadas, poderão ser gravadas se selecionar a opção <menuchoice -><guimenu ->Arquivo</guimenu -><guimenuitem ->Salvar</guimenuitem -></menuchoice -> ou <menuchoice -><guimenu ->Arquivo</guimenu -><guimenuitem ->Salvar Tudo...</guimenuitem -></menuchoice ->.</para> -<para ->As diferenças aplicadas são salvas tanto no arquivo de origem como no destino.</para> +<title>Salvando Alterações</title> +<para>Logo que as diferenças tenham sido aplicadas, poderão ser gravadas se selecionar a opção <menuchoice><guimenu>Arquivo</guimenu><guimenuitem>Salvar</guimenuitem></menuchoice> ou <menuchoice><guimenu>Arquivo</guimenu><guimenuitem>Salvar Tudo...</guimenuitem></menuchoice>.</para> +<para>As diferenças aplicadas são salvas tanto no arquivo de origem como no destino.</para> </sect2> </sect1> <sect1 id="working-with-diff-files"> -<title ->Trabalhando com Arquivos do 'Diff'</title> -<para ->Os arquivos do 'diff' contém apenas as alterações feitas entre arquivos, ou um conjunto de arquivos dentro de um sistema de pastas, podendo ou não conter um número de linhas de contexto, antes e depois das alterações de linhas. O somatório de uma mudança de linha e das suas linhas de contexto chama-se 'bloco'. Um arquivo do 'diff' contém deste modo diversos blocos de um ou mais arquivos. Quando as linhas de contexto de dois ou mais blocos se sobreporem, são consideradas um único bloco. Os arquivos do 'diff' poderão ser usados para:</para> +<title>Trabalhando com Arquivos do 'Diff'</title> +<para>Os arquivos do 'diff' contém apenas as alterações feitas entre arquivos, ou um conjunto de arquivos dentro de um sistema de pastas, podendo ou não conter um número de linhas de contexto, antes e depois das alterações de linhas. O somatório de uma mudança de linha e das suas linhas de contexto chama-se 'bloco'. Um arquivo do 'diff' contém deste modo diversos blocos de um ou mais arquivos. Quando as linhas de contexto de dois ou mais blocos se sobreporem, são consideradas um único bloco. Os arquivos do 'diff' poderão ser usados para:</para> <itemizedlist> -<listitem -><para ->Aplicar as alterações contidas nos blocos sobre um arquivo original.</para -></listitem> -<listitem -><para ->Aplicar as alterações contidas nos blocos num arquivo ou conjunto de arquivos, dentro de um sistema de pastas.</para -></listitem> -<listitem -><para ->Efetuar modificações, antes de aplicar as diferenças a um arquivo ou conjunto de arquivos originais, dentro de um sistema de pastas.</para -></listitem> +<listitem><para>Aplicar as alterações contidas nos blocos sobre um arquivo original.</para></listitem> +<listitem><para>Aplicar as alterações contidas nos blocos num arquivo ou conjunto de arquivos, dentro de um sistema de pastas.</para></listitem> +<listitem><para>Efetuar modificações, antes de aplicar as diferenças a um arquivo ou conjunto de arquivos originais, dentro de um sistema de pastas.</para></listitem> </itemizedlist> <sect2 id="creating-a-diff"> -<title ->Criando as Diferenças</title> -<para ->Para criar um arquivo do 'diff', é necessário mostrar uma comparação no &kompare;. Assumindo que é este o caso, selecione depois a opção <menuchoice -><guimenu ->Arquivo</guimenu -><guimenuitem ->Salvar o .diff</guimenuitem -></menuchoice ->. Isto irá mostrar a janela de <guilabel ->Opções do Diff</guilabel -> (veja mais informações em <xref linkend="diff-settings"/> sobre os formatos e opções do 'diff'). Depois de configurar estas opções, clique no botão <guibutton ->Salvar</guibutton -> e grave as diferenças num arquivo com a extensão <filename class="extension" ->.diff</filename ->.</para> +<title>Criando as Diferenças</title> +<para>Para criar um arquivo do 'diff', é necessário mostrar uma comparação no &kompare;. Assumindo que é este o caso, selecione depois a opção <menuchoice><guimenu>Arquivo</guimenu><guimenuitem>Salvar o .diff</guimenuitem></menuchoice>. Isto irá mostrar a janela de <guilabel>Opções do Diff</guilabel> (veja mais informações em <xref linkend="diff-settings"/> sobre os formatos e opções do 'diff'). Depois de configurar estas opções, clique no botão <guibutton>Salvar</guibutton> e grave as diferenças num arquivo com a extensão <filename class="extension">.diff</filename>.</para> </sect2> <sect2 id="displaying-a-diff"> -<title ->Mostrando as Diferenças</title> -<para ->É possível mostrar o conteúdo de um arquivo de diferenças no &kompare;, abrindo o arquivo do 'diff' em <menuchoice -><guimenu ->Arquivo</guimenu -><guimenuitem ->Abrir o Diff...</guimenuitem -></menuchoice ->.</para> -<para ->Ao ver um arquivo de diferenças, são apresentados os blocos entre o arquivo de origem e de destino; lembre-se que só são apresentados esses blocos, as linhas não-modificadas não o são. Em alguns casos, um arquivo do 'diff' é criado sem linhas de contexto. Nesse caso, só são apresentadas as linhas alteradas.</para> -<para ->Quando um arquivo de diferenças contiver blocos de vários arquivos, o &kompare; mostra os blocos de cada arquivo, um de cada vez, e você poderá mudar entre arquivos, como se fossem arquivos reais, mesmo que esta informação só seja fornecida pelo conteúdo do arquivo do 'diff'.</para> +<title>Mostrando as Diferenças</title> +<para>É possível mostrar o conteúdo de um arquivo de diferenças no &kompare;, abrindo o arquivo do 'diff' em <menuchoice><guimenu>Arquivo</guimenu><guimenuitem>Abrir o Diff...</guimenuitem></menuchoice>.</para> +<para>Ao ver um arquivo de diferenças, são apresentados os blocos entre o arquivo de origem e de destino; lembre-se que só são apresentados esses blocos, as linhas não-modificadas não o são. Em alguns casos, um arquivo do 'diff' é criado sem linhas de contexto. Nesse caso, só são apresentadas as linhas alteradas.</para> +<para>Quando um arquivo de diferenças contiver blocos de vários arquivos, o &kompare; mostra os blocos de cada arquivo, um de cada vez, e você poderá mudar entre arquivos, como se fossem arquivos reais, mesmo que esta informação só seja fornecida pelo conteúdo do arquivo do 'diff'.</para> </sect2> <sect2 id="applying-a-diff"> -<title ->Aplicando as Diferenças num Arquivo do 'Diff'</title> -<para ->Ao ver as diferenças de um arquivo do 'diff', é possível aplicar as diferenças, como o faria ao comparar os arquivos de origem e de destino (veja em <xref linkend="merging-differences"/>).</para> +<title>Aplicando as Diferenças num Arquivo do 'Diff'</title> +<para>Ao ver as diferenças de um arquivo do 'diff', é possível aplicar as diferenças, como o faria ao comparar os arquivos de origem e de destino (veja em <xref linkend="merging-differences"/>).</para> </sect2> <sect2 id="blending-a-diff"> -<title ->Fundindo um &URL; com um 'Diff'</title> -<para ->Nos casos em que seja fornecido um arquivo do 'diff', é possível comparar os blocos no 'diff' com um arquivo ou pasta. Para o fazer, selecione a opção <menuchoice -><guimenu ->Arquivo</guimenu -><guimenuitem ->Fundir o URL com o Diff...</guimenuitem -></menuchoice ->. Depois, introduza a localização do <guilabel ->Arquivo/Pasta</guilabel -> e o <guilabel ->Resultado do 'Diff'</guilabel ->.</para> -<para ->Ao ver as diferenças entre um arquivo de origem e um arquivo do 'diff', é possível aplicar as diferenças, como o faria ao comparar os arquivos de origem e de destino (veja em <xref linkend="merging-differences"/>).</para> +<title>Fundindo um &URL; com um 'Diff'</title> +<para>Nos casos em que seja fornecido um arquivo do 'diff', é possível comparar os blocos no 'diff' com um arquivo ou pasta. Para o fazer, selecione a opção <menuchoice><guimenu>Arquivo</guimenu><guimenuitem>Fundir o URL com o Diff...</guimenuitem></menuchoice>. Depois, introduza a localização do <guilabel>Arquivo/Pasta</guilabel> e o <guilabel>Resultado do 'Diff'</guilabel>.</para> +<para>Ao ver as diferenças entre um arquivo de origem e um arquivo do 'diff', é possível aplicar as diferenças, como o faria ao comparar os arquivos de origem e de destino (veja em <xref linkend="merging-differences"/>).</para> </sect2> </sect1> </chapter> <chapter id="configure-preferences"> -<title ->Configurando as Preferências</title> - -<para ->O &kompare; permite aos usuários definirem as preferências de aparência, de modo a formatar as diferenças na interface principal, bem como definir propriedades de comportamento do programa' diff'. A janela de <guilabel ->Preferências</guilabel -> poderá ser acessada selecionando-se a opção <menuchoice -><guimenu ->Configurações</guimenu -><guisubmenu ->Configurar o &kompare;...</guisubmenu -></menuchoice ->.</para> - -<para ->Para configurar as preferências da aparência, selecione o item do menu <guilabel ->Ver</guilabel -> (veja em <xref linkend="view-settings"/>).</para> - -<para ->Para configurar as preferências do programa 'diff', selecione o item de menu <guilabel ->Diff</guilabel -> (veja em <xref linkend="diff-settings"/>).</para> +<title>Configurando as Preferências</title> + +<para>O &kompare; permite aos usuários definirem as preferências de aparência, de modo a formatar as diferenças na interface principal, bem como definir propriedades de comportamento do programa' diff'. A janela de <guilabel>Preferências</guilabel> poderá ser acessada selecionando-se a opção <menuchoice><guimenu>Configurações</guimenu><guisubmenu>Configurar o &kompare;...</guisubmenu></menuchoice>.</para> + +<para>Para configurar as preferências da aparência, selecione o item do menu <guilabel>Ver</guilabel> (veja em <xref linkend="view-settings"/>).</para> + +<para>Para configurar as preferências do programa 'diff', selecione o item de menu <guilabel>Diff</guilabel> (veja em <xref linkend="diff-settings"/>).</para> <sect1 id="view-settings"> -<title ->Configurações de Visualização</title> -<para ->O menu <guimenu ->Ver</guimenu ->, que aparece na janela de <guilabel ->Preferências</guilabel ->, mostra os formulários <guilabel ->Aparência</guilabel -> e <guilabel ->Fontes</guilabel ->.</para> +<title>Configurações de Visualização</title> +<para>O menu <guimenu>Ver</guimenu>, que aparece na janela de <guilabel>Preferências</guilabel>, mostra os formulários <guilabel>Aparência</guilabel> e <guilabel>Fontes</guilabel>.</para> <sect2 id="appearance"> -<title ->Aparência</title> -<para ->O formulário <guilabel ->Aparência</guilabel -> mostra controles para gerenciar as <guilabel ->Cores</guilabel -> usadas para visualizar as diferenças na interface principal, o comportamento da <guilabel ->Roda do Mouse</guilabel -> ao deslocá-la e como é gerenciada a conversão de <guilabel ->Tabulações para Espaços</guilabel ->.</para> +<title>Aparência</title> +<para>O formulário <guilabel>Aparência</guilabel> mostra controles para gerenciar as <guilabel>Cores</guilabel> usadas para visualizar as diferenças na interface principal, o comportamento da <guilabel>Roda do Mouse</guilabel> ao deslocá-la e como é gerenciada a conversão de <guilabel>Tabulações para Espaços</guilabel>.</para> <screenshot> -<screeninfo ->Configurações da Aparência do &kompare;</screeninfo> +<screeninfo>Configurações da Aparência do &kompare;</screeninfo> <mediaobject> <imageobject> <imagedata fileref="settings-view1.png" format="PNG"/> </imageobject> <textobject> - <phrase ->Configurações da Aparência do &kompare;</phrase> + <phrase>Configurações da Aparência do &kompare;</phrase> </textobject> </mediaobject> </screenshot> <variablelist> -<title ->Grupo de Cores</title> -<para ->Para ajustar as preferências de cores, usadas ao mostrar as diferenças, clique no botão de cores para mostrar a janela de <guilabel ->Seleção de Cores</guilabel -> para os seguintes estados:</para> +<title>Grupo de Cores</title> +<para>Para ajustar as preferências de cores, usadas ao mostrar as diferenças, clique no botão de cores para mostrar a janela de <guilabel>Seleção de Cores</guilabel> para os seguintes estados:</para> <varlistentry> -<term -><guilabel ->Cor de removido</guilabel -></term> -<listitem -><para ->As linhas que foram removidas ou não existem, entre a origem e o destino.</para -></listitem> +<term><guilabel>Cor de removido</guilabel></term> +<listitem><para>As linhas que foram removidas ou não existem, entre a origem e o destino.</para></listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Cor de modificado</guilabel -></term> -<listitem -><para ->As linhas que foram alteradas ou modificadas, entre a origem e o destino. </para -></listitem> +<term><guilabel>Cor de modificado</guilabel></term> +<listitem><para>As linhas que foram alteradas ou modificadas, entre a origem e o destino. </para></listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Cor de adicionado</guilabel -></term> -<listitem -><para ->As linhas que foram adicionadas entre a origem e o destino.</para -></listitem> +<term><guilabel>Cor de adicionado</guilabel></term> +<listitem><para>As linhas que foram adicionadas entre a origem e o destino.</para></listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Cor de aplicado</guilabel -></term> -<listitem -><para ->Qualquer um dos estados anteriores, no caso de a diferença ter sido aplicada entre a origem e o destino.</para -></listitem> +<term><guilabel>Cor de aplicado</guilabel></term> +<listitem><para>Qualquer um dos estados anteriores, no caso de a diferença ter sido aplicada entre a origem e o destino.</para></listitem> </varlistentry> </variablelist> <variablelist> -<title ->Roda do Mouse</title> +<title>Roda do Mouse</title> <varlistentry> -<term -><guilabel ->Número de linhas</guilabel -></term> -<listitem -><para ->O número de linhas a deslocar nas diferenças, ao avançar ou recuar a roda do mouse.</para -></listitem> +<term><guilabel>Número de linhas</guilabel></term> +<listitem><para>O número de linhas a deslocar nas diferenças, ao avançar ou recuar a roda do mouse.</para></listitem> </varlistentry> </variablelist> <variablelist> -<title ->TABs para Espaços</title> +<title>TABs para Espaços</title> <varlistentry> -<term -><guilabel ->O número de espaços a usar na conversão das tabulações</guilabel -></term> -<listitem -><para ->Converte cada tabulação para "n" espaços.</para -></listitem> +<term><guilabel>O número de espaços a usar na conversão das tabulações</guilabel></term> +<listitem><para>Converte cada tabulação para "n" espaços.</para></listitem> </varlistentry> </variablelist> </sect2> <sect2 id="fonts"> -<title ->Fontes</title> +<title>Fontes</title> <screenshot> -<screeninfo ->Configurações das Fontes do &kompare;</screeninfo> +<screeninfo>Configurações das Fontes do &kompare;</screeninfo> <mediaobject> <imageobject> <imagedata fileref="settings-view2.png" format="PNG"/> </imageobject> <textobject> - <phrase ->Configurações das Fontes do &kompare;</phrase> + <phrase>Configurações das Fontes do &kompare;</phrase> </textobject> </mediaobject> </screenshot> -<para ->Selecione o tipo e tamanho da letra a mostrar, quando visualizar as diferenças.</para> +<para>Selecione o tipo e tamanho da letra a mostrar, quando visualizar as diferenças.</para> </sect2> </sect1> <sect1 id="diff-settings"> -<title ->Opções do Diff</title> -<para ->O menu de <guimenu ->Diferenças</guimenu ->, existente na janela de <guilabel ->Preferências</guilabel ->, mostra os formulários <guilabel ->Diferença</guilabel ->, <guilabel ->Formato</guilabel ->, <guilabel ->Opções</guilabel -> e <guilabel ->Excluir</guilabel ->. Estes formulários poderão ser usados para configurar as propriedades de comportamento do programa 'diff'.</para> +<title>Opções do Diff</title> +<para>O menu de <guimenu>Diferenças</guimenu>, existente na janela de <guilabel>Preferências</guilabel>, mostra os formulários <guilabel>Diferença</guilabel>, <guilabel>Formato</guilabel>, <guilabel>Opções</guilabel> e <guilabel>Excluir</guilabel>. Estes formulários poderão ser usados para configurar as propriedades de comportamento do programa 'diff'.</para> <sect2 id="diff"> -<title ->Diferença</title> +<title>Diferença</title> <screenshot> -<screeninfo ->Configuração das Diferenças do &kompare;</screeninfo> +<screeninfo>Configuração das Diferenças do &kompare;</screeninfo> <mediaobject> <imageobject> <imagedata fileref="settings-diff1.png" format="PNG"/> </imageobject> <textobject> - <phrase ->Configuração das Diferenças do &kompare;</phrase> + <phrase>Configuração das Diferenças do &kompare;</phrase> </textobject> </mediaobject> </screenshot> -<para ->O comando executado para rodar o programa 'diff' (por padrão, <application ->diff</application ->).</para> +<para>O comando executado para rodar o programa 'diff' (por padrão, <application>diff</application>).</para> </sect2> <sect2 id="diff-format"> -<title ->Formato</title> +<title>Formato</title> <screenshot> -<screeninfo ->Configuração do Formato do &kompare;</screeninfo> +<screeninfo>Configuração do Formato do &kompare;</screeninfo> <mediaobject> <imageobject> <imagedata fileref="settings-diff2.png" format="PNG"/> </imageobject> <textobject> - <phrase ->Configuração do Formato do &kompare;</phrase> + <phrase>Configuração do Formato do &kompare;</phrase> </textobject> </mediaobject> </screenshot> -<para ->Ajusta as opções do <guilabel ->Formato do Resultado</guilabel -> e o número de <guilabel ->Linhas de Contexto</guilabel ->.</para> +<para>Ajusta as opções do <guilabel>Formato do Resultado</guilabel> e o número de <guilabel>Linhas de Contexto</guilabel>.</para> <variablelist> -<title ->Formato de Saída</title> +<title>Formato de Saída</title> <varlistentry> -<term -><guilabel ->Contexto</guilabel -></term> +<term><guilabel>Contexto</guilabel></term> <listitem> -<para ->O formato do resultado do contexto adiciona várias linhas de contexto em torno das linhas que diferem.</para> +<para>O formato do resultado do contexto adiciona várias linhas de contexto em torno das linhas que diferem.</para> </listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Ed</guilabel -></term> +<term><guilabel>Ed</guilabel></term> <listitem> -<para ->O 'diff' pode produzir comandos que, direcionados para o editor de texto 'ed', transformam o primeiro arquivo no segundo. Historicamente, este era o único modo adequado para editar automaticamente um arquivo e transformá-lo em outro. Com o aparecimento do <application ->patch</application ->, essa opção atualmente é raramente usada.</para> +<para>O 'diff' pode produzir comandos que, direcionados para o editor de texto 'ed', transformam o primeiro arquivo no segundo. Historicamente, este era o único modo adequado para editar automaticamente um arquivo e transformá-lo em outro. Com o aparecimento do <application>patch</application>, essa opção atualmente é raramente usada.</para> </listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Normal</guilabel -></term> +<term><guilabel>Normal</guilabel></term> <listitem> -<para ->O formato de saída normal mostra as linhas diferentes sem quaisquer linhas de contexto envolvente. </para> +<para>O formato de saída normal mostra as linhas diferentes sem quaisquer linhas de contexto envolvente. </para> </listitem> </varlistentry> <varlistentry> -<term -><guilabel ->RCS</guilabel -></term> +<term><guilabel>RCS</guilabel></term> <listitem> -<para ->O formato de saída RCS é desenhado especificamente para ser usado pelo <acronym ->RCS</acronym -> (Revision Control System - Sistema de Controle de Versões). Como no formato do Ed, este formato é raramente usado, desde que foi introduzido o programa <application ->patch</application ->.</para> +<para>O formato de saída RCS é desenhado especificamente para ser usado pelo <acronym>RCS</acronym> (Revision Control System - Sistema de Controle de Versões). Como no formato do Ed, este formato é raramente usado, desde que foi introduzido o programa <application>patch</application>.</para> </listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Unificado</guilabel -></term> +<term><guilabel>Unificado</guilabel></term> <listitem> -<para ->O formato de saída unificado é uma variação do formato de contexto. É considerado melhor que o formato de contexto, porque o resultado é mais compacto, uma vez que omite as linhas de contexto redundantes.</para> +<para>O formato de saída unificado é uma variação do formato de contexto. É considerado melhor que o formato de contexto, porque o resultado é mais compacto, uma vez que omite as linhas de contexto redundantes.</para> </listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Lado-a-lado</guilabel -></term> +<term><guilabel>Lado-a-lado</guilabel></term> <listitem> -<para ->Use o formato de saída lado-a-lado, que mostra os arquivos em duas colunas, com um separador entre elas. Esta opção só está disponível na janela de <guilabel ->Opções do Diff</guilabel -> (veja em <xref linkend="creating-a-diff"/>).</para> +<para>Use o formato de saída lado-a-lado, que mostra os arquivos em duas colunas, com um separador entre elas. Esta opção só está disponível na janela de <guilabel>Opções do Diff</guilabel> (veja em <xref linkend="creating-a-diff"/>).</para> </listitem> </varlistentry> </variablelist> <variablelist> -<title ->Linhas de Contexto</title> +<title>Linhas de Contexto</title> <varlistentry> -<term -><guilabel ->O número de linhas de contexto</guilabel -></term> +<term><guilabel>O número de linhas de contexto</guilabel></term> <listitem> -<para ->Ao executar um 'diff' com o formato de saída unificado ou de contexto, use este parâmetro para controlar o número de linhas de contexto incluídas.</para> +<para>Ao executar um 'diff' com o formato de saída unificado ou de contexto, use este parâmetro para controlar o número de linhas de contexto incluídas.</para> </listitem> </varlistentry> </variablelist> </sect2> <sect2 id="options"> -<title ->Opções</title> +<title>Opções</title> <screenshot> -<screeninfo ->Configuração das Opções do &kompare;</screeninfo> +<screeninfo>Configuração das Opções do &kompare;</screeninfo> <mediaobject> <imageobject> <imagedata fileref="settings-diff3.png" format="PNG"/> </imageobject> <textobject> - <phrase ->Configuração das Opções do &kompare;</phrase> + <phrase>Configuração das Opções do &kompare;</phrase> </textobject> </mediaobject> </screenshot> -<para ->A página de <guilabel ->Opções</guilabel -> permite a configuração das opções suportadas pelo programa 'diff'.</para> +<para>A página de <guilabel>Opções</guilabel> permite a configuração das opções suportadas pelo programa 'diff'.</para> <variablelist> -<title ->Geral</title> +<title>Geral</title> <varlistentry> -<term -><guilabel ->Procurar alterações menores</guilabel -></term> -<listitem -><para ->Obriga o 'diff' a mostrar as mudanças de capitalização, pontuação, espaços, &etc;, se estiver assinalada a opção.</para -></listitem> +<term><guilabel>Procurar alterações menores</guilabel></term> +<listitem><para>Obriga o 'diff' a mostrar as mudanças de capitalização, pontuação, espaços, &etc;, se estiver assinalada a opção.</para></listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Otimizar para arquivos grandes</guilabel -></term> -<listitem -><para ->Muda o 'diff' para processar os arquivos a alta velocidade, quando estiver assinalada.</para -></listitem> +<term><guilabel>Otimizar para arquivos grandes</guilabel></term> +<listitem><para>Muda o 'diff' para processar os arquivos a alta velocidade, quando estiver assinalada.</para></listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Ignorar as mudanças de capitalização</guilabel -></term> -<listitem -><para ->As mudanças de maiúsculas para minúsculas e vice-versa são omitidas, quando esta opção estiver assinalada.</para -></listitem> +<term><guilabel>Ignorar as mudanças de capitalização</guilabel></term> +<listitem><para>As mudanças de maiúsculas para minúsculas e vice-versa são omitidas, quando esta opção estiver assinalada.</para></listitem> </varlistentry> </variablelist> <variablelist> -<title ->Ignorar a expressão regular</title> +<title>Ignorar a expressão regular</title> <varlistentry> -<term -><guilabel ->Ignorar a expressão regular</guilabel -></term> -<listitem -><para ->Ignorar as linhas que correspondam a uma expressão regular.</para -></listitem> +<term><guilabel>Ignorar a expressão regular</guilabel></term> +<listitem><para>Ignorar as linhas que correspondam a uma expressão regular.</para></listitem> </varlistentry> </variablelist> <variablelist> -<title ->Espaços em branco</title> +<title>Espaços em branco</title> <varlistentry> -<term -><guilabel ->Expandir as tabulações para espaços no resultado</guilabel -></term> -<listitem -><para ->Quando a opção estiver assinalada, o resultado do 'diff' irá converter as tabulações para o número de espaços definido na janela de <guilabel ->Preferências</guilabel ->, no menu <guimenu ->Ver</guimenu -> e opção <guilabel ->Tabulações para Espaços</guilabel ->.</para> +<term><guilabel>Expandir as tabulações para espaços no resultado</guilabel></term> +<listitem><para>Quando a opção estiver assinalada, o resultado do 'diff' irá converter as tabulações para o número de espaços definido na janela de <guilabel>Preferências</guilabel>, no menu <guimenu>Ver</guimenu> e opção <guilabel>Tabulações para Espaços</guilabel>.</para> </listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Ignorar as linhas em branco adicionadas ou removidas</guilabel -></term> -<listitem -><para ->As linhas com tamanho nulo, diferentes entre os arquivos de origem e destino, são ignoradas se esta opção estiver assinalada.</para -></listitem> +<term><guilabel>Ignorar as linhas em branco adicionadas ou removidas</guilabel></term> +<listitem><para>As linhas com tamanho nulo, diferentes entre os arquivos de origem e destino, são ignoradas se esta opção estiver assinalada.</para></listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Ignorar as alterações dos espaços em branco</guilabel -></term> -<listitem -><para ->Os espaços em branco antes, depois e entre as linhas poderão alterar, dependendo dos diferentes editores. Quando esta opção estiver assinalada, estas alterações serão ignoradas.</para -></listitem> +<term><guilabel>Ignorar as alterações dos espaços em branco</guilabel></term> +<listitem><para>Os espaços em branco antes, depois e entre as linhas poderão alterar, dependendo dos diferentes editores. Quando esta opção estiver assinalada, estas alterações serão ignoradas.</para></listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Ignorar todos os espaços em branco</guilabel -></term> -<listitem -><para ->Quando a opção estiver assinalada, as diferenças de espaços em branco são ignoradas por completo.</para -></listitem> +<term><guilabel>Ignorar todos os espaços em branco</guilabel></term> +<listitem><para>Quando a opção estiver assinalada, as diferenças de espaços em branco são ignoradas por completo.</para></listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Ignorar as alterações devidas à expansão de tabulações</guilabel -></term> -<listitem -><para ->Quando a opção estiver assinalada, os espaços em branco resultantes das tabulações são ignoradas por completo.</para -></listitem> +<term><guilabel>Ignorar as alterações devidas à expansão de tabulações</guilabel></term> +<listitem><para>Quando a opção estiver assinalada, os espaços em branco resultantes das tabulações são ignoradas por completo.</para></listitem> </varlistentry> </variablelist> </sect2> <sect2 id="exclude"> -<title ->Excluir</title> -<para ->O formulário <guilabel ->Excluir</guilabel -> ativa a utilização das opções de filtragem, fornecidas pelo programa 'diff'.</para> +<title>Excluir</title> +<para>O formulário <guilabel>Excluir</guilabel> ativa a utilização das opções de filtragem, fornecidas pelo programa 'diff'.</para> <screenshot> -<screeninfo ->Configuração da Exclusão do &kompare;</screeninfo> +<screeninfo>Configuração da Exclusão do &kompare;</screeninfo> <mediaobject> <imageobject> <imagedata fileref="settings-diff4.png" format="PNG"/> </imageobject> <textobject> - <phrase ->Configuração da Exclusão do &kompare;</phrase> + <phrase>Configuração da Exclusão do &kompare;</phrase> </textobject> </mediaobject> </screenshot> <variablelist> -<title ->Padrão de Arquivos a Excluir</title> +<title>Padrão de Arquivos a Excluir</title> <varlistentry> -<term -><guilabel ->Padrão de Arquivos a Excluir</guilabel -></term> -<listitem -><para ->Excluir os arquivos baseando-se na filtragem por caracteres especiais</para -></listitem> +<term><guilabel>Padrão de Arquivos a Excluir</guilabel></term> +<listitem><para>Excluir os arquivos baseando-se na filtragem por caracteres especiais</para></listitem> </varlistentry> </variablelist> <variablelist> -<title ->Arquivo com Nomes de Arquivos a Excluir</title> +<title>Arquivo com Nomes de Arquivos a Excluir</title> <varlistentry> -<term -><guilabel ->Arquivo com Nomes de Arquivos a Excluir</guilabel -></term> -<listitem -><para ->Define o filtro com base no conteúdo de um arquivo gerenciado externamente.</para -></listitem> +<term><guilabel>Arquivo com Nomes de Arquivos a Excluir</guilabel></term> +<listitem><para>Define o filtro com base no conteúdo de um arquivo gerenciado externamente.</para></listitem> </varlistentry> </variablelist> </sect2> @@ -1191,510 +569,160 @@ </chapter> <chapter id="command-reference"> -<title ->Referência de Comandos</title> +<title>Referência de Comandos</title> <sect1 id="file-menu"> -<title ->O Menu <guimenu ->Arquivo</guimenu -></title> +<title>O Menu <guimenu>Arquivo</guimenu></title> <variablelist> <varlistentry> -<term -><menuchoice -><shortcut -> <keycombo action="simul" ->&Ctrl;<keycap ->O</keycap -></keycombo -> </shortcut -> <guimenu ->Arquivo</guimenu -><guimenuitem ->Abrir o Diff...</guimenuitem -></menuchoice -></term> -<listitem -><para ->Abre a janela para <guilabel ->Abrir Arquivos</guilabel ->.</para -></listitem> +<term><menuchoice><shortcut> <keycombo action="simul">&Ctrl;<keycap>O</keycap></keycombo> </shortcut> <guimenu>Arquivo</guimenu><guimenuitem>Abrir o Diff...</guimenuitem></menuchoice></term> +<listitem><para>Abre a janela para <guilabel>Abrir Arquivos</guilabel>.</para></listitem> </varlistentry> <varlistentry> -<term -><menuchoice -><shortcut -> <keycombo action="simul" ->&Ctrl;<keycap ->C</keycap -></keycombo -> </shortcut -> <guimenu ->Arquivo</guimenu -><guimenuitem ->Comparar os Arquivos...</guimenuitem -></menuchoice -></term> -<listitem -><para ->Mostra a janela para <guilabel ->Comparar Arquivos ou Pastas</guilabel ->.</para -></listitem> +<term><menuchoice><shortcut> <keycombo action="simul">&Ctrl;<keycap>C</keycap></keycombo> </shortcut> <guimenu>Arquivo</guimenu><guimenuitem>Comparar os Arquivos...</guimenuitem></menuchoice></term> +<listitem><para>Mostra a janela para <guilabel>Comparar Arquivos ou Pastas</guilabel>.</para></listitem> </varlistentry> <varlistentry> -<term -><menuchoice -><shortcut -> <keycombo action="simul" ->&Ctrl;<keycap ->B</keycap -></keycombo -> </shortcut -> <guimenu ->Arquivo</guimenu -><guimenuitem ->Fundir o URL com o Diff...</guimenuitem -></menuchoice -></term> -<listitem -><para ->Mostra a janela para <guilabel ->Fundir o Arquivo/Pasta com o Resultado do Diff</guilabel ->.</para -></listitem> +<term><menuchoice><shortcut> <keycombo action="simul">&Ctrl;<keycap>B</keycap></keycombo> </shortcut> <guimenu>Arquivo</guimenu><guimenuitem>Fundir o URL com o Diff...</guimenuitem></menuchoice></term> +<listitem><para>Mostra a janela para <guilabel>Fundir o Arquivo/Pasta com o Resultado do Diff</guilabel>.</para></listitem> </varlistentry> <varlistentry> -<term -><menuchoice -><shortcut -> <keycombo action="simul" ->&Ctrl;<keycap ->S</keycap -></keycombo -> </shortcut -> <guimenu ->Arquivo</guimenu -><guimenuitem ->Salvar</guimenuitem -></menuchoice -></term> -<listitem -><para ->Salva as alterações aplicadas no arquivo de origem e destino atuais.</para -></listitem> +<term><menuchoice><shortcut> <keycombo action="simul">&Ctrl;<keycap>S</keycap></keycombo> </shortcut> <guimenu>Arquivo</guimenu><guimenuitem>Salvar</guimenuitem></menuchoice></term> +<listitem><para>Salva as alterações aplicadas no arquivo de origem e destino atuais.</para></listitem> </varlistentry> <varlistentry> -<term -><menuchoice -><guimenu ->Arquivo</guimenu -><guimenuitem ->Salvar Tudo</guimenuitem -></menuchoice -></term> -<listitem -><para ->Salva as diferenças aplicadas em todos os arquivos de origem e destino.</para -></listitem> +<term><menuchoice><guimenu>Arquivo</guimenu><guimenuitem>Salvar Tudo</guimenuitem></menuchoice></term> +<listitem><para>Salva as diferenças aplicadas em todos os arquivos de origem e destino.</para></listitem> </varlistentry> <varlistentry> -<term -><menuchoice -><guimenu ->Arquivo</guimenu -><guimenuitem ->Salvar o .diff</guimenuitem -></menuchoice -></term> -<listitem -><para ->Mostra a janela de <guilabel ->Opções do Diff</guilabel -> para definir o formato e as opções do 'diff'.</para -></listitem> +<term><menuchoice><guimenu>Arquivo</guimenu><guimenuitem>Salvar o .diff</guimenuitem></menuchoice></term> +<listitem><para>Mostra a janela de <guilabel>Opções do Diff</guilabel> para definir o formato e as opções do 'diff'.</para></listitem> </varlistentry> <varlistentry> -<term -><menuchoice -><guimenu ->Arquivo</guimenu -><guimenuitem ->Trocar a Origem e o Destino</guimenuitem -></menuchoice -></term> -<listitem -><para ->Troca a origem e o destino de posição.</para -></listitem> +<term><menuchoice><guimenu>Arquivo</guimenu><guimenuitem>Trocar a Origem e o Destino</guimenuitem></menuchoice></term> +<listitem><para>Troca a origem e o destino de posição.</para></listitem> </varlistentry> <varlistentry> -<term -><menuchoice -><guimenu ->Arquivo</guimenu -><guimenuitem ->Mostrar as Estatísticas</guimenuitem -></menuchoice -></term> -<listitem -><para ->Mostra a janela para <guilabel ->Mostrar as Estatísticas</guilabel ->.</para -></listitem> +<term><menuchoice><guimenu>Arquivo</guimenu><guimenuitem>Mostrar as Estatísticas</guimenuitem></menuchoice></term> +<listitem><para>Mostra a janela para <guilabel>Mostrar as Estatísticas</guilabel>.</para></listitem> </varlistentry> <varlistentry> -<term -><menuchoice -><shortcut -> <keycombo action="simul" ->&Ctrl;<keycap ->Q</keycap -></keycombo -> </shortcut -> <guimenu ->Arquivo</guimenu -><guimenuitem ->Sair</guimenuitem -></menuchoice -></term> -<listitem -><para ->Sai do &kompare;.</para -></listitem> +<term><menuchoice><shortcut> <keycombo action="simul">&Ctrl;<keycap>Q</keycap></keycombo> </shortcut> <guimenu>Arquivo</guimenu><guimenuitem>Sair</guimenuitem></menuchoice></term> +<listitem><para>Sai do &kompare;.</para></listitem> </varlistentry> </variablelist> </sect1> <sect1 id="difference-menu"> -<title ->O Menu <guimenu ->Diferenças</guimenu -></title> +<title>O Menu <guimenu>Diferenças</guimenu></title> <variablelist> <varlistentry> -<term -><menuchoice -><shortcut -> <keycombo action="simul" ->&Ctrl;<keycap ->U</keycap -></keycombo -> </shortcut -> <guimenu ->Diferença</guimenu -><guimenuitem ->Ignorar Tudo</guimenuitem -></menuchoice -></term> -<listitem -><para ->Ignora todas as diferenças aplicadas previamente entre a origem e o destino.</para -></listitem> +<term><menuchoice><shortcut> <keycombo action="simul">&Ctrl;<keycap>U</keycap></keycombo> </shortcut> <guimenu>Diferença</guimenu><guimenuitem>Ignorar Tudo</guimenuitem></menuchoice></term> +<listitem><para>Ignora todas as diferenças aplicadas previamente entre a origem e o destino.</para></listitem> </varlistentry> <varlistentry> -<term -><menuchoice -><shortcut -><keycap ->Backspace</keycap -></shortcut -> <guimenu ->Diferença</guimenu -><guimenuitem ->Ignorar a Diferença</guimenuitem -></menuchoice -></term> -<listitem -><para ->Anula uma diferença previamente aplicada.</para -></listitem> +<term><menuchoice><shortcut><keycap>Backspace</keycap></shortcut> <guimenu>Diferença</guimenu><guimenuitem>Ignorar a Diferença</guimenuitem></menuchoice></term> +<listitem><para>Anula uma diferença previamente aplicada.</para></listitem> </varlistentry> <varlistentry> -<term -><menuchoice -><shortcut -><keycap ->Espaço</keycap -></shortcut -> <guimenu ->Diferença</guimenu -><guimenuitem ->Aplicar a Diferença</guimenuitem -></menuchoice -></term> -<listitem -><para ->Aplica uma diferença selecionada.</para -></listitem> +<term><menuchoice><shortcut><keycap>Espaço</keycap></shortcut> <guimenu>Diferença</guimenu><guimenuitem>Aplicar a Diferença</guimenuitem></menuchoice></term> +<listitem><para>Aplica uma diferença selecionada.</para></listitem> </varlistentry> <varlistentry> -<term -><menuchoice -><shortcut -> <keycombo action="simul" ->&Ctrl;<keycap ->A</keycap -></keycombo -> </shortcut -> <guimenu ->Diferença</guimenu -><guimenuitem ->Aplicar Tudo</guimenuitem -></menuchoice -></term> -<listitem -><para ->Aplica todas as diferenças entre o original e o destino.</para -></listitem> +<term><menuchoice><shortcut> <keycombo action="simul">&Ctrl;<keycap>A</keycap></keycombo> </shortcut> <guimenu>Diferença</guimenu><guimenuitem>Aplicar Tudo</guimenuitem></menuchoice></term> +<listitem><para>Aplica todas as diferenças entre o original e o destino.</para></listitem> </varlistentry> <varlistentry> -<term -><menuchoice -><shortcut -> <keycombo action="simul" ->&Ctrl;<keycap ->PageUp</keycap -></keycombo -> </shortcut -> <guimenu ->Diferença</guimenu -><guimenuitem ->Arquivo Anterior</guimenuitem -></menuchoice -></term> -<listitem -><para ->Coloca o arquivo anterior, da lista de arquivos com diferenças encontradas, como o arquivo atual da área de visualização.</para -></listitem> +<term><menuchoice><shortcut> <keycombo action="simul">&Ctrl;<keycap>PageUp</keycap></keycombo> </shortcut> <guimenu>Diferença</guimenu><guimenuitem>Arquivo Anterior</guimenuitem></menuchoice></term> +<listitem><para>Coloca o arquivo anterior, da lista de arquivos com diferenças encontradas, como o arquivo atual da área de visualização.</para></listitem> </varlistentry> <varlistentry> -<term -><menuchoice -><shortcut -> <keycombo action="simul" ->&Ctrl;<keycap ->PageDown</keycap -></keycombo -> </shortcut -> <guimenu ->Diferença</guimenu -><guimenuitem ->Arquivo Seguinte</guimenuitem -></menuchoice -></term> -<listitem -><para ->Coloca o arquivo seguinte, da lista de arquivos com diferenças encontradas, como o arquivo atual da área de visualização.</para -></listitem> +<term><menuchoice><shortcut> <keycombo action="simul">&Ctrl;<keycap>PageDown</keycap></keycombo> </shortcut> <guimenu>Diferença</guimenu><guimenuitem>Arquivo Seguinte</guimenuitem></menuchoice></term> +<listitem><para>Coloca o arquivo seguinte, da lista de arquivos com diferenças encontradas, como o arquivo atual da área de visualização.</para></listitem> </varlistentry> <varlistentry> -<term -><menuchoice -><shortcut -> <keycombo action="simul" ->&Ctrl;<keycap ->Cima</keycap -></keycombo -> </shortcut -> <guimenu ->Diferença</guimenu -><guimenuitem ->Diferença Anterior</guimenuitem -></menuchoice -></term> -<listitem -><para ->Seleciona a diferença anterior à diferença atualmente selecionada na lista.</para -></listitem> +<term><menuchoice><shortcut> <keycombo action="simul">&Ctrl;<keycap>Cima</keycap></keycombo> </shortcut> <guimenu>Diferença</guimenu><guimenuitem>Diferença Anterior</guimenuitem></menuchoice></term> +<listitem><para>Seleciona a diferença anterior à diferença atualmente selecionada na lista.</para></listitem> </varlistentry> <varlistentry> -<term -><menuchoice -><shortcut -> <keycombo action="simul" ->&Ctrl;<keycap ->Baixo</keycap -></keycombo -> </shortcut -> <guimenu ->Diferença</guimenu -><guimenuitem ->Diferença Seguinte</guimenuitem -></menuchoice -></term> -<listitem -><para ->Seleciona a diferença abaixo da diferença atualmente selecionada.</para -></listitem> +<term><menuchoice><shortcut> <keycombo action="simul">&Ctrl;<keycap>Baixo</keycap></keycombo> </shortcut> <guimenu>Diferença</guimenu><guimenuitem>Diferença Seguinte</guimenuitem></menuchoice></term> +<listitem><para>Seleciona a diferença abaixo da diferença atualmente selecionada.</para></listitem> </varlistentry> </variablelist> </sect1> <sect1 id="settingsmenu"> -<title ->O Menu <guimenu ->Configurações</guimenu -></title> +<title>O Menu <guimenu>Configurações</guimenu></title> <variablelist> <varlistentry> -<term -><menuchoice -><guimenu ->Configurações</guimenu -><guimenuitem ->Ocultar/Mostrar a Barra de Ferramentas</guimenuitem -></menuchoice -></term> -<listitem -><para ->Ativa ou desativa a visibilidade da barra de ferramentas.</para -></listitem> +<term><menuchoice><guimenu>Configurações</guimenu><guimenuitem>Ocultar/Mostrar a Barra de Ferramentas</guimenuitem></menuchoice></term> +<listitem><para>Ativa ou desativa a visibilidade da barra de ferramentas.</para></listitem> </varlistentry> <varlistentry> -<term -><menuchoice -><guimenu ->Configurações</guimenu -><guimenuitem ->Mostrar/Ocultar a Barra de Estado</guimenuitem -></menuchoice -></term> -<listitem -><para ->Ativa ou desativa a visibilidade da barra de estado.</para -></listitem> +<term><menuchoice><guimenu>Configurações</guimenu><guimenuitem>Mostrar/Ocultar a Barra de Estado</guimenuitem></menuchoice></term> +<listitem><para>Ativa ou desativa a visibilidade da barra de estado.</para></listitem> </varlistentry> <varlistentry> -<term -><menuchoice -><guimenu ->Configurações</guimenu -><guimenuitem ->Mostrar a Área de Texto</guimenuitem -></menuchoice -></term> -<listitem -><para ->Mostra a <guilabel ->Área de Texto</guilabel ->.</para -></listitem> +<term><menuchoice><guimenu>Configurações</guimenu><guimenuitem>Mostrar a Área de Texto</guimenuitem></menuchoice></term> +<listitem><para>Mostra a <guilabel>Área de Texto</guilabel>.</para></listitem> </varlistentry> <varlistentry> -<term -><menuchoice -><guimenu ->Configurações</guimenu -><guimenuitem ->Configurar os Atalhos...</guimenuitem -></menuchoice -></term> -<listitem -><para ->Mostra a janela para <guilabel ->Configurar os Atalhos</guilabel ->.</para -></listitem> +<term><menuchoice><guimenu>Configurações</guimenu><guimenuitem>Configurar os Atalhos...</guimenuitem></menuchoice></term> +<listitem><para>Mostra a janela para <guilabel>Configurar os Atalhos</guilabel>.</para></listitem> </varlistentry> <varlistentry> -<term -><menuchoice -><guimenu ->Configurações</guimenu -><guimenuitem ->Configurar as Barras de Ferramentas...</guimenuitem -></menuchoice -></term> -<listitem -><para ->Mostra a janela para <guilabel ->Configurar a Barra de Ferramentas</guilabel ->.</para -></listitem> +<term><menuchoice><guimenu>Configurações</guimenu><guimenuitem>Configurar as Barras de Ferramentas...</guimenuitem></menuchoice></term> +<listitem><para>Mostra a janela para <guilabel>Configurar a Barra de Ferramentas</guilabel>.</para></listitem> </varlistentry> <varlistentry> -<term -><menuchoice -><guimenu ->Configurações</guimenu -><guimenuitem ->Configurar o &kompare;...</guimenuitem -></menuchoice -></term> -<listitem -><para ->Mostra a janela de <guilabel ->Preferências</guilabel -> do &kompare;.</para -></listitem> +<term><menuchoice><guimenu>Configurações</guimenu><guimenuitem>Configurar o &kompare;...</guimenuitem></menuchoice></term> +<listitem><para>Mostra a janela de <guilabel>Preferências</guilabel> do &kompare;.</para></listitem> </varlistentry> </variablelist> </sect1> <sect1 id="help-menu"> -<title ->O Menu <guimenu ->Ajuda</guimenu -></title> +<title>O Menu <guimenu>Ajuda</guimenu></title> &help.menu.documentation; </sect1> </chapter> <chapter id="credits"> -<title ->Créditos e Licença</title> - -<para ->&kompare; </para> -<para ->Programa com direitos autorais 2001-2004 de &John.Firebaugh; &John.Firebaugh.mail; e Otto Bruggeman<email ->otto.bruggeman@home.nl</email -> </para> - -<para ->Documentação com direitos autorais © 2007 de Sean Wheller <email ->sean@inwords.co.za</email -> </para> - -<para ->Tradução de Marcus Gama <email ->marcus.gama@gmail.com</email -></para -> +<title>Créditos e Licença</title> + +<para>&kompare; </para> +<para>Programa com direitos autorais 2001-2004 de &John.Firebaugh; &John.Firebaugh.mail; e Otto Bruggeman<email>otto.bruggeman@home.nl</email> </para> + +<para>Documentação com direitos autorais © 2007 de Sean Wheller <email>sean@inwords.co.za</email> </para> + +<para>Tradução de Marcus Gama <email>marcus.gama@gmail.com</email></para> &underFDL; &underGPL; </chapter> <appendix id="installation"> -<title ->Instalação</title> +<title>Instalação</title> <sect1 id="getting-kapp"> -<title ->Como obter o &kompare;</title> +<title>Como obter o &kompare;</title> &install.intro.documentation; </sect1> <sect1 id="compilation"> -<title ->Compilação e Instalação</title> +<title>Compilação e Instalação</title> &install.compile.documentation; </sect1> diff --git a/tde-i18n-pt_BR/docs/tdesdk/scripts/man-adddebug.1.docbook b/tde-i18n-pt_BR/docs/tdesdk/scripts/man-adddebug.1.docbook index 8ad24516b08..1ba1fb3b497 100644 --- a/tde-i18n-pt_BR/docs/tdesdk/scripts/man-adddebug.1.docbook +++ b/tde-i18n-pt_BR/docs/tdesdk/scripts/man-adddebug.1.docbook @@ -5,119 +5,51 @@ <refentry lang="&language;"> <refentryinfo> -<author -><personname -><firstname ->Ben</firstname -><surname ->Burton</surname -></personname -> <email ->bab@debian.org</email -></author> -<date ->7 de Março de 2003</date> +<author><personname><firstname>Ben</firstname><surname>Burton</surname></personname> <email>bab@debian.org</email></author> +<date>7 de Março de 2003</date> </refentryinfo> <refmeta> -<refentrytitle -><command ->addebug</command -></refentrytitle> -<manvolnum ->1</manvolnum> +<refentrytitle><command>addebug</command></refentrytitle> +<manvolnum>1</manvolnum> </refmeta> <refnamediv> -<refname -><command ->addebug</command -></refname> -<refpurpose ->Modifica as <filename ->Makefile</filename ->(s) para adicionar informações de depuração</refpurpose> +<refname><command>addebug</command></refname> +<refpurpose>Modifica as <filename>Makefile</filename>(s) para adicionar informações de depuração</refpurpose> </refnamediv> <refsynopsisdiv> -<cmdsynopsis -><command ->adddebug</command -> <group -><option ->-k</option -></group -> <group -><option ->-r</option -></group -> <group -><option ->-n</option -></group -> </cmdsynopsis> +<cmdsynopsis><command>adddebug</command> <group><option>-k</option></group> <group><option>-r</option></group> <group><option>-n</option></group> </cmdsynopsis> </refsynopsisdiv> <refsect1> -<title ->Descrição</title> +<title>Descrição</title> -<para ->O <command ->adddebug</command -> modifica as <filename ->Makefile</filename ->s na pasta atual (e, opcionalmente, nas suas sub-pastas) para adicionar informações de depuração (<option ->-g3</option ->). Irá também remover as otimizações (<option ->-O[1-9]</option ->).</para> +<para>O <command>adddebug</command> modifica as <filename>Makefile</filename>s na pasta atual (e, opcionalmente, nas suas sub-pastas) para adicionar informações de depuração (<option>-g3</option>). Irá também remover as otimizações (<option>-O[1-9]</option>).</para> -<para ->Este utilitário faz parte do Kit de Desenvolvimento de Software (SDK) do &kde;.</para> +<para>Este utilitário faz parte do Kit de Desenvolvimento de Software (SDK) do &kde;.</para> </refsect1> <refsect1> -<title ->Opções</title> +<title>Opções</title> <variablelist> <varlistentry> -<term -><option ->-k</option -></term> -<listitem -><para ->Mantém as otimizações (não remove as opções <option ->-O[1-9]?</option -> que são removidas por padrão).</para> +<term><option>-k</option></term> +<listitem><para>Mantém as otimizações (não remove as opções <option>-O[1-9]?</option> que são removidas por padrão).</para> </listitem> </varlistentry> <varlistentry> -<term -><option ->-r</option -></term> +<term><option>-r</option></term> <listitem> -<para ->Procura recursivamente em todas as sub-pastas da pasta atual e atua em todas as <filename ->Makefile</filename ->s encontradas. </para> +<para>Procura recursivamente em todas as sub-pastas da pasta atual e atua em todas as <filename>Makefile</filename>s encontradas. </para> </listitem> </varlistentry> <varlistentry> -<term -><option ->-n</option -></term> -<listitem -><para ->compila sem o NDEBUG e o NO_DEBUG definidos (faz com que as chamadas <function ->kdDebug</function -> funcionem)</para -></listitem> +<term><option>-n</option></term> +<listitem><para>compila sem o NDEBUG e o NO_DEBUG definidos (faz com que as chamadas <function>kdDebug</function> funcionem)</para></listitem> </varlistentry> </variablelist> </refsect1> diff --git a/tde-i18n-pt_BR/docs/tdesdk/scripts/man-cheatmake.1.docbook b/tde-i18n-pt_BR/docs/tdesdk/scripts/man-cheatmake.1.docbook index 7fdc748904d..03d05ec5612 100644 --- a/tde-i18n-pt_BR/docs/tdesdk/scripts/man-cheatmake.1.docbook +++ b/tde-i18n-pt_BR/docs/tdesdk/scripts/man-cheatmake.1.docbook @@ -5,155 +5,65 @@ <refentry lang="&language;"> <refentryinfo> -<date ->8 de Março de 2003</date> +<date>8 de Março de 2003</date> </refentryinfo> <refmeta> -<refentrytitle -><command ->cheatmake</command -></refentrytitle> -<manvolnum ->1</manvolnum> +<refentrytitle><command>cheatmake</command></refentrytitle> +<manvolnum>1</manvolnum> </refmeta> <refnamediv> -<refname -><command ->cheatmake</command -></refname> -<refpurpose ->Faz com que o <command ->make</command -> não recompile determinados arquivos</refpurpose> +<refname><command>cheatmake</command></refname> +<refpurpose>Faz com que o <command>make</command> não recompile determinados arquivos</refpurpose> </refnamediv> <refsynopsisdiv> -<cmdsynopsis -><command ->cheatmake</command -> <group -><option ->hidechange</option -> <replaceable ->arquivo</replaceable -></group -> <group -><option ->show</option -></group -> <group -><option ->why</option -> <replaceable ->arquivo</replaceable -></group -> </cmdsynopsis> +<cmdsynopsis><command>cheatmake</command> <group><option>hidechange</option> <replaceable>arquivo</replaceable></group> <group><option>show</option></group> <group><option>why</option> <replaceable>arquivo</replaceable></group> </cmdsynopsis> </refsynopsisdiv> <refsect1> -<title ->Descrição</title> +<title>Descrição</title> -<para ->O <command ->cheatmake</command -> é usado para poupar tempo ao recompilar. Ele pode fazer com que o 'make' pule os arquivos que não foram modificados de uma maneira transparente. Isto pode ser usado por exemplo quando você muda um comentário em um arquivo mas nenhuma parte do código atual.</para> +<para>O <command>cheatmake</command> é usado para poupar tempo ao recompilar. Ele pode fazer com que o 'make' pule os arquivos que não foram modificados de uma maneira transparente. Isto pode ser usado por exemplo quando você muda um comentário em um arquivo mas nenhuma parte do código atual.</para> -<para ->Este utilitário faz parte do Kit de Desenvolvimento de Software (SDK) do &kde;. </para> +<para>Este utilitário faz parte do Kit de Desenvolvimento de Software (SDK) do &kde;. </para> </refsect1> <refsect1> -<title ->Opções</title> +<title>Opções</title> <variablelist> <varlistentry> -<term -><option ->hidechange</option -> <replaceable ->arquivo</replaceable -></term> -<listitem -><para ->Oculta o fato de que o arquivo foi mudado configurando a estampa de tempo no passado. Use isto com cuidado!</para> +<term><option>hidechange</option> <replaceable>arquivo</replaceable></term> +<listitem><para>Oculta o fato de que o arquivo foi mudado configurando a estampa de tempo no passado. Use isto com cuidado!</para> </listitem> </varlistentry> <varlistentry> -<term -><option ->show</option -></term> -<listitem -><para ->Lista quais arquivos o <command ->make</command -> precisa atualmente recompilar</para -></listitem> +<term><option>show</option></term> +<listitem><para>Lista quais arquivos o <command>make</command> precisa atualmente recompilar</para></listitem> </varlistentry> <varlistentry> -<term -><option ->why</option -> <replaceable ->arquivo</replaceable -></term> -<listitem -><para ->Explica porque o 'make' deve recompilar o arquivo</para -></listitem> +<term><option>why</option> <replaceable>arquivo</replaceable></term> +<listitem><para>Explica porque o 'make' deve recompilar o arquivo</para></listitem> </varlistentry> </variablelist> </refsect1> <refsect1> -<title ->Ambiente</title> +<title>Ambiente</title> -<para ->Uma das seguintes variáveis (mas não ambas) deve ser configurada se o diretório fonte for diferente do diretório de compilação. Se o diretório de compilação é simplesmente um subdiretório do diretório fonte, a variável mais simples <envar ->OBJ_SUBDIR</envar -> deve ser usada. </para> +<para>Uma das seguintes variáveis (mas não ambas) deve ser configurada se o diretório fonte for diferente do diretório de compilação. Se o diretório de compilação é simplesmente um subdiretório do diretório fonte, a variável mais simples <envar>OBJ_SUBDIR</envar> deve ser usada. </para> <variablelist> <varlistentry> -<term -><envar ->OBJ_SUBJDIR</envar -></term> -<listitem -><para ->Indica que o diretório de compilação está no subdiretório fornecido do diretório fonte. Por exemplo, se o diretório fonte é <filename class="directory" ->tdesdk</filename -> e o diretório de compilação é <filename class="directory" ->tdesdk/obj-386-linux</filename ->, então o <envar ->OBJ_SUBDIR</envar -> deve ser configurado como <parameter ->obj-386-linux</parameter ->.</para -></listitem> +<term><envar>OBJ_SUBJDIR</envar></term> +<listitem><para>Indica que o diretório de compilação está no subdiretório fornecido do diretório fonte. Por exemplo, se o diretório fonte é <filename class="directory">tdesdk</filename> e o diretório de compilação é <filename class="directory">tdesdk/obj-386-linux</filename>, então o <envar>OBJ_SUBDIR</envar> deve ser configurado como <parameter>obj-386-linux</parameter>.</para></listitem> </varlistentry> <varlistentry> -<term -><envar ->OBJ_REPLACEMENT</envar -></term> -<listitem -><para ->Uma expressão <command ->sed</command -> que é usada para transformar o diretório fonte em diretório de compilação. Por exemplo, se o diretório fonte é <filename class="directory" ->tdesdk/obj-i386-linux</filename ->, então <envar ->OBJ_REPLACEMENT</envar -> deve ser configurado como <parameter ->s#tdesdk#tdesdk-obj#</parameter ->.</para> +<term><envar>OBJ_REPLACEMENT</envar></term> +<listitem><para>Uma expressão <command>sed</command> que é usada para transformar o diretório fonte em diretório de compilação. Por exemplo, se o diretório fonte é <filename class="directory">tdesdk/obj-i386-linux</filename>, então <envar>OBJ_REPLACEMENT</envar> deve ser configurado como <parameter>s#tdesdk#tdesdk-obj#</parameter>.</para> </listitem> </varlistentry> </variablelist> @@ -161,32 +71,16 @@ </refsect1> <refsect1> -<title ->Veja Também</title> +<title>Veja Também</title> -<para ->make(1)</para> +<para>make(1)</para> </refsect1> <refsect1> -<title ->Autores</title> - -<para ->O <command ->cheatmake</command -> foi escrito por &David.Faure; &David.Faure.mail;. Esta página de manual foi preparada por <personname -><firstname ->Ben</firstname -><surname ->Burton</surname -></personname -> <email ->bab@debian.org</email -> para o sistema Debian <acronym ->GNU</acronym ->/&Linux; (mas pode ser usada pelos outros).</para> +<title>Autores</title> + +<para>O <command>cheatmake</command> foi escrito por &David.Faure; &David.Faure.mail;. Esta página de manual foi preparada por <personname><firstname>Ben</firstname><surname>Burton</surname></personname> <email>bab@debian.org</email> para o sistema Debian <acronym>GNU</acronym>/&Linux; (mas pode ser usada pelos outros).</para> </refsect1> diff --git a/tde-i18n-pt_BR/docs/tdesdk/scripts/man-create_cvsignore.1.docbook b/tde-i18n-pt_BR/docs/tdesdk/scripts/man-create_cvsignore.1.docbook index 74ed77972d9..d15ced80aad 100644 --- a/tde-i18n-pt_BR/docs/tdesdk/scripts/man-create_cvsignore.1.docbook +++ b/tde-i18n-pt_BR/docs/tdesdk/scripts/man-create_cvsignore.1.docbook @@ -7,72 +7,36 @@ <refentry lang="&language;"> <refentryinfo> -<author -><personname -><firstname ->Ben</firstname -><surname ->Burton</surname -></personname -> <email ->bab@debian.org</email -></author> -<date ->8 de Março de 2003</date> +<author><personname><firstname>Ben</firstname><surname>Burton</surname></personname> <email>bab@debian.org</email></author> +<date>8 de Março de 2003</date> </refentryinfo> <refmeta> -<refentrytitle -><command ->create_cvsignore</command -></refentrytitle> -<manvolnum ->1</manvolnum> +<refentrytitle><command>create_cvsignore</command></refentrytitle> +<manvolnum>1</manvolnum> </refmeta> <refnamediv> -<refname -><command ->create_cvsignore</command -></refname> -<refpurpose ->Cria um .cvsignore preliminar no diretório atual</refpurpose> +<refname><command>create_cvsignore</command></refname> +<refpurpose>Cria um .cvsignore preliminar no diretório atual</refpurpose> </refnamediv> <refsynopsisdiv> <cmdsynopsis> -<command ->createcvsignore</command> +<command>createcvsignore</command> </cmdsynopsis> </refsynopsisdiv> <refsect1> -<title ->Descrição</title> +<title>Descrição</title> -<para ->O <command ->create_cvsignore</command -> é usado para criar um <filename ->.cvsignore</filename -> preliminar no diretório atual. Ele faz isto baseado em determinado conteúdo que ele encontra no <filename ->Makefile.am</filename -></para> +<para>O <command>create_cvsignore</command> é usado para criar um <filename>.cvsignore</filename> preliminar no diretório atual. Ele faz isto baseado em determinado conteúdo que ele encontra no <filename>Makefile.am</filename></para> -<para ->Nenhuma linha será removida de qualquer <filename ->.cvsignore</filename -> existente. Se ainda não existir um arquivo <filename ->.cvsignore</filename ->, ele será adicionado ao repositório cvs.</para> +<para>Nenhuma linha será removida de qualquer <filename>.cvsignore</filename> existente. Se ainda não existir um arquivo <filename>.cvsignore</filename>, ele será adicionado ao repositório cvs.</para> -<para ->Observe que você deve ter um <filename ->Makefile.am</filename -> no diretório atual para esta ferramenta funcionar.</para> +<para>Observe que você deve ter um <filename>Makefile.am</filename> no diretório atual para esta ferramenta funcionar.</para> -<para ->Este utilitário faz parte do Kit de Desenvolvimento de Software (SDK) do &kde;.</para> +<para>Este utilitário faz parte do Kit de Desenvolvimento de Software (SDK) do &kde;.</para> </refsect1> diff --git a/tde-i18n-pt_BR/docs/tdesdk/scripts/man-create_makefile.1.docbook b/tde-i18n-pt_BR/docs/tdesdk/scripts/man-create_makefile.1.docbook index 928f91f6ee2..2882e2d4eda 100644 --- a/tde-i18n-pt_BR/docs/tdesdk/scripts/man-create_makefile.1.docbook +++ b/tde-i18n-pt_BR/docs/tdesdk/scripts/man-create_makefile.1.docbook @@ -7,136 +7,51 @@ <refentry lang="&language;"> <refentryinfo> -<date ->8 de Março de 2003</date> +<date>8 de Março de 2003</date> </refentryinfo> <refmeta> -<refentrytitle -><command ->create_makefile</command -></refentrytitle> -<manvolnum ->1</manvolnum> +<refentrytitle><command>create_makefile</command></refentrytitle> +<manvolnum>1</manvolnum> </refmeta> <refnamediv> -<refname -><command ->create_makefile</command -></refname> -<refpurpose ->Cria o <filename ->Makefile.in</filename -> e <filename ->Makefile</filename -> a partir de um <filename ->Makefile.am</filename -></refpurpose> +<refname><command>create_makefile</command></refname> +<refpurpose>Cria o <filename>Makefile.in</filename> e <filename>Makefile</filename> a partir de um <filename>Makefile.am</filename></refpurpose> </refnamediv> <refsynopsisdiv> -<cmdsynopsis -><command ->create_makefile</command -> <group -><replaceable ->caminho_relativo/Makefile</replaceable -></group -> <group -><replaceable ->caminho_relativo</replaceable -></group -> </cmdsynopsis> +<cmdsynopsis><command>create_makefile</command> <group><replaceable>caminho_relativo/Makefile</replaceable></group> <group><replaceable>caminho_relativo</replaceable></group> </cmdsynopsis> </refsynopsisdiv> <refsect1> -<title ->Descrição</title> - -<para ->O <command ->create_makefile</command -> cria o <filename ->Makefile.in</filename -> e <filename ->Makefile</filename -> em um subdiretório contendo um <filename ->Makefile.am</filename ->. Este script poupa o tempo de re-executar o configure completamente.</para> - -<para ->Observe que você deve fornecer o caminho para o <filename ->Makefile</filename -> <filename ->Makefile.am</filename -> desejado (apesar do <filename ->/Makefile</filename -> final poder ser omitido).</para> - -<para ->Este script pode ser rodado a partir do diretório de nível superior (o que contém o <filename ->configure</filename ->) ou a partir de um dos seus subdiretórios.</para> - -<para ->Se o diretório fonte for diferente do diretório de compilação (veja as variáveis de ambiente abaixo), será considerado que o <filename ->Makefile.am</filename -> e <filename ->Makefile.in</filename -> está abaixo do diretório fonte e que o <filename ->Makefile</filename -> está abaixo do diretório de compilação. </para> - -<para ->Este utilitário faz parte do Kit de Desenvolvimento de Software (SDK) do &kde;.</para> +<title>Descrição</title> + +<para>O <command>create_makefile</command> cria o <filename>Makefile.in</filename> e <filename>Makefile</filename> em um subdiretório contendo um <filename>Makefile.am</filename>. Este script poupa o tempo de re-executar o configure completamente.</para> + +<para>Observe que você deve fornecer o caminho para o <filename>Makefile</filename> <filename>Makefile.am</filename> desejado (apesar do <filename>/Makefile</filename> final poder ser omitido).</para> + +<para>Este script pode ser rodado a partir do diretório de nível superior (o que contém o <filename>configure</filename>) ou a partir de um dos seus subdiretórios.</para> + +<para>Se o diretório fonte for diferente do diretório de compilação (veja as variáveis de ambiente abaixo), será considerado que o <filename>Makefile.am</filename> e <filename>Makefile.in</filename> está abaixo do diretório fonte e que o <filename>Makefile</filename> está abaixo do diretório de compilação. </para> + +<para>Este utilitário faz parte do Kit de Desenvolvimento de Software (SDK) do &kde;.</para> </refsect1> <refsect1> -<title ->Ambiente</title> +<title>Ambiente</title> -<para ->Uma das seguintes variáveis (mas não ambas) deve ser configurada se o diretório fonte for diferente do diretório de compilação. Se o diretório de compilação é simplesmente um subdiretório do diretório fonte, a variável mais simples <envar ->OBJ_SUBDIR</envar -> deve ser usada. </para> +<para>Uma das seguintes variáveis (mas não ambas) deve ser configurada se o diretório fonte for diferente do diretório de compilação. Se o diretório de compilação é simplesmente um subdiretório do diretório fonte, a variável mais simples <envar>OBJ_SUBDIR</envar> deve ser usada. </para> <variablelist> <varlistentry> -<term -><envar ->OBJ_SUBJDIR</envar -></term> -<listitem -><para ->Indica que o diretório de compilação está no subdiretório fornecido do diretório fonte. Por exemplo, se o diretório fonte é <filename class="directory" ->tdesdk</filename -> e o diretório de compilação é <filename class="directory" ->tdesdk/obj-386-linux</filename ->, então o <envar ->OBJ_SUBDIR</envar -> deve ser configurado como <parameter ->obj-386-linux</parameter ->.</para -></listitem> +<term><envar>OBJ_SUBJDIR</envar></term> +<listitem><para>Indica que o diretório de compilação está no subdiretório fornecido do diretório fonte. Por exemplo, se o diretório fonte é <filename class="directory">tdesdk</filename> e o diretório de compilação é <filename class="directory">tdesdk/obj-386-linux</filename>, então o <envar>OBJ_SUBDIR</envar> deve ser configurado como <parameter>obj-386-linux</parameter>.</para></listitem> </varlistentry> <varlistentry> -<term -><envar ->OBJ_REPLACEMENT</envar -></term> -<listitem -><para ->Uma expressão <command ->sed</command -> que é usada para transformar o diretório fonte em diretório de compilação. Por exemplo, se o diretório fonte é <filename class="directory" ->tdesdk/obj-i386-linux</filename ->, então <envar ->OBJ_REPLACEMENT</envar -> deve ser configurado como <parameter ->s#tdesdk#tdesdk-obj#</parameter ->.</para> +<term><envar>OBJ_REPLACEMENT</envar></term> +<listitem><para>Uma expressão <command>sed</command> que é usada para transformar o diretório fonte em diretório de compilação. Por exemplo, se o diretório fonte é <filename class="directory">tdesdk/obj-i386-linux</filename>, então <envar>OBJ_REPLACEMENT</envar> deve ser configurado como <parameter>s#tdesdk#tdesdk-obj#</parameter>.</para> </listitem> </varlistentry> </variablelist> @@ -144,29 +59,13 @@ </refsect1> <refsect1> -<title ->Veja Também</title> +<title>Veja Também</title> -<para ->create_makefiles(1)</para> +<para>create_makefiles(1)</para> </refsect1> <refsect1> -<title ->Autores</title> - -<para ->O <command ->create_makefile</command -> foi escrito por &David.Faure; &David.Faure.mail;. Esta página de manual foi preparada por <personname -><firstname ->Ben</firstname -><surname ->Burton</surname -></personname -> <email ->bab@debian.org</email -> para o sistema Debian <acronym ->GNU</acronym ->/&Linux; (mas pode ser usada pelos outros).</para> +<title>Autores</title> + +<para>O <command>create_makefile</command> foi escrito por &David.Faure; &David.Faure.mail;. Esta página de manual foi preparada por <personname><firstname>Ben</firstname><surname>Burton</surname></personname> <email>bab@debian.org</email> para o sistema Debian <acronym>GNU</acronym>/&Linux; (mas pode ser usada pelos outros).</para> </refsect1> </refentry> diff --git a/tde-i18n-pt_BR/docs/tdesdk/scripts/man-create_makefiles.1.docbook b/tde-i18n-pt_BR/docs/tdesdk/scripts/man-create_makefiles.1.docbook index e5de0672235..e0b82237340 100644 --- a/tde-i18n-pt_BR/docs/tdesdk/scripts/man-create_makefiles.1.docbook +++ b/tde-i18n-pt_BR/docs/tdesdk/scripts/man-create_makefiles.1.docbook @@ -1,146 +1,71 @@ <?xml version="1.0" ?> <!DOCTYPE refentry PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [ -<!ENTITY create_makefiles "<command ->create_makefiles</command ->"> +<!ENTITY create_makefiles "<command>create_makefiles</command>"> <!ENTITY % Brazilian-Portuguese "INCLUDE"> ]> <refentry lang="&language;"> <refentryinfo> -<date ->8 de Março de 2003</date> +<date>8 de Março de 2003</date> </refentryinfo> <refmeta> -<refentrytitle ->&create_makefiles;</refentrytitle> -<manvolnum ->1</manvolnum> +<refentrytitle>&create_makefiles;</refentrytitle> +<manvolnum>1</manvolnum> </refmeta> <refnamediv> -<refname ->&create_makefiles;</refname> -<refpurpose ->Recria todas as <filename ->Makefile</filename ->s sob uma determinada pasta</refpurpose> +<refname>&create_makefiles;</refname> +<refpurpose>Recria todas as <filename>Makefile</filename>s sob uma determinada pasta</refpurpose> </refnamediv> <refsynopsisdiv> -<cmdsynopsis ->&create_makefiles; <group -><replaceable ->pasta</replaceable -></group -> </cmdsynopsis> +<cmdsynopsis>&create_makefiles; <group><replaceable>pasta</replaceable></group> </cmdsynopsis> </refsynopsisdiv> <refsect1> -<title ->Descrição</title> - -<para ->O &create_makefiles; recria todos os arquivos <filename ->Makefile</filename ->s na <replaceable ->pasta</replaceable -> e todas as suas sub-pastas (de forma recursiva) a partir dos modelos correspondentes em <filename ->Makefile.am</filename ->.</para> - -<para ->Este programa deverá ser executado na pasta de topo (a que contém o 'configure'). Este programa poupa tempo, em comparação com uma nova execução completa do 'configure'.</para> - -<para ->Se a pasta de código for diferente da pasta de compilação (veja as variáveis de ambiente em baixo), será assumido que cada arquivo <filename ->Makefile.am</filename -> e <filename ->Makefile.in</filename -> pertence abaixo da pasta de código e que cada <filename ->Makefile</filename -> pertence abaixo da pasta de compilação.</para> - -<para ->Este utilitário faz parte do Kit de Desenvolvimento de Software (SDK) do &kde;.</para> +<title>Descrição</title> + +<para>O &create_makefiles; recria todos os arquivos <filename>Makefile</filename>s na <replaceable>pasta</replaceable> e todas as suas sub-pastas (de forma recursiva) a partir dos modelos correspondentes em <filename>Makefile.am</filename>.</para> + +<para>Este programa deverá ser executado na pasta de topo (a que contém o 'configure'). Este programa poupa tempo, em comparação com uma nova execução completa do 'configure'.</para> + +<para>Se a pasta de código for diferente da pasta de compilação (veja as variáveis de ambiente em baixo), será assumido que cada arquivo <filename>Makefile.am</filename> e <filename>Makefile.in</filename> pertence abaixo da pasta de código e que cada <filename>Makefile</filename> pertence abaixo da pasta de compilação.</para> + +<para>Este utilitário faz parte do Kit de Desenvolvimento de Software (SDK) do &kde;.</para> </refsect1> <refsect1> -<title ->Ambiente</title> -<para ->Uma das seguintes variáveis (mas não ambas) deverão ser alteradas, se a pasta de código for diferente da pasta de compilação. Se a pasta de compilação for apenas uma sub-pasta da pasta de código, deverá ser usada a variável mais simples <envar ->OBJ_SUBDIR</envar ->. </para> +<title>Ambiente</title> +<para>Uma das seguintes variáveis (mas não ambas) deverão ser alteradas, se a pasta de código for diferente da pasta de compilação. Se a pasta de compilação for apenas uma sub-pasta da pasta de código, deverá ser usada a variável mais simples <envar>OBJ_SUBDIR</envar>. </para> <variablelist> <varlistentry> -<term -><envar ->OBJ_SUBJDIR</envar -></term> -<listitem -><para ->Indica que a pasta de compilação está na sub-pasta da pasta de código. Por exemplo, se a pasta de código for a <filename class="directory" ->tdesdk</filename -> e a pasta de compilação for a <filename class="directory" ->tdesdk/obj-i386-linux</filename ->, então o <envar ->OBJ_SUBDIR</envar -> deverá ser igual a <parameter ->obj-i386-linux</parameter ->.</para -></listitem> +<term><envar>OBJ_SUBJDIR</envar></term> +<listitem><para>Indica que a pasta de compilação está na sub-pasta da pasta de código. Por exemplo, se a pasta de código for a <filename class="directory">tdesdk</filename> e a pasta de compilação for a <filename class="directory">tdesdk/obj-i386-linux</filename>, então o <envar>OBJ_SUBDIR</envar> deverá ser igual a <parameter>obj-i386-linux</parameter>.</para></listitem> </varlistentry> <varlistentry> -<term -><envar ->OBJ_REPLACEMENT</envar -></term> -<listitem -><para ->Uma expressão de <command ->sed</command -> que é usada para transformar a pasta de origem na pasta de compilação. Por exemplo, se a pasta de código for a <filename class="directory" ->tdesdk/obj-i386-linux</filename ->, então a <envar ->OBJ_REPLACEMENT</envar -> deverá ser igual a <parameter ->s#tdesdk#tdesdk-obj#</parameter ->.</para> +<term><envar>OBJ_REPLACEMENT</envar></term> +<listitem><para>Uma expressão de <command>sed</command> que é usada para transformar a pasta de origem na pasta de compilação. Por exemplo, se a pasta de código for a <filename class="directory">tdesdk/obj-i386-linux</filename>, então a <envar>OBJ_REPLACEMENT</envar> deverá ser igual a <parameter>s#tdesdk#tdesdk-obj#</parameter>.</para> </listitem> </varlistentry> </variablelist> </refsect1> <refsect1> -<title ->Veja Também</title> +<title>Veja Também</title> -<para ->create_makefile(1) make(2)</para> +<para>create_makefile(1) make(2)</para> </refsect1> <refsect1> -<title ->Autores</title> - -<para ->&create_makefiles; foi escrito por &David.Faure; &David.Faure.mail;.</para> - -<para ->Esta página de manual foi preparada por <personname -><firstname ->Ben</firstname -><surname ->Burton</surname -></personname -> <email ->bab@debian.org</email -> para o sistema GNU/Linux da Debian (mas poderá ser usado por outros).</para> +<title>Autores</title> + +<para>&create_makefiles; foi escrito por &David.Faure; &David.Faure.mail;.</para> + +<para>Esta página de manual foi preparada por <personname><firstname>Ben</firstname><surname>Burton</surname></personname> <email>bab@debian.org</email> para o sistema GNU/Linux da Debian (mas poderá ser usado por outros).</para> </refsect1> diff --git a/tde-i18n-pt_BR/docs/tdesdk/scripts/man-cvscheck.1.docbook b/tde-i18n-pt_BR/docs/tdesdk/scripts/man-cvscheck.1.docbook index 1ca363edae7..0537ce44989 100644 --- a/tde-i18n-pt_BR/docs/tdesdk/scripts/man-cvscheck.1.docbook +++ b/tde-i18n-pt_BR/docs/tdesdk/scripts/man-cvscheck.1.docbook @@ -1,202 +1,104 @@ <?xml version="1.0" ?> <!DOCTYPE refentry PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [ -<!ENTITY cvscheck "<command ->cvscheck</command ->"> -<!ENTITY CVS "<acronym ->CVS</acronym ->"> +<!ENTITY cvscheck "<command>cvscheck</command>"> +<!ENTITY CVS "<acronym>CVS</acronym>"> <!ENTITY % Brazilian-Portuguese "INCLUDE"> ]> <refentry lang="&language;"> <refentryinfo> -<date ->8 de Março de 2003</date> +<date>8 de Março de 2003</date> </refentryinfo> <refmeta> -<refentrytitle ->&cvscheck;</refentrytitle> -<manvolnum ->1</manvolnum> +<refentrytitle>&cvscheck;</refentrytitle> +<manvolnum>1</manvolnum> </refmeta> <refnamediv> -<refname ->&cvscheck;</refname> -<refpurpose ->Relatório de estado, sem conexão ao servidor, para arquivos num módulo de &CVS;.</refpurpose> +<refname>&cvscheck;</refname> +<refpurpose>Relatório de estado, sem conexão ao servidor, para arquivos num módulo de &CVS;.</refpurpose> </refnamediv> <refsynopsisdiv> -<cmdsynopsis ->&cvscheck; <group -><replaceable ->pasta</replaceable -></group -> </cmdsynopsis> +<cmdsynopsis>&cvscheck; <group><replaceable>pasta</replaceable></group> </cmdsynopsis> </refsynopsisdiv> <refsect1> -<title ->Descrição</title> +<title>Descrição</title> -<para ->O &cvscheck; imprime informações sobre o estado da sua versão local ('checkout') do &CVS; sem se comunicar com o servidor. Isto significa que é extremamente rápido e não precisa de uma conexão de rede.</para> +<para>O &cvscheck; imprime informações sobre o estado da sua versão local ('checkout') do &CVS; sem se comunicar com o servidor. Isto significa que é extremamente rápido e não precisa de uma conexão de rede.</para> -<para ->A pasta indicada e as suas sub-pastas serão processados de forma recursiva. Se não for indicada qualquer pasta, será usada a pasta atual e as suas sub-pastas.</para> +<para>A pasta indicada e as suas sub-pastas serão processados de forma recursiva. Se não for indicada qualquer pasta, será usada a pasta atual e as suas sub-pastas.</para> -<para ->Todos os arquivos com um estado interessante serão impressos com um caractere de estado à frente do seu nome. Os caracteres de estado são os seguintes.</para> +<para>Todos os arquivos com um estado interessante serão impressos com um caractere de estado à frente do seu nome. Os caracteres de estado são os seguintes.</para> <variablelist> <varlistentry> -<term -><returnvalue ->?</returnvalue -> <filename ->foobar.c</filename -></term> +<term><returnvalue>?</returnvalue> <filename>foobar.c</filename></term> <listitem> -<para ->O arquivo não é conhecido pelo &CVS;</para> +<para>O arquivo não é conhecido pelo &CVS;</para> </listitem> </varlistentry> <varlistentry> -<term -><returnvalue ->M</returnvalue -> <filename ->foobar.c</filename -></term> +<term><returnvalue>M</returnvalue> <filename>foobar.c</filename></term> <listitem> -<para ->O arquivo foi realmente modificado localmente</para> +<para>O arquivo foi realmente modificado localmente</para> </listitem> </varlistentry> <varlistentry> -<term -><returnvalue ->m</returnvalue -> <filename ->foobar.c</filename -></term> +<term><returnvalue>m</returnvalue> <filename>foobar.c</filename></term> <listitem> -<para ->O arquivo <emphasis ->pode</emphasis -> ter modificações locais. Você deve fazer <command ->diff</command -> com o servidor para verificar.</para> +<para>O arquivo <emphasis>pode</emphasis> ter modificações locais. Você deve fazer <command>diff</command> com o servidor para verificar.</para> </listitem> </varlistentry> <varlistentry> -<term -><returnvalue ->C</returnvalue -> <filename ->foobar.c</filename -></term> +<term><returnvalue>C</returnvalue> <filename>foobar.c</filename></term> <listitem> -<para ->O arquivo tem um conflito com o &CVS; e por isso não pode ser enviado.</para> +<para>O arquivo tem um conflito com o &CVS; e por isso não pode ser enviado.</para> </listitem> </varlistentry> <varlistentry> -<term -><returnvalue ->U</returnvalue -> <filename ->foobar.c</filename -></term> +<term><returnvalue>U</returnvalue> <filename>foobar.c</filename></term> <listitem> -<para ->O arquivo está no &CVS; mas não está na sua cópia local.</para> +<para>O arquivo está no &CVS; mas não está na sua cópia local.</para> </listitem> </varlistentry> <varlistentry> -<term -><returnvalue ->T</returnvalue -> <filename ->foobar.c</filename -></term> -<listitem -><para ->O arquivo tem uma marca &CVS; fixa anormal.</para -></listitem> +<term><returnvalue>T</returnvalue> <filename>foobar.c</filename></term> +<listitem><para>O arquivo tem uma marca &CVS; fixa anormal.</para></listitem> </varlistentry> <varlistentry> -<term -><returnvalue ->A</returnvalue -> <filename ->foobar.c</filename -></term> +<term><returnvalue>A</returnvalue> <filename>foobar.c</filename></term> <listitem> -<para ->Você fez <userinput -><command ->cvs</command -> <option ->add</option -></userinput -> para este arquivo, mas ainda não o enviou.</para> +<para>Você fez <userinput><command>cvs</command> <option>add</option></userinput> para este arquivo, mas ainda não o enviou.</para> </listitem> </varlistentry> <varlistentry> -<term -><returnvalue ->R</returnvalue -> <filename ->foobar.c</filename -></term> +<term><returnvalue>R</returnvalue> <filename>foobar.c</filename></term> <listitem> -<para ->Você fez <userinput -><command ->cvs</command -> <option ->rm</option -></userinput -> para este arquivo, mas ainda não o enviou.</para> +<para>Você fez <userinput><command>cvs</command> <option>rm</option></userinput> para este arquivo, mas ainda não o enviou.</para> </listitem> </varlistentry> </variablelist> -<para ->Este utilitário faz parte do Kit de Desenvolvimento de Software (SDK) do &kde;.</para> +<para>Este utilitário faz parte do Kit de Desenvolvimento de Software (SDK) do &kde;.</para> </refsect1> <refsect1> -<title ->Veja Também</title> +<title>Veja Também</title> -<para ->cvs(1)</para> +<para>cvs(1)</para> </refsect1> <refsect1> -<title ->Autores</title> - -<para ->cvscheck foi escrito por &Dirk.Mueller; &Dirk.Mueller.mail; e Sirtaj.Singh.Kang; &Sirtaj.Singh.Kang.mail;</para> - -<para ->Esta página de manual foi preparada por <personname -><firstname ->Ben</firstname -> <surname ->Burton</surname -></personname -> <email ->bab@debian.org</email -> para o sistema Debian GNU/Linux (mas pode ser utilizada por outros). </para> +<title>Autores</title> + +<para>cvscheck foi escrito por &Dirk.Mueller; &Dirk.Mueller.mail; e Sirtaj.Singh.Kang; &Sirtaj.Singh.Kang.mail;</para> + +<para>Esta página de manual foi preparada por <personname><firstname>Ben</firstname> <surname>Burton</surname></personname> <email>bab@debian.org</email> para o sistema Debian GNU/Linux (mas pode ser utilizada por outros). </para> </refsect1> </refentry> diff --git a/tde-i18n-pt_BR/docs/tdesdk/scripts/man-cvslastchange.1.docbook b/tde-i18n-pt_BR/docs/tdesdk/scripts/man-cvslastchange.1.docbook index 981ab9173d0..da8c4eb9f47 100644 --- a/tde-i18n-pt_BR/docs/tdesdk/scripts/man-cvslastchange.1.docbook +++ b/tde-i18n-pt_BR/docs/tdesdk/scripts/man-cvslastchange.1.docbook @@ -1,78 +1,45 @@ <?xml version="1.0" ?> <!DOCTYPE refentry PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [ -<!ENTITY cvslastchange "<command ->cvslastchange</command ->"> -<!ENTITY CVS "<acronym ->CVS</acronym ->"> +<!ENTITY cvslastchange "<command>cvslastchange</command>"> +<!ENTITY CVS "<acronym>CVS</acronym>"> <!ENTITY % Brazilian-Portuguese "INCLUDE"> ]> <refentry lang="&language;"> <refentryinfo> -<author -><personname -><firstname ->Ben</firstname -><surname ->Burton</surname -></personname -> <email ->bab@debian.org</email -></author> -<date ->8 de Março de 2003</date> +<author><personname><firstname>Ben</firstname><surname>Burton</surname></personname> <email>bab@debian.org</email></author> +<date>8 de Março de 2003</date> </refentryinfo> <refmeta> -<refentrytitle ->&cvslastchange;</refentrytitle> -<manvolnum ->1</manvolnum> +<refentrytitle>&cvslastchange;</refentrytitle> +<manvolnum>1</manvolnum> </refmeta> <refnamediv> -<refname ->&cvslastchange;</refname> -<refpurpose ->Mostra a última alteração enviada ('committed') para o &CVS; de um arquivo</refpurpose> +<refname>&cvslastchange;</refname> +<refpurpose>Mostra a última alteração enviada ('committed') para o &CVS; de um arquivo</refpurpose> </refnamediv> <refsynopsisdiv> -<cmdsynopsis ->&cvslastchange; <group -><replaceable ->arquivo</replaceable -></group -> </cmdsynopsis> +<cmdsynopsis>&cvslastchange; <group><replaceable>arquivo</replaceable></group> </cmdsynopsis> </refsynopsisdiv> <refsect1> -<title ->Descrição</title> +<title>Descrição</title> -<para ->O &cvslastchange; mostra a última alteração de um arquivo enviada ('committed') para o &CVS;. Ele usa o <command ->cvs diff</command -> e o <command ->cvs log</command -> para fazer isso.</para> +<para>O &cvslastchange; mostra a última alteração de um arquivo enviada ('committed') para o &CVS;. Ele usa o <command>cvs diff</command> e o <command>cvs log</command> para fazer isso.</para> -<para ->O &cvslastchange; funciona em qualquer ramificação do &CVS;, não só no HEAD.</para> +<para>O &cvslastchange; funciona em qualquer ramificação do &CVS;, não só no HEAD.</para> -<para ->Este utilitário faz parte do Kit de Desenvolvimento de Software (SDK) do &kde;.</para> +<para>Este utilitário faz parte do Kit de Desenvolvimento de Software (SDK) do &kde;.</para> </refsect1> <refsect1> -<title ->Veja Também</title> +<title>Veja Também</title> -<para ->cvslastlog(1) cvsrevertlast(1) cvs(1)</para> +<para>cvslastlog(1) cvsrevertlast(1) cvs(1)</para> </refsect1> diff --git a/tde-i18n-pt_BR/docs/tdesdk/scripts/man-cvslastlog.1.docbook b/tde-i18n-pt_BR/docs/tdesdk/scripts/man-cvslastlog.1.docbook index 5185186a36f..c08a1903f4c 100644 --- a/tde-i18n-pt_BR/docs/tdesdk/scripts/man-cvslastlog.1.docbook +++ b/tde-i18n-pt_BR/docs/tdesdk/scripts/man-cvslastlog.1.docbook @@ -5,62 +5,30 @@ <refentry lang="&language;"> <refentryinfo> -<author -><personname -><firstname ->Ben</firstname -><surname ->Burton</surname -></personname -> <email -></email -></author> -<date ->6 de Abril de 2003</date> +<author><personname><firstname>Ben</firstname><surname>Burton</surname></personname> <email></email></author> +<date>6 de Abril de 2003</date> </refentryinfo> <refmeta> -<refentrytitle -><command ->cvslastlog</command -></refentrytitle> -<manvolnum ->1</manvolnum> +<refentrytitle><command>cvslastlog</command></refentrytitle> +<manvolnum>1</manvolnum> </refmeta> <refnamediv> -<refname -><command ->cvslastlog</command -></refname> -<refpurpose ->Imprime o item de registro sobre o último envio ('commit') de um arquivo.</refpurpose> +<refname><command>cvslastlog</command></refname> +<refpurpose>Imprime o item de registro sobre o último envio ('commit') de um arquivo.</refpurpose> </refnamediv> <refsynopsisdiv> -<cmdsynopsis -><command ->cvslastlog</command -> <group -><option -><replaceable ->arquivo</replaceable -></option -></group -> </cmdsynopsis> +<cmdsynopsis><command>cvslastlog</command> <group><option><replaceable>arquivo</replaceable></option></group> </cmdsynopsis> </refsynopsisdiv> <refsect1> -<title ->Descrição</title> +<title>Descrição</title> -<para ->O <command ->cvslastlog</command -> mostra o registro associado ao último envio ('commit') do CVS para o arquivo indicado. Depende da versão do arquivo local, não da que se encontra no servidor. </para> +<para>O <command>cvslastlog</command> mostra o registro associado ao último envio ('commit') do CVS para o arquivo indicado. Depende da versão do arquivo local, não da que se encontra no servidor. </para> -<para ->Este utilitário faz parte do Kit de Desenvolvimento de Software (SDK) do &kde;.</para> +<para>Este utilitário faz parte do Kit de Desenvolvimento de Software (SDK) do &kde;.</para> </refsect1> diff --git a/tde-i18n-pt_BR/docs/tdesdk/scripts/man-cvsrevertlast.1.docbook b/tde-i18n-pt_BR/docs/tdesdk/scripts/man-cvsrevertlast.1.docbook index b905f88e0a5..a77c189ce5d 100644 --- a/tde-i18n-pt_BR/docs/tdesdk/scripts/man-cvsrevertlast.1.docbook +++ b/tde-i18n-pt_BR/docs/tdesdk/scripts/man-cvsrevertlast.1.docbook @@ -5,69 +5,37 @@ <refentry lang="&language;"> <refentryinfo> -<author -><personname -><firstname ->Ben</firstname -><surname ->Burton</surname -></personname -> <email -></email -></author> -<date ->xx de xx de xxxx</date> +<author><personname><firstname>Ben</firstname><surname>Burton</surname></personname> <email></email></author> +<date>xx de xx de xxxx</date> </refentryinfo> <refmeta> -<refentrytitle -><command ->cvsrevertlast</command -></refentrytitle> -<manvolnum ->1</manvolnum> +<refentrytitle><command>cvsrevertlast</command></refentrytitle> +<manvolnum>1</manvolnum> </refmeta> <refnamediv> -<refname -><command ->cvsrevertlast</command -></refname> -<refpurpose ->Reverte os arquivos no CVS para a versão anterior</refpurpose> +<refname><command>cvsrevertlast</command></refname> +<refpurpose>Reverte os arquivos no CVS para a versão anterior</refpurpose> </refnamediv> <refsynopsisdiv> -<cmdsynopsis -><command ->cvsrevertlast</command -> <group -><option -><replaceable ->arquivo</replaceable -></option -></group -> </cmdsynopsis> +<cmdsynopsis><command>cvsrevertlast</command> <group><option><replaceable>arquivo</replaceable></option></group> </cmdsynopsis> </refsynopsisdiv> <refsect1> -<title ->Descrição</title> +<title>Descrição</title> -<para ->O 'cvsrevertlast' é usado para reverter todos os arquivos, na linha de comando, para a versão anterior no CVS. Os arquivos não serão enviados ('committed').</para> +<para>O 'cvsrevertlast' é usado para reverter todos os arquivos, na linha de comando, para a versão anterior no CVS. Os arquivos não serão enviados ('committed').</para> -<para ->Este utilitário faz parte do Kit de Desenvolvimento de Software do KDE. </para> +<para>Este utilitário faz parte do Kit de Desenvolvimento de Software do KDE. </para> </refsect1> <refsect1> -<title ->Veja Também</title> +<title>Veja Também</title> -<para ->cvsblame(1)</para> +<para>cvsblame(1)</para> </refsect1> diff --git a/tde-i18n-pt_BR/docs/tdesdk/scripts/man-cxxmetric.1.docbook b/tde-i18n-pt_BR/docs/tdesdk/scripts/man-cxxmetric.1.docbook index 42661d5ed3e..1c81be79560 100644 --- a/tde-i18n-pt_BR/docs/tdesdk/scripts/man-cxxmetric.1.docbook +++ b/tde-i18n-pt_BR/docs/tdesdk/scripts/man-cxxmetric.1.docbook @@ -5,61 +5,30 @@ <refentry lang="&language;"> <refentryinfo> -<author -><personname -><firstname ->Ben</firstname -><surname ->Burton</surname -></personname -> <email ->bab@debian.org</email -></author> -<date ->7 de Abril de 2003</date> +<author><personname><firstname>Ben</firstname><surname>Burton</surname></personname> <email>bab@debian.org</email></author> +<date>7 de Abril de 2003</date> </refentryinfo> <refmeta> -<refentrytitle -><command ->cxxmetric</command -></refentrytitle> -<manvolnum ->1</manvolnum> +<refentrytitle><command>cxxmetric</command></refentrytitle> +<manvolnum>1</manvolnum> </refmeta> <refnamediv> -<refname -><command ->cxxmetric</command -></refname> -<refpurpose ->Algumas medidas simples de código para C e C++</refpurpose> +<refname><command>cxxmetric</command></refname> +<refpurpose>Algumas medidas simples de código para C e C++</refpurpose> </refnamediv> <refsynopsisdiv> -<cmdsynopsis -><command ->cxxmetric</command -> <group -><option -><replaceable ->arquivo</replaceable -></option -></group -> </cmdsynopsis> +<cmdsynopsis><command>cxxmetric</command> <group><option><replaceable>arquivo</replaceable></option></group> </cmdsynopsis> </refsynopsisdiv> <refsect1> -<title ->Descrição</title> +<title>Descrição</title> -<para ->O 'cxxmetric' conta as linhas de código, comentários e espaços em branco, calculando ainda várias outras estatísticas para cada arquivo de código. Os arquivos de código deverão estar em C ou C++.</para> +<para>O 'cxxmetric' conta as linhas de código, comentários e espaços em branco, calculando ainda várias outras estatísticas para cada arquivo de código. Os arquivos de código deverão estar em C ou C++.</para> -<para ->Este utilitário faz parte do Kit de Desenvolvimento de Software do KDE. </para -> +<para>Este utilitário faz parte do Kit de Desenvolvimento de Software do KDE. </para> </refsect1> diff --git a/tde-i18n-pt_BR/docs/tdesdk/scripts/man-demangle.1.docbook b/tde-i18n-pt_BR/docs/tdesdk/scripts/man-demangle.1.docbook index c50839d5e5a..94fb4568e5c 100644 --- a/tde-i18n-pt_BR/docs/tdesdk/scripts/man-demangle.1.docbook +++ b/tde-i18n-pt_BR/docs/tdesdk/scripts/man-demangle.1.docbook @@ -5,100 +5,57 @@ <refentry lang="&language;"> <refentryinfo> -<author -><personname -><firstname ->Ben</firstname -><surname ->Burton</surname -></personname -> <email ->bab@debian.org</email -></author> -<date ->7 de Abril de 2003</date> +<author><personname><firstname>Ben</firstname><surname>Burton</surname></personname> <email>bab@debian.org</email></author> +<date>7 de Abril de 2003</date> </refentryinfo> <refmeta> -<refentrytitle -><command ->demangle</command -></refentrytitle> -<manvolnum ->1</manvolnum> +<refentrytitle><command>demangle</command></refentrytitle> +<manvolnum>1</manvolnum> </refmeta> <refnamediv> -<refname -><command ->demangle</command -></refname> -<refpurpose ->Decodifica nomes de símbolos C++</refpurpose> +<refname><command>demangle</command></refname> +<refpurpose>Decodifica nomes de símbolos C++</refpurpose> </refnamediv> <refsynopsisdiv> <cmdsynopsis> -<command ->demangle</command> +<command>demangle</command> </cmdsynopsis> </refsynopsisdiv> <refsect1> -<title ->Descrição</title> +<title>Descrição</title> -<para -><command ->demangle</command -> lê uma lista de símbolos codificados C++ do 'standard input' e converte esses nome para um formato legível no 'standard output'.</para> +<para><command>demangle</command> lê uma lista de símbolos codificados C++ do 'standard input' e converte esses nome para um formato legível no 'standard output'.</para> -<para ->Este utilitário faz parte do Kit de Desenvolvimento de Software (SDK) do &kde;.</para -> +<para>Este utilitário faz parte do Kit de Desenvolvimento de Software (SDK) do &kde;.</para> </refsect1> <refsect1> -<title ->Exemplo</title> +<title>Exemplo</title> -<para ->Crie um arquivo chamado <filename ->nomes</filename -> com os seguintes nomes de símbolos codificados:</para> +<para>Crie um arquivo chamado <filename>nomes</filename> com os seguintes nomes de símbolos codificados:</para> -<programlisting ->_ZNK6Object10metaObjectEv +<programlisting>_ZNK6Object10metaObjectEv _ZN8QPtrListI5ArrowE5clearEv _ZTC4Kolf0_11KMainWindow</programlisting> -<para ->Este nomes podem ser descodificados da seguinte forma:</para> - -<screen -><prompt ->exemplo$</prompt -> <userinput -><command ->demangle</command -> < <filename ->nomes</filename -></userinput> -<computeroutput ->Object::metaObject() const +<para>Este nomes podem ser descodificados da seguinte forma:</para> + +<screen><prompt>exemplo$</prompt> <userinput><command>demangle</command> < <filename>nomes</filename></userinput> +<computeroutput>Object::metaObject() const QPtrList<Arrow>::clear() -construction vtable for TDEMainWindow-in-Kolf</computeroutput -></screen> +construction vtable for TDEMainWindow-in-Kolf</computeroutput></screen> </refsect1> <refsect1> -<title ->Veja Também</title> +<title>Veja Também</title> -<para ->kminspector(1) kmtrace(1) match(1)</para> +<para>kminspector(1) kmtrace(1) match(1)</para> </refsect1> diff --git a/tde-i18n-pt_BR/docs/tdesdk/scripts/man-extend_dmalloc.1.docbook b/tde-i18n-pt_BR/docs/tdesdk/scripts/man-extend_dmalloc.1.docbook index 8bf21c3443b..08d2359d625 100644 --- a/tde-i18n-pt_BR/docs/tdesdk/scripts/man-extend_dmalloc.1.docbook +++ b/tde-i18n-pt_BR/docs/tdesdk/scripts/man-extend_dmalloc.1.docbook @@ -5,93 +5,39 @@ <refentry lang="&language;"> <refentryinfo> -<author -><personname -><firstname ->Ben</firstname -><surname ->Burton</surname -></personname -> <email ->bab@debian.org</email -></author> -<date ->7 de Abril de 2003</date> +<author><personname><firstname>Ben</firstname><surname>Burton</surname></personname> <email>bab@debian.org</email></author> +<date>7 de Abril de 2003</date> </refentryinfo> <refmeta> -<refentrytitle -><command ->extend_dmalloc</command -></refentrytitle> -<manvolnum ->1</manvolnum> +<refentrytitle><command>extend_dmalloc</command></refentrytitle> +<manvolnum>1</manvolnum> </refmeta> <refnamediv> -<refname -><command ->extend_dmalloc</command -></refname> -<refpurpose ->Analiza endereços de retorno de arquivos de registro dmalloc.</refpurpose> +<refname><command>extend_dmalloc</command></refname> +<refpurpose>Analiza endereços de retorno de arquivos de registro dmalloc.</refpurpose> </refnamediv> <refsynopsisdiv> -<cmdsynopsis -><command ->extend_dmalloc</command -> <group -><option -><replaceable ->registro-dmalloc</replaceable -> <command ->binário</command -></option -></group -> </cmdsynopsis> +<cmdsynopsis><command>extend_dmalloc</command> <group><option><replaceable>registro-dmalloc</replaceable> <command>binário</command></option></group> </cmdsynopsis> </refsynopsisdiv> <refsect1> -<title ->Descrição</title> +<title>Descrição</title> -<para ->O <command ->extend_dmalloc</command -> irá executar o <command ->gdb</command ->(1) para obter informações sobre os endereços devolvidos num arquivo de registro do <command ->dmalloc</command ->(1). Especificamente, ele irá examinar as linhas <literal ->ra=</literal -> e tentará obter os números de linha correspondentes</para> +<para>O <command>extend_dmalloc</command> irá executar o <command>gdb</command>(1) para obter informações sobre os endereços devolvidos num arquivo de registro do <command>dmalloc</command>(1). Especificamente, ele irá examinar as linhas <literal>ra=</literal> e tentará obter os números de linha correspondentes</para> -<para ->O argumento <option -><command ->binário</command -></option -> deverá ser o executável que gerou o registro <filename ->registro-dmalloc</filename ->.</para> +<para>O argumento <option><command>binário</command></option> deverá ser o executável que gerou o registro <filename>registro-dmalloc</filename>.</para> -<para ->Este utilitário faz parte do Kit de Desenvolvimento de Software (SDK) do &kde;.</para> +<para>Este utilitário faz parte do Kit de Desenvolvimento de Software (SDK) do &kde;.</para> </refsect1> <refsect1> -<title ->Notas</title> -<para ->Você poderá querer direcionar o resultado do <command ->extend_dmalloc</command -> para um arquivo, caso contrário o <command ->gdb</command -> parece ficar à espera de algum retorno, como se estivesse no fim de uma página. </para -> +<title>Notas</title> +<para>Você poderá querer direcionar o resultado do <command>extend_dmalloc</command> para um arquivo, caso contrário o <command>gdb</command> parece ficar à espera de algum retorno, como se estivesse no fim de uma página. </para> </refsect1> </refentry> diff --git a/tde-i18n-pt_BR/docs/tdesdk/scripts/man-extractrc.1.docbook b/tde-i18n-pt_BR/docs/tdesdk/scripts/man-extractrc.1.docbook index 2a02652b16c..8fe57066134 100644 --- a/tde-i18n-pt_BR/docs/tdesdk/scripts/man-extractrc.1.docbook +++ b/tde-i18n-pt_BR/docs/tdesdk/scripts/man-extractrc.1.docbook @@ -5,69 +5,32 @@ <refentry lang="&language;"> <refentryinfo> -<author -><personname -><firstname ->Ben</firstname -><surname ->Burton</surname -></personname -> <email ->bab@debian.org</email -></author> -<date ->7 de Abril de 2003</date> +<author><personname><firstname>Ben</firstname><surname>Burton</surname></personname> <email>bab@debian.org</email></author> +<date>7 de Abril de 2003</date> </refentryinfo> <refmeta> -<refentrytitle -><command ->extractrc</command -></refentrytitle> -<manvolnum ->1</manvolnum> +<refentrytitle><command>extractrc</command></refentrytitle> +<manvolnum>1</manvolnum> </refmeta> <refnamediv> -<refname -><command ->extractrc</command -></refname> -<refpurpose ->Extrai mensagens de arquivo UI e GUI-RC</refpurpose> +<refname><command>extractrc</command></refname> +<refpurpose>Extrai mensagens de arquivo UI e GUI-RC</refpurpose> </refnamediv> <refsynopsisdiv> -<cmdsynopsis -><command ->extractrc</command -> <group -><option -><replaceable ->arquivo</replaceable -></option -></group -> </cmdsynopsis> +<cmdsynopsis><command>extractrc</command> <group><option><replaceable>arquivo</replaceable></option></group> </cmdsynopsis> </refsynopsisdiv> <refsect1> -<title ->Descrição</title> +<title>Descrição</title> -<para ->O <command ->extractrc</command -> obtém todas as marcas de texto e de outras mensagens nos arquivos indicados e escreve as mensagens correspondentes do i18n() no 'standard output', para que o 'xgettext' as consiga processar.</para> +<para>O <command>extractrc</command> obtém todas as marcas de texto e de outras mensagens nos arquivos indicados e escreve as mensagens correspondentes do i18n() no 'standard output', para que o 'xgettext' as consiga processar.</para> -<para ->Ele reconhece arquivos (&Qt;/&kde;) <application ->designer</application -> <acronym ->UI</acronym -> e arquivos &XML; GUI-RC. </para> +<para>Ele reconhece arquivos (&Qt;/&kde;) <application>designer</application> <acronym>UI</acronym> e arquivos &XML; GUI-RC. </para> -<para ->Este utilitário faz parte do Kit de Desenvolvimento de Software do KDE. </para> +<para>Este utilitário faz parte do Kit de Desenvolvimento de Software do KDE. </para> </refsect1> diff --git a/tde-i18n-pt_BR/docs/tdesdk/scripts/man-fixincludes.1.docbook b/tde-i18n-pt_BR/docs/tdesdk/scripts/man-fixincludes.1.docbook index 4d8b7093810..4510ed2b82c 100644 --- a/tde-i18n-pt_BR/docs/tdesdk/scripts/man-fixincludes.1.docbook +++ b/tde-i18n-pt_BR/docs/tdesdk/scripts/man-fixincludes.1.docbook @@ -5,162 +5,73 @@ <refentry lang="&language;"> <refentryinfo> -<author -><personname -><firstname ->Ben</firstname -><surname ->Burton</surname -></personname -> <email ->bab@debian.org</email -></author> -<date ->7 de Abril de 2003</date> +<author><personname><firstname>Ben</firstname><surname>Burton</surname></personname> <email>bab@debian.org</email></author> +<date>7 de Abril de 2003</date> </refentryinfo> <refmeta> -<refentrytitle -><command ->fixincludes</command -></refentrytitle> -<manvolnum ->1</manvolnum> +<refentrytitle><command>fixincludes</command></refentrytitle> +<manvolnum>1</manvolnum> </refmeta> <refnamediv> -<refname -><command ->fixincludes</command -></refname> -<refpurpose ->Reduz o número de #includes em arquivo de código do &kde;</refpurpose> +<refname><command>fixincludes</command></refname> +<refpurpose>Reduz o número de #includes em arquivo de código do &kde;</refpurpose> </refnamediv> <refsynopsisdiv> -<cmdsynopsis -><command ->fixincludes</command -> <group -><option ->-v, --verbose</option -></group -> <group -><option ->-e, --experimental</option -></group -> <group -><option ->-m, --modify</option -></group -> <group -><option -><replaceable ->arquivo</replaceable -></option -></group -> <group -><option ->--help</option -></group -> </cmdsynopsis> +<cmdsynopsis><command>fixincludes</command> <group><option>-v, --verbose</option></group> <group><option>-e, --experimental</option></group> <group><option>-m, --modify</option></group> <group><option><replaceable>arquivo</replaceable></option></group> <group><option>--help</option></group> </cmdsynopsis> </refsynopsisdiv> <refsect1> -<title ->Descrição</title> +<title>Descrição</title> -<para ->O <command ->fixincludes</command -> tenta reduzir o número de inclusões (#include) nos arquivos de código em C++. Muito do processamento dele é específico do código do &kde; e, como tal, poderá não funcionar tão bem com o código dos aplicativos não-&kde;.</para> +<para>O <command>fixincludes</command> tenta reduzir o número de inclusões (#include) nos arquivos de código em C++. Muito do processamento dele é específico do código do &kde; e, como tal, poderá não funcionar tão bem com o código dos aplicativos não-&kde;.</para> -<para ->Os seguintes problemas são identificados pelo <command ->fixincludes</command ->:</para> +<para>Os seguintes problemas são identificados pelo <command>fixincludes</command>:</para> <itemizedlist> <listitem> -<para ->A inclusão de arquivos que já não sejam suportados, mas que ainda existam por compatibilidade com versões mais antigas do Qt/KDE;</para> +<para>A inclusão de arquivos que já não sejam suportados, mas que ainda existam por compatibilidade com versões mais antigas do Qt/KDE;</para> </listitem> <listitem> -<para ->Incluir o mesmo arquivo várias vezes. </para> +<para>Incluir o mesmo arquivo várias vezes. </para> </listitem> </itemizedlist> -<para ->Existe também um modo experimental que tenta remover cada um dos #include's de cada vez (com algumas exceções) para ver se o código ainda compila. Lembre-se que este modo experimental irá modificar o código original. </para> +<para>Existe também um modo experimental que tenta remover cada um dos #include's de cada vez (com algumas exceções) para ver se o código ainda compila. Lembre-se que este modo experimental irá modificar o código original. </para> -<para ->Por padrão, o código não será modificado; os problemas identificados simplesmente serão apresentados no 'standard output'. </para> +<para>Por padrão, o código não será modificado; os problemas identificados simplesmente serão apresentados no 'standard output'. </para> -<para ->A lista de arquivos de C++ a examinar deverá ser indicada na linha de comando. Se não forem indicados arquivos, todo o código em C++ dentro e/ou abaixo da pasta atual será examinado (com a exceção das pastas cujo <filename ->Makefile.am</filename -> contenha <option ->-UQT_NO_COMPAT</option -> ou <option ->-UKDE_NO_COMPAT</option ->)</para> +<para>A lista de arquivos de C++ a examinar deverá ser indicada na linha de comando. Se não forem indicados arquivos, todo o código em C++ dentro e/ou abaixo da pasta atual será examinado (com a exceção das pastas cujo <filename>Makefile.am</filename> contenha <option>-UQT_NO_COMPAT</option> ou <option>-UKDE_NO_COMPAT</option>)</para> -<para ->Este utilitário faz parte do Kit de Desenvolvimento de Software do KDE. </para> +<para>Este utilitário faz parte do Kit de Desenvolvimento de Software do KDE. </para> </refsect1> <refsect1> -<title ->Opções</title> +<title>Opções</title> <variablelist> <varlistentry> -<term -><option ->-v, --verbose</option -></term> -<listitem -><para ->Modo descritivo. Será mostrada alguma informação adicional de depuração no 'standard output'.</para -></listitem> +<term><option>-v, --verbose</option></term> +<listitem><para>Modo descritivo. Será mostrada alguma informação adicional de depuração no 'standard output'.</para></listitem> </varlistentry> <varlistentry> -<term -><option ->-e, --experimental</option -></term> -<listitem -><para ->O modo experimental, tal como foi descrito, em detalhe. Lembre-se que esta opção implica a <option ->--modify</option ->.</para -></listitem> +<term><option>-e, --experimental</option></term> +<listitem><para>O modo experimental, tal como foi descrito, em detalhe. Lembre-se que esta opção implica a <option>--modify</option>.</para></listitem> </varlistentry> <varlistentry> -<term -><option ->-m, --modify</option -></term> -<listitem -><para ->Assim como escreve as mensagens no 'standard output', efetua de fato as modificações ao código original, de modo a corrigir os problemas encontrados.</para -></listitem> +<term><option>-m, --modify</option></term> +<listitem><para>Assim como escreve as mensagens no 'standard output', efetua de fato as modificações ao código original, de modo a corrigir os problemas encontrados.</para></listitem> </varlistentry> </variablelist> </refsect1> <refsect1> -<title ->Autores</title> -<para ->O <command ->fixincludes</command -> foi criado por Dirk Mueller <email ->mueller@kde.org</email ->. </para> +<title>Autores</title> +<para>O <command>fixincludes</command> foi criado por Dirk Mueller <email>mueller@kde.org</email>. </para> </refsect1> </refentry> diff --git a/tde-i18n-pt_BR/docs/tdesdk/scripts/man-po2xml.1.docbook b/tde-i18n-pt_BR/docs/tdesdk/scripts/man-po2xml.1.docbook index f8540575eac..acad2001ab4 100644 --- a/tde-i18n-pt_BR/docs/tdesdk/scripts/man-po2xml.1.docbook +++ b/tde-i18n-pt_BR/docs/tdesdk/scripts/man-po2xml.1.docbook @@ -5,95 +5,44 @@ <refentry lang="&language;"> <refentryinfo> -<author -><personname -><firstname ->Ben</firstname -><surname ->Burton</surname -></personname -> <email ->bab@debian.org</email -></author> -<date ->8 de Abril de 2003</date> +<author><personname><firstname>Ben</firstname><surname>Burton</surname></personname> <email>bab@debian.org</email></author> +<date>8 de Abril de 2003</date> </refentryinfo> <refmeta> -<refentrytitle -><command ->po2xml</command -></refentrytitle> -<manvolnum ->1</manvolnum> +<refentrytitle><command>po2xml</command></refentrytitle> +<manvolnum>1</manvolnum> </refmeta> <refnamediv> -<refname -><command ->po2xml</command -></refname> -<refpurpose ->Traduz para um arquivo de DocBook em XML, usando um arquivo PO</refpurpose> +<refname><command>po2xml</command></refname> +<refpurpose>Traduz para um arquivo de DocBook em XML, usando um arquivo PO</refpurpose> </refnamediv> <refsynopsisdiv> -<cmdsynopsis -><command ->po2xml</command -> <group -><option -><replaceable ->XML-original</replaceable -> <replaceable ->PO-traduzido</replaceable -></option -></group -> </cmdsynopsis> +<cmdsynopsis><command>po2xml</command> <group><option><replaceable>XML-original</replaceable> <replaceable>PO-traduzido</replaceable></option></group> </cmdsynopsis> </refsynopsisdiv> <refsect1> -<title ->Descrição</title> +<title>Descrição</title> -<para ->O <command ->po2xml</command -> é uma ferramenta da linha de comando que traduz o arquivo de DocBook em XML <replaceable ->XML-original</replaceable ->, usando o arquivo de mensagens do 'gettext' <replaceable ->PO-traduzido</replaceable ->. O arquivo de XML traduzido daí resultante é enviado para o 'standard output'.</para> +<para>O <command>po2xml</command> é uma ferramenta da linha de comando que traduz o arquivo de DocBook em XML <replaceable>XML-original</replaceable>, usando o arquivo de mensagens do 'gettext' <replaceable>PO-traduzido</replaceable>. O arquivo de XML traduzido daí resultante é enviado para o 'standard output'.</para> -<para ->Este utilitário faz parte do Kit de Desenvolvimento de Software do KDE.</para> +<para>Este utilitário faz parte do Kit de Desenvolvimento de Software do KDE.</para> </refsect1> <refsect1> -<title ->Veja Também</title> +<title>Veja Também</title> -<para ->split2po(1), swappo(1), transxx(1), xml2pot(1)</para> +<para>split2po(1), swappo(1), transxx(1), xml2pot(1)</para> </refsect1> <refsect1> -<title ->Autores</title> -<para ->As ferramentas PO-XML foram escritas por &Stephan.Kulow; &Stephan.Kulow.mail;</para> -<para ->Esta página de manual foi preparada por <personname -><firstname ->Ben</firstname -><surname ->Burton</surname -></personname -><email ->bab@debian.org</email -></para> +<title>Autores</title> +<para>As ferramentas PO-XML foram escritas por &Stephan.Kulow; &Stephan.Kulow.mail;</para> +<para>Esta página de manual foi preparada por <personname><firstname>Ben</firstname><surname>Burton</surname></personname><email>bab@debian.org</email></para> </refsect1> diff --git a/tde-i18n-pt_BR/docs/tdesdk/scripts/man-pruneemptydirs.1.docbook b/tde-i18n-pt_BR/docs/tdesdk/scripts/man-pruneemptydirs.1.docbook index 0e1b6f11c88..1ea500d81a2 100644 --- a/tde-i18n-pt_BR/docs/tdesdk/scripts/man-pruneemptydirs.1.docbook +++ b/tde-i18n-pt_BR/docs/tdesdk/scripts/man-pruneemptydirs.1.docbook @@ -5,106 +5,54 @@ <refentry lang="&language;"> <refentryinfo> -<author -><personname -><firstname ->Ben</firstname -><surname ->Burton</surname -></personname -><email ->bab@debian.org</email -></author> -<date ->8 de Abril de 2003</date> +<author><personname><firstname>Ben</firstname><surname>Burton</surname></personname><email>bab@debian.org</email></author> +<date>8 de Abril de 2003</date> </refentryinfo> <refmeta> -<refentrytitle -><command ->pruneemptydirs</command -></refentrytitle> -<manvolnum ->1</manvolnum> +<refentrytitle><command>pruneemptydirs</command></refentrytitle> +<manvolnum>1</manvolnum> </refmeta> <refnamediv> -<refname -><command ->pruneemptydirs</command -></refname> -<refpurpose ->Detecta pastas inúteis de código numa árvore de CVS</refpurpose> +<refname><command>pruneemptydirs</command></refname> +<refpurpose>Detecta pastas inúteis de código numa árvore de CVS</refpurpose> </refnamediv> <refsynopsisdiv> -<cmdsynopsis -><command ->pruneemptydirs</command -> <group -><option ->-f</option -></group -> </cmdsynopsis> +<cmdsynopsis><command>pruneemptydirs</command> <group><option>-f</option></group> </cmdsynopsis> </refsynopsisdiv> <refsect1> -<title ->Descrição</title> +<title>Descrição</title> -<para ->O <command ->pruneemptydirs</command -> é usado para limpar uma árvore de CVS local. Ele detecta as pastas que contenham restos de coisas antigas que tenham sido removidas do CVS. Essas pastas inúteis normalmente comprometem a compilação. Será examinada a pasta atual, bem como todas as sub-pastas dela.</para> +<para>O <command>pruneemptydirs</command> é usado para limpar uma árvore de CVS local. Ele detecta as pastas que contenham restos de coisas antigas que tenham sido removidas do CVS. Essas pastas inúteis normalmente comprometem a compilação. Será examinada a pasta atual, bem como todas as sub-pastas dela.</para> -<para ->Lembre-se que esta ferramenta não remove nada; simplesmente imprime o que fazer, como uma série de comandos de remoção. Você poderá copiar e colar este comandos ou usá-los com o comando 'eval' num programa.</para> +<para>Lembre-se que esta ferramenta não remove nada; simplesmente imprime o que fazer, como uma série de comandos de remoção. Você poderá copiar e colar este comandos ou usá-los com o comando 'eval' num programa.</para> -<para ->Esta ferramenta funciona melhor se a pasta de código não for a mesma que a pasta de compilação, uma vez que não irá imprimir as pastas que contenham executáveis antigos.</para> +<para>Esta ferramenta funciona melhor se a pasta de código não for a mesma que a pasta de compilação, uma vez que não irá imprimir as pastas que contenham executáveis antigos.</para> -<para ->Este utilitário faz parte do Kit de Desenvolvimento de Software do KDE.</para> +<para>Este utilitário faz parte do Kit de Desenvolvimento de Software do KDE.</para> </refsect1> <refsect1> -<title ->Opções</title> +<title>Opções</title> <variablelist> <varlistentry> -<term -><option ->-f</option -></term> -<listitem -><para ->Efetua de fato as remoções, em vez de as imprimir apenas. Use esta opção com cuidado.</para -></listitem> +<term><option>-f</option></term> +<listitem><para>Efetua de fato as remoções, em vez de as imprimir apenas. Use esta opção com cuidado.</para></listitem> </varlistentry> </variablelist> </refsect1> <refsect1> -<title ->Autores</title> - -<para -><command ->pruneemptydirs</command -> foi escrito por &David.Faure; &David.Faure.mail;</para> -<para ->Esta página de manual foi preparada por <personname -><firstname ->Ben</firstname -><surname ->Burton</surname -></personname -><email ->bab@debian.org</email -></para> +<title>Autores</title> + +<para><command>pruneemptydirs</command> foi escrito por &David.Faure; &David.Faure.mail;</para> +<para>Esta página de manual foi preparada por <personname><firstname>Ben</firstname><surname>Burton</surname></personname><email>bab@debian.org</email></para> </refsect1> </refentry> diff --git a/tde-i18n-pt_BR/docs/tdesdk/scripts/man-qtdoc.1.docbook b/tde-i18n-pt_BR/docs/tdesdk/scripts/man-qtdoc.1.docbook index 36cfc0a8779..17511e86ce8 100644 --- a/tde-i18n-pt_BR/docs/tdesdk/scripts/man-qtdoc.1.docbook +++ b/tde-i18n-pt_BR/docs/tdesdk/scripts/man-qtdoc.1.docbook @@ -5,134 +5,64 @@ <refentry lang="&language;"> <refentryinfo> -<author -><personname -><firstname ->Ben</firstname -><surname ->Burton</surname -></personname -><email ->bab@debian.org</email -></author> -<date ->8 de Abril de 2003</date> +<author><personname><firstname>Ben</firstname><surname>Burton</surname></personname><email>bab@debian.org</email></author> +<date>8 de Abril de 2003</date> </refentryinfo> <refmeta> -<refentrytitle -><command ->qtdoc</command -></refentrytitle> -<manvolnum ->1</manvolnum> +<refentrytitle><command>qtdoc</command></refentrytitle> +<manvolnum>1</manvolnum> </refmeta> <refnamediv> -<refname -><command ->qtdoc</command -></refname> -<refpurpose ->Abre uma página de ajuda do &Qt; no &konqueror;</refpurpose> +<refname><command>qtdoc</command></refname> +<refpurpose>Abre uma página de ajuda do &Qt; no &konqueror;</refpurpose> </refnamediv> <refsynopsisdiv> -<cmdsynopsis -><command ->qtdoc</command -> <group -><option -><replaceable ->nome-classe</replaceable -></option -></group -> </cmdsynopsis> +<cmdsynopsis><command>qtdoc</command> <group><option><replaceable>nome-classe</replaceable></option></group> </cmdsynopsis> </refsynopsisdiv> <refsect1> -<title ->Descrição</title> +<title>Descrição</title> -<para ->O <command ->qtdoc</command -> abre uma página de ajuda &Qt; no &konqueror;. Se o <replaceable ->nome-classe</replaceable -> for indicado, ele abre a página de ajuda para esta classe. Caso contrário, é aberta a página de ajuda principal do &Qt;. O <replaceable ->nome-classe</replaceable -> não faz distinção entre maiúsculas e minúsculas.</para> +<para>O <command>qtdoc</command> abre uma página de ajuda &Qt; no &konqueror;. Se o <replaceable>nome-classe</replaceable> for indicado, ele abre a página de ajuda para esta classe. Caso contrário, é aberta a página de ajuda principal do &Qt;. O <replaceable>nome-classe</replaceable> não faz distinção entre maiúsculas e minúsculas.</para> -<para ->Este utilitário faz parte do Kit de Desenvolvimento de Software (SDK) do &kde;</para> +<para>Este utilitário faz parte do Kit de Desenvolvimento de Software (SDK) do &kde;</para> </refsect1> <refsect1> -<title ->Ambiente</title> +<title>Ambiente</title> <variablelist> <varlistentry> -<term -><envar ->QTDIR</envar -></term> -<listitem -><para ->A pasta sob a qual o &Qt; está instalado. A página principal de ajuda do &Qt; supõe-se existir dentro da <filename class="directory" ->$<envar ->QTDIR</envar ->/doc/html/</filename ->.</para -></listitem> +<term><envar>QTDIR</envar></term> +<listitem><para>A pasta sob a qual o &Qt; está instalado. A página principal de ajuda do &Qt; supõe-se existir dentro da <filename class="directory">$<envar>QTDIR</envar>/doc/html/</filename>.</para></listitem> </varlistentry> </variablelist> </refsect1> <refsect1> -<title ->Exemplos</title> - -<para ->Para mostrar alguma ajuda sobre a classe <classname ->QString</classname ->:</para> -<screen -><userinput -><command ->qtdoc</command -> <option ->QString</option -></userinput -></screen> +<title>Exemplos</title> + +<para>Para mostrar alguma ajuda sobre a classe <classname>QString</classname>:</para> +<screen><userinput><command>qtdoc</command> <option>QString</option></userinput></screen> </refsect1> <refsect1> -<title ->Veja Também</title> +<title>Veja Também</title> -<para ->kdedoc(1), assistant(1)</para> +<para>kdedoc(1), assistant(1)</para> </refsect1> <refsect1> -<title ->Autores</title> - -<para ->Esta página de manual foi preparada por <personname -><firstname ->Ben</firstname -><surname ->Burton</surname -></personname -><email ->bab@debian.org</email -></para> +<title>Autores</title> + +<para>Esta página de manual foi preparada por <personname><firstname>Ben</firstname><surname>Burton</surname></personname><email>bab@debian.org</email></para> </refsect1> </refentry> diff --git a/tde-i18n-pt_BR/docs/tdesdk/scripts/man-reportview.1.docbook b/tde-i18n-pt_BR/docs/tdesdk/scripts/man-reportview.1.docbook index 0a6595ee5d1..b2ebee9209d 100644 --- a/tde-i18n-pt_BR/docs/tdesdk/scripts/man-reportview.1.docbook +++ b/tde-i18n-pt_BR/docs/tdesdk/scripts/man-reportview.1.docbook @@ -1,140 +1,59 @@ <?xml version="1.0" ?> <!DOCTYPE refentry PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [ -<!ENTITY Ian.Reinhart.Geiser "<personname -><firstname ->Ian</firstname -><othername ->Reinhart</othername -><surname ->Geiser</surname -></personname ->"> -<!ENTITY Ian.Reinhart.Geiser.mail "<email ->geiseri@kde.org</email ->"> -<!ENTITY kweather "<application ->kweather</application ->"> -<!ENTITY Nadeem.Hasan "<personname -><firstname ->Nadeem</firstname -><surname ->Hasan</surname -></personname ->"> -<!ENTITY Nadeem.Hasan.mail "<email ->nhasan@kde.org</email ->"> +<!ENTITY Ian.Reinhart.Geiser "<personname><firstname>Ian</firstname><othername>Reinhart</othername><surname>Geiser</surname></personname>"> +<!ENTITY Ian.Reinhart.Geiser.mail "<email>geiseri@kde.org</email>"> +<!ENTITY kweather "<application>kweather</application>"> +<!ENTITY Nadeem.Hasan "<personname><firstname>Nadeem</firstname><surname>Hasan</surname></personname>"> +<!ENTITY Nadeem.Hasan.mail "<email>nhasan@kde.org</email>"> <!ENTITY % Brazilian-Portuguese "INCLUDE"> ]> <refentry lang="&language;"> <refentryinfo> -<author -><personname -><firstname ->Ben</firstname -><surname ->Burton</surname -></personname -><email ->bab@debian.org</email -></author> -<date ->7 de Abril de 2003</date> +<author><personname><firstname>Ben</firstname><surname>Burton</surname></personname><email>bab@debian.org</email></author> +<date>7 de Abril de 2003</date> </refentryinfo> <refmeta> -<refentrytitle -><command ->reportview</command -></refentrytitle> -<manvolnum ->1</manvolnum> +<refentrytitle><command>reportview</command></refentrytitle> +<manvolnum>1</manvolnum> </refmeta> <refnamediv> -<refname -><command ->reportview</command -></refname> -<refpurpose ->pede ao KWeatherService que mostre um boletim metereológico </refpurpose> +<refname><command>reportview</command></refname> +<refpurpose>pede ao KWeatherService que mostre um boletim metereológico </refpurpose> </refnamediv> <refsynopsisdiv> -<cmdsynopsis -><command ->reportview;</command -> <group -><option ->Opções Genéricas do KDE</option -></group -> <group -><option ->Opções Genéricas do Qt</option -></group -> </cmdsynopsis> +<cmdsynopsis><command>reportview;</command> <group><option>Opções Genéricas do KDE</option></group> <group><option>Opções Genéricas do Qt</option></group> </cmdsynopsis> </refsynopsisdiv> <refsect1> -<title ->Descrição</title> +<title>Descrição</title> -<para -><command ->reportview</command -> não deve ser utilizado diretamente.</para> +<para><command>reportview</command> não deve ser utilizado diretamente.</para> -<para ->O <command ->reportview</command -> é um pequeno programa que pede ao KWeatherService um relatório meteorológico. As informações incluem a temperatura, a velocidade do evento e a pressão do ar.</para> +<para>O <command>reportview</command> é um pequeno programa que pede ao KWeatherService um relatório meteorológico. As informações incluem a temperatura, a velocidade do evento e a pressão do ar.</para> -<para ->O KWeatherService é um serviço de DCOP que é usado tanto pelo 'reportview' como pelo mini-aplicativo do painel do &kweather; para oferecer dados meteorológicos. Não existe a necessidade de iniciar o KWeatherService em separado; o 'reportview' irá iniciar o próprio serviço, se necessário.</para> +<para>O KWeatherService é um serviço de DCOP que é usado tanto pelo 'reportview' como pelo mini-aplicativo do painel do &kweather; para oferecer dados meteorológicos. Não existe a necessidade de iniciar o KWeatherService em separado; o 'reportview' irá iniciar o próprio serviço, se necessário.</para> </refsect1> <refsect1> -<title ->Veja Também</title> - -<para ->kweather(1)</para> - -<para ->Uma documentação do usuário mais detalhada está disponível em <ulink url="help:/kweather" ->help:/kweather</ulink -> (tanto poderá inserir este <acronym ->URL</acronym -> no &konqueror;, como executar o <userinput -><command ->khelpcenter</command -> <parameter ->help:/kweather</parameter -></userinput ->).</para> +<title>Veja Também</title> + +<para>kweather(1)</para> + +<para>Uma documentação do usuário mais detalhada está disponível em <ulink url="help:/kweather">help:/kweather</ulink> (tanto poderá inserir este <acronym>URL</acronym> no &konqueror;, como executar o <userinput><command>khelpcenter</command> <parameter>help:/kweather</parameter></userinput>).</para> </refsect1> <refsect1> -<title ->Autores</title> - -<para ->&kweather; foi escrito por &Ian.Reinhart.Geiser; &Ian.Reinhart.Geiser.mail; e &Nadeem.Hasan; &Nadeem.Hasan.mail;</para> -<para ->Esta página de manual foi preparada por <personname -><firstname ->Ben</firstname -><surname ->Burton</surname -></personname -><email ->bab@debian.org</email -></para> +<title>Autores</title> + +<para>&kweather; foi escrito por &Ian.Reinhart.Geiser; &Ian.Reinhart.Geiser.mail; e &Nadeem.Hasan; &Nadeem.Hasan.mail;</para> +<para>Esta página de manual foi preparada por <personname><firstname>Ben</firstname><surname>Burton</surname></personname><email>bab@debian.org</email></para> </refsect1> </refentry> diff --git a/tde-i18n-pt_BR/docs/tdesdk/scripts/man-split2po.1.docbook b/tde-i18n-pt_BR/docs/tdesdk/scripts/man-split2po.1.docbook index 781b9528d85..d2597d1a323 100644 --- a/tde-i18n-pt_BR/docs/tdesdk/scripts/man-split2po.1.docbook +++ b/tde-i18n-pt_BR/docs/tdesdk/scripts/man-split2po.1.docbook @@ -5,103 +5,47 @@ <refentry lang="&language;"> <refentryinfo> -<author -><personname -><firstname ->Ben</firstname -><surname ->Burton</surname -></personname -><email ->bab@debian.org</email -></author> -<date ->7 de Abril de 2003</date> +<author><personname><firstname>Ben</firstname><surname>Burton</surname></personname><email>bab@debian.org</email></author> +<date>7 de Abril de 2003</date> </refentryinfo> <refmeta> -<refentrytitle -><command ->split2po</command -></refentrytitle> -<manvolnum ->1</manvolnum> +<refentrytitle><command>split2po</command></refentrytitle> +<manvolnum>1</manvolnum> </refmeta> <refnamediv> -<refname -><command ->split2po</command -></refname> -<refpurpose ->Cria um arquivo po a partir de dois arquivos DocBook XML</refpurpose> +<refname><command>split2po</command></refname> +<refpurpose>Cria um arquivo po a partir de dois arquivos DocBook XML</refpurpose> </refnamediv> <refsynopsisdiv> -<cmdsynopsis -><command ->split2po</command -> <group choice="req" -><option -><replaceable ->XML-original</replaceable -></option -> <option -><replaceable ->XML-traduzido</replaceable -></option -></group -> </cmdsynopsis> +<cmdsynopsis><command>split2po</command> <group choice="req"><option><replaceable>XML-original</replaceable></option> <option><replaceable>XML-traduzido</replaceable></option></group> </cmdsynopsis> </refsynopsisdiv> <refsect1> -<title ->Descrição</title> - -<para ->O <command ->split2po</command -> é uma ferramenta da linha de comando que recebe os dois arquivos DocBook em XML e produz um arquivo de mensagens do <command ->gettext</command -> (arquivo PO), que representa as alterações entre estes. O arquivo PO resultante é enviado para o 'standard output'.</para> - -<para ->O <filename ->XML-traduzido</filename -> deverá ser o resultado da tradução do <filename ->XML-original</filename -> para outro idioma. Esta é a tradução que o arquivo PO resultante irá representar.</para> - -<para ->Este utilitário faz parte do Kit de Desenvolvimento de Software do KDE. </para> +<title>Descrição</title> + +<para>O <command>split2po</command> é uma ferramenta da linha de comando que recebe os dois arquivos DocBook em XML e produz um arquivo de mensagens do <command>gettext</command> (arquivo PO), que representa as alterações entre estes. O arquivo PO resultante é enviado para o 'standard output'.</para> + +<para>O <filename>XML-traduzido</filename> deverá ser o resultado da tradução do <filename>XML-original</filename> para outro idioma. Esta é a tradução que o arquivo PO resultante irá representar.</para> + +<para>Este utilitário faz parte do Kit de Desenvolvimento de Software do KDE. </para> </refsect1> <refsect1> -<title ->Veja Também</title> +<title>Veja Também</title> -<para ->po2xml(1), swappo(1), transxx(1), xml2pot(1)</para> +<para>po2xml(1), swappo(1), transxx(1), xml2pot(1)</para> </refsect1> <refsect1> -<title ->Autores</title> - -<para ->As ferramentas de PO para XML foram criadas por &Stephan.Kulow; &Stephan.Kulow.mail;</para> -<para ->Esta página de manual foi preparada por <personname -><firstname ->Ben</firstname -><surname ->Burton</surname -></personname -><email ->bab@debian.org</email -></para> +<title>Autores</title> + +<para>As ferramentas de PO para XML foram criadas por &Stephan.Kulow; &Stephan.Kulow.mail;</para> +<para>Esta página de manual foi preparada por <personname><firstname>Ben</firstname><surname>Burton</surname></personname><email>bab@debian.org</email></para> </refsect1> diff --git a/tde-i18n-pt_BR/docs/tdesdk/scripts/man-swappo.1.docbook b/tde-i18n-pt_BR/docs/tdesdk/scripts/man-swappo.1.docbook index 2ec41401cf4..b73d5c17e28 100644 --- a/tde-i18n-pt_BR/docs/tdesdk/scripts/man-swappo.1.docbook +++ b/tde-i18n-pt_BR/docs/tdesdk/scripts/man-swappo.1.docbook @@ -5,93 +5,46 @@ <refentry lang="&language;"> <refentryinfo> -<author -><personname -><firstname ->Ben</firstname -><surname ->Burton</surname -></personname -><email ->bab@debian.org</email -></author> -<date ->7 de Abril de 2003</date> +<author><personname><firstname>Ben</firstname><surname>Burton</surname></personname><email>bab@debian.org</email></author> +<date>7 de Abril de 2003</date> </refentryinfo> <refmeta> -<refentrytitle -><command ->swappo</command -></refentrytitle> -<manvolnum ->1</manvolnum> +<refentrytitle><command>swappo</command></refentrytitle> +<manvolnum>1</manvolnum> </refmeta> <refnamediv> -<refname -><command ->swappo</command -></refname> -<refpurpose ->troca os campos msgid e msgstr num arquivo PO</refpurpose> +<refname><command>swappo</command></refname> +<refpurpose>troca os campos msgid e msgstr num arquivo PO</refpurpose> </refnamediv> <refsynopsisdiv> -<cmdsynopsis -><command ->swappo</command -> <group -><option -><replaceable ->arquivo.po</replaceable -></option -></group -> </cmdsynopsis> +<cmdsynopsis><command>swappo</command> <group><option><replaceable>arquivo.po</replaceable></option></group> </cmdsynopsis> </refsynopsisdiv> <refsect1> -<title ->Descrição</title> +<title>Descrição</title> -<para ->O <command ->swappo</command -> lê o arquivo PO indicado e troca os campos 'msgid' e 'msgstr' para todas as mensagens. O resultado é um novo arquivo PO que é traduzido na direção inversa. Por exemplo, se o arquivo PO traduz de Inglês para Francês, o novo arquivo PO irá traduzir de Francês para Inglês.</para> +<para>O <command>swappo</command> lê o arquivo PO indicado e troca os campos 'msgid' e 'msgstr' para todas as mensagens. O resultado é um novo arquivo PO que é traduzido na direção inversa. Por exemplo, se o arquivo PO traduz de Inglês para Francês, o novo arquivo PO irá traduzir de Francês para Inglês.</para> -<para ->O novo arquivo PO será escrito no 'standard output'. O arquivo PO antigo será deixado tal como está.</para> +<para>O novo arquivo PO será escrito no 'standard output'. O arquivo PO antigo será deixado tal como está.</para> -<para ->Este utilitário faz parte do Kit de Desenvolvimento de Software (SDK) do &kde;</para -> +<para>Este utilitário faz parte do Kit de Desenvolvimento de Software (SDK) do &kde;</para> </refsect1> <refsect1> -<title ->Veja Também</title> +<title>Veja Também</title> -<para ->po2xml(1), split2po(1), transxx(1), xml2pot(1)</para> +<para>po2xml(1), split2po(1), transxx(1), xml2pot(1)</para> </refsect1> <refsect1> -<title ->Autores</title> -<para ->As ferramentas PO-XML foram escritas por &Stephan.Kulow; &Stephan.Kulow.mail;</para> -<para ->Esta página de manual foi preparada por <personname -><firstname ->Ben</firstname -><surname ->Burton</surname -></personname -><email ->bab@debian.org</email -></para> +<title>Autores</title> +<para>As ferramentas PO-XML foram escritas por &Stephan.Kulow; &Stephan.Kulow.mail;</para> +<para>Esta página de manual foi preparada por <personname><firstname>Ben</firstname><surname>Burton</surname></personname><email>bab@debian.org</email></para> </refsect1> diff --git a/tde-i18n-pt_BR/docs/tdesdk/scripts/man-transxx.1.docbook b/tde-i18n-pt_BR/docs/tdesdk/scripts/man-transxx.1.docbook index 7a12792e684..5b93d3ccd15 100644 --- a/tde-i18n-pt_BR/docs/tdesdk/scripts/man-transxx.1.docbook +++ b/tde-i18n-pt_BR/docs/tdesdk/scripts/man-transxx.1.docbook @@ -5,92 +5,42 @@ <refentry lang="&language;"> <refentryinfo> -<author -><personname -><firstname ->Ben</firstname -><surname ->Burton</surname -></personname -><email ->bab@debian.org</email -></author> -<date ->7 de Abril de 2003</date> +<author><personname><firstname>Ben</firstname><surname>Burton</surname></personname><email>bab@debian.org</email></author> +<date>7 de Abril de 2003</date> </refentryinfo> <refmeta> -<refentrytitle -><command ->transxx</command -></refentrytitle> -<manvolnum ->1</manvolnum> +<refentrytitle><command>transxx</command></refentrytitle> +<manvolnum>1</manvolnum> </refmeta> <refnamediv> -<refname -><command ->transxx</command -></refname> -<refpurpose ->Cria um pseudo arquivo PO traduzido de um arquivo de modelo PO</refpurpose> +<refname><command>transxx</command></refname> +<refpurpose>Cria um pseudo arquivo PO traduzido de um arquivo de modelo PO</refpurpose> </refnamediv> <refsynopsisdiv> -<cmdsynopsis -><command ->transxx</command -> <group -><option -><replaceable ->modelo.pot</replaceable -></option -></group -> </cmdsynopsis> +<cmdsynopsis><command>transxx</command> <group><option><replaceable>modelo.pot</replaceable></option></group> </cmdsynopsis> </refsynopsisdiv> <refsect1> -<title ->Descrição</title> +<title>Descrição</title> -<para ->O <command ->transxx</command -> é uma ferramenta da linha de comando que produz um arquivo PO básico a partir de um arquivo-modelo PO. Alguma da formatação e estrutura dos textos do 'msgid' será copiada para o texto do 'msgstr', só que o texto será traduzido como <quote ->xx</quote ->.</para> +<para>O <command>transxx</command> é uma ferramenta da linha de comando que produz um arquivo PO básico a partir de um arquivo-modelo PO. Alguma da formatação e estrutura dos textos do 'msgid' será copiada para o texto do 'msgstr', só que o texto será traduzido como <quote>xx</quote>.</para> -<para ->O arquivo PO pseudo traduzido é enviado para o 'standard output'.</para> +<para>O arquivo PO pseudo traduzido é enviado para o 'standard output'.</para> -<para ->A execução do seu programa com o idioma <quote ->xx</quote -> lhe mostrará rapidamente todos os textos visíveis para o usuário que não estejam sendo traduzidos atualmente.</para> +<para>A execução do seu programa com o idioma <quote>xx</quote> lhe mostrará rapidamente todos os textos visíveis para o usuário que não estejam sendo traduzidos atualmente.</para> -<para ->Este utilitário faz parte do Kit de Desenvolvimento de Software do KDE.</para -> +<para>Este utilitário faz parte do Kit de Desenvolvimento de Software do KDE.</para> </refsect1> <refsect1> -<title ->Autores</title> +<title>Autores</title> -<para ->As ferramentas PO-XML foram escritas por &Stephan.Kulow; &Stephan.Kulow.mail;</para> -<para ->Esta página de manual foi preparada por <personname -><firstname ->Ben</firstname -><surname ->Burton</surname -></personname -><email ->bab@debian.org</email -></para> +<para>As ferramentas PO-XML foram escritas por &Stephan.Kulow; &Stephan.Kulow.mail;</para> +<para>Esta página de manual foi preparada por <personname><firstname>Ben</firstname><surname>Burton</surname></personname><email>bab@debian.org</email></para> </refsect1> </refentry> diff --git a/tde-i18n-pt_BR/docs/tdesdk/scripts/man-xml2pot.1.docbook b/tde-i18n-pt_BR/docs/tdesdk/scripts/man-xml2pot.1.docbook index f29bdebdadb..e56fc5f8e48 100644 --- a/tde-i18n-pt_BR/docs/tdesdk/scripts/man-xml2pot.1.docbook +++ b/tde-i18n-pt_BR/docs/tdesdk/scripts/man-xml2pot.1.docbook @@ -5,99 +5,48 @@ <refentry lang="&language;"> <refentryinfo> -<author -><personname -><firstname ->Ben</firstname -><surname ->Burton</surname -></personname -><email ->bab@debian.org</email -></author> -<date ->7 de Abril de 2003</date> +<author><personname><firstname>Ben</firstname><surname>Burton</surname></personname><email>bab@debian.org</email></author> +<date>7 de Abril de 2003</date> </refentryinfo> <refmeta> -<refentrytitle -><command ->xml2pot</command -></refentrytitle> -<manvolnum ->1</manvolnum> +<refentrytitle><command>xml2pot</command></refentrytitle> +<manvolnum>1</manvolnum> </refmeta> <refnamediv> -<refname -><command ->xml2pot</command -></refname> -<refpurpose ->Cria um arquivo de modelo PO a partir de um arquivo XML do DocBook.</refpurpose> +<refname><command>xml2pot</command></refname> +<refpurpose>Cria um arquivo de modelo PO a partir de um arquivo XML do DocBook.</refpurpose> </refnamediv> <refsynopsisdiv> -<cmdsynopsis -><command ->xml2pot</command -> <group -><option -><replaceable ->XML-original</replaceable -></option -></group -> </cmdsynopsis> +<cmdsynopsis><command>xml2pot</command> <group><option><replaceable>XML-original</replaceable></option></group> </cmdsynopsis> </refsynopsisdiv> <refsect1> -<title ->Descrição</title> +<title>Descrição</title> -<para ->O <command ->xml2pot</command -> é uma ferramenta da linha de comando que produz um arquivo de modelo de mensagens do 'gettext' a partir do arquivo XML de DocBook original <filename ->XML-original</filename ->. O arquivo de modelo é enviado para o 'standard output'.</para> +<para>O <command>xml2pot</command> é uma ferramenta da linha de comando que produz um arquivo de modelo de mensagens do 'gettext' a partir do arquivo XML de DocBook original <filename>XML-original</filename>. O arquivo de modelo é enviado para o 'standard output'.</para> -<para ->O arquivo de modelo resultante poderá ser usado para criar arquivos de mensagens do 'gettext' (arquivos PO) para uma variedade de idiomas. Estes poderão então ser usados com o <command ->po2xml</command ->(1) para traduzir o arquivo XML original para estas outros idiomas.</para> +<para>O arquivo de modelo resultante poderá ser usado para criar arquivos de mensagens do 'gettext' (arquivos PO) para uma variedade de idiomas. Estes poderão então ser usados com o <command>po2xml</command>(1) para traduzir o arquivo XML original para estas outros idiomas.</para> -<para ->Este utilitário faz parte do Kit de Desenvolvimento de Software do KDE.</para -> +<para>Este utilitário faz parte do Kit de Desenvolvimento de Software do KDE.</para> </refsect1> <refsect1> -<title ->Veja Também</title> +<title>Veja Também</title> -<para ->po2xml(1), split2po(1), swappo(1), transxx(1)</para> +<para>po2xml(1), split2po(1), swappo(1), transxx(1)</para> </refsect1> <refsect1> -<title ->Autores</title> - -<para ->As ferramentas de PO para XML foram criadas por &Stephan.Kulow; &Stephan.Kulow.mail;</para> -<para ->Esta página de manual foi preparada por <personname -><firstname ->Ben</firstname -><surname ->Burton</surname -></personname -><email ->bab@debian.org</email -></para> +<title>Autores</title> + +<para>As ferramentas de PO para XML foram criadas por &Stephan.Kulow; &Stephan.Kulow.mail;</para> +<para>Esta página de manual foi preparada por <personname><firstname>Ben</firstname><surname>Burton</surname></personname><email>bab@debian.org</email></para> </refsect1> </refentry> diff --git a/tde-i18n-pt_BR/docs/tdesdk/scripts/man-zonetab2pot.1.docbook b/tde-i18n-pt_BR/docs/tdesdk/scripts/man-zonetab2pot.1.docbook index 85eb702ead6..f4de24fdb96 100644 --- a/tde-i18n-pt_BR/docs/tdesdk/scripts/man-zonetab2pot.1.docbook +++ b/tde-i18n-pt_BR/docs/tdesdk/scripts/man-zonetab2pot.1.docbook @@ -5,98 +5,42 @@ <refentry lang="&language;"> <refentryinfo> -<author -><personname -><firstname ->Ben</firstname -><surname ->Burton</surname -></personname -> <email -></email -></author> -<date ->7 de Abril de 2003</date> +<author><personname><firstname>Ben</firstname><surname>Burton</surname></personname> <email></email></author> +<date>7 de Abril de 2003</date> </refentryinfo> <refmeta> -<refentrytitle -><command ->zonetab2pot.py</command -></refentrytitle> -<manvolnum ->1</manvolnum> +<refentrytitle><command>zonetab2pot.py</command></refentrytitle> +<manvolnum>1</manvolnum> </refmeta> <refnamediv> -<refname -><command ->zonetab2pot.py</command -></refname> -<refpurpose ->Converte uma lista de fusos-horários para um modelo de um arquivo PO.</refpurpose> +<refname><command>zonetab2pot.py</command></refname> +<refpurpose>Converte uma lista de fusos-horários para um modelo de um arquivo PO.</refpurpose> </refnamediv> <refsynopsisdiv> -<cmdsynopsis -><command ->zonetab2pot.py</command -> <group -><option -><replaceable ->lista-fusos-horários</replaceable -></option -></group -> </cmdsynopsis> +<cmdsynopsis><command>zonetab2pot.py</command> <group><option><replaceable>lista-fusos-horários</replaceable></option></group> </cmdsynopsis> </refsynopsisdiv> <refsect1> -<title ->Descrição</title> +<title>Descrição</title> -<para ->O <command ->zonetab2pot.py</command -> lê a lista de fusos-horários na linha de comando e converte-a para um arquivo de mensagens do 'gettext' (arquivo PO), contendo os nomes dos fusos-horários individualmente. </para> +<para>O <command>zonetab2pot.py</command> lê a lista de fusos-horários na linha de comando e converte-a para um arquivo de mensagens do 'gettext' (arquivo PO), contendo os nomes dos fusos-horários individualmente. </para> -<para ->A lista de fusos-horários indicada deverá estar no mesmo formato que a tabela de zonas do sistema. Se não for indicada qualquer lista na linha de comando, é usado o arquivo <filename ->/usr/share/zoneinfo/zone.tab</filename ->.</para> +<para>A lista de fusos-horários indicada deverá estar no mesmo formato que a tabela de zonas do sistema. Se não for indicada qualquer lista na linha de comando, é usado o arquivo <filename>/usr/share/zoneinfo/zone.tab</filename>.</para> -<para ->O novo modelo de arquivo PO será gravado no 'standard output'.</para> +<para>O novo modelo de arquivo PO será gravado no 'standard output'.</para> -<para ->Este utilitário faz parte do Kit de Desenvolvimento de Software do KDE. </para -> +<para>Este utilitário faz parte do Kit de Desenvolvimento de Software do KDE. </para> </refsect1> <refsect1> -<title ->Autores</title> +<title>Autores</title> -<para ->O zonetab2pot.py foi criado por <personname -><firstname ->Lukas</firstname -><surname ->Tinkl</surname -></personname -><email ->lukas@kde.org</email -></para> -<para ->Esta página de manual foi preparada por <personname -><firstname ->Ben</firstname -><surname ->Burton</surname -></personname -><email ->bab@debian.org</email -></para> +<para>O zonetab2pot.py foi criado por <personname><firstname>Lukas</firstname><surname>Tinkl</surname></personname><email>lukas@kde.org</email></para> +<para>Esta página de manual foi preparada por <personname><firstname>Ben</firstname><surname>Burton</surname></personname><email>bab@debian.org</email></para> </refsect1> </refentry> diff --git a/tde-i18n-pt_BR/docs/tdesdk/scripts/tdesvn-build/index.docbook b/tde-i18n-pt_BR/docs/tdesdk/scripts/tdesvn-build/index.docbook index 13c34f2e33f..6b9244a2d3a 100644 --- a/tde-i18n-pt_BR/docs/tdesdk/scripts/tdesvn-build/index.docbook +++ b/tde-i18n-pt_BR/docs/tdesdk/scripts/tdesvn-build/index.docbook @@ -3,269 +3,130 @@ <!ENTITY kappname "tdesvn-build"> <!ENTITY package "tdesdk"> <!ENTITY % addindex "IGNORE"> - <!ENTITY % Brazilian-Portuguese "INCLUDE" -> <!-- Change language only here --> - <!ENTITY svn "<application ->Subversion</application ->"> - <!ENTITY tdesvn-build "<application ->tdesvn-build</application ->"> + <!ENTITY % Brazilian-Portuguese "INCLUDE"> <!-- Change language only here --> + <!ENTITY svn "<application>Subversion</application>"> + <!ENTITY tdesvn-build "<application>tdesvn-build</application>"> ]> <book lang="&language;"> <bookinfo> -<title ->Manual do 'Script' &tdesvn-build;</title> +<title>Manual do 'Script' &tdesvn-build;</title> <authorgroup id="authors"> -<author -><firstname ->Michael</firstname -><surname ->Pyne</surname -> <affiliation -><address -><email ->michael.pyne@kdemail.net</email -></address -></affiliation> -</author -> -<author -><firstname ->Carlos</firstname -><surname ->Woelz</surname -> <affiliation -><address -><email ->carloswoelz@imap-mail.com</email -></address -></affiliation> -</author -> - - -<othercredit role="translator" -><firstname ->Marcus</firstname -><surname ->Gama</surname -><affiliation -><address -><email ->marcus.gama@gmail.com</email -></address -></affiliation -><contrib ->Tradução</contrib -></othercredit -> +<author><firstname>Michael</firstname><surname>Pyne</surname> <affiliation><address><email>michael.pyne@kdemail.net</email></address></affiliation> +</author> +<author><firstname>Carlos</firstname><surname>Woelz</surname> <affiliation><address><email>carloswoelz@imap-mail.com</email></address></affiliation> +</author> + + +<othercredit role="translator"><firstname>Marcus</firstname><surname>Gama</surname><affiliation><address><email>marcus.gama@gmail.com</email></address></affiliation><contrib>Tradução</contrib></othercredit> </authorgroup> <copyright> -<year ->2005</year> -<holder ->Michael Pyne</holder> +<year>2005</year> +<holder>Michael Pyne</holder> </copyright> <copyright> -<year ->2005</year> -<holder ->Carlos Woelz</holder> +<year>2005</year> +<holder>Carlos Woelz</holder> </copyright> -<legalnotice ->&FDLNotice;</legalnotice> +<legalnotice>&FDLNotice;</legalnotice> -<date ->2005-06-18</date> -<releaseinfo ->0.98</releaseinfo> +<date>2005-06-18</date> +<releaseinfo>0.98</releaseinfo> <abstract> -<para ->O &tdesvn-build; é um programa em Perl que compila e instala o &kde; diretamente a partir do código existente no repositório de &svn; do &kde;.</para> +<para>O &tdesvn-build; é um programa em Perl que compila e instala o &kde; diretamente a partir do código existente no repositório de &svn; do &kde;.</para> </abstract> <keywordset> -<keyword ->KDE</keyword> -<keyword ->tdesdk</keyword> -<keyword ->SVN</keyword> -<keyword ->Subversion</keyword> -<keyword ->Desenvolvimento KDE</keyword> +<keyword>KDE</keyword> +<keyword>tdesdk</keyword> +<keyword>SVN</keyword> +<keyword>Subversion</keyword> +<keyword>Desenvolvimento KDE</keyword> </keywordset> </bookinfo> <chapter id="introduction"> -<title ->Introdução</title> +<title>Introdução</title> -<para ->O &tdesvn-build; é um programa em Perl que ajuda os usuários a instalar o <ulink url="http://www.kde.org/" ->&kde;</ulink -> a partir do <ulink url="http://subversion.tigris.org/" ->&svn;</ulink ->. Você pode também querer considerar o programa 'kde-build' que vem incluído no módulo 'tdesdk' do &kde;. </para> +<para>O &tdesvn-build; é um programa em Perl que ajuda os usuários a instalar o <ulink url="http://www.kde.org/">&kde;</ulink> a partir do <ulink url="http://subversion.tigris.org/">&svn;</ulink>. Você pode também querer considerar o programa 'kde-build' que vem incluído no módulo 'tdesdk' do &kde;. </para> -<para ->Aqui será documentado a sintaxe opções do arquivo de configuração do &tdesvn-build;, as suas opções da linha de comando, as funcionalidades e uma introdução a todos os passos necessários para compilar o &kde; a partir do código fonte, incluindo os passos que você deverá efetuar ao usar as outras ferramentas ou, em outras palavras, os passos que não são efetuados automaticamente pelo programa &tdesvn-build;. </para> +<para>Aqui será documentado a sintaxe opções do arquivo de configuração do &tdesvn-build;, as suas opções da linha de comando, as funcionalidades e uma introdução a todos os passos necessários para compilar o &kde; a partir do código fonte, incluindo os passos que você deverá efetuar ao usar as outras ferramentas ou, em outras palavras, os passos que não são efetuados automaticamente pelo programa &tdesvn-build;. </para> </chapter> <chapter id="getting-started"> -<title ->Começando</title> +<title>Começando</title> -<para ->Neste capítulo, será apresentada a forma de utilização do &tdesvn-build; para obter os módulos do repositório do &kde; e compilá-los. Nós daremos também uma explicação básica da estrutura de &svn; do &kde; e os passos que você terá que efetuar antes de executar o programa. </para> +<para>Neste capítulo, será apresentada a forma de utilização do &tdesvn-build; para obter os módulos do repositório do &kde; e compilá-los. Nós daremos também uma explicação básica da estrutura de &svn; do &kde; e os passos que você terá que efetuar antes de executar o programa. </para> -<para ->Todos os tópicos presentes neste capítulo são cobertos com ainda mais detalhe na seção <ulink url="http://quality.kde.org/develop/cvsguide/buildstep.php" -> Guia de Compilação do Código do &kde; Passo-a-Passo</ulink ->, na <ulink url="http://quality.kde.org" ->Página Web da Equipe de Qualidade do &kde;</ulink ->. Se você estiver compilando o KDE pela primeira vez, é uma boa idéia lê-lo ou consultá-lo como fonte de referência. Você irá encontrar informações detalhadas sobre as ferramentas de empacotamento e os requisitos, os problemas de compilação comuns e as estratégias e informações sobre a execução da instalação do seu novo &kde;. </para> +<para>Todos os tópicos presentes neste capítulo são cobertos com ainda mais detalhe na seção <ulink url="http://quality.kde.org/develop/cvsguide/buildstep.php"> Guia de Compilação do Código do &kde; Passo-a-Passo</ulink>, na <ulink url="http://quality.kde.org">Página Web da Equipe de Qualidade do &kde;</ulink>. Se você estiver compilando o KDE pela primeira vez, é uma boa idéia lê-lo ou consultá-lo como fonte de referência. Você irá encontrar informações detalhadas sobre as ferramentas de empacotamento e os requisitos, os problemas de compilação comuns e as estratégias e informações sobre a execução da instalação do seu novo &kde;. </para> <sect1 id="before-building"> -<title ->Preparando o Sistema para Compilar o &kde;</title> - -<para ->É recomendável que você transfira e compile o &kde; com uma conta de usuário. Se você já tiver os pacotes do &kde; instalados, a melhor opção será criar um usuário diferente (dedicado) para compilar e executar o novo &kde;. A vantagem de compilar o &kde; com um usuário dedicado é que você não poderá corromper o sistema base e terá sempre uma forma de trabalhar confortavelmente quando as coisas correrem mal. </para> - -<para ->Mais tarde, você poderá fazer uma instalação como 'root' se desejar. Este documento não cobre uma instalação como 'root'. Se você estiver executando uma instalação a nível do sistema, provavelmente já deverá saber o que está fazendo. </para> - -<para ->Antes de usar o programa &tdesvn-build; (ou qualquer outra estratégia de compilação), você deverá instalar as ferramentas de desenvolvimento e bibliotecas necessárias para o &kde;. Você precisará da biblioteca Qt, versão 3.3.0 ou posterior, do Automake 1.8, Autoconf 2.5X (melhor se ->=2.57, uma vez que foi detectado um erro com as versões anteriores), o cliente do 'subversion' (svn), o compilador 'gcc' com o suporte de C++, a libxml2, o openssl, a libbz2 entre outras coisas (para uma lista completa, visite os <ulink url="http://www.kde.org/info/requirements/3.4.php" ->Requisitos de Compilação do KDE</ulink ->). Você poderá obter normalmente estas ferramentas para o seu sistema, a partir da sua distribuição ou fornecedor. </para> - -<para ->Alguns destes pacotes estão divididos em bibliotecas, programas ou utilitários e pacotes de desenvolvimento. Você irá precisar pelo menos do programa ou biblioteca e do seu pacote de desenvolvimento. Se você tiver dúvidas, instale tudo. As bibliotecas que necessita irão variar de acordo com os módulos que pretende compilar, uma vez que cada módulo tem os seus próprio requisitos. O <ulink url="http://quality.kde.org/develop/cvsguide/buildstep.php#step1" -> Guia de Compilação do Código do &kde; Passo-a-Passo</ulink -> possui mais detalhes sobre as ferramentas e técnicas específicas usadas para instalar e encontrar o 'software' necessário. </para> - -<para ->Você poderá já ter uma versão do programa &tdesvn-build; instalada no seu sistema. O &tdesvn-build; exije que você crie um arquivo de configuração chamado <filename ->.tdesvn-buildrc</filename ->. Este arquivo deverá ser instalado na pasta pessoal (~/), e contém todos os dados de configuração necessários para o programa rodar, como as opções de configuração, compilação, a localização do código, o destino da instalação (prefixo), os módulos que serão compilados, &etc;. Os dados de configuração por padrão são oferecidos pelo arquivo <filename ->tdesvn-buildrc-sample</filename ->. Você poderá encontrar mais informações sobre a sintaxe do arquivo de configuração em <xref linkend="configure-data"/> e <xref linkend="tdesvn-buildrc"/>. </para> - -<para ->Uma boa forma de obter a última versão é escolher a página 'tdesdk/scripts' da página Web do <ulink url="http://websvn.kde.org/trunk/KDE" ->websvn.kde.org</ulink ->. Você verá uma lista dos arquivos disponíveis na pasta 'tdesdk/scripts' do repositório de &svn; do &kde;. Clique na ligação do &tdesvn-build; e transfira a última versão do programa. Faça o mesmo para o arquivo <filename ->tdesvn-buildrc-sample</filename ->. Torne o programa executável e verifique se está na sua PATH. </para> +<title>Preparando o Sistema para Compilar o &kde;</title> + +<para>É recomendável que você transfira e compile o &kde; com uma conta de usuário. Se você já tiver os pacotes do &kde; instalados, a melhor opção será criar um usuário diferente (dedicado) para compilar e executar o novo &kde;. A vantagem de compilar o &kde; com um usuário dedicado é que você não poderá corromper o sistema base e terá sempre uma forma de trabalhar confortavelmente quando as coisas correrem mal. </para> + +<para>Mais tarde, você poderá fazer uma instalação como 'root' se desejar. Este documento não cobre uma instalação como 'root'. Se você estiver executando uma instalação a nível do sistema, provavelmente já deverá saber o que está fazendo. </para> + +<para>Antes de usar o programa &tdesvn-build; (ou qualquer outra estratégia de compilação), você deverá instalar as ferramentas de desenvolvimento e bibliotecas necessárias para o &kde;. Você precisará da biblioteca Qt, versão 3.3.0 ou posterior, do Automake 1.8, Autoconf 2.5X (melhor se >=2.57, uma vez que foi detectado um erro com as versões anteriores), o cliente do 'subversion' (svn), o compilador 'gcc' com o suporte de C++, a libxml2, o openssl, a libbz2 entre outras coisas (para uma lista completa, visite os <ulink url="http://www.kde.org/info/requirements/3.4.php">Requisitos de Compilação do KDE</ulink>). Você poderá obter normalmente estas ferramentas para o seu sistema, a partir da sua distribuição ou fornecedor. </para> + +<para>Alguns destes pacotes estão divididos em bibliotecas, programas ou utilitários e pacotes de desenvolvimento. Você irá precisar pelo menos do programa ou biblioteca e do seu pacote de desenvolvimento. Se você tiver dúvidas, instale tudo. As bibliotecas que necessita irão variar de acordo com os módulos que pretende compilar, uma vez que cada módulo tem os seus próprio requisitos. O <ulink url="http://quality.kde.org/develop/cvsguide/buildstep.php#step1"> Guia de Compilação do Código do &kde; Passo-a-Passo</ulink> possui mais detalhes sobre as ferramentas e técnicas específicas usadas para instalar e encontrar o 'software' necessário. </para> + +<para>Você poderá já ter uma versão do programa &tdesvn-build; instalada no seu sistema. O &tdesvn-build; exije que você crie um arquivo de configuração chamado <filename>.tdesvn-buildrc</filename>. Este arquivo deverá ser instalado na pasta pessoal (~/), e contém todos os dados de configuração necessários para o programa rodar, como as opções de configuração, compilação, a localização do código, o destino da instalação (prefixo), os módulos que serão compilados, &etc;. Os dados de configuração por padrão são oferecidos pelo arquivo <filename>tdesvn-buildrc-sample</filename>. Você poderá encontrar mais informações sobre a sintaxe do arquivo de configuração em <xref linkend="configure-data"/> e <xref linkend="tdesvn-buildrc"/>. </para> + +<para>Uma boa forma de obter a última versão é escolher a página 'tdesdk/scripts' da página Web do <ulink url="http://websvn.kde.org/trunk/KDE">websvn.kde.org</ulink>. Você verá uma lista dos arquivos disponíveis na pasta 'tdesdk/scripts' do repositório de &svn; do &kde;. Clique na ligação do &tdesvn-build; e transfira a última versão do programa. Faça o mesmo para o arquivo <filename>tdesvn-buildrc-sample</filename>. Torne o programa executável e verifique se está na sua PATH. </para> </sect1> <sect1 id="configure-data"> -<title ->Definindo os Dados de Configuração</title> - -<para ->Para usar o programa, você deverá ter um arquivo na sua pasta pessoal chamado <filename ->.tdesvn-buildrc</filename ->, que define as opções gerais e os módulos que deseja transferir e compilar. </para> - -<para ->Use o arquivo <filename ->tdesvn-buildrc-sample</filename -> como modelo, defina as opções globais e os módulos que deseja compilar. </para> - -<para ->Selecione o servidor de onde deseja obter o &svn;, definindo a opção global 'svn-server'. O valor padrão é o servidor &svn; anónimo, o <emphasis ->svn://anonsvn.kde.org/</emphasis ->, mas fique à vontade para alterá-lo se tiver uma <ulink url="http://developer.kde.org/documentation/misc/firststepsaccount" ->conta de &svn; do &kde;</ulink -> ou, se existir, <ulink url="http://developer.kde.org/source/anonsvn.html" -> um servidor espelho perto de você</ulink ->. </para> - -<para ->Preste bastante atenção às variáveis globais 'tdedir' e 'qtdir', uma vez que a primeira define onde o seu &kde; irá ser instalado (por padrão em <filename ->~/kde</filename ->), e o segundo diz onde (e se) a sua biblioteca Qt irá ser compilada e instalada, (por padrão em <filename ->~/tdesvn/build/qt-copy</filename ->). Você terá que saber mais tarde a localização da 'tdedir' e da 'qtdir', para configurar as variáveis de ambiente que são necessárias para executar a sua nova instalação. Verifique se os módulos indicados são, de fato, os módulos que pretende compilar. As opções padrão do arquivo <filename ->tdesvn-buildrc-sample</filename -> deverão ser suficientes para obter uma instalação relativamente completa do &kde;. Salve o resultado como <filename ->.tdesvn-buildrc</filename -> na sua pasta pessoal. </para> - -<para ->Se você desejar fazer um ajuste fino do seu arquivo <filename ->.tdesvn-buildrc</filename ->, consulte o <xref linkend="tdesvn-buildrc"/> para obter informações mais detalhadas sobre todas as opções de configuração. </para> +<title>Definindo os Dados de Configuração</title> + +<para>Para usar o programa, você deverá ter um arquivo na sua pasta pessoal chamado <filename>.tdesvn-buildrc</filename>, que define as opções gerais e os módulos que deseja transferir e compilar. </para> + +<para>Use o arquivo <filename>tdesvn-buildrc-sample</filename> como modelo, defina as opções globais e os módulos que deseja compilar. </para> + +<para>Selecione o servidor de onde deseja obter o &svn;, definindo a opção global 'svn-server'. O valor padrão é o servidor &svn; anónimo, o <emphasis>svn://anonsvn.kde.org/</emphasis>, mas fique à vontade para alterá-lo se tiver uma <ulink url="http://developer.kde.org/documentation/misc/firststepsaccount">conta de &svn; do &kde;</ulink> ou, se existir, <ulink url="http://developer.kde.org/source/anonsvn.html"> um servidor espelho perto de você</ulink>. </para> + +<para>Preste bastante atenção às variáveis globais 'tdedir' e 'qtdir', uma vez que a primeira define onde o seu &kde; irá ser instalado (por padrão em <filename>~/kde</filename>), e o segundo diz onde (e se) a sua biblioteca Qt irá ser compilada e instalada, (por padrão em <filename>~/tdesvn/build/qt-copy</filename>). Você terá que saber mais tarde a localização da 'tdedir' e da 'qtdir', para configurar as variáveis de ambiente que são necessárias para executar a sua nova instalação. Verifique se os módulos indicados são, de fato, os módulos que pretende compilar. As opções padrão do arquivo <filename>tdesvn-buildrc-sample</filename> deverão ser suficientes para obter uma instalação relativamente completa do &kde;. Salve o resultado como <filename>.tdesvn-buildrc</filename> na sua pasta pessoal. </para> + +<para>Se você desejar fazer um ajuste fino do seu arquivo <filename>.tdesvn-buildrc</filename>, consulte o <xref linkend="tdesvn-buildrc"/> para obter informações mais detalhadas sobre todas as opções de configuração. </para> </sect1> <sect1 id="building-and-troubleshooting"> -<title ->Usando o 'script' &tdesvn-build;</title> - -<para ->Agora você está pronto para executar o programa. A partir de uma janela de terminal, autentique-se com o usuário que usará para compilar o &kde; e execute o programa: <screen -><prompt ->%</prompt -><command ->su</command -> <option ->-</option -> <replaceable ->usuário</replaceable> -<prompt ->%</prompt -><command ->tdesvn-build</command -> +<title>Usando o 'script' &tdesvn-build;</title> + +<para>Agora você está pronto para executar o programa. A partir de uma janela de terminal, autentique-se com o usuário que usará para compilar o &kde; e execute o programa: <screen><prompt>%</prompt><command>su</command> <option>-</option> <replaceable>usuário</replaceable> +<prompt>%</prompt><command>tdesvn-build</command> </screen> </para> -<para ->Agora, o programa deverá começar a obter o código-fonte e a compilá-lo. É pouco provável que corra tudo bem da primeira vez que compilar o &kde;. Não se desespere! Verifique os arquivos de registro para ver se falta alguma ferramenta ou pacote de desenvolvimento (a localização dos arquivos de registro é definida pela variável 'log-dir' no arquivo de configuração). Algumas vezes, a ramificação de desenvolvimento principal fica muito instável e difícil de compilar, principalmente quando está próximo de um congelamento do desenvolvimento. Tenha paciência. Você poderá descobrir mais exemplos comuns das coisas que poderão correr mal e as suas soluções, assim como dicas e estratégias gerais para compilar o &kde; no <ulink url="http://quality.kde.org/develop/cvsguide/buildstep.php#step1" -> Guia de Compilação do Código do &kde; Passo-a-Passo</ulink ->. </para> +<para>Agora, o programa deverá começar a obter o código-fonte e a compilá-lo. É pouco provável que corra tudo bem da primeira vez que compilar o &kde;. Não se desespere! Verifique os arquivos de registro para ver se falta alguma ferramenta ou pacote de desenvolvimento (a localização dos arquivos de registro é definida pela variável 'log-dir' no arquivo de configuração). Algumas vezes, a ramificação de desenvolvimento principal fica muito instável e difícil de compilar, principalmente quando está próximo de um congelamento do desenvolvimento. Tenha paciência. Você poderá descobrir mais exemplos comuns das coisas que poderão correr mal e as suas soluções, assim como dicas e estratégias gerais para compilar o &kde; no <ulink url="http://quality.kde.org/develop/cvsguide/buildstep.php#step1"> Guia de Compilação do Código do &kde; Passo-a-Passo</ulink>. </para> </sect1> <sect1 id="environment"> -<title ->Configurando o Ambiente para Executar o seu &kde; Novo</title> +<title>Configurando o Ambiente para Executar o seu &kde; Novo</title> -<para ->Assumindo que você está usando um usuário dedicado para compilar o &kde; e já possui uma versão do &kde; instalada, a execução do seu &kde; novo precisará de alguns truques, uma vez que o &kde; novo terá de ter precedência sobre o antigo. Mude as variáveis de ambiente para garantir que isso aconteça. </para> +<para>Assumindo que você está usando um usuário dedicado para compilar o &kde; e já possui uma versão do &kde; instalada, a execução do seu &kde; novo precisará de alguns truques, uma vez que o &kde; novo terá de ter precedência sobre o antigo. Mude as variáveis de ambiente para garantir que isso aconteça. </para> -<para ->Abra ou crie o arquivo <filename ->.bash_profile</filename -> na sua pasta pessoal com o seu editor favorito e adicione o seguinte ao fim do arquivo: <programlisting> +<para>Abra ou crie o arquivo <filename>.bash_profile</filename> na sua pasta pessoal com o seu editor favorito e adicione o seguinte ao fim do arquivo: <programlisting> TDEDIR=(local do tdedir) TDEDIRS=$TDEDIR PATH=$TDEDIR/bin:$QTDIR/bin:$PATH LD_LIBRARY_PATH=$TDEDIR/lib:$LD_LIBRARY_PATH export TDEDIRS PATH LD_LIBRARY_PATH -</programlisting -> Se estiver compilando o módulo 'qt-copy', adicione em alternativa: <programlisting ->QTDIR=(local do qtdir) +</programlisting> Se estiver compilando o módulo 'qt-copy', adicione em alternativa: <programlisting>QTDIR=(local do qtdir) TDEDIR=(local do tdedir) TDEDIRS=$TDEDIR PATH=$TDEDIR/bin:$QTDIR/bin:$PATH @@ -275,13 +136,7 @@ export QTDIR TDEDIRS PATH MANPATH LD_LIBRARY_PATH </programlisting> </para> -<para ->Se você não estiver usando um usuário dedicado, defina um novo <envar ->$TDEHOME</envar -> para o seu novo ambiente no seu arquivo <filename ->.bash_profile</filename ->: <programlisting ->export TDEHOME="${HOME}/.tde-svn" +<para>Se você não estiver usando um usuário dedicado, defina um novo <envar>$TDEHOME</envar> para o seu novo ambiente no seu arquivo <filename>.bash_profile</filename>: <programlisting>export TDEHOME="${HOME}/.tde-svn" # Criar a pasta se necessário [ ! -e ~/.trinity-svn ] && mkdir ~/.trinity-svn @@ -289,11 +144,7 @@ export QTDIR TDEDIRS PATH MANPATH LD_LIBRARY_PATH </para> <note> -<para ->Se, mais tarde, o seu menu estiver vazio ou completamente cheio de aplicações da sua distribuição, você poderá ter que definir as suas variáveis de ambiente do 'xdg' no seu <filename ->.bash_profile</filename ->: <programlisting ->XDG_CONFIG_DIRS="/etc/xdg" +<para>Se, mais tarde, o seu menu estiver vazio ou completamente cheio de aplicações da sua distribuição, você poderá ter que definir as suas variáveis de ambiente do 'xdg' no seu <filename>.bash_profile</filename>: <programlisting>XDG_CONFIG_DIRS="/etc/xdg" XDG_DATA_DIRS="${TDEDIR}/share:/usr/share" export XDG_CONFIG_DIRS XDG_DATA_DIRS </programlisting> @@ -301,34 +152,21 @@ export XDG_CONFIG_DIRS XDG_DATA_DIRS </para> </note> -<para ->Agora que terminou o que tinha para fazer, certifique-se que será usado o <application ->starttde</application -> correto: </para> - -<para ->Abra o arquivo de texto <filename ->.xinitrc</filename -> (ou o <filename ->.xsession</filename ->, dependendo da distribuição) da pasta pessoal, ou crie-o se necessário. Adicione a linha: <programlisting ->exec ${TDEDIR}/bin/starttde +<para>Agora que terminou o que tinha para fazer, certifique-se que será usado o <application>starttde</application> correto: </para> + +<para>Abra o arquivo de texto <filename>.xinitrc</filename> (ou o <filename>.xsession</filename>, dependendo da distribuição) da pasta pessoal, ou crie-o se necessário. Adicione a linha: <programlisting>exec ${TDEDIR}/bin/starttde </programlisting> </para> -<para ->Agora inicie o seu &kde; novo: nos sistemas BSD e Linux, com o suporte para terminais virtuais, os atalhos Ctrl+Alt+F1...F12 são usados para mudar para o Console Virtual 1 a 12. Isto permite-lhe executar mais de um ambiente gráfico ao mesmo tempo. Os primeiros seis são terminais de texto e os seis seguintes são gráficos. </para> +<para>Agora inicie o seu &kde; novo: nos sistemas BSD e Linux, com o suporte para terminais virtuais, os atalhos Ctrl+Alt+F1...F12 são usados para mudar para o Console Virtual 1 a 12. Isto permite-lhe executar mais de um ambiente gráfico ao mesmo tempo. Os primeiros seis são terminais de texto e os seis seguintes são gráficos. </para> -<para ->Quando você inicializa, é exibido um gerenciador gráfico, em alternativa. Você poderá usar o novo ambiente do KDE, mesmo que não apareça como opção. Pressione Ctrl + Alt + F2, para que apareça um terminal de texto. Autentique-se com o usuário dedicado e digite: </para> +<para>Quando você inicializa, é exibido um gerenciador gráfico, em alternativa. Você poderá usar o novo ambiente do KDE, mesmo que não apareça como opção. Pressione Ctrl + Alt + F2, para que apareça um terminal de texto. Autentique-se com o usuário dedicado e digite: </para> -<screen ->startx -- :1 +<screen>startx -- :1 </screen> <tip> -<para ->Você poderá executar o KDE a partir do código e o KDE antigo ao mesmo tempo! Autentique-se com o seu usuário normal e inicie o ambiente do KDE estável. Pressione Ctrl + Alt + F2 (ou F1, F3, etc..), para que apareça um terminal de texto. Logue-se com o usuário dedicado e digite "startx -- :1". Você poderá voltar ao usuário normal, pressionando Ctrl + Alt + F6 (Ou F7, F8, etc... Experimente! Um deles é o correto.) Para voltar ao KDE a partir do código, pressione Ctrl + Alt + F7 (ou F6, F8,etc..). Agora você poderá mudar entre as suas versões do KDE e testar a nova, sabendo que poderá voltar rapidamente à segurança do ambiente estável do KDE. </para> +<para>Você poderá executar o KDE a partir do código e o KDE antigo ao mesmo tempo! Autentique-se com o seu usuário normal e inicie o ambiente do KDE estável. Pressione Ctrl + Alt + F2 (ou F1, F3, etc..), para que apareça um terminal de texto. Logue-se com o usuário dedicado e digite "startx -- :1". Você poderá voltar ao usuário normal, pressionando Ctrl + Alt + F6 (Ou F7, F8, etc... Experimente! Um deles é o correto.) Para voltar ao KDE a partir do código, pressione Ctrl + Alt + F7 (ou F6, F8,etc..). Agora você poderá mudar entre as suas versões do KDE e testar a nova, sabendo que poderá voltar rapidamente à segurança do ambiente estável do KDE. </para> </tip> @@ -337,1001 +175,399 @@ export XDG_CONFIG_DIRS XDG_DATA_DIRS </chapter> <chapter id="features"> -<title ->Funcionalidades do Programa</title> +<title>Funcionalidades do Programa</title> -<para ->As funcionalidades do &tdesvn-build; incluem: </para> +<para>As funcionalidades do &tdesvn-build; incluem: </para> <itemizedlist> -<listitem -><para ->Obtém ou atualiza automaticamente os módulos do &svn;, conforme necessário. </para -></listitem> - -<listitem -><para ->Agenda o processo de compilação dos módulos. </para -></listitem> - -<listitem -><para ->Tenta automaticamente compilar de novo os módulos que foram compilados com o 'make' incremental, que está sujeito a erros ao fim de algumas modificações. </para -></listitem> - -<listitem -><para ->Poderá retomar uma execução anterior ou iniciar o processo de compilação de um determinado módulo. </para -></listitem> - -<listitem -><para ->Vem com um conjunto seguro de opções padrão, apropriadas para compilar uma instalação mono-usuário básica do &kde; a partir do repositório de &svn; anónimo. </para -></listitem> - -<listitem -><para ->Vem com suporte para o <ulink url="http://www.kde.me.uk/index.php?page=unsermake" ->Unsermake</ulink ->. </para -></listitem> - -<listitem -><para ->Expansão do til (~) para as suas opções de configuração. Por exemplo, você poderá especificar: <programlisting ->qtdir ~/tdesvn/build/qt-copy</programlisting> -</para -></listitem> - -<listitem -><para ->Pastas configuráveis para compilação, para o código-fonte e para registros. </para -></listitem> - -<listitem -><para ->Configura automaticamente um sistema de compilação com uma pasta de compilação diferente da pasta de código, para manter intocávela pasta de código. A única exceção é o <application ->qt-copy</application ->, que não está desenhado para ser compilado dessa forma (a menos que queira testar o <link linkend="conf-use-qt-builddir-hack" -><quote ->truque do Qt com uma pasta de compilação separada</quote -></link ->). </para -></listitem> - -<listitem -><para ->Você poderá indicar as opções globais a aplicar a todos os módulos a serem obtidos, assim como poderá indicar opções para serem aplicadas aos módulos individualmente. </para -></listitem> - -<listitem -><para ->Uma vez que as ferramentas 'auto*' normalmente perdem a sincronização com as modificações na árvore de código, você poderá forçar uma nova compilação de um módulo, se criar um arquivo chamado '.refresh-me' na pasta de compilação do módulo em questão ou executando o &tdesvn-build; com a opção <option ->--refresh-build</option ->. </para -></listitem> - -<listitem -><para ->Você poderá indicar vários valores de ambiente a usar durante a compilação, incluindo o <envar ->TDEDIR</envar ->, o <envar ->QTDIR</envar ->, o <envar ->DO_NOT_COMPILE</envar -> e o <envar ->CXXFLAGS</envar ->. </para -></listitem> - -<listitem -><para ->Registro dos comandos. Os arquivos de registro são datados e numerados, para que você tenha sempre um relatório de execução de um programa. Do mesmo modo, é criada uma ligação simbólica 'latest' para apontar sempre para o item de registro mais recente na respectiva pasta. </para -></listitem> - -<listitem -><para ->Se você estiver usando uma compilação de usuário do &kde;, em vez de uma instalação do sistema (para a qual precisa ser o 'root' para instalar), você poderá usar o programa para instalá-lo para você. O código não foi ainda validado e ele faz uma utilização ampla da chamada <function ->system()</function ->, assim, eu não recomendo executá-lo como 'root' por enquanto. </para -></listitem> - -<listitem -><para ->Você poderá usar o <link linkend="conf-make-install-prefix" ->make-install-prefix</link -> para anteceder o comando 'make install' com um comando separado, o que poderá ser útil para o 'sudo'. </para -></listitem> - -<listitem -><para ->Você poderá usar a opção <link linkend="conf-apidox" ->apidox</link -> para compilar e instalar automaticamente a documentação da API para alguns módulos. </para -></listitem> - -<listitem -><para ->Você poderá obter apenas uma parte de um módulo do &kde; no &svn;. Por exemplo, poderá obter apenas a biblioteca <application ->taglib</application -> do <application ->tdesupport</application -> ou apenas o <application ->K3B</application -> do <application ->extragear/multimedia</application ->. O programa irá obter automaticamente o <application ->kde-common</application ->, se for necessário para fazer a compilação funcionar. </para -></listitem> - -<listitem -><para ->Você poderá <quote ->fingir</quote -> efetuar as operações. Se passar a opção <option ->--pretend</option -> ou <option ->-p</option -> na linha de comando, o programa fornecerá uma descrição mais completa dos comandos que está prestes a executar, sem executá-los de fato. </para -></listitem> - -<listitem -><para ->Suporte para obter ramificações ('branches') específicas dos módulos do &svn;. Este trabalho ainda precisa ser finalizado, mas você já poderá selecionar a ramificação que pretende compilar com a <link linkend="conf-module-base-path" ->opção de configuração 'module-base-path'</link ->. </para -></listitem> +<listitem><para>Obtém ou atualiza automaticamente os módulos do &svn;, conforme necessário. </para></listitem> + +<listitem><para>Agenda o processo de compilação dos módulos. </para></listitem> + +<listitem><para>Tenta automaticamente compilar de novo os módulos que foram compilados com o 'make' incremental, que está sujeito a erros ao fim de algumas modificações. </para></listitem> + +<listitem><para>Poderá retomar uma execução anterior ou iniciar o processo de compilação de um determinado módulo. </para></listitem> + +<listitem><para>Vem com um conjunto seguro de opções padrão, apropriadas para compilar uma instalação mono-usuário básica do &kde; a partir do repositório de &svn; anónimo. </para></listitem> + +<listitem><para>Vem com suporte para o <ulink url="http://www.kde.me.uk/index.php?page=unsermake">Unsermake</ulink>. </para></listitem> + +<listitem><para>Expansão do til (~) para as suas opções de configuração. Por exemplo, você poderá especificar: <programlisting>qtdir ~/tdesvn/build/qt-copy</programlisting> +</para></listitem> + +<listitem><para>Pastas configuráveis para compilação, para o código-fonte e para registros. </para></listitem> + +<listitem><para>Configura automaticamente um sistema de compilação com uma pasta de compilação diferente da pasta de código, para manter intocávela pasta de código. A única exceção é o <application>qt-copy</application>, que não está desenhado para ser compilado dessa forma (a menos que queira testar o <link linkend="conf-use-qt-builddir-hack"><quote>truque do Qt com uma pasta de compilação separada</quote></link>). </para></listitem> + +<listitem><para>Você poderá indicar as opções globais a aplicar a todos os módulos a serem obtidos, assim como poderá indicar opções para serem aplicadas aos módulos individualmente. </para></listitem> + +<listitem><para>Uma vez que as ferramentas 'auto*' normalmente perdem a sincronização com as modificações na árvore de código, você poderá forçar uma nova compilação de um módulo, se criar um arquivo chamado '.refresh-me' na pasta de compilação do módulo em questão ou executando o &tdesvn-build; com a opção <option>--refresh-build</option>. </para></listitem> + +<listitem><para>Você poderá indicar vários valores de ambiente a usar durante a compilação, incluindo o <envar>TDEDIR</envar>, o <envar>QTDIR</envar>, o <envar>DO_NOT_COMPILE</envar> e o <envar>CXXFLAGS</envar>. </para></listitem> + +<listitem><para>Registro dos comandos. Os arquivos de registro são datados e numerados, para que você tenha sempre um relatório de execução de um programa. Do mesmo modo, é criada uma ligação simbólica 'latest' para apontar sempre para o item de registro mais recente na respectiva pasta. </para></listitem> + +<listitem><para>Se você estiver usando uma compilação de usuário do &kde;, em vez de uma instalação do sistema (para a qual precisa ser o 'root' para instalar), você poderá usar o programa para instalá-lo para você. O código não foi ainda validado e ele faz uma utilização ampla da chamada <function>system()</function>, assim, eu não recomendo executá-lo como 'root' por enquanto. </para></listitem> + +<listitem><para>Você poderá usar o <link linkend="conf-make-install-prefix">make-install-prefix</link> para anteceder o comando 'make install' com um comando separado, o que poderá ser útil para o 'sudo'. </para></listitem> + +<listitem><para>Você poderá usar a opção <link linkend="conf-apidox">apidox</link> para compilar e instalar automaticamente a documentação da API para alguns módulos. </para></listitem> + +<listitem><para>Você poderá obter apenas uma parte de um módulo do &kde; no &svn;. Por exemplo, poderá obter apenas a biblioteca <application>taglib</application> do <application>tdesupport</application> ou apenas o <application>K3B</application> do <application>extragear/multimedia</application>. O programa irá obter automaticamente o <application>kde-common</application>, se for necessário para fazer a compilação funcionar. </para></listitem> + +<listitem><para>Você poderá <quote>fingir</quote> efetuar as operações. Se passar a opção <option>--pretend</option> ou <option>-p</option> na linha de comando, o programa fornecerá uma descrição mais completa dos comandos que está prestes a executar, sem executá-los de fato. </para></listitem> + +<listitem><para>Suporte para obter ramificações ('branches') específicas dos módulos do &svn;. Este trabalho ainda precisa ser finalizado, mas você já poderá selecionar a ramificação que pretende compilar com a <link linkend="conf-module-base-path">opção de configuração 'module-base-path'</link>. </para></listitem> </itemizedlist> -<para ->As coisas que o &tdesvn-build; NÃO faz: </para> +<para>As coisas que o &tdesvn-build; NÃO faz: </para> <itemizedlist> -<listitem -><para ->Descobrir a réplica do &svn; do &kde; mais rápida. Não existe sequer uma lista acompanhando o programa atualmente, ainda que o servidor padrão deva funcionar perfeitamente. </para -></listitem> +<listitem><para>Descobrir a réplica do &svn; do &kde; mais rápida. Não existe sequer uma lista acompanhando o programa atualmente, ainda que o servidor padrão deva funcionar perfeitamente. </para></listitem> -<listitem -><para ->Escovar os seus dentes. Você deve lembrar de fazer isso você mesmo. </para -></listitem> +<listitem><para>Escovar os seus dentes. Você deve lembrar de fazer isso você mesmo. </para></listitem> -<listitem -><para ->O programa, provavelmente, não está livre de erros. Desculpe por isso. </para -></listitem> +<listitem><para>O programa, provavelmente, não está livre de erros. Desculpe por isso. </para></listitem> </itemizedlist> </chapter> <chapter id="tdesvn-buildrc"> -<title ->O Formato do '.tdesvn-buildrc'</title> +<title>O Formato do '.tdesvn-buildrc'</title> -<para ->Para usar o programa, você deverá ter um arquivo na sua pasta pessoal <filename ->.tdesvn-buildrc</filename ->, que descreve os módulos que deseja obter e compilar. </para> +<para>Para usar o programa, você deverá ter um arquivo na sua pasta pessoal <filename>.tdesvn-buildrc</filename>, que descreve os módulos que deseja obter e compilar. </para> -<para ->Ele começa com as opções globais, indicadas da seguinte forma: </para> +<para>Ele começa com as opções globais, indicadas da seguinte forma: </para> -<programlisting ->global -<replaceable ->nome-opção valor-opção</replaceable> -<replaceable ->[...]</replaceable> +<programlisting>global +<replaceable>nome-opção valor-opção</replaceable> +<replaceable>[...]</replaceable> end global </programlisting> -<para ->Segue-se então uma ou mais seções dos módulos, organizadas da seguinte forma: </para> +<para>Segue-se então uma ou mais seções dos módulos, organizadas da seguinte forma: </para> -<programlisting ->module <replaceable ->nome-módulo</replaceable> -<replaceable ->nome-opção valor-opção</replaceable> -<replaceable ->[...]</replaceable> +<programlisting>module <replaceable>nome-módulo</replaceable> +<replaceable>nome-opção valor-opção</replaceable> +<replaceable>[...]</replaceable> end module </programlisting> -<para ->O <replaceable ->nome-módulo</replaceable -> deverá ser um módulo do repositório de &svn; do &kde; (por exemplo, o 'tdelibs' ou o 'tdebase'). Algumas das opções sobrepõem-se às globais, algumas adicionam-se às opções globais e algumas opções globais simplesmente não podem ser sobrepostas. </para> +<para>O <replaceable>nome-módulo</replaceable> deverá ser um módulo do repositório de &svn; do &kde; (por exemplo, o 'tdelibs' ou o 'tdebase'). Algumas das opções sobrepõem-se às globais, algumas adicionam-se às opções globais e algumas opções globais simplesmente não podem ser sobrepostas. </para> -<para ->Segue-se uma lista ordenada alfabeticamente das opções que poderá usar. Clique na opção para descobrir mais sobre ela. Se alguma não estiver documentada, envie por favor um e-mail aos autores, usando o endereço que poderá encontrar <link linkend="authors" ->acima</link ->. </para> +<para>Segue-se uma lista ordenada alfabeticamente das opções que poderá usar. Clique na opção para descobrir mais sobre ela. Se alguma não estiver documentada, envie por favor um e-mail aos autores, usando o endereço que poderá encontrar <link linkend="authors">acima</link>. </para> <itemizedlist> -<listitem -><para -><link linkend="conf-apidox" ->apidox</link ->, para compilar a Documentação da API</para -></listitem> -<listitem -><para -><link linkend="conf-apply-qt-patches" ->apply-qt-patches</link ->, para melhorar o 'qt-copy'</para -></listitem> -<listitem -><para -><link linkend="conf-binpath" ->binpath</link ->, para definir a variável <envar ->PATH</envar ->.</para -></listitem> -<listitem -><para -><link linkend="conf-branch" ->branch</link ->, para obter uma determinada ramificação, em vez da '/trunk'.</para -></listitem> -<listitem -><para -><link linkend="conf-build-dir" ->build-dir</link ->, para definir a pasta onde será feita a compilação.</para -></listitem> -<listitem -><para -><link linkend="conf-checkout-only" ->checkout-only</link ->, para transferir apenas as partes de um módulo.</para -></listitem> -<listitem -><para -><link linkend="conf-colorful-output" ->colorful-output</link -> para colorir o resultado do programa.</para -></listitem> -<listitem -><para -><link linkend="conf-configure-flags" ->configure-flags</link -> para definir as opções com que um módulo poderá ser configurado.</para -></listitem> -<listitem -><para -><link linkend="conf-cxxflags" ->cxxflags</link -> para definir a variável <envar ->CXXFLAGS</envar ->.</para -></listitem> -<listitem -><para -><link linkend="conf-dest-dir" ->dest-dir</link -> para mudar a pasta de instalação de um módulo.</para -></listitem> -<listitem -><para -><link linkend="conf-disable-agent-check" ->disable-agent-check</link ->, para impedir que o 'tdesvn-build' verifique o estado do 'ssh-agent'.</para -></listitem> -<listitem -><para -><link linkend="conf-do-not-compile" ->do-not-compile</link ->, para marcar as pastas que não serão compiladas.</para -></listitem> -<listitem -><para -><link linkend="conf-inst-apps" ->inst-apps</link ->, para só compilar e instalar algumas pastas.</para -></listitem> -<listitem -><para -><link linkend="conf-install-after-build" ->install-after-build</link ->, para evitar a instalação após o processo de compilação.</para -></listitem> -<listitem -><para -><link linkend="conf-tdedir" ->tdedir</link ->, para indicar a pasta onde o KDE será instalado.</para -></listitem> -<listitem -><para -><link linkend="conf-libpath" ->libpath</link ->, para configurar a variável <envar ->LD_LIBRARY_PATH</envar ->.</para -></listitem> -<listitem -><para -><link linkend="conf-make-install-prefix" ->make-install-prefix</link ->, para executar um programa auxiliar (como o 'sudo') durante o 'make install'.</para -></listitem> -<listitem -><para -><link linkend="conf-make-options" ->make-options</link ->, para passar opções ao programa 'make'.</para -></listitem> -<listitem -><para -><link linkend="conf-manual-build" ->manual-build</link ->, para evitar que o módulo seja compilado automaticamente.</para -></listitem> -<listitem -><para -><link linkend="conf-manual-update" ->manual-update</link ->, para evitar que seja feito, seja o que for, ao módulo de forma automática.</para -></listitem> -<listitem -><para -><link linkend="conf-module-base-path" ->module-base-path</link ->, para mudar o local de onde transferir o módulo (útil para as ramificações - 'branches' -, e marcas - 'tags').</para -></listitem> -<listitem -><para -><link linkend="conf-niceness" ->niceness</link ->, para mudar a prioridade da CPU.</para -></listitem> -<listitem -><para -><link linkend="conf-no-rebuild-on-fail" ->no-rebuild-on-fail</link ->, para evitar a execução do 'make' novamente se algo falhar.</para -></listitem> -<listitem -><para -><link linkend="conf-qtdir" ->qtdir</link ->, para definir a localização do Qt.</para -></listitem> -<listitem -><para -><link linkend="conf-set-env" ->set-env</link ->, para configurar uma variável de ambiente.</para -></listitem> -<listitem -><para -><link linkend="conf-source-dir" ->source-dir</link ->, para mudar o local onde colocar o código transferido.</para -></listitem> -<listitem -><para -><link linkend="conf-stop-on-failure" ->stop-on-failure</link ->, para fazer com que o 'tdesvn-build' pare o mais cedo possível, após encontrar um problema.</para -></listitem> -<listitem -><para -><link linkend="conf-svn-server" ->svn-server</link ->, para mudar o servidor de onde é transferido o código.</para -></listitem> -<listitem -><para -><link linkend="conf-use-qt-builddir-hack" ->use-qt-builddir-hack</link ->, para dar ao Qt uma pasta de compilação diferente da do seu código, como acontece no KDE.</para -></listitem> -<listitem -><para -><link linkend="conf-use-unsermake" ->use-unsermake</link ->, para usar o sistema de compilação avançado, o 'unsermake'.</para -></listitem> +<listitem><para><link linkend="conf-apidox">apidox</link>, para compilar a Documentação da API</para></listitem> +<listitem><para><link linkend="conf-apply-qt-patches">apply-qt-patches</link>, para melhorar o 'qt-copy'</para></listitem> +<listitem><para><link linkend="conf-binpath">binpath</link>, para definir a variável <envar>PATH</envar>.</para></listitem> +<listitem><para><link linkend="conf-branch">branch</link>, para obter uma determinada ramificação, em vez da '/trunk'.</para></listitem> +<listitem><para><link linkend="conf-build-dir">build-dir</link>, para definir a pasta onde será feita a compilação.</para></listitem> +<listitem><para><link linkend="conf-checkout-only">checkout-only</link>, para transferir apenas as partes de um módulo.</para></listitem> +<listitem><para><link linkend="conf-colorful-output">colorful-output</link> para colorir o resultado do programa.</para></listitem> +<listitem><para><link linkend="conf-configure-flags">configure-flags</link> para definir as opções com que um módulo poderá ser configurado.</para></listitem> +<listitem><para><link linkend="conf-cxxflags">cxxflags</link> para definir a variável <envar>CXXFLAGS</envar>.</para></listitem> +<listitem><para><link linkend="conf-dest-dir">dest-dir</link> para mudar a pasta de instalação de um módulo.</para></listitem> +<listitem><para><link linkend="conf-disable-agent-check">disable-agent-check</link>, para impedir que o 'tdesvn-build' verifique o estado do 'ssh-agent'.</para></listitem> +<listitem><para><link linkend="conf-do-not-compile">do-not-compile</link>, para marcar as pastas que não serão compiladas.</para></listitem> +<listitem><para><link linkend="conf-inst-apps">inst-apps</link>, para só compilar e instalar algumas pastas.</para></listitem> +<listitem><para><link linkend="conf-install-after-build">install-after-build</link>, para evitar a instalação após o processo de compilação.</para></listitem> +<listitem><para><link linkend="conf-tdedir">tdedir</link>, para indicar a pasta onde o KDE será instalado.</para></listitem> +<listitem><para><link linkend="conf-libpath">libpath</link>, para configurar a variável <envar>LD_LIBRARY_PATH</envar>.</para></listitem> +<listitem><para><link linkend="conf-make-install-prefix">make-install-prefix</link>, para executar um programa auxiliar (como o 'sudo') durante o 'make install'.</para></listitem> +<listitem><para><link linkend="conf-make-options">make-options</link>, para passar opções ao programa 'make'.</para></listitem> +<listitem><para><link linkend="conf-manual-build">manual-build</link>, para evitar que o módulo seja compilado automaticamente.</para></listitem> +<listitem><para><link linkend="conf-manual-update">manual-update</link>, para evitar que seja feito, seja o que for, ao módulo de forma automática.</para></listitem> +<listitem><para><link linkend="conf-module-base-path">module-base-path</link>, para mudar o local de onde transferir o módulo (útil para as ramificações - 'branches' -, e marcas - 'tags').</para></listitem> +<listitem><para><link linkend="conf-niceness">niceness</link>, para mudar a prioridade da CPU.</para></listitem> +<listitem><para><link linkend="conf-no-rebuild-on-fail">no-rebuild-on-fail</link>, para evitar a execução do 'make' novamente se algo falhar.</para></listitem> +<listitem><para><link linkend="conf-qtdir">qtdir</link>, para definir a localização do Qt.</para></listitem> +<listitem><para><link linkend="conf-set-env">set-env</link>, para configurar uma variável de ambiente.</para></listitem> +<listitem><para><link linkend="conf-source-dir">source-dir</link>, para mudar o local onde colocar o código transferido.</para></listitem> +<listitem><para><link linkend="conf-stop-on-failure">stop-on-failure</link>, para fazer com que o 'tdesvn-build' pare o mais cedo possível, após encontrar um problema.</para></listitem> +<listitem><para><link linkend="conf-svn-server">svn-server</link>, para mudar o servidor de onde é transferido o código.</para></listitem> +<listitem><para><link linkend="conf-use-qt-builddir-hack">use-qt-builddir-hack</link>, para dar ao Qt uma pasta de compilação diferente da do seu código, como acontece no KDE.</para></listitem> +<listitem><para><link linkend="conf-use-unsermake">use-unsermake</link>, para usar o sistema de compilação avançado, o 'unsermake'.</para></listitem> </itemizedlist> -<para ->Aqui está uma tabela com as opções globais, bem como alguns comentários sobre elas. As opções que se sobreporem às globais irão também sobrepor-se a uma configuração da linha de comando. </para> +<para>Aqui está uma tabela com as opções globais, bem como alguns comentários sobre elas. As opções que se sobreporem às globais irão também sobrepor-se a uma configuração da linha de comando. </para> <table id="option-table"> -<title ->Tabela de Opções</title> +<title>Tabela de Opções</title> <tgroup cols="3"> <thead> <row> -<entry ->Nome da Opção</entry> -<entry ->Comportamento do Módulo -> Global</entry> -<entry ->Notas</entry> +<entry>Nome da Opção</entry> +<entry>Comportamento do Módulo -> Global</entry> +<entry>Notas</entry> </row> </thead> <tbody> <row id="conf-apidox"> -<entry ->apidox</entry> -<entry ->Sobrepõe-se à global</entry> -<entry ->Configure esta opção como <quote ->true</quote ->, para que o &tdesvn-build; compile e instale automaticamente a documentação da API do módulo, após o processo de compilação/instalação normal. Isto só funciona para os módulos em que o <command ->make apidox</command -> faz alguma coisa, e que incluem o 'tdelibs', 'tdebase' e o 'koffice', entre outros. </entry> +<entry>apidox</entry> +<entry>Sobrepõe-se à global</entry> +<entry>Configure esta opção como <quote>true</quote>, para que o &tdesvn-build; compile e instale automaticamente a documentação da API do módulo, após o processo de compilação/instalação normal. Isto só funciona para os módulos em que o <command>make apidox</command> faz alguma coisa, e que incluem o 'tdelibs', 'tdebase' e o 'koffice', entre outros. </entry> </row> <row id="conf-apply-qt-patches"> -<entry ->apply-qt-patches</entry> -<entry ->Sobrepõe-se à global</entry> -<entry ->Esta opção só é útil para o 'qt-copy'. Se for um valor diferente de zero, então o programa 'apply-patches' do 'qt-copy' será executado antes da compilação, para aplicar as alterações não oficiais no 'qt-copy'. Uma vez que estas alterações são normalmente a razão para usar o 'qt-copy', em vez de um Qt oficial, não deverá haver qualquer problema em ativá-las. Por padrão, está ativada a aplicação destas modificações.</entry> +<entry>apply-qt-patches</entry> +<entry>Sobrepõe-se à global</entry> +<entry>Esta opção só é útil para o 'qt-copy'. Se for um valor diferente de zero, então o programa 'apply-patches' do 'qt-copy' será executado antes da compilação, para aplicar as alterações não oficiais no 'qt-copy'. Uma vez que estas alterações são normalmente a razão para usar o 'qt-copy', em vez de um Qt oficial, não deverá haver qualquer problema em ativá-las. Por padrão, está ativada a aplicação destas modificações.</entry> </row> <row id="conf-binpath"> -<entry ->binpath</entry> -<entry ->Não poderá ser sobreposta</entry> -<entry -><para ->Ative esta opção para modificar a variável de ambiente PATH durante a compilação. Não poderá sobrepor esta opção numa opção do módulo. O valor padrão é o <filename class="directory" ->/bin:/usr/bin:/usr/local/bin:/usr/X11R6/bin</filename ->. Esta variável de ambiente deverá incluir os locais, separados por dois-pontos das suas ferramentas de desenvolvimento. Os locais <filename class="directory" ->$TDEDIR/bin</filename -> e <filename class="directory" ->$QTDIR/bin</filename -> são adicionados automaticamente. Você poderá usar o til (~) para os locais que adicionar com esta opção.</para> +<entry>binpath</entry> +<entry>Não poderá ser sobreposta</entry> +<entry><para>Ative esta opção para modificar a variável de ambiente PATH durante a compilação. Não poderá sobrepor esta opção numa opção do módulo. O valor padrão é o <filename class="directory">/bin:/usr/bin:/usr/local/bin:/usr/X11R6/bin</filename>. Esta variável de ambiente deverá incluir os locais, separados por dois-pontos das suas ferramentas de desenvolvimento. Os locais <filename class="directory">$TDEDIR/bin</filename> e <filename class="directory">$QTDIR/bin</filename> são adicionados automaticamente. Você poderá usar o til (~) para os locais que adicionar com esta opção.</para> </entry> </row> <row id="conf-branch"> -<entry ->branch</entry> -<entry ->Sobrepõe-se à global</entry> -<entry -><para ->Altere esta opção para obter uma ramificação do KDE, em vez do valor por padrão "trunk", onde o desenvolvimento do KDE está em curso. Por exemplo, para obter a ramificação do KDE 3.4, você deverá configurar esta opção como "3.4".</para> -<para ->Lembre-se que alguns módulos usam um nome de ramificação diferente. Notavelmente,o módulo obrigatório 'arts' não segue os números de versões do KDE. O 'arts' que acompanhava o KDE 3.4 era o 1.4.</para> -<para ->Se o 'tdesvn-build' não conseguir obter adequadamente uma ramificação com esta opção, você poderá ter de indicar manualmente o URL de onde transferir, com a opção <link linkend="conf-override-url" ->override-url</link ->.</para> +<entry>branch</entry> +<entry>Sobrepõe-se à global</entry> +<entry><para>Altere esta opção para obter uma ramificação do KDE, em vez do valor por padrão "trunk", onde o desenvolvimento do KDE está em curso. Por exemplo, para obter a ramificação do KDE 3.4, você deverá configurar esta opção como "3.4".</para> +<para>Lembre-se que alguns módulos usam um nome de ramificação diferente. Notavelmente,o módulo obrigatório 'arts' não segue os números de versões do KDE. O 'arts' que acompanhava o KDE 3.4 era o 1.4.</para> +<para>Se o 'tdesvn-build' não conseguir obter adequadamente uma ramificação com esta opção, você poderá ter de indicar manualmente o URL de onde transferir, com a opção <link linkend="conf-override-url">override-url</link>.</para> </entry> </row> <row id="conf-build-dir"> -<entry ->build-dir</entry> -<entry ->Sobrepõe-se à global</entry> -<entry ->Use esta opção para mudar a pasta que contém o código compilado. Existem três formas diferentes de usá-la: <itemizedlist -> <listitem -><para ->Relativa à pasta de código do &kde; no &svn; (ver a <link linkend="conf-source-dir" ->opção 'source-dir'</link ->). Esta é a opção padrão e a forma como funcionou o programa até à versão v0.61. Este modo fica selecionado se digitar o nome de uma pasta que não comece por um til (~) ou uma barra (/).</para -> <para ->O valor padrão é <filename class="directory" ->build</filename ->.</para -></listitem -> <listitem -><para ->Um local absoluto. Se indicar um local que comece por um /, então será usado esse local diretamente. Por exemplo, o <filename class="directory" ->/tmp/kde-obj-dir/</filename ->.</para -></listitem -> <listitem -><para ->Relativo à sua pasta pessoal. Se indicar uma pasta que comece com um '~', então o local será usado em relação à sua pasta pessoal, de forma semelhante à expansão do til da linha de comando. Por exemplo, o <filename class="directory" ->~/builddir</filename -> irá configurar a pasta de compilação como <filename class="directory" ->/home/usuário/builddir</filename ->.</para -></listitem -> </itemizedlist -> Surpreendentemente, esta opção poderá ser alterada por módulo. </entry> +<entry>build-dir</entry> +<entry>Sobrepõe-se à global</entry> +<entry>Use esta opção para mudar a pasta que contém o código compilado. Existem três formas diferentes de usá-la: <itemizedlist> <listitem><para>Relativa à pasta de código do &kde; no &svn; (ver a <link linkend="conf-source-dir">opção 'source-dir'</link>). Esta é a opção padrão e a forma como funcionou o programa até à versão v0.61. Este modo fica selecionado se digitar o nome de uma pasta que não comece por um til (~) ou uma barra (/).</para> <para>O valor padrão é <filename class="directory">build</filename>.</para></listitem> <listitem><para>Um local absoluto. Se indicar um local que comece por um /, então será usado esse local diretamente. Por exemplo, o <filename class="directory">/tmp/kde-obj-dir/</filename>.</para></listitem> <listitem><para>Relativo à sua pasta pessoal. Se indicar uma pasta que comece com um '~', então o local será usado em relação à sua pasta pessoal, de forma semelhante à expansão do til da linha de comando. Por exemplo, o <filename class="directory">~/builddir</filename> irá configurar a pasta de compilação como <filename class="directory">/home/usuário/builddir</filename>.</para></listitem> </itemizedlist> Surpreendentemente, esta opção poderá ser alterada por módulo. </entry> </row> <row id="conf-checkout-only"> -<entry ->checkout-only</entry> -<entry ->Sobrepõe-se à global</entry> -<entry ->Altere esta opção para obter o código do &svn; passo-a-passo. O valor desta opção deverá ser uma lista separada por espaços das pastas a transferir. Se não incluir a pasta 'admin', ela será incluída automaticamente (se necessário). Ao transferir passo-a-passo, a pasta 'admin' será obtida do 'kde-common', que é onde se encontra no servidor do &svn;. Ainda que esta opção se sobreponha à global, observe que esta opção, como global, não faz sentido. </entry> +<entry>checkout-only</entry> +<entry>Sobrepõe-se à global</entry> +<entry>Altere esta opção para obter o código do &svn; passo-a-passo. O valor desta opção deverá ser uma lista separada por espaços das pastas a transferir. Se não incluir a pasta 'admin', ela será incluída automaticamente (se necessário). Ao transferir passo-a-passo, a pasta 'admin' será obtida do 'kde-common', que é onde se encontra no servidor do &svn;. Ainda que esta opção se sobreponha à global, observe que esta opção, como global, não faz sentido. </entry> </row> <row id="conf-configure-flags"> -<entry ->configure-flags</entry> -<entry ->Adiciona às opções globais (exceto no 'qt-copy')</entry> -<entry ->Use esta opção para indicar quais opções passar ao './configure' quando criar o sistema de compilação do módulo. Quando isto é usado como uma opção global, é aplicada a todos os módulos onde este programa se compila. O 'qt-copy' usa um conjunto muito diferente de opções do 'configure' do resto do &kde;, assim esta opção <emphasis ->sobrepõe</emphasis -> as opções globais, quando é aplicada ao 'qt-copy'.</entry> +<entry>configure-flags</entry> +<entry>Adiciona às opções globais (exceto no 'qt-copy')</entry> +<entry>Use esta opção para indicar quais opções passar ao './configure' quando criar o sistema de compilação do módulo. Quando isto é usado como uma opção global, é aplicada a todos os módulos onde este programa se compila. O 'qt-copy' usa um conjunto muito diferente de opções do 'configure' do resto do &kde;, assim esta opção <emphasis>sobrepõe</emphasis> as opções globais, quando é aplicada ao 'qt-copy'.</entry> </row> <row id="conf-colorful-output"> -<entry ->colorful-output</entry> -<entry ->Não poderá ser sobreposta</entry> -<entry ->Configure esta opção como 'false' para desativar o resultado colorido do &tdesvn-build;. Por padrão é <quote ->true</quote ->. Lembre-se que o &tdesvn-build; não irá mostrar os códigos de cores em nada que não seja um terminal (como o 'xterm', o &konsole; ou o console normal do Linux). </entry> +<entry>colorful-output</entry> +<entry>Não poderá ser sobreposta</entry> +<entry>Configure esta opção como 'false' para desativar o resultado colorido do &tdesvn-build;. Por padrão é <quote>true</quote>. Lembre-se que o &tdesvn-build; não irá mostrar os códigos de cores em nada que não seja um terminal (como o 'xterm', o &konsole; ou o console normal do Linux). </entry> </row> <row id="conf-cxxflags"> -<entry ->cxxflags</entry> -<entry ->Adiciona-se à opção global</entry> -<entry ->Use esta opção para indicar as opções a passar ao <command ->./configure</command -> como <envar ->CXXFLAGS</envar ->, ao criar o sistema de compilação do módulo. Esta opção é indicada aqui em vez do <link linkend="conf-configure-flags" ->configure-flags</link ->, uma vez que esta opção irá também definir a variável de ambiente <envar ->CXXFLAGS</envar -> durante o processo de compilação. </entry> +<entry>cxxflags</entry> +<entry>Adiciona-se à opção global</entry> +<entry>Use esta opção para indicar as opções a passar ao <command>./configure</command> como <envar>CXXFLAGS</envar>, ao criar o sistema de compilação do módulo. Esta opção é indicada aqui em vez do <link linkend="conf-configure-flags">configure-flags</link>, uma vez que esta opção irá também definir a variável de ambiente <envar>CXXFLAGS</envar> durante o processo de compilação. </entry> </row> <row id="conf-dest-dir"> -<entry ->dest-dir</entry> -<entry ->Sobrepõe-se à global</entry> -<entry ->Use esta opção para mudar o nome que é dado a um módulo no disco. Por exemplo, se o seu módulo se chamava 'extragear/network', você poderá mudar o nome do mesmo para 'extragear-network' com esta opção. </entry> +<entry>dest-dir</entry> +<entry>Sobrepõe-se à global</entry> +<entry>Use esta opção para mudar o nome que é dado a um módulo no disco. Por exemplo, se o seu módulo se chamava 'extragear/network', você poderá mudar o nome do mesmo para 'extragear-network' com esta opção. </entry> </row> <row id="conf-disable-agent-check"> -<entry ->disable-agent-check</entry> -<entry ->Não poderá ser sobreposta</entry> -<entry ->Normalmente, se você estiver usando o SSH para obter o código do Subversion (se, por exemplo, estiver usando o protocolo 'svn+ssh'), o 'tdesvn-build' irá tentar certificar-se que, se estiver usando o 'ssh-agent', ele está de fato gerenciando algumas identidades do SSH. Isto é para tentar evitar que o SSH pergunte a sua frase-senha para todos os módulos. Você poderá desativar esta opção se ativar a opção 'disable-agent-check' como 'true'. </entry> +<entry>disable-agent-check</entry> +<entry>Não poderá ser sobreposta</entry> +<entry>Normalmente, se você estiver usando o SSH para obter o código do Subversion (se, por exemplo, estiver usando o protocolo 'svn+ssh'), o 'tdesvn-build' irá tentar certificar-se que, se estiver usando o 'ssh-agent', ele está de fato gerenciando algumas identidades do SSH. Isto é para tentar evitar que o SSH pergunte a sua frase-senha para todos os módulos. Você poderá desativar esta opção se ativar a opção 'disable-agent-check' como 'true'. </entry> </row> <row id="conf-do-not-compile"> -<entry ->do-not-compile</entry> -<entry ->Sobrepõe-se à global</entry> -<entry -><para ->Use esta opção para definir a variável de ambiente <envar ->DO_NOT_COMPILE</envar -> antes de executar o programa 'configure'. De acordo com a <ulink url="http://developer.kde.org/documentation/other/developer-faq.html" ->FAQ de Desenvolvimento do &kde;</ulink ->, este deverá ser o caso de uma pasta de topo que não deseje compilar. As pastas deverão estar separadas por espaços.</para> - -<para ->Lembre-se que o código dos programas será ainda transferido. Você poderá usar a instrução <link linkend="conf-checkout-only" ->checkout-only</link -> para escolher as pastas que deseja obter.</para> +<entry>do-not-compile</entry> +<entry>Sobrepõe-se à global</entry> +<entry><para>Use esta opção para definir a variável de ambiente <envar>DO_NOT_COMPILE</envar> antes de executar o programa 'configure'. De acordo com a <ulink url="http://developer.kde.org/documentation/other/developer-faq.html">FAQ de Desenvolvimento do &kde;</ulink>, este deverá ser o caso de uma pasta de topo que não deseje compilar. As pastas deverão estar separadas por espaços.</para> + +<para>Lembre-se que o código dos programas será ainda transferido. Você poderá usar a instrução <link linkend="conf-checkout-only">checkout-only</link> para escolher as pastas que deseja obter.</para> </entry> </row> <row id="conf-email-address"> -<entry ->email-address</entry> -<entry ->Não poderá ser sobreposta</entry> +<entry>email-address</entry> +<entry>Não poderá ser sobreposta</entry> <entry> -<para ->Configure esta opção com o endereço de e-mail que o 'tdesvn-build' deverá usar, no caso de precisar alguma vez enviar mensagens. Você não terá que se preocupar com isto se não usar qualquer funcionalidade que envie e-mails. (Elas estão todas desativadas por padrão). </para> +<para>Configure esta opção com o endereço de e-mail que o 'tdesvn-build' deverá usar, no caso de precisar alguma vez enviar mensagens. Você não terá que se preocupar com isto se não usar qualquer funcionalidade que envie e-mails. (Elas estão todas desativadas por padrão). </para> -<para ->Atualmente, somente o <link linkend="conf-email-on-compile-error" ->email-on-compile-error</link -> necessita desta opção. </para> +<para>Atualmente, somente o <link linkend="conf-email-on-compile-error">email-on-compile-error</link> necessita desta opção. </para> </entry> </row> <row id="conf-email-on-compile-error"> -<entry ->email-on-compile-error</entry> -<entry ->Não poderá ser sobreposta</entry> +<entry>email-on-compile-error</entry> +<entry>Não poderá ser sobreposta</entry> <entry> -<para ->Você poderá configurar esta opção com o endereço de e-mail para onde enviar um relatório, sempre que um módulo não conseguir ser compilado. O 'tdesvn-build' irá esperar até que todos os módulos terminem e irá recolher todos os resultados no relatório. Este relatório só é enviado se um módulo se recusar a compilar. </para> +<para>Você poderá configurar esta opção com o endereço de e-mail para onde enviar um relatório, sempre que um módulo não conseguir ser compilado. O 'tdesvn-build' irá esperar até que todos os módulos terminem e irá recolher todos os resultados no relatório. Este relatório só é enviado se um módulo se recusar a compilar. </para> -<para ->Por favor, veja a opção <link linkend="conf-email-address" ->email-address</link -> para configurar o endereço de onde o 'tdesvn-build' irá enviar, uma vez que o valor padrão não é normalmente o que você deseja. </para> +<para>Por favor, veja a opção <link linkend="conf-email-address">email-address</link> para configurar o endereço de onde o 'tdesvn-build' irá enviar, uma vez que o valor padrão não é normalmente o que você deseja. </para> </entry> </row> <row id="conf-inst-apps"> -<entry ->inst-apps</entry> -<entry ->Sobrepõe-se à global</entry> -<entry -><para ->Isto é o oposto da opção <link linkend="conf-do-not-compile" ->do-not-compile</link ->. Serve para indicar que apenas as pastas de topo referidas serão compiladas. As pastas deverão estar separadas por espaços.</para> - -<para ->As alterações não farão efeito até à próxima vez que o <command ->make <option ->-f</option -> Makefile.cvs</command -> seja executado, quer automaticamente pelo programa, quer manualmente pelas opções <link linkend="cmdline-refresh-build" -><option ->--refresh-build</option -></link -> ou <link linkend="cmdline-recreate-configure" -><option ->--recreate-configure</option -></link ->. </para> - -<para ->Lembre-se que o código dos programas será ainda transferido. Você poderá usar a instrução <link linkend="conf-checkout-only" ->checkout-only</link -> para escolher as pastas que deseja obter.</para> +<entry>inst-apps</entry> +<entry>Sobrepõe-se à global</entry> +<entry><para>Isto é o oposto da opção <link linkend="conf-do-not-compile">do-not-compile</link>. Serve para indicar que apenas as pastas de topo referidas serão compiladas. As pastas deverão estar separadas por espaços.</para> + +<para>As alterações não farão efeito até à próxima vez que o <command>make <option>-f</option> Makefile.cvs</command> seja executado, quer automaticamente pelo programa, quer manualmente pelas opções <link linkend="cmdline-refresh-build"><option>--refresh-build</option></link> ou <link linkend="cmdline-recreate-configure"><option>--recreate-configure</option></link>. </para> + +<para>Lembre-se que o código dos programas será ainda transferido. Você poderá usar a instrução <link linkend="conf-checkout-only">checkout-only</link> para escolher as pastas que deseja obter.</para> </entry> </row> <row id="conf-install-after-build"> -<entry ->install-after-build</entry> -<entry ->Sobrepõe-se à global</entry> -<entry ->Esta opção é usada para instalar o pacote depois dele ser compilado com sucesso. Esta opção está ativa por padrão. Se quiser desativá-la, terá que configurar esta opção como 0 no arquivo de configuração. Você poderá também usar a opção da linha de comando <link linkend="cmdline-no-install" -><option ->--no-install</option -></link ->. </entry> +<entry>install-after-build</entry> +<entry>Sobrepõe-se à global</entry> +<entry>Esta opção é usada para instalar o pacote depois dele ser compilado com sucesso. Esta opção está ativa por padrão. Se quiser desativá-la, terá que configurar esta opção como 0 no arquivo de configuração. Você poderá também usar a opção da linha de comando <link linkend="cmdline-no-install"><option>--no-install</option></link>. </entry> </row> <row id="conf-tdedir"> -<entry ->tdedir</entry> -<entry ->Não poderá ser sobreposta</entry> -<entry ->Esta opção define a pasta em que o &kde; será instalado após a compilação. Por padrão, será em <filename class="directory" ->~/kde</filename ->. Se mudar isto para uma pasta que precise do acesso do 'root', será útil também ler algumas informações sobre a opção <link linkend="conf-make-install-prefix" ->make-install-prefix</link ->.</entry> +<entry>tdedir</entry> +<entry>Não poderá ser sobreposta</entry> +<entry>Esta opção define a pasta em que o &kde; será instalado após a compilação. Por padrão, será em <filename class="directory">~/kde</filename>. Se mudar isto para uma pasta que precise do acesso do 'root', será útil também ler algumas informações sobre a opção <link linkend="conf-make-install-prefix">make-install-prefix</link>.</entry> </row> <row id="conf-libpath"> -<entry ->libpath</entry> -<entry ->Não poderá ser sobreposta</entry> -<entry ->Configure esta opção para definir a variável de ambiente LD_LIBRARY_PATH, enquanto efetua a compilação. Você não poderá sobrepor esta opção num módulo. O valor padrão está em branco, mas os locais <filename class="directory" ->$TDEDIR/lib</filename -> e <filename class="directory" ->$QTDIR/lib</filename -> são adicionados automaticamente. Você poderá usar o til (~) para os locais que adicionar com esta opção. </entry> +<entry>libpath</entry> +<entry>Não poderá ser sobreposta</entry> +<entry>Configure esta opção para definir a variável de ambiente LD_LIBRARY_PATH, enquanto efetua a compilação. Você não poderá sobrepor esta opção num módulo. O valor padrão está em branco, mas os locais <filename class="directory">$TDEDIR/lib</filename> e <filename class="directory">$QTDIR/lib</filename> são adicionados automaticamente. Você poderá usar o til (~) para os locais que adicionar com esta opção. </entry> </row> <row id="conf-log-dir"> -<entry ->log-dir</entry> -<entry ->Sobrepõe-se à global</entry> -<entry ->Use esta opção para mudar a pasta que irá conter os arquivos de registro gerados pelo programa. Esta opção poderá ser definida para cada módulo, a partir da versão 0.64. </entry> +<entry>log-dir</entry> +<entry>Sobrepõe-se à global</entry> +<entry>Use esta opção para mudar a pasta que irá conter os arquivos de registro gerados pelo programa. Esta opção poderá ser definida para cada módulo, a partir da versão 0.64. </entry> </row> <row id="conf-make-install-prefix"> -<entry ->make-install-prefix</entry> -<entry ->Sobrepõe-se à global</entry> -<entry ->Configure esta variável com uma lista separada por espaços, que será interpretada como um comando e as suas opções, para anteceder o comando 'make install', que é usado para instalar os módulos. Isto é útil para instalar os pacotes com o 'sudo', por exemplo, mas tenha cuidado ao trabalhar com os privilégios do 'root'.</entry> +<entry>make-install-prefix</entry> +<entry>Sobrepõe-se à global</entry> +<entry>Configure esta variável com uma lista separada por espaços, que será interpretada como um comando e as suas opções, para anteceder o comando 'make install', que é usado para instalar os módulos. Isto é útil para instalar os pacotes com o 'sudo', por exemplo, mas tenha cuidado ao trabalhar com os privilégios do 'root'.</entry> </row> <row id="conf-make-options"> -<entry ->make-options</entry> -<entry ->Sobrepõe-se à global</entry> -<entry ->Configure esta variável para passar as opções da linha de comando ao comando 'make'. Isto é útil para os programas, como o <ulink url="http://distcc.samba.org/" -><application ->distcc</application -></ulink ->. O <application ->distcc</application -> permite-lhe compartilhar o seu trabalho de compilação em mais de um computador. Para usá-lo, deverá usar a opção <option ->-j</option -> do 'make'. Agora você já pode. De acordo com a documentação, recomenda-se '2 * número_de_cpus_na_rede'. Eu tenho 1 CPU, assim devo usar <option ->-j2</option -> no meu caso.</entry> +<entry>make-options</entry> +<entry>Sobrepõe-se à global</entry> +<entry>Configure esta variável para passar as opções da linha de comando ao comando 'make'. Isto é útil para os programas, como o <ulink url="http://distcc.samba.org/"><application>distcc</application></ulink>. O <application>distcc</application> permite-lhe compartilhar o seu trabalho de compilação em mais de um computador. Para usá-lo, deverá usar a opção <option>-j</option> do 'make'. Agora você já pode. De acordo com a documentação, recomenda-se '2 * número_de_cpus_na_rede'. Eu tenho 1 CPU, assim devo usar <option>-j2</option> no meu caso.</entry> </row> <row id="conf-manual-build"> -<entry ->manual-build</entry> -<entry ->Sobrepõe-se à global</entry> -<entry ->Configure o valor da opção como <quote ->true</quote -> para evitar que o processo de compilação tente compilar este módulo. Ele ainda será mantido atualizado ao atualizar a partir do &svn;. Esta opção é exatamente equivalente à opção da linha de comando <link linkend="cmdline-no-build" -><option ->--no-build</option -></link ->. </entry> +<entry>manual-build</entry> +<entry>Sobrepõe-se à global</entry> +<entry>Configure o valor da opção como <quote>true</quote> para evitar que o processo de compilação tente compilar este módulo. Ele ainda será mantido atualizado ao atualizar a partir do &svn;. Esta opção é exatamente equivalente à opção da linha de comando <link linkend="cmdline-no-build"><option>--no-build</option></link>. </entry> </row> <row id="conf-manual-update"> -<entry ->manual-update</entry> -<entry ->Sobrepõe-se à global</entry> -<entry ->Configure o valor da opção como <quote ->true</quote -> para evitar que o processo de compilação tente atualizar (e, por conseguinte, compilar ou instalar) este módulo. Se definir esta opção para um módulo, também poderá tê-la comentada. </entry> +<entry>manual-update</entry> +<entry>Sobrepõe-se à global</entry> +<entry>Configure o valor da opção como <quote>true</quote> para evitar que o processo de compilação tente atualizar (e, por conseguinte, compilar ou instalar) este módulo. Se definir esta opção para um módulo, também poderá tê-la comentada. </entry> </row> <row id="conf-module-base-path"> -<entry ->module-base-path</entry> -<entry ->Sobrepõe-se à global</entry> -<entry -><para ->Configure esta opção para se sobrepor à pasta padrão do &tdesvn-build; para o módulo em questão. Isto poderá ser usado, por exemplo, para usar ramificações ou marcas específicas de determinadas bibliotecas. O <ulink url="http://websvn.kde.org/" ->Visualizador de Código do &kde;</ulink -> é extremamente valioso para ajudá-lo a escolher o local correto.</para> -<para ->Lembre-se que o &tdesvn-build; constrói o local final de acordo com o seguinte modelo: <varname ->$svn-server</varname ->/home/kde/<varname ->$module-base-path</varname ->/<varname ->$module-name</varname ->. </para> -<para ->O valor padrão tanto pode ser o <quote ->trunk</quote -> como o <quote ->trunk/KDE</quote ->, dependendo do nome do módulo.</para> +<entry>module-base-path</entry> +<entry>Sobrepõe-se à global</entry> +<entry><para>Configure esta opção para se sobrepor à pasta padrão do &tdesvn-build; para o módulo em questão. Isto poderá ser usado, por exemplo, para usar ramificações ou marcas específicas de determinadas bibliotecas. O <ulink url="http://websvn.kde.org/">Visualizador de Código do &kde;</ulink> é extremamente valioso para ajudá-lo a escolher o local correto.</para> +<para>Lembre-se que o &tdesvn-build; constrói o local final de acordo com o seguinte modelo: <varname>$svn-server</varname>/home/kde/<varname>$module-base-path</varname>/<varname>$module-name</varname>. </para> +<para>O valor padrão tanto pode ser o <quote>trunk</quote> como o <quote>trunk/KDE</quote>, dependendo do nome do módulo.</para> </entry> </row> <row id="conf-niceness"> -<entry ->niceness</entry> -<entry ->Não poderá ser sobreposta</entry> -<entry ->Configure esta opção com um valor entre 20 e 0. Quanto mais alto o número, menor prioridade terá o &tdesvn-build;. O valor padrão é 10. </entry> +<entry>niceness</entry> +<entry>Não poderá ser sobreposta</entry> +<entry>Configure esta opção com um valor entre 20 e 0. Quanto mais alto o número, menor prioridade terá o &tdesvn-build;. O valor padrão é 10. </entry> </row> <row id="conf-no-rebuild-on-fail"> -<entry ->no-rebuild-on-fail</entry> -<entry ->Sobrepõe-se à global</entry> -<entry ->Configure o valor desta opção como <quote ->true</quote -> para evitar que o &tdesvn-build; sempre tente compilar de novo este módulo, se falhar numa compilação incremental. Normalmente, o &tdesvn-build; irá tentar compilar de novo o módulo do zero, para lidar com o efeito de uma atualização do &svn; inválida que confunda o sistema de compilação.</entry> +<entry>no-rebuild-on-fail</entry> +<entry>Sobrepõe-se à global</entry> +<entry>Configure o valor desta opção como <quote>true</quote> para evitar que o &tdesvn-build; sempre tente compilar de novo este módulo, se falhar numa compilação incremental. Normalmente, o &tdesvn-build; irá tentar compilar de novo o módulo do zero, para lidar com o efeito de uma atualização do &svn; inválida que confunda o sistema de compilação.</entry> </row> <row id="conf-override-url"> -<entry ->override-url</entry> -<entry ->Sobrepõe-se à global</entry> -<entry ->Se configurar esta opção, o 'tdesvn-build' irá usar o seu valor como o URL a passar ao Subversion, <emphasis ->sem qualquer alteração</emphasis ->. Você deverá usar geralmente esta opção, se quiser obter uma versão específica, mas o 'tdesvn-build' não conseguir descobrir o que queria dizer ao usar a opção <link linkend="conf-branch" ->branch</link ->. </entry> +<entry>override-url</entry> +<entry>Sobrepõe-se à global</entry> +<entry>Se configurar esta opção, o 'tdesvn-build' irá usar o seu valor como o URL a passar ao Subversion, <emphasis>sem qualquer alteração</emphasis>. Você deverá usar geralmente esta opção, se quiser obter uma versão específica, mas o 'tdesvn-build' não conseguir descobrir o que queria dizer ao usar a opção <link linkend="conf-branch">branch</link>. </entry> </row> <row id="conf-qtdir"> -<entry ->qtdir</entry> -<entry ->Não poderá ser sobreposta</entry> -<entry ->Configure esta opção para definir a variável de ambiente QTDIR enquanto compila. Você poderá sobrepor esta configuração numa opção de um módulo. Se não indicar esta opção, será por padrão a <filename class="directory" -><varname ->$(source-dir)</varname ->/build/qt-copy</filename ->, que irá usar o módulo 'qt-copy' que está incluído no repositório de código do &kde;. Você poderá usar um til (~) que representa a sua pasta pessoal. </entry> +<entry>qtdir</entry> +<entry>Não poderá ser sobreposta</entry> +<entry>Configure esta opção para definir a variável de ambiente QTDIR enquanto compila. Você poderá sobrepor esta configuração numa opção de um módulo. Se não indicar esta opção, será por padrão a <filename class="directory"><varname>$(source-dir)</varname>/build/qt-copy</filename>, que irá usar o módulo 'qt-copy' que está incluído no repositório de código do &kde;. Você poderá usar um til (~) que representa a sua pasta pessoal. </entry> </row> <row id="conf-remove-after-install"> -<entry ->remove-after-install</entry> -<entry ->Sobrepõe-se à global</entry> -<entry -><para ->Se estiver com pouco espaço em disco, você poderá querer usar esta opção para remover automaticamente a pasta de compilação (ou as pastas de compilação e de código, para instalações episódicas), após o módulo ter sido instalado com sucesso. </para> -<para ->Os valores possíveis para esta opção são: <itemizedlist> -<listitem -><para ->none - Não remove nada (Este é o valor padrão).</para -></listitem> -<listitem -><para ->builddir - Remove a pasta de compilação, mas não o código.</para -></listitem> -<listitem -><para ->all - Remove tanto o código-fonte como a pasta de compilação.</para -></listitem> +<entry>remove-after-install</entry> +<entry>Sobrepõe-se à global</entry> +<entry><para>Se estiver com pouco espaço em disco, você poderá querer usar esta opção para remover automaticamente a pasta de compilação (ou as pastas de compilação e de código, para instalações episódicas), após o módulo ter sido instalado com sucesso. </para> +<para>Os valores possíveis para esta opção são: <itemizedlist> +<listitem><para>none - Não remove nada (Este é o valor padrão).</para></listitem> +<listitem><para>builddir - Remove a pasta de compilação, mas não o código.</para></listitem> +<listitem><para>all - Remove tanto o código-fonte como a pasta de compilação.</para></listitem> </itemizedlist> </para> -<para ->Lembre-se que a utilização desta opção poderá ter um grande impacto na utilização da sua largura de banda (se usar o 'all') e o tempo que dura a compilação do KDE, uma vez que o 'tdesvn-build' será incapaz de efetuar compilações incrementais.</para> +<para>Lembre-se que a utilização desta opção poderá ter um grande impacto na utilização da sua largura de banda (se usar o 'all') e o tempo que dura a compilação do KDE, uma vez que o 'tdesvn-build' será incapaz de efetuar compilações incrementais.</para> </entry> </row> <row id="conf-set-env"> -<entry ->set-env</entry> -<entry ->Sobrepõe-se à global</entry> -<entry -><para ->Esta opção aceita um conjunto de valores separados por espaços, onde o primeiro valor é a variável de ambiente a definir e o resto dos valores é o que deseja atribuir à sua variável. Por exemplo, para configurar a variável RONALD como McDonald, você deve colocar este comando na seção apropriada:</para> -<screen -><command ->set-env</command -> <envar ->RONALD</envar -> <userinput ->McDonald</userinput -></screen> -<para ->Esta opção é especial, na medida em que poderá ser repetida sem sobrepor a configuração anterior do 'set-env' na mesma seção do arquivo de configuração. Desta forma, você poderá definir mais de uma variável de ambiente por módulo (ou a nível global).</para> +<entry>set-env</entry> +<entry>Sobrepõe-se à global</entry> +<entry><para>Esta opção aceita um conjunto de valores separados por espaços, onde o primeiro valor é a variável de ambiente a definir e o resto dos valores é o que deseja atribuir à sua variável. Por exemplo, para configurar a variável RONALD como McDonald, você deve colocar este comando na seção apropriada:</para> +<screen><command>set-env</command> <envar>RONALD</envar> <userinput>McDonald</userinput></screen> +<para>Esta opção é especial, na medida em que poderá ser repetida sem sobrepor a configuração anterior do 'set-env' na mesma seção do arquivo de configuração. Desta forma, você poderá definir mais de uma variável de ambiente por módulo (ou a nível global).</para> </entry> </row> <row id="conf-source-dir"> -<entry ->source-dir</entry> -<entry ->Não poderá ser sobreposta</entry> -<entry ->Esta opção é usada para definir a pasta do seu computador onde será guardado o código-fonte do &svn; do &kde;. Se não indicar este valor, será usado o valor padrão <filename class="directory" ->~/tdesvn</filename ->. Se você especificar este valor, use um local absoluto. </entry> +<entry>source-dir</entry> +<entry>Não poderá ser sobreposta</entry> +<entry>Esta opção é usada para definir a pasta do seu computador onde será guardado o código-fonte do &svn; do &kde;. Se não indicar este valor, será usado o valor padrão <filename class="directory">~/tdesvn</filename>. Se você especificar este valor, use um local absoluto. </entry> </row> <row id="conf-svn-server"> -<entry ->svn-server</entry> -<entry ->Não poderá ser sobreposta</entry> -<entry ->Esta opção é usada para definir o servidor usado para obter o código do &svn;. Por padrão, é usado o repositório anónimo de &svn;, em <emphasis ->svn://anonsvn.kde.org/</emphasis -></entry> +<entry>svn-server</entry> +<entry>Não poderá ser sobreposta</entry> +<entry>Esta opção é usada para definir o servidor usado para obter o código do &svn;. Por padrão, é usado o repositório anónimo de &svn;, em <emphasis>svn://anonsvn.kde.org/</emphasis></entry> </row> <row id="conf-stop-on-failure"> -<entry ->stop-on-failure</entry> -<entry ->Sobrepõe-se à global</entry> -<entry ->Configure o valor desta opção como <quote ->true</quote -> para fazer com que o programa pare a execução, após ocorrer um erro durante o processo de compilação ou instalação. Esta opção está desativada por padrão. </entry> +<entry>stop-on-failure</entry> +<entry>Sobrepõe-se à global</entry> +<entry>Configure o valor desta opção como <quote>true</quote> para fazer com que o programa pare a execução, após ocorrer um erro durante o processo de compilação ou instalação. Esta opção está desativada por padrão. </entry> </row> <row id="conf-tag"> -<entry ->tag</entry> -<entry ->Sobrepõe-se à global</entry> -<entry -><para ->Use esta opção para obter uma versão específica de um módulo.</para> -<para -><emphasis ->NOTA:</emphasis -> É muito provável que você NÃO QUEIRA usar esta opção. As versões do KDE lançadas estão disponíveis em pacotes compactados no <ulink url="ftp://ftp.kde.org/" ->servidor de FTP do KDE</ulink -> ou em um dos servidores <ulink url="http://download.kde.org/download.php" ->espelho</ulink ->.</para> -<para ->Se você estiver usando o 'tdesvn-build' porque está com problemas para obter uma versão do KDE para compilar na sua distribuição, pense em usar a <ulink url="http://developer.kde.org/build/konstruct/" ->ferramenta de compilação Konstruct</ulink -> em alternativa, que funciona a partir dos pacotes de lançamento.</para> +<entry>tag</entry> +<entry>Sobrepõe-se à global</entry> +<entry><para>Use esta opção para obter uma versão específica de um módulo.</para> +<para><emphasis>NOTA:</emphasis> É muito provável que você NÃO QUEIRA usar esta opção. As versões do KDE lançadas estão disponíveis em pacotes compactados no <ulink url="ftp://ftp.kde.org/">servidor de FTP do KDE</ulink> ou em um dos servidores <ulink url="http://download.kde.org/download.php">espelho</ulink>.</para> +<para>Se você estiver usando o 'tdesvn-build' porque está com problemas para obter uma versão do KDE para compilar na sua distribuição, pense em usar a <ulink url="http://developer.kde.org/build/konstruct/">ferramenta de compilação Konstruct</ulink> em alternativa, que funciona a partir dos pacotes de lançamento.</para> </entry> </row> <row id="conf-use-qt-builddir-hack"> -<entry ->use-qt-builddir-hack</entry> -<entry ->Sobrepõe-se à global</entry> -<entry ->Ainda que esta opção se sobreponha à global, só fará sentido para o 'qt-copy'. Configure esta opção como <quote ->true</quote -> para ativar o modo <emphasis ->experimental</emphasis -> de 'srcdir' != 'builddir'. Se estiver ativada, o &tdesvn-build; irá copiar o módulo de código do 'qt-copy' para a pasta de compilação e efetuar as compilações a partir daí. Isto significa que a sua variável de ambiente QTDIR ficará igual a <filename class="directory" ->$(qt-copy-build-dir)/qt-copy/lib</filename -> em alternativa. Você deverá também mudar a sua opção <link linkend="conf-qtdir" ->qtdir</link -> em função disso. O 'make' incremental deverá ainda funcionar neste modo, uma vez que as datas serão preservadas após a cópia. Se usar a opção <link linkend="conf-apply-qt-patches" ->apply-qt-patches</link ->, as atualizações serão aplicadas na pasta de compilação, não na pasta de código. Esta opção é igual a <quote ->true</quote ->, por padrão. </entry> +<entry>use-qt-builddir-hack</entry> +<entry>Sobrepõe-se à global</entry> +<entry>Ainda que esta opção se sobreponha à global, só fará sentido para o 'qt-copy'. Configure esta opção como <quote>true</quote> para ativar o modo <emphasis>experimental</emphasis> de 'srcdir' != 'builddir'. Se estiver ativada, o &tdesvn-build; irá copiar o módulo de código do 'qt-copy' para a pasta de compilação e efetuar as compilações a partir daí. Isto significa que a sua variável de ambiente QTDIR ficará igual a <filename class="directory">$(qt-copy-build-dir)/qt-copy/lib</filename> em alternativa. Você deverá também mudar a sua opção <link linkend="conf-qtdir">qtdir</link> em função disso. O 'make' incremental deverá ainda funcionar neste modo, uma vez que as datas serão preservadas após a cópia. Se usar a opção <link linkend="conf-apply-qt-patches">apply-qt-patches</link>, as atualizações serão aplicadas na pasta de compilação, não na pasta de código. Esta opção é igual a <quote>true</quote>, por padrão. </entry> </row> <row id="conf-use-unsermake"> -<entry ->use-unsermake</entry> -<entry ->Sobrepõe-se à global</entry> -<entry -><para ->Configure esta opção como <quote ->true</quote -> para poder usar o programa experimental 'unsermake' em vez do 'automake' ao rodar o programa 'configure'. Isto poderá levar a uma diminuição significativa no tempo da compilação, principalmente no caso dos <ulink url="http://www.csh.rit.edu/slashdot/distcc.html" ->sistemas de compilação distribuídos</ulink ->. Esta opção é, por padrão, <quote ->true</quote -> (para a maioria dos módulos). </para> - -<para ->Normalmente, se usar esta opção, o 'tdesvn-build' irá manter automaticamente o 'unsermake' atualizado. Isto poderá começar a ser incómodo, principalmente se estiver gerenciando você mesmo o 'unsermake'. Se for este o caso, você poderá configurar esta opção como <quote ->self</quote ->, fazendo com que o 'tdesvn-build' ainda use o 'unsermake', mas não faça nada de especial para mantê-lo atualizado. </para> +<entry>use-unsermake</entry> +<entry>Sobrepõe-se à global</entry> +<entry><para>Configure esta opção como <quote>true</quote> para poder usar o programa experimental 'unsermake' em vez do 'automake' ao rodar o programa 'configure'. Isto poderá levar a uma diminuição significativa no tempo da compilação, principalmente no caso dos <ulink url="http://www.csh.rit.edu/slashdot/distcc.html">sistemas de compilação distribuídos</ulink>. Esta opção é, por padrão, <quote>true</quote> (para a maioria dos módulos). </para> + +<para>Normalmente, se usar esta opção, o 'tdesvn-build' irá manter automaticamente o 'unsermake' atualizado. Isto poderá começar a ser incómodo, principalmente se estiver gerenciando você mesmo o 'unsermake'. Se for este o caso, você poderá configurar esta opção como <quote>self</quote>, fazendo com que o 'tdesvn-build' ainda use o 'unsermake', mas não faça nada de especial para mantê-lo atualizado. </para> </entry> </row> @@ -1343,383 +579,161 @@ end module </chapter> <chapter id="cmdline"> -<title ->Opções da Linha de Comando e Variáveis de Ambiente</title> +<title>Opções da Linha de Comando e Variáveis de Ambiente</title> -<para ->Este programa não usa variáveis de ambiente. Se você precisar definir variáveis de ambiente para o ambiente de compilação ou de instalação, veja a opção <link linkend="conf-set-env" ->set-env</link ->. </para> +<para>Este programa não usa variáveis de ambiente. Se você precisar definir variáveis de ambiente para o ambiente de compilação ou de instalação, veja a opção <link linkend="conf-set-env">set-env</link>. </para> -<para ->O programa aceita as seguintes opções da linha de comando: </para> +<para>O programa aceita as seguintes opções da linha de comando: </para> <variablelist> <varlistentry id="cmdline-help"> -<term -><option ->--help</option -></term> -<listitem -><para ->mostra apenas uma ajuda simples deste programa. </para -></listitem> +<term><option>--help</option></term> +<listitem><para>mostra apenas uma ajuda simples deste programa. </para></listitem> </varlistentry> <varlistentry id="cmdline-version"> -<term -><option ->--version</option -></term> -<listitem -><para ->mostra a versão do programa. </para -></listitem> +<term><option>--version</option></term> +<listitem><para>mostra a versão do programa. </para></listitem> </varlistentry> <varlistentry id="cmdline-author"> -<term -><option ->--author</option -></term> -<listitem -><para ->mostra as informações de contato do autor. </para -></listitem> +<term><option>--author</option></term> +<listitem><para>mostra as informações de contato do autor. </para></listitem> </varlistentry> <varlistentry id="cmdline-color"> -<term -><option ->--color</option -></term> -<listitem -><para ->ativa o resultado do programa à cores. </para -></listitem> +<term><option>--color</option></term> +<listitem><para>ativa o resultado do programa à cores. </para></listitem> </varlistentry> <varlistentry id="cmdline-no-color"> -<term -><option ->--no-color</option -></term> -<listitem -><para ->desativa o resultado do programa à cores. </para -></listitem> +<term><option>--no-color</option></term> +<listitem><para>desativa o resultado do programa à cores. </para></listitem> </varlistentry> <varlistentry id="cmdline-pretend"> -<term -><option ->--pretend</option -> (ou <option ->-p</option ->)</term> -<listitem -><para ->não faz NADA de fato, mas funciona como se você fizesse. </para -></listitem> +<term><option>--pretend</option> (ou <option>-p</option>)</term> +<listitem><para>não faz NADA de fato, mas funciona como se você fizesse. </para></listitem> </varlistentry> <varlistentry id="cmdline-quiet"> -<term -><option ->--quiet</option -> (ou <option ->-q</option ->)</term> -<listitem -><para ->Não é tão descritivo com o resultado exibido pela compilação. Com esta opção, somente as mensagens básicas são apresentadas. </para -></listitem> +<term><option>--quiet</option> (ou <option>-q</option>)</term> +<listitem><para>Não é tão descritivo com o resultado exibido pela compilação. Com esta opção, somente as mensagens básicas são apresentadas. </para></listitem> </varlistentry> <varlistentry id="cmdline-really-quiet"> -<term -><option ->--really-quiet</option -></term> -<listitem -><para ->Só mostra as mensagens de avisos e erros. </para -></listitem> +<term><option>--really-quiet</option></term> +<listitem><para>Só mostra as mensagens de avisos e erros. </para></listitem> </varlistentry> <varlistentry id="cmdline-verbose"> -<term -><option ->--verbose</option -></term> -<listitem -><para ->Torna-se bastante descritivo com o que está acontecendo e o que o 'tdesvn-build' está fazendo. </para -></listitem> +<term><option>--verbose</option></term> +<listitem><para>Torna-se bastante descritivo com o que está acontecendo e o que o 'tdesvn-build' está fazendo. </para></listitem> </varlistentry> <varlistentry id="cmdline-svn-only"> -<term -><option ->--svn-only</option -></term> -<listitem -><para ->efetua apenas a atualização do código. </para -></listitem> +<term><option>--svn-only</option></term> +<listitem><para>efetua apenas a atualização do código. </para></listitem> </varlistentry> <varlistentry id="cmdline-build-only"> -<term -><option ->--build-only</option -></term> -<listitem -><para ->efetua apenas o processo de compilação. </para -></listitem> +<term><option>--build-only</option></term> +<listitem><para>efetua apenas o processo de compilação. </para></listitem> </varlistentry> <varlistentry id="cmdline-ignore-modules"> -<term -><option ->--ignore-modules</option -></term> -<listitem -><para ->não inclui os módulos passados no resto da linha de comando no processo de atualização/compilação. </para -></listitem> +<term><option>--ignore-modules</option></term> +<listitem><para>não inclui os módulos passados no resto da linha de comando no processo de atualização/compilação. </para></listitem> </varlistentry> <varlistentry id="cmdline-no-svn"> -<term -><option ->--no-svn</option -></term> -<listitem -><para ->ignora o passo de contacto do servidor do &svn;. </para -></listitem> +<term><option>--no-svn</option></term> +<listitem><para>ignora o passo de contacto do servidor do &svn;. </para></listitem> </varlistentry> <varlistentry id="cmdline-no-build"> -<term -><option ->--no-build</option -></term> -<listitem -><para ->salta o processo de compilação. </para -></listitem> +<term><option>--no-build</option></term> +<listitem><para>salta o processo de compilação. </para></listitem> </varlistentry> <varlistentry id="cmdline-no-install"> -<term -><option ->--no-install</option -></term> -<listitem -><para ->não instala automaticamente os pacotes, após a sua compilação. </para -></listitem> +<term><option>--no-install</option></term> +<listitem><para>não instala automaticamente os pacotes, após a sua compilação. </para></listitem> </varlistentry> <varlistentry id="cmdline-debug"> -<term -><option ->--debug</option -></term> -<listitem -><para ->ativa o modo de depuração para o programa. Atualmente, isto significa que todo o resultado será enviado para o STDOUT, além de ficar registrado na pasta de registro normalmente. Do mesmo modo, muitas das funções tornar-se-ão mais descritivas sobre o que estão fazendo no modo de depuração. </para -></listitem> +<term><option>--debug</option></term> +<listitem><para>ativa o modo de depuração para o programa. Atualmente, isto significa que todo o resultado será enviado para o STDOUT, além de ficar registrado na pasta de registro normalmente. Do mesmo modo, muitas das funções tornar-se-ão mais descritivas sobre o que estão fazendo no modo de depuração. </para></listitem> </varlistentry> <varlistentry id="cmdline-no-rebuild-on-fail"> -<term -><option ->--no-rebuild-on-fail</option -></term> -<listitem -><para ->não tenta compilar de novo os módulos que não conseguiram ser compilados do zero. O &tdesvn-build; nunca irá tentar fazer isto num módulo que já se tentou compilar do zero. </para -></listitem> +<term><option>--no-rebuild-on-fail</option></term> +<listitem><para>não tenta compilar de novo os módulos que não conseguiram ser compilados do zero. O &tdesvn-build; nunca irá tentar fazer isto num módulo que já se tentou compilar do zero. </para></listitem> </varlistentry> <varlistentry id="cmdline-refresh-build"> -<term -><option ->--refresh-build</option -></term> -<listitem -><para ->recria o sistema de compilação e compila a partir do zero. </para -></listitem> +<term><option>--refresh-build</option></term> +<listitem><para>recria o sistema de compilação e compila a partir do zero. </para></listitem> </varlistentry> <varlistentry id="cmdline-reconfigure"> -<term -><option ->--reconfigure</option -></term> -<listitem -><para ->executa o programa 'configure' novamente sem limpar a pasta de compilação. </para -></listitem> +<term><option>--reconfigure</option></term> +<listitem><para>executa o programa 'configure' novamente sem limpar a pasta de compilação. </para></listitem> </varlistentry> <varlistentry id="cmdline-recreate-configure"> -<term -><option ->--recreate-configure</option -></term> -<listitem -><para ->executa o <command ->make <option ->-f</option -> Makefile.cvs</command -> novamente para criar o programa 'configure' e continua a compilação normalmente. Esta opção implica a <option -><link linkend="cmdline-reconfigure" ->--reconfigure</link -></option ->. </para -></listitem> +<term><option>--recreate-configure</option></term> +<listitem><para>executa o <command>make <option>-f</option> Makefile.cvs</command> novamente para criar o programa 'configure' e continua a compilação normalmente. Esta opção implica a <option><link linkend="cmdline-reconfigure">--reconfigure</link></option>. </para></listitem> </varlistentry> <varlistentry id="cmdline-resume"> -<term -><option ->--resume</option -></term> -<listitem -><para ->tenta continuar a compilação a partir do ponto em que o programa parou da última vez. O programa começa a compilar o módulo, após o último ter sido compilado da última vez em que o programa foi executado, quer tenha corrido bem ou não. Esta opção implica a <link linkend="cmdline-no-svn" -><option ->--no-svn</option -></link ->. Você não deverá indicar os nomes de outros módulos na linha de comando. </para -></listitem> +<term><option>--resume</option></term> +<listitem><para>tenta continuar a compilação a partir do ponto em que o programa parou da última vez. O programa começa a compilar o módulo, após o último ter sido compilado da última vez em que o programa foi executado, quer tenha corrido bem ou não. Esta opção implica a <link linkend="cmdline-no-svn"><option>--no-svn</option></link>. Você não deverá indicar os nomes de outros módulos na linha de comando. </para></listitem> </varlistentry> <varlistentry id="cmdline-resume-from"> -<term -><option ->--resume-from</option -></term> -<listitem -><para ->é semelhante à opção <link linkend="cmdline-resume" -><option ->--resume</option -></link ->, exceto que você indica qual o módulo de onde começar a compilação como parâmetro a seguir na linha de comando. Esta opção implica a <link linkend="cmdline-no-svn" -><option ->--no-svn</option -></link ->. Você não deverá indicar os nomes dos outros módulos na linha de comando. </para -></listitem> +<term><option>--resume-from</option></term> +<listitem><para>é semelhante à opção <link linkend="cmdline-resume"><option>--resume</option></link>, exceto que você indica qual o módulo de onde começar a compilação como parâmetro a seguir na linha de comando. Esta opção implica a <link linkend="cmdline-no-svn"><option>--no-svn</option></link>. Você não deverá indicar os nomes dos outros módulos na linha de comando. </para></listitem> </varlistentry> <varlistentry id="cmdline-rc-file"> -<term -><option ->--rc-file</option -></term> -<listitem -><para ->interpreta o próximo parâmetro da linha de comando como o arquivo de onde ler as opções de configuração. O valor padrão deste parâmetro é '~/.tdesvn-buildrc'. </para -></listitem> +<term><option>--rc-file</option></term> +<listitem><para>interpreta o próximo parâmetro da linha de comando como o arquivo de onde ler as opções de configuração. O valor padrão deste parâmetro é '~/.tdesvn-buildrc'. </para></listitem> </varlistentry> <varlistentry id="cmdline-prefix"> -<term -><option ->--prefix=</localização/do/kde></option -></term> -<listitem -><para ->permite-lhe mudar a pasta onde o &kde; será instalado na linha de comando. Esta opção implica a <link linkend="cmdline-reconfigure" -><option ->--reconfigure</option -></link ->. </para -></listitem> +<term><option>--prefix=</localização/do/kde></option></term> +<listitem><para>permite-lhe mudar a pasta onde o &kde; será instalado na linha de comando. Esta opção implica a <link linkend="cmdline-reconfigure"><option>--reconfigure</option></link>. </para></listitem> </varlistentry> <varlistentry id="cmdline-build-system-only"> -<term -><option ->--build-system-only</option -></term> -<listitem -><para ->pára após a execução do <command ->make <option ->-f</option -> Makefile.cvs</command ->. O programa 'configure' precisará ainda ser executado, coisa que o &tdesvn-build; irá fazer da próxima vez. Isto permite-lhe preparar todos os programas 'configure' de uma vez, para que você possa ver o <command ->./configure <option ->--help</option -></command -> de cada módulo e editar as suas opções do 'configure' adequadamente. </para -></listitem> +<term><option>--build-system-only</option></term> +<listitem><para>pára após a execução do <command>make <option>-f</option> Makefile.cvs</command>. O programa 'configure' precisará ainda ser executado, coisa que o &tdesvn-build; irá fazer da próxima vez. Isto permite-lhe preparar todos os programas 'configure' de uma vez, para que você possa ver o <command>./configure <option>--help</option></command> de cada módulo e editar as suas opções do 'configure' adequadamente. </para></listitem> </varlistentry> -<varlistentry id="cmdline-install" -><term -><option ->--install</option -></term> -<listitem -><para ->Se esta for a única opção da linha de comando, ele irá tentar instalar todos os módulo incluídos em 'successfully-built', exceto o 'qt-copy', que não precisa de instalação. Se as opções da linha de comando forem indicadas após o <option ->--install</option ->, então assumem-se que são módulos para instalar. </para -></listitem> +<varlistentry id="cmdline-install"><term><option>--install</option></term> +<listitem><para>Se esta for a única opção da linha de comando, ele irá tentar instalar todos os módulo incluídos em 'successfully-built', exceto o 'qt-copy', que não precisa de instalação. Se as opções da linha de comando forem indicadas após o <option>--install</option>, então assumem-se que são módulos para instalar. </para></listitem> </varlistentry> <varlistentry id="cmdline-global-option"> -<term -><option ->--<nome-da-opção>=</option -></term> -<listitem -><para ->Você poderá usar esta opção para sobrepor outra opção no seu arquivo de configuração para todos os módulos. Por exemplo, para sobrepor a opção <link linkend="conf-log-dir" ->log-dir</link ->, deverá digitar: <option ->--log-dir=/local/da/pasta</option ->. </para -></listitem> +<term><option>--<nome-da-opção>=</option></term> +<listitem><para>Você poderá usar esta opção para sobrepor outra opção no seu arquivo de configuração para todos os módulos. Por exemplo, para sobrepor a opção <link linkend="conf-log-dir">log-dir</link>, deverá digitar: <option>--log-dir=/local/da/pasta</option>. </para></listitem> </varlistentry> <varlistentry id="cmdline-module-option"> -<term -><option ->--<nome-módulo>,<nome-opção>=</option -></term> -<listitem -><para ->Você poderá usar esta opção para sobrepor uma opção do seu arquivo de configuração para um determinado módulo. Por exemplo, para sobrepor a opção <link linkend="conf-use-unsermake" ->use-unsermake</link -> do 'tdemultimedia', você deveria digitar: <option ->--tdemultimedia,use-unsermake=false</option ->. </para -></listitem> +<term><option>--<nome-módulo>,<nome-opção>=</option></term> +<listitem><para>Você poderá usar esta opção para sobrepor uma opção do seu arquivo de configuração para um determinado módulo. Por exemplo, para sobrepor a opção <link linkend="conf-use-unsermake">use-unsermake</link> do 'tdemultimedia', você deveria digitar: <option>--tdemultimedia,use-unsermake=false</option>. </para></listitem> </varlistentry> </variablelist> -<para ->Todas as outras opções da linha de comando assumem-se como sendo módulos para atualizar e compilar. Por favor, não misture a compilação com a instalação. </para> +<para>Todas as outras opções da linha de comando assumem-se como sendo módulos para atualizar e compilar. Por favor, não misture a compilação com a instalação. </para> </chapter> <chapter id="credits-and-licenses"> -<title ->Créditos e Licenças</title> +<title>Créditos e Licenças</title> &underFDL; </chapter> </book> diff --git a/tde-i18n-pt_BR/docs/tdesdk/tdecachegrind/index.docbook b/tde-i18n-pt_BR/docs/tdesdk/tdecachegrind/index.docbook index fcb3a7bd5b7..3f2857ad99e 100644 --- a/tde-i18n-pt_BR/docs/tdesdk/tdecachegrind/index.docbook +++ b/tde-i18n-pt_BR/docs/tdesdk/tdecachegrind/index.docbook @@ -1,23 +1,11 @@ <?xml version="1.0" ?> <!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [ - <!ENTITY tdecachegrind '<application ->KCachegrind</application ->'> - <!ENTITY cachegrind "<application ->Cachegrind</application ->"> - <!ENTITY calltree "<application ->Calltree</application ->"> - <!ENTITY callgrind "<application ->Callgrind</application ->"> - <!ENTITY valgrind "<application ->Valgrind</application ->"> - <!ENTITY oprofile "<application ->OProfile</application ->"> + <!ENTITY tdecachegrind '<application>KCachegrind</application>'> + <!ENTITY cachegrind "<application>Cachegrind</application>"> + <!ENTITY calltree "<application>Calltree</application>"> + <!ENTITY callgrind "<application>Callgrind</application>"> + <!ENTITY valgrind "<application>Valgrind</application>"> + <!ENTITY oprofile "<application>OProfile</application>"> <!ENTITY kappname "&tdecachegrind;"> <!ENTITY package "tdesdk"> <!ENTITY % addindex "IGNORE"> @@ -29,167 +17,96 @@ <book lang="&language;"> <bookinfo> -<title ->O Manual do &tdecachegrind;</title> +<title>O Manual do &tdecachegrind;</title> <authorgroup> -<author -><firstname ->Josef</firstname -> <surname ->Weidendorfer</surname -> <affiliation -> <address -><email ->Josef.Weidendorfer@gmx.de</email -></address> +<author><firstname>Josef</firstname> <surname>Weidendorfer</surname> <affiliation> <address><email>Josef.Weidendorfer@gmx.de</email></address> </affiliation> </author> -<othercredit role="translator" -><firstname ->Marcus</firstname -><surname ->Gama</surname -><affiliation -><address -><email ->marcus.gama@gmail.com</email -></address -></affiliation -><contrib ->Tradução</contrib -></othercredit -> +<othercredit role="translator"><firstname>Marcus</firstname><surname>Gama</surname><affiliation><address><email>marcus.gama@gmail.com</email></address></affiliation><contrib>Tradução</contrib></othercredit> </authorgroup> <copyright> -<year ->2002-2004</year> -<holder ->Josef Weidendorfer</holder> +<year>2002-2004</year> +<holder>Josef Weidendorfer</holder> </copyright> -<legalnotice ->&FDLNotice;</legalnotice> +<legalnotice>&FDLNotice;</legalnotice> -<date ->2004-07-27</date> -<releaseinfo ->0.4.6</releaseinfo> +<date>2004-07-27</date> +<releaseinfo>0.4.6</releaseinfo> <abstract> -<para ->O &tdecachegrind; é uma ferramenta de visualização de dados de auditoria, escrito usando o ambiente &kde;. </para> +<para>O &tdecachegrind; é uma ferramenta de visualização de dados de auditoria, escrito usando o ambiente &kde;. </para> </abstract> <keywordset> -<keyword ->KDE</keyword> -<keyword ->tdesdk</keyword> -<keyword ->Cachegrind</keyword> -<keyword ->Callgrind</keyword> -<keyword ->Valgrind</keyword> -<keyword ->Auditoria</keyword> +<keyword>KDE</keyword> +<keyword>tdesdk</keyword> +<keyword>Cachegrind</keyword> +<keyword>Callgrind</keyword> +<keyword>Valgrind</keyword> +<keyword>Auditoria</keyword> </keywordset> </bookinfo> <chapter id="introduction"> -<title ->Introdução</title> +<title>Introdução</title> -<para ->O &kappname; é um navegador para dados produzidos por ferramentas de auditoria. Este capítulo esclarece para que serve um auditoria, como ela é feita, e fornece alguns exemplos de ferramentas de auditoria disponíveis. </para> +<para>O &kappname; é um navegador para dados produzidos por ferramentas de auditoria. Este capítulo esclarece para que serve um auditoria, como ela é feita, e fornece alguns exemplos de ferramentas de auditoria disponíveis. </para> <sect1 id="introduction-profiling"> -<title ->Auditoria</title> +<title>Auditoria</title> -<para ->Quando você desenvolve um programa, um dos últimos passos muitas vezes envolve otimizações de desempenho. Como não faz sentido otimizar funções raramente usada, uma vez que elas não consumirão muito tempo de execução, você precisa saber em qual parte do seu programa a maior parte do tempo é consumido. </para> +<para>Quando você desenvolve um programa, um dos últimos passos muitas vezes envolve otimizações de desempenho. Como não faz sentido otimizar funções raramente usada, uma vez que elas não consumirão muito tempo de execução, você precisa saber em qual parte do seu programa a maior parte do tempo é consumido. </para> -<para ->Para um código sequencial, coletar dados estatísticos das características em tempo de execução como a quantidade de tempo gasto nas funções e linhas de código normalmente é o suficiente. Isto é chamado Auditoria. O programa é executado sob controle de uma ferramenta de auditoria, que fornece um resumo de um execução ao final dela. Em contraste, para código paralelo, problemas de desempenho tipicamente são causados quando um processamento está esperando por dados de outro. Como este tempo de espera normalmente não pode ser facilmente atribuído, aqui é melhor gerar uma trilha de eventos ocorridos na linha de tempo. O KCachegrind não pode visualizar este tipo de dado. </para> +<para>Para um código sequencial, coletar dados estatísticos das características em tempo de execução como a quantidade de tempo gasto nas funções e linhas de código normalmente é o suficiente. Isto é chamado Auditoria. O programa é executado sob controle de uma ferramenta de auditoria, que fornece um resumo de um execução ao final dela. Em contraste, para código paralelo, problemas de desempenho tipicamente são causados quando um processamento está esperando por dados de outro. Como este tempo de espera normalmente não pode ser facilmente atribuído, aqui é melhor gerar uma trilha de eventos ocorridos na linha de tempo. O KCachegrind não pode visualizar este tipo de dado. </para> -<para ->Após analisar os dados da auditoria produzida, deve ser fácil ver os trechos mais importantes e pontos de estrangulamento do código. Por exemplo, suposições sobre a contagem de chamadas podem ser verificadas, e identificadas regiões do código que pode ser otimizadas. Além disso, sucesso da otimização pode ser verificado novamente com a execução de outra auditoria. </para> +<para>Após analisar os dados da auditoria produzida, deve ser fácil ver os trechos mais importantes e pontos de estrangulamento do código. Por exemplo, suposições sobre a contagem de chamadas podem ser verificadas, e identificadas regiões do código que pode ser otimizadas. Além disso, sucesso da otimização pode ser verificado novamente com a execução de outra auditoria. </para> </sect1> <sect1 id="introduction-methods"> -<title ->Métodos de Auditoria</title> +<title>Métodos de Auditoria</title> -<para ->A medida exata do tempo decorrido ou de eventos ocorridos na execução de uma região do código (por exemplo uma função) necessida que código adicional para medidas seja inserido antes a após da referida região. Este código cronometra o tempo ou conta a ocorrência de um evento, e calcula a diferença. Assim, o código original teve que ser mudado antes da execução. Isto é chamado instrumentação. A instrumentação pode ser feita pelo próprio programador, pelo compilador ou pelo sistema em tempo de execução. Como as regiões de interesse normalmente estão aninhadas, o cômputo geral da medida sempre influencia a medida em si. Assim, a instrumentação deve ser feita seletivamente e os resultados devem ser interpretados com cuidado. É claro, isto torna a análise do desempenho por medidas exatas um processo muito complexo.</para> +<para>A medida exata do tempo decorrido ou de eventos ocorridos na execução de uma região do código (por exemplo uma função) necessida que código adicional para medidas seja inserido antes a após da referida região. Este código cronometra o tempo ou conta a ocorrência de um evento, e calcula a diferença. Assim, o código original teve que ser mudado antes da execução. Isto é chamado instrumentação. A instrumentação pode ser feita pelo próprio programador, pelo compilador ou pelo sistema em tempo de execução. Como as regiões de interesse normalmente estão aninhadas, o cômputo geral da medida sempre influencia a medida em si. Assim, a instrumentação deve ser feita seletivamente e os resultados devem ser interpretados com cuidado. É claro, isto torna a análise do desempenho por medidas exatas um processo muito complexo.</para> -<para ->A medição exata é possível em função os contadores de hardware (incluindo contadores incrementados em um tique de tempo) fornecidos nos processadores modernos, que são incrementados sempre que um evento acontece. Como nós desejamos atribuir eventos para regiões de código, sem os contadores, nós teríamos que manipular cada evento incrementando um contador para a região de código atual por nós mesmos. Fazer isto no software é claramente impossível; mas na suposição que a distribuição do evento pelo código fonte é semelhante quando procuramos somente a cada enésimo evento ao invés de evento por evento, nós construímos um método de medição que é ajustável em função do todo. Isto é chamado Amostragem. Amostragem Baseada em Tempo (do inglês TBS) é feita usando um temporizador que regularmente verifica o contador do programa para criar um histograma ao longo do código do programa. Amostragem Baseada em Evento (do inglês EBS) é feita aproveitando os contadores de hardware dos modernos processadores, e é feita usando um modo onde um manipulador de interrupção é chamado em um contador abaixo do fluxo, gerando um histograma da distribuição do evento correspondente. No manipulador, o contador do evento está sempre reinicializado para o 'n' do método de amostragem. A vantagem da amostragem é que o código não precisa ser mudado, mas ela ainda deve atentar para uma restrição: a suposição acima será mais correta se n for pequeno, mas quanto menor o n, maior o todo do manipulador de interrupção.</para> +<para>A medição exata é possível em função os contadores de hardware (incluindo contadores incrementados em um tique de tempo) fornecidos nos processadores modernos, que são incrementados sempre que um evento acontece. Como nós desejamos atribuir eventos para regiões de código, sem os contadores, nós teríamos que manipular cada evento incrementando um contador para a região de código atual por nós mesmos. Fazer isto no software é claramente impossível; mas na suposição que a distribuição do evento pelo código fonte é semelhante quando procuramos somente a cada enésimo evento ao invés de evento por evento, nós construímos um método de medição que é ajustável em função do todo. Isto é chamado Amostragem. Amostragem Baseada em Tempo (do inglês TBS) é feita usando um temporizador que regularmente verifica o contador do programa para criar um histograma ao longo do código do programa. Amostragem Baseada em Evento (do inglês EBS) é feita aproveitando os contadores de hardware dos modernos processadores, e é feita usando um modo onde um manipulador de interrupção é chamado em um contador abaixo do fluxo, gerando um histograma da distribuição do evento correspondente. No manipulador, o contador do evento está sempre reinicializado para o 'n' do método de amostragem. A vantagem da amostragem é que o código não precisa ser mudado, mas ela ainda deve atentar para uma restrição: a suposição acima será mais correta se n for pequeno, mas quanto menor o n, maior o todo do manipulador de interrupção.</para> -<para ->Outro método de medição é simular coisas acontecendo no sistema do computador ao executar o código fornecido, isto é, executar uma simulação dirigida. A simulação é sempre derivada a partir mais ou menos da precisão do modelo da máquina. No entanto, com modelos mais detalhados que se aproximem bastante da realidade, o tempo de simulação pode ser inaceitavelmente alto na prática. A vantagem é que a arbitrária e complexa medição/simulação do código pode ser inserida em um código sem distorçer os resultados. Fazer isto diretamente antes da execução (chamada instrumentação em tempo de execução), usando o binário original, é muito confortável para o usuário: nenhuma recompilação é necessária. O método se torna usável quando simulamos somente partes de uma máquina com um modelo simples. Além disso, resultados produzidos por modelos simples frequentemente são mais fáceis de entender: o problema com o hardware real é que frequentemente estes resultados incluem efeitos de sobreposição das diferentes partes da máquina.</para> +<para>Outro método de medição é simular coisas acontecendo no sistema do computador ao executar o código fornecido, isto é, executar uma simulação dirigida. A simulação é sempre derivada a partir mais ou menos da precisão do modelo da máquina. No entanto, com modelos mais detalhados que se aproximem bastante da realidade, o tempo de simulação pode ser inaceitavelmente alto na prática. A vantagem é que a arbitrária e complexa medição/simulação do código pode ser inserida em um código sem distorçer os resultados. Fazer isto diretamente antes da execução (chamada instrumentação em tempo de execução), usando o binário original, é muito confortável para o usuário: nenhuma recompilação é necessária. O método se torna usável quando simulamos somente partes de uma máquina com um modelo simples. Além disso, resultados produzidos por modelos simples frequentemente são mais fáceis de entender: o problema com o hardware real é que frequentemente estes resultados incluem efeitos de sobreposição das diferentes partes da máquina.</para> </sect1> <sect1 id="introduction-tools"> -<title ->Ferramentas de Auditoria</title> - -<para ->A ferramenta de auditoria mais conhecida do GCC é o <application ->gprof</application ->: Você precisa compilar seu programa com a opção <option ->-pg</option ->; executar o programa gera um arquivo <filename ->gmon.out</filename ->, que será transformado para uma forma legível pelos humanos com o <command ->gprof</command ->. Uma desvantagem é a necessidade do passo de recompilação para preparar o executável, que deve ser ligado estaticamente. O método usado aqui é instrumentação gerada na compilação que está medindo arcos de chamadas ocorrendo entre funções e gerando contagens de chamadas, em conjunto com o TBS, que fornece um histograma da distribuição do tempo pelo código. Usando ambas as informações, é possível calcular heuristicamente o tempo inclusivo das funções, isto é o tempo gasto em uma função juntamente com todas as funções chamadas a partir dela. </para> - -<para ->Para medições exatas da ocorrência de eventos, existem bibliotecas com funções capazes de ler os contadores de desempenho do hardware. As mais conhecidas aqui são o remendo PerfCtr para o Linux, e as bibliotecas independentes de arquitetura PAPI e PCL. Ainda assim, a medição exata necessida de instrumentação do código, como indicado acima. Pode-se usar as bibliotecas propriamente ditas ou usar sistemas de instrumentação automática como o ADAPTOR (para instrumentação de código FORTRAN) ou DynaProf (injeção de código através do DynInst).</para> - -<para ->O &oprofile; é uma ampla ferramenta de auditoria para Linux que usa Amostragem.</para> - -<para ->Em muitos aspectos, uma maneira confortável de Auditoria é usar o Cachegrind ou Callgring, que são simuladores usando o ambiente de trabalho de instrumentação em tempo de execução do &valgrind;. Isto porque não é necessário acessar contadores de hardware (algo frequentemente difícil com as instalações Linux atuais), e binários para serem auditados podem ser deixados sem modificações, sendo uma boa alternativa em relação a outras ferramentas de auditoria. A desvantagem do retardo da simulação pode ser reduzida fazendo a simulação somente das partes do programa que interessam, e talvez somente em algumas poucas interações de um loop. Sem instrumentação de simulação/medição, o uso do Valgrind somente possui um retardo no intervalo de 3 à 5. E quando somente o gráfico de chamadas e contadores de chamadas são relevantes, o simulador de cache pode ser desligado. </para> - -<para ->A simulação de cache é o primeiro passo na aproximação de tempos reais, uma vez que nos modernos sistemas, o tempo de execução é muito sensível à exploração das chamadas caches (pequenos e rápidos buffers que aceleram acessos repetitivos às mesmas células de memória). O &cachegrind; faz simulação de cache travando os acessos à memória. Os dados produzidos incluem número de instruções/acesso à dados na memória e perdas nas caches de nível 1 e 2, e relaciona-o às linhas de código e funções do programa executável. Através da combinação destas contagens de perdas, usando típicas latências perdidas, uma estimativa do tempo gasto pode ser fornecida. </para> - -<para ->O Callgrind é uma extensão do &cachegrind; que constrói um gráfico de chamadas do programa em tempo real, &ie; como as funções chamam umas às outras e quantos eventos ocorrem durante a execução de uma função. Além disso, os dados da auditoria a serem coletados podem ser separados por contexto de linhas de execução e sequência de chamadas. Ele pode fornecer dados de auditoria no nível instrução para permitir anotação do código desassemblado. </para> +<title>Ferramentas de Auditoria</title> + +<para>A ferramenta de auditoria mais conhecida do GCC é o <application>gprof</application>: Você precisa compilar seu programa com a opção <option>-pg</option>; executar o programa gera um arquivo <filename>gmon.out</filename>, que será transformado para uma forma legível pelos humanos com o <command>gprof</command>. Uma desvantagem é a necessidade do passo de recompilação para preparar o executável, que deve ser ligado estaticamente. O método usado aqui é instrumentação gerada na compilação que está medindo arcos de chamadas ocorrendo entre funções e gerando contagens de chamadas, em conjunto com o TBS, que fornece um histograma da distribuição do tempo pelo código. Usando ambas as informações, é possível calcular heuristicamente o tempo inclusivo das funções, isto é o tempo gasto em uma função juntamente com todas as funções chamadas a partir dela. </para> + +<para>Para medições exatas da ocorrência de eventos, existem bibliotecas com funções capazes de ler os contadores de desempenho do hardware. As mais conhecidas aqui são o remendo PerfCtr para o Linux, e as bibliotecas independentes de arquitetura PAPI e PCL. Ainda assim, a medição exata necessida de instrumentação do código, como indicado acima. Pode-se usar as bibliotecas propriamente ditas ou usar sistemas de instrumentação automática como o ADAPTOR (para instrumentação de código FORTRAN) ou DynaProf (injeção de código através do DynInst).</para> + +<para>O &oprofile; é uma ampla ferramenta de auditoria para Linux que usa Amostragem.</para> + +<para>Em muitos aspectos, uma maneira confortável de Auditoria é usar o Cachegrind ou Callgring, que são simuladores usando o ambiente de trabalho de instrumentação em tempo de execução do &valgrind;. Isto porque não é necessário acessar contadores de hardware (algo frequentemente difícil com as instalações Linux atuais), e binários para serem auditados podem ser deixados sem modificações, sendo uma boa alternativa em relação a outras ferramentas de auditoria. A desvantagem do retardo da simulação pode ser reduzida fazendo a simulação somente das partes do programa que interessam, e talvez somente em algumas poucas interações de um loop. Sem instrumentação de simulação/medição, o uso do Valgrind somente possui um retardo no intervalo de 3 à 5. E quando somente o gráfico de chamadas e contadores de chamadas são relevantes, o simulador de cache pode ser desligado. </para> + +<para>A simulação de cache é o primeiro passo na aproximação de tempos reais, uma vez que nos modernos sistemas, o tempo de execução é muito sensível à exploração das chamadas caches (pequenos e rápidos buffers que aceleram acessos repetitivos às mesmas células de memória). O &cachegrind; faz simulação de cache travando os acessos à memória. Os dados produzidos incluem número de instruções/acesso à dados na memória e perdas nas caches de nível 1 e 2, e relaciona-o às linhas de código e funções do programa executável. Através da combinação destas contagens de perdas, usando típicas latências perdidas, uma estimativa do tempo gasto pode ser fornecida. </para> + +<para>O Callgrind é uma extensão do &cachegrind; que constrói um gráfico de chamadas do programa em tempo real, &ie; como as funções chamam umas às outras e quantos eventos ocorrem durante a execução de uma função. Além disso, os dados da auditoria a serem coletados podem ser separados por contexto de linhas de execução e sequência de chamadas. Ele pode fornecer dados de auditoria no nível instrução para permitir anotação do código desassemblado. </para> </sect1> <sect1 id="introduction-visualization"> -<title ->Visualização</title> +<title>Visualização</title> -<para ->Ferramentas de auditoria produzem tipicamente uma grande quantidade de dados. O desejo de facilmente navegar pelo gráfico de chamadas, além de rapidamente alternar o modo de ordenação das funções e exibir diferentes tipos de eventos, motivaram este aplicativo GUI que permitirá a execução destas tarefas. </para> +<para>Ferramentas de auditoria produzem tipicamente uma grande quantidade de dados. O desejo de facilmente navegar pelo gráfico de chamadas, além de rapidamente alternar o modo de ordenação das funções e exibir diferentes tipos de eventos, motivaram este aplicativo GUI que permitirá a execução destas tarefas. </para> -<para ->O &kappname; é um visualizador de dados de auditoria preenchendo estas necessidades. A despeito de ter sido programado inicialmente para navegar dados do &cachegrind; e &calltree;, existem conversores disponíveis capazes de exibir dados de auditoria produzidos por outras ferramentas. No apêndice, uma descrição do formato do arquivo do Cachegrind/Callgrind é fornecida. </para> +<para>O &kappname; é um visualizador de dados de auditoria preenchendo estas necessidades. A despeito de ter sido programado inicialmente para navegar dados do &cachegrind; e &calltree;, existem conversores disponíveis capazes de exibir dados de auditoria produzidos por outras ferramentas. No apêndice, uma descrição do formato do arquivo do Cachegrind/Callgrind é fornecida. </para> -<para ->Além de uma lista de funções ordenadas de acordo com medidas de custo exclusivas ou inclusivas, e opcionalmente agrupadas por arquivo fonte, biblioteca compartilhada ou classe C++, os recursos do &kappname; incluem diversas formas de visualização para uma função selecionada, quais sejam <itemizedlist> -<listitem -><para ->uma visão de gráfico de chamadas, que mostra uma seção do gráfico de chamadas ao redor da função selecionada,</para> +<para>Além de uma lista de funções ordenadas de acordo com medidas de custo exclusivas ou inclusivas, e opcionalmente agrupadas por arquivo fonte, biblioteca compartilhada ou classe C++, os recursos do &kappname; incluem diversas formas de visualização para uma função selecionada, quais sejam <itemizedlist> +<listitem><para>uma visão de gráfico de chamadas, que mostra uma seção do gráfico de chamadas ao redor da função selecionada,</para> </listitem> -<listitem -><para ->uma visão de mapa em árvore, que permite visualizar chamadas aninhadas relacionadas juntas com métrica de custo inclusiva para rápida detecção visual de funções problemáticas,</para> +<listitem><para>uma visão de mapa em árvore, que permite visualizar chamadas aninhadas relacionadas juntas com métrica de custo inclusiva para rápida detecção visual de funções problemáticas,</para> </listitem> -<listitem -><para ->código fonte e visões anotadas desassembladas, permitindo ver detalhes do custo relacionado às linhas de código e instruções assembler.</para> +<listitem><para>código fonte e visões anotadas desassembladas, permitindo ver detalhes do custo relacionado às linhas de código e instruções assembler.</para> </listitem> </itemizedlist> @@ -198,409 +115,193 @@ </chapter> <chapter id="using-tdecachegrind"> -<title ->Usando o &tdecachegrind;</title> +<title>Usando o &tdecachegrind;</title> <sect1 id="using-profile"> -<title ->Gerando Dados para Visualizar</title> +<title>Gerando Dados para Visualizar</title> -<para ->Primeiro, devemos gerar dados de desempenho medindo os aspectos das características em tempo de execução de um aplicativo, usando uma ferramenta de auditoria. O &tdecachegrind; propriamente dito não inclui nenhuma ferramenta de auditoria, mas pode ser melhor aproveitado em conjunto com o &callgrind;, e usando um conversor, pode também ser usado para visualizar dados produzidos com o &oprofile;. Apesar do escopo deste manual não ser o de documentar como auditar com estas ferramentas, a próxima seção fornece um pequeno tutorial para início rápido que você pode tomar como base. </para> +<para>Primeiro, devemos gerar dados de desempenho medindo os aspectos das características em tempo de execução de um aplicativo, usando uma ferramenta de auditoria. O &tdecachegrind; propriamente dito não inclui nenhuma ferramenta de auditoria, mas pode ser melhor aproveitado em conjunto com o &callgrind;, e usando um conversor, pode também ser usado para visualizar dados produzidos com o &oprofile;. Apesar do escopo deste manual não ser o de documentar como auditar com estas ferramentas, a próxima seção fornece um pequeno tutorial para início rápido que você pode tomar como base. </para> <sect2> -<title ->&callgrind;</title> - -<para ->O &callgrind; está disponível em <ulink url="http://tdecachegrind.sf.net" -> http://tdecachegrind.sf.net</ulink ->. Observe que ele era anteriormente chamado de &calltree;, mas o nome foi abandonado. </para> - -<para ->O uso mais comum é preceder a linha de comando que inicia seu aplicativo com o <application ->callgrind</application ->, como em <blockquote -><para -><command ->callgrind meuprograma meusargs</command -></para -></blockquote ->. Ao término do programa, um arquivo <filename ->callgrind.out.pid</filename -> será gerado o qual pode ser carregado para o &tdecachegrind;. </para> - -<para ->Um uso mais avançado é gerar dados de auditoria sempre que uma determinada função de seu aplicativo é chamada. Por exemplo, para o <command ->konqueror</command ->, para ver dados de auditoria somente para renderização de uma página web, você pode decidir gerar os dados sempre que você selecionar o ítem de menu Ver/Recarregar. Isto corresponde a uma chamada ao <symbol ->KonqMainWindow::slotReload</symbol ->. Use <blockquote -><para -><command -> callgrind --dump-before=KonqMainWindow::slotReload konqueror </command -></para -></blockquote -> Isto produzirá múltiplos arquivos de dados de auditoria com uma sequência numérica crescente no final dos nomes de arquivo. Um arquivo sem um número no final (terminando somente no PID do processo) também será produzido. Carregando este arquivo no &tdecachegrind;, todos os outros serão também carregados, e podem ser vistos na Visão Geral de Partes e Lista de Partes. </para> +<title>&callgrind;</title> + +<para>O &callgrind; está disponível em <ulink url="http://tdecachegrind.sf.net"> http://tdecachegrind.sf.net</ulink>. Observe que ele era anteriormente chamado de &calltree;, mas o nome foi abandonado. </para> + +<para>O uso mais comum é preceder a linha de comando que inicia seu aplicativo com o <application>callgrind</application>, como em <blockquote><para><command>callgrind meuprograma meusargs</command></para></blockquote>. Ao término do programa, um arquivo <filename>callgrind.out.pid</filename> será gerado o qual pode ser carregado para o &tdecachegrind;. </para> + +<para>Um uso mais avançado é gerar dados de auditoria sempre que uma determinada função de seu aplicativo é chamada. Por exemplo, para o <command>konqueror</command>, para ver dados de auditoria somente para renderização de uma página web, você pode decidir gerar os dados sempre que você selecionar o ítem de menu Ver/Recarregar. Isto corresponde a uma chamada ao <symbol>KonqMainWindow::slotReload</symbol>. Use <blockquote><para><command> callgrind --dump-before=KonqMainWindow::slotReload konqueror </command></para></blockquote> Isto produzirá múltiplos arquivos de dados de auditoria com uma sequência numérica crescente no final dos nomes de arquivo. Um arquivo sem um número no final (terminando somente no PID do processo) também será produzido. Carregando este arquivo no &tdecachegrind;, todos os outros serão também carregados, e podem ser vistos na Visão Geral de Partes e Lista de Partes. </para> </sect2> <sect2> -<title ->&oprofile;</title> - -<para ->O &oprofile; está disponível em <ulink url="http://oprofile.sf.net" ->http://oprofile.sf.net</ulink ->. Siga as instruções de instalação no site web. Mas antes, verifique se sua distribuição já não fornece-o empacotado (como a SuSE). </para> - -<para ->Uma ampla auditoria do sistema somente é permitida ao usuário root, onde todas as ações do sistema podem ser observadas. Logo, o descrito a seguir deve ser feito como root. Primeiro, configure o processo de auditoria, usando a GUI <command ->oprof_stat</command -> ou a ferramenta de linha de comando opcontrol. A configuração padrão deve estar no modo tempo (TBS, veja a introdução). Para iniciar a medição, execute <command ->opcontrol -s</command ->. Então execute o aplicativo a ser analisado, e após isso, execute um <command ->opcontrol -d</command ->. Isto gravará todos os resultados medidos em arquivos sob o diretório <filename ->/var/lib/oprofile/samples/</filename ->. Para ser capaz de visualizar os dados no &tdecachegrind;, coloque-os em um diretório vazio: <blockquote -><para -><command -> opreport -gdf | op2callgrind </command -></para -></blockquote -> Isto produzirá uma grande quantidade de arquivos, um para cada programa que está em execução no sistema. Cada um deles pode ser carregado no &tdecachegrind; conforme desejar. </para> +<title>&oprofile;</title> + +<para>O &oprofile; está disponível em <ulink url="http://oprofile.sf.net">http://oprofile.sf.net</ulink>. Siga as instruções de instalação no site web. Mas antes, verifique se sua distribuição já não fornece-o empacotado (como a SuSE). </para> + +<para>Uma ampla auditoria do sistema somente é permitida ao usuário root, onde todas as ações do sistema podem ser observadas. Logo, o descrito a seguir deve ser feito como root. Primeiro, configure o processo de auditoria, usando a GUI <command>oprof_stat</command> ou a ferramenta de linha de comando opcontrol. A configuração padrão deve estar no modo tempo (TBS, veja a introdução). Para iniciar a medição, execute <command>opcontrol -s</command>. Então execute o aplicativo a ser analisado, e após isso, execute um <command>opcontrol -d</command>. Isto gravará todos os resultados medidos em arquivos sob o diretório <filename>/var/lib/oprofile/samples/</filename>. Para ser capaz de visualizar os dados no &tdecachegrind;, coloque-os em um diretório vazio: <blockquote><para><command> opreport -gdf | op2callgrind </command></para></blockquote> Isto produzirá uma grande quantidade de arquivos, um para cada programa que está em execução no sistema. Cada um deles pode ser carregado no &tdecachegrind; conforme desejar. </para> </sect2> </sect1> <sect1 id="using-basics"> -<title ->Fundamentos da Interface com o Usuário</title> - -<para ->Ao iniciar o &tdecachegrind; com um arquivo de dados de auditoria como argumento, ou após carregar um através do Arquivo/Abrir, você verá uma barra lateral contendo a lista de funções à esquerda, e na parte principal à direita, uma área com visualizações para a função selecionada. Esta área de visualização pode ser configurada arbitrariamente para mostrar múltiplas visualizações de uma vez. </para> - -<para ->Na primeira inicialização, esta área será dividida em uma parte superior e inferior, cada uma com diferentes visualizações selecionáveis por abas. Para mover as visualizações, use o menu de contexto das abas, e ajuste os divisores entre as visualizações. Para alternar rapidamente entre as diferentes disposições de visualização, use Ver/Disposição/Duplicar, mude a disposição e alterne entre as disposições com Ver/Disposição/Próximo (ou melhor de acordo com os atalhos de teclado). </para> - -<para ->O importante para a visualização é o tipo de evento ativo: para o &callgrind;, isto é por exemplo Perdas de Cache ou Estimativa de Ciclo, para o &oprofile;, isto é "Temporizador" no caso mais simples. Você pode mudar o tipo de evento através da caixa combinada na barra de ferramentas ou na visão de Tipo de Evento. Uma primeira visão geral das características em tempo de execução deve ser fornecida quando você seleciona a função <symbol ->main</symbol -> na lista à esquerda, e observa a visualização do gráfico de chamadas. Nele, você vê as chamadas ocorrendo em seu programa. Observe que a visão do gráfico de chamadas somente mostra funções com alta contagem de eventos. Executar um duplo-clique em uma função no gráfico, mudará a representação para mostrar as funções ao redor da selecionada. </para> - -<para ->Se desejar explorar mais a GUI, além deste manual, dê uma olhada na seção de documentação do site web <ulink url="http://tdecachegrind.sf.net" ->http://tdecachegrind.sf.net</ulink ->. Além disso, cada widget no &tdecachegrind; possui ajuda do tipo <quote ->O Que é Isso</quote ->. </para> +<title>Fundamentos da Interface com o Usuário</title> + +<para>Ao iniciar o &tdecachegrind; com um arquivo de dados de auditoria como argumento, ou após carregar um através do Arquivo/Abrir, você verá uma barra lateral contendo a lista de funções à esquerda, e na parte principal à direita, uma área com visualizações para a função selecionada. Esta área de visualização pode ser configurada arbitrariamente para mostrar múltiplas visualizações de uma vez. </para> + +<para>Na primeira inicialização, esta área será dividida em uma parte superior e inferior, cada uma com diferentes visualizações selecionáveis por abas. Para mover as visualizações, use o menu de contexto das abas, e ajuste os divisores entre as visualizações. Para alternar rapidamente entre as diferentes disposições de visualização, use Ver/Disposição/Duplicar, mude a disposição e alterne entre as disposições com Ver/Disposição/Próximo (ou melhor de acordo com os atalhos de teclado). </para> + +<para>O importante para a visualização é o tipo de evento ativo: para o &callgrind;, isto é por exemplo Perdas de Cache ou Estimativa de Ciclo, para o &oprofile;, isto é "Temporizador" no caso mais simples. Você pode mudar o tipo de evento através da caixa combinada na barra de ferramentas ou na visão de Tipo de Evento. Uma primeira visão geral das características em tempo de execução deve ser fornecida quando você seleciona a função <symbol>main</symbol> na lista à esquerda, e observa a visualização do gráfico de chamadas. Nele, você vê as chamadas ocorrendo em seu programa. Observe que a visão do gráfico de chamadas somente mostra funções com alta contagem de eventos. Executar um duplo-clique em uma função no gráfico, mudará a representação para mostrar as funções ao redor da selecionada. </para> + +<para>Se desejar explorar mais a GUI, além deste manual, dê uma olhada na seção de documentação do site web <ulink url="http://tdecachegrind.sf.net">http://tdecachegrind.sf.net</ulink>. Além disso, cada widget no &tdecachegrind; possui ajuda do tipo <quote>O Que é Isso</quote>. </para> </sect1> </chapter> <chapter id="tdecachegrind-concepts"> -<title ->Conceitos Básicos</title> +<title>Conceitos Básicos</title> -<para ->Este capítulo explana alguns conceitos do &tdecachegrind; e introduz termos usados na interface. </para> +<para>Este capítulo explana alguns conceitos do &tdecachegrind; e introduz termos usados na interface. </para> <sect1 id="concepts-model"> -<title ->O Modelo de Dados para Dados de Auditoria</title> +<title>O Modelo de Dados para Dados de Auditoria</title> <sect2> -<title ->Entidades de Custo</title> - -<para ->Contagem de custos de eventos (como Perdas na L2) são atribuídas a entidades de custo, que são ítens com relacionamentos com o código fonte ou estrutura de dados de um programa fornecido. Entidades de custo não somente podem ser código simples ou posições de dados, mas também posições de referência. Por exemplo, uma chamada tem uma fonte e um alvo, ou um endereço de dados pode ter um tipo de dado e uma posição do código onde sua alocação ocorreu. </para> - -<para ->As entidades de custo reconhecidas pelo KCacheGrind são fornecidas a seguir. Posições Simples: <itemizedlist -> <listitem -><para -> Instrução. Uma instrução assembler em um endereço esecificado. </para -></listitem -> <listitem -><para -> Linha de Código de uma Função. Todas as instruções que o compilador (através de informações de depuração) mapeia para uma linha de código determinada especificada pelo nome do arquivo fonte e número da linha, e que são executadas no contexto de alguma função. O útlimo requisito é necessário porque uma linha fonte dentro de uma função em linha pode aparecer no contexto de múltiplas funções. Instruções sem nenhum mapeamento para uma linha de código atual são mapeados para o número de linha 0 no arquivo "???". </para -></listitem -> <listitem -><para -> Função. Todas as linhas de código de uma função fornecida que consistem na função propriamente dita. Uma função é especificada por seu nome e sua localização em algum objeto binário, se disponível. O último requisito é necessário porque cada objeto binário de um programa simples pode manter funções com o mesmo nome (elas podem ser acessadas por exemplo com o dlopen/dlsym; o linkador em tempo de execução resolve funções em uma ordem de busca fornecida de objetos binários usados). Se uma ferramenta de auditorianão puder detectar o nome símbolo de uma função, por exemplo devido às informações de depuração não estarem disponíveis, seja pelo endereço da primeira instrução executada tipicamente ser usado, ou "???". </para -></listitem -> <listitem -><para ->Objeto Binário. Todas as funções nas quais o código está dentro do intervalo de um objeto binário fornecido, seja o executável principal ou uma biblioteca compartilhada. </para -></listitem -> <listitem -><para ->Arquivo Fonte. Todas as funções nas quais a primeira instrução é mapeada para uma linha de um arquivo fonte fornecido. </para -></listitem -> <listitem -><para -> Classe. Nomes símbolos de funções tipicamente são ordenados hierarquicamente no espaço de nomes, por exemplo espaço de nomes C++, ou linguagens orientadas a classes de objeto. Assim, uma classe pode manter funções de classes ou embutir classes propriamente ditas. </para -></listitem -> <listitem -><para -> Parte de Auditoria. Alguma seção de tempo de uma auditoria executada, com um ID de cabeçalho fornecido, ID do processo e linha de comando executada. </para -></listitem -> </itemizedlist -> Como visto na lista, um conjunto de entidades de custo frequentemente define outra entidade de custo. Assim, existe uma inclusão hierárquica de entidades de custo que deve ser óbvia a partir da descrição acima. </para> - -<para ->Posições de referência: <itemizedlist -> <listitem -><para -> Chamada de um endereço de instrução para função alvo. </para -></listitem -> <listitem -><para -> Chamada de uma linha de código para função alvo. </para -></listitem -> <listitem -><para -> Chamada de código de função para função alvo. </para -></listitem -> <listitem -><para -> Salto (in)condicional do código para instrução alvo. </para -></listitem -> <listitem -><para -> Salto (in)condicional do código para linha alvo. </para -></listitem -> </itemizedlist -> Saltos entre funções não são permitidos, uma vez que isto não faz sentido em um gráfico de chamadas. Assim, construções como manipulação de exceções e saltos longos em C terão que ser traduzidas para aparecerem na pilha de chamadas se necessário. </para> +<title>Entidades de Custo</title> + +<para>Contagem de custos de eventos (como Perdas na L2) são atribuídas a entidades de custo, que são ítens com relacionamentos com o código fonte ou estrutura de dados de um programa fornecido. Entidades de custo não somente podem ser código simples ou posições de dados, mas também posições de referência. Por exemplo, uma chamada tem uma fonte e um alvo, ou um endereço de dados pode ter um tipo de dado e uma posição do código onde sua alocação ocorreu. </para> + +<para>As entidades de custo reconhecidas pelo KCacheGrind são fornecidas a seguir. Posições Simples: <itemizedlist> <listitem><para> Instrução. Uma instrução assembler em um endereço esecificado. </para></listitem> <listitem><para> Linha de Código de uma Função. Todas as instruções que o compilador (através de informações de depuração) mapeia para uma linha de código determinada especificada pelo nome do arquivo fonte e número da linha, e que são executadas no contexto de alguma função. O útlimo requisito é necessário porque uma linha fonte dentro de uma função em linha pode aparecer no contexto de múltiplas funções. Instruções sem nenhum mapeamento para uma linha de código atual são mapeados para o número de linha 0 no arquivo "???". </para></listitem> <listitem><para> Função. Todas as linhas de código de uma função fornecida que consistem na função propriamente dita. Uma função é especificada por seu nome e sua localização em algum objeto binário, se disponível. O último requisito é necessário porque cada objeto binário de um programa simples pode manter funções com o mesmo nome (elas podem ser acessadas por exemplo com o dlopen/dlsym; o linkador em tempo de execução resolve funções em uma ordem de busca fornecida de objetos binários usados). Se uma ferramenta de auditorianão puder detectar o nome símbolo de uma função, por exemplo devido às informações de depuração não estarem disponíveis, seja pelo endereço da primeira instrução executada tipicamente ser usado, ou "???". </para></listitem> <listitem><para>Objeto Binário. Todas as funções nas quais o código está dentro do intervalo de um objeto binário fornecido, seja o executável principal ou uma biblioteca compartilhada. </para></listitem> <listitem><para>Arquivo Fonte. Todas as funções nas quais a primeira instrução é mapeada para uma linha de um arquivo fonte fornecido. </para></listitem> <listitem><para> Classe. Nomes símbolos de funções tipicamente são ordenados hierarquicamente no espaço de nomes, por exemplo espaço de nomes C++, ou linguagens orientadas a classes de objeto. Assim, uma classe pode manter funções de classes ou embutir classes propriamente ditas. </para></listitem> <listitem><para> Parte de Auditoria. Alguma seção de tempo de uma auditoria executada, com um ID de cabeçalho fornecido, ID do processo e linha de comando executada. </para></listitem> </itemizedlist> Como visto na lista, um conjunto de entidades de custo frequentemente define outra entidade de custo. Assim, existe uma inclusão hierárquica de entidades de custo que deve ser óbvia a partir da descrição acima. </para> + +<para>Posições de referência: <itemizedlist> <listitem><para> Chamada de um endereço de instrução para função alvo. </para></listitem> <listitem><para> Chamada de uma linha de código para função alvo. </para></listitem> <listitem><para> Chamada de código de função para função alvo. </para></listitem> <listitem><para> Salto (in)condicional do código para instrução alvo. </para></listitem> <listitem><para> Salto (in)condicional do código para linha alvo. </para></listitem> </itemizedlist> Saltos entre funções não são permitidos, uma vez que isto não faz sentido em um gráfico de chamadas. Assim, construções como manipulação de exceções e saltos longos em C terão que ser traduzidas para aparecerem na pilha de chamadas se necessário. </para> </sect2> <sect2> -<title ->Tipos de Eventos</title> +<title>Tipos de Eventos</title> -<para ->Tipos de eventos arbitrários podem ser especificados nos dados de auditoria fornecendo-lhes um nome. Seu custo relacionado a uma entidade de custo é um inteiro de 64 bits. </para> -<para ->Tipos de eventos os quais os custos são especificados em um arquivo de dados de auditoria são chamados eventos reais. Além disso, tipos podem especificar fórmulas para tipos de eventos calculados a partir de eventos reais, sendo chamados de eventos herdados. </para> +<para>Tipos de eventos arbitrários podem ser especificados nos dados de auditoria fornecendo-lhes um nome. Seu custo relacionado a uma entidade de custo é um inteiro de 64 bits. </para> +<para>Tipos de eventos os quais os custos são especificados em um arquivo de dados de auditoria são chamados eventos reais. Além disso, tipos podem especificar fórmulas para tipos de eventos calculados a partir de eventos reais, sendo chamados de eventos herdados. </para> </sect2> </sect1> <sect1 id="concepts-state"> -<title ->Visualização de Estado</title> - -<para ->A visualização de estado de uma janela do KCachegring inclui: <itemizedlist -> <listitem -><para -> o tipo de evento primário e secundário escolhido para exibição, </para -></listitem -> <listitem -><para -> o grupo de função (usado na lista de Auditoria de Função e coloração de entidade), </para -></listitem -> <listitem -><para -> a auditoria de partes cujos custos estão incluídos na visualização, </para -></listitem -> <listitem -><para -> uma entidade de custo ativa (por exemplo a função selecionada a partir da aba de auditoria de função), </para -></listitem -> <listitem -><para -> uma entidade de custo selecionada. </para -></listitem -> </itemizedlist -> Isto influencia as visualizações. </para> -<para ->Visualizações sempre são mostradas por uma, a ativa, entidade de custo. Quando uma determinada visualização não é apropriada para uma entidade de custo, ela é desabilitada (por exemplo ao selecionar um objeto ELF na lista de grupo com um duplo-clique, a anotação de código para um objeto ELF não faz sentido). </para> -<para ->Por exemplo para uma função ativa, a lista de chamadas mostra todas as funções chamadas a partir da ativa. Aguém pode selecionar uma destas funções sem torná-la ativa. Se o gráfico de chamada é mostrado logo ao lado, ele automaticamente selecionará a mesma função. </para> +<title>Visualização de Estado</title> + +<para>A visualização de estado de uma janela do KCachegring inclui: <itemizedlist> <listitem><para> o tipo de evento primário e secundário escolhido para exibição, </para></listitem> <listitem><para> o grupo de função (usado na lista de Auditoria de Função e coloração de entidade), </para></listitem> <listitem><para> a auditoria de partes cujos custos estão incluídos na visualização, </para></listitem> <listitem><para> uma entidade de custo ativa (por exemplo a função selecionada a partir da aba de auditoria de função), </para></listitem> <listitem><para> uma entidade de custo selecionada. </para></listitem> </itemizedlist> Isto influencia as visualizações. </para> +<para>Visualizações sempre são mostradas por uma, a ativa, entidade de custo. Quando uma determinada visualização não é apropriada para uma entidade de custo, ela é desabilitada (por exemplo ao selecionar um objeto ELF na lista de grupo com um duplo-clique, a anotação de código para um objeto ELF não faz sentido). </para> +<para>Por exemplo para uma função ativa, a lista de chamadas mostra todas as funções chamadas a partir da ativa. Aguém pode selecionar uma destas funções sem torná-la ativa. Se o gráfico de chamada é mostrado logo ao lado, ele automaticamente selecionará a mesma função. </para> </sect1> <sect1 id="concepts-guiparts"> -<title ->Partes da GUI</title> +<title>Partes da GUI</title> <sect2> -<title ->Abas Laterais</title> -<para ->Abas laterais (Embutíveis) são janelas laterais que podem ser colocadas em qualquer lado de uma janela do KCachegring. Elas sempre contém uma lista de entidades de custo ordenadas de alguma maneira. <itemizedlist> -<listitem -><para ->Auditoria de Função. A Auditoria de Função é uma lista de funções mostrando custo inclusivo e exclusivo, contagem de chamadas, nome e posição de funções. </para -></listitem> -<listitem -><para ->Visão Geral das Partes </para -></listitem> -<listitem -><para ->Pilha de Chamadas </para -></listitem> +<title>Abas Laterais</title> +<para>Abas laterais (Embutíveis) são janelas laterais que podem ser colocadas em qualquer lado de uma janela do KCachegring. Elas sempre contém uma lista de entidades de custo ordenadas de alguma maneira. <itemizedlist> +<listitem><para>Auditoria de Função. A Auditoria de Função é uma lista de funções mostrando custo inclusivo e exclusivo, contagem de chamadas, nome e posição de funções. </para></listitem> +<listitem><para>Visão Geral das Partes </para></listitem> +<listitem><para>Pilha de Chamadas </para></listitem> </itemizedlist> </para> </sect2> <sect2> -<title ->Área de Visualização</title> -<para ->A área de visualização, normalmente a parte direita da janela principal do KCachegrind, é constituída de uma (padrão) ou mais Visões em Aba, alinhadas horizontalmente ou verticalmente. Cada visão em aba mantém visualizações diferentes de uma entidade de custo por vez. O nome desta entidade é fornecido na visão em aba superior. Se existirem múltiplas visões em aba, somente uma fica ativa. O nome da entidade na aba de visão ativa é mostrado em negrito e determina a entidade de custo ativa da janela do KCachegrind. </para> +<title>Área de Visualização</title> +<para>A área de visualização, normalmente a parte direita da janela principal do KCachegrind, é constituída de uma (padrão) ou mais Visões em Aba, alinhadas horizontalmente ou verticalmente. Cada visão em aba mantém visualizações diferentes de uma entidade de custo por vez. O nome desta entidade é fornecido na visão em aba superior. Se existirem múltiplas visões em aba, somente uma fica ativa. O nome da entidade na aba de visão ativa é mostrado em negrito e determina a entidade de custo ativa da janela do KCachegrind. </para> </sect2> <sect2> -<title ->Áreas de uma Visão em Aba</title> -<para ->Cada visão em aba pode conter quatro áreas de visão, nomeadas Superior, Direita, Esquerda e Inferior. Cada área pode conter múltiplas visualizações empilhadas. A parte visível de uma área é selecionada por uma barra de abas. Barras de abas da área superior e direita estão no topo, barras de abas da área inferior e esquerda estão na base. Você pode especificar que tipo de visualização deve ser colocado em qual área usando o menu de contexto das abas. </para> +<title>Áreas de uma Visão em Aba</title> +<para>Cada visão em aba pode conter quatro áreas de visão, nomeadas Superior, Direita, Esquerda e Inferior. Cada área pode conter múltiplas visualizações empilhadas. A parte visível de uma área é selecionada por uma barra de abas. Barras de abas da área superior e direita estão no topo, barras de abas da área inferior e esquerda estão na base. Você pode especificar que tipo de visualização deve ser colocado em qual área usando o menu de contexto das abas. </para> </sect2> <sect2> -<title ->Visualização Sincronizada através da Entidade Selecionada na Visão em Abas</title> -<para ->Além de uma entidade ativa, cada visão em aba tem uma entidade selecionada. Como a maioria dos tipos de visualização mostram múltiplas entidades com a ativa centrada, você muda o ítem selecionado navegando dentro de uma visualização (clicando com o mouse ou usando o teclado). Tipicamente, ítens selecionados são mostrado em um estado destacado. Mudando a entidade selecionada em uma visualização de uma visão em aba, todas as outras visualizações na visão em abas destacarão a nova entidade selecionada. </para> +<title>Visualização Sincronizada através da Entidade Selecionada na Visão em Abas</title> +<para>Além de uma entidade ativa, cada visão em aba tem uma entidade selecionada. Como a maioria dos tipos de visualização mostram múltiplas entidades com a ativa centrada, você muda o ítem selecionado navegando dentro de uma visualização (clicando com o mouse ou usando o teclado). Tipicamente, ítens selecionados são mostrado em um estado destacado. Mudando a entidade selecionada em uma visualização de uma visão em aba, todas as outras visualizações na visão em abas destacarão a nova entidade selecionada. </para> </sect2> <sect2> -<title ->Sincronização entre Visões em Abas</title> -<para ->Se existirem múltiplas visões em abas, uma mudança de seleção em uma visão em aba faz um mudança de ativação na visão em aba seguinte (à direita/abaixo). Este tipo de ligação por exemplo deve permitir uma rápida navegação nos gráficos de chamadas. </para> +<title>Sincronização entre Visões em Abas</title> +<para>Se existirem múltiplas visões em abas, uma mudança de seleção em uma visão em aba faz um mudança de ativação na visão em aba seguinte (à direita/abaixo). Este tipo de ligação por exemplo deve permitir uma rápida navegação nos gráficos de chamadas. </para> </sect2> <sect2> -<title ->Disposições</title> -<para ->A disposição para todas as visões em aba de uma janela pode ser salva (veja o ítem de menu Ver/Disposição). Após duplicar a disposição atual (Ctrl+Mais ou menu) e mudar alguns tamanhos ou mover uma visualização para outra área de uma visão em abas, você pode rapidamente alternar entre a disposição antiga e a nova através do Ctrl+Esquerda/Direita. O conjunto de disposições será armazenado entre sessões do KCachegring do mesmo comando de auditoria. Você pode tornar o conjunto atual de disposições o padrão para novas sessões do KCachegrind, ou restaurar para o conjunto de disposições padrão. </para> +<title>Disposições</title> +<para>A disposição para todas as visões em aba de uma janela pode ser salva (veja o ítem de menu Ver/Disposição). Após duplicar a disposição atual (Ctrl+Mais ou menu) e mudar alguns tamanhos ou mover uma visualização para outra área de uma visão em abas, você pode rapidamente alternar entre a disposição antiga e a nova através do Ctrl+Esquerda/Direita. O conjunto de disposições será armazenado entre sessões do KCachegring do mesmo comando de auditoria. Você pode tornar o conjunto atual de disposições o padrão para novas sessões do KCachegrind, ou restaurar para o conjunto de disposições padrão. </para> </sect2> </sect1> <sect1 id="concepts-sidedocks"> -<title ->Abas Laterais</title> +<title>Abas Laterais</title> <sect2> -<title ->Auditoria Plana</title> -<para ->A auditoria plana contém uma lista de grupos e uma lista de funções. A lista de grupos contém todos os grupos onde o custo ocorre, dependendo do tipo de grupo escolhido. A lista de grupos é oculta quando o agrupamento é desligado. </para> -<para ->A lista de funções contém as funções do grupo selecionado (ou todas as funções se o agrupamente estiver desligado), ordenadas por alguma coluna, por exemplo os custos gastos por ele ou inclusivos. Existe um número máximo de funções mostradas na lista, que é configurável em Configurações/Configurar o KCachegrind. </para> +<title>Auditoria Plana</title> +<para>A auditoria plana contém uma lista de grupos e uma lista de funções. A lista de grupos contém todos os grupos onde o custo ocorre, dependendo do tipo de grupo escolhido. A lista de grupos é oculta quando o agrupamento é desligado. </para> +<para>A lista de funções contém as funções do grupo selecionado (ou todas as funções se o agrupamente estiver desligado), ordenadas por alguma coluna, por exemplo os custos gastos por ele ou inclusivos. Existe um número máximo de funções mostradas na lista, que é configurável em Configurações/Configurar o KCachegrind. </para> </sect2> <sect2> -<title ->Visão Geral das Partes</title> -<para ->Na execução de uma auditoria, múltiplos arquivos de dados auditados podem ser produzidos, os quais podem ser carregados simultaneamente no KCachegrind. A aba lateral Visão Geral de Partes mostra estes arquivos, ordenados horizontalmente de acordo com a hora de criação; os tamanhos dos retângulos são proporcionais ao custo gasto nas partes. Você pode selecionar uma ou diversas partes para limitar os custos mostrados nas outras visões do KCachegrind às partes selecionadas. </para> -<para ->As partes são posteriormente subdivididas: existe um modo e particionamento e um de divisão de custo inclusivo: <itemizedlist> -<listitem -><para ->Particionamento: Você vê o particionamento em grupos para uma parte dos dados de auditoria, de acordo com o tipo de grupo selecionado. Por exemplo se o grupo de objetos ELF estiver selecionado, você vê retângulos coloridos para cada objeto ELF usado (biblioteca compartilhada ou executável), dimensionado de acordo com o custo gasto nele. </para -></listitem> -<listitem -><para ->Divisão de Custo Inclusivo: Um retângulo mostrando o custo inclusivo da função ativa atual na parte é mostrado. Ele divide-se novamente para mostrar os custos inclusivos de suas chamadas. </para -></listitem> +<title>Visão Geral das Partes</title> +<para>Na execução de uma auditoria, múltiplos arquivos de dados auditados podem ser produzidos, os quais podem ser carregados simultaneamente no KCachegrind. A aba lateral Visão Geral de Partes mostra estes arquivos, ordenados horizontalmente de acordo com a hora de criação; os tamanhos dos retângulos são proporcionais ao custo gasto nas partes. Você pode selecionar uma ou diversas partes para limitar os custos mostrados nas outras visões do KCachegrind às partes selecionadas. </para> +<para>As partes são posteriormente subdivididas: existe um modo e particionamento e um de divisão de custo inclusivo: <itemizedlist> +<listitem><para>Particionamento: Você vê o particionamento em grupos para uma parte dos dados de auditoria, de acordo com o tipo de grupo selecionado. Por exemplo se o grupo de objetos ELF estiver selecionado, você vê retângulos coloridos para cada objeto ELF usado (biblioteca compartilhada ou executável), dimensionado de acordo com o custo gasto nele. </para></listitem> +<listitem><para>Divisão de Custo Inclusivo: Um retângulo mostrando o custo inclusivo da função ativa atual na parte é mostrado. Ele divide-se novamente para mostrar os custos inclusivos de suas chamadas. </para></listitem> </itemizedlist> </para> </sect2> <sect2> -<title ->Pilha de Chamadas</title> -<para ->Isto é uma pilha de chamadas 'mais provável' puramente fictícia. Ela é construída iniciando com a função ativa atual e adicionar as chamadas/chamados com custo mais alto de cima para baixo. </para> -<para ->As colunas 'Custo' e 'Chamadas' mostram o custo usado para todas as chamadas a partir da função na linha acima. </para> +<title>Pilha de Chamadas</title> +<para>Isto é uma pilha de chamadas 'mais provável' puramente fictícia. Ela é construída iniciando com a função ativa atual e adicionar as chamadas/chamados com custo mais alto de cima para baixo. </para> +<para>As colunas 'Custo' e 'Chamadas' mostram o custo usado para todas as chamadas a partir da função na linha acima. </para> </sect2> </sect1> <sect1 id="concepts-visualizations"> -<title ->Visualizações</title> +<title>Visualizações</title> <sect2> -<title ->Tipos de Eventos</title> -<para ->Esta lista mostra todos os tipos de custo disponíveis e o custo próprio correspondente e inclusivo da função ativa atual para o tipo de evento especificado. </para> -<para ->Escolhendo um tipo de evento na lista, você muda o tipo de custo mostrado por todo o KCachegrind para o selecionado. </para> +<title>Tipos de Eventos</title> +<para>Esta lista mostra todos os tipos de custo disponíveis e o custo próprio correspondente e inclusivo da função ativa atual para o tipo de evento especificado. </para> +<para>Escolhendo um tipo de evento na lista, você muda o tipo de custo mostrado por todo o KCachegrind para o selecionado. </para> </sect2> <sect2> -<title ->Lista de Chamadas</title> -<para ->Estas listas mostram chamadas para/da função ativa atual. Com 'todas' funções chamadoras/chamadas significando que podem ser alcançadas na direção chamadora/chamada, mesmo se outras funções estiverem interpostas. </para> -<para ->Visões de lista de chamada incluem: <itemizedlist> -<listitem -><para ->Chamadores Diretos </para -></listitem> -<listitem -><para ->Chamados Diretos </para -></listitem> -<listitem -><para ->Todos os Chamadores </para -></listitem> -<listitem -><para ->Todas as Chamadas </para -></listitem> +<title>Lista de Chamadas</title> +<para>Estas listas mostram chamadas para/da função ativa atual. Com 'todas' funções chamadoras/chamadas significando que podem ser alcançadas na direção chamadora/chamada, mesmo se outras funções estiverem interpostas. </para> +<para>Visões de lista de chamada incluem: <itemizedlist> +<listitem><para>Chamadores Diretos </para></listitem> +<listitem><para>Chamados Diretos </para></listitem> +<listitem><para>Todos os Chamadores </para></listitem> +<listitem><para>Todas as Chamadas </para></listitem> </itemizedlist> </para> </sect2> <sect2> -<title ->Mapas</title> -<para ->Uma visualização de mapa em árvore do tipo de evento primário, acima e abaixo da hierarquia de chamadas. Cada retângulo colorido representa uma função; seu tamanho tenta ser proporcional ao custo gasto nela enquanto a função ativa estiver em execução (no entanto, existem restrições de desenho). </para> -<para ->Para o Mapa de Chamador, o gráfico mostra a hierarquia aninhada de todos os chamadores da função ativa atual; para o Mapa de Chamados, ele mostra a hierarquia aninhada de todas os chamados da função ativa atual. </para> -<para ->Opções de aparência podem ser encontradas no menu de contexto. Para obter proporções exatas de tamanho, escolha 'Ocultar bordas incorretas'. Como este modo pode consumir muito tempo, você pode querer limitar o nível de aninhamento de desenho máximo antes. 'O Melhor' determina a direção de divisão para filhos a partir da proporção do pai. 'Sempre O Melhor' decide sobre o espaço remanescente para cada irmão. 'Ignorar Proporções' toma o espaço para desenhar o nome da função antes de desenhar o filho. Observe que as proporções de tamanho podem ficar bastante incorretas. </para> -<para ->A navegação pelo teclado está disponível com as teclas de set esquerda/direita para navegar por irmãos, e teclas de seta acima/abaixo para ir um nível aninhado acima/abaixo. 'Return' ativa o ítem atual. </para> +<title>Mapas</title> +<para>Uma visualização de mapa em árvore do tipo de evento primário, acima e abaixo da hierarquia de chamadas. Cada retângulo colorido representa uma função; seu tamanho tenta ser proporcional ao custo gasto nela enquanto a função ativa estiver em execução (no entanto, existem restrições de desenho). </para> +<para>Para o Mapa de Chamador, o gráfico mostra a hierarquia aninhada de todos os chamadores da função ativa atual; para o Mapa de Chamados, ele mostra a hierarquia aninhada de todas os chamados da função ativa atual. </para> +<para>Opções de aparência podem ser encontradas no menu de contexto. Para obter proporções exatas de tamanho, escolha 'Ocultar bordas incorretas'. Como este modo pode consumir muito tempo, você pode querer limitar o nível de aninhamento de desenho máximo antes. 'O Melhor' determina a direção de divisão para filhos a partir da proporção do pai. 'Sempre O Melhor' decide sobre o espaço remanescente para cada irmão. 'Ignorar Proporções' toma o espaço para desenhar o nome da função antes de desenhar o filho. Observe que as proporções de tamanho podem ficar bastante incorretas. </para> +<para>A navegação pelo teclado está disponível com as teclas de set esquerda/direita para navegar por irmãos, e teclas de seta acima/abaixo para ir um nível aninhado acima/abaixo. 'Return' ativa o ítem atual. </para> </sect2> <sect2> -<title ->Gráfico de Chamadas</title> -<para ->Esta visão mostra o gráfico de chamadas ao redor da função ativa. O custo mostrado é somente o custo que é gasto enquanto a função ativa estiver em execução; isto é o custo mostrado para main() - se ela estiver visível - deve ser o mesmo que o custo da função ativa, uma vez que é parte do custo inclusivo que main() gasta enquanto a função ativa estiver rodando. </para> -<para ->Para ciclos, setas de chamadas em azul indicam que esta é uma chamada artificial adicionada para corrigir o desenho e que na verdade nunca ocorre. </para> -<para ->Se o gráfico é maior que a área do widget, um painel de visão geral é mostrado em um dos lados. Existem opções de visualização similares as do Mapa em Árvore de Chamadas; a função selecionada é destacada. </para> +<title>Gráfico de Chamadas</title> +<para>Esta visão mostra o gráfico de chamadas ao redor da função ativa. O custo mostrado é somente o custo que é gasto enquanto a função ativa estiver em execução; isto é o custo mostrado para main() - se ela estiver visível - deve ser o mesmo que o custo da função ativa, uma vez que é parte do custo inclusivo que main() gasta enquanto a função ativa estiver rodando. </para> +<para>Para ciclos, setas de chamadas em azul indicam que esta é uma chamada artificial adicionada para corrigir o desenho e que na verdade nunca ocorre. </para> +<para>Se o gráfico é maior que a área do widget, um painel de visão geral é mostrado em um dos lados. Existem opções de visualização similares as do Mapa em Árvore de Chamadas; a função selecionada é destacada. </para> </sect2> <sect2> -<title ->Anotações</title> -<para ->A lista de código/assembler anotado mostra as instruções da linha de código/desassembladas da função ativa atual junto com o custo (próprio) gasto ao executar o código de uma linha fonte/instrução. Se existir uma chamada, linhas com detalhes sobre a chamada serão inseridas na fonte: o custo (inclusivo) gasto dentro de uma chamada, o número de chamadas que ocorreram, e o destino da chamada. </para> -<para ->Selecione uma linha de informação de chamada para ativar o destino da chamada. </para> +<title>Anotações</title> +<para>A lista de código/assembler anotado mostra as instruções da linha de código/desassembladas da função ativa atual junto com o custo (próprio) gasto ao executar o código de uma linha fonte/instrução. Se existir uma chamada, linhas com detalhes sobre a chamada serão inseridas na fonte: o custo (inclusivo) gasto dentro de uma chamada, o número de chamadas que ocorreram, e o destino da chamada. </para> +<para>Selecione uma linha de informação de chamada para ativar o destino da chamada. </para> </sect2> </sect1> @@ -608,128 +309,42 @@ <chapter id="commands"> -<title ->Referência de Comandos</title> +<title>Referência de Comandos</title> <sect1 id="tdecachegrind-mainwindow"> -<title ->A janela principal do &tdecachegrind;</title> -<para -></para> +<title>A janela principal do &tdecachegrind;</title> +<para></para> <sect2> -<title ->O Menu <guimenu ->Arquivo</guimenu -></title> +<title>O Menu <guimenu>Arquivo</guimenu></title> <para> <variablelist> <varlistentry> -<term -><menuchoice -><shortcut -> <keycombo ->&Ctrl;<keycap ->N</keycap -></keycombo -> </shortcut -> <guimenu ->Arquivo</guimenu -> <guimenuitem ->Novo</guimenuitem -> </menuchoice -></term> -<listitem -><para -><action -> Abre uma nova janela de nível superior de onde você pode carregar dados de auditoria. </action -> Esta ação não é realmente necessária, uma vez que Arquivo/Abrir lhe fornecerá uma nova janela de nível superior quando a atual já estiver exibindo algum dado. </para -></listitem> +<term><menuchoice><shortcut> <keycombo>&Ctrl;<keycap>N</keycap></keycombo> </shortcut> <guimenu>Arquivo</guimenu> <guimenuitem>Novo</guimenuitem> </menuchoice></term> +<listitem><para><action> Abre uma nova janela de nível superior de onde você pode carregar dados de auditoria. </action> Esta ação não é realmente necessária, uma vez que Arquivo/Abrir lhe fornecerá uma nova janela de nível superior quando a atual já estiver exibindo algum dado. </para></listitem> </varlistentry> <varlistentry> -<term -><menuchoice -><shortcut -> <keycombo ->&Ctrl;<keycap ->O</keycap -></keycombo -> </shortcut -> <guimenu ->Arquivo</guimenu -> <guimenuitem ->Abrir</guimenuitem -> </menuchoice -></term> -<listitem -><para -><action -> Exibe o Diálogo de Abertura de Arquivo para escolher um arquivo de dados de auditoria a ser carregado. </action -> Se já existir algum dado sendo mostrado na janela de nível superior atual, ele abrirá uma nova janela. Se você deseja abrir dados de auditoria adicionais na janela atual, use Arquivo/Adicionar. </para> -<para ->Os nomes dos arquivos de dados de auditoria normalmente terminam em ..-, onde o último trecho é opcional e usado por arquivos de dados de auditoria múltiplos ao longo da execução de um aplicativo. Ao carregar um arquivo terminando somente com ., eventualmente existindo outros arquivos de dados para esta execução, mas com pontos adicionais, serão também carregados. </para> -<para ->Exemplo: Se existir arquivos de dados de auditoria cachegrind.out.123 e cachegrind.out.123.1, carregando o primeiro, o segundo será automaticamente carregado também. </para -></listitem> +<term><menuchoice><shortcut> <keycombo>&Ctrl;<keycap>O</keycap></keycombo> </shortcut> <guimenu>Arquivo</guimenu> <guimenuitem>Abrir</guimenuitem> </menuchoice></term> +<listitem><para><action> Exibe o Diálogo de Abertura de Arquivo para escolher um arquivo de dados de auditoria a ser carregado. </action> Se já existir algum dado sendo mostrado na janela de nível superior atual, ele abrirá uma nova janela. Se você deseja abrir dados de auditoria adicionais na janela atual, use Arquivo/Adicionar. </para> +<para>Os nomes dos arquivos de dados de auditoria normalmente terminam em ..-, onde o último trecho é opcional e usado por arquivos de dados de auditoria múltiplos ao longo da execução de um aplicativo. Ao carregar um arquivo terminando somente com ., eventualmente existindo outros arquivos de dados para esta execução, mas com pontos adicionais, serão também carregados. </para> +<para>Exemplo: Se existir arquivos de dados de auditoria cachegrind.out.123 e cachegrind.out.123.1, carregando o primeiro, o segundo será automaticamente carregado também. </para></listitem> </varlistentry> <varlistentry> -<term -><menuchoice -><guimenu ->Arquivo</guimenu -> <guimenuitem ->Adicionar</guimenuitem -> </menuchoice -></term> -<listitem -><para -><action -> Adiciona uma arquivo de dados de auditoria à janela atual. </action -> Com isto, você pode forçar que arquivos de dados múltiplos sejam carregados em uma mesma janela de nível superior mesmo se eles não vierem da mesma execução fornecida por uma convenção de nomeação de arquivos de dados de auditoria. Por exemplo, use-o para comparações lado a lado. </para -></listitem> +<term><menuchoice><guimenu>Arquivo</guimenu> <guimenuitem>Adicionar</guimenuitem> </menuchoice></term> +<listitem><para><action> Adiciona uma arquivo de dados de auditoria à janela atual. </action> Com isto, você pode forçar que arquivos de dados múltiplos sejam carregados em uma mesma janela de nível superior mesmo se eles não vierem da mesma execução fornecida por uma convenção de nomeação de arquivos de dados de auditoria. Por exemplo, use-o para comparações lado a lado. </para></listitem> </varlistentry> <varlistentry> -<term -><menuchoice -><guimenu ->Arquivo</guimenu -> <guimenuitem ->Recarregar</guimenuitem -> </menuchoice -></term> -<listitem -><para -><action -> Recarrega os dados de auditoria. </action -> Isto é mais interessante após outro arquivo de dados de auditoria ter sido gerado pela execução de um aplicativo já carregado. </para -></listitem> +<term><menuchoice><guimenu>Arquivo</guimenu> <guimenuitem>Recarregar</guimenuitem> </menuchoice></term> +<listitem><para><action> Recarrega os dados de auditoria. </action> Isto é mais interessante após outro arquivo de dados de auditoria ter sido gerado pela execução de um aplicativo já carregado. </para></listitem> </varlistentry> <varlistentry> -<term -><menuchoice -><shortcut -> <keycombo ->&Ctrl;<keycap ->S</keycap -></keycombo -> </shortcut -> <guimenu ->Arquivo</guimenu -> <guimenuitem ->Sair</guimenuitem -> </menuchoice -></term> -<listitem -><para -><action ->Sai</action -> do &kappname;</para -></listitem> +<term><menuchoice><shortcut> <keycombo>&Ctrl;<keycap>S</keycap></keycombo> </shortcut> <guimenu>Arquivo</guimenu> <guimenuitem>Sair</guimenuitem> </menuchoice></term> +<listitem><para><action>Sai</action> do &kappname;</para></listitem> </varlistentry> </variablelist> </para> @@ -737,96 +352,33 @@ </sect2> <sect2> -<title ->O Menu <guimenu ->Ver</guimenu -></title> +<title>O Menu <guimenu>Ver</guimenu></title> <para> <variablelist> <varlistentry> -<term -><menuchoice -><guimenu ->Ver</guimenu -> <guimenuitem ->Tipo de Evento Primário</guimenuitem -> </menuchoice -></term> -<listitem -><para -><action ->(A ser feito)</action -></para -></listitem> +<term><menuchoice><guimenu>Ver</guimenu> <guimenuitem>Tipo de Evento Primário</guimenuitem> </menuchoice></term> +<listitem><para><action>(A ser feito)</action></para></listitem> </varlistentry> <varlistentry> -<term -><menuchoice -><guimenu ->Ver</guimenu -> <guimenuitem ->Tipo de Evento Sevundário</guimenuitem -> </menuchoice -></term> -<listitem -><para -><action ->(A ser feito)</action -></para -></listitem> +<term><menuchoice><guimenu>Ver</guimenu> <guimenuitem>Tipo de Evento Sevundário</guimenuitem> </menuchoice></term> +<listitem><para><action>(A ser feito)</action></para></listitem> </varlistentry> <varlistentry> -<term -><menuchoice -><guimenu ->Ver</guimenu -> <guimenuitem ->Agrupamento</guimenuitem -> </menuchoice -></term> -<listitem -><para -><action ->(A ser feito)</action -></para -></listitem> +<term><menuchoice><guimenu>Ver</guimenu> <guimenuitem>Agrupamento</guimenuitem> </menuchoice></term> +<listitem><para><action>(A ser feito)</action></para></listitem> </varlistentry> <varlistentry> -<term -><menuchoice -><guimenu ->Ver</guimenu -> <guimenuitem ->Disposição</guimenuitem -> </menuchoice -></term> -<listitem -><para -><action ->(A ser feito)</action -></para -></listitem> +<term><menuchoice><guimenu>Ver</guimenu> <guimenuitem>Disposição</guimenuitem> </menuchoice></term> +<listitem><para><action>(A ser feito)</action></para></listitem> </varlistentry> <varlistentry> -<term -><menuchoice -><guimenu ->Ver</guimenu -> <guimenuitem ->Dividir</guimenuitem -> </menuchoice -></term> -<listitem -><para -><action ->(A ser feito)</action -></para -></listitem> +<term><menuchoice><guimenu>Ver</guimenu> <guimenuitem>Dividir</guimenuitem> </menuchoice></term> +<listitem><para><action>(A ser feito)</action></para></listitem> </varlistentry> </variablelist> @@ -839,56 +391,44 @@ </chapter> <chapter id="faq"> -<title ->Perguntas e Respostas</title> +<title>Perguntas e Respostas</title> &reporting.bugs; &updating.documentation; <qandaset id="faqlist"> <qandaentry> <question> -<para ->Para que serve o &tdecachegrind;? Eu não faço a mínima idéia. </para> +<para>Para que serve o &tdecachegrind;? Eu não faço a mínima idéia. </para> </question> <answer> -<para ->O &tdecachegrind; é útil no último estágio de desenvolvimento de software, chamado Auditoria. Se você não desenvolve aplicativos, você não precisa do &tdecachegrind;. </para> +<para>O &tdecachegrind; é útil no último estágio de desenvolvimento de software, chamado Auditoria. Se você não desenvolve aplicativos, você não precisa do &tdecachegrind;. </para> </answer> </qandaentry> <qandaentry> <question> -<para ->Qual a diferença entre 'Inclusivo' e 'Próprio'? </para> +<para>Qual a diferença entre 'Inclusivo' e 'Próprio'? </para> </question> <answer> -<para ->Estes são atributos de custo para funções relativos a algum tipo de evento. Como funções podem chamar outras, faz sentido distinguir o custo da função propriamente dita ('Custo Próprio') e o cuso incluindo todas as chamadas de funções ('Custo Inclusivo'). 'Próprio' é algumas vezes também referenciado como custo 'Exclusivo'. </para> -<para ->Assim, por exemplo para o main(), você sempre terá um custo inclusivo de cerca de 100%, visto que o custo próprio e negligenciado quando o trabalho real é feito em outra função. </para> +<para>Estes são atributos de custo para funções relativos a algum tipo de evento. Como funções podem chamar outras, faz sentido distinguir o custo da função propriamente dita ('Custo Próprio') e o cuso incluindo todas as chamadas de funções ('Custo Inclusivo'). 'Próprio' é algumas vezes também referenciado como custo 'Exclusivo'. </para> +<para>Assim, por exemplo para o main(), você sempre terá um custo inclusivo de cerca de 100%, visto que o custo próprio e negligenciado quando o trabalho real é feito em outra função. </para> </answer> </qandaentry> <qandaentry> <question> -<para ->A barra de menu/ferramentas do meu KCachegrind parece espartana. Isto é normal?</para> +<para>A barra de menu/ferramentas do meu KCachegrind parece espartana. Isto é normal?</para> </question> <answer> -<para ->Obviamente o KCachegrind foi erradamente instalado em seu sistema. É recomendável compilá-lo com o prefixo de instalação do diretório base do sistema completo do KDE como <command ->configure --prefix=/opt/kde3; make install</command ->. Se você selecionar outro diretório como $HOME/kde, você deve configurar a variável de ambiente TDEDIR para o diretório correto do sistema antes de executar o KCachegrind. </para> +<para>Obviamente o KCachegrind foi erradamente instalado em seu sistema. É recomendável compilá-lo com o prefixo de instalação do diretório base do sistema completo do KDE como <command>configure --prefix=/opt/kde3; make install</command>. Se você selecionar outro diretório como $HOME/kde, você deve configurar a variável de ambiente TDEDIR para o diretório correto do sistema antes de executar o KCachegrind. </para> </answer> </qandaentry> <qandaentry> <question> -<para ->Se eu der um duplo-clique em uma função abaixo da Visão do Gráfico de Chamadas, ele mostra para a função principal o mesmo custo da função selecionada. Isto não é supostamente um 100% costante? </para> +<para>Se eu der um duplo-clique em uma função abaixo da Visão do Gráfico de Chamadas, ele mostra para a função principal o mesmo custo da função selecionada. Isto não é supostamente um 100% costante? </para> </question> <answer> -<para ->Você terá ativado uma função abaixo do main() com custo menor que o main(). Para qualquer função, somente esta parte do custo total da função é mostrado, que é gasta enquanto a função ativada está rodando. Isto é, o custo mostrado para qualquer função nunca pode ser maior que o custo da função ativada. </para> +<para>Você terá ativado uma função abaixo do main() com custo menor que o main(). Para qualquer função, somente esta parte do custo total da função é mostrado, que é gasta enquanto a função ativada está rodando. Isto é, o custo mostrado para qualquer função nunca pode ser maior que o custo da função ativada. </para> </answer> </qandaentry> @@ -897,59 +437,21 @@ </chapter> <chapter id="glossary"> -<title ->Glossário</title> - -<para ->A seguir está uma lista mesclada de termos. <itemizedlist> -<listitem -><para ->Auditoria: O processo de coletar informações estatísticas sobre as características de tempo de execução de um programa. </para -></listitem> -<listitem -><para ->Rastreamento: O processo de supervisionar a execução de um programa e armazenar eventos ocorridos ordenados por uma estampa de tempo em um arquivo de saída, para Rastreio. </para -></listitem> -<listitem -><para ->Rastreio: Uma sequência de eventos com estampas de tempo que ocorreram durante o rastreamento da execução de um programa. Seu tamanho é tipicamente linear em função do tempo de execução de um programa. </para -></listitem> -<listitem -><para ->Arquivo de Dados de Auditoria: Um arquivo contendo dados medidos em um experimento de auditoria (ou parte de) ou produzidos por processamento posterior de um rastreio. Seu tamanho é tipicamente linear em função do tamanho do código do programa. </para -></listitem> -<listitem -><para ->Parte da Dados de Auditoria (incorretamente também usado: Parte de Rastreio): Dados de um arquivo de dados de auditoria. </para -></listitem> -<listitem -><para ->Experimento de Auditoria: Um programa executado sob supervisão de uma ferramenta de auditoria, produzindo possivelmente múltiplos arquivos de dados de auditoria a partir de partes e/ou linhas de execução. </para -></listitem> -<listitem -><para ->Projeto de Auditoria: Uma configuração para experimentos de auditoria usados para um programa que será auditado, talvez em versões múltiplas. Comparações de dados auditados tipicamente só fazem sentido entre dados auditados produzidos em experimentos de um projeto de auditoria. </para -></listitem> -<listitem -><para ->Entidade de Custo: Um ítem abstrato relacionado ao código fonte no qual a contagem de eventos pode ser atribuída. Dimensões para entidades de custo são localização de código (por exemplo, linha da fonte, função), localização de dados (por exemplo, tipo de dado acessado, objeto de dados), localização da execução (por exemplo, linha, processo), e referências das posições mencionadas (por exemplo chamadas, acesso a objetos a partir de sentenças, dados descartados da cache). </para -></listitem> -<listitem -><para ->Tipo de Evento: O tipo de evento do qual custos podem ser atribuídos para uma entidade de custo. Aqui existem tipos de eventos reais e tipos de eventos herdados. </para -></listitem> -<listitem -><para ->Tipo de Evento Real: Um tipo de evento que pode ser medido por uma ferramenta. Ele precisa da existência de um sensor para o tipo de evento fornecido. </para -></listitem> -<listitem -><para ->Tipo de Evento Herdado: Um tipo de evento virtual somente visível na visualização que é definido por uma fórmula a ser calculada a partir de tipos de eventos reais. </para -></listitem> -<listitem -><para ->Custos de Evento: Soma de eventos de algum tipo de evento ocorrido durante a execução é relacionada a alguma entidade de custo. O custo é atribuído à entidade. </para -></listitem> +<title>Glossário</title> + +<para>A seguir está uma lista mesclada de termos. <itemizedlist> +<listitem><para>Auditoria: O processo de coletar informações estatísticas sobre as características de tempo de execução de um programa. </para></listitem> +<listitem><para>Rastreamento: O processo de supervisionar a execução de um programa e armazenar eventos ocorridos ordenados por uma estampa de tempo em um arquivo de saída, para Rastreio. </para></listitem> +<listitem><para>Rastreio: Uma sequência de eventos com estampas de tempo que ocorreram durante o rastreamento da execução de um programa. Seu tamanho é tipicamente linear em função do tempo de execução de um programa. </para></listitem> +<listitem><para>Arquivo de Dados de Auditoria: Um arquivo contendo dados medidos em um experimento de auditoria (ou parte de) ou produzidos por processamento posterior de um rastreio. Seu tamanho é tipicamente linear em função do tamanho do código do programa. </para></listitem> +<listitem><para>Parte da Dados de Auditoria (incorretamente também usado: Parte de Rastreio): Dados de um arquivo de dados de auditoria. </para></listitem> +<listitem><para>Experimento de Auditoria: Um programa executado sob supervisão de uma ferramenta de auditoria, produzindo possivelmente múltiplos arquivos de dados de auditoria a partir de partes e/ou linhas de execução. </para></listitem> +<listitem><para>Projeto de Auditoria: Uma configuração para experimentos de auditoria usados para um programa que será auditado, talvez em versões múltiplas. Comparações de dados auditados tipicamente só fazem sentido entre dados auditados produzidos em experimentos de um projeto de auditoria. </para></listitem> +<listitem><para>Entidade de Custo: Um ítem abstrato relacionado ao código fonte no qual a contagem de eventos pode ser atribuída. Dimensões para entidades de custo são localização de código (por exemplo, linha da fonte, função), localização de dados (por exemplo, tipo de dado acessado, objeto de dados), localização da execução (por exemplo, linha, processo), e referências das posições mencionadas (por exemplo chamadas, acesso a objetos a partir de sentenças, dados descartados da cache). </para></listitem> +<listitem><para>Tipo de Evento: O tipo de evento do qual custos podem ser atribuídos para uma entidade de custo. Aqui existem tipos de eventos reais e tipos de eventos herdados. </para></listitem> +<listitem><para>Tipo de Evento Real: Um tipo de evento que pode ser medido por uma ferramenta. Ele precisa da existência de um sensor para o tipo de evento fornecido. </para></listitem> +<listitem><para>Tipo de Evento Herdado: Um tipo de evento virtual somente visível na visualização que é definido por uma fórmula a ser calculada a partir de tipos de eventos reais. </para></listitem> +<listitem><para>Custos de Evento: Soma de eventos de algum tipo de evento ocorrido durante a execução é relacionada a alguma entidade de custo. O custo é atribuído à entidade. </para></listitem> </itemizedlist> </para> </chapter> @@ -957,52 +459,36 @@ <chapter id="credits"> -<title ->Créditos e Licença</title> +<title>Créditos e Licença</title> -<para ->&kappname; </para> -<para ->Agradecimentos à Julian Seward pelo excelente &valgrind;, e Nicholas Nethercote pela adição do &cachegrind;. Sem estes programas, o <application ->KCachegrind</application -> não existiria. Muitas idéias para esta &GUI; também vieram deles. </para> -<para ->E agradecimentos a todos os diferentes usuários que reportaram erros/sugestões. </para> +<para>&kappname; </para> +<para>Agradecimentos à Julian Seward pelo excelente &valgrind;, e Nicholas Nethercote pela adição do &cachegrind;. Sem estes programas, o <application>KCachegrind</application> não existiria. Muitas idéias para esta &GUI; também vieram deles. </para> +<para>E agradecimentos a todos os diferentes usuários que reportaram erros/sugestões. </para> &underFDL; </chapter> <appendix id="installation"> -<title ->Instalação</title> +<title>Instalação</title> <sect1 id="getting-tdecachegrind"> -<title ->Como obter o &tdecachegrind;</title> +<title>Como obter o &tdecachegrind;</title> -<para ->O &tdecachegrind; é parte do pacote &package; do &kde;. Para versões menos suportadas, &callgrind; e documentação adicional, veja a página web em <ulink url="http://tdecachegrind.sf.net" ->http://tdecachegrind.sf.net</ulink ->. Lá você obterá instruções completas para instalação e compilação. </para> +<para>O &tdecachegrind; é parte do pacote &package; do &kde;. Para versões menos suportadas, &callgrind; e documentação adicional, veja a página web em <ulink url="http://tdecachegrind.sf.net">http://tdecachegrind.sf.net</ulink>. Lá você obterá instruções completas para instalação e compilação. </para> </sect1> <sect1 id="requirements"> -<title ->Requisitos</title> +<title>Requisitos</title> -<para ->Para usar com sucesso o &tdecachegrind;, você precisa do &kde; 3.x. Para gerar dados de auditoria, o &cachegrind; ou o &calltree;/&callgrind; é recomendável. </para> +<para>Para usar com sucesso o &tdecachegrind;, você precisa do &kde; 3.x. Para gerar dados de auditoria, o &cachegrind; ou o &calltree;/&callgrind; é recomendável. </para> </sect1> <sect1 id="compilation"> -<title ->Compilação e Instalação</title> +<title>Compilação e Instalação</title> &install.compile.documentation; </sect1> <sect1 id="configuration"> -<title ->Configuração</title> +<title>Configuração</title> -<para ->Todas as opções de configuração estão tanto no diálogo de configuração como nos menus de contexto das visualizações. </para> +<para>Todas as opções de configuração estão tanto no diálogo de configuração como nos menus de contexto das visualizações. </para> </sect1> diff --git a/tde-i18n-pt_BR/docs/tdesdk/umbrello/authors.docbook b/tde-i18n-pt_BR/docs/tdesdk/umbrello/authors.docbook index 18116121ead..bfa9ddc5e2e 100644 --- a/tde-i18n-pt_BR/docs/tdesdk/umbrello/authors.docbook +++ b/tde-i18n-pt_BR/docs/tdesdk/umbrello/authors.docbook @@ -1,46 +1,15 @@ <chapter id="authors"> -<title ->Autores e Histórico</title> -<para ->Este projeto foi iniciado por Paul Hensgen como um de seus projetos Universitários. O nome original do aplicativo era <application ->Modelador UML</application ->. Paul fez todo o desenvolvimento até o final de 2001 quando o programa atingiu sua versão 1.0. </para> -<para ->A versão 1.0 já oferecia muitas funcionalidades, mas após o projeto ter sido revisado pela Universidade de Paul, outros desenvolvedores puderam juntar-se e iniciaram fazendo contribuições importantes para o <application ->Modelador UML</application ->, como alternar de um formato binário de arquivo para um arquivo &XML;, suporte para mais tipos de Diagramas &UML;, Geração de Código e Importação de Código apenas para citar algumas. </para> -<para ->Paul retirou-se da equipe de desenvolvimento no Verão de 2002 mas, como um Software Livre e de Código Aberto, o programa continua a melhorar e evoluir, e está sendo mantido por um grupo de desenvolvedores de diferentes partes do mundo. Em Setembro de 2002, o projeto mudou seu nome de <application ->Modelador &UML;</application ->, para &umbrello;. Existiram várias razões para a mudança do nome, a mais importante sendo que apenas <quote ->uml</quote ->— como é comumente conhecido — é um nome muito genérico e causa problemas com alguns distribuidores. A outra razão importante é que os desenvolvedores acham <application ->Umbrello</application -> um nome mais legal. </para> -<para ->O desenvolvimento do &umbrello; assim como as discussões sobre para onde o programa deve progredir nas versões futuras é aberto e ocorre na Internet. Se você gostaria de contribuir para o projeto, por favor não hesite em contactar os desenvolvedores. Existem muitas maneiras nas quais você pode auxiliar o &umbrello;: </para> +<title>Autores e Histórico</title> +<para>Este projeto foi iniciado por Paul Hensgen como um de seus projetos Universitários. O nome original do aplicativo era <application>Modelador UML</application>. Paul fez todo o desenvolvimento até o final de 2001 quando o programa atingiu sua versão 1.0. </para> +<para>A versão 1.0 já oferecia muitas funcionalidades, mas após o projeto ter sido revisado pela Universidade de Paul, outros desenvolvedores puderam juntar-se e iniciaram fazendo contribuições importantes para o <application>Modelador UML</application>, como alternar de um formato binário de arquivo para um arquivo &XML;, suporte para mais tipos de Diagramas &UML;, Geração de Código e Importação de Código apenas para citar algumas. </para> +<para>Paul retirou-se da equipe de desenvolvimento no Verão de 2002 mas, como um Software Livre e de Código Aberto, o programa continua a melhorar e evoluir, e está sendo mantido por um grupo de desenvolvedores de diferentes partes do mundo. Em Setembro de 2002, o projeto mudou seu nome de <application>Modelador &UML;</application>, para &umbrello;. Existiram várias razões para a mudança do nome, a mais importante sendo que apenas <quote>uml</quote>— como é comumente conhecido — é um nome muito genérico e causa problemas com alguns distribuidores. A outra razão importante é que os desenvolvedores acham <application>Umbrello</application> um nome mais legal. </para> +<para>O desenvolvimento do &umbrello; assim como as discussões sobre para onde o programa deve progredir nas versões futuras é aberto e ocorre na Internet. Se você gostaria de contribuir para o projeto, por favor não hesite em contactar os desenvolvedores. Existem muitas maneiras nas quais você pode auxiliar o &umbrello;: </para> <itemizedlist> -<listitem -><para ->Relatando erros ou sugerindo melhorias</para -></listitem> -<listitem -><para ->Corrigindo erros e adicionando recursos</para -></listitem> -<listitem -><para ->Escrevendo uma boa documentação ou traduzindo para outros idiomas</para -></listitem> -<listitem -><para ->E é claro...codificando conosco!</para -></listitem> +<listitem><para>Relatando erros ou sugerindo melhorias</para></listitem> +<listitem><para>Corrigindo erros e adicionando recursos</para></listitem> +<listitem><para>Escrevendo uma boa documentação ou traduzindo para outros idiomas</para></listitem> +<listitem><para>E é claro...codificando conosco!</para></listitem> </itemizedlist> -<para ->Como voçê viu, existem muitas maneiras de contribuir. Todas elas são muito importantes e todos são bem vindos a participar. </para> -<para ->Os desenvolvedores do &umbrello; podem ser contactados em <email ->uml-devel@lists.sourceforge.net</email ->. </para> +<para>Como voçê viu, existem muitas maneiras de contribuir. Todas elas são muito importantes e todos são bem vindos a participar. </para> +<para>Os desenvolvedores do &umbrello; podem ser contactados em <email>uml-devel@lists.sourceforge.net</email>. </para> </chapter> diff --git a/tde-i18n-pt_BR/docs/tdesdk/umbrello/code_import_and_generation.docbook b/tde-i18n-pt_BR/docs/tdesdk/umbrello/code_import_and_generation.docbook index c299f837341..c84bb7cee17 100644 --- a/tde-i18n-pt_BR/docs/tdesdk/umbrello/code_import_and_generation.docbook +++ b/tde-i18n-pt_BR/docs/tdesdk/umbrello/code_import_and_generation.docbook @@ -1,163 +1,82 @@ <chapter id="code-import-generation"> -<title ->Importação de Código e Geração de Código</title> -<para ->O &umbrello; é uma ferramenta de modelagem &UML;, e como tal seu principal propósito é auxiliá-lo na <emphasis ->análise e desenho</emphasis -> de seus sistemas. No entanto, para fazer a transição entre seu desenho e sua <emphasis ->implementação</emphasis ->, o &umbrello; permite gerar código fonte numa linguagem de programação que você conheça. Se você quiser iniciar o uso do &UML; num projeto em C++ já iniciado, o &umbrello; pode auxiliá-lo a criar um modelo de seu sistema a partir do código fonte analisando seu código e importando as classes encontradas nele. </para> +<title>Importação de Código e Geração de Código</title> +<para>O &umbrello; é uma ferramenta de modelagem &UML;, e como tal seu principal propósito é auxiliá-lo na <emphasis>análise e desenho</emphasis> de seus sistemas. No entanto, para fazer a transição entre seu desenho e sua <emphasis>implementação</emphasis>, o &umbrello; permite gerar código fonte numa linguagem de programação que você conheça. Se você quiser iniciar o uso do &UML; num projeto em C++ já iniciado, o &umbrello; pode auxiliá-lo a criar um modelo de seu sistema a partir do código fonte analisando seu código e importando as classes encontradas nele. </para> <sect1 id="code-generation"> -<title ->Geração de Código</title> -<para ->O &umbrello; pode gerar código fonte a partir de várias linguagens de programação baseadas no seu Modelo &UML; para auxiliá-lo no início com a implementação do seu projeto. O código gerado consiste de declarações de classe, com seus métodos e atributos de modo que você possa <quote ->preencher as lacunas</quote -> fornecendo a funcionalidade das suas operações de classes. </para> -<para ->O &umbrello; 1.2 vem com suporte à geração de código para ActionScript, Ada, C++, CORBA IDL, &Java;, JavaScript, <acronym ->PHP</acronym ->, Perl, Python, SQL e Esquema XML. </para> +<title>Geração de Código</title> +<para>O &umbrello; pode gerar código fonte a partir de várias linguagens de programação baseadas no seu Modelo &UML; para auxiliá-lo no início com a implementação do seu projeto. O código gerado consiste de declarações de classe, com seus métodos e atributos de modo que você possa <quote>preencher as lacunas</quote> fornecendo a funcionalidade das suas operações de classes. </para> +<para>O &umbrello; 1.2 vem com suporte à geração de código para ActionScript, Ada, C++, CORBA IDL, &Java;, JavaScript, <acronym>PHP</acronym>, Perl, Python, SQL e Esquema XML. </para> <sect2 id="generate-code"> -<title ->Gerando Código</title> -<para ->Para gerar código como o &umbrello;, você primeiro precisa criar ou carregar um Modelo contendo pelo menos uma classe. Quando você estiver pronto para iniciar a escrita de algum código, selecione a entrada do <guimenuitem ->Assistente de Geração de Código</guimenuitem -> no menu <guimenuitem ->Código</guimenuitem -> para iniciar um Assistente que o guiará através do processo de geração de código. </para> -<para ->O primeiro passo é selecionar as classes para quais você deseja gerar código fonte. Por padrão todas as classes de seu modelo serão selecionadas, e você pode remover as que não deseja que seja gerado código movendo-as para o lado esquerdo da lista. </para> -<para ->O próximo passo do assistente lhe permite modificar os parâmetros que o Gerador de Código usa ao escrever seu código. As seguintes opções estão disponíveis: </para> +<title>Gerando Código</title> +<para>Para gerar código como o &umbrello;, você primeiro precisa criar ou carregar um Modelo contendo pelo menos uma classe. Quando você estiver pronto para iniciar a escrita de algum código, selecione a entrada do <guimenuitem>Assistente de Geração de Código</guimenuitem> no menu <guimenuitem>Código</guimenuitem> para iniciar um Assistente que o guiará através do processo de geração de código. </para> +<para>O primeiro passo é selecionar as classes para quais você deseja gerar código fonte. Por padrão todas as classes de seu modelo serão selecionadas, e você pode remover as que não deseja que seja gerado código movendo-as para o lado esquerdo da lista. </para> +<para>O próximo passo do assistente lhe permite modificar os parâmetros que o Gerador de Código usa ao escrever seu código. As seguintes opções estão disponíveis: </para> <para> <screenshot> -<screeninfo ->Opções de Geração de Código</screeninfo> +<screeninfo>Opções de Geração de Código</screeninfo> <mediaobject> <imageobject> <imagedata fileref="generation-options.png" format="PNG"/> </imageobject> <textobject> - <phrase ->Opções para a Geração de Código no &umbrello;</phrase> + <phrase>Opções para a Geração de Código no &umbrello;</phrase> </textobject> <caption> - <para ->Opções para a Geração de Código no &umbrello; </para> + <para>Opções para a Geração de Código no &umbrello; </para> </caption> </mediaobject> </screenshot> </para> <sect3 id="generation-options"> -<title ->Opções Gerais</title> +<title>Opções Gerais</title> <!-- LW; to rearrange --> <sect4> -<title ->Verbosidade do Código</title> -<para ->A opção <guilabel ->Escrever cometários da documentação se vazios</guilabel -> instrui o Gerador de Código a escrever comentários no estilo /** blah */ sempre que o bloco de comentários estiver vazio. Se você adicionar documentação a sua classe, métodos ou atributos em seu Modelo, o Gerador de Código escreverá estes comentários como documentação <application ->Doxygen</application -> a menos que você configure algo aqui, mas se você selecionar esta opção o &umbrello; escreverá blocos de comentários para todas as classes, métodos e atributos se não houver nenhuma documentação no Modelo, caso contrário você deverá documentar suas classes posteriormente diretamente no código fonte. </para> -<para -><guilabel ->Escrever comentários para seções se seção estiver vazia</guilabel -> faz com que o &umbrello; escreva comentários no código fonte para delimitar as diferentes seções de uma classe. Por exemplo <quote ->métodos públicos</quote -> ou <quote ->Atributos</quote -> antes das seções correspondentes. Se você selecionar esta opção o &umbrello; escreverá comentários para todas as seções da classe se a seção estiver vazia. Por exemplo, ele escreverá um comentário <quote ->métodos protegidos</quote -> se existem métodos não protegidos em sua classe. </para> +<title>Verbosidade do Código</title> +<para>A opção <guilabel>Escrever cometários da documentação se vazios</guilabel> instrui o Gerador de Código a escrever comentários no estilo /** blah */ sempre que o bloco de comentários estiver vazio. Se você adicionar documentação a sua classe, métodos ou atributos em seu Modelo, o Gerador de Código escreverá estes comentários como documentação <application>Doxygen</application> a menos que você configure algo aqui, mas se você selecionar esta opção o &umbrello; escreverá blocos de comentários para todas as classes, métodos e atributos se não houver nenhuma documentação no Modelo, caso contrário você deverá documentar suas classes posteriormente diretamente no código fonte. </para> +<para><guilabel>Escrever comentários para seções se seção estiver vazia</guilabel> faz com que o &umbrello; escreva comentários no código fonte para delimitar as diferentes seções de uma classe. Por exemplo <quote>métodos públicos</quote> ou <quote>Atributos</quote> antes das seções correspondentes. Se você selecionar esta opção o &umbrello; escreverá comentários para todas as seções da classe se a seção estiver vazia. Por exemplo, ele escreverá um comentário <quote>métodos protegidos</quote> se existem métodos não protegidos em sua classe. </para> </sect4> <sect4> -<title ->Pastas</title> -<para -><guilabel ->Gravar todos os arquivos gerados para pasta</guilabel ->. Aqui você pode selecionar a pasta onde deseja que o &umbrello; coloque os fontes gerados. </para> -<para ->A opção <guilabel ->Incluir arquivos de cabeçalho da pasta</guilabel -> permite-lhe inserir um cabeçalho no início de cada arquivo gerado. Arquivos de cabeçalho podem conter informações de direito de cópia ou licença e conter variáveis que serão avaliados no momento da geração. Você pode dar uma olhada nos arquivos modelos de cabeçalho fornecidos com o &umbrello; para ver como usar estas variáveis para substituir seu nome ou a data atual no momento da geração. </para> +<title>Pastas</title> +<para><guilabel>Gravar todos os arquivos gerados para pasta</guilabel>. Aqui você pode selecionar a pasta onde deseja que o &umbrello; coloque os fontes gerados. </para> +<para>A opção <guilabel>Incluir arquivos de cabeçalho da pasta</guilabel> permite-lhe inserir um cabeçalho no início de cada arquivo gerado. Arquivos de cabeçalho podem conter informações de direito de cópia ou licença e conter variáveis que serão avaliados no momento da geração. Você pode dar uma olhada nos arquivos modelos de cabeçalho fornecidos com o &umbrello; para ver como usar estas variáveis para substituir seu nome ou a data atual no momento da geração. </para> </sect4> <sect4> -<title ->Política de Sobrescrever</title> +<title>Política de Sobrescrever</title> <!-- FIXME update for Umbrello 1.2's new C++ and Java code generators --> -<para ->Esta opção diz ao &umbrello; o que fazer se o arquivo que está sendo criado já existe na pasta destino. O &umbrello; <emphasis ->não pode modificar arquivos fonte existentes</emphasis ->, logo você deve escolher entre sobrescrever o arquivo existente, pular a geração do arquivo em particular ou deixar o &umbrello; escolher um nome de arquivo diferente. Se você escolher a opção de usar um nome diferente, o &umbrello; adicionará um sufixo ao nome do arquivo. </para> +<para>Esta opção diz ao &umbrello; o que fazer se o arquivo que está sendo criado já existe na pasta destino. O &umbrello; <emphasis>não pode modificar arquivos fonte existentes</emphasis>, logo você deve escolher entre sobrescrever o arquivo existente, pular a geração do arquivo em particular ou deixar o &umbrello; escolher um nome de arquivo diferente. Se você escolher a opção de usar um nome diferente, o &umbrello; adicionará um sufixo ao nome do arquivo. </para> </sect4> <sect4> -<title ->Linguagem</title> -<para ->O &umbrello; irá gerar por padrão código na linguagem que você tiver selecionado como Linguagem Ativa, mas com o Assistente de Geração de Código você tem a opção de mudar isto para outra linguagem. </para> +<title>Linguagem</title> +<para>O &umbrello; irá gerar por padrão código na linguagem que você tiver selecionado como Linguagem Ativa, mas com o Assistente de Geração de Código você tem a opção de mudar isto para outra linguagem. </para> </sect4> -</sect3 -><!--generation-options--> +</sect3><!--generation-options--> <sect3 id="generation-wizard-generation"> -<title ->Geração do Assistente de Geração</title> -<para ->O terceiro e último passo do assistente mostra o estado do processo de Geração de Código. Você precisa somente clicar no botão Gerar para ter suas classes escritas para você. </para> -<para ->Observe que as Opções que você selecionou durante o assistente de Geração de Código são válidas somente para a geração atual. Na próxima vez que executar o Assistente você precisará re-selecionar todas as opções (sua pasta de cabeçalhos, política de sobrescrever, e assim por diante). Você pode configurar os padrões usados pelo &umbrello; na seção <guilabel ->Geração de Código</guilabel -> das configurações do Umbrello, disponível em <menuchoice -><guimenu ->Configurações</guimenu -><guimenuitem ->Configurar &umbrello;...</guimenuitem -></menuchoice -> </para> -<para ->Se você tiver configurado suas opções de Geração de Código para as configurações corretas e desejar gerar algum código da mesma maneira sem passar pelo assistente, você pode selecionar a entrada <guimenuitem ->Gerar Todo Código</guimenuitem -> no menu Código. Isto irá gerar código para todas as classes em seu Modelo usando suas configurações atuais (incluindo Pasta de Saída e Política de Sobrescrever, logo use com cuidado). </para> +<title>Geração do Assistente de Geração</title> +<para>O terceiro e último passo do assistente mostra o estado do processo de Geração de Código. Você precisa somente clicar no botão Gerar para ter suas classes escritas para você. </para> +<para>Observe que as Opções que você selecionou durante o assistente de Geração de Código são válidas somente para a geração atual. Na próxima vez que executar o Assistente você precisará re-selecionar todas as opções (sua pasta de cabeçalhos, política de sobrescrever, e assim por diante). Você pode configurar os padrões usados pelo &umbrello; na seção <guilabel>Geração de Código</guilabel> das configurações do Umbrello, disponível em <menuchoice><guimenu>Configurações</guimenu><guimenuitem>Configurar &umbrello;...</guimenuitem></menuchoice> </para> +<para>Se você tiver configurado suas opções de Geração de Código para as configurações corretas e desejar gerar algum código da mesma maneira sem passar pelo assistente, você pode selecionar a entrada <guimenuitem>Gerar Todo Código</guimenuitem> no menu Código. Isto irá gerar código para todas as classes em seu Modelo usando suas configurações atuais (incluindo Pasta de Saída e Política de Sobrescrever, logo use com cuidado). </para> </sect3> -</sect2 -><!--generate-code--> -</sect1 -> <!--code-generation--> +</sect2><!--generate-code--> +</sect1> <!--code-generation--> <sect1 id="code-import"> -<title ->Importar Código</title> -<para ->O &umbrello; pode importar código fonte de seus projetos existentes para auxiliá-lo a construir o Modelo de seus sistemas. O &umbrello; 1.2 suporta somente código fonte C++, mas outras linguagens devem estar disponíveis em versões futuras. </para> -<para ->Para importar classes para seu Modelo, selecione a entrada <guimenuitem ->Importar Classes...</guimenuitem -> no menu <guimenu ->Código</guimenu ->. No diálogo de arquivo selecione os arquivos contendo as declarações de classe C++ e pressione OK. As classes serão importadas e você irá encontrá-las como parte de seu Modelo na Visão Árvore. Observe que o &umbrello; não criará nenhum tipo de Diagrama para mostrar suas classes, elas serão apenas importadas para seu Modelo e então você poderá usá-las mais tarde em qualquer diagrama que desejar. </para> +<title>Importar Código</title> +<para>O &umbrello; pode importar código fonte de seus projetos existentes para auxiliá-lo a construir o Modelo de seus sistemas. O &umbrello; 1.2 suporta somente código fonte C++, mas outras linguagens devem estar disponíveis em versões futuras. </para> +<para>Para importar classes para seu Modelo, selecione a entrada <guimenuitem>Importar Classes...</guimenuitem> no menu <guimenu>Código</guimenu>. No diálogo de arquivo selecione os arquivos contendo as declarações de classe C++ e pressione OK. As classes serão importadas e você irá encontrá-las como parte de seu Modelo na Visão Árvore. Observe que o &umbrello; não criará nenhum tipo de Diagrama para mostrar suas classes, elas serão apenas importadas para seu Modelo e então você poderá usá-las mais tarde em qualquer diagrama que desejar. </para> <para> <screenshot> -<screeninfo ->Importar Código</screeninfo> +<screeninfo>Importar Código</screeninfo> <mediaobject> <imageobject> <imagedata fileref="code-import.png" format="PNG"/> </imageobject> <textobject> - <phrase ->Menu para importação de código fonte no &umbrello;</phrase> + <phrase>Menu para importação de código fonte no &umbrello;</phrase> </textobject> <caption> - <para ->Menu para importação de código fonte no &umbrello; </para> + <para>Menu para importação de código fonte no &umbrello; </para> </caption> </mediaobject> </screenshot> </para> </sect1> -</chapter -> <!--code-import-generation--> +</chapter> <!--code-import-generation--> diff --git a/tde-i18n-pt_BR/docs/tdesdk/umbrello/credits.docbook b/tde-i18n-pt_BR/docs/tdesdk/umbrello/credits.docbook index 6af0c223a0a..dee53c7c7a2 100644 --- a/tde-i18n-pt_BR/docs/tdesdk/umbrello/credits.docbook +++ b/tde-i18n-pt_BR/docs/tdesdk/umbrello/credits.docbook @@ -1,11 +1,6 @@ <chapter id="copyright"> -<title ->Direitos de Cópia</title> +<title>Direitos de Cópia</title> -<para ->Direitos de Cópia 2001, Paul Hensgen</para> -<para ->Direitos de Cópia 2002, 2003 Os Autores do &umbrello;. Veja <ulink url="http://uml.sf.net/developers.php" ->http://uml.sf.net/developers.php</ulink -> para mais informações</para> +<para>Direitos de Cópia 2001, Paul Hensgen</para> +<para>Direitos de Cópia 2002, 2003 Os Autores do &umbrello;. Veja <ulink url="http://uml.sf.net/developers.php">http://uml.sf.net/developers.php</ulink> para mais informações</para> &underFDL; &underGPL; </chapter> diff --git a/tde-i18n-pt_BR/docs/tdesdk/umbrello/index.docbook b/tde-i18n-pt_BR/docs/tdesdk/umbrello/index.docbook index 96bbed477f2..19fe077892a 100644 --- a/tde-i18n-pt_BR/docs/tdesdk/umbrello/index.docbook +++ b/tde-i18n-pt_BR/docs/tdesdk/umbrello/index.docbook @@ -1,14 +1,10 @@ <?xml version="1.0" ?> <!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [ - <!ENTITY umbrello "<application ->Umbrello &UML; Modeller</application ->"> + <!ENTITY umbrello "<application>Umbrello &UML; Modeller</application>"> <!ENTITY kappname "&umbrello;"> <!ENTITY packagename "tdesdk"> - <!ENTITY UML "<acronym ->UML</acronym ->"> + <!ENTITY UML "<acronym>UML</acronym>"> <!ENTITY introduction-chapter SYSTEM "introduction.docbook"> <!ENTITY uml-basics-chapter SYSTEM "uml_basics.docbook"> <!ENTITY working-with-umbrello-chapter SYSTEM "working_with_umbrello.docbook"> @@ -17,59 +13,43 @@ <!ENTITY authors-chapter SYSTEM "authors.docbook"> <!ENTITY credits-chapter SYSTEM "credits.docbook"> <!ENTITY % addindex "IGNORE"> - <!ENTITY % Brazilian-Portuguese "INCLUDE" -><!-- change language only here --> + <!ENTITY % Brazilian-Portuguese "INCLUDE"><!-- change language only here --> <!-- Do not define any other entities; instead, use the entities from kde-genent.entities and $LANG/user.entities. --> ]> <book id="Umbrello" lang="&language;"> <bookinfo> -<title ->Manual do &umbrello;</title> +<title>Manual do &umbrello;</title> <authorgroup> -<corpauthor ->Autores do &umbrello;</corpauthor> +<corpauthor>Autores do &umbrello;</corpauthor> </authorgroup> <copyright> -<year ->2001</year> -<holder ->Paul Hensgen</holder> +<year>2001</year> +<holder>Paul Hensgen</holder> </copyright> <copyright> -<year ->2002, 2003</year> -<holder ->Autores do &umbrello;</holder> +<year>2002, 2003</year> +<holder>Autores do &umbrello;</holder> </copyright> -<date ->2003-10-15</date> -<releaseinfo ->1.2</releaseinfo> +<date>2003-10-15</date> +<releaseinfo>1.2</releaseinfo> <abstract> -<para ->O &umbrello; auxiliar o processo de desenvolvimento de software através do uso do padrão industrial da Linguagem de Modelagem Unificada (&UML;) para permitir-lhe criar diagramas para o desenvolvimento e documentação de seus sistemas. </para> +<para>O &umbrello; auxiliar o processo de desenvolvimento de software através do uso do padrão industrial da Linguagem de Modelagem Unificada (&UML;) para permitir-lhe criar diagramas para o desenvolvimento e documentação de seus sistemas. </para> </abstract> <keywordset> -<keyword ->KDE</keyword> -<keyword ->UML</keyword> -<keyword ->modelando</keyword> -<keyword ->diagramas</keyword> -<keyword ->desenvolvimento de software</keyword> -<keyword ->desenvolvimento</keyword> +<keyword>KDE</keyword> +<keyword>UML</keyword> +<keyword>modelando</keyword> +<keyword>diagramas</keyword> +<keyword>desenvolvimento de software</keyword> +<keyword>desenvolvimento</keyword> </keywordset> </bookinfo> diff --git a/tde-i18n-pt_BR/docs/tdesdk/umbrello/introduction.docbook b/tde-i18n-pt_BR/docs/tdesdk/umbrello/introduction.docbook index 07bb0a128f2..250b2404511 100644 --- a/tde-i18n-pt_BR/docs/tdesdk/umbrello/introduction.docbook +++ b/tde-i18n-pt_BR/docs/tdesdk/umbrello/introduction.docbook @@ -1,57 +1,19 @@ <chapter id="introduction"> -<title ->Introdução</title> +<title>Introdução</title> -<para ->O &umbrello; é uma ferramenta de diagrama &UML; que pode auxiliá-lo no processo de desenvolvimento de software. Especialmente durante as fases de análise e desenho, o &umbrello; lhe auxilia a obter um produto de alta qualidade. A &UML; pode também ser usada para documentar o desenho de seu software para auxiliá-lo e seus companheiros de desenvolvimento. </para> -<para ->Ter um bom modelo de seu software é a melhor maneira de comunicar-se com outros desenvolvedores que estão trabalhando no projeto e com seus clientes. Um bom modelo é extremamente importante para projetos de tamanho médio e grande, mas é também muito útil para projetos pequenos. Caso esteja trabalhando num projeto pequeno, de um desenvolvedor, você se beneficiará com um bom modelo porque ele lhe dará uma visão geral que lhe auxiliará a codificar as coisas da maneira correta na primeira vez. </para> -<para ->A &UML; é uma linguagem de diagramação usada para descrever modelos. Você pode representar suas idéias em &UML; usando diferentes tipos de diagramas. O &umbrello; 1.2 suporta os seguintes tipos: </para> +<para>O &umbrello; é uma ferramenta de diagrama &UML; que pode auxiliá-lo no processo de desenvolvimento de software. Especialmente durante as fases de análise e desenho, o &umbrello; lhe auxilia a obter um produto de alta qualidade. A &UML; pode também ser usada para documentar o desenho de seu software para auxiliá-lo e seus companheiros de desenvolvimento. </para> +<para>Ter um bom modelo de seu software é a melhor maneira de comunicar-se com outros desenvolvedores que estão trabalhando no projeto e com seus clientes. Um bom modelo é extremamente importante para projetos de tamanho médio e grande, mas é também muito útil para projetos pequenos. Caso esteja trabalhando num projeto pequeno, de um desenvolvedor, você se beneficiará com um bom modelo porque ele lhe dará uma visão geral que lhe auxiliará a codificar as coisas da maneira correta na primeira vez. </para> +<para>A &UML; é uma linguagem de diagramação usada para descrever modelos. Você pode representar suas idéias em &UML; usando diferentes tipos de diagramas. O &umbrello; 1.2 suporta os seguintes tipos: </para> <itemizedlist> -<listitem -><para ->Diagrama de Classe</para -></listitem> -<listitem -><para ->Diagrama de Seqüência</para -></listitem> -<listitem -><para ->Diagrama de Colaboração</para -></listitem> -<listitem -><para ->Diagrama de Caso de Uso</para -></listitem> -<listitem -><para ->Diagrama de Estado</para -></listitem> -<listitem -><para ->Diagrama de Atividade</para -></listitem> -<listitem -><para ->Diagrama de Componente</para -></listitem> -<listitem -><para ->Diagrama de Distribuição</para -></listitem> +<listitem><para>Diagrama de Classe</para></listitem> +<listitem><para>Diagrama de Seqüência</para></listitem> +<listitem><para>Diagrama de Colaboração</para></listitem> +<listitem><para>Diagrama de Caso de Uso</para></listitem> +<listitem><para>Diagrama de Estado</para></listitem> +<listitem><para>Diagrama de Atividade</para></listitem> +<listitem><para>Diagrama de Componente</para></listitem> +<listitem><para>Diagrama de Distribuição</para></listitem> </itemizedlist> -<para ->Mais informações sobre &UML; podem ser encontradas no site web da <ulink url="http://www.omg.org" -> <acronym ->OMG</acronym ->, http://www.omg.org.</ulink ->, criadora do padrão &UML;. </para> -<para ->Nós esperamos que você goste do &umbrello; e que ele lhe auxilie a criar software de alta qualidade. O &umbrello; é um Software Livre e disponível gratuitamente, e a única coisa que lhe pedimos é reportar qualquer erro, problemas ou sugestões para os desenvolvedores do &umbrello; em <email ->uml-devel@lists.sourceforge.net</email -> ou <ulink url="http://bugs.kde.org" ->http://bugs.kde.org</ulink ->. </para> +<para>Mais informações sobre &UML; podem ser encontradas no site web da <ulink url="http://www.omg.org"> <acronym>OMG</acronym>, http://www.omg.org.</ulink>, criadora do padrão &UML;. </para> +<para>Nós esperamos que você goste do &umbrello; e que ele lhe auxilie a criar software de alta qualidade. O &umbrello; é um Software Livre e disponível gratuitamente, e a única coisa que lhe pedimos é reportar qualquer erro, problemas ou sugestões para os desenvolvedores do &umbrello; em <email>uml-devel@lists.sourceforge.net</email> ou <ulink url="http://bugs.kde.org">http://bugs.kde.org</ulink>. </para> </chapter> diff --git a/tde-i18n-pt_BR/docs/tdesdk/umbrello/other_features.docbook b/tde-i18n-pt_BR/docs/tdesdk/umbrello/other_features.docbook index 3b7f43a2077..70965248ca0 100644 --- a/tde-i18n-pt_BR/docs/tdesdk/umbrello/other_features.docbook +++ b/tde-i18n-pt_BR/docs/tdesdk/umbrello/other_features.docbook @@ -1,72 +1,35 @@ <chapter id="other-features"> -<title ->Outros Recursos</title> -<sect1 -> -<title ->Outros Recursos do &umbrello;</title> -<para ->Este capítulo explanará sumariamente alguns outros recursos que o &umbrello; lhe oferece.</para> +<title>Outros Recursos</title> +<sect1> +<title>Outros Recursos do &umbrello;</title> +<para>Este capítulo explanará sumariamente alguns outros recursos que o &umbrello; lhe oferece.</para> <sect2 id="copying-as-png"> -<title ->Copiar objetos como imagens PNG</title> -<para ->Além de lhe oferecer as funcionalidades normais de copiar, cortar e colar que você espera para copiar objetos entre diagramas diferentes, o &umbrello; pode copiar os objetos como figuras PNG de modo que você possa inserí-las em outro tipo de documento. Você não precisa fazer nada em especial para usar este recurso, apenas selecione um objeto de um diagrama (Classe, Ator, &etc;) e copie-o (<keycombo ->&Ctrl;<keycap ->C</keycap -></keycombo ->, ou usando o menu), e então abra um documento &kword; (ou qualquer programa para o qual você possa colar imagens) e selecione <guimenuitem ->Colar</guimenuitem ->. Este é um grande recurso para exportar partes de seu diagrama como simples figuras. </para> +<title>Copiar objetos como imagens PNG</title> +<para>Além de lhe oferecer as funcionalidades normais de copiar, cortar e colar que você espera para copiar objetos entre diagramas diferentes, o &umbrello; pode copiar os objetos como figuras PNG de modo que você possa inserí-las em outro tipo de documento. Você não precisa fazer nada em especial para usar este recurso, apenas selecione um objeto de um diagrama (Classe, Ator, &etc;) e copie-o (<keycombo>&Ctrl;<keycap>C</keycap></keycombo>, ou usando o menu), e então abra um documento &kword; (ou qualquer programa para o qual você possa colar imagens) e selecione <guimenuitem>Colar</guimenuitem>. Este é um grande recurso para exportar partes de seu diagrama como simples figuras. </para> </sect2> <sect2 id="export-as-png"> -<title ->Exportando para uma Imagem</title> -<para ->Você pode também exportar um diagrama completo como uma imagem. A única coisa que você precisa fazer é selecionar o diagrama que você deseja exportar, e então a opção <guimenuitem ->Exportar como Figura...</guimenuitem -> no menu <guimenu ->Diagrama</guimenu ->. </para> +<title>Exportando para uma Imagem</title> +<para>Você pode também exportar um diagrama completo como uma imagem. A única coisa que você precisa fazer é selecionar o diagrama que você deseja exportar, e então a opção <guimenuitem>Exportar como Figura...</guimenuitem> no menu <guimenu>Diagrama</guimenu>. </para> </sect2> <sect2 id="printing"> -<title ->Imprimindo</title> -<para ->O &umbrello; permite imprimir diagramas individuais. Pressionar o botão <guiicon ->Imprimir</guiicon -> na barra de ferramentas do aplicativo ou selecionar a opção <guimenuitem ->Imprimir</guimenuitem -> no menu <guimenu ->Arquivo</guimenu -> lhe trará o diálogo padrão de impressão do &kde; a partir do qual você pode imprimir seus diagramas. </para> +<title>Imprimindo</title> +<para>O &umbrello; permite imprimir diagramas individuais. Pressionar o botão <guiicon>Imprimir</guiicon> na barra de ferramentas do aplicativo ou selecionar a opção <guimenuitem>Imprimir</guimenuitem> no menu <guimenu>Arquivo</guimenu> lhe trará o diálogo padrão de impressão do &kde; a partir do qual você pode imprimir seus diagramas. </para> </sect2> <sect2 id="logical-folders"> -<title ->Pastas Lógicas</title> -<para ->Para melhor organizar o seu modelo, especialmente para grandes projetos, você pode criar pastas lógicas na Visão de Árvore. Apenas selecione a opção <menuchoice -><guimenu ->Nova</guimenu -><guimenuitem ->Pasta</guimenuitem -></menuchoice -> no menu de contexto das pastas padrão na Visão de Árvore para criá-las. Pastas podem ser aninhadas, e você pode mover objetos arrastando-os de uma pasta e soltando-os em outra. </para> +<title>Pastas Lógicas</title> +<para>Para melhor organizar o seu modelo, especialmente para grandes projetos, você pode criar pastas lógicas na Visão de Árvore. Apenas selecione a opção <menuchoice><guimenu>Nova</guimenu><guimenuitem>Pasta</guimenuitem></menuchoice> no menu de contexto das pastas padrão na Visão de Árvore para criá-las. Pastas podem ser aninhadas, e você pode mover objetos arrastando-os de uma pasta e soltando-os em outra. </para> <screenshot> -<screeninfo ->Organizando seu Modelo com Pastas</screeninfo> +<screeninfo>Organizando seu Modelo com Pastas</screeninfo> <mediaobject> <imageobject> <imagedata fileref="folders.png" format="PNG"/> </imageobject> <textobject> - <phrase ->Organizando um Modelo com Pastas Lógicas no &umbrello;</phrase> + <phrase>Organizando um Modelo com Pastas Lógicas no &umbrello;</phrase> </textobject> <caption> - <para ->Organizando um Modelo com Pastas Lógicas no &umbrello; </para> + <para>Organizando um Modelo com Pastas Lógicas no &umbrello; </para> </caption> </mediaobject> </screenshot> diff --git a/tde-i18n-pt_BR/docs/tdesdk/umbrello/uml_basics.docbook b/tde-i18n-pt_BR/docs/tdesdk/umbrello/uml_basics.docbook index bba8624bafe..d7f88564f98 100644 --- a/tde-i18n-pt_BR/docs/tdesdk/umbrello/uml_basics.docbook +++ b/tde-i18n-pt_BR/docs/tdesdk/umbrello/uml_basics.docbook @@ -1,378 +1,169 @@ <chapter id="uml-basics"> -<title ->Fundamentos do &UML;</title> +<title>Fundamentos do &UML;</title> <sect1 id="about-uml"> -<title ->Sobre o &UML;</title> -<para ->Este capítulo lhe fornecerá uma visão rápida dos fundamentos da &UML;. Tenha em mente que isto não é um tutorial detalhado sobre &UML;, mas apenas uma rápida introdução a &UML; que pode ser lida como um tutorial &UML;. Se você gostaria de aprender mais sobre a Linguagem de Modelagem Unificada, ou generalidades sobre análise e desenho de software, consulte um dos muitos livros disponíveis sobre o tópico. Existem também muitos tutoriais na Internet os quais você pode usar como ponto de partida. </para> - -<para ->A Linguagem de Modelagem Unificada (Unified Modelling Language - &UML;) é uma linguagem de diagramação ou notação para especificar, visualizar e documentar modelos de sistemas de software Orientados à Objeto. A &UML; não é um método de desenvolvimento, o que significa que ela não diz para você o que fazer primeiro e em seguida ou como desenhar seu sistema, mas ele lhe auxilia a visualizar seu desenho e a comunicação entre objetos. A &UML; é controlada pelo Grupo de Gerenciamento de Objeto (Object Management Group - <acronym ->OMG</acronym ->) e é um padrão da indústria para descrever graficamente software. </para> -<para ->A &UML; é voltada para o desenho de software Orientado à Objeto e tem um uso limitado para outros paradigmas de programação. </para> -<para ->A &UML; é composta por muitos elementos de modelo que representam as diferentes partes de um sistema de software. Os elementos &UML; são usados para criar diagramas, que representam um determinada parte, ou um ponto de vista do sistema. Os seguintes tipos de diagramas são suportados pelo &umbrello;: </para> +<title>Sobre o &UML;</title> +<para>Este capítulo lhe fornecerá uma visão rápida dos fundamentos da &UML;. Tenha em mente que isto não é um tutorial detalhado sobre &UML;, mas apenas uma rápida introdução a &UML; que pode ser lida como um tutorial &UML;. Se você gostaria de aprender mais sobre a Linguagem de Modelagem Unificada, ou generalidades sobre análise e desenho de software, consulte um dos muitos livros disponíveis sobre o tópico. Existem também muitos tutoriais na Internet os quais você pode usar como ponto de partida. </para> + +<para>A Linguagem de Modelagem Unificada (Unified Modelling Language - &UML;) é uma linguagem de diagramação ou notação para especificar, visualizar e documentar modelos de sistemas de software Orientados à Objeto. A &UML; não é um método de desenvolvimento, o que significa que ela não diz para você o que fazer primeiro e em seguida ou como desenhar seu sistema, mas ele lhe auxilia a visualizar seu desenho e a comunicação entre objetos. A &UML; é controlada pelo Grupo de Gerenciamento de Objeto (Object Management Group - <acronym>OMG</acronym>) e é um padrão da indústria para descrever graficamente software. </para> +<para>A &UML; é voltada para o desenho de software Orientado à Objeto e tem um uso limitado para outros paradigmas de programação. </para> +<para>A &UML; é composta por muitos elementos de modelo que representam as diferentes partes de um sistema de software. Os elementos &UML; são usados para criar diagramas, que representam um determinada parte, ou um ponto de vista do sistema. Os seguintes tipos de diagramas são suportados pelo &umbrello;: </para> <itemizedlist> -<listitem -><para -><emphasis -><link linkend="use-case-diagram" ->Diagrama de Caso de Uso</link -></emphasis -> mostra atores (pessoas ou outros usuários do sistema), casos de uso (os cenários onde eles usam o sistema), e seus relacionamentos</para -> </listitem> - -<listitem -><para -><emphasis -><link linkend="class-diagram" ->Diagrama de Classe</link -></emphasis -> mostra classes e os relacionamentos entre elas</para -> </listitem> - -<listitem -><para -><emphasis -><link linkend="sequence-diagram" ->Diagrama de Seqüência</link -></emphasis -> mostra objetos e uma seqüência das chamadas do método feitas para outros objetos.</para -> </listitem> - -<listitem -><para -><emphasis -><link linkend="collaboration-diagram" ->Diagrama de Colaboração</link -></emphasis -> mostra objetos e seus relacionamentos, colocando ênfase nos objetos que participam na troca de mensagens</para> +<listitem><para><emphasis><link linkend="use-case-diagram">Diagrama de Caso de Uso</link></emphasis> mostra atores (pessoas ou outros usuários do sistema), casos de uso (os cenários onde eles usam o sistema), e seus relacionamentos</para> </listitem> + +<listitem><para><emphasis><link linkend="class-diagram">Diagrama de Classe</link></emphasis> mostra classes e os relacionamentos entre elas</para> </listitem> + +<listitem><para><emphasis><link linkend="sequence-diagram">Diagrama de Seqüência</link></emphasis> mostra objetos e uma seqüência das chamadas do método feitas para outros objetos.</para> </listitem> + +<listitem><para><emphasis><link linkend="collaboration-diagram">Diagrama de Colaboração</link></emphasis> mostra objetos e seus relacionamentos, colocando ênfase nos objetos que participam na troca de mensagens</para> </listitem> -<listitem -><para -><emphasis -><link linkend="state-diagram" ->Diagrama de Estado</link -></emphasis -> mostra estados, mudanças de estado e eventos num objeto ou uma parte do sistema</para -> </listitem> - -<listitem -><para -><emphasis -><link linkend="activity-diagram" ->Diagrama de Atividade</link -></emphasis -> mostra atividades e as mudanças de uma atividade para outra com os eventos ocorridos em alguma parte do sistema</para -></listitem> - -<listitem -><para -><emphasis -><link linkend="component-diagram" ->Diagrama de Componente</link -></emphasis -> mostra os componentes de programação de alto nível (como KParts ou Java Beans).</para -></listitem> - -<listitem -><para -><emphasis -><link linkend="deployment-diagram" ->Diagrama de Distribuição</link -></emphasis -> mostra as instâncias dos componentes e seus relacionamentos.</para -></listitem -> +<listitem><para><emphasis><link linkend="state-diagram">Diagrama de Estado</link></emphasis> mostra estados, mudanças de estado e eventos num objeto ou uma parte do sistema</para> </listitem> + +<listitem><para><emphasis><link linkend="activity-diagram">Diagrama de Atividade</link></emphasis> mostra atividades e as mudanças de uma atividade para outra com os eventos ocorridos em alguma parte do sistema</para></listitem> + +<listitem><para><emphasis><link linkend="component-diagram">Diagrama de Componente</link></emphasis> mostra os componentes de programação de alto nível (como KParts ou Java Beans).</para></listitem> + +<listitem><para><emphasis><link linkend="deployment-diagram">Diagrama de Distribuição</link></emphasis> mostra as instâncias dos componentes e seus relacionamentos.</para></listitem> </itemizedlist> -</sect1 -> <!-- about-uml --> +</sect1> <!-- about-uml --> -<sect1 id="uml-elements" -> -<title ->Elementos &UML;</title> +<sect1 id="uml-elements"> +<title>Elementos &UML;</title> <sect2 id="use-case-diagram"> -<title ->Diagrama de Caso de Uso</title> -<para ->Diagramas de Caso de Uso descrevem relacionamentos e dependências entre um grupo de <emphasis ->Caso de Uso</emphasis -> e os Atores participantes no processo.</para> -<para ->É importante observar que Diagramas de Caso de Uso não são adequados para representar o desenho, e não podem descrever os mecanismos internos de um sistema. Diagramas de Caso de Uso são feitos para facilitar a comunicação com os futuros usuários do sistema, e com o cliente, e são especialmente úteis para determinar os recursos necessários que o sistema deve ter. Diagramas de Caso de Uso dizem <emphasis ->o quê</emphasis -> o sistema deve fazer, mas não fazem — e não podem — especificar <emphasis ->como</emphasis -> isto será conseguido.</para> +<title>Diagrama de Caso de Uso</title> +<para>Diagramas de Caso de Uso descrevem relacionamentos e dependências entre um grupo de <emphasis>Caso de Uso</emphasis> e os Atores participantes no processo.</para> +<para>É importante observar que Diagramas de Caso de Uso não são adequados para representar o desenho, e não podem descrever os mecanismos internos de um sistema. Diagramas de Caso de Uso são feitos para facilitar a comunicação com os futuros usuários do sistema, e com o cliente, e são especialmente úteis para determinar os recursos necessários que o sistema deve ter. Diagramas de Caso de Uso dizem <emphasis>o quê</emphasis> o sistema deve fazer, mas não fazem — e não podem — especificar <emphasis>como</emphasis> isto será conseguido.</para> <para> <screenshot> -<screeninfo ->Um exemplo de Diagrama de Caso de Uso.</screeninfo> +<screeninfo>Um exemplo de Diagrama de Caso de Uso.</screeninfo> <mediaobject> <imageobject> <imagedata fileref="use-case-diagram.png" format="PNG"/> </imageobject> <textobject> - <phrase ->O &umbrello; mostrando um Diagrama de Caso de Uso</phrase> + <phrase>O &umbrello; mostrando um Diagrama de Caso de Uso</phrase> </textobject> <caption> - <para ->O &umbrello; mostrando um Diagrama de Caso de Uso </para> + <para>O &umbrello; mostrando um Diagrama de Caso de Uso </para> </caption> </mediaobject> </screenshot> </para> <sect3 id="use-case"> -<title ->Caso de Uso</title> -<para ->Um <emphasis ->Caso de Uso</emphasis -> descreve — do ponto de vista dos atores — um grupo de atividades num sistema que produz um resultado concreto e tangível.</para> -<para ->Casos de Uso são descrições de interações típicas entre os usuários de um sistema e o sistema propriamente dito. Eles representam a interface externa do sistema e especificam um conjunto de exigências do que o sistema deve fazer (lembre-se: somente o quê, não como). </para> -<para ->Quando trabalhar com Casos de Uso, é importante lembrar-se de algumas regras simples: <itemizedlist> - <listitem -><para ->Cada Caso de Uso está relacionado com no mínimo um ator</para -></listitem> - <listitem -><para ->Cada Caso de Uso possui um iniciador (&ie; um ator)</para -></listitem> - <listitem -><para ->Cada Caso de Uso liga-se a um resultado relevante (um resultado com <quote ->valor de negócio</quote ->)</para> +<title>Caso de Uso</title> +<para>Um <emphasis>Caso de Uso</emphasis> descreve — do ponto de vista dos atores — um grupo de atividades num sistema que produz um resultado concreto e tangível.</para> +<para>Casos de Uso são descrições de interações típicas entre os usuários de um sistema e o sistema propriamente dito. Eles representam a interface externa do sistema e especificam um conjunto de exigências do que o sistema deve fazer (lembre-se: somente o quê, não como). </para> +<para>Quando trabalhar com Casos de Uso, é importante lembrar-se de algumas regras simples: <itemizedlist> + <listitem><para>Cada Caso de Uso está relacionado com no mínimo um ator</para></listitem> + <listitem><para>Cada Caso de Uso possui um iniciador (&ie; um ator)</para></listitem> + <listitem><para>Cada Caso de Uso liga-se a um resultado relevante (um resultado com <quote>valor de negócio</quote>)</para> </listitem> </itemizedlist> </para> -<para ->Casos de Uso também podem ter relacionamentos com outros Casos de Uso. Os três tipos mais comuns de relacionamento entre Casos de Uso são:</para> +<para>Casos de Uso também podem ter relacionamentos com outros Casos de Uso. Os três tipos mais comuns de relacionamento entre Casos de Uso são:</para> <itemizedlist> -<listitem -><para -><emphasis -><<inclui-se>></emphasis -> que especifica que um Caso de Uso toma lugar <emphasis ->dentro</emphasis -> de outro Caso de Uso</para -></listitem> -<listitem -><para -><emphasis -><<estende>></emphasis -> que especifica que em determinadas situações, ou em algum ponto (chamado um ponto de extensão) um Caso de Uso será estendido por outro.</para -></listitem> -<listitem -><para -><emphasis ->Generalização</emphasis -> especifica que um Caso de Uso herda as características do <quote ->Super</quote -> Caso de Uso, e pode sobrepor algumas delas ou adicionar novas de maneira semelhante a herança entre classes. </para> +<listitem><para><emphasis><<inclui-se>></emphasis> que especifica que um Caso de Uso toma lugar <emphasis>dentro</emphasis> de outro Caso de Uso</para></listitem> +<listitem><para><emphasis><<estende>></emphasis> que especifica que em determinadas situações, ou em algum ponto (chamado um ponto de extensão) um Caso de Uso será estendido por outro.</para></listitem> +<listitem><para><emphasis>Generalização</emphasis> especifica que um Caso de Uso herda as características do <quote>Super</quote> Caso de Uso, e pode sobrepor algumas delas ou adicionar novas de maneira semelhante a herança entre classes. </para> </listitem> </itemizedlist> </sect3> <sect3 id="actor"> -<title ->Ator</title> -<para ->Um ator é uma entidade externa (fora do sistema) que interage com o sistema participando (e freqüentemente iniciando) um Caso de Uso. Atores podem ser pessoas reais (por exemplo usuários do sistema), outro sistema de computador ou eventos externos. </para> -<para ->Atores não representam as pessoa <emphasis ->física</emphasis -> ou sistemas, mas sua <emphasis ->regra</emphasis ->. Isto significa que quando uma pessoa interage com o sistema de diferentes maneiras (assumindo diferentes regras) ela será representada por diversos atores. Por exemplo um pessoa que fornece suporte ao cliente por telefone e recebe ordens do cliente para o sistema pode ser representado por um ator da <quote ->Equipe de Suporte</quote -> e um ator <quote ->Representante de Vendas</quote -> </para> +<title>Ator</title> +<para>Um ator é uma entidade externa (fora do sistema) que interage com o sistema participando (e freqüentemente iniciando) um Caso de Uso. Atores podem ser pessoas reais (por exemplo usuários do sistema), outro sistema de computador ou eventos externos. </para> +<para>Atores não representam as pessoa <emphasis>física</emphasis> ou sistemas, mas sua <emphasis>regra</emphasis>. Isto significa que quando uma pessoa interage com o sistema de diferentes maneiras (assumindo diferentes regras) ela será representada por diversos atores. Por exemplo um pessoa que fornece suporte ao cliente por telefone e recebe ordens do cliente para o sistema pode ser representado por um ator da <quote>Equipe de Suporte</quote> e um ator <quote>Representante de Vendas</quote> </para> </sect3> <sect3 id="use-case-description"> -<title ->Descrição do Caso de Uso</title> -<para ->Descrição do Caso de Uso são narrativas de texto do Caso de Uso. Elas usualmente tomam a forma de uma nota ou um documento que é de alguma maneira ligado ao Caso de Uso, e explana o processo ou atividades que tomarão lugar no Caso de Uso. </para> +<title>Descrição do Caso de Uso</title> +<para>Descrição do Caso de Uso são narrativas de texto do Caso de Uso. Elas usualmente tomam a forma de uma nota ou um documento que é de alguma maneira ligado ao Caso de Uso, e explana o processo ou atividades que tomarão lugar no Caso de Uso. </para> </sect3> -</sect2 -> <!-- use-case-diagram --> +</sect2> <!-- use-case-diagram --> <sect2 id="class-diagram"> -<title ->Diagrama de Classe</title> -<para ->Diagramas de Classe mostram as diferentes classes que fazem um sistema e como elas se relacionam. Os Diagramas de Classe são chamados diagramas <quote ->estáticos</quote -> porque mostram as classes, com seus métodos e atributos bem como os relacionamentos estáticos entre elas: quais classes <quote ->conhecem</quote -> quais classes ou quais classes <quote ->são parte</quote -> de outras classes, mas não mostram a troca de mensagens entre elas. </para> +<title>Diagrama de Classe</title> +<para>Diagramas de Classe mostram as diferentes classes que fazem um sistema e como elas se relacionam. Os Diagramas de Classe são chamados diagramas <quote>estáticos</quote> porque mostram as classes, com seus métodos e atributos bem como os relacionamentos estáticos entre elas: quais classes <quote>conhecem</quote> quais classes ou quais classes <quote>são parte</quote> de outras classes, mas não mostram a troca de mensagens entre elas. </para> <para> <screenshot> -<screeninfo ->Um exemplo de um Diagrama de Classe</screeninfo> +<screeninfo>Um exemplo de um Diagrama de Classe</screeninfo> <mediaobject> <imageobject> <imagedata fileref="class-diagram.png" format="PNG"/> </imageobject> <textobject> - <phrase ->O &umbrello; mostrando um Diagrama de Classe</phrase> + <phrase>O &umbrello; mostrando um Diagrama de Classe</phrase> </textobject> <caption> - <para ->O &umbrello; mostrando um Diagrama de Classe </para> + <para>O &umbrello; mostrando um Diagrama de Classe </para> </caption> </mediaobject> </screenshot> </para> <sect3 id="class"> -<title ->Classe</title> -<para ->Um Classe define os atributos e os métodos de um conjunto de objetos. Todos os objetos desta classe (instâncias desta classe) compartilham o mesmo comportamento, e possuem o mesmo conjunto de atributos (cada objeto possui seu próprio conjunto). O termo <quote ->Tipo</quote -> é algumas vezes usado ao invés de Classe, mas é importante mencionar que estes dois termos não são a mesma coisa, e Tipo é um termo mais genérico. </para> -<para ->Em &UML; Classes são representadas por retângulos, com o nome da classe, e podem também mostrar os atributos e operações da classe em dois outros <quote ->compartimentos</quote -> dentro do retângulo. </para> +<title>Classe</title> +<para>Um Classe define os atributos e os métodos de um conjunto de objetos. Todos os objetos desta classe (instâncias desta classe) compartilham o mesmo comportamento, e possuem o mesmo conjunto de atributos (cada objeto possui seu próprio conjunto). O termo <quote>Tipo</quote> é algumas vezes usado ao invés de Classe, mas é importante mencionar que estes dois termos não são a mesma coisa, e Tipo é um termo mais genérico. </para> +<para>Em &UML; Classes são representadas por retângulos, com o nome da classe, e podem também mostrar os atributos e operações da classe em dois outros <quote>compartimentos</quote> dentro do retângulo. </para> <para> <screenshot> -<screeninfo ->Uma Classe em &UML;</screeninfo> +<screeninfo>Uma Classe em &UML;</screeninfo> <mediaobject> <imageobject> <imagedata fileref="class.png" format="PNG"/> </imageobject> <textobject> - <phrase ->Representação visual de uma Classe em &UML;</phrase> + <phrase>Representação visual de uma Classe em &UML;</phrase> </textobject> <caption> - <para ->Representação visual de uma Classe em &UML; </para> + <para>Representação visual de uma Classe em &UML; </para> </caption> </mediaobject> </screenshot> </para> <sect4 id="attribute"> -<title ->Atributos</title> -<para ->Na &UML;, atributos são mostrados com pelo menos seu nome, e podem também mostrar seu tipo, valor inicial e outras propriedades. Atributos podem também ser exibidos com sua visibilidade: </para> +<title>Atributos</title> +<para>Na &UML;, atributos são mostrados com pelo menos seu nome, e podem também mostrar seu tipo, valor inicial e outras propriedades. Atributos podem também ser exibidos com sua visibilidade: </para> <itemizedlist> -<listitem -><para -><literal ->+</literal -> indica atributos <emphasis ->públicos</emphasis -></para -></listitem> -<listitem -><para -><literal ->#</literal -> indica atributos <emphasis ->protegidos</emphasis -></para -></listitem> -<listitem -><para -><literal ->-</literal -> indica atributos <emphasis ->privados</emphasis -></para -></listitem> +<listitem><para><literal>+</literal> indica atributos <emphasis>públicos</emphasis></para></listitem> +<listitem><para><literal>#</literal> indica atributos <emphasis>protegidos</emphasis></para></listitem> +<listitem><para><literal>-</literal> indica atributos <emphasis>privados</emphasis></para></listitem> </itemizedlist> </sect4> <sect4 id="operation"> -<title ->Operações</title> -<para ->Operações (métodos) também são exibidos com pelo menos seu nome, e podem também mostrar seus parâmetros e valores de retorno. Operações podem, como os Atributos, mostras sua visibilidade: <itemizedlist> -<listitem -><para -><literal ->+</literal -> indica operações <emphasis ->públicas</emphasis -></para -></listitem> -<listitem -><para -><literal ->#</literal -> indica operações <emphasis ->protegidas</emphasis -></para -></listitem> -<listitem -><para -><literal ->-</literal -> indica operações <emphasis ->privadas</emphasis -></para -></listitem> +<title>Operações</title> +<para>Operações (métodos) também são exibidos com pelo menos seu nome, e podem também mostrar seus parâmetros e valores de retorno. Operações podem, como os Atributos, mostras sua visibilidade: <itemizedlist> +<listitem><para><literal>+</literal> indica operações <emphasis>públicas</emphasis></para></listitem> +<listitem><para><literal>#</literal> indica operações <emphasis>protegidas</emphasis></para></listitem> +<listitem><para><literal>-</literal> indica operações <emphasis>privadas</emphasis></para></listitem> </itemizedlist> </para> </sect4> <sect4 id="templates"> -<title ->Modelos</title> -<para ->Classes podem ter modelos, um valor que é usado para uma classe ou tipo não especificado. O tipo de modelo é especificado quando uma classe é iniciada (&ie; um objeto é criado). Modelos existem no C++ moderno e foram introduzidos no Java 1.5 onde eles são chamados de Genéricos. </para> +<title>Modelos</title> +<para>Classes podem ter modelos, um valor que é usado para uma classe ou tipo não especificado. O tipo de modelo é especificado quando uma classe é iniciada (&ie; um objeto é criado). Modelos existem no C++ moderno e foram introduzidos no Java 1.5 onde eles são chamados de Genéricos. </para> </sect4> </sect3> <sect3 id="class-associations"> -<title ->Associações de Classe</title> -<para ->Classes podem relacionar-se (ser associada com) com outras de diferentes maneiras:</para> +<title>Associações de Classe</title> +<para>Classes podem relacionar-se (ser associada com) com outras de diferentes maneiras:</para> <sect4 id="generalization"> -<title ->Generalização</title> -<para ->Herança é um dos conceitos fundamentais da programação Orientada à Objeto, na qual uma classe <quote ->herda</quote -> todos os atributos e operações da classe da qual deriva, e pode sobrescrever/modificar alguns deles, bem como adicionar mais atributos e operações próprios.</para> -<para ->EM &UML;, uma associação <emphasis ->Generalização</emphasis -> entre duas classes coloca-as numa hierarquia representando o conceito de herança de uma classe derivada de uma classe base. Em &UML;, Generalizações são representadas por uma linha conectando duas classes, com uma seta no lado da classe base. <screenshot> -<screeninfo ->Generalização</screeninfo> +<title>Generalização</title> +<para>Herança é um dos conceitos fundamentais da programação Orientada à Objeto, na qual uma classe <quote>herda</quote> todos os atributos e operações da classe da qual deriva, e pode sobrescrever/modificar alguns deles, bem como adicionar mais atributos e operações próprios.</para> +<para>EM &UML;, uma associação <emphasis>Generalização</emphasis> entre duas classes coloca-as numa hierarquia representando o conceito de herança de uma classe derivada de uma classe base. Em &UML;, Generalizações são representadas por uma linha conectando duas classes, com uma seta no lado da classe base. <screenshot> +<screeninfo>Generalização</screeninfo> <mediaobject> <imageobject> <imagedata fileref="generalization.png" format="PNG"/> </imageobject> <textobject> - <phrase ->Representação visual de uma generalização em &UML;</phrase> + <phrase>Representação visual de uma generalização em &UML;</phrase> </textobject> <caption> - <para ->Representação visual de uma generalização em &UML; </para> + <para>Representação visual de uma generalização em &UML; </para> </caption> </mediaobject> </screenshot> @@ -380,35 +171,21 @@ </sect4> <sect4 id="uml-associations"> -<title ->Associações</title> -<para ->Um associação representa um relacionamento entre classes, e fornece a semântica comum e a estrutura para muitos tipos de <quote ->conexões</quote -> entre objetos.</para> -<para ->Associações são o mecanismo que permite objetos comunicarem-se entre si. Elas descrevem a conexão entre diferentes classes (a conexão entre os objetos atuais é chamada conexão do objeto, ou <emphasis ->link</emphasis ->. </para> -<para ->Associações podem ter um regra que especifica o propósito da associação e pode ser uni ou bidirecional (indicadando se os dois objetos participantes do relacionamento podem mandar mensagens para o outro, ou se apenas um deles sabe sobre o outro). Cada ponta da associação também possui uma valor de multiplicidade, que dita como muitos objetos neste lado da associação pode relacionar-se com o outro lado. </para> -<para ->Em &UML;, associações são representadas como linhas conectando as classes participantes do relacionamento, e podem também mostrar a regra e a multiplicidade de cada um dos participantes. A multiplicidade é exibida como um intervalo [min...máx] de valores não negativos, com uma estrela (<literal ->*</literal ->) no lado máximo representando infinito. <screenshot> -<screeninfo ->Associação &UML;</screeninfo> +<title>Associações</title> +<para>Um associação representa um relacionamento entre classes, e fornece a semântica comum e a estrutura para muitos tipos de <quote>conexões</quote> entre objetos.</para> +<para>Associações são o mecanismo que permite objetos comunicarem-se entre si. Elas descrevem a conexão entre diferentes classes (a conexão entre os objetos atuais é chamada conexão do objeto, ou <emphasis>link</emphasis>. </para> +<para>Associações podem ter um regra que especifica o propósito da associação e pode ser uni ou bidirecional (indicadando se os dois objetos participantes do relacionamento podem mandar mensagens para o outro, ou se apenas um deles sabe sobre o outro). Cada ponta da associação também possui uma valor de multiplicidade, que dita como muitos objetos neste lado da associação pode relacionar-se com o outro lado. </para> +<para>Em &UML;, associações são representadas como linhas conectando as classes participantes do relacionamento, e podem também mostrar a regra e a multiplicidade de cada um dos participantes. A multiplicidade é exibida como um intervalo [min...máx] de valores não negativos, com uma estrela (<literal>*</literal>) no lado máximo representando infinito. <screenshot> +<screeninfo>Associação &UML;</screeninfo> <mediaobject> <imageobject> <imagedata fileref="association.png" format="PNG"/> </imageobject> <textobject> - <phrase ->Representação visual de uma Associação em &UML;</phrase> + <phrase>Representação visual de uma Associação em &UML;</phrase> </textobject> <caption> - <para ->Representação visual de uma Associação em &UML; </para> + <para>Representação visual de uma Associação em &UML; </para> </caption> </mediaobject> </screenshot> @@ -416,367 +193,226 @@ </sect4> <sect4 id="aggregation"> -<title ->Agregação</title> -<para ->Agregações são um tipo especial de associação no qual as duas classes participantes não possuem em nível igual, mas fazem um relacionamento <quote ->todo-parte</quote ->. Uma Agregação descreve como a classe que possui a regra do todo, é composta (tem) de outras classes, que possuem a regra das partes. Para Agregações, a classe que age como o todo sempre tem uma multiplicidade de um. </para> -<para ->Em &UML;, Agregações são representadas por uma associação que mostra um rombóide no lado do todo. <screenshot> -<screeninfo ->Agregação</screeninfo> +<title>Agregação</title> +<para>Agregações são um tipo especial de associação no qual as duas classes participantes não possuem em nível igual, mas fazem um relacionamento <quote>todo-parte</quote>. Uma Agregação descreve como a classe que possui a regra do todo, é composta (tem) de outras classes, que possuem a regra das partes. Para Agregações, a classe que age como o todo sempre tem uma multiplicidade de um. </para> +<para>Em &UML;, Agregações são representadas por uma associação que mostra um rombóide no lado do todo. <screenshot> +<screeninfo>Agregação</screeninfo> <mediaobject> <imageobject> <imagedata fileref="aggregation.png" format="PNG"/> </imageobject> <textobject> - <phrase ->Representação visual de um relacionamento Agregação em &UML;</phrase> + <phrase>Representação visual de um relacionamento Agregação em &UML;</phrase> </textobject> <caption> - <para ->Representação visual de um relacionamento Agregação em &UML; </para> + <para>Representação visual de um relacionamento Agregação em &UML; </para> </caption> </mediaobject> </screenshot> </para> </sect4> <sect4 id="composition"> -<title ->Composição</title> -<para ->Composições são associações que representam agregações <emphasis ->muito fortes</emphasis ->. Isto significa que Composições formam relacionamentos todo-parte também, mas o relacionamento é tão forte que as partes não pode existir independentes. Elas existem somente dentro do todo, e se o todo é destruído as partes morrem também.</para> -<para ->Em &UML;, Composições são representadas por um rombóide sólido no lado do todo. </para> -<para -><screenshot> -<screeninfo ->Composição</screeninfo> +<title>Composição</title> +<para>Composições são associações que representam agregações <emphasis>muito fortes</emphasis>. Isto significa que Composições formam relacionamentos todo-parte também, mas o relacionamento é tão forte que as partes não pode existir independentes. Elas existem somente dentro do todo, e se o todo é destruído as partes morrem também.</para> +<para>Em &UML;, Composições são representadas por um rombóide sólido no lado do todo. </para> +<para><screenshot> +<screeninfo>Composição</screeninfo> <mediaobject> <imageobject> <imagedata fileref="composition.png" format="PNG"/> </imageobject> <textobject> - <phrase ->Representação visual de um relacionamento Composição em &UML;</phrase> + <phrase>Representação visual de um relacionamento Composição em &UML;</phrase> </textobject> </mediaobject> -</screenshot -></para> +</screenshot></para> </sect4> -</sect3 -> <!--class-associations--> +</sect3> <!--class-associations--> <sect3 id="other-class-diagram-items"> -<title ->Outros Ítens do Diagrama de Classe</title> -<para ->Diagramas de Classe podem conter diversos outros ítens além das classes.</para> +<title>Outros Ítens do Diagrama de Classe</title> +<para>Diagramas de Classe podem conter diversos outros ítens além das classes.</para> <sect4 id="interfaces"> -<title ->Interfaces</title> -<para ->Interfaces são classes abstratas que significam instâncias que não podem ser diretamente criadas delas. Elas podem conter operações mas não podem conter atributos. Classes podem derivar de interfaces (através da realização de uma associação) e instâncias podem então ser feitas destes diagramas.</para> +<title>Interfaces</title> +<para>Interfaces são classes abstratas que significam instâncias que não podem ser diretamente criadas delas. Elas podem conter operações mas não podem conter atributos. Classes podem derivar de interfaces (através da realização de uma associação) e instâncias podem então ser feitas destes diagramas.</para> <!-- FIXME screenshot --> </sect4> <sect4 id="datatype"> -<title ->Tipos de dados</title> -<para ->Tipos de dados são primitivos uma vez que são tipicamente construídos numa linguagem de programação. Exemplos comuns são inteiros e lógicos. Eles não podem ser relacionados à classes mas classes pode se relacionar com eles.</para> +<title>Tipos de dados</title> +<para>Tipos de dados são primitivos uma vez que são tipicamente construídos numa linguagem de programação. Exemplos comuns são inteiros e lógicos. Eles não podem ser relacionados à classes mas classes pode se relacionar com eles.</para> <!-- FIXME screenshot --> </sect4> <sect4 id="enum"> -<title ->Enumerações</title> -<para ->Enumerações são uma lista simples de valores. Um exemplo típico é uma enumeração para dias da semana. As opções de uma enumeração são chamadas Literais de Enumeração. Como tipos de dados, elas não podem ter relacionamentos para classes mas classes podem relacionar-se com elas.</para> +<title>Enumerações</title> +<para>Enumerações são uma lista simples de valores. Um exemplo típico é uma enumeração para dias da semana. As opções de uma enumeração são chamadas Literais de Enumeração. Como tipos de dados, elas não podem ter relacionamentos para classes mas classes podem relacionar-se com elas.</para> <!-- FIXME screenshot --> </sect4> <sect4 id="package"> -<title ->Pacotes</title> -<para ->Pacotes representam um espaço de nomes numa linguagem de programação. Num diagrama eles são usados para representar partes de um sistema que contém mais de uma classe, talvez centenas de classes.</para> +<title>Pacotes</title> +<para>Pacotes representam um espaço de nomes numa linguagem de programação. Num diagrama eles são usados para representar partes de um sistema que contém mais de uma classe, talvez centenas de classes.</para> <!-- FIXME screenshot --> </sect4> </sect3> -</sect2 -> <!-- class diagram --> +</sect2> <!-- class diagram --> <sect2 id="sequence-diagram"> -<title ->Diagramas de Seqüência</title> +<title>Diagramas de Seqüência</title> -<para ->Diagramas de Seqüência mostram a troca de mensagens (&ie; chamada de método) entre diversos Objetos, numa situação específica e delimitada no tempo. Objetos são instâncias de classes. Diagramas de Seqüência colocam ênfase especial na ordem e nos momentos nos quais mensagens para os objetos são enviadas.</para> +<para>Diagramas de Seqüência mostram a troca de mensagens (&ie; chamada de método) entre diversos Objetos, numa situação específica e delimitada no tempo. Objetos são instâncias de classes. Diagramas de Seqüência colocam ênfase especial na ordem e nos momentos nos quais mensagens para os objetos são enviadas.</para> -<para ->Em Diagramas de Seqüência objetos são representados através de linhas verticais tracejadas, com o nome do Objeto no topo. O eixo do tempo é também vertical, aumentando para baixo, de modo que as mensagens são enviadas de um Objeto para outro na forma de setas com a operação e os nomes dos parâmetros. </para> +<para>Em Diagramas de Seqüência objetos são representados através de linhas verticais tracejadas, com o nome do Objeto no topo. O eixo do tempo é também vertical, aumentando para baixo, de modo que as mensagens são enviadas de um Objeto para outro na forma de setas com a operação e os nomes dos parâmetros. </para> <!-- FIXME update screenshot to show synchronous messages --> <screenshot> -<screeninfo ->Diagrama de Seqüência</screeninfo> +<screeninfo>Diagrama de Seqüência</screeninfo> <mediaobject> <imageobject> <imagedata fileref="sequence-diagram.png" format="PNG"/> </imageobject> <textobject> - <phrase ->O &umbrello; mostrando um Diagrama de Seqüência</phrase> + <phrase>O &umbrello; mostrando um Diagrama de Seqüência</phrase> </textobject> <caption> - <para ->O &umbrello; mostrando um Diagrama de Seqüência </para> + <para>O &umbrello; mostrando um Diagrama de Seqüência </para> </caption> </mediaobject> </screenshot> -<para ->Mensagens pode ser síncronas, o tipo normal de mensagem de chamada onde o controle é passado para o objeto chamado até o método ter terminado sua execução, ou assíncronas onde o controle é passado diretamente para o objeto chamado. Mensagens síncronas possui uma caixa vertical no lado do objeto chamado para mostrar o controle do fluxo do programa.</para> -</sect2 -> <!-- sequence diagrams --> +<para>Mensagens pode ser síncronas, o tipo normal de mensagem de chamada onde o controle é passado para o objeto chamado até o método ter terminado sua execução, ou assíncronas onde o controle é passado diretamente para o objeto chamado. Mensagens síncronas possui uma caixa vertical no lado do objeto chamado para mostrar o controle do fluxo do programa.</para> +</sect2> <!-- sequence diagrams --> <sect2 id="collaboration-diagram"> -<title ->Diagramas de Colaboração</title> +<title>Diagramas de Colaboração</title> -<para ->Diagramas de Colaboração mostram as interações que ocorrem entre os objetos participantes numa situação específica. Isto é mais ou menos a mesma informação mostrada pelos Diagramas de Seqüência, mas neste a ênfase é colocada em como as interações ocorrem no tempo, enquanto os Diagramas de Colaboração colocam os relacionamentos entre os objetos e sua topologia em destaque.</para> +<para>Diagramas de Colaboração mostram as interações que ocorrem entre os objetos participantes numa situação específica. Isto é mais ou menos a mesma informação mostrada pelos Diagramas de Seqüência, mas neste a ênfase é colocada em como as interações ocorrem no tempo, enquanto os Diagramas de Colaboração colocam os relacionamentos entre os objetos e sua topologia em destaque.</para> -<para ->Em Diagramas de Colaboração as mensagens enviadas de um objeto para outro são representadas por setas, mostrando o nome da mensagem, parâmetros, e a seqüência da mensagem. Diagramas de Colaboração são especialmente indicados para mostrar um fluxo ou situação específica do programa e são um dos melhores tipos de diagrama para rapidamente demonstrar ou explanar um processo na lógica do programa. </para> +<para>Em Diagramas de Colaboração as mensagens enviadas de um objeto para outro são representadas por setas, mostrando o nome da mensagem, parâmetros, e a seqüência da mensagem. Diagramas de Colaboração são especialmente indicados para mostrar um fluxo ou situação específica do programa e são um dos melhores tipos de diagrama para rapidamente demonstrar ou explanar um processo na lógica do programa. </para> <screenshot> -<screeninfo ->Colaboração</screeninfo> +<screeninfo>Colaboração</screeninfo> <mediaobject> <imageobject> <imagedata fileref="collaboration-diagram.png" format="PNG"/> </imageobject> <textobject> - <phrase ->O &umbrello; mostrando um Diagrama de Colaboração</phrase> + <phrase>O &umbrello; mostrando um Diagrama de Colaboração</phrase> </textobject> <caption> - <para ->O &umbrello; mostrando um Diagrama de Colaboração </para> + <para>O &umbrello; mostrando um Diagrama de Colaboração </para> </caption> </mediaobject> </screenshot> -</sect2 -> <!-- collaboration diagrams --> +</sect2> <!-- collaboration diagrams --> <sect2 id="state-diagram"> -<title ->Diagrama de Estado</title> -<para ->Diagramas de Estado mostram os diferentes estados de um Objeto durante sua vida, e o estímulo que faz com que o Objeto mude seu estado. </para -> -<para ->Diagramas de Estado vêem Objetos como <emphasis ->máquinas de estado</emphasis -> ou automatismos finitos que podem ser um de um conjunto de estados finitos e que podem mudar seu estado através de um de um conjunto finito de estímulos. Por exemplo um tipo de Objeto <emphasis ->ServidorRede</emphasis -> pode estar em um dos seguintes estados durante sua vida: </para> +<title>Diagrama de Estado</title> +<para>Diagramas de Estado mostram os diferentes estados de um Objeto durante sua vida, e o estímulo que faz com que o Objeto mude seu estado. </para> +<para>Diagramas de Estado vêem Objetos como <emphasis>máquinas de estado</emphasis> ou automatismos finitos que podem ser um de um conjunto de estados finitos e que podem mudar seu estado através de um de um conjunto finito de estímulos. Por exemplo um tipo de Objeto <emphasis>ServidorRede</emphasis> pode estar em um dos seguintes estados durante sua vida: </para> <itemizedlist> -<listitem -><para ->Pronto</para -></listitem> -<listitem -><para ->Ouvindo</para -></listitem> -<listitem -><para ->Trabalhando</para -></listitem> -<listitem -><para ->Parado</para -></listitem> +<listitem><para>Pronto</para></listitem> +<listitem><para>Ouvindo</para></listitem> +<listitem><para>Trabalhando</para></listitem> +<listitem><para>Parado</para></listitem> </itemizedlist> -<para ->e os eventos que podem fazer com que o Objeto mude de estado são</para> +<para>e os eventos que podem fazer com que o Objeto mude de estado são</para> <itemizedlist> -<listitem -><para ->Objeto é criado</para -></listitem> -<listitem -><para ->Objeto recebe mensagem ouvir</para -></listitem> -<listitem -><para ->Um Cliente solicita uma conexão através da rede</para -></listitem> -<listitem -><para ->Um Cliente termina um pedido</para -></listitem> -<listitem -><para ->O pedido é executado e terminado</para -></listitem> -<listitem -><para ->Objeto recebe mensagem parar</para -></listitem> -<listitem -><para ->etc</para -></listitem> +<listitem><para>Objeto é criado</para></listitem> +<listitem><para>Objeto recebe mensagem ouvir</para></listitem> +<listitem><para>Um Cliente solicita uma conexão através da rede</para></listitem> +<listitem><para>Um Cliente termina um pedido</para></listitem> +<listitem><para>O pedido é executado e terminado</para></listitem> +<listitem><para>Objeto recebe mensagem parar</para></listitem> +<listitem><para>etc</para></listitem> </itemizedlist> <para> <screenshot> -<screeninfo ->Diagrama de Estado</screeninfo> +<screeninfo>Diagrama de Estado</screeninfo> <mediaobject> <imageobject> <imagedata fileref="state-diagram.png" format="PNG"/> </imageobject> <textobject> - <phrase ->O &umbrello; mostrando um Diagrama de Estado</phrase> + <phrase>O &umbrello; mostrando um Diagrama de Estado</phrase> </textobject> <caption> - <para ->O &umbrello; mostrando um Diagrama de Estado </para> + <para>O &umbrello; mostrando um Diagrama de Estado </para> </caption> </mediaobject> </screenshot> </para> <sect3 id="state"> -<title ->Estado</title> -<para ->Estados são os blocos construídos dos Diagramas de Estado. Um Estado pertence a exatamente uma classe e representa um resumo dos valores dos atributos que uma classe pode tomar. Um Estado &UML; descreve o estado interno de um objeto para uma classe em particular </para -> -<para ->Observe que nem toda mudança em um dos atributos de um objeto pode ser representada por um Estado mas somente aquelas mudanças que podem afetar significativamente o trabalho do objeto</para> -<para ->Existem dois tipos especiais de Estados: Inicial e Final. Eles são especiais porque nenhum evento pode fazer com que um Objeto retorne para seu estado Inicial, e da mesma maneira nenhum evento pode tirar um Objeto de seu estado Final uma vez que ele já o tenha alcançado. </para> +<title>Estado</title> +<para>Estados são os blocos construídos dos Diagramas de Estado. Um Estado pertence a exatamente uma classe e representa um resumo dos valores dos atributos que uma classe pode tomar. Um Estado &UML; descreve o estado interno de um objeto para uma classe em particular </para> +<para>Observe que nem toda mudança em um dos atributos de um objeto pode ser representada por um Estado mas somente aquelas mudanças que podem afetar significativamente o trabalho do objeto</para> +<para>Existem dois tipos especiais de Estados: Inicial e Final. Eles são especiais porque nenhum evento pode fazer com que um Objeto retorne para seu estado Inicial, e da mesma maneira nenhum evento pode tirar um Objeto de seu estado Final uma vez que ele já o tenha alcançado. </para> </sect3> -</sect2 -> <!-- state diagrams --> +</sect2> <!-- state diagrams --> <sect2 id="activity-diagram"> -<title ->Diagrama de Atividade</title> -<para ->O Diagrama de Atividade descreve a seqüência de atividades num sistema com a ajuda as Atividades. Diagramas de Atividade são uma forma especial de Diagramas de Estado, que somente (ou principalmente) contém Atividades. </para> +<title>Diagrama de Atividade</title> +<para>O Diagrama de Atividade descreve a seqüência de atividades num sistema com a ajuda as Atividades. Diagramas de Atividade são uma forma especial de Diagramas de Estado, que somente (ou principalmente) contém Atividades. </para> <para> <screenshot> -<screeninfo ->Um exemplo de um Diagrama de Atividade.</screeninfo> +<screeninfo>Um exemplo de um Diagrama de Atividade.</screeninfo> <mediaobject> <imageobject> <imagedata fileref="activity-diagram.png" format="PNG"/> </imageobject> <textobject> - <phrase ->O &umbrello; mostrando um Diagrama de Atividade</phrase> + <phrase>O &umbrello; mostrando um Diagrama de Atividade</phrase> </textobject> <caption> - <para ->O &umbrello; mostrando um Diagrama de Atividade </para> + <para>O &umbrello; mostrando um Diagrama de Atividade </para> </caption> </mediaobject> </screenshot> </para> -<para ->Diagramas de Atividade são similares as Diagramas de Fluxo de procedimentos, com a diferença de que todas as Atividades são claramente anexas aos Objetos.</para> - -<para ->Diagramas de Atividade são sempre associados a um <emphasis ->Classe</emphasis ->, uma <emphasis ->Operação</emphasis -> ou um <emphasis ->Caso de Uso</emphasis ->.</para> - -<para ->Diagramas de Atividade suportam Atividades seqüenciais bem como paralelas. A execução paralela é representada pelos ícones Forquilha/Esperar, e para as Atividades executadas em paralelo, não é importante a ordem na qual elas se executam (elas podem ser executadas ao mesmo tempo ou uma após a outra).</para> +<para>Diagramas de Atividade são similares as Diagramas de Fluxo de procedimentos, com a diferença de que todas as Atividades são claramente anexas aos Objetos.</para> + +<para>Diagramas de Atividade são sempre associados a um <emphasis>Classe</emphasis>, uma <emphasis>Operação</emphasis> ou um <emphasis>Caso de Uso</emphasis>.</para> + +<para>Diagramas de Atividade suportam Atividades seqüenciais bem como paralelas. A execução paralela é representada pelos ícones Forquilha/Esperar, e para as Atividades executadas em paralelo, não é importante a ordem na qual elas se executam (elas podem ser executadas ao mesmo tempo ou uma após a outra).</para> <sect3 id="activity"> -<title ->Atividade</title> -<para ->Uma Atividade é um passo simples num processo. Uma Atividade é um estado no sistema com atividade interna e, pelo menos, uma transição de saída. Atividades podem também ter mais de uma transição de saída se elas possuem condições diferentes. </para -> -<para ->Atividades podem formar hierarquias, isto significa que uma Atividade pode ser composta por diversas Atividades em <quote ->detalhe</quote ->, na qual as transições de entrada e saída devem corresponder às transições de entrada e saída do diagrama de detalhe. </para> +<title>Atividade</title> +<para>Uma Atividade é um passo simples num processo. Uma Atividade é um estado no sistema com atividade interna e, pelo menos, uma transição de saída. Atividades podem também ter mais de uma transição de saída se elas possuem condições diferentes. </para> +<para>Atividades podem formar hierarquias, isto significa que uma Atividade pode ser composta por diversas Atividades em <quote>detalhe</quote>, na qual as transições de entrada e saída devem corresponder às transições de entrada e saída do diagrama de detalhe. </para> </sect3> -</sect2 -> <!-- activity diagram --> +</sect2> <!-- activity diagram --> <sect2 id="helper-elements"> -<title ->Elementos Auxiliares</title> -<para ->Existem dois elementos em &UML; que não possuem nenhum valor real semântico para o modelo, mas auxiliam a elucidar partes do diagrama. Estes elementos são </para> +<title>Elementos Auxiliares</title> +<para>Existem dois elementos em &UML; que não possuem nenhum valor real semântico para o modelo, mas auxiliam a elucidar partes do diagrama. Estes elementos são </para> <itemizedlist> -<listitem -><para ->Linhas de texto</para -></listitem> -<listitem -><para ->Notas de Texto e âncoras</para -></listitem> -<listitem -><para ->Caixas</para -></listitem> -</itemizedlist -> -<para ->Linhas de texto são úteis para adicionar informações curtas de texto ao diagrama. São textos livres e não possuem nenhum significado para o Modelo propriamente dito. </para -> - -<para ->Notas são úteis para adicionar informações mais detalhadas sobre um objeto ou situação específica. Elas possuem a grande vantagem de poderem ser ancoradas a Elementos &UML; para mostrar que a nota <quote ->pertence</quote -> a um objeto específico ou situação. </para> - -<para ->Caixas são retângulos de forma livre que podem ser usados para agrupar ítens tornando os diagramas mais legíveis. Eles não possuem nenhum significado lógico no modelo.</para> +<listitem><para>Linhas de texto</para></listitem> +<listitem><para>Notas de Texto e âncoras</para></listitem> +<listitem><para>Caixas</para></listitem> +</itemizedlist> +<para>Linhas de texto são úteis para adicionar informações curtas de texto ao diagrama. São textos livres e não possuem nenhum significado para o Modelo propriamente dito. </para> + +<para>Notas são úteis para adicionar informações mais detalhadas sobre um objeto ou situação específica. Elas possuem a grande vantagem de poderem ser ancoradas a Elementos &UML; para mostrar que a nota <quote>pertence</quote> a um objeto específico ou situação. </para> + +<para>Caixas são retângulos de forma livre que podem ser usados para agrupar ítens tornando os diagramas mais legíveis. Eles não possuem nenhum significado lógico no modelo.</para> <!-- FIXME, screenshot --> -</sect2 -> <!-- helper elements --> +</sect2> <!-- helper elements --> <sect2 id="component-diagram"> -<title ->Diagramas de Componente</title> -<para ->Diagramas de Componente mostram os componentes do software (sejam componentes de tecnologias como KParts, componentes CORBA ou Java Beans ou apenas seções do sistema que são claramente distintas) e os artefatos de que eles são feitos como arquivos de código fonte, bibliotecas de programação ou tabelas de bancos de dados relacionais.</para> +<title>Diagramas de Componente</title> +<para>Diagramas de Componente mostram os componentes do software (sejam componentes de tecnologias como KParts, componentes CORBA ou Java Beans ou apenas seções do sistema que são claramente distintas) e os artefatos de que eles são feitos como arquivos de código fonte, bibliotecas de programação ou tabelas de bancos de dados relacionais.</para> -<para ->Componentes pode possui interfaces (&ie; classes abstratas com operações) que permitem associações entre componentes.</para> +<para>Componentes pode possui interfaces (&ie; classes abstratas com operações) que permitem associações entre componentes.</para> </sect2> <sect2 id="deployment-diagram"> -<title ->Diagramas de Distribuição</title> +<title>Diagramas de Distribuição</title> -<para ->Diagramas de distribuição mostram as instâncias dos componentes de tempo de execução e suas associações. Eles incluem Nós que são recursos físicos, tipicamente um computador simples. Eles também mostram interfaces e objetos (instâncias da classe).</para> +<para>Diagramas de distribuição mostram as instâncias dos componentes de tempo de execução e suas associações. Eles incluem Nós que são recursos físicos, tipicamente um computador simples. Eles também mostram interfaces e objetos (instâncias da classe).</para> </sect2> -</sect1 -> +</sect1> </chapter> diff --git a/tde-i18n-pt_BR/docs/tdesdk/umbrello/working_with_umbrello.docbook b/tde-i18n-pt_BR/docs/tdesdk/umbrello/working_with_umbrello.docbook index 178c56ebf29..2cdfa7de212 100644 --- a/tde-i18n-pt_BR/docs/tdesdk/umbrello/working_with_umbrello.docbook +++ b/tde-i18n-pt_BR/docs/tdesdk/umbrello/working_with_umbrello.docbook @@ -1,411 +1,188 @@ <chapter id="working-with-umbrello"> -<title ->Trabalhando com o &umbrello;</title> +<title>Trabalhando com o &umbrello;</title> <!-- Umbrello basics: creating diagrams, creating classes, adding objects to diagrams, associations, editing properties, anchor points in associations, removing objects, removing diagrams --> -<para ->Este capítulo lhe introduzirá na interface com o usuário do &umbrello; e lhe dirá tudo que você precisa saber para iniciar um modelo. Todas as ações no &umbrello; estão acessíveis através do menu e das barras de ferramentas, mas o &umbrello; também faz uso intensivo de menus de contexto do &RMB;. Você pode clicar o &RMB; na maioria dos elementos da área de trabalho do &umbrello; ou visão de árvore para obter um menu com as funções mais úteis que podem ser aplicadas ao elemento em particular que você está trabalhando. Alguns usuários acharão isto um pouco confuso no início, porque eles estão mais acostumados a trabalhar com o menu ou barras de ferramentas, mas uma vez que você acostume-se a usar o clique <mousebutton ->direito</mousebutton ->, isto aumentará significativamente a velocidade do seu trabalho. </para> +<para>Este capítulo lhe introduzirá na interface com o usuário do &umbrello; e lhe dirá tudo que você precisa saber para iniciar um modelo. Todas as ações no &umbrello; estão acessíveis através do menu e das barras de ferramentas, mas o &umbrello; também faz uso intensivo de menus de contexto do &RMB;. Você pode clicar o &RMB; na maioria dos elementos da área de trabalho do &umbrello; ou visão de árvore para obter um menu com as funções mais úteis que podem ser aplicadas ao elemento em particular que você está trabalhando. Alguns usuários acharão isto um pouco confuso no início, porque eles estão mais acostumados a trabalhar com o menu ou barras de ferramentas, mas uma vez que você acostume-se a usar o clique <mousebutton>direito</mousebutton>, isto aumentará significativamente a velocidade do seu trabalho. </para> <sect1 id="user-interface"> -<title ->Interface com o Usuário</title> -<para ->A janela principal do &umbrello; é dividida em três áreas que lhe auxiliam a manter uma visão geral de todo sistema e acessar os diferentes diagramas rapidamente enquanto trabalha em seu modelo. </para> -<para ->Estas áreas são chamadas:</para> +<title>Interface com o Usuário</title> +<para>A janela principal do &umbrello; é dividida em três áreas que lhe auxiliam a manter uma visão geral de todo sistema e acessar os diferentes diagramas rapidamente enquanto trabalha em seu modelo. </para> +<para>Estas áreas são chamadas:</para> <itemizedlist> -<listitem -><para ->Visão de Árvore</para -></listitem> -<listitem -><para ->Área de Trabalho</para -></listitem> -<listitem -><para ->Janela de Documentação</para -></listitem> +<listitem><para>Visão de Árvore</para></listitem> +<listitem><para>Área de Trabalho</para></listitem> +<listitem><para>Janela de Documentação</para></listitem> </itemizedlist> <screenshot> -<screeninfo ->Interface com o Usuário do &umbrello;</screeninfo> +<screeninfo>Interface com o Usuário do &umbrello;</screeninfo> <mediaobject> <imageobject> <imagedata fileref="umbrello-ui.png" format="PNG"/> </imageobject> <textobject> - <phrase ->Interface com o Usuário do &umbrello;</phrase> + <phrase>Interface com o Usuário do &umbrello;</phrase> </textobject> <caption> - <para ->Interface com o Usuário do &umbrello; </para> + <para>Interface com o Usuário do &umbrello; </para> </caption> </mediaobject> </screenshot> <sect2 id="tree-view"> -<title ->Visão de Árvore</title> -<para ->A Visão de Árvore é localizada na parte superior esquerda da janela, e mostra todos os diagramas, classes, atores e casos de uso que compuserem o seu modelo. A Visão de Árvore lhe permite ter uma rápida visão geral dos elementos componentes de seu modelo. A Visão de Árvore também lhe fornece uma maneira rápida de alternar entre os diferentes diagramas em seu modelo e inserir elementos de seu modelo no diagrama atual. </para> -<para ->Se você está trabalhando em um modelo com mais do que algumas poucas classes e diagramas, a Visão de Árvore pode auxiliá-lo a manter no topo as coisas organizando seus elementos do modelo em pastas. Você pode criar pastas selecionando a opção apropriada no menu de contexto (clique &RMB; em uma das pastas na visão de árvore) e você pode organizar seus elementos movendo-os para a pasta apropriada (arrastar e soltar) </para> +<title>Visão de Árvore</title> +<para>A Visão de Árvore é localizada na parte superior esquerda da janela, e mostra todos os diagramas, classes, atores e casos de uso que compuserem o seu modelo. A Visão de Árvore lhe permite ter uma rápida visão geral dos elementos componentes de seu modelo. A Visão de Árvore também lhe fornece uma maneira rápida de alternar entre os diferentes diagramas em seu modelo e inserir elementos de seu modelo no diagrama atual. </para> +<para>Se você está trabalhando em um modelo com mais do que algumas poucas classes e diagramas, a Visão de Árvore pode auxiliá-lo a manter no topo as coisas organizando seus elementos do modelo em pastas. Você pode criar pastas selecionando a opção apropriada no menu de contexto (clique &RMB; em uma das pastas na visão de árvore) e você pode organizar seus elementos movendo-os para a pasta apropriada (arrastar e soltar) </para> </sect2> <sect2 id="documentation-window"> -<title ->Janela de Documentação</title> -<para ->A Janela de Documentação é a pequena janela localizada na parte inferior esquerda do &umbrello;, e ela lhe fornece uma rápida previsão da documentação para o ítem atualmente selecionado. A Janela de Documentação é um pouco pequena porque ela pretende permitir-lhe apenas uma rápida observação dos elementos da documentação ocupando o menor espaço possível. Se você precisar ver a documentação em mais detalhes você pode sempre abrir as propriedades do ítem. </para> +<title>Janela de Documentação</title> +<para>A Janela de Documentação é a pequena janela localizada na parte inferior esquerda do &umbrello;, e ela lhe fornece uma rápida previsão da documentação para o ítem atualmente selecionado. A Janela de Documentação é um pouco pequena porque ela pretende permitir-lhe apenas uma rápida observação dos elementos da documentação ocupando o menor espaço possível. Se você precisar ver a documentação em mais detalhes você pode sempre abrir as propriedades do ítem. </para> </sect2> <sect2 id="work-area"> -<title ->Área de Trabalho</title> -<para ->A Área de Trabalho é a janela principal do &umbrello;, e é onde as ações reais ocorrem. Você usa a Área de Trabalho para editar e ver os diagramas em seu modelo. A Área de Trabalho mostra o diagrama atualmente ativo. Atualmente somente um diagrama pode ser mostrado na Área de Trabalho de cada vez. </para> +<title>Área de Trabalho</title> +<para>A Área de Trabalho é a janela principal do &umbrello;, e é onde as ações reais ocorrem. Você usa a Área de Trabalho para editar e ver os diagramas em seu modelo. A Área de Trabalho mostra o diagrama atualmente ativo. Atualmente somente um diagrama pode ser mostrado na Área de Trabalho de cada vez. </para> </sect2> -</sect1 -> <!--user-interface--> +</sect1> <!--user-interface--> <sect1 id="load-save"> -<title ->Criando, Carregando e Salvando Modelos</title> -<para ->A primeira coisa que você precisa para iniciar a fazer algo útil com o &umbrello; é criar um modelo para trabalho. Quando você inicia o &umbrello; ele sempre carrega o último modelo usado ou cria um novo modelo vazio (dependendo de suas configurações de preferências no diálogo de configuração). Isto lhe permitirá iniciar trabalhando rapidamente. </para> +<title>Criando, Carregando e Salvando Modelos</title> +<para>A primeira coisa que você precisa para iniciar a fazer algo útil com o &umbrello; é criar um modelo para trabalho. Quando você inicia o &umbrello; ele sempre carrega o último modelo usado ou cria um novo modelo vazio (dependendo de suas configurações de preferências no diálogo de configuração). Isto lhe permitirá iniciar trabalhando rapidamente. </para> <sect2 id="new-model"> -<title ->Novo Modelo</title> -<para ->Se a qualquer momento você precisar criar um novo modelo você pode fazer isto selecionando a entrada <guimenuitem ->Novo</guimenuitem -> no menu <guimenu ->Arquivo</guimenu ->, ou clicando o ícone <guiicon ->Novo</guiicon -> na barra de ferramentas do aplicativo. Se você estiver trabalhando no momento em um modelo que foi modificado, o &umbrello; lhe perguntará se deseja salvar as mudanças antes de carregar o novo modelo. </para> +<title>Novo Modelo</title> +<para>Se a qualquer momento você precisar criar um novo modelo você pode fazer isto selecionando a entrada <guimenuitem>Novo</guimenuitem> no menu <guimenu>Arquivo</guimenu>, ou clicando o ícone <guiicon>Novo</guiicon> na barra de ferramentas do aplicativo. Se você estiver trabalhando no momento em um modelo que foi modificado, o &umbrello; lhe perguntará se deseja salvar as mudanças antes de carregar o novo modelo. </para> </sect2> <sect2 id="save-model"> -<title ->Salvar Modelo</title> -<para ->Você pode salvar seu modelo a qualquer momento selecionando a opção <guimenuitem ->Salvar</guimenuitem -> do Menu <guimenu ->Arquivo</guimenu -> ou clicando no botão <guiicon ->Salvar</guiicon -> na barra de ferramentas do aplicativo. Se você precisar salvar seu modelo com um nome diferente você pode usar a opção <guimenuitem ->Salvar Como</guimenuitem -> no Menu <guimenu ->Arquivo</guimenu ->. </para> -<para ->Para sua conveniência, o &umbrello; também oferece a opção de salvar automaticamente seu trabalho a cada período de tempo determinado. Você pode configurar se deseja esta opção bem como o intervalo de tempo nas <guimenu ->Configurações</guimenu -> do &umbrello;</para> +<title>Salvar Modelo</title> +<para>Você pode salvar seu modelo a qualquer momento selecionando a opção <guimenuitem>Salvar</guimenuitem> do Menu <guimenu>Arquivo</guimenu> ou clicando no botão <guiicon>Salvar</guiicon> na barra de ferramentas do aplicativo. Se você precisar salvar seu modelo com um nome diferente você pode usar a opção <guimenuitem>Salvar Como</guimenuitem> no Menu <guimenu>Arquivo</guimenu>. </para> +<para>Para sua conveniência, o &umbrello; também oferece a opção de salvar automaticamente seu trabalho a cada período de tempo determinado. Você pode configurar se deseja esta opção bem como o intervalo de tempo nas <guimenu>Configurações</guimenu> do &umbrello;</para> </sect2> <sect2 id="load-model"> -<title ->Carregar Modelo</title> -<para ->Para carregar um modelo já existente você pode selecionar a opção <guimenuitem ->Abrir</guimenuitem -> no Menu <guimenu ->Arquivo</guimenu -> ou clicar no ícone <guiicon ->Abrir</guiicon -> na barra de ferramentas do aplicativo. Os modelos mais recentemente usados também estão disponíveis no submenu <guimenuitem ->Abrir Recente</guimenuitem -> do Menu <guimenu ->Arquivo</guimenu -> para acelerar o acesso aos seus modelos mais freqüentemente usados. </para> -<para ->O &umbrello; pode trabalhar com somente um modelo por vez, logo se você pedir que o programa carregue um modelo e o modelo atual foi modificado desde a última vez que você o salvou, o &umbrello; lhe perguntará se suas mudanças devem ser salvas para evitar qualquer perda de seu trabalho. Você pode iniciar duas ou mais instâncias do &umbrello; ao mesmo tempo, de modo que você possa copiar e colar entre as instâncias. </para> +<title>Carregar Modelo</title> +<para>Para carregar um modelo já existente você pode selecionar a opção <guimenuitem>Abrir</guimenuitem> no Menu <guimenu>Arquivo</guimenu> ou clicar no ícone <guiicon>Abrir</guiicon> na barra de ferramentas do aplicativo. Os modelos mais recentemente usados também estão disponíveis no submenu <guimenuitem>Abrir Recente</guimenuitem> do Menu <guimenu>Arquivo</guimenu> para acelerar o acesso aos seus modelos mais freqüentemente usados. </para> +<para>O &umbrello; pode trabalhar com somente um modelo por vez, logo se você pedir que o programa carregue um modelo e o modelo atual foi modificado desde a última vez que você o salvou, o &umbrello; lhe perguntará se suas mudanças devem ser salvas para evitar qualquer perda de seu trabalho. Você pode iniciar duas ou mais instâncias do &umbrello; ao mesmo tempo, de modo que você possa copiar e colar entre as instâncias. </para> </sect2> -</sect1 -> <!--load-save--> +</sect1> <!--load-save--> <sect1 id="edit-model"> -<title ->Editando Modelos</title> -<para ->No &umbrello;, existem basicamente duas maneiras de editar os elementos em seu modelo. <itemizedlist> -<listitem -><para ->Editar elementos do modelo diretamente através da Visão de Árvore</para -></listitem> -<listitem -><para ->Editar elementos do modelo através de um Diagrama</para -></listitem> +<title>Editando Modelos</title> +<para>No &umbrello;, existem basicamente duas maneiras de editar os elementos em seu modelo. <itemizedlist> +<listitem><para>Editar elementos do modelo diretamente através da Visão de Árvore</para></listitem> +<listitem><para>Editar elementos do modelo através de um Diagrama</para></listitem> </itemizedlist> </para> -<para ->Usando o menu de contexto dos diferentes ítens na Visão de Árvore você será capaz de adicionar, remover e modificar a maioria dos elementos em seu modelo. Clique <mousebutton ->direito</mousebutton -> nas pastas na Visão de Árvore lhe fornecerá as opções para criação dos diferentes tipos de diagramas bem como, dependendo se a pasta é uma <emphasis ->Visão de Caso de Uso</emphasis -> ou uma <emphasis ->Visão Lógica</emphasis ->, Atores, Casos de Uso, Classes, etc. </para> -<para ->Uma vez que você tenha adicionado elementos ao seu modelo você pode também editá-los acessando seus diálogos de propriedades, que será encontrado selecionando a opção <emphasis ->Propriedades</emphasis -> no menu de contexto mostrado quando der um clique <mousebutton ->direito</mousebutton -> nos ítens na Visão de Árvore. </para> -<para ->Você pode também editar seu modelo criando e modificando elementos pelos diagramas. Mais detalhes sobre como fazer isto são fornecidos nas seguintes seções. </para> +<para>Usando o menu de contexto dos diferentes ítens na Visão de Árvore você será capaz de adicionar, remover e modificar a maioria dos elementos em seu modelo. Clique <mousebutton>direito</mousebutton> nas pastas na Visão de Árvore lhe fornecerá as opções para criação dos diferentes tipos de diagramas bem como, dependendo se a pasta é uma <emphasis>Visão de Caso de Uso</emphasis> ou uma <emphasis>Visão Lógica</emphasis>, Atores, Casos de Uso, Classes, etc. </para> +<para>Uma vez que você tenha adicionado elementos ao seu modelo você pode também editá-los acessando seus diálogos de propriedades, que será encontrado selecionando a opção <emphasis>Propriedades</emphasis> no menu de contexto mostrado quando der um clique <mousebutton>direito</mousebutton> nos ítens na Visão de Árvore. </para> +<para>Você pode também editar seu modelo criando e modificando elementos pelos diagramas. Mais detalhes sobre como fazer isto são fornecidos nas seguintes seções. </para> </sect1> <sect1 id="add-remove-diagrams"> -<title ->Adicionando e Removendo Diagramas</title> -<para ->Seu modelo &UML; consiste de um conjunto de elementos &UML; e associações entre eles. No entanto você não pode ver o modelo diretamente, você usa os <emphasis ->Diagramas</emphasis -> para vê-lo. </para> +<title>Adicionando e Removendo Diagramas</title> +<para>Seu modelo &UML; consiste de um conjunto de elementos &UML; e associações entre eles. No entanto você não pode ver o modelo diretamente, você usa os <emphasis>Diagramas</emphasis> para vê-lo. </para> <sect2 id="create-diagram"> -<title ->Criando Diagramas</title> -<para ->Para criar um novo diagrama em seu modelo simplesmente selecione o tipo de diagrama que você deseja a partir do submenu <guimenuitem ->Novo</guimenuitem -> no menu <guimenu ->Diagrama</guimenu -> e dê um nome a ele. O diagrama será criada e tornado ativo, e você imediatamente o verá na visão de árvore. </para> -<para ->Lembre-se que o &umbrello; faz um uso intensivo de menus de contexto: você pode também clicar o &RMB; numa pasta na Visão de Árvore e selecionar o tipo apropriado de diagrama a partir do submenu <guisubmenu ->Novo</guisubmenu -> no menu de contexto. Observe que você pode criar Diagramas de Caso de Uso somente em pastas de Visão de Caso de Uso, e os outros tipos de diagrama podem somente ser criados em pastas de Visão Lógica. </para> +<title>Criando Diagramas</title> +<para>Para criar um novo diagrama em seu modelo simplesmente selecione o tipo de diagrama que você deseja a partir do submenu <guimenuitem>Novo</guimenuitem> no menu <guimenu>Diagrama</guimenu> e dê um nome a ele. O diagrama será criada e tornado ativo, e você imediatamente o verá na visão de árvore. </para> +<para>Lembre-se que o &umbrello; faz um uso intensivo de menus de contexto: você pode também clicar o &RMB; numa pasta na Visão de Árvore e selecionar o tipo apropriado de diagrama a partir do submenu <guisubmenu>Novo</guisubmenu> no menu de contexto. Observe que você pode criar Diagramas de Caso de Uso somente em pastas de Visão de Caso de Uso, e os outros tipos de diagrama podem somente ser criados em pastas de Visão Lógica. </para> </sect2> <sect2 id="remove-diagram"> -<title ->Removendo Diagramas</title> -<para ->Caso você precise remover um diagrama de seu modelo, você pode fazer isto tornando-o ativo e selecionando <guimenuitem ->Excluir</guimenuitem -> a partir do Menu <guimenu ->Diagrama</guimenu ->. Você pode também conseguir isto selecionando <guimenuitem ->Excluir</guimenuitem -> no menu de contexto do diagrama na Visão de Árvore </para> -<para ->Uma vez que excluir um diagrama é algo sério que pode causar perda de trabalho se feito por acidente, o &umbrello; lhe pedirá para confirmar a operação de exclusão antes de remover o Diagrama atual. Uma vez que o diagrama seja excluído e o arquivo salvo não existe nenhuma maneira de desfazer esta ação. </para> +<title>Removendo Diagramas</title> +<para>Caso você precise remover um diagrama de seu modelo, você pode fazer isto tornando-o ativo e selecionando <guimenuitem>Excluir</guimenuitem> a partir do Menu <guimenu>Diagrama</guimenu>. Você pode também conseguir isto selecionando <guimenuitem>Excluir</guimenuitem> no menu de contexto do diagrama na Visão de Árvore </para> +<para>Uma vez que excluir um diagrama é algo sério que pode causar perda de trabalho se feito por acidente, o &umbrello; lhe pedirá para confirmar a operação de exclusão antes de remover o Diagrama atual. Uma vez que o diagrama seja excluído e o arquivo salvo não existe nenhuma maneira de desfazer esta ação. </para> </sect2> <sect2 id="rename-diagram"> -<title ->Renomeando Diagramas</title> -<para ->Se você deseja mudar o nome de um diagrama existente você pode facilmente fazer isto selecionando a opção Renomear no menu &RMB; na Visão de Árvore. </para> -<para ->Outra maneira de renomear um diagrama é fazer isto através de seu diálogo de propriedades, que pode ser obtido selecionando Propriedades a partir do Menu de Contexto ou através de um clique duplo nele na Visão de Árvore. </para> +<title>Renomeando Diagramas</title> +<para>Se você deseja mudar o nome de um diagrama existente você pode facilmente fazer isto selecionando a opção Renomear no menu &RMB; na Visão de Árvore. </para> +<para>Outra maneira de renomear um diagrama é fazer isto através de seu diálogo de propriedades, que pode ser obtido selecionando Propriedades a partir do Menu de Contexto ou através de um clique duplo nele na Visão de Árvore. </para> </sect2> </sect1> <sect1 id="edit-diagram"> -<title ->Editando Diagramas</title> -<para ->Enquanto trabalha num diagrama, o &umbrello; tentará guiá-lo aplicando algumas regras simples como quais elementos são validados nos diferentes tipos de diagramas, bem como os relacionamentos que podem existir entre eles. Se você é experiente em &UML; você provavelmente não será noticiado, mas isto auxiliará novatos em &UML; a criar diagramas em conformidade com os padrões. </para> -<para ->Uma vez que você tenha criado seus diagramas é hora de iniciar a editá-los. Aqui você deve notar (para iniciantes perspicazes) a diferença entre editar seu diagrama e editar o <emphasis ->modelo</emphasis ->. Como você já deve saber, Diagramas são <emphasis ->visões</emphasis -> do seu modelo. Por exemplo, se você criar uma classe editando um Diagrama de Classe, você estará realmente editando ambos, seu Diagrama e seu modelo. Se você mudar a cor ou outra opção de exibição de uma Classe em seu Diagrama de Classe, você estará somente editando o Diagrama, mas nada será mudado no seu modelo. </para> +<title>Editando Diagramas</title> +<para>Enquanto trabalha num diagrama, o &umbrello; tentará guiá-lo aplicando algumas regras simples como quais elementos são validados nos diferentes tipos de diagramas, bem como os relacionamentos que podem existir entre eles. Se você é experiente em &UML; você provavelmente não será noticiado, mas isto auxiliará novatos em &UML; a criar diagramas em conformidade com os padrões. </para> +<para>Uma vez que você tenha criado seus diagramas é hora de iniciar a editá-los. Aqui você deve notar (para iniciantes perspicazes) a diferença entre editar seu diagrama e editar o <emphasis>modelo</emphasis>. Como você já deve saber, Diagramas são <emphasis>visões</emphasis> do seu modelo. Por exemplo, se você criar uma classe editando um Diagrama de Classe, você estará realmente editando ambos, seu Diagrama e seu modelo. Se você mudar a cor ou outra opção de exibição de uma Classe em seu Diagrama de Classe, você estará somente editando o Diagrama, mas nada será mudado no seu modelo. </para> <sect2 id="insert-elements"> -<title ->Inserir Elementos</title> -<para ->Uma das primeiras coisas que você deverá fazer ao editar um novo diagrama é inserir elementos nele (Classes, Atores, Casos de Uso, &etc;). Existem basicamente duas maneiras de fazer isto:</para> +<title>Inserir Elementos</title> +<para>Uma das primeiras coisas que você deverá fazer ao editar um novo diagrama é inserir elementos nele (Classes, Atores, Casos de Uso, &etc;). Existem basicamente duas maneiras de fazer isto:</para> <itemizedlist> -<listitem -><para ->Arrastando elementos existentes em seu modelo da Visão de Árvore</para -></listitem> -<listitem -><para ->Criando novos elementos em seu modelo e adicionando-os ao seu diagrama ao mesmo tempo, usando uma das Ferramentas de edição da Barra de Ferramentas de Trabalho</para -></listitem> +<listitem><para>Arrastando elementos existentes em seu modelo da Visão de Árvore</para></listitem> +<listitem><para>Criando novos elementos em seu modelo e adicionando-os ao seu diagrama ao mesmo tempo, usando uma das Ferramentas de edição da Barra de Ferramentas de Trabalho</para></listitem> </itemizedlist> -<para ->Para inserir elementos que já existam em seu modelo, apenas arraste-os da Visão de Árvore e solte-os onde você deseja posicioná-los em seu diagrama. Você sempre poderá mover elementos pelo Diagrama usando a Ferramenta Selecionar </para> -<para ->A segunda maneira de adicionar elementos ao seu diagrama é usando as ferramentas de edição da Barra de Ferramentas de Trabalho (observe que isto também adicionará elementos ao seu modelo). </para> -<para ->A Barra de Ferramentas de Trabalho era localizada por padrão no lado direito da janela do aplicativo, mas o &umbrello; 1.2 moveu-a para a parte superior da janela. Você pode colocá-la em outro lado ou tê-la flutuante se preferir. As ferramentas disponíveis nesta barra de ferramentas (os botões que você vê nela) mudam dependendo do tipo de diagrama em que você está atualmente trabalhando. O botão para a ferramenta atualmente selecionada é ativado na barra de ferramentas. Você pode alternar para a ferramenta selecionada pressionando a tecla &Esc;. </para> -<para ->Quando você tiver selecionado uma ferramenta de edição da Barra de Ferramentas de Trabalho (por exemplo, a ferramenta para inserir classes) o ponteiro do mouse muda para uma cruz, e você pode inserir os elementos em seu modelo através de um clique simples em seu diagrama. Observe que elementos em &UML; devem ter um <emphasis ->Nome Único</emphasis ->. Logo se você tiver uma classe em um diagrama cujo nome é <quote ->ClasseA</quote -> e então usar a ferramenta de inserção de classe para inserir um classe em outro diagrama você não pode nomear esta classe com <quote ->ClasseA</quote -> também. Se estes dois serão supostamente dois diferentes elementos, você deve fornecer-lhes um nome único. Se você está tentando adicionar o <emphasis ->mesmo</emphasis -> elemento em seu diagrama, então a Inserir Classe não é a ferramenta adequada para isto. Ao invés disso, você deve arrastar e soltar a classe da Visão de Árvore. </para> +<para>Para inserir elementos que já existam em seu modelo, apenas arraste-os da Visão de Árvore e solte-os onde você deseja posicioná-los em seu diagrama. Você sempre poderá mover elementos pelo Diagrama usando a Ferramenta Selecionar </para> +<para>A segunda maneira de adicionar elementos ao seu diagrama é usando as ferramentas de edição da Barra de Ferramentas de Trabalho (observe que isto também adicionará elementos ao seu modelo). </para> +<para>A Barra de Ferramentas de Trabalho era localizada por padrão no lado direito da janela do aplicativo, mas o &umbrello; 1.2 moveu-a para a parte superior da janela. Você pode colocá-la em outro lado ou tê-la flutuante se preferir. As ferramentas disponíveis nesta barra de ferramentas (os botões que você vê nela) mudam dependendo do tipo de diagrama em que você está atualmente trabalhando. O botão para a ferramenta atualmente selecionada é ativado na barra de ferramentas. Você pode alternar para a ferramenta selecionada pressionando a tecla &Esc;. </para> +<para>Quando você tiver selecionado uma ferramenta de edição da Barra de Ferramentas de Trabalho (por exemplo, a ferramenta para inserir classes) o ponteiro do mouse muda para uma cruz, e você pode inserir os elementos em seu modelo através de um clique simples em seu diagrama. Observe que elementos em &UML; devem ter um <emphasis>Nome Único</emphasis>. Logo se você tiver uma classe em um diagrama cujo nome é <quote>ClasseA</quote> e então usar a ferramenta de inserção de classe para inserir um classe em outro diagrama você não pode nomear esta classe com <quote>ClasseA</quote> também. Se estes dois serão supostamente dois diferentes elementos, você deve fornecer-lhes um nome único. Se você está tentando adicionar o <emphasis>mesmo</emphasis> elemento em seu diagrama, então a Inserir Classe não é a ferramenta adequada para isto. Ao invés disso, você deve arrastar e soltar a classe da Visão de Árvore. </para> </sect2> <sect2 id="delete-elements"> -<title ->Excluindo Elementos</title> -<para ->Você pode excluir qualquer elemento selecionando a opção <guimenuitem ->Excluir</guimenuitem -> do seu menu de contexto. </para> -<para ->Novamente, aqui existe uma <emphasis ->grande</emphasis -> diferença entre remover um objeto de um diagrama, e remover um objeto de seu modelo. Se você excluir um objeto de dentro de um diagrama, você está somente removendo o objeto daquele diagrama em particular: o elemento ainda faz parte do seu modelo e se existirem outros diagramas usando o mesmo elemento eles não sofrerão nenhuma mudança. Se, por outro lado, você excluir o elemento da Visão de Árvore, você está atualmente excluindo o elemento de seu <emphasis ->modelo</emphasis ->. Uma vez que o elemento não mais exista em seu modelo, ele será automaticamente removido de todos os diagramas em que ele aparece. </para> +<title>Excluindo Elementos</title> +<para>Você pode excluir qualquer elemento selecionando a opção <guimenuitem>Excluir</guimenuitem> do seu menu de contexto. </para> +<para>Novamente, aqui existe uma <emphasis>grande</emphasis> diferença entre remover um objeto de um diagrama, e remover um objeto de seu modelo. Se você excluir um objeto de dentro de um diagrama, você está somente removendo o objeto daquele diagrama em particular: o elemento ainda faz parte do seu modelo e se existirem outros diagramas usando o mesmo elemento eles não sofrerão nenhuma mudança. Se, por outro lado, você excluir o elemento da Visão de Árvore, você está atualmente excluindo o elemento de seu <emphasis>modelo</emphasis>. Uma vez que o elemento não mais exista em seu modelo, ele será automaticamente removido de todos os diagramas em que ele aparece. </para> </sect2> <sect2 id="edit-elements"> -<title ->Editando Elementos</title> -<para ->Você pode editar a maioria dos elementos &UML; em seu modelo e diagramas abrindo seu diálogo de Propriedades e selecionando as opções apropriadas. Para editar as propriedades de um objeto, selecione <guimenuitem ->Propriedades</guimenuitem -> no seu menu de contexto (clique &RMB;). Cada elemento possui um diálogo consistindo de diversas páginas de onde você pode configurar as opções correspondentes aquele elemento. Para alguns elementos, como atores, você pode somente configurar um par de opções, como o nome do objeto e documentação, enquanto outros elementos, como classes, você pode editar seus atributos e operações, selecionar o que você deseja que seja exibido no diagrama (toda a assinatura da operação ou apenas nomes da operação, etc) e também as cores que deseja usar para a linha e preenchimento da representação da classe no diagrama. </para> +<title>Editando Elementos</title> +<para>Você pode editar a maioria dos elementos &UML; em seu modelo e diagramas abrindo seu diálogo de Propriedades e selecionando as opções apropriadas. Para editar as propriedades de um objeto, selecione <guimenuitem>Propriedades</guimenuitem> no seu menu de contexto (clique &RMB;). Cada elemento possui um diálogo consistindo de diversas páginas de onde você pode configurar as opções correspondentes aquele elemento. Para alguns elementos, como atores, você pode somente configurar um par de opções, como o nome do objeto e documentação, enquanto outros elementos, como classes, você pode editar seus atributos e operações, selecionar o que você deseja que seja exibido no diagrama (toda a assinatura da operação ou apenas nomes da operação, etc) e também as cores que deseja usar para a linha e preenchimento da representação da classe no diagrama. </para> -<para ->Para a maioria dos elementos &UML; você pode também abrir o diálogo de propriedades através de um clique duplo nele se você está usando a ferramenta de seleção (seta). Uma exceção para isso são Associações, nas quais um clique duplo cria um ponto de ancoragem. Para associações você precisa usar o menu de contexto do &RMB; para obter o diálogo de propriedades. </para> +<para>Para a maioria dos elementos &UML; você pode também abrir o diálogo de propriedades através de um clique duplo nele se você está usando a ferramenta de seleção (seta). Uma exceção para isso são Associações, nas quais um clique duplo cria um ponto de ancoragem. Para associações você precisa usar o menu de contexto do &RMB; para obter o diálogo de propriedades. </para> -<para ->Observe que você também pode selecionar a opção propriedades do menu de contexto dos elementos na Visão de Árvore. Isto lhe permite também editar as propriedades para os diagramas, como configurar se a grade deve ser mostrada ou não. </para> +<para>Observe que você também pode selecionar a opção propriedades do menu de contexto dos elementos na Visão de Árvore. Isto lhe permite também editar as propriedades para os diagramas, como configurar se a grade deve ser mostrada ou não. </para> </sect2> <sect2 id="edit-classes"> -<title ->Editando Classes</title> -<para ->Apesar da edição de propriedades para todos os objetos já ter sido abordada na seção anterior, as classes merecem uma seção especial porque elas são um pouco mais complexas e possuem mais opções que a maioria dos outros elementos &UML;. </para> -<para ->No diálogo de propriedades para uma classe você pode configurar tudo, da cor que ela usa até as operações e atributos que ela possui. </para> +<title>Editando Classes</title> +<para>Apesar da edição de propriedades para todos os objetos já ter sido abordada na seção anterior, as classes merecem uma seção especial porque elas são um pouco mais complexas e possuem mais opções que a maioria dos outros elementos &UML;. </para> +<para>No diálogo de propriedades para uma classe você pode configurar tudo, da cor que ela usa até as operações e atributos que ela possui. </para> <sect3 id="class-general-settings"> -<title ->Configurações Gerais da Classe</title> -<para ->A página de Configurações Gerais do diálogo de propriedades é auto-explicativa. Aqui você pode mudar o nome da classe, visibilidade, documentação, &etc;. Esta página está sempre disponível. </para> +<title>Configurações Gerais da Classe</title> +<para>A página de Configurações Gerais do diálogo de propriedades é auto-explicativa. Aqui você pode mudar o nome da classe, visibilidade, documentação, &etc;. Esta página está sempre disponível. </para> </sect3> <sect3 id="class-attributes-settings"> -<title ->Configurações de Atributos da Classe</title> -<para ->Na página de Configurações de Atributos você pode adicionar, editar ou excluir atributos (variáveis) para esta classe. Você pode também mover atributos para cima e para baixo da lista pressionando o botão de seta ao lado. Esta página está sempre disponível. </para> +<title>Configurações de Atributos da Classe</title> +<para>Na página de Configurações de Atributos você pode adicionar, editar ou excluir atributos (variáveis) para esta classe. Você pode também mover atributos para cima e para baixo da lista pressionando o botão de seta ao lado. Esta página está sempre disponível. </para> </sect3> <sect3 id="class-operations-settings"> -<title ->Configurações de Operações da Classe</title> -<para ->Semelhante à Página de Configurações dos Atributos, na Página de Configurações das Operações você pode adicionar, editar ou remover operações para sua classe. Quando adiciona ou edita uma operação, você insere os dados básicos no diálogo <emphasis ->Propriedades da Operação</emphasis ->. Para adicionar parâmetros a sua operação você precisa clicar no botão <guibutton ->Novo Parâmetro</guibutton ->, que lhe mostrará o diálogo de <emphasis ->Propriedades do Parâmetro</emphasis ->. Esta página está sempre disponível </para> +<title>Configurações de Operações da Classe</title> +<para>Semelhante à Página de Configurações dos Atributos, na Página de Configurações das Operações você pode adicionar, editar ou remover operações para sua classe. Quando adiciona ou edita uma operação, você insere os dados básicos no diálogo <emphasis>Propriedades da Operação</emphasis>. Para adicionar parâmetros a sua operação você precisa clicar no botão <guibutton>Novo Parâmetro</guibutton>, que lhe mostrará o diálogo de <emphasis>Propriedades do Parâmetro</emphasis>. Esta página está sempre disponível </para> </sect3> <sect3 id="class-template-settings"> -<title ->Configurações de Modelo de Classe</title> -<para ->Esta página permite-lhe adicionar modelos de classe que serão classes não especificadas ou tipos de dados. Em Java 1.5 eles são chamados Genéricos. </para> +<title>Configurações de Modelo de Classe</title> +<para>Esta página permite-lhe adicionar modelos de classe que serão classes não especificadas ou tipos de dados. Em Java 1.5 eles são chamados Genéricos. </para> </sect3> <sect3 id="class-associations-page"> -<title ->Página Associações da Classe</title> -<para ->A página <guilabel ->Associações da Classe</guilabel -> mostra todas as associações desta classe no diagrama atual. Um clique duplo numa associação mostra suas propriedades, e dependendo do tipo de associação você pode modificar alguns parâmetros como um configuração de multiplicidade e nome da Regra. Se a associação não permitir que opções sejam modificadas, o diálogo de Propriedades da Associação é somente leitura e você pode somente modificar a documentação associada com esta associação. </para> -<para ->Esta página está disponível somente se você abrir as Propriedades da Classe de dentro de um diagrama. Se você selecionar as propriedades da classe no menu de contexto na Visão de Árvore esta página não estará disponível. </para> +<title>Página Associações da Classe</title> +<para>A página <guilabel>Associações da Classe</guilabel> mostra todas as associações desta classe no diagrama atual. Um clique duplo numa associação mostra suas propriedades, e dependendo do tipo de associação você pode modificar alguns parâmetros como um configuração de multiplicidade e nome da Regra. Se a associação não permitir que opções sejam modificadas, o diálogo de Propriedades da Associação é somente leitura e você pode somente modificar a documentação associada com esta associação. </para> +<para>Esta página está disponível somente se você abrir as Propriedades da Classe de dentro de um diagrama. Se você selecionar as propriedades da classe no menu de contexto na Visão de Árvore esta página não estará disponível. </para> </sect3> <sect3 id="class-display-page"> -<title ->Página de Exibição da Classe</title> -<para ->Na página de <guilabel ->Opções de Exibição</guilabel ->, você pode configurar como a classe será mostrada no diagrama. Uma classe pode ser mostrada como somente um retângulo com o nome da classe nele (útil se você possui muitas classes em seu diagrama, ou não está interessado no momento nos detalhes de cada classe) ou completa mostrando pacotes, estereótipos, atributos e operações com assinatura completa e visibilidade </para> -<para ->Dependendo da quantidade de informação que você deseja ver você pode selecionar as opções correspondentes nesta página. As mudanças que você realizar aqui serão somenta as <emphasis ->opções de exibição</emphasis -> para o diagrama. Isto significa que <quote ->ocultar</quote -> uma operação de classe somente faz com que ele não seja exibida no diagrama, mas a operação ainda faz parte de seu modelo. Esta opção está somente disponível se você selecionou as propriedades da classe de dentro de um Diagrama. Se você abrir as propriedades de classe a partir da Visão de Árvore esta página estará faltando uma vez que as Opções de Exibição não fazem sentido neste caso</para> +<title>Página de Exibição da Classe</title> +<para>Na página de <guilabel>Opções de Exibição</guilabel>, você pode configurar como a classe será mostrada no diagrama. Uma classe pode ser mostrada como somente um retângulo com o nome da classe nele (útil se você possui muitas classes em seu diagrama, ou não está interessado no momento nos detalhes de cada classe) ou completa mostrando pacotes, estereótipos, atributos e operações com assinatura completa e visibilidade </para> +<para>Dependendo da quantidade de informação que você deseja ver você pode selecionar as opções correspondentes nesta página. As mudanças que você realizar aqui serão somenta as <emphasis>opções de exibição</emphasis> para o diagrama. Isto significa que <quote>ocultar</quote> uma operação de classe somente faz com que ele não seja exibida no diagrama, mas a operação ainda faz parte de seu modelo. Esta opção está somente disponível se você selecionou as propriedades da classe de dentro de um Diagrama. Se você abrir as propriedades de classe a partir da Visão de Árvore esta página estará faltando uma vez que as Opções de Exibição não fazem sentido neste caso</para> </sect3> <sect3 id="class-color-page"> -<title ->Página de Cor da Classe</title> -<para ->Na página de <guilabel ->Cor do Widget</guilabel -> você pode configurar as cores que deseja para a linha e o preenchimento do widget. Esta opção obviamente faz sentido somente para classes exibidas em diagramas, e não aparecerá se você abrir o diálogo de propriedades da classe a partir da Visão de Árvore. </para> +<title>Página de Cor da Classe</title> +<para>Na página de <guilabel>Cor do Widget</guilabel> você pode configurar as cores que deseja para a linha e o preenchimento do widget. Esta opção obviamente faz sentido somente para classes exibidas em diagramas, e não aparecerá se você abrir o diálogo de propriedades da classe a partir da Visão de Árvore. </para> </sect3> </sect2> <sect2 id="associations"> -<title ->Associações</title> -<para ->Associações relacionam dois objetos &UML; um com o outro. Normalmente associações são definidas entre duas classes, mas alguns tipos de associações podem também existir entre casos de uso e atores. </para> -<para ->Para criar uma associação seleciona a ferramenta apropriada na Barra de Ferramentas de Trabalho (Associação genérica, Generalização, Agregação, &etc;) e dê um clique simples no primeiro elemento participante na associação e então um clique simples no segundo elemento participante. Observe que são dois cliques, um em cada um dos objetos participantes da associação, e <emphasis ->não</emphasis -> arrastar um objeto para outro. </para> -<para ->Se você tentar usar uma associação de uma maneira contrária as especificações &UML; o &umbrello; se recusará a criar a associação e você receberá uma mensagem de erro. Isto pode acontecer se, por exemplo, uma Generalização existir da classe A para classe B e então você tentar criar outra Generalização da classe B para a classe A </para> -<para ->Um clique <mousebutton ->direito</mousebutton -> numa associação mostrará um menu de contexto com as ações que você pode aplicar nela. Se você precisar excluir uma associação, simplesmente selecione a opção <guimenuitem ->Excluir</guimenuitem -> deste menu de contexto. Você pode também selecionar a opção <guimenuitem ->Propriedades</guimenuitem -> e, dependendo do tipo de associação, editar os atributos como regras e multiplicidade. </para> +<title>Associações</title> +<para>Associações relacionam dois objetos &UML; um com o outro. Normalmente associações são definidas entre duas classes, mas alguns tipos de associações podem também existir entre casos de uso e atores. </para> +<para>Para criar uma associação seleciona a ferramenta apropriada na Barra de Ferramentas de Trabalho (Associação genérica, Generalização, Agregação, &etc;) e dê um clique simples no primeiro elemento participante na associação e então um clique simples no segundo elemento participante. Observe que são dois cliques, um em cada um dos objetos participantes da associação, e <emphasis>não</emphasis> arrastar um objeto para outro. </para> +<para>Se você tentar usar uma associação de uma maneira contrária as especificações &UML; o &umbrello; se recusará a criar a associação e você receberá uma mensagem de erro. Isto pode acontecer se, por exemplo, uma Generalização existir da classe A para classe B e então você tentar criar outra Generalização da classe B para a classe A </para> +<para>Um clique <mousebutton>direito</mousebutton> numa associação mostrará um menu de contexto com as ações que você pode aplicar nela. Se você precisar excluir uma associação, simplesmente selecione a opção <guimenuitem>Excluir</guimenuitem> deste menu de contexto. Você pode também selecionar a opção <guimenuitem>Propriedades</guimenuitem> e, dependendo do tipo de associação, editar os atributos como regras e multiplicidade. </para> <sect3 id="anchor-points"> -<title ->Pontos de Ancoragem</title> -<para ->Associações são desenhadas, por padrão, como uma linha reta conectando dois objetos no diagrama. </para> -<para ->Você pode adicionar pontos de ancoragem dando um clique <mousebutton ->duplo</mousebutton -> ao longo da linha de associação. Isto irá inserir um ponto de ancoragem (exibido como um ponto azul quando a linha de associação é selecionada) o qual você poderá mover para obter a forma da associação </para> -<para ->Se você precisar remover um ponto de ancoragem, dê um clique <mousebutton ->duplo</mousebutton -> nele novamente para removê-lo </para> -<para ->Observe que a única maneira de editar as propriedades de uma associação é através do menu de contexto. Se você tentar das um clique <mousebutton ->duplo</mousebutton -> nela como é feito nos outros objetos &UML;, isto somente irá inserir um ponto de ancoragem. </para> +<title>Pontos de Ancoragem</title> +<para>Associações são desenhadas, por padrão, como uma linha reta conectando dois objetos no diagrama. </para> +<para>Você pode adicionar pontos de ancoragem dando um clique <mousebutton>duplo</mousebutton> ao longo da linha de associação. Isto irá inserir um ponto de ancoragem (exibido como um ponto azul quando a linha de associação é selecionada) o qual você poderá mover para obter a forma da associação </para> +<para>Se você precisar remover um ponto de ancoragem, dê um clique <mousebutton>duplo</mousebutton> nele novamente para removê-lo </para> +<para>Observe que a única maneira de editar as propriedades de uma associação é através do menu de contexto. Se você tentar das um clique <mousebutton>duplo</mousebutton> nela como é feito nos outros objetos &UML;, isto somente irá inserir um ponto de ancoragem. </para> </sect3> </sect2> <sect2 id="notes"> -<title ->Notas, Texto e Caixas</title> -<para ->Notas, Linhas de Texto e Caixas são elementos que podem ser representados em qualquer tipo de diagrama e não possuem nenhum valor semântico, mas são muito úteis para adicionar comentários extras ou explanações que podem tornar seu diagrama mais fácil de entender. </para> -<para ->Para adicionar uma Nota ou Linha de Texto, selecione a ferramenta correspondente na Barra de Ferramentas de Trabalho e dê um clique simples no diagrama onde você deseja colocar seu comentário. Você pode editar o texto abrindo o elemento através do menu de contexto ou, no caso de notas, através de um clique <mousebutton ->duplo</mousebutton -> nelas. </para> +<title>Notas, Texto e Caixas</title> +<para>Notas, Linhas de Texto e Caixas são elementos que podem ser representados em qualquer tipo de diagrama e não possuem nenhum valor semântico, mas são muito úteis para adicionar comentários extras ou explanações que podem tornar seu diagrama mais fácil de entender. </para> +<para>Para adicionar uma Nota ou Linha de Texto, selecione a ferramenta correspondente na Barra de Ferramentas de Trabalho e dê um clique simples no diagrama onde você deseja colocar seu comentário. Você pode editar o texto abrindo o elemento através do menu de contexto ou, no caso de notas, através de um clique <mousebutton>duplo</mousebutton> nelas. </para> <sect3 id="anchors"> -<title ->Âncoras</title> -<para ->Âncoras são usadas para manter uma nota de texto e outro Elemento &UML; juntos. Por exemplo, você normalmente usa uma nota de texto para explanar ou fazer algum comentário sobre uma classe ou uma associação em particular, neste caso você pode usar a âncora para tornar claro que a nota <quote ->pertence</quote -> aquele elemento em particular. </para> -<para ->Para adicionar uma âncora entre uma nota e outro elemento &UML;, use a ferramenta âncora da barra de ferramentas de trabalho. Você primeiro precisa clicar na nota e então clicar no elemento &UML; ao qual deseja que a nota se ligue. </para> +<title>Âncoras</title> +<para>Âncoras são usadas para manter uma nota de texto e outro Elemento &UML; juntos. Por exemplo, você normalmente usa uma nota de texto para explanar ou fazer algum comentário sobre uma classe ou uma associação em particular, neste caso você pode usar a âncora para tornar claro que a nota <quote>pertence</quote> aquele elemento em particular. </para> +<para>Para adicionar uma âncora entre uma nota e outro elemento &UML;, use a ferramenta âncora da barra de ferramentas de trabalho. Você primeiro precisa clicar na nota e então clicar no elemento &UML; ao qual deseja que a nota se ligue. </para> </sect3> </sect2> </sect1> |