From 0b8ca6637be94f7814cafa7d01ad4699672ff336 Mon Sep 17 00:00:00 2001 From: Darrell Anderson Date: Tue, 21 Jan 2014 22:06:48 -0600 Subject: Beautify docbook files --- .../docs/tdemultimedia/artsbuilder/helping.docbook | 168 +++++---------------- 1 file changed, 40 insertions(+), 128 deletions(-) (limited to 'tde-i18n-pt_BR/docs/tdemultimedia/artsbuilder/helping.docbook') diff --git a/tde-i18n-pt_BR/docs/tdemultimedia/artsbuilder/helping.docbook b/tde-i18n-pt_BR/docs/tdemultimedia/artsbuilder/helping.docbook index 714f1d7ca1f..185b5d29197 100644 --- a/tde-i18n-pt_BR/docs/tdemultimedia/artsbuilder/helping.docbook +++ b/tde-i18n-pt_BR/docs/tdemultimedia/artsbuilder/helping.docbook @@ -4,71 +4,38 @@ To validate or process this file as a standalone document, uncomment this prolog. Be sure to comment it out again when you are done --> -Contribuindo com o &arts; +Contribuindo com o &arts; -Como Eu Posso Ajudar +Como Eu Posso Ajudar -O projeto &arts; pode se beneficiar da ajuda de desenvolvedores para tornar os aplicativos multimídia existentes compatíveis com o &arts;, escrever novos aplicativos multimídia, e incrementar os recursos do &arts;. No entanto, você não precisa ser um desenvolvedor para contribuir. Nós podems também nos beneficiar de testadores para submeter relatórios de erros, tradutores para traduzir o texto e documentação do aplicativo para outros idiomas, artistas para desenhar bitmaps (especialmente para os módulos do artsbuilder), músicos para criar modos de amostras para o &arts;, e escritores para escrever ou analisar a documentação. +O projeto &arts; pode se beneficiar da ajuda de desenvolvedores para tornar os aplicativos multimídia existentes compatíveis com o &arts;, escrever novos aplicativos multimídia, e incrementar os recursos do &arts;. No entanto, você não precisa ser um desenvolvedor para contribuir. Nós podems também nos beneficiar de testadores para submeter relatórios de erros, tradutores para traduzir o texto e documentação do aplicativo para outros idiomas, artistas para desenhar bitmaps (especialmente para os módulos do artsbuilder), músicos para criar modos de amostras para o &arts;, e escritores para escrever ou analisar a documentação. -Listas de Discussão - -A maioria das discossões sobre o desenvolvimento do &arts; ocorrem em duas listas. Elas são o local para discutir novos recursos e idéias de implementação ou pedir ajuda quando problemas acontecem. - -A lista de discussão de Multimídia do &kde; é para questões gerais sobre multimídia no &kde; incluindo o &arts; bem como aplicativos multimídia como o &noatun; e &aktion;. Você pode inscrever-se a partir da página web em http://www.kde.org/mailinglists.html ou enviar uma mensagem eletrônica com o assunto subscribe seu-endereço-eletrônico para kde-multimedia-request@kde.org. A lista também é arquivada em http://lists.kde.org. - -A lista de discussão do &arts; é para questões específicas do &arts;, incluindo uso não-&kde; do &arts;. Para inscrever-se, envie uma mensagem eletrônica contendo o corpo da mensagem subscribe seu-endereço-eletrônico para arts-request@space.twc.de. A lista é arquivada em http://space.twc.de/~stefan/arts-archive. +Listas de Discussão + +A maioria das discossões sobre o desenvolvimento do &arts; ocorrem em duas listas. Elas são o local para discutir novos recursos e idéias de implementação ou pedir ajuda quando problemas acontecem. + +A lista de discussão de Multimídia do &kde; é para questões gerais sobre multimídia no &kde; incluindo o &arts; bem como aplicativos multimídia como o &noatun; e &aktion;. Você pode inscrever-se a partir da página web em http://www.kde.org/mailinglists.html ou enviar uma mensagem eletrônica com o assunto subscribe seu-endereço-eletrônico para kde-multimedia-request@kde.org. A lista também é arquivada em http://lists.kde.org. + +A lista de discussão do &arts; é para questões específicas do &arts;, incluindo uso não-&kde; do &arts;. Para inscrever-se, envie uma mensagem eletrônica contendo o corpo da mensagem subscribe seu-endereço-eletrônico para arts-request@space.twc.de. A lista é arquivada em http://space.twc.de/~stefan/arts-archive. -Padrões de Codificação +Padrões de Codificação -Para obter uma leitura consistente em todas as fontes, é importante manter o mesmo estilo de código, em todos arquivos de código fonte do &arts;. Por favor, se você acabou de escrever um módulo, tente escrever/formatar seu código de acordo, assim ficará mais fácil para as diferentes pessoas manter a árvore de código fonte, e mais fácil copiar partes de código de um arquivo para outro. +Para obter uma leitura consistente em todas as fontes, é importante manter o mesmo estilo de código, em todos arquivos de código fonte do &arts;. Por favor, se você acabou de escrever um módulo, tente escrever/formatar seu código de acordo, assim ficará mais fácil para as diferentes pessoas manter a árvore de código fonte, e mais fácil copiar partes de código de um arquivo para outro. -Nomeando funções membro +Nomeando funções membro -Estilo &Qt;/&Java;. Ou seja, capitalização nas quebras de palavra, e a primeira letra sempre sem capitalização, sem sublinhados. -Isto significa, por exemplo: +Estilo &Qt;/&Java;. Ou seja, capitalização nas quebras de palavra, e a primeira letra sempre sem capitalização, sem sublinhados. +Isto significa, por exemplo: -createStructureDesc() +createStructureDesc() updateWidget(); start(); @@ -76,94 +43,54 @@ this prolog. Be sure to comment it out again when you are done --> -Membros de classe +Membros de classe -Membros de classe não são capitalizados, assim como uma barra de menu ou botão. +Membros de classe não são capitalizados, assim como uma barra de menu ou botão. -Onde estão acessando funções, o padrão deve ser o do &MCOP;, que é, ao ter um membro longo foo, que deve ser visível diretamente, você cria: +Onde estão acessando funções, o padrão deve ser o do &MCOP;, que é, ao ter um membro longo foo, que deve ser visível diretamente, você cria: -foo(long new_value); +foo(long new_value); long foo(); -funções para obter ou configurar o valor. Neste caso, o valor real de foo deve ser armazenado em _foo. +funções para obter ou configurar o valor. Neste caso, o valor real de foo deve ser armazenado em _foo. -Nomes de classe +Nomes de classe -Todas as classes devem ter capitalizadas as letras iniciais das palavras, o que significa ModuleView, SynthModule. Todas as classes que se originam de bibliotecas devem usar o espaço de nomes do &arts;, como Arts::Soundserver. -A implementação de classes &MCOP; deve ser chamada Classe_impl, como SoundServer_impl. +Todas as classes devem ter capitalizadas as letras iniciais das palavras, o que significa ModuleView, SynthModule. Todas as classes que se originam de bibliotecas devem usar o espaço de nomes do &arts;, como Arts::Soundserver. +A implementação de classes &MCOP; deve ser chamada Classe_impl, como SoundServer_impl. -Parâmetros +Parâmetros -Os parâmetros são sempre em minúsculas. +Os parâmetros são sempre em minúsculas. -Variáveis locais +Variáveis locais -Variáveis locais são sempre em minúsculas, e devem ter nomes como i, p, x, &etc; onde apropriado. +Variáveis locais são sempre em minúsculas, e devem ter nomes como i, p, x, &etc; onde apropriado. -Largura da tabulação (largura do Shift) +Largura da tabulação (largura do Shift) -Uma tabulação deve ser tão longa quanto 4 espaços. +Uma tabulação deve ser tão longa quanto 4 espaços. -Espaços em expressões. +Espaços em expressões. -Você normalmente não precisa usar espaços em expressões. Você pode entretanto usá-los entre o operador e seus operandos. No entanto, se você colocar um espaço antes de um operador (por exemplo o +), você também deve colocar um espaço após o operador. A única exceção a isto são expressões estilo lista (com ,), onde você deve colocar um espaço após a "," mas não antes. Não há problemas se omitir o espaço aqui também. -Os exemplos a seguir demonstram o bom uso de espaços: -{ +Você normalmente não precisa usar espaços em expressões. Você pode entretanto usá-los entre o operador e seus operandos. No entanto, se você colocar um espaço antes de um operador (por exemplo o +), você também deve colocar um espaço após o operador. A única exceção a isto são expressões estilo lista (com ,), onde você deve colocar um espaço após a "," mas não antes. Não há problemas se omitir o espaço aqui também. +Os exemplos a seguir demonstram o bom uso de espaços: +{ int a,b; int c, d, e; int f = 4; @@ -181,12 +108,8 @@ this prolog. Be sure to comment it out again when you are done --> arts_debug("%d\n", c); } -Os exemplos a seguir demonstram como não usar espaços. Para chamadas de função, após if, while, for, switch e assim por diante, nenhum espaço deve ser escrito. -{ +Os exemplos a seguir demonstram como não usar espaços. Para chamadas de função, após if, while, for, switch e assim por diante, nenhum espaço deve ser escrito. +{ // RUIM: se você escreveu uma lista, espaços em branco somente após a "," int a , b , c , d , e , f; @@ -213,22 +136,11 @@ this prolog. Be sure to comment it out again when you are done --> -Nomes de arquivos fonte +Nomes de arquivos fonte -Arquivos fonte não devem ter capitalização no nome. Eles devem ter o nome da classe quando implementam uma classe única. Sua extensão é .cc se eles referem-se a código independente para &Qt;/&GUI;, e .cpp se eles referem-se a código dependente do &Qt;/&GUI;. Arquivos de implementação para interfaces devem ser chamados foo_impl, se Foo foi o nome da interface. - -Arquivos &IDL; devem ser chamados de uma maneira descritiva para a coleção de interfaces que eles contém, também tudo em minúsculas. Especialmente não é uma boa idéia chamar um arquivo &IDL; como a classe propriamente dita, assim como o negociador mcopclass e inserir entradas de informação conflitantes. +Arquivos fonte não devem ter capitalização no nome. Eles devem ter o nome da classe quando implementam uma classe única. Sua extensão é .cc se eles referem-se a código independente para &Qt;/&GUI;, e .cpp se eles referem-se a código dependente do &Qt;/&GUI;. Arquivos de implementação para interfaces devem ser chamados foo_impl, se Foo foi o nome da interface. + +Arquivos &IDL; devem ser chamados de uma maneira descritiva para a coleção de interfaces que eles contém, também tudo em minúsculas. Especialmente não é uma boa idéia chamar um arquivo &IDL; como a classe propriamente dita, assim como o negociador mcopclass e inserir entradas de informação conflitantes. -- cgit v1.2.1