| /* gettext - retrieve text string from message catalog and print it. |
| Copyright (C) 1995-1997, 2000-2007, 2012, 2018-2020 Free Software |
| Foundation, Inc. |
| Written by Ulrich Drepper <drepper@gnu.ai.mit.edu>, May 1995. |
| |
| This program is free software: you can redistribute it and/or modify |
| it under the terms of the GNU General Public License as published by |
| the Free Software Foundation; either version 3 of the License, or |
| (at your option) any later version. |
| |
| This program is distributed in the hope that it will be useful, |
| but WITHOUT ANY WARRANTY; without even the implied warranty of |
| MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the |
| GNU General Public License for more details. |
| |
| You should have received a copy of the GNU General Public License |
| along with this program. If not, see <https://www.gnu.org/licenses/>. */ |
| |
| #ifdef HAVE_CONFIG_H |
| # include <config.h> |
| #endif |
| |
| #include <getopt.h> |
| #include <stdbool.h> |
| #include <stdio.h> |
| #include <stdlib.h> |
| #include <string.h> |
| #include <locale.h> |
| |
| #include "attribute.h" |
| #include "noreturn.h" |
| #include "closeout.h" |
| #include "error.h" |
| #include "progname.h" |
| #include "relocatable.h" |
| #include "basename-lgpl.h" |
| #include "xalloc.h" |
| #include "propername.h" |
| #include "xsetenv.h" |
| #include "../../gettext-runtime/src/escapes.h" |
| |
| /* Make sure we use the included libintl, not the system's one. */ |
| #undef _LIBINTL_H |
| #include "libgnuintl.h" |
| |
| #if defined _WIN32 && !defined __CYGWIN__ |
| # undef setlocale |
| # define setlocale fake_setlocale |
| extern char *setlocale (int category, const char *locale); |
| #endif |
| |
| #define _(str) gettext (str) |
| |
| /* If false, add newline after last string. This makes only sense in |
| the 'echo' emulation mode. */ |
| static bool inhibit_added_newline; |
| |
| /* If true, expand escape sequences in strings before looking in the |
| message catalog. */ |
| static bool do_expand; |
| |
| /* Long options. */ |
| static const struct option long_options[] = |
| { |
| { "domain", required_argument, NULL, 'd' }, |
| { "env", required_argument, NULL, '=' }, |
| { "help", no_argument, NULL, 'h' }, |
| { "shell-script", no_argument, NULL, 's' }, |
| { "version", no_argument, NULL, 'V' }, |
| { NULL, 0, NULL, 0 } |
| }; |
| |
| /* Forward declaration of local functions. */ |
| _GL_NORETURN_FUNC static void usage (int status); |
| |
| int |
| main (int argc, char *argv[]) |
| { |
| int optchar; |
| const char *msgid; |
| |
| /* Default values for command line options. */ |
| bool do_help = false; |
| bool do_shell = false; |
| bool do_version = false; |
| bool environ_changed = false; |
| const char *domain = getenv ("TEXTDOMAIN"); |
| const char *domaindir = getenv ("TEXTDOMAINDIR"); |
| inhibit_added_newline = false; |
| do_expand = false; |
| |
| /* Set program name for message texts. */ |
| set_program_name (argv[0]); |
| |
| /* Set locale via LC_ALL. */ |
| setlocale (LC_ALL, ""); |
| |
| /* Set the text message domain. */ |
| bindtextdomain (PACKAGE, relocate (LOCALEDIR)); |
| textdomain (PACKAGE); |
| |
| /* Ensure that write errors on stdout are detected. */ |
| atexit (close_stdout); |
| |
| /* Parse command line options. */ |
| while ((optchar = getopt_long (argc, argv, "+d:eEhnsV", long_options, NULL)) |
| != EOF) |
| switch (optchar) |
| { |
| case '\0': /* Long option. */ |
| break; |
| case 'd': |
| domain = optarg; |
| break; |
| case 'e': |
| do_expand = true; |
| break; |
| case 'E': |
| /* Ignore. Just for compatibility. */ |
| break; |
| case 'h': |
| do_help = true; |
| break; |
| case 'n': |
| inhibit_added_newline = true; |
| break; |
| case 's': |
| do_shell = true; |
| break; |
| case 'V': |
| do_version = true; |
| break; |
| case '=': |
| { |
| /* Undocumented option --env sets an environment variable. */ |
| char *separator = strchr (optarg, '='); |
| if (separator != NULL) |
| { |
| *separator = '\0'; |
| xsetenv (optarg, separator + 1, 1); |
| environ_changed = true; |
| break; |
| } |
| } |
| FALLTHROUGH; |
| default: |
| usage (EXIT_FAILURE); |
| } |
| |
| if (environ_changed) |
| /* Set locale again via LC_ALL. */ |
| setlocale (LC_ALL, ""); |
| |
| /* Version information is requested. */ |
| if (do_version) |
| { |
| printf ("%s (GNU %s) %s\n", last_component (program_name), |
| PACKAGE, VERSION); |
| /* xgettext: no-wrap */ |
| printf (_("Copyright (C) %s Free Software Foundation, Inc.\n\ |
| License GPLv3+: GNU GPL version 3 or later <%s>\n\ |
| This is free software: you are free to change and redistribute it.\n\ |
| There is NO WARRANTY, to the extent permitted by law.\n\ |
| "), |
| "1995-1997, 2000-2006", "https://gnu.org/licenses/gpl.html"); |
| printf (_("Written by %s.\n"), proper_name ("Ulrich Drepper")); |
| exit (EXIT_SUCCESS); |
| } |
| |
| /* Help is requested. */ |
| if (do_help) |
| usage (EXIT_SUCCESS); |
| |
| /* We have two major modes: use following Uniforum spec and as |
| internationalized 'echo' program. */ |
| if (!do_shell) |
| { |
| /* We have to write a single strings translation to stdout. */ |
| |
| /* Get arguments. */ |
| switch (argc - optind) |
| { |
| default: |
| error (EXIT_FAILURE, 0, _("too many arguments")); |
| |
| case 2: |
| domain = argv[optind++]; |
| FALLTHROUGH; |
| |
| case 1: |
| break; |
| |
| case 0: |
| error (EXIT_FAILURE, 0, _("missing arguments")); |
| } |
| |
| msgid = argv[optind++]; |
| |
| /* Expand escape sequences if enabled. */ |
| if (do_expand) |
| msgid = expand_escapes (msgid, &inhibit_added_newline); |
| |
| /* If no domain name is given we don't translate. */ |
| if (domain == NULL || domain[0] == '\0') |
| { |
| fputs (msgid, stdout); |
| } |
| else |
| { |
| /* Bind domain to appropriate directory. */ |
| if (domaindir != NULL && domaindir[0] != '\0') |
| bindtextdomain (domain, domaindir); |
| |
| /* Write out the result. */ |
| fputs (dgettext (domain, msgid), stdout); |
| } |
| } |
| else |
| { |
| if (optind < argc) |
| { |
| /* If no domain name is given we print the original string. |
| We mark this assigning NULL to domain. */ |
| if (domain == NULL || domain[0] == '\0') |
| domain = NULL; |
| else |
| /* Bind domain to appropriate directory. */ |
| if (domaindir != NULL && domaindir[0] != '\0') |
| bindtextdomain (domain, domaindir); |
| |
| /* We have to simulate 'echo'. All arguments are strings. */ |
| do |
| { |
| msgid = argv[optind++]; |
| |
| /* Expand escape sequences if enabled. */ |
| if (do_expand) |
| msgid = expand_escapes (msgid, &inhibit_added_newline); |
| |
| /* Write out the result. */ |
| fputs (domain == NULL ? msgid : dgettext (domain, msgid), |
| stdout); |
| |
| /* We separate the arguments by a single ' '. */ |
| if (optind < argc) |
| fputc (' ', stdout); |
| } |
| while (optind < argc); |
| } |
| |
| /* If not otherwise told: add trailing newline. */ |
| if (!inhibit_added_newline) |
| fputc ('\n', stdout); |
| } |
| |
| exit (EXIT_SUCCESS); |
| } |
| |
| |
| /* Display usage information and exit. */ |
| static void |
| usage (int status) |
| { |
| if (status != EXIT_SUCCESS) |
| fprintf (stderr, _("Try '%s --help' for more information.\n"), |
| program_name); |
| else |
| { |
| /* xgettext: no-wrap */ |
| printf (_("\ |
| Usage: %s [OPTION] [[TEXTDOMAIN] MSGID]\n\ |
| or: %s [OPTION] -s [MSGID]...\n\ |
| "), program_name, program_name); |
| printf ("\n"); |
| /* xgettext: no-wrap */ |
| printf (_("\ |
| Display native language translation of a textual message.\n")); |
| printf ("\n"); |
| /* xgettext: no-wrap */ |
| printf (_("\ |
| -d, --domain=TEXTDOMAIN retrieve translated messages from TEXTDOMAIN\n\ |
| -e enable expansion of some escape sequences\n\ |
| -E (ignored for compatibility)\n\ |
| -h, --help display this help and exit\n\ |
| -n suppress trailing newline\n\ |
| -V, --version display version information and exit\n\ |
| [TEXTDOMAIN] MSGID retrieve translated message corresponding\n\ |
| to MSGID from TEXTDOMAIN\n")); |
| printf ("\n"); |
| /* xgettext: no-wrap */ |
| printf (_("\ |
| If the TEXTDOMAIN parameter is not given, the domain is determined from the\n\ |
| environment variable TEXTDOMAIN. If the message catalog is not found in the\n\ |
| regular directory, another location can be specified with the environment\n\ |
| variable TEXTDOMAINDIR.\n\ |
| When used with the -s option the program behaves like the 'echo' command.\n\ |
| But it does not simply copy its arguments to stdout. Instead those messages\n\ |
| found in the selected catalog are translated.\n\ |
| Standard search directory: %s\n"), |
| getenv ("IN_HELP2MAN") == NULL ? LOCALEDIR : "@localedir@"); |
| printf ("\n"); |
| /* TRANSLATORS: The first placeholder is the web address of the Savannah |
| project of this package. The second placeholder is the bug-reporting |
| email address for this package. Please add _another line_ saying |
| "Report translation bugs to <...>\n" with the address for translation |
| bugs (typically your translation team's web or email address). */ |
| printf(_("\ |
| Report bugs in the bug tracker at <%s>\n\ |
| or by email to <%s>.\n"), |
| "https://savannah.gnu.org/projects/gettext", |
| "bug-gettext@gnu.org"); |
| } |
| |
| exit (status); |
| } |