gnu/dist/gettext/gettext-tools/src/po-lex.h

   1 /* GNU gettext - internationalization aids
   2    Copyright (C) 1995-1998, 2000-2004 Free Software Foundation, Inc.
   3
   4    This file was written by Peter Miller <millerp@canb.auug.org.au>
   5
   6    This program 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 2, or (at your option)
   9    any later version.
  10
  11    This program 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 this program; if not, write to the Free Software Foundation,
  18    Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.  */
  19
  20 #ifndef _PO_LEX_H
  21 #define _PO_LEX_H
  22
  23 #include <sys/types.h>
  24 #include <stdio.h>
  25 #include <stdbool.h>
  26 #include "error.h"
  27 #include "error-progname.h"
  28 #include "xerror.h"
  29 #include "po-error.h"
  30 #include "pos.h"
  31
  32
  33 #ifdef __cplusplus
  34 extern "C" {
  35 #endif
  36
  37
  38 /* Lexical analyzer for reading PO files.  */
  39
  40
  41 /* Global variables from po-lex.c.  */
  42
  43 /* Current position within the PO file.  */
  44 extern DLL_VARIABLE lex_pos_ty gram_pos;
  45 extern DLL_VARIABLE int gram_pos_column;
  46
  47 /* Number of parse errors within a PO file that cause the program to
  48    terminate.  Cf. error_message_count, declared in <error.h>.  */
  49 extern DLL_VARIABLE unsigned int gram_max_allowed_errors;
  50
  51 /* True if obsolete entries shall be considered as valid.  */
  52 extern DLL_VARIABLE bool pass_obsolete_entries;
  53
  54
  55 /* Prepare lexical analysis.  */
  56 extern void lex_start (FILE *fp, const char *real_filename,
  57                        const char *logical_filename);
  58
  59 /* Terminate lexical analysis.  */
  60 extern void lex_end (void);
  61
  62 /* Return the next token in the PO file.  The return codes are defined
  63    in "po-gram-gen2.h".  Associated data is put in 'po_gram_lval.  */
  64 extern int po_gram_lex (void);
  65
  66 /* po_gram_lex() can return comments as COMMENT.  Switch this on or off.  */
  67 extern void po_lex_pass_comments (bool flag);
  68
  69 /* po_gram_lex() can return obsolete entries as if they were normal entries.
  70    Switch this on or off.  */
  71 extern void po_lex_pass_obsolete_entries (bool flag);
  72
  73
  74 /* ISO C 99 is smart enough to allow optimizations like this.
  75    Note: OpenVMS 7.3 cc pretends to support ISO C 99 but chokes on '...'.  */
  76 #if __STDC__ && (defined __STDC_VERSION__ && __STDC_VERSION__ >= 199901L && !defined __DECC)
  77
  78 /* CAUTION: If you change this macro, you must also make identical
  79    changes to the function of the same name in src/po-lex.c  */
  80
  81 # define po_gram_error(fmt, ...)                                            \
  82   do {                                                                      \
  83     char *totalfmt = xasprintf ("%s%s", "%s:%lu:%d: ", fmt);                \
  84     error_with_progname = false;                                            \
  85     po_error (0, 0, totalfmt, gram_pos.file_name,                           \
  86               (unsigned long) gram_pos.line_number, gram_pos_column + 1,    \
  87               __VA_ARGS__ + 0);                                             \
  88     error_with_progname = true;                                             \
  89     free (totalfmt);                                                        \
  90     if (*fmt == '.')                                                        \
  91       --error_message_count;                                                \
  92     else if (error_message_count >= gram_max_allowed_errors)                \
  93       po_error (1, 0, _("too many errors, aborting"));                      \
  94   } while (0)
  95
  96 /* CAUTION: If you change this macro, you must also make identical
  97    changes to the function of the same name in src/po-lex.c  */
  98
  99 # define po_gram_error_at_line(pos, fmt, ...)                               \
 100   do {                                                                      \
 101     error_with_progname = false;                                            \
 102     po_error_at_line (0, 0, (pos)->file_name, (pos)->line_number,           \
 103                       fmt, __VA_ARGS__ + 0);                                \
 104     error_with_progname = true;                                             \
 105     if (*fmt == '.')                                                        \
 106       --error_message_count;                                                \
 107     else if (error_message_count >= gram_max_allowed_errors)                \
 108       po_error (1, 0, _("too many errors, aborting"));                      \
 109   } while (0)
 110
 111 /* GCC is also smart enough to allow optimizations like this.  */
 112 #elif __STDC__ && defined __GNUC__ && __GNUC__ >= 2 && !defined __APPLE_CC__
 113
 114 /* CAUTION: If you change this macro, you must also make identical
 115    changes to the function of the same name in src/po-lex.c  */
 116
 117 # define po_gram_error(fmt, args...)                                        \
 118   do {                                                                      \
 119     char *totalfmt = xasprintf ("%s%s", "%s:%d:%d: ", fmt);                 \
 120     error_with_progname = false;                                            \
 121     po_error (0, 0, totalfmt, gram_pos.file_name, gram_pos.line_number,     \
 122               gram_pos_column + 1 , ## args);                               \
 123     error_with_progname = true;                                             \
 124     free (totalfmt);                                                        \
 125     if (*fmt == '.')                                                        \
 126       --error_message_count;                                                \
 127     else if (error_message_count >= gram_max_allowed_errors)                \
 128       po_error (1, 0, _("too many errors, aborting"));                      \
 129   } while (0)
 130
 131 /* CAUTION: If you change this macro, you must also make identical
 132    changes to the function of the same name in src/po-lex.c  */
 133
 134 # define po_gram_error_at_line(pos, fmt, args...)                           \
 135   do {                                                                      \
 136     error_with_progname = false;                                            \
 137     po_error_at_line (0, 0, (pos)->file_name, (pos)->line_number,           \
 138                       fmt , ## args);                                       \
 139     error_with_progname = true;                                             \
 140     if (*fmt == '.')                                                        \
 141       --error_message_count;                                                \
 142     else if (error_message_count >= gram_max_allowed_errors)                \
 143       po_error (1, 0, _("too many errors, aborting"));                      \
 144   } while (0)
 145
 146 #else
 147 extern void po_gram_error (const char *fmt, ...);
 148 extern void po_gram_error_at_line (const lex_pos_ty *pos, const char *fmt, ...);
 149 #endif
 150
 151
 152 /* Contains information about the definition of one translation.  */
 153 struct msgstr_def
 154 {
 155   char *msgstr;
 156   size_t msgstr_len;
 157 };
 158
 159
 160 #ifdef __cplusplus
 161 }
 162 #endif
 163
 164
 165 #endif