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

« back to all changes in this revision

Viewing changes to gettext-tools/doc/gettext_5.html

  • 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:
1
1
<HTML>
2
2
<HEAD>
3
3
<!-- This HTML file has been created by texi2html 1.52b
4
 
     from gettext.texi on 4 November 2007 -->
 
4
     from gettext.texi on 6 June 2010 -->
5
5
 
6
6
<META HTTP-EQUIV="content-type" CONTENT="text/html; charset=UTF-8">
7
7
<TITLE>GNU gettext utilities - 5  Making the PO Template File</TITLE>
13
13
 
14
14
<H1><A NAME="SEC27" HREF="gettext_toc.html#TOC27">5  Making the PO Template File</A></H1>
15
15
<P>
16
 
<A NAME="IDX153"></A>
 
16
<A NAME="IDX158"></A>
17
17
 
18
18
</P>
19
19
<P>
36
36
<H2><A NAME="SEC28" HREF="gettext_toc.html#TOC28">5.1  Invoking the <CODE>xgettext</CODE> Program</A></H2>
37
37
 
38
38
<P>
39
 
<A NAME="IDX154"></A>
40
 
<A NAME="IDX155"></A>
 
39
<A NAME="IDX159"></A>
 
40
<A NAME="IDX160"></A>
41
41
 
42
42
<PRE>
43
43
xgettext [<VAR>option</VAR>] [<VAR>inputfile</VAR>] ...
62
62
<DD>
63
63
<DT><SAMP>&lsquo;--files-from=<VAR>file</VAR>&rsquo;</SAMP>
64
64
<DD>
65
 
<A NAME="IDX156"></A>
66
 
<A NAME="IDX157"></A>
 
65
<A NAME="IDX161"></A>
 
66
<A NAME="IDX162"></A>
67
67
Read the names of the input files from <VAR>file</VAR> instead of getting
68
68
them from the command line.
69
69
 
71
71
<DD>
72
72
<DT><SAMP>&lsquo;--directory=<VAR>directory</VAR>&rsquo;</SAMP>
73
73
<DD>
74
 
<A NAME="IDX158"></A>
75
 
<A NAME="IDX159"></A>
 
74
<A NAME="IDX163"></A>
 
75
<A NAME="IDX164"></A>
76
76
Add <VAR>directory</VAR> to the list of directories.  Source files are
77
77
searched relative to this list of directories.  The resulting <TT>&lsquo;.po&rsquo;</TT>
78
78
file will be written relative to the current directory, though.
93
93
<DD>
94
94
<DT><SAMP>&lsquo;--default-domain=<VAR>name</VAR>&rsquo;</SAMP>
95
95
<DD>
96
 
<A NAME="IDX160"></A>
97
 
<A NAME="IDX161"></A>
 
96
<A NAME="IDX165"></A>
 
97
<A NAME="IDX166"></A>
98
98
Use <TT>&lsquo;<VAR>name</VAR>.po&rsquo;</TT> for output (instead of <TT>&lsquo;messages.po&rsquo;</TT>).
99
99
 
100
100
<DT><SAMP>&lsquo;-o <VAR>file</VAR>&rsquo;</SAMP>
101
101
<DD>
102
102
<DT><SAMP>&lsquo;--output=<VAR>file</VAR>&rsquo;</SAMP>
103
103
<DD>
104
 
<A NAME="IDX162"></A>
105
 
<A NAME="IDX163"></A>
 
104
<A NAME="IDX167"></A>
 
105
<A NAME="IDX168"></A>
106
106
Write output to specified file (instead of <TT>&lsquo;<VAR>name</VAR>.po&rsquo;</TT> or
107
107
<TT>&lsquo;messages.po&rsquo;</TT>).
108
108
 
110
110
<DD>
111
111
<DT><SAMP>&lsquo;--output-dir=<VAR>dir</VAR>&rsquo;</SAMP>
112
112
<DD>
113
 
<A NAME="IDX164"></A>
114
 
<A NAME="IDX165"></A>
 
113
<A NAME="IDX169"></A>
 
114
<A NAME="IDX170"></A>
115
115
Output files will be placed in directory <VAR>dir</VAR>.
116
116
 
117
117
</DL>
118
118
 
119
119
<P>
120
 
<A NAME="IDX166"></A>
 
