NOME

       podebconf-report-po - enviar ficheiros PO de debconf, desactualizados, aos últimos tradutores

SINOPSE

       podebconf-report-po [options]

DESCRIÇÃO

       Este programa lê um directório com ficheiros po para determinar quais os ficheiros que contêm traduções
       em falta ou marcadas como fuzzy, lança um editor para permitir modificações ao corpo e cabeçalhos do
       mail, pede confirmação para enviar os mails, e envia-os ao último tradutor pedindo uma actualização.  O
       mail irá conter o ficheiro PO que tem de ser actualizado.  O podebconf-report-po pode ser chamado quer a
       partir do directório de nível de topo, ou nos sub-directórios debian ou debian/po (ou, para traduções
       não-debconf, a partir do próprio directório po ou do seu directório-pai).

       O podebconf-report-po também pode ser utilizado para enviar um pedido de traduções para uma mailing list.
       Neste caso, o ficheiro POT será anexado.

       Existem diferentes templates para pedidos de actualização da tradução, pedidos para enviar ficheiros PO
       actualizados para um relatório de bug (--submit) ou para chamadas para traduções (--call).  O template
       pode também ser fornecido pelo utilizador.  Veja a secção TEMPLATES para mais informações acerca dos
       templates.

OPÇÕES

       Podem ser definidas muitas opções num ficheiro de configuração.  Veja a secção FICHEIRO DE CONFIGURAÇÃO.

       --addlanguageteam=LANGUAGE:LIST
           Especificar  a  mailing  list para um determinado idioma.  Quando for utilizado <--languageteam> esta
           mailing list será acrescentada ao CC da lista para os ficheiros PO deste idioma, além disso a  equipa
           do idioma especificado no ficheiro PO (se estas mailing lists diferirem).

           Isto  é útil para manter as equipas especificas informadas, e permitir uma reacção mais rápida quando
           se sabe que um tradutor está inactivo.

           Esta opção pode ser especificada mais do que uma vez.  O código do idioma e a mailing list do  idioma
           são separados pelo sinal de dois pontos.

           Esta  opção  pode  ser  especificada  no  ficheiro  de  configuração  para  definir  o  comportamento
           pré-definido de podebconf-report-po.  Veja, abaixo, a secção CONFIGURATION FILE.

       --bts=NUMBER
           Após ter sido enviado um relato de bug (manualmente ou com a flag --submit) para seguir as traduções,
           o podebconf-report-po pode correr novamente, mas desta vez com a flag --bts=NUMBER.  É  então  pedido
           aos  tradutores  que respeitem o campo do cabeçalho Reply-To: que é definido para este relato de bug,
           para que todas as traduções sejam juntas num mesmo local único.

       --call[=MAILING_LIST]
           Enviar um pedido de traduções.  Se o argumento opcional MAILING_LIST não for especificado,  o  pedido
           de traduções é enviado para a lista Debian Internationalization (debian-i18n@lists.debian.org).

           Os pedidos de traduções são úteis para receber traduções em novos idiomas.

           Por  pré-definição,  os pedidos de traduções são combinados com os pedidos normais de actualização de
           traduções aos tradutores, para as traduções já existentes. Você pode desabilitar  este  comportamento
           pré-definido com a opção --withouttranslators.

       --conf=FILE
           Especificar  o  ficheiro  de  configuração.  O ficheiro pré-definido que o podebconf-report-po lê é o
           $HOME/.podebconf-report-po.conf.

       --noconf
           Não ler qualquer ficheiro de configuração.

       --deadline=DEADLINE
           Especificar o prazo para receber as traduções actualizadas (o valor pré-definido é sem prazo).

           Isto deve ser uma data, que pode ser precedida por:
            O prazo para receber a tradução actualizada é
            DEADLINE.

           Se a string especificada começar com um '+', será interpretada por:
            LC_ALL=C date -R -d DEADLINE

           Se não for especificado um prazo (e não for utilizada a opção --nodeadline), será perguntado um prazo
           ao utilizador, propondo um prazo pré-definido de +10days.

           Esta  opção  pode  ser  especificada  no  ficheiro  de  configuração  para  definir  o  comportamento
           pré-definido de podebconf-report-po.  Veja, abaixo, a secção CONFIGURATION FILE.

       <--nodeadline
           Desactivar a indicação de prazo aos tradutores, e evitar perguntas de prazos.

           Esta  opção  pode  ser  especificada  no  ficheiro  de  configuração  para  definir  o  comportamento
           pré-definido de podebconf-report-po.  Veja, abaixo, a secção CONFIGURATION FILE.

       --default
           Não abrir o editor e utilizar o template conforme está.

           Esta  opção  pode  ser  especificada  no  ficheiro  de  configuração  para  definir  o  comportamento
           pré-definido de podebconf-report-po.  Veja, abaixo, a secção CONFIGURATION FILE.

       --nodefault
           Abrir um editor antes de enviar o(s) email(s).

       -f, --force
           Enviar email(s) sem confirmação.

           Esta  opção  pode  ser  especificada  no  ficheiro  de  configuração  para  definir  o  comportamento
           pré-definido de podebconf-report-po.  Veja, abaixo, a secção CONFIGURATION FILE.

       --noforce
           Pedir confirmação antes de enviar email(s).

       --from=FROM
           Especifique o nome e o endereço de email do remetente (o valor por omissão é tirado das variáveis  de
           ambiente  DEBEMAIL  e DEBFULLNAME, ou da variável de ambiente EMAIL, ou é definido pelo maintainer do
           pacote se estas variáveis não estiverem definidas).

           Esta  opção  pode  ser  especificada  no  ficheiro  de  configuração  para  definir  o  comportamento
           pré-definido de podebconf-report-po.  Veja, abaixo, a secção CONFIGURATION FILE.

       --gzip
           Comprimir os ficheiros PO em anexo com "gzip".

           Esta  opção  pode  ser  especificada  no  ficheiro  de  configuração  para  definir  o  comportamento
           pré-definido de podebconf-report-po.  Veja, abaixo, a secção CONFIGURATION FILE.

       --nogzip
           Não comprimir os ficheiros PO.

       -h, --help
           Mostrar a informação de utilização e sair.

       --langs=LANGUAGES
           Especificar uma lista de idiomas para restringir o envio da notificação apenas para esses idiomas.  A
           lista de idiomas é separada por vírgulas.  Os ficheiros PO têm de ter o  nome  de  acordo  com  esses
           idiomas, com a extensão .po.

       --languageteam
           Enviar também o email à Equipa do Idioma como CC.

           Está activo por pré-definição.

           Esta  opção  pode  ser  especificada  no  ficheiro  de  configuração  para  definir  o  comportamento
           pré-definido de podebconf-report-po.  Veja, abaixo, a secção CONFIGURATION FILE.

       --nolanguageteam
           Não enviar o(s) email(s) às equipas de idioma.

           Esta  opção  pode  ser  especificada  no  ficheiro  de  configuração  para  definir  o  comportamento
           pré-definido de podebconf-report-po.  Veja, abaixo, a secção CONFIGURATION FILE.

       --mutt
           Enviar os mails com o mutt.  Isto define o argumento --postpone para $HOME/postponed.

       --notdebconf
           Indicar  que  não  é  uma tradução debconf.  podebconf-report-po irá utilizar o modelo translator-po,
           call-po, ou submit-po (se nenhuns outros modelos forem pedidos no  ficheiro  de  configuração  ou  na
           linha  de  comandos).   Estes modelos não mencionam debconf no título ou no corpo do email e são mais
           adequados para traduções não-debconf.

           Esta opção também muda o directório po pré-definido utilizado pelo podebconf-report-po (i.e. a  opção
           --podir  não é necessária quando a chamada for feita a partir do próprio directório po ou a partir do
           seu directório pai).

           Por pré-definição, é preferido um directório debian/po em vez dum directório  po.   Com  esta  opção,
           apenas será considerado o directório po.

           Esta  opção  normalmente  não é necessária. O podebconf-report-po tenta determinar o tipo de tradução
           baseada no directório actual e a existência dum directório debian/po ou po.

       --package=PACKAGE
           Especificar o nome do pacote (o valor pré-definido é o nome do pacote source).

       --podir=DIR
           Especifique onde estão  localizados  os  ficheiros  PO.   Por  pré-definição,  o  podebconf-report-po
           verifica se é chamado a partir de um directório po, ou procura por um directório debian/po (isto pode
           ser desabilitado com a opção --notdebconf), ou por um directório po.

       --postpone=MBOX
           Não  enviar  emails,  acrescentá-los em MBOX.  Este ficheiro pode ser utilizado para ler uma caixa de
           correio adiada com o mutt -p.

       --potfile=POTFILE
           Especifique o ficheiro POT a enviar num pedido de traduções  (--call).   Por  omissão,  o  podebconf-
           report-po utiliza o ficheiro POT do directório dos ficheiros PO se existir apenas um.

           Este  ficheiro  também  é  utilizado  para  procurar  o  nome e versão do pacote, caso não tenha sido
           especificado nenhum com uma opção, e não tiver sido encontrado o ficheiro debian/changelog.

       --sendmessage
           Enviar apenas uma mensagem, sem anexos.  Isto pode ser útil quando os tradutores  tiverem  permissões
           para 'commit' no repositório de pacotes.

       --smtp=SERVER
           Especificar o servidor SMTP para o envio (o valor pré-definido é "localhost").

           Esta  opção  pode  ser  especificada  no  ficheiro  de  configuração  para  definir  o  comportamento
           pré-definido de podebconf-report-po.  Veja, abaixo, a secção CONFIGURATION FILE.

       --submit
           Em vez de enviar mails aos tradutores, lançar um relatório de  bug  contra  este  pacote  para  pedir
           traduções.   Isto é útil e.g. quando se preparam uploads de não-maintainers (NMUs) para ter a certeza
           que as traduções não se perdem.

       --summary
           Enviar um relatório de estado ao maintainer com a lista de emails enviados aos tradutores.

           Esta  opção  pode  ser  especificada  no  ficheiro  de  configuração  para  definir  o  comportamento
           pré-definido de podebconf-report-po.  Veja, abaixo, a secção CONFIGURATION FILE.

       --nosummary
           Não enviar qualquer relatório de estado ao maintainer.

       --utf8
           Enviar  o  email em UTF-8.  Isto permite caracteres não-ascii no corpo e cabeçalho do mail.  O editor
           tem de suportar UTF-8.

           Esta  opção  pode  ser  especificada  no  ficheiro  de  configuração  para  definir  o  comportamento
           pré-definido de podebconf-report-po.  Veja, abaixo, a secção CONFIGURATION FILE.

       --noutf8
           Enviar  o(s)  email(s)  em  us-ascii.   Os  caracteres  não-ascii  são  substituídos  por um ponto de
           interrogação.

       --version
           Mostrar a informação da versão e sair.

       -v, --verbose
           Mostrar informação adicional enquanto está a correr.

           Esta  opção  pode  ser  especificada  no  ficheiro  de  configuração  para  definir  o  comportamento
           pré-definido de podebconf-report-po.  Veja, abaixo, a secção CONFIGURATION FILE.

       --noverbose
           Não utilizar o modo detalhado.

       --templatecall=TEMPLATE
           Especificar  o  ficheiro  a  utilizar  como  template  para  o(s) email(s) da chamada de traduções. O
           template pré-definido é /usr/share/po-debconf/templates/call.

           Esta  opção  pode  ser  especificada  no  ficheiro  de  configuração  para  definir  o  comportamento
           pré-definido de podebconf-report-po.  Veja, abaixo, a secção CONFIGURATION FILE.

       --templatesubmit=TEMPLATE
           Especificar um ficheiro para utilizar como template para o(s) email(s) a enviar aos tradutores quando
           for utilizada a opção --submit.  O template pré-definido é /usr/share/po-debconf/templates/submit.

           Esta  opção  pode  ser  especificada  no  ficheiro  de  configuração  para  definir  o  comportamento
           pré-definido de podebconf-report-po.  Veja, abaixo, a secção CONFIGURATION FILE.

       --templatetranslators=TEMPLATE
           Especificar um ficheiro a utilizar como template para o(s) email(s) a serem enviados aos  tradutores.
           O template pré-definido é /usr/share/po-debconf/templates/translators.

           Esta  opção  pode  ser  especificada  no  ficheiro  de  configuração  para  definir  o  comportamento
           pré-definido de podebconf-report-po.  Veja, abaixo, a secção CONFIGURATION FILE.

       --template=TEMPLATE
           Especifique o ficheiro a utilizar como template para o(s) email(s).  Se for especificado um  template
           com  esta  opção,  este  template  será utilizado em vez de um template especificado com qualquer das
           opções --templatetranslators, --templatesubmit, ou --templatecall.

           Esta  opção  pode  ser  especificada  no  ficheiro  de  configuração  para  definir  o  comportamento
           pré-definido de podebconf-report-po.  Veja, abaixo, a secção CONFIGURATION FILE.

       --notemplate
           Utilizar o template pré-definido.

       --withtranslators
           Enviar aos tradutores pedidos de actualização após ter sido enviado o pedido de traduções.

           Esta opção é ignorada quando não é especificada a opção --call.  Está habilitada por pré-definição.

           Esta  opção  pode  ser  especificada  no  ficheiro  de  configuração  para  definir  o  comportamento
           pré-definido de podebconf-report-po.  Veja, abaixo, a secção CONFIGURATION FILE.

       --withouttranslators
           Não enviar, aos tradutores, pedidos de actualização de traduções após o pedido de traduções.

           Esta  opção  pode  ser  especificada  no  ficheiro  de  configuração  para  definir  o  comportamento
           pré-definido de podebconf-report-po.  Veja, abaixo, a secção CONFIGURATION FILE.

