NAME

       mcpp - Matsui CPP, an alternative C preprocessor

SYNOPSIS

       mcpp [options] [<infile> [<outfile>]]

DESCRIPTION

       mcpp  is  a  C/C++ preprocessor with the highest conformance which implements C90, C99 and
       C++98.  mcpp has  plentiful  diagnostics  and  many  #pragmas.   It  is  useful  to  check
       portability  of  your program, and also useful to debug complicated macro.  This is a man-
       page for mcpp of compiler-independent-build.

OPTIONS

       mcpp expects two file names as arguments,  <infile>  and  <outfile>.   If  not  specified,
       <infile> defaults to standard input and <outfile> defaults to standard output.

       It takes the following options.

       Commonly used options:

       -@MODE Specify preprocessing mode. MODE should be one of these 4:

           -@std
              Standard conforming mode. (default)

           -@poststd, -@post
              special 'post-Standard' mode.

           -@kr
              K&R 1st mode.

           -@oldprep, -@old
              "old_preprocessor" mode (i.e. "Reiser model" cpp).

       -C     Output also comments.

       -D <macro>[=<value>]
              Define <macro> as <value> (default:1).

       -D <macro(args)>[=<replace>]
              Define <macro(args)> as <replace>.

       -e <encoding>
              Change  the  default  multi-byte  character  encoding  to  one  of: euc_jp, gb2312,
              ksc5601, big5, sjis, iso2022_jp, utf8.

       -I <directory>
              Add <directory> to the #include search list.

       -I-    Unset system or site specific include directories.

       -j     Do not output the source line in diagnostics.

       -M, -MM, -MD, -MMD, -MP, -MQ target, -MT target, -MF file
              Output source file dependency line for makefile.

       -N     Don't predefine any non-standard macros.

       -o <file>
              Output to <file>.

       -P     Don't output #line lines.

       -Q     Output diagnostics to "mcpp.err" (default:stderr).

       -U <macro>
              Undefine <macro>.

       -v     Show version of mcpp.

       -W <level>
              Set warning level to <level> (OR of {0,1,2,4,8,16}, default:1).

       -z     Don't output the included file, only defining macros.

       Options available with -@std (default) or -@poststd options:

       -+     Process C++ source.

       -2     Enable digraphs.

       -h <n> Re-define the pre-defined macro __STDC_HOSTED__ as <n>.

       -S <n> Redefine __STDC__ to <n>, undefine old style macros.

       -V <n> Redefine __STDC_VERSION__ or __cplusplus to <n>.
              C with -V199901L specifies C99 mode.
              C++ with -V199901L specifies C99 compatible mode.

       Options available with only -@std (default) option:

       -@compat
              Expand recursive macro more than Standard.

       -3     Enable trigraphs.

       -K     Embed macro annotations into comments.

       Options available with -@std (default), -@kr or -@oldprep options:

       -a     Process "assembler" source.

PRAGMA

       mcpp has the following #pragma directives.

       #pragma once
              Read the header file only once even if multiply #included.

       #pragma __setlocale( "encoding")
              Specify the multibyte character encoding to "encoding".   See  -e  option  for  the
              encodings.

       #pragma MCPP put_defines
              Putout all the macro definitions currently valid.

       #pragma MCPP debug <args>
              Start to putout debugging informations.
                  <args> should be one or more of:
                  token expand macro_call path if expression memory getc

       #pragma MCPP end_debug <args>
              Stop to putout debugging informations.
                  <args> are the same with 'debug'.
                  No argument specifies all arguments.

       #pragma MCPP push_macro( "MACRO")
              Save the macro definition to the stack.

       #pragma MCPP pop_macro( "MACRO")
              Retrieve the macro definition from the stack.

       #pragma MCPP preprocess
              "Pre-preprocess" the following header files for mcpp.

       #pragma MCPP warning    any message
              Putout warning "any message".

VERSION

       MCPP V.2.7 (2008/03) compiler-independent-build

SEE ALSO

       Do  'man  mcpp-gcc'  for  mcpp of GCC-specific-build.  The full documentation for mcpp are
       maintained as html files.  Please see mcpp-manual.html.