Merge branch 'es/doc-worktree-guessremote-config'
[git.git] / gettext.h
blob71255e503eeb70e691e03ac1be0e2a249244a096
1 /*
2 * Copyright (c) 2010-2011 Ævar Arnfjörð Bjarmason
4 * This is a skeleton no-op implementation of gettext for Git.
5 * You can replace it with something that uses libintl.h and wraps
6 * gettext() to try out the translations.
7 */
9 #ifndef GETTEXT_H
10 #define GETTEXT_H
12 #if defined(_) || defined(Q_)
13 #error "namespace conflict: '_' or 'Q_' is pre-defined?"
14 #endif
16 #ifndef NO_GETTEXT
17 # include <libintl.h>
18 #else
19 # ifdef gettext
20 # undef gettext
21 # endif
22 # define gettext(s) (s)
23 # ifdef ngettext
24 # undef ngettext
25 # endif
26 # define ngettext(s, p, n) ((n == 1) ? (s) : (p))
27 #endif
29 #define FORMAT_PRESERVING(n) __attribute__((format_arg(n)))
31 extern int use_gettext_poison(void);
33 #ifndef NO_GETTEXT
34 extern void git_setup_gettext(void);
35 extern int gettext_width(const char *s);
36 #else
37 static inline void git_setup_gettext(void)
39 use_gettext_poison(); /* getenv() reentrancy paranoia */
41 static inline int gettext_width(const char *s)
43 return strlen(s);
45 #endif
47 static inline FORMAT_PRESERVING(1) const char *_(const char *msgid)
49 if (!*msgid)
50 return "";
51 return use_gettext_poison() ? "# GETTEXT POISON #" : gettext(msgid);
54 static inline FORMAT_PRESERVING(1) FORMAT_PRESERVING(2)
55 const char *Q_(const char *msgid, const char *plu, unsigned long n)
57 if (use_gettext_poison())
58 return "# GETTEXT POISON #";
59 return ngettext(msgid, plu, n);
62 /* Mark msgid for translation but do not translate it. */
63 #if !USE_PARENS_AROUND_GETTEXT_N
64 #define N_(msgid) msgid
65 #else
67 * Strictly speaking, this will lead to invalid C when
68 * used this way:
69 * static const char s[] = N_("FOO");
70 * which will expand to
71 * static const char s[] = ("FOO");
72 * and in valid C, the initializer on the right hand side must
73 * be without the parentheses. But many compilers do accept it
74 * as a language extension and it will allow us to catch mistakes
75 * like:
76 * static const char *msgs[] = {
77 * N_("one")
78 * N_("two"),
79 * N_("three"),
80 * NULL
81 * };
82 * (notice the missing comma on one of the lines) by forcing
83 * a compilation error, because parenthesised ("one") ("two")
84 * will not get silently turned into ("onetwo").
86 #define N_(msgid) (msgid)
87 #endif
89 const char *get_preferred_languages(void);
90 extern int is_utf8_locale(void);
92 #endif