NAME

       ucpp - C preprocessor

SYNOPSIS

       ucpp [ options ] [ file ]

DESCRIPTION

       ucpp  is  a  C  preprocessor  mostly  compatible with ISO-C99.  It is rather strict and uses only a small
       amount of memory. It uses standard input as primary input if no file argument is given.

OPTIONS

       There are several classes of options.

       Language Options

       -C     keep comments in the output.

       -s     if a rogue '#' is encountered, do not emit an error and keep it in the output.

       -l     supress the emission of '#line' directives in the output.

       -lg    convert the '#line' to the gcc-style equivalent.

       -CC    disable C++-like comments (a '//' begins a comment, up to the end of the line). Use this option to
              get closer to C90 behaviour.

       -a, -na
              handle assertions (defined with #assert); -a also defines the standard assertions #machine ,  #cpu
              and #system (see -e to get the local definition of such assertions).

       -a0    disable assertion support.

       -V     disable  support  for  macros with a variable number of arguments: in C99, a macro may be declared
              with ...  as the last argument; inside the replacement list,  __VA_ARGS__  is  replaced  with  the
              optional  extra  arguments  given  in the call to the macro.  Use this option to get closer to C90
              behaviour.

       -u     enable UTF-8 support: with this option, the source is considered as an ISO/10646  source,  encoded
              in  UTF-8.  Characters  represented  as two bytes or more are considered as alphabetic characters,
              like letters, and therefore usable in identifiers. These characters hold the same syntactic  value
              than the corresponding Universal Character Names.

       -X     enable  -a, -u and -Y.  This should make ucpp behave closer to what is requested from a "modern" C
              preprocessor.

       -c90   enable -V and -CC, and do not define __STDC_VERSION__.  This should  make  ucpp  mimic  older  C90
              behaviour.

       -t     disable trigraph support; this seems to be required for some legacy code.

       Warning Options

       -wt    emit a final warning when trigraphs are encountered.

       -wtt   emit warnings for each trigraph encountered.

       -wa    emit annoying warnings (these are usually useless).

       -w0    supress standard warnings.

       Directory Options

       -Idirectory

       -I directory
              add directory to the include path, before the standard include path.

       -Jdirectory

       -J directory
              add directory to the include path, after the standard include path.

       -zI    do not use the standard (compile-time) include path.

       -M     emit  only  the  names  of  encountered files, separated by spaces; this is intended for automatic
              generation of Makefile dependencies.

       -Ma    do the same as -M but also for system files.

       -o file
              direct the ouput to file instead of standard output.

       Macro Options

       -Dmacro
              predefine macro with content 1.

       -Dmacro=def
              predefine macro with the content def.

       -Umacro
              undefine macro.

       -Y     predefine system-dependant macros.

       -Z     do not predefine special macros such as __TIME__.

       -Afoo(bar)
              add foo(bar) to the list of assertions.

       -Bfoo(bar)
              remove foo(bar) of the list of assertions; you may also use -Bfoo to remove  all  -Bfoo(xxx)  from
              the list of assertions.

       -d     instead  of  normal  output,  emit  '#define'  directives  representing  all macros defined during
              processing.

       -e     instead of normal output, emit '#assert' directives representing  all  assertions  defined  during
              processing.

       Miscellaneous Options

       -v     print version number, include path and (optionaly) defined assertions.

       -h     print some help.

ENVIRONMENT

       ucpp  is  not  itself affected by environment variables. However, it uses library functions that might be
       affected, depending on the system.

AUTHOR

       Thomas Pornin <pornin@bolet.org>

BUGS

       ucpp is considered stable software. However improbable it is, please report bugs to the author  (possibly
       with a file that exhibits the problem) if the latest version, available from this site:

       http://pornin.nerim.net/ucpp/

       has the bug.

                                                   Oct 21 2000                                           UCPP(1)