NAME
occ − OpenC++ compiler
SYNOPSIS
occ [
-g ] [ -M option=value ]
[ -l ] [ -S metaclass ] [ -s ] [
-V ] [ -v ] [ -w ]
[ -n ] [ -p ] [ -E ] [ -c ] [
-P ] [ -m file_name ]
[ -I directory ] [ -D
name=def ] [ -d option ]
[ -C ]
[ --regular-c++ ]
[ -- C++ compiler options ]
source_file
DESCRIPTION
occ applying a meta-level program to an OpenC++ program, and compiles the result program.
Full documentation can be found in /usr/share/doc/openc++.
OPTIONS
MAIN OPTIONS
|
-g |
Produce debugging information. |
-M option=value
Specify an option with value. It is passed to metaobjects.
|
-l |
Print the list of statically loaded metaclasses. |
-S metaclass
Load a metaclass.
|
-s |
Print the whole parse tree of the given source program. Don’t perform translation or compilation. If no source file is given, occ reads from the standard input. | ||
|
-V |
Show the version number. | ||
|
-v |
Specify the verbose mode. | ||
|
-w |
Enable wide characters support. |
BUILDING STAGES OPTIONS
|
-n |
Suppress invoking the preprocessor. | ||
|
-p |
Stop after the parsing stage. No translation is done. | ||
|
-E |
Don’t run the back-end C++ compiler. Stop after generating a .ii file. | ||
|
-c |
Suppress linking and produce a .o file. | ||
|
-P |
Preprocess again after translation. |
-m file_name
Produce a shared library (a .so file). This is used to compile a metaclass. If file_name is specified, the name of the shared library is file_name.so. If the -c option is specified together, occ produces a .so file, which should be linked by the user to be a shared library.
PREPROCESSOR
OPTIONS
-I directory
Add a directory to the search path of the #include directive.
-D name=def
Define a macro name as def.
-d option
Specify a preprocessor option
|
-C |
Don’t discard comments |
OTHER
OPTIONS
--regular-c++
Inhibit the extended syntax. This enables the keyword metaclass to be used as a variable name. This option is useful when parsing legacy code being not intended to translation. When this option is used, the symbol __opencxx is not defined.
|
-- |
The following options are interpreted as options for the back-end C++ compiler. For example, if you type: |
% occ -I.. -- -g foo.c
Then the -g option is passed to the C++ compiler. Note that these options are not passed to the C++ preprocessor. The -D and -I options need to be placed before --.
FILES
file.{cc,C,c,cpp,cxx,mc} source file.
file.occ output file after C++ preprocessing.
file.ii output file after translation.
file.o object file.
file.so shared library dynamically loaded by occ.
/usr/lib/libocc.so library to link with meta-level program.
NOTES
While the C++ processor is running, the macro __opencxx is predefined.
The programs compiled by occ do not need any runtime libraries or a garbage collector unless the meta-level program requires them at the base level.
COPYRIGHT
Copyright (C) 1997, 1998 Shigeru Chiba. All Rights Reserved.
Copyright (C) 1995, 1996 Xerox Corporation. All Rights Reserved.
AUTHOR
OpenC++ was initially written by Shigeru Chiba<chiba [AT] is.jp>, University of Tsukuba, Japan. It is now further developped by a Grzegorz Jakacki <jakacki [AT] hed.cn> and other people.
This manpage was initially written by John Lapeyre for the Debian GNU/Linux openc++ package, and was later reformated and updated by Yann Dirson.