120
<A NAME="IDX171"></A>
121
121
If the output <VAR>file</VAR> is <SAMP>&lsquo;-&rsquo;</SAMP> or <SAMP>&lsquo;/dev/stdout&rsquo;</SAMP>, the output
122
122
is written to standard output.
123
123
 
132
132
<DD>
133
133
<DT><SAMP>&lsquo;--language=<VAR>name</VAR>&rsquo;</SAMP>
134
134
<DD>
135
 
<A NAME="IDX167"></A>
136
 
<A NAME="IDX168"></A>
137
 
<A NAME="IDX169"></A>
 
135
<A NAME="IDX172"></A>
 
136
<A NAME="IDX173"></A>
 
137
<A NAME="IDX174"></A>
138
138
Specifies the language of the input files.  The supported languages
139
139
are <CODE>C</CODE>, <CODE>C++</CODE>, <CODE>ObjectiveC</CODE>, <CODE>PO</CODE>, <CODE>Python</CODE>,
140
140
<CODE>Lisp</CODE>, <CODE>EmacsLisp</CODE>, <CODE>librep</CODE>, <CODE>Scheme</CODE>, <CODE>Smalltalk</CODE>,
146
146
<DD>
147
147
<DT><SAMP>&lsquo;--c++&rsquo;</SAMP>
148
148
<DD>
149
 
<A NAME="IDX170"></A>
150
 
<A NAME="IDX171"></A>
 
149
<A NAME="IDX175"></A>
 
150
<A NAME="IDX176"></A>
151
151
This is a shorthand for <CODE>--language=C++</CODE>.
152
152
 
153
153
</DL>
165
165
 
166
166
<DT><SAMP>&lsquo;--from-code=<VAR>name</VAR>&rsquo;</SAMP>
167
167
<DD>
168
 
<A NAME="IDX172"></A>
 
168
<A NAME="IDX177"></A>
169
169
Specifies the encoding of the input files.  This option is needed only
170
170
if some untranslated message strings or their corresponding comments
171
171
contain non-ASCII characters.  Note that Tcl and Glade input files are
187
187
<DD>
188
188
<DT><SAMP>&lsquo;--join-existing&rsquo;</SAMP>
189
189
<DD>
190
 
<A NAME="IDX173"></A>
191
 
<A NAME="IDX174"></A>
 
190
<A NAME="IDX178"></A>
 
191
<A NAME="IDX179"></A>
192
192
Join messages with existing file.
193
193
 
194
194
<DT><SAMP>&lsquo;-x <VAR>file</VAR>&rsquo;</SAMP>
195
195
<DD>
196
196
<DT><SAMP>&lsquo;--exclude-file=<VAR>file</VAR>&rsquo;</SAMP>
197
197
<DD>
198
 
<A NAME="IDX175"></A>
199
 
<A NAME="IDX176"></A>
 
198
<A NAME="IDX180"></A>
 
199
<A NAME="IDX181"></A>
200
200
Entries from <VAR>file</VAR> are not extracted.  <VAR>file</VAR> should be a PO or
201
201
POT file.
202
202
 
203
 
<DT><SAMP>&lsquo;-c [<VAR>tag</VAR>]&rsquo;</SAMP>
 
203
<DT><SAMP>&lsquo;-c[<VAR>tag</VAR>]&rsquo;</SAMP>
204
204
<DD>
205
205
<DT><SAMP>&lsquo;--add-comments[=<VAR>tag</VAR>]&rsquo;</SAMP>
206
206
<DD>
207
 
<A NAME="IDX177"></A>
208
 
<A NAME="IDX178"></A>
209
 
Place comment block with <VAR>tag</VAR> (or those preceding keyword lines)
210
 
in output file.
 
207
<A NAME="IDX182"></A>
 
208
<A NAME="IDX183"></A>
 
209
Place comment blocks starting with <VAR>tag</VAR> and preceding keyword lines
 
210
in the output file.  Without a <VAR>tag</VAR>, the option means to put <EM>all</EM>
 
211
comment blocks preceding keyword lines in the output file.
211
212
 
212
213
</DL>
213
214
 
221
222
<DD>
222
223
<DT><SAMP>&lsquo;--extract-all&rsquo;</SAMP>
223
224
<DD>
224
 
<A NAME="IDX179"></A>
225
 
<A NAME="IDX180"></A>
 
225
<A NAME="IDX184"></A>
 
226
<A NAME="IDX185"></A>
226
227
Extract all strings.
227
228
 
228
229
This option has an effect with most languages, namely C, C++, ObjectiveC,
229
230
Shell, Python, Lisp, EmacsLisp, librep, Java, C#, awk, Tcl, Perl, PHP,
230
231
GCC-source, Glade.
231
232
 
232
 
<DT><SAMP>&lsquo;-k <VAR>keywordspec</VAR>&rsquo;</SAMP>
 
233
<DT><SAMP>&lsquo;-k[<VAR>keywordspec</VAR>]&rsquo;</SAMP>
233
234
<DD>
234
235
<DT><SAMP>&lsquo;--keyword[=<VAR>keywordspec</VAR>]&rsquo;</SAMP>
235
236
<DD>
236
 
<A NAME="IDX181"></A>
237
 
<A NAME="IDX182"></A>
238
 
Additional keyword to be looked for (without <VAR>keywordspec</VAR> means not to
239
 
use default keywords).
 
237
<A NAME="IDX186"></A>
 
238
<A NAME="IDX187"></A>
 
239
Specify <VAR>keywordspec</VAR> as an additional keyword to be looked for.
 
240
Without a <VAR>keywordspec</VAR>, the option means to not use default keywords.
240
241
 
241
 
<A NAME="IDX183"></A>
242
 
<A NAME="IDX184"></A>
 
242
<A NAME="IDX188"></A>
 
243
<A NAME="IDX189"></A>
243
244
If <VAR>keywordspec</VAR> is a C identifier <VAR>id</VAR>, <CODE>xgettext</CODE> looks
244
245
for strings in the first argument of each call to the function or macro
245
246
<VAR>id</VAR>.  If <VAR>keywordspec</VAR> is of the form
361
362
 
362
363
<DT><SAMP>&lsquo;--flag=<VAR>word</VAR>:<VAR>arg</VAR>:<VAR>flag</VAR>&rsquo;</SAMP>
363
364
<DD>
364
 
<A NAME="IDX185"></A>
 
365
<A NAME="IDX190"></A>
365
366
Specifies additional flags for strings occurring as part of the <VAR>arg</VAR>th
366
367
argument of the function <VAR>word</VAR>.  The possible flags are the possible
367
368
format string indicators, such as <SAMP>&lsquo;c-format&rsquo;</SAMP>, and their negations,
368
369
such as <SAMP>&lsquo;no-c-format&rsquo;</SAMP>, possibly prefixed with <SAMP>&lsquo;pass-&rsquo;</SAMP>.
369
370
<BR>
370
 
<A NAME="IDX186"></A>
 
371
<A NAME="IDX191"></A>
371
372
The meaning of <CODE>--flag=<VAR>function</VAR>:<VAR>arg</VAR>:<VAR>lang</VAR>-format</CODE>
372
373
is that in language <VAR>lang</VAR>, the specified <VAR>function</VAR> expects as
373
374
<VAR>arg</VAR>th argument a format string.  (For those of you familiar with
385
386
translators cannot accidentally use format string directives that would
386
387
lead to a crash at runtime.
387
388
<BR>
388
 
<A NAME="IDX187"></A>
 
389
<A NAME="IDX192"></A>
389
390
The meaning of <CODE>--flag=<VAR>function</VAR>:<VAR>arg</VAR>:pass-<VAR>lang</VAR>-format</CODE>
390
391
is that in language <VAR>lang</VAR>, if the <VAR>function</VAR> call occurs in a
391
392
position that must yield a format string, then its <VAR>arg</VAR>th argument
412
413
<DD>
413
414
<DT><SAMP>&lsquo;--trigraphs&rsquo;</SAMP>
414
415
<DD>
415
 
<A NAME="IDX188"></A>
416
 
<A NAME="IDX189"></A>
417
 
<A NAME="IDX190"></A>
 
416
<A NAME="IDX193"></A>
 
417
<A NAME="IDX194"></A>
 
418
<A NAME="IDX195"></A>
418
419
Understand ANSI C trigraphs for input.
419
420
<BR>
420
421
This option has an effect only with the languages C, C++, ObjectiveC.
421
422
 
422
423
<DT><SAMP>&lsquo;--qt&rsquo;</SAMP>
423
424
<DD>
424
 
<A NAME="IDX191"></A>
425
 
<A NAME="IDX192"></A>
 
425
<A NAME="IDX196"></A>
 
426
<A NAME="IDX197"></A>
426
427
Recognize Qt format strings.
427
428
<BR>
428
429
This option has an effect only with the language C++.
429
430
 
430
431
<DT><SAMP>&lsquo;--kde&rsquo;</SAMP>
431
432
<DD>
432
 
<A NAME="IDX193"></A>
433
 
<A NAME="IDX194"></A>
 
433
<A NAME="IDX198"></A>
 
434
<A NAME="IDX199"></A>
434
435
Recognize KDE 4 format strings.
435
436
<BR>
436
437
This option has an effect only with the language C++.
437
438
 
438
439
<DT><SAMP>&lsquo;--boost&rsquo;</SAMP>
439
440
<DD>
440
 
<A NAME="IDX195"></A>
441
 
<A NAME="IDX196"></A>
 
441
<A NAME="IDX200"></A>
 
442
<A NAME="IDX201"></A>
442
443
Recognize Boost format strings.
443
444
<BR>
444
445
This option has an effect only with the language C++.
445
446
 
446
447
<DT><SAMP>&lsquo;--debug&rsquo;</SAMP>
447
448
<DD>
448
 
<A NAME="IDX197"></A>
449
 
<A NAME="IDX198"></A>
 
449
<A NAME="IDX202"></A>
 
450
<A NAME="IDX203"></A>
450
451
Use the flags <CODE>c-format</CODE> and <CODE>possible-c-format</CODE> to show who was
451
452
responsible for marking a message as a format string.  The latter form is
452
453
used if the <CODE>xgettext</CODE> program decided, the format form is used if
469
470
 
470
471
<DL COMPACT>
471
472
 
 
473
<DT><SAMP>&lsquo;--color&rsquo;</SAMP>
 
474
<DD>
 
475
<DT><SAMP>&lsquo;--color=<VAR>when</VAR>&rsquo;</SAMP>
 
476
<DD>
 
477
<A NAME="IDX204"></A>
 
478
Specify whether or when to use colors and other text attributes.
 
479
See section <A HREF="gettext_9.html#SEC150">9.11.1  The <CODE>--color</CODE> option</A> for details.
 
480
 
 
481
<DT><SAMP>&lsquo;--style=<VAR>style_file</VAR>&rsquo;</SAMP>
 
482
<DD>
 
483
<A NAME="IDX205"></A>
 
484
Specify the CSS style rule file to use for <CODE>--color</CODE>.
 
485
See section <A HREF="gettext_9.html#SEC152">9.11.3  The <CODE>--style</CODE> option</A> for details.
 
486
 
472
487
<DT><SAMP>&lsquo;--force-po&rsquo;</SAMP>
473
488
<DD>
474
 
<A NAME="IDX199"></A>
 
489
<A NAME="IDX206"></A>
475
490
Always write an output file even if no message is defined.
476
491
 
477
492
<DT><SAMP>&lsquo;-i&rsquo;</SAMP>
478
493
<DD>
479
494
<DT><SAMP>&lsquo;--indent&rsquo;</SAMP>
480
495
<DD>
481
 
<A NAME="IDX200"></A>
482
 
<A NAME="IDX201"></A>
 
496
<A NAME="IDX207"></A>
 
497
<A NAME="IDX208"></A>
483
498
Write the .po file using indented style.
484
499
 
485
500
<DT><SAMP>&lsquo;--no-location&rsquo;</SAMP>
486
501
<DD>
487
 
<A NAME="IDX202"></A>
 
502
<A NAME="IDX209"></A>
488
503
Do not write <SAMP>&lsquo;#: <VAR>filename</VAR>:<VAR>line</VAR>&rsquo;</SAMP> lines.  Note that using
489
504
this option makes it harder for technically skilled translators to understand
490
505
each message's context.
493
508
<DD>
494
509
<DT><SAMP>&lsquo;--add-location&rsquo;</SAMP>
495
510
<DD>
496
 
<A NAME="IDX203"></A>
497
 
<A NAME="IDX204"></A>
 
511
<A NAME="IDX210"></A>
 
512
<A NAME="IDX211"></A>
498
513
Generate <SAMP>&lsquo;#: <VAR>filename</VAR>:<VAR>line</VAR>&rsquo;</SAMP> lines (default).
499
514
 
500
515
<DT><SAMP>&lsquo;--strict&rsquo;</SAMP>
501
516
<DD>
502
 
<A NAME="IDX205"></A>
 
517
<A NAME="IDX212"></A>
503
518
Write out a strict Uniforum conforming PO file.  Note that this
504
519
Uniforum format should be avoided because it doesn't support the
505
520
GNU extensions.
506
521
 
507
522
<DT><SAMP>&lsquo;--properties-output&rsquo;</SAMP>
508
523
<DD>
509
 
<A NAME="IDX206"></A>
 
524
<A NAME="IDX213"></A>
510
525
Write out a Java ResourceBundle in Java <CODE>.properties</CODE> syntax.  Note
511
526
that this file format doesn't support plural forms and silently drops
512
527
obsolete messages.
513
528
 
514
529
<DT><SAMP>&lsquo;--stringtable-output&rsquo;</SAMP>
515
530
<DD>
516
 
<A NAME="IDX207"></A>
 
531
<A NAME="IDX214"></A>
517
532
Write out a NeXTstep/GNUstep localized resource file in <CODE>.strings</CODE> syntax.
518
533
Note that this file format doesn't support plural forms.
519
534
 
521
536
<DD>
522
537
<DT><SAMP>&lsquo;--width=<VAR>number</VAR>&rsquo;</SAMP>
523
538
<DD>
524
 
<A NAME="IDX208"></A>
525
 
<A NAME="IDX209"></A>
 
539
<A NAME="IDX215"></A>
 
540
<A NAME="IDX216"></A>
526
541
Set the output page width.  Long strings in the output files will be
527
542
split across multiple lines in order to ensure that each line's width
528
543
(= number of screen columns) is less or equal to the given <VAR>number</VAR>.
529
544
 
530
545
<DT><SAMP>&lsquo;--no-wrap&rsquo;</SAMP>
531
546
<DD>
532
 
<A NAME="IDX210"></A>
 
547
<A NAME="IDX217"></A>
533
548
Do not break long message lines.  Message lines whose width exceeds the
534
549
output page width will not be split into several lines.  Only file reference
535
550
lines which are wider than the output page width will be split.
538
553
<DD>
539
554
<DT><SAMP>&lsquo;--sort-output&rsquo;</SAMP>
540
555
<DD>
541
 
<A NAME="IDX211"></A>
542
 
<A NAME="IDX212"></A>
543
 
<A NAME="IDX213"></A>
 
556
<A NAME="IDX218"></A>
 
557
<A NAME="IDX219"></A>
 
558
<A NAME="IDX220"></A>
544
559
Generate sorted output.  Note that using this option makes it much harder
545
560
for the translator to understand each message's context.
546
561
 
548
563
<DD>
549
564
<DT><SAMP>&lsquo;--sort-by-file&rsquo;</SAMP>
550
565
<DD>
551
 
<A NAME="IDX214"></A>
552
 
<A NAME="IDX215"></A>
 
566
<A NAME="IDX221"></A>
 
567
<A NAME="IDX222"></A>
553
568
Sort output by file location.
554
569
 
555
570
<DT><SAMP>&lsquo;--omit-header&rsquo;</SAMP>
556
571
<DD>
557
 
<A NAME="IDX216"></A>
 
572
<A NAME="IDX223"></A>
558
573
Don't write header with <SAMP>&lsquo;msgid ""&rsquo;</SAMP> entry.
559
574
 
560
 
<A NAME="IDX217"></A>
 
575
<A NAME="IDX224"></A>
561
576
This is useful for testing purposes because it eliminates a source
562
577
of variance for generated <CODE>.gmo</CODE> files.  With <CODE>--omit-header</CODE>,
563
578
two invocations of <CODE>xgettext</CODE> on the same files with the same
568
583
 
569
584
<DT><SAMP>&lsquo;--copyright-holder=<VAR>string</VAR>&rsquo;</SAMP>
570
585
<DD>
571
 
<A NAME="IDX218"></A>
 
586
<A NAME="IDX225"></A>
572
587
Set the copyright holder in the output.  <VAR>string</VAR> should be the
573
588
copyright holder of the surrounding package.  (Note that the msgstr
574
589
strings, extracted from the package's sources, belong to the copyright
584
599
 
585
600
<DT><SAMP>&lsquo;--foreign-user&rsquo;</SAMP>
586
601
<DD>
587
 
<A NAME="IDX219"></A>
 
602
<A NAME="IDX226"></A>
588
603
Omit FSF copyright in output.  This option is equivalent to
589
604
<SAMP>&lsquo;--copyright-holder=”&rsquo;</SAMP>.  It can be useful for packages outside the GNU
590
605
project that want their translations to be in the public domain.
591
606
 
592
607
<DT><SAMP>&lsquo;--package-name=<VAR>package</VAR>&rsquo;</SAMP>
593
608
<DD>
594
 
<A NAME="IDX220"></A>
 
609
<A NAME="IDX227"></A>
595
610
Set the package name in the header of the output.
596
611
 
597
612
<DT><SAMP>&lsquo;--package-version=<VAR>version</VAR>&rsquo;</SAMP>
598
613
<DD>
599
 
<A NAME="IDX221"></A>
 
614
<A NAME="IDX228"></A>
600
615
Set the package version in the header of the output.  This option has an
601
616
effect only if the <SAMP>&lsquo;--package-name&rsquo;</SAMP> option is also used.
602
617
 
603
618
<DT><SAMP>&lsquo;--msgid-bugs-address=<VAR>email@address</VAR>&rsquo;</SAMP>
604
619
<DD>
605
 
<A NAME="IDX222"></A>
 
620
<A NAME="IDX229"></A>
606
621
Set the reporting address for msgid bugs.  This is the email address or URL
607
622
to which the translators shall report bugs in the untranslated strings:
608
623
 
632
647
The default value is empty, which means that translators will be clueless!
633
648
Don't forget to specify this option.
634
649
 
635
 
<DT><SAMP>&lsquo;-m [<VAR>string</VAR>]&rsquo;</SAMP>
 
650
<DT><SAMP>&lsquo;-m[<VAR>string</VAR>]&rsquo;</SAMP>
636
651
<DD>
637
652
<DT><SAMP>&lsquo;--msgstr-prefix[=<VAR>string</VAR>]&rsquo;</SAMP>
638
653
<DD>
639
 
<A NAME="IDX223"></A>
640
 
<A NAME="IDX224"></A>
641
 
Use <VAR>string</VAR> (or "" if not specified) as prefix for msgstr entries.
 
654
<A NAME="IDX230"></A>
 
655
<A NAME="IDX231"></A>
 
656
Use <VAR>string</VAR> (or "" if not specified) as prefix for msgstr values.
642
657
 
643
 
<DT><SAMP>&lsquo;-M [<VAR>string</VAR>]&rsquo;</SAMP>
 
658
<DT><SAMP>&lsquo;-M[<VAR>string</VAR>]&rsquo;</SAMP>
644
659
<DD>
645
660
<DT><SAMP>&lsquo;--msgstr-suffix[=<VAR>string</VAR>]&rsquo;</SAMP>
646
661
<DD>
647
 
<A NAME="IDX225"></A>
648
 
<A NAME="IDX226"></A>
649
 
Use <VAR>string</VAR> (or "" if not specified) as suffix for msgstr entries.
 
662
<A NAME="IDX232"></A>
 
663
<A NAME="IDX233"></A>
 
664
Use <VAR>string</VAR> (or "" if not specified) as suffix for msgstr values.
650
665
 
651
666
</DL>
652
667
 
660
675
<DD>
661
676
<DT><SAMP>&lsquo;--help&rsquo;</SAMP>
662
677
<DD>
663
 
<A NAME="IDX227"></A>
664
 
<A NAME="IDX228"></A>
 
678
<A NAME="IDX234"></A>
 
679
<A NAME="IDX235"></A>
665
680
Display this help and exit.
666
681
 
667
682
<DT><SAMP>&lsquo;-V&rsquo;</SAMP>
668
683
<DD>
669
684
<DT><SAMP>&lsquo;--version&rsquo;</SAMP>
670
685
<DD>
671
 
<A NAME="IDX229"></A>
672
 
<A NAME="IDX230"></A>
 
686
<A NAME="IDX236"></A>
 
687
<A NAME="IDX237"></A>
673
688
Output version information and exit.
674
689
 
675
690
</DL>