.\" Automatically generated by Pod::Man 4.10 (Pod::Simple 3.35)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" Set up some character translations and predefined strings.  \*(-- will
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
.\" double quote, and \*(R" will give a right double quote.  \*(C+ will
.\" give a nicer C++.  Capital omega is used to do unbreakable dashes and
.\" therefore won't be available.  \*(C` and \*(C' expand to `' in nroff,
.\" nothing in troff, for use with C<>.
.tr \(*W-
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
.ie n \{\
.    ds -- \(*W-
.    ds PI pi
.    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
.    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
.    ds L" ""
.    ds R" ""
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds -- \|\(em\|
.    ds PI \(*p
.    ds L" ``
.    ds R" ''
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is >0, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{\
.    if \nF \{\
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{\
.            nr % 0
.            nr F 2
.        \}
.    \}
.\}
.rr rF
.\" ========================================================================
.\"
.IX Title "PODEBCONF-REPORT-PO 1"
.TH PODEBCONF-REPORT-PO 1 "2018-11-20" "" "po-debconf"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH "NAME"
podebconf\-report\-po \- send outdated debconf PO files to the last translators
.SH "SYNOPSIS"
.IX Header "SYNOPSIS"
\&\fBpodebconf-report-po\fR [\fB\f(BIoptions\fB\fR]
.SH "DESCRIPTION"
.IX Header "DESCRIPTION"
This program reads a directory with po files to determine which files
contain fuzzy or missing translations, launches an editor to allow
modifications of mail body and headers, asks confirmation to send mails,
and sends them to the last translator requesting updates.  The mail will
contain the \s-1PO\s0 file which has to be updated.  \fBpodebconf-report-po\fR can
be called either in the top-level directory, or in \fIdebian\fR or
\&\fIdebian/po\fR subdirectories (or, for non debconf translations, from the
\&\fBpo\fR directory itself or its parent directory).
.PP
\&\fBpodebconf-report-po\fR can also be used to send a call for translations to a
mailing list.  In that case, the \s-1POT\s0 file will be attached.
.PP
Different templates exist for translation update requests, request to send
updated \s-1PO\s0 files to a bug report (\fB\-\-submit\fR) or for calls for
translations (\fB\-\-call\fR).
The template can also be provided by the user.
See the \fB\s-1TEMPLATES\s0\fR section for more information on the templates.
.SH "OPTIONS"
.IX Header "OPTIONS"
Many options can be set in a configuration file.
See section \fB\s-1CONFIGURATION FILE\s0\fR.
.IP "\fB\-\-addlanguageteam=\f(BI\s-1LANGUAGE\s0\fB:\f(BI\s-1LIST\s0\fB\fR" 4
.IX Item "--addlanguageteam=LANGUAGE:LIST"
Specify a mailing list for a given language.  This mailing list will be
added to the \s-1CC\s0 list for the \s-1PO\s0 files of this language when
\&\fB\-\-languageteam\fR is used, in addition to the language team specified in
the \s-1PO\s0 file (if these mailing lists differ).
.Sp
This is useful to keep the specified team informed, and allow a faster
reaction when a translator is known to be inactive.
.Sp
This option can be specified more than once.  The language code and
language mailing list are separated by a colon.
.Sp
This option can be specified in the configuration file to define default
behavior of \fBpodebconf-report-po\fR.  See section \fB\s-1CONFIGURATION FILE\s0\fR
below.
.IP "\fB\-\-bts=\f(BI\s-1NUMBER\s0\fB\fR" 4
.IX Item "--bts=NUMBER"
After a bug report has been filed (either manually or with the \fB\-\-submit\fR
flag) to track down translations, \fBpodebconf-report-po\fR can be run
again, but this time with the \fB\-\-bts=\f(BI\s-1NUMBER\s0\fB\fR flag.  Translators are
then requested to respect the \fBReply-To:\fR header field which is set to
this bug report, so that all translations are gathered into a single
location.
.IP "\fB\-\-call[=\f(BI\s-1MAILING_LIST\s0\fB]\fR" 4
.IX Item "--call[=MAILING_LIST]"
Send a call for translations.  If the optional \fI\s-1MAILING_LIST\s0\fR argument is
not specified, the call for translations is sent to the Debian
Internationalization list (\fIdebian\-i18n@lists.debian.org\fR).
.Sp
Calls for translations are useful to receive translations in new
languages.
.Sp
By default, calls for translation are combined with regular requests for
updates sent to translators, for the existing translations.  You can
disable this default behavior with the \fB\-\-withouttranslators\fR option.
.IP "\fB\-\-conf=\f(BI\s-1FILE\s0\fB\fR" 4
.IX Item "--conf=FILE"
Specify the configuration file.
By default, \fBpodebconf-report-po\fR reads
\&\fI\f(CI$HOME\fI/.podebconf\-report\-po.conf\fR.
.IP "\fB\-\-noconf\fR" 4
.IX Item "--noconf"
Do not read any configuration file.
.IP "\fB\-\-deadline=\f(BI\s-1DEADLINE\s0\fB\fR" 4
.IX Item "--deadline=DEADLINE"
Specify the deadline for receiving the updated translations (default is
no deadline).
.Sp
This should be a date, which will be prefixed by:
 The deadline for receiving the updated translation is
 \fI\s-1DEADLINE\s0\fR.
.Sp
If the specified string starts with a '+', it will be interpreted by:
 LC_ALL=C date \-R \-d \fI\s-1DEADLINE\s0\fR
.Sp
If no deadline is specified (and the \fB\-\-nodeadline\fR option is not used),
a deadline will be prompted to the user, proposing a default deadline set
to +10days.
.Sp
This option can be specified in the configuration file to define default
behavior of \fBpodebconf-report-po\fR.  See section \fB\s-1CONFIGURATION FILE\s0\fR
below.
.IP "\fB\-\-nodeadline\fR" 4
.IX Item "--nodeadline"
Deactivate the deadline indication to translators, and avoid the deadline
prompts.
.Sp
This option can be specified in the configuration file to define default
behavior of \fBpodebconf-report-po\fR.  See section \fB\s-1CONFIGURATION FILE\s0\fR
below.
.IP "\fB\-\-default\fR" 4
.IX Item "--default"
Do not open the editor and use the template as is.
.Sp
This option can be specified in the configuration file to define default
behavior of \fBpodebconf-report-po\fR.  See section \fB\s-1CONFIGURATION FILE\s0\fR
below.
.IP "\fB\-\-nodefault\fR" 4
.IX Item "--nodefault"
Open an editor before sending the email(s).
.IP "\fB\-f\fR, \fB\-\-force\fR" 4
.IX Item "-f, --force"
Send the email(s) without confirmation.
.Sp
This option can be specified in the configuration file to define default
behavior of \fBpodebconf-report-po\fR.  See section \fB\s-1CONFIGURATION FILE\s0\fR
below.
.IP "\fB\-\-noforce\fR" 4
.IX Item "--noforce"
Ask for confirmation before sending email(s).
.IP "\fB\-\-from=\f(BI\s-1FROM\s0\fB\fR" 4
.IX Item "--from=FROM"
Specify the name and the email address of the sender (default is taken
from the \fB\s-1DEBEMAIL\s0\fR and \fB\s-1DEBFULLNAME\s0\fR environment variables, or from the
\&\fB\s-1EMAIL\s0\fR environment variable, or is set to the package maintainer if
these variables are not set).
.Sp
This option can be specified in the configuration file to define default
behavior of \fBpodebconf-report-po\fR.  See section \fB\s-1CONFIGURATION FILE\s0\fR
below.
.IP "\fB\-\-gzip\fR" 4
.IX Item "--gzip"
Compress \s-1PO\s0 files in attachment with \f(CW\*(C`gzip\*(C'\fR.
.Sp
This option can be specified in the configuration file to define default
behavior of \fBpodebconf-report-po\fR.  See section \fB\s-1CONFIGURATION FILE\s0\fR
below.
.IP "\fB\-\-nogzip\fR" 4
.IX Item "--nogzip"
Do not compress \s-1PO\s0 files.
.IP "\fB\-h\fR, \fB\-\-help\fR" 4
.IX Item "-h, --help"
Print usage information and exit.
.IP "\fB\-\-langs=\f(BI\s-1LANGUAGES\s0\fB\fR" 4
.IX Item "--langs=LANGUAGES"
Specify a list of languages to restrict sending the notification only for
these languages.
The list of languages is comma separated. The \s-1PO\s0 files must be named
according to these languages, with the .po extension.
.IP "\fB\-\-languageteam\fR" 4
.IX Item "--languageteam"
Send the email also to the Language Team as carbon copy.
.Sp
It is enabled by default.
.Sp
This option can be specified in the configuration file to define default
behavior of \fBpodebconf-report-po\fR.  See section \fB\s-1CONFIGURATION FILE\s0\fR
below.
.IP "\fB\-\-nolanguageteam\fR" 4
.IX Item "--nolanguageteam"
Do not send the email(s) to the language teams.
.Sp
This option can be specified in the configuration file to define default
behavior of \fBpodebconf-report-po\fR.  See section \fB\s-1CONFIGURATION FILE\s0\fR
below.
.IP "\fB\-\-mutt\fR" 4
.IX Item "--mutt"
Send the mails with mutt.
This set the \fB\-\-postpone\fR argument to \fI\f(CI$HOME\fI/postponed\fR.
.IP "\fB\-\-notdebconf\fR" 4
.IX Item "--notdebconf"
Indicate that it is not a debconf translation.
\&\fBpodebconf-report-po\fR will use the \fItranslator-po\fR, \fIcall-po\fR, or
\&\fIsubmit-po\fR template (if no other templates are requested in the
configuration file or in the command line).
These templates do not mention debconf in the subject or mail body and are
more suitable for non-debconf translations.
.Sp
This option also changes the default \fIpo\fR directory used by
\&\fBpodebconf-report-po\fR (i.e. the \fB\-\-podir\fR option is not needed when the
call is done from the \fIpo\fR directory itself or from its parent directory).
.Sp
By default, a \fIdebian/po\fR directory is preferred over a \fIpo\fR directory.
With this option, only the \fIpo\fR directory will be considered.
.Sp
This option is usually not necessary. \fBpodebconf-report-po\fR tries to
determine the type of translation based on the current directory and the
existence of a \fIdebian/po\fR or \fIpo\fR directory.
.IP "\fB\-\-package=\f(BI\s-1PACKAGE\s0\fB\fR" 4
.IX Item "--package=PACKAGE"
Specify the name of the package (default is the source package name).
.IP "\fB\-\-podir=\f(BI\s-1DIR\s0\fB\fR" 4
.IX Item "--podir=DIR"
Specify where the \s-1PO\s0 files are located.
By default, \fBpodebconf-report-po\fR checks if it is called from a \fIpo\fR
directory, or it searches for a \fIdebian/po\fR directory (this can be disabled
with the \fB\-\-notdebconf\fR option), or for a \fIpo\fR directory.
.IP "\fB\-\-postpone=\f(BI\s-1MBOX\s0\fB\fR" 4
.IX Item "--postpone=MBOX"
Do not send emails, append them in \fI\s-1MBOX\s0\fR.
This file can be used as a postponed mailbox with \fBmutt \-p\fR.
.IP "\fB\-\-potfile=\f(BI\s-1POTFILE\s0\fB\fR" 4
.IX Item "--potfile=POTFILE"
Specify the \s-1POT\s0 file to send to a call for translations (\fB\-\-call\fR).
By default, \fBpodebconf-report-po\fR uses the \s-1POT\s0 file of the \s-1PO\s0 files
directory, if there is only one.
.Sp
This file is also used to find the package's name and version, if none
were specified with an option, and if no \fIdebian/changelog\fR files were
found.
.IP "\fB\-\-sendmessage\fR" 4
.IX Item "--sendmessage"
Only send a message, with no attachments.
This can be useful when the translators have a commit access to the
package repository.
.IP "\fB\-\-smtp=\f(BI\s-1SERVER\s0\fB\fR" 4
.IX Item "--smtp=SERVER"
Specify \s-1SMTP\s0 server for mailing (default is \f(CW\*(C`localhost\*(C'\fR).
.Sp
This option can be specified in the configuration file to define default
behavior of \fBpodebconf-report-po\fR.  See section \fB\s-1CONFIGURATION FILE\s0\fR
below.
.IP "\fB\-\-submit\fR" 4
.IX Item "--submit"
Instead of sending mails to translators, file a bug report against this
package to request for translations.  This is useful e.g. when preparing
non-maintainer uploads to make sure that translations do not get lost.
.IP "\fB\-\-summary\fR" 4
.IX Item "--summary"
Send a status report to the maintainer with the list of emails sent to
translators.
.Sp
This option can be specified in the configuration file to define default
behavior of \fBpodebconf-report-po\fR.  See section \fB\s-1CONFIGURATION FILE\s0\fR
below.
.IP "\fB\-\-nosummary\fR" 4
.IX Item "--nosummary"
Do not send any status report to the maintainer.
.IP "\fB\-\-utf8\fR" 4
.IX Item "--utf8"
Send the email in \s-1UTF\-8.\s0  This allow non-ascii characters in the mail body
and mail header.  The editor must support \s-1UTF\-8.\s0
.Sp
This option can be specified in the configuration file to define default
behavior of \fBpodebconf-report-po\fR.  See section \fB\s-1CONFIGURATION FILE\s0\fR
below.
.IP "\fB\-\-noutf8\fR" 4
.IX Item "--noutf8"
Send the email(s) in us-ascii.  Non-ascii characters are replaced by a
question mark.
.IP "\fB\-\-version\fR" 4
.IX Item "--version"
Print version information and exit.
.IP "\fB\-v\fR, \fB\-\-verbose\fR" 4
.IX Item "-v, --verbose"
Display additional information while running.
.Sp
This option can be specified in the configuration file to define default
behavior of \fBpodebconf-report-po\fR.  See section \fB\s-1CONFIGURATION FILE\s0\fR
below.
.IP "\fB\-\-noverbose\fR" 4
.IX Item "--noverbose"
Do not use the verbose mode.
.IP "\fB\-\-templatecall=\f(BI\s-1TEMPLATE\s0\fB\fR" 4
.IX Item "--templatecall=TEMPLATE"
Specify a file to use as a template for the call for translations email(s).
The default template is \fI/usr/share/po\-debconf/templates/call\fR.
.Sp
This option can be specified in the configuration file to define default
behavior of \fBpodebconf-report-po\fR.  See section \fB\s-1CONFIGURATION FILE\s0\fR
below.
.IP "\fB\-\-templatesubmit=\f(BI\s-1TEMPLATE\s0\fB\fR" 4
.IX Item "--templatesubmit=TEMPLATE"
Specify a file to use as a template for the email(s) sent to translators
when the \fB\-\-submit\fR option is used.
The default template is \fI/usr/share/po\-debconf/templates/submit\fR.
.Sp
This option can be specified in the configuration file to define default
behavior of \fBpodebconf-report-po\fR.  See section \fB\s-1CONFIGURATION FILE\s0\fR
below.
.IP "\fB\-\-templatetranslators=\f(BI\s-1TEMPLATE\s0\fB\fR" 4
.IX Item "--templatetranslators=TEMPLATE"
Specify a file to use as a template for the email(s) sent to translators.
The default template is \fI/usr/share/po\-debconf/templates/translators\fR.
.Sp
This option can be specified in the configuration file to define default
behavior of \fBpodebconf-report-po\fR.  See section \fB\s-1CONFIGURATION FILE\s0\fR
below.
.IP "\fB\-\-template=\f(BI\s-1TEMPLATE\s0\fB\fR" 4
.IX Item "--template=TEMPLATE"
Specify file to use it as template for the email(s).
If a template is specified with this option, this template will be used
rather than a template specified with any of the \fB\-\-templatetranslators\fR,
\&\fB\-\-templatesubmit\fR, or \fB\-\-templatecall\fR options.
.Sp
This option can be specified in the configuration file to define default
behavior of \fBpodebconf-report-po\fR.  See section \fB\s-1CONFIGURATION FILE\s0\fR
below.
.IP "\fB\-\-notemplate\fR" 4
.IX Item "--notemplate"
Use the default template.
.IP "\fB\-\-withtranslators\fR" 4
.IX Item "--withtranslators"
Send requests for updates to the translators after sending the call for
translation.
.Sp
This option is ignored when the \fB\-\-call\fR option is not specified.
It is enabled by default.
.Sp
This option can be specified in the configuration file to define default
behavior of \fBpodebconf-report-po\fR.  See section \fB\s-1CONFIGURATION FILE\s0\fR
below.
.IP "\fB\-\-withouttranslators\fR" 4
.IX Item "--withouttranslators"
Do not send requests for translation update to the translators after a
call for translations.
.Sp
This option can be specified in the configuration file to define default
behavior of \fBpodebconf-report-po\fR.  See section \fB\s-1CONFIGURATION FILE\s0\fR
below.
.SH "CONFIGURATION FILE"
.IX Header "CONFIGURATION FILE"
By default, \fBpodebconf-report-po\fR reads
\&\fI\f(CI$HOME\fI/.podebconf\-report\-po.conf\fR.
The configuration file can be set with the \fB\-\-conf\fR option.
You can also ignore any configuration file by specifying the \fB\-\-noconf\fR
option.
Command line options can be used to override configuration file settings.
.PP
The configuration files accept most of the command line options, without
the leading \fB\-\-\fR:
\&\fBdeadline\fR,
\&\fBnodeadline\fR,
\&\fBsmtp\fR,
\&\fBfrom\fR,
\&\fBverbose\fR,
\&\fBforce\fR,
\&\fBtemplatetranslators\fR,
\&\fBtemplatesubmit\fR,
\&\fBtemplatecall\fR,
\&\fBtemplate\fR,
\&\fBdefault\fR,
\&\fBgzip\fR,
\&\fBlanguageteam\fR,
\&\fBnolanguageteam\fR,
\&\fBaddlanguageteam\fR,
\&\fBsummary\fR,
\&\fButf8\fR,
\&\fBwithouttranslators\fR,
\&\fBwithtranslators\fR.
.PP
Lines starting by a number sign (possibly preceded by spaces) are comments
and are ignored.
.PP
Here is an example:
 # This is a comment
 smtp smtp.mydomain
 from = Me Myself <me@mydomain>
 utf8
.SH "TEMPLATES"
.IX Header "TEMPLATES"
The templates specified with the \fB\-\-template\fR, \fB\-\-templatetranslators\fR,
\&\fB\-\-templatesubmit\fR, or \fB\-\-templatecall\fR options can contain the
following tags:
.IP "\fB<from\fR>, \fB<subject\fR>, \fB<reply\-to\fR>" 4
.IX Item "<from>, <subject>, <reply-to>"
Replaced by the corresponding headers of the email(s).
.IP "\fB<filelist\fR>" 4
.IX Item "<filelist>"
In the default mode, it is replaced by comments showing the list of
translators with outdated translations.
.Sp
In the \fB\-\-submit\fR mode, it is replaced by the list of \s-1PO\s0 files with
outdated translations.
.Sp
And in the \fB\-\-call\fR mode, it is replaced by the list of \s-1PO\s0 files found in
the \s-1PO\s0 directory.
.IP "\fB<reply\fR>" 4
.IX Item "<reply>"
Replaced by a string that indicates how the translators have to reply
(e.g. follow the \fIReply-To\fR tag or sending the \s-1PO\s0 to a given bug report).
.IP "\fB<deadline\fR>" 4
.IX Item "<deadline>"
Replaced by a string indicating the deadline for the translation (see
\&\fB\-\-deadline\fR).
.IP "\fB<package\fR>" 4
.IX Item "<package>"
Replaced by the name of the package (if it was detected).
.IP "\fB<statistics\fR>" 4
.IX Item "<statistics>"
Replaced by the statistics of the \s-1PO\s0 files found in the \s-1PO\s0 directory (in the
\&\fB\-\-call\fR mode only).
.PP
The \fI/usr/share/po\-debconf/templates\fR directory contains the default
templates.
.SH "EXAMPLES"
.IX Header "EXAMPLES"
The recommended usage is to call \fBpodebconf-report-po\fR from the \fIpo\fR
directory to be updated:
.PP
podebconf-report-po \-\-call
.PP
This will send a call for new translations to the
<debian\-i18n@lists.debian.org> mailing list and will ask translation
updates to the previous translators. The language teams will also be
notified and should be able to react if the assigned translator is known
to be \s-1MIA.\s0
.PP
A prompt will ask a deadline to the user (the default is to request
translations and updates within 10 days).
.PP
Then an editor will display the message to be sent to the mailing list.
When this editor exits, \fBpodebconf-report-po\fR will ask confirmation
to send the mail to the mailing list.
.PP
If confirmed, another editor will display the message to be sent to the
translators and language teams. 
\&\fBpodebconf-report-po\fR will ask for another confirmation to send the mails
to translators and language teams.
.PP
You should make a new release with the received translations after the
deadline.
.SH "SEE ALSO"
.IX Header "SEE ALSO"
\&\fBdebconf\-updatepo\fR\|(1)
.SH "AUTHOR"
.IX Header "AUTHOR"
.Vb 1
\&  Fabio Tranchitella <kobold@kobold.it>
.Ve
