xgettext(1) 맨 페이지 - 윈디하나의 솔라나라

개요

섹션
맨 페이지 이름
검색(S)

xgettext(1)

xgettext(1)                      User Commands                     xgettext(1)

NAME
       xgettext - extract gettext call strings from C programs

SYNOPSIS
       xgettext [-ns] [-a [-x exclude-file]] [-c comment-tag]
            [-d default-domain] [-j] [-m prefix] [-M suffix]
            [-p pathname] -| filename...


       xgettext -h

DESCRIPTION
       The  xgettext utility is used to automate the creation of portable mes‐
       sage files (.po). A .po file contains copies of "C"  strings  that  are
       found in ANSI C source code in filename or the standard input if '−' is
       specified on the command line. The .po file can be used as input to the
       msgfmt(1)  utility,  which  produces  a binary form of the message file
       that can be used by application during runtime.


       xgettext writes msgid strings from gettext(3C) calls in filename to the
       default output file messages.po. The default output file  name  can  be
       changed  by -d option. msgid strings in dgettext() calls are written to
       the output file domainname.po where domainname is the  first  parameter
       to the dgettext() call.


       By  default,  xgettext creates a .po file in the current working direc‐
       tory, and each entry is in the same order  that  the  strings  are  ex‐
       tracted  from  filenames. When the -p option is specified, the .po file
       is created in the pathname directory. An existing .po file is overwrit‐
       ten.


       Duplicate msgids are written to the .po file as comment lines. When the
       -s option is specified, the .po is sorted by the msgid string, and  all
       duplicated  msgids  are  removed. All msgstr directives in the .po file
       are empty unless the -m option is used.

OPTIONS
       The following options are supported:

       -n                   Add comment lines to the  output  file  indicating
                            file name and line number in the source file where
                            each  extracted string is encountered. These lines
                            appear before each msgid in the following format:

                              # # File: filename, line: line-number



       -s                   Generate output sorted by msgids with  all  dupli‐
                            cate msgids removed.


       -a                   Extract  all strings, not just those found in get‐
                            text(3C) and dgettext() calls. Only one  .po  file
                            is created.


       -c comment-tag       The  comment  block  beginning with comment-tag as
                            the first token of the comment block is  added  to
                            the  output  .po file as # delimited comments. For
                            multiple domains, xgettext  directs  comments  and
                            messages to the prevailing text domain.


       -d default-domain    Rename default output file from messages.po to de‐
                            fault-domain.po.


       -j                   Join  messages  with  existing message files. If a
                            .po file does not exist, it is created. If  a  .po
                            file  does  exist,  new messages are appended. Any
                            duplicate msgids are commented out in the  result‐
                            ing  .po  file.  Domain directives in the existing
                            .po file are ignored. Results  not  guaranteed  if
                            the existing message file has been edited.


       -m prefix            Fill in the msgstr with prefix. This is useful for
                            debugging  purposes.  To  make msgstr identical to
                            msgid, use an empty string ("") for prefix.


       -M suffix            Fill in the msgstr with suffix. This is useful for
                            debugging purposes.


       -p pathname          Specify the directory where the output files  will
                            be placed. This option overrides the current work‐
                            ing directory.


       -x exclude-file      Specify  a .po file that contains a list of msgids
                            that are not to be extracted from the input files.
                            The format of exclude-file is identical to the .po
                            file. However, only the msgid  directive  line  in
                            exclude-file  is  used. All other lines are simply
                            ignored. The -x option can only be used  with  the
                            -a option.


       -h                   Print a help message on the standard output.


ATTRIBUTES
       See attributes(7) for descriptions of the following attributes:

       tab()  box; cw(2.75i) |cw(2.75i) lw(2.75i) |lw(2.75i) ATTRIBUTE TYPEAT‐
       TRIBUTE VALUE _ Availabilitytext/locale


SEE ALSO
       gettext(1), msgfmt(1), xgettext(1g), gettext(3C), attributes(7)


       gettext APIs in Internationalizing and Localizing Applications in  Ora‐
       cle Solaris

NOTES
       xgettext  is not able to extract cast strings, for example ANSI C casts
       of literal strings to (const char *). This is unnecessary anyway, since
       the prototypes in <libintl.h> already specify this type.


       In messages and translation notes, lines greater than  2048  characters
       are  truncated  to  2048 characters and a warning message is printed to
       stderr.

HISTORY
       Support for the -j option was added to the xgettext command in  Solaris
       2.1.


       The xgettext command was added in Solaris 2.0.

Oracle Solaris 11.4               25 Nov 2024                      xgettext(1)
맨 페이지 내용의 저작권은 맨 페이지 작성자에게 있습니다.
RSS ATOM XHTML 5 CSS3