PageRenderTime 2819ms CodeModel.GetById 24ms RepoModel.GetById 1ms app.codeStats 0ms

/html/en/podebconf-report-po.html

https://gitlab.com/chch/manpages
HTML | 423 lines | 316 code | 107 blank | 0 comment | 0 complexity | 6f1e81be2edc662a69332a5d5582f64d MD5 | raw file
    

  1. <html>
    2. 

  2. <head><meta charset=utf-8/>
    3. 

  3. <title>podebconf-report-po - send outdated debconf PO files to the last translators</title></head>
    4. 

  4. <body><pre>
    5. 

  5. 

  6. PODEBCONF-REPORT-PO(1)             po-debconf             PODEBCONF-REPORT-PO(1)
    7. 

  7. 

  8. 

  9. 

  10. NAME
    11. 

  11.        podebconf-report-po - send outdated debconf PO files to the last
    12. 

  12.        translators
    13. 

  13. 

  14. SYNOPSIS
    15. 

  15.        podebconf-report-po [options]
    16. 

  16. 

  17. DESCRIPTION
    18. 

  18.        This program reads a directory with po files to determine which files
    19. 

  19.        contain fuzzy or missing translations, launches an editor to allow
    20. 

  20.        modifications of mail body and headers, asks confirmation to send mails,
    21. 

  21.        and sends them to the last translator requesting updates.  The mail will
    22. 

  22.        contain the PO file which has to be updated.  podebconf-report-po can be
    23. 

  23.        called either in the top-level directory, or in debian or debian/po
    24. 

  24.        subdirectories (or, for non debconf translations, from the po directory
    25. 

  25.        itself or its parent directory).
    26. 

  26. 

  27.        podebconf-report-po can also be used to send a call for translations to a
    28. 

  28.        mailing list.  In that case, the POT file will be attached.
    29. 

  29. 

  30.        Different templates exist for translation update requests, request to
    31. 

  31.        send updated PO files to a bug report (--submit) or for calls for
    32. 

  32.        translations (--call).  The template can also be provided by the user.
    33. 

  33.        See the TEMPLATES section for more information on the templates.
    34. 

  34. 

  35. OPTIONS
    36. 

  36.        Many options can be set in a configuration file.  See section
    37. 

  37.        CONFIGURATION FILE.
    38. 

  38. 

  39.        --addlanguageteam=LANGUAGE:LIST
    40. 

  40.            Specify a mailing list for a given language.  This mailing list will
    41. 

  41.            be added to the CC list for the PO files of this language when
    42. 

  42.            --languageteam is used, in addition to the language team specified in
    43. 

  43.            the PO file (if these mailing lists differ).
    44. 

  44. 

  45.            This is useful to keep the specified team informed, and allow a
    46. 

  46.            faster reaction when a translator is known to be inactive.
    47. 

  47. 

  48.            This option can be specified more than once.  The language code and
    49. 

  49.            language mailing list are separated by a colon.
    50. 

  50. 

  51.            This option can be specified in the configuration file to define
    52. 

  52.            default behavior of podebconf-report-po.  See section CONFIGURATION
    53. 

  53.            FILE below.
    54. 

  54. 

  55.        --bts=NUMBER
    56. 

  56.            After a bug report has been filed (either manually or with the
    57. 

  57.            --submit flag) to track down translations, podebconf-report-po can be
    58. 

  58.            run again, but this time with the --bts=NUMBER flag.  Translators are
    59. 

  59.            then requested to respect the Reply-To: header field which is set to
    60. 

  60.            this bug report, so that all translations are gathered into a single
    61. 

  61.            location.
    62. 

  62. 

  63.        --call[=MAILING_LIST]
    64. 

  64.            Send a call for translations.  If the optional MAILING_LIST argument
    65. 

  65.            is not specified, the call for translations is sent to the Debian
    66. 

  66.            Internationalization list (debian-i18n@lists.debian.org).
    67. 

  67. 

  68.            Calls for translations are useful to receive translations in new
    69. 

  69.            languages.
    70. 

  70. 

  71.            By default, calls for translation are combined with regular requests
    72. 

  72.            for updates sent to translators, for the existing translations.  You
    73. 

  73.            can disable this default behavior with the --withouttranslators
    74. 

  74.            option.
    75. 

  75. 

  76.        --conf=FILE
    77. 

  77.            Specify the configuration file.  By default, podebconf-report-po
    78. 

  78.            reads $HOME/.podebconf-report-po.conf.
    79. 

  79. 

  80.        --noconf
    81. 

  81.            Do not read any configuration file.
    82. 

  82. 

  83.        --deadline=DEADLINE
    84. 

  84.            Specify the deadline for receiving the updated translations (default
    85. 

  85.            is no deadline).
    86. 

  86. 

  87.            This should be a date, which will be prefixed by:
    88. 

  88.             The deadline for receiving the updated translation is
    89. 

  89.             DEADLINE.
    90. 

  90. 

  91.            If the specified string starts with a &apos;+&apos;, it will be interpreted by:
    92. 

  92.             LC_ALL=C date -R -d DEADLINE
    93. 

  93. 

  94.            If no deadline is specified (and the --nodeadline option is not
    95. 

  95.            used), a deadline will be prompted to the user, proposing a default
    96. 

  96.            deadline set to +10days.
    97. 

  97. 

  98.            This option can be specified in the configuration file to define
    99. 

  99.            default behavior of podebconf-report-po.  See section CONFIGURATION
    100. 

  100.            FILE below.
    101. 

  101. 

  102.        --nodeadline
    103. 

  103.            Deactivate the deadline indication to translators, and avoid the
    104. 

  104.            deadline prompts.
    105. 

  105. 

  106.            This option can be specified in the configuration file to define
    107. 

  107.            default behavior of podebconf-report-po.  See section CONFIGURATION
    108. 

  108.            FILE below.
    109. 

  109. 

  110.        --default
    111. 

  111.            Do not open the editor and use the template as is.
    112. 

  112. 

  113.            This option can be specified in the configuration file to define
    114. 

  114.            default behavior of podebconf-report-po.  See section CONFIGURATION
    115. 

  115.            FILE below.
    116. 

  116. 

  117.        --nodefault
    118. 

  118.            Open an editor before sending the email(s).
    119. 

  119. 

  120.        -f, --force
    121. 

  121.            Send the email(s) without confirmation.
    122. 

  122. 

  123.            This option can be specified in the configuration file to define
    124. 

  124.            default behavior of podebconf-report-po.  See section CONFIGURATION
    125. 

  125.            FILE below.
    126. 

  126. 

  127.        --noforce
    128. 

  128.            Ask for confirmation before sending email(s).
    129. 

  129. 

  130.        --from=FROM
    131. 

  131.            Specify the name and the email address of the sender (default is
    132. 

  132.            taken from the DEBEMAIL and DEBFULLNAME environment variables, or
    133. 

  133.            from the EMAIL environment variable, or is set to the package
    134. 

  134.            maintainer if these variables are not set).
    135. 

  135. 

  136.            This option can be specified in the configuration file to define
    137. 

  137.            default behavior of podebconf-report-po.  See section CONFIGURATION
    138. 

  138.            FILE below.
    139. 

  139. 

  140.        --gzip
    141. 

  141.            Compress PO files in attachment with &quot;gzip&quot;.
    142. 

  142. 

  143.            This option can be specified in the configuration file to define
    144. 

  144.            default behavior of podebconf-report-po.  See section CONFIGURATION
    145. 

  145.            FILE below.
    146. 

  146. 

  147.        --nogzip
    148. 

  148.            Do not compress PO files.
    149. 

  149. 

  150.        -h, --help
    151. 

  151.            Print usage information and exit.
    152. 

  152. 

  153.        --langs=LANGUAGES
    154. 

  154.            Specify a list of languages to restrict sending the notification only
    155. 

  155.            for these languages.  The list of languages is comma separated. The
    156. 

  156.            PO files must be named according to these languages, with the .po
    157. 

  157.            extension.
    158. 

  158. 

  159.        --languageteam
    160. 

  160.            Send the email also to the Language Team as carbon copy.
    161. 

  161. 

  162.            It is enabled by default.
    163. 

  163. 

  164.            This option can be specified in the configuration file to define
    165. 

  165.            default behavior of podebconf-report-po.  See section CONFIGURATION
    166. 

  166.            FILE below.
    167. 

  167. 

  168.        --nolanguageteam
    169. 

  169.            Do not send the email(s) to the language teams.
    170. 

  170. 

  171.            This option can be specified in the configuration file to define
    172. 

  172.            default behavior of podebconf-report-po.  See section CONFIGURATION
    173. 

  173.            FILE below.
    174. 

  174. 

  175.        --mutt
    176. 

  176.            Send the mails with mutt.  This set the --postpone argument to
    177. 

  177.            $HOME/postponed.
    178. 

  178. 

  179.        --notdebconf
    180. 

  180.            Indicate that it is not a debconf translation.  podebconf-report-po
    181. 

  181.            will use the translator-po, call-po, or submit-po template (if no
    182. 

  182.            other templates are requested in the configuration file or in the
    183. 

  183.            command line).  These templates do not mention debconf in the subject
    184. 

  184.            or mail body and are more suitable for non-debconf translations.
    185. 

  185. 

  186.            This option also changes the default po directory used by podebconf-
    187. 

  187.            report-po (i.e. the --podir option is not needed when the call is
    188. 

  188.            done from the po directory itself or from its parent directory).
    189. 

  189. 

  190.            By default, a debian/po directory is preferred over a po directory.
    191. 

  191.            With this option, only the po directory will be considered.
    192. 

  192. 

  193.            This option is usually not necessary. podebconf-report-po tries to
    194. 

  194.            determine the type of translation based on the current directory and
    195. 

  195.            the existence of a debian/po or po directory.
    196. 

  196. 

  197.        --package=PACKAGE
    198. 

  198.            Specify the name of the package (default is the source package name).
    199. 

  199. 

  200.        --podir=DIR
    201. 

  201.            Specify where the PO files are located.  By default, podebconf-
    202. 

  202.            report-po checks if it is called from a po directory, or it searches
    203. 

  203.            for a debian/po directory (this can be disabled with the --notdebconf
    204. 

  204.            option), or for a po directory.
    205. 

  205. 

  206.        --postpone=MBOX
    207. 

  207.            Do not send emails, append them in MBOX.  This file can be used as a
    208. 

  208.            postponed mailbox with mutt -p.
    209. 

  209. 

  210.        --potfile=POTFILE
    211. 

  211.            Specify the POT file to send to a call for translations (--call).  By
    212. 

  212.            default, podebconf-report-po uses the POT file of the PO files
    213. 

  213.            directory, if there is only one.
    214. 

  214. 

  215.            This file is also used to find the package&apos;s name and version, if
    216. 

  216.            none were specified with an option, and if no debian/changelog files
    217. 

  217.            were found.
    218. 

  218. 

  219.        --sendmessage
    220. 

  220.            Only send a message, with no attachments.  This can be useful when
    221. 

  221.            the translators have a commit access to the package repository.
    222. 

  222. 

  223.        --smtp=SERVER
    224. 

  224.            Specify SMTP server for mailing (default is &quot;localhost&quot;).
    225. 

  225. 

  226.            This option can be specified in the configuration file to define
    227. 

  227.            default behavior of podebconf-report-po.  See section CONFIGURATION
    228. 

  228.            FILE below.
    229. 

  229. 

  230.        --submit
    231. 

  231.            Instead of sending mails to translators, file a bug report against
    232. 

  232.            this package to request for translations.  This is useful e.g. when
    233. 

  233.            preparing non-maintainer uploads to make sure that translations do
    234. 

  234.            not get lost.
    235. 

  235. 

  236.        --summary
    237. 

  237.            Send a status report to the maintainer with the list of emails sent
    238. 

  238.            to translators.
    239. 

  239. 

  240.            This option can be specified in the configuration file to define
    241. 

  241.            default behavior of podebconf-report-po.  See section CONFIGURATION
    242. 

  242.            FILE below.
    243. 

  243. 

  244.        --nosummary
    245. 

  245.            Do not send any status report to the maintainer.
    246. 

  246. 

  247.        --utf8
    248. 

  248.            Send the email in UTF-8.  This allow non-ascii characters in the mail
    249. 

  249.            body and mail header.  The editor must support UTF-8.
    250. 

  250. 

  251.            This option can be specified in the configuration file to define
    252. 

  252.            default behavior of podebconf-report-po.  See section CONFIGURATION
    253. 

  253.            FILE below.
    254. 

  254. 

  255.        --noutf8
    256. 

  256.            Send the email(s) in us-ascii.  Non-ascii characters are replaced by
    257. 

  257.            a question mark.
    258. 

  258. 

  259.        --version
    260. 

  260.            Print version information and exit.
    261. 

  261. 

  262.        -v, --verbose
    263. 

  263.            Display additional information while running.
    264. 

  264. 

  265.            This option can be specified in the configuration file to define
    266. 

  266.            default behavior of podebconf-report-po.  See section CONFIGURATION
    267. 

  267.            FILE below.
    268. 

  268. 

  269.        --noverbose
    270. 

  270.            Do not use the verbose mode.
    271. 

  271. &#12;       --templatecall=TEMPLATE
    272. 

  272.            Specify a file to use as a template for the call for translations
    273. 

  273.            email(s).  The default template is
    274. 

  274.            /usr/share/po-debconf/templates/call.
    275. 

  275. 

  276.            This option can be specified in the configuration file to define
    277. 

  277.            default behavior of podebconf-report-po.  See section CONFIGURATION
    278. 

  278.            FILE below.
    279. 

  279. 

  280.        --templatesubmit=TEMPLATE
    281. 

  281.            Specify a file to use as a template for the email(s) sent to
    282. 

  282.            translators when the --submit option is used.  The default template
    283. 

  283.            is /usr/share/po-debconf/templates/submit.
    284. 

  284. 

  285.            This option can be specified in the configuration file to define
    286. 

  286.            default behavior of podebconf-report-po.  See section CONFIGURATION
    287. 

  287.            FILE below.
    288. 

  288. 

  289.        --templatetranslators=TEMPLATE
    290. 

  290.            Specify a file to use as a template for the email(s) sent to
    291. 

  291.            translators.  The default template is
    292. 

  292.            /usr/share/po-debconf/templates/translators.
    293. 

  293. 

  294.            This option can be specified in the configuration file to define
    295. 

  295.            default behavior of podebconf-report-po.  See section CONFIGURATION
    296. 

  296.            FILE below.
    297. 

  297. 

  298.        --template=TEMPLATE
    299. 

  299.            Specify file to use it as template for the email(s).  If a template
    300. 

  300.            is specified with this option, this template will be used rather than
    301. 

  301.            a template specified with any of the --templatetranslators,
    302. 

  302.            --templatesubmit, or --templatecall options.
    303. 

  303. 

  304.            This option can be specified in the configuration file to define
    305. 

  305.            default behavior of podebconf-report-po.  See section CONFIGURATION
    306. 

  306.            FILE below.
    307. 

  307. 

  308.        --notemplate
    309. 

  309.            Use the default template.
    310. 

  310. 

  311.        --withtranslators
    312. 

  312.            Send requests for updates to the translators after sending the call
    313. 

  313.            for translation.
    314. 

  314. 

  315.            This option is ignored when the --call option is not specified.  It
    316. 

  316.            is enabled by default.
    317. 

  317. 

  318.            This option can be specified in the configuration file to define
    319. 

  319.            default behavior of podebconf-report-po.  See section CONFIGURATION
    320. 

  320.            FILE below.
    321. 

  321. 

  322.        --withouttranslators
    323. 

  323.            Do not send requests for translation update to the translators after
    324. 

  324.            a call for translations.
    325. 

  325. 

  326.            This option can be specified in the configuration file to define
    327. 

  327.            default behavior of podebconf-report-po.  See section CONFIGURATION
    328. 

  328.            FILE below.
    329. 

  329. 

  330. CONFIGURATION FILE
    331. 

  331.        By default, podebconf-report-po reads $HOME/.podebconf-report-po.conf.
    332. 

  332.        The configuration file can be set with the --conf option.  You can also
    333. 

  333.        ignore any configuration file by specifying the --noconf option.  Command
    334. 

  334.        line options can be used to override configuration file settings.
    335. 

  335. 

  336.        The configuration files accept most of the command line options, without
    337. 

  337.        the leading --: deadline, nodeadline, smtp, from, verbose, force,
    338. 

  338.        templatetranslators, templatesubmit, templatecall, template, default,
    339. 

  339.        gzip, languageteam, nolanguageteam, addlanguageteam, summary, utf8,
    340. 

  340.        withouttranslators, withtranslators.
    341. 

  341. 

  342.        Lines starting by a number sign (possibly preceded by spaces) are
    343. 

  343.        comments and are ignored.
    344. 

  344. 

  345.        Here is an example:
    346. 

  346.         # This is a comment
    347. 

  347.         smtp smtp.mydomain
    348. 

  348.         from = Me Myself &lt;me@mydomain&gt;
    349. 

  349.         utf8
    350. 

  350. 

  351. TEMPLATES
    352. 

  352.        The templates specified with the --template, --templatetranslators,
    353. 

  353.        --templatesubmit, or --templatecall options can contain the following
    354. 

  354.        tags:
    355. 

  355. 

  356.        &lt;from&gt;, &lt;subject&gt;, &lt;reply-to&gt;
    357. 

  357.            Replaced by the corresponding headers of the email(s).
    358. 

  358. 

  359.        &lt;filelist&gt;
    360. 

  360.            In the default mode, it is replaced by comments showing the list of
    361. 

  361.            translators with outdated translations.
    362. 

  362. 

  363.            In the --submit mode, it is replaced by the list of PO files with
    364. 

  364.            outdated translations.
    365. 

  365. 

  366.            And in the --call mode, it is replaced by the list of PO files found
    367. 

  367.            in the PO directory.
    368. 

  368. 

  369.        &lt;reply&gt;
    370. 

  370.            Replaced by a string that indicates how the translators have to reply
    371. 

  371.            (e.g. follow the Reply-To tag or sending the PO to a given bug
    372. 

  372.            report).
    373. 

  373. 

  374.        &lt;deadline&gt;
    375. 

  375.            Replaced by a string indicating the deadline for the translation (see
    376. 

  376.            --deadline).
    377. 

  377. 

  378.        &lt;package&gt;
    379. 

  379.            Replaced by the name of the package (if it was detected).
    380. 

  380. 

  381.        &lt;statistics&gt;
    382. 

  382.            Replaced by the statistics of the PO files found in the PO directory
    383. 

  383.            (in the --call mode only).
    384. 

  384. 

  385.        The /usr/share/po-debconf/templates directory contains the default
    386. 

  386.        templates.
    387. 

  387. 

  388. EXAMPLES
    389. 

  389.        The recommended usage is to call podebconf-report-po from the po
    390. 

  390.        directory to be updated:
    391. 

  391. 

  392.        podebconf-report-po --call
    393. 

  393. 

  394.        This will send a call for new translations to the
    395. 

  395.        &lt;debian-i18n@lists.debian.org&gt; mailing list and will ask translation
    396. 

  396.        updates to the previous translators. The language teams will also be
    397. 

  397.        notified and should be able to react if the assigned translator is known
    398. 

  398.        to be MIA.
    399. 

  399. 

  400.        A prompt will ask a deadline to the user (the default is to request
    401. 

  401.        translations and updates within 10 days).
    402. 

  402. 

  403.        Then an editor will display the message to be sent to the mailing list.
    404. 

  404.        When this editor exits, podebconf-report-po will ask confirmation to send
    405. 

  405.        the mail to the mailing list.
    406. 

  406. &#12;       If confirmed, another editor will display the message to be sent to the
    407. 

  407.        translators and language teams.  podebconf-report-po will ask for another
    408. 

  408.        confirmation to send the mails to translators and language teams.
    409. 

  409. 

  410.        You should make a new release with the received translations after the
    411. 

  411.        deadline.
    412. 

  412. 

  413. SEE ALSO
    414. 

  414.        debconf-updatepo(1)
    415. 

  415. 

  416. AUTHOR
    417. 

  417.          Fabio Tranchitella &lt;kobold@kobold.it&gt;
    418. 

  418. 

  419. 

  420. 

  421.                                    2011-12-29             PODEBCONF-REPORT-PO(1)
    422. 

  422. 

  423. </pre></body></html>
    424. 

  424.