DDTC.1(1) | User Contributed Perl Documentation | DDTC.1(1) |
ddtc - ddts client tool to help translators and reviewers.
ddtc [OPTIONS] COMMAND [ARGUMENTS]
This script helps both translators and reviewers with parsing mails from the ddts, splitting them into individual package files, sending reviews and patching buggy translations.
Before sending back the translation or the review to the server, the script performs a few tests on it and does not sent it if one of the following succeeds:
It can also be run in interactive mode if no command is provided. In this case, menus are displayed to prompt the user for commands.
Here is the basic process:
If it finds descriptions to translate, it creates a package.todo file for each of them in your Base_dir/tr directory, diffing it with the preceding you have already translated if it exists.
If it finds descriptions to review, it creates a package.todo file for each of them in your Base_dir/rev directory. If a preceding review exists, it diffs both and write the diff or set the description as reviewed if there is no difference.
If it finds a bug report, it creates a package.bug file in your Base_dir/bug directory, it merges all bug reports to ease corrections. It also tries to detect collisions (see below).
Edit it with your favorite text editor.
Edit it with your favorite text editor. You can add comments that will be sent to the translator by adding lines beginning with `>> ' (your $Comment variable contents followed by a mandatory space character).
If a translation has already been reviewed and has been modified the script show you the differences between both versions. Lines beginning with `>>--' correspond to your last version you reviewed, replace this by `+>--' if you think the translator is still wrong. Lines beginning with `>>++' are the new translator's version, replace this by `+>++' if you agree with the translator. Of course, if you still disagree with the translator, you can add comments as indicated above.
Edit it with your favorite text editor. It contains all changes and comments of the reviewers.
Lines beginning with `>>' are comments and doesn't have to be removed. Lines beginning with `>>X+' are suggested corrections, replace this by `+>X+' if you want to validate it. Lines beginning with `>>--' are your last translation, replace this by `+>--' if you don't want to accept suggested corrections.
Run the script providing the fix command. It creates a new package.tr file in your Base_dir/tr directory containing the unchanged lines and the lines you have selected.
To prevent collisions (reviewers sending review based on a different version than yours), don't send fixed descriptions too often (once a day should be fine), retrieve your mails and parse them just before fixing, send the fixed description as soon as possible afterward.
It sends descriptions from package.tr and package.rev files back to the ddts renaming them into package.sent and closing bugs if necessary.
Available commands:
In each set: sget/get/review/getbug/btsclose/notification, noneveraguide/neveraguide and noguide/guide, only the first found command is used. The script automatically adds language, encoding and mail address (Mail_in) if requested, noguide is default.
Due to server limitation, to avoid risk of deny of service attack, you cannot receive for more than 9 new documents at the same time. The script does not check for this, but the server will.
For sget, get, review, status and listtranslatedpackages you have either to define the $Language variable in you .ddtcrc configuration file, or to provide a language extension via the --lang or -l option.
It removes unnecessary files in ddtc directories but temporary one as this directory should be a system wide temporary directory cleaned via system scheduled threads, but for debugging reason.
It prints figures based on file counts, it may not be accurate if directory cleaning has not been made before.
Verbosity level:
cc mails to one-self:
other:
level 5 and 9 are really verbose, so you should direct the output to a file.
http://ddtp.debian.org/ddtp-text/misc/ddts-faq.txt.
http://ddtp.debian.org/ddtp-text/guides/guide.txt.
http://ddtp.debian.org/ddtp-text/guides/review.txt.
Nicolas Bertolissio <bertol@debian.org>
2022-11-23 | perl v5.36.0 |