~ubuntu-branches/ubuntu/utopic/gettext/utopic

« back to all changes in this revision

Viewing changes to gettext-tools/doc/xgettext.texi

  • Committer: Colin Watson
  • Date: 2010-08-01 21:36:08 UTC
  • mfrom: (2.1.10 sid)
  • Revision ID: cjwatson@canonical.com-20100801213608-yy7vkm8lpatep3ci
merge from Debian 0.18.1.1-1

Show diffs side-by-side

added added

removed removed

Lines of Context:
116
116
Entries from @var{file} are not extracted.  @var{file} should be a PO or
117
117
POT file.
118
118
 
119
 
@item -c [@var{tag}]
 
119
@item -c[@var{tag}]
120
120
@itemx --add-comments[=@var{tag}]
121
121
@opindex -c@r{, @code{xgettext} option}
122
122
@opindex --add-comments@r{, @code{xgettext} option}
123
 
Place comment block with @var{tag} (or those preceding keyword lines)
124
 
in output file.
 
123
Place comment blocks starting with @var{tag} and preceding keyword lines
 
124
in the output file.  Without a @var{tag}, the option means to put @emph{all}
 
125
comment blocks preceding keyword lines in the output file.
125
126
 
126
127
@end table
127
128
 
138
139
Shell, Python, Lisp, EmacsLisp, librep, Java, C#, awk, Tcl, Perl, PHP,
139
140
GCC-source, Glade.
140
141
 
141
 
@item -k @var{keywordspec}
 
142
@item -k[@var{keywordspec}]
142
143
@itemx --keyword[=@var{keywordspec}]
143
144
@opindex -k@r{, @code{xgettext} option}
144
145
@opindex --keyword@r{, @code{xgettext} option}
145
 
Additional keyword to be looked for (without @var{keywordspec} means not to
146
 
use default keywords).
 
146
Specify @var{keywordspec} as an additional keyword to be looked for.
 
147
Without a @var{keywordspec}, the option means to not use default keywords.
147
148
 
148
149
@cindex adding keywords, @code{xgettext}
149
150
@cindex context, argument specification in @code{xgettext}
350
351
@c --no-escape and --escape omitted on purpose.  They are not useful.
351
352
 
352
353
@table @samp
 
354
@item --color
 
355
@itemx --color=@var{when}
 
356
@opindex --color@r{, @code{xgettext} option}
 
357
Specify whether or when to use colors and other text attributes.
 
358
See @ref{The --color option} for details.
 
359
 
 
360
@item --style=@var{style_file}
 
361
@opindex --style@r{, @code{xgettext} option}
 
362
Specify the CSS style rule file to use for @code{--color}.
 
363
See @ref{The --style option} for details.
 
364
 
353
365
@item --force-po
354
366
@opindex --force-po@r{, @code{xgettext} option}
355
367
Always write an output file even if no message is defined.
484
496
The default value is empty, which means that translators will be clueless!
485
497
Don't forget to specify this option.
486
498
 
487
 
@item -m [@var{string}]
 
499
@item -m[@var{string}]
488
500
@itemx --msgstr-prefix[=@var{string}]
489
501
@opindex -m@r{, @code{xgettext} option}
490
502
@opindex --msgstr-prefix@r{, @code{xgettext} option}
491
 
Use @var{string} (or "" if not specified) as prefix for msgstr entries.
 
503
Use @var{string} (or "" if not specified) as prefix for msgstr values.
492
504
 
493
 
@item -M [@var{string}]
 
505
@item -M[@var{string}]
494
506
@itemx --msgstr-suffix[=@var{string}]
495
507
@opindex -M@r{, @code{xgettext} option}
496
508
@opindex --msgstr-suffix@r{, @code{xgettext} option}
497
 
Use @var{string} (or "" if not specified) as suffix for msgstr entries.
 
509
Use @var{string} (or "" if not specified) as suffix for msgstr values.
498
510
 
499
511
@end table
500
512