B.5.  Core Debian Installer and various levels packages repositories checkout command lines

Typical non anonymous and anonymous checkout command lines for Debian Installer and related packages are listed in Chapter 1, For translators: translating Debian Installer.

Below is an example of a typical checkout for the console-data package:

user@host:~> svn co svn://anonscm.debian.org/console-data/trunk/debian/po console-data

After this the console-data directory contains all files from the package. Updating this directory later needs running the svn update:

user@host:~> cd console-data
user@host:~/console-data> svn up

Subdirectories of a full SVN directory can also be checked out in case one want to work on specific parts. This can be very useful for Debian Installer core translations as Debian Installer SVN repository is very big:

user@host:~> svn co svn+ssh://<alioth_username>@svn.debian.org/svn/d-i/trunk/packages/po debian-installer level1-po
user@host:~> cd level1-po/
user@host:~/level1-po> ls -l
total 19112
-rw-r--r--  1 user user 369598 2005-08-18 02:56 ar.po
-rw-r--r--  1 user user 266462 2005-08-18 02:56 be.po
-rw-r--r--  1 user user   1120 2005-07-17 08:17 PROSPECTIVE
-rw-r--r--  1 user user   2027 2005-07-31 08:54 README
-rw-r--r--  1 user user 353752 2005-08-18 02:56 ro.po
-rw-r--r--  1 user user    324 2005-08-16 16:30 run-l10n-sync
-rw-r--r--  1 user user 237996 2005-08-18 02:56 template.pot
-rw-r--r--  1 user user 350181 2005-08-18 02:56 xh.po
-rw-r--r--  1 user user 335898 2005-08-18 02:56 zh_CN.po
-rw-r--r--  1 user user 335413 2005-08-18 02:56 zh_TW.po

If the translation file already exists, then just update the local copy:

user@host:~/level1-po> lokalize fr.po

(use Lokalize or any other gettext utility, see Appendix E, Gettext files editors and tools for details about gettext files handling, editing and maintenance tools)

Once saved the modified version of the file, the status can be displayed with the svn status command:

user@host:~/level1-po> svn status
M      fr.po

The above means that fr.po includes uncommited modifications. These modifications can be committed by using the svn commit command:

user@host:~/level1-po> svn commit

The user will then be dropped in a file editor (either vi or any other file editor pointed by the EDITOR variable. The changelog message can be then filled in the editor. Saving it and exiting the editor will trigger the commit action to the SVN repository.

A more targeted commit command is also possible, as well as giving the commit message on the command line:

user@host:~/level1-po> svn commit -m"French translation update" fr.po

In general, a few recommendations can be made to translators: