flower/include/international.hh

   1 /*
   2   This file is part of LilyPond, the GNU music typesetter.
   3
   4   Copyright (C) 1997--2014 Jan Nieuwenhuizen <janneke@gnu.org>
   5
   6   LilyPond is free software: you can redistribute it and/or modify
   7   it under the terms of the GNU General Public License as published by
   8   the Free Software Foundation, either version 3 of the License, or
   9   (at your option) any later version.
  10
  11   LilyPond is distributed in the hope that it will be useful,
  12   but WITHOUT ANY WARRANTY; without even the implied warranty of
  13   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  14   GNU General Public License for more details.
  15
  16   You should have received a copy of the GNU General Public License
  17   along with LilyPond.  If not, see <http://www.gnu.org/licenses/>.
  18 */
  19
  20 #ifndef INTERNATIONAL_HH
  21 #define INTERNATIONAL_HH
  22
  23 #include <stdarg.h>
  24
  25 #include "std-string.hh"
  26
  27 /**
  28    Internationalisation: _i ("to be translated") gets an entry in the POT file
  29    gettext () must be invoked explicitly to do the actual "translation".
  30    See flower/getopt-long.cc.
  31 */
  32 #define _i(sz) sz
  33
  34 // don't inline: get warnings only once
  35 /**
  36    Internationalisation: _ ("to be translated") gets "translated" by GNU gettext
  37 */
  38 string _ (char const *ch);
  39
  40 /**
  41    Internationalisation: _f ("Usage: %s [FILE]", "lilypond") gets "translated" by
  42    GNU gettext
  43 */
  44 string _f (char const *format, ...)
  45 __attribute__ ((format (printf, 1, 2)));
  46 string _f (char const *format, const string &s, const string &s2 = "", const string &s3 = "");
  47 /**
  48    va_list version of _f
  49  */
  50 string v_f (char const *format, va_list args);
  51
  52 #endif // INTERNATIONAL_HH
  53