1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
|
.. _phase:
phase
*****
phase is a script that allows you to perform a number of tasks on a set of PO
files that have been broken into phases. You can create a ZIP file for a
phase, run checks against a phase, review a phase, edit files in a phase, etc.
All the tasks that would be involved in sending work to various translators,
receiving work, checking it and committing to CVS.
.. _phase#prerequisites:
Prerequisites
=============
* An environment that will run :man:`bash`
* :man:`diff`
* :man:`cvs`
.. _phase#latest_version:
Latest Version
==============
phase is not currently distributed as part of the toolkit. You can get the
`latest version from Git
<https://raw.github.com/translate/translate/master/tools/phase>`_
.. _phase#usage:
Usage
=====
::
phase <command> [options]
Mostly the usage follows the format of::
phase <command> <language-dir> <phaselist> <phase-name>
phase <command> <language-dir> <phase-name>
A full list of commands and options can be seen by running::
phase --help
.. _phase#commands:
Commands
========
These are the commands that you can use:
* makephaselist <new-phase-list-name> -- creates a phase list
* listphases <phase-list> -- lists the different phases that appear in the
phase-list file
* listfiles <phase-list> <phase-name> -- list all files for the given phase in
the phase-list file
* checkphaselist <language-dir> <phase-list> -- checks to see which files are
not included in the phaselist
* countpo <language-dir> <phase-list> <phase-name> -- counts PO file in the
given phase
* countpot <template-dir> <phase-list> <phase-name> -- counts POT file in the
given phase
* missingpo <language-dir> <phase-list> <phase-name> -- lists files that have
not been returned for a phase
* packpot <template-dir> <phase-list> <phase-name> -- packs all POT files for a
given phase into a ZIP file
* packpo <language-dir> <phase-list> <phase-name> -- packs all PO files for a
given phase into a ZIP file
* packall <template-dir> <phase-list> -- packs all phases found in the phase
list
* packallpo <language-dir> <phase-list> -- packs all phases found in the phase
list for the given language
* countmismatch <language-dir> <template-dir> <phase-list> <phase-name> --
compares the source word count between PO and POT to determine if there are
any file errors.
* editpo <language-dir> <phase-list> <phase-name> -- edit the PO files in a
phase
* editpochecks <language> <phase-name> -- edit the PO checks output by checkpo
* editconflicts <language-dir> <phase-list> <phase-name> -- edit the extracted
conflict items
* checkpo <language-dir> <phase-list> <phase-name> [pofilter options] -- run
pofilter checks against the given phase
* mergepo <language> <phase-name> -- merge the checks back into the main
language directory
* conflictpo <language-dir> <phase-list> <phase-name> [poconflict options] --
run poconflict checks against the given phase
* diffpo <language-dir> <phase-list> <phase-name> -- perform a cvs diff for the
phase
* cvslog <language-dir> <phase-list> <phase-name> -- perform a cvs log against
files in the phase
* lastlog <language-dir> <phase-list> <phase-name> -- retrieves the last cvs
log entry for each file in a phase
* cvsadd <languages-dir> <phase-list> <phase-name> -- CVS adds files and
directories that are not already in CVS
* diffpo <language-dir> <phase-list> <phase-name> -- perform a cvs diff for the
phase
* reviewpo <language-dir> <phase-list> <phase-name> [pofilter options] --
extract items marked for review for the given phase
* editreviews <language-dir> <phase-list> <phase-name> -- edit the extracted
review items
* countreviews <language-dir> <phase-list> <phase-name> -- count the number of
strings and words under review
* checkinpo <language-dir> <phase-list> <phase-name> -- cvs checkin the files
in the given phase
* creategsi <language-dir> <en-US.gsi> <target-language> -- creates a BZ2
GSI/SDF file for the language against the en-US GSI file
* reviewsinout <language> <phase-name> -- counts the number of review files
returned vs sent and shows which are missing
* reviewsdiff <language> <phase-name> -- create a diff between what was sent
for review and what was returned
.. _phase#bugs:
Bugs
====
There are probably lots mostly the bug is that the command line options are
pretty inconsistent
|
