flower/include/international.hh

   1 /*
   2   international.hh -- declare stuff for internationalization
   3
   4   source file of the GNU LilyPond music typesetter
   5
   6   (c) 1997--2007 Jan Nieuwenhuizen <janneke@gnu.org>
   7 */
   8
   9 #ifndef INTERNATIONAL_HH
  10 #define INTERNATIONAL_HH
  11
  12 #include <stdarg.h>
  13
  14 #include "std-string.hh"
  15
  16 /**
  17    Internationalisation: _i ("to be translated") gets an entry in the POT file
  18    gettext () must be invoked explicitely to do the actual "translation".
  19    See flower/getopt-long.cc.
  20 */
  21 #define _i(sz) sz
  22
  23 // don't inline: get warnings only once
  24 /**
  25    Internationalisation: _ ("to be translated") gets "translated" by GNU gettext
  26 */
  27 string _ (char const *ch);
  28
  29 /**
  30    Internationalisation: _f ("Usage: %s [FILE]", "lilypond") gets "translated" by
  31    GNU gettext
  32 */
  33 string _f (char const *format, ...)
  34            __attribute__ ((format (printf, 1, 2)));
  35 string _f (char const *format, string s, string s2 = "", string s3 = "");
  36 /**
  37    va_list version of _f
  38  */
  39 string v_f (char const *format, va_list args);
  40
  41 #endif // INTERNATIONAL_HH
  42