FICHEIRO DE CONFIGURAÇÃO

       Por  omissão,  o podebconf-report-po lê $HOME/.podebconf-report-po.conf.  O ficheiro de configuração pode
       ser definido com a opção --conf. Pode também ignorar qualquer ficheiro de configuração ao  especificar  a
       opção  --noconf.  As  opções  da linha de comandos podem ser utilizadas para ultrapassar as definições do
       ficheiro de configuração.

       Os ficheiros de configuração aceitam a maioria das opções de linha de  comandos,  sem  o  --  no  começo:
       deadline,  nodeadline,  smtp,  from,  verbose,  force, templatetranslators, templatesubmit, templatecall,
       template, default, gzip, languageteam, nolanguageteam, addlanguageteam, summary,  utf8,  withtranslators,
       withtranslators.

       As linhas que comecem por um símbolo cardinal (possivelmente precedidos de espaços) são comentários e são
       ignorados.

       Aqui está um exemplo:
        # Isto é um comentário
        smtp smtp.meudominio
        from = Eu Próprio <eu@meudominio>
        utf8

TEMPLATES

       Os  templates  especificados  com  as  opções  --template,  --templatetranslators,  --templatesubmit,  ou
       --templatecall podem conter as seguintes tags:

       <from>, <subject>, <reply-to>
           Substituído pelos cabeçalhos correspondentes do(s) email(s).

       <filelist>
           No modo pré-definido, é substituído por comentários que mostram a lista de tradutores  com  traduções
           desactualizadas.

           No modo --submit, é substituído pela lista de ficheiros PO com traduções desactualizadas.

           E no modo --call, é substituído pela lista de ficheiros PO encontrados no directório PO.

       <reply>
           Substituído  por  uma  'string'  que  indica como os tradutores têm de responder (e.g. seguido do tag
           Reply-To ou enviar o PO para um dado relatório de bug).

       <deadline>
           Substituído pela mensagem que indica o prazo para a tradução (veja --deadline).

       <package>
           Substituído pelo nome do pacote (se foi detectado).

       <statistics>
           Substituído pelas estatísticas dos ficheiros PO encontrados no directório PO (apenas no modo --call).

       O directório /usr/share/po-debconf/templates contém os templates pré-definidos.

EXEMPLOS

       A utilização recomendada é chamar podebconf-report-po a partir do directório po a ser actualizado:

       podebconf-report-po --call

       Isto irá enviar um pedido de novas traduções para a mailing  list  <debian-i18n@lists.debian.org>  e  irá
       pedir  aos  tradutores  anteriores  actualizações  das  traduções.  As  equipas  de  idiomas também serão
       notificadas e deverão reagir se for conhecido que o tradutor alocado esteja 'MIA' (desaparecido).

       Uma questão irá pedir um prazo ao utilizador (o pré-definido é pedir traduções e actualizações dentro  de
       10 dias).

       Depois  um editor irá mostrar a mensagem a ser enviada para a mailing list.  Quando este editor terminar,
       o podebconf-report-po irá pedir uma confirmação para enviar o email para a mailing list.

       Se for confirmado, outro editor irá mostrar a  mensagem  a  ser  enviada  aos  tradutores  e  equipas  de
       tradução.   O podebconf-report-po irá pedir outra confirmação para enviar emails aos tradutores e equipas
       de tradução.

       Deve fazer um novo lançamento com as traduções recebidas após o prazo.

VEJA TAMBÉM

       debconf-updatepo(1)

AUTOR

         Fabio Tranchitella <kobold@kobold.it>

                                                   2020-12-30                             PODEBCONF-REPORT-PO(1)