ITSTOOL(1)						      General Commands Manual							ITSTOOL(1)

NAME

       itstool - convert between XML and PO using ITS

SYNOPSIS

       itstool [OPTIONS] [XMLFILES]
       itstool -m <MOFILE> [OPTIONS] [XMLFILES]

DESCRIPTION

       itstool	extracts  messages  from  XML files and outputs PO template files, then merges translations from MO files to create translated XML
       files. It determines what to translate and how to chunk it into messages using the W3C Internationalization Tag Set (ITS).

       To extract messages from XML files FILES and output them to OUT.pot:

       itstool -o OUT.pot FILES

       After merging with existing translations or translating strings, generate an MO file with msgfmt(1), then output translated  files  to  the
       directory DIR:

       itstool -m OUT.mo -o DIR FILES

       ITS  definitions  are  loaded  from  the  built-in  rules, rules embedded in the source XML files, files passed with the -i option, and ITS
       attributes in the source XML files. Later definitions take precedence.

OPTIONS

   Extracting
       -o FILE
       --out=FILE
	   output PO template to the file OUT

   Merging
       -m FILE
       --merge=FILE
	   merge from an MO file FILE and output XML files

       -l LANG
       --lang=LANG
	   explicitly set the language code output to XML

       -o FILE
       --out=FILE
	   output XML files in the directory OUT

   Common
       -i ITS
       --its=ITS
	   load the ITS rules in the file ITS (can specify multiple times)

AUTHOR

       Shaun McCance <shaunm@gnome.org>

SEE ALSO

       More documentation for itstool is maintained online. For more information, see:

	      http://itstool.org/documentation/

itstool 1.1.3							     May 2011								ITSTOOL(1)