Lines Matching refs:program
2 @c %MENU% How to make the program speak the user's language
5 The program's interface with the user should be designed to ease the user's
30 in the program a translation for the appropriate language. So the tasks
62 This means for the author of the program that s/he will have to make
63 sure the meaning of the identifier in the program code and in the
67 The user of the program must be able to guide the responsible function
77 * The gencat program:: How to generate message catalogs files which
124 the program influence the decision. It is up to the user to decide
130 stored. Every program could have its own place to keep all the
135 To tell the @code{catopen} function where the catalog for the program
205 as specified in the program, perhaps relative to the current working
293 helps to understand the program seems otherwise there would be no hint
300 It is somewhat uncomfortable to write a program using the @code{catgets}
462 use in a running program. The @code{catopen} function would have to
466 format. There is a special program @code{gencat} which is explained in
475 these files are always created by the @code{gencat} program. The
477 @code{gencat} program and so the interested reader can look through
481 @node The gencat program
485 The @code{gencat} program is specified in the X/Open standard and the
491 The @code{gencat} program can be invoked in two ways:
517 The @code{gencat} program works by concatenating all input files and
528 program. The X/Open standard does not specify any options for the
529 program so all of these are GNU extensions.
544 messages in the input files for use in the program. Details about how
569 writing a program we have to replace all appearances of translatable
578 normally done once at the program start. The @code{"string"} is the
582 In a bigger program several programmers usually work at the same time on
583 the program and so coordinating the number allocation is crucial.
591 different parts of the program. So the number of developers who have to
595 Only the user of the program might see wrong messages printed. In the
618 program itself.
621 before the program sources can be compiled. In the last section it was
624 call the @code{gencat} program as follows (assume @file{ex.msg} contains
645 but this is not necessary. The @code{gencat} program can take care for
677 famous greeting program. We start by writing the code as usual:
717 process it using the @code{gencat} program.
720 $ Messages for the famous greeting program.
727 Now we can start building the program (assume the message catalog source
728 file is named @file{hello.msg} and the program source file @file{hello.c}):
744 The call of the @code{gencat} program creates the missing header file
799 * GUI program problems:: How to use @code{gettext} in GUI programs.
866 task of the user to react on missing catalogs. The program cannot guess
868 the language the program was developed in, the message does not need any translation.
873 This is important if parts of the program are developed independently.
1031 When using the three functions above in a program it is a frequent case
1043 remarkable simple interface. But to provide the user of the program
1065 language the user selects the program should be able to locate the
1077 expects the program to understand what s/he means. E.g., to select the
1079 @code{deutsch} and the program should always react the same.
1095 to read the messages in another language and so the user of the program
1106 simple string which should be unique for each program part that uses a
1107 separate domain. It is possible to use in one program arbitrarily many
1109 named @code{libc} while the program using the C Library could use a
1131 program should ever really use a domain with this name since this can
1167 come with the program have to be placed in a directory hierarchy starting
1168 at, say, @file{/foo/bar}. Then the program should make a
1169 @code{bindtextdomain} call to bind the domain for the current program to
1171 running program does not depend on the user setting an environment
1178 If the program which wish to use @code{bindtextdomain} at some point of
1266 display the correct strings only if the program itself is written using
1592 @node GUI program problems
1601 situation in the program but might have different translations. This is
1611 As an example consider the following fictional situation. A GUI program
1632 to make them unambiguous. But what would the program do if no
1676 possible to produce a program which can be internationalized.
1730 internationalize the messages of the program. But it is finally up to
1759 files. If the program executed the @code{bindtextdomain} function for
1767 in the program code. For @code{gettext} and @code{dgettext} this is
1810 good choice for the domain name in the program code is a string which is
1811 closely related to the program/package name. E.g., for @theglibc{}
1815 A limited piece of example code should show how the program is supposed
1827 At the program start the default domain is @code{messages}, and the
1903 allows the program user much more freedom in choosing the locale name.
1922 character set of the system/program can be used (directly; there will
1936 package by far exceeds the abilities of the @code{gencat} program
1939 There is a program @code{msgfmt} which is the equivalent program to the
1940 @code{gencat} program. It generates from the human-readable and
1945 The @code{xgettext} program can be used to automatically extract the
1950 program has a lot of options which help to customize the output or