icompile [--doc] [--opt|--debug] [--clean] [--version]
[--config ] [--verbosity n]
[--help] [--noprompt [--template ]] [--info]
[--run|--gdb ...]
iCompile can build most C++ projects without options or manual
configuration. Just type 'icompile' with no arguments. Run in an
empty directory to generate a set of starter files.
Options:
--doc Generate documentation before building.
--debug (Default) Create a debug executable (define _DEBUG,
disable optimizations).
--opt or -O Generate an optimized executable.
--run Run the program if compilation succeeds, passing all
further arguments (...) to the program.
--config Use instead of ~/.icompile as the user configuration
file. This allows you to build certain projects with
a different compiler or include paths without changing the
project ice.txt file, e.g., when installing a 3rd party library
--gdb Run the program under gdb if compilation succeeds,
passing all further arguments (...) to the program.
You can also just run gdb yourself after using iCompile.
--verbosity n Change the amount of information printed by icompile
n | Result
----|---------------------------------------------------
0 | Quiet: Only errors and prompts are displayed.
|
1 | Normal (Default): Filenames and progress information
| are also displayed
2 | Verbose: Executed commands are also displayed
|
3 | Trace: Additional debugging information is also
| displayed.
--noprompt Run even if there is no ice.txt file, don't prompt the
user for input. This is handy for launching iCompile
from automated build shell scripts. If
--template is specified as well, a default
set of files will be built. The only legal templates
are 'hello', 'G3D', and 'empty' (default).
--info Read configuration files and command line options, but instead
of building, print out information about where the generated
file will go.
Exclusive options:
--help Print this information.
--clean Delete all generated files (but not library generated files).
--version Print the version number of iCompile.
Special directory names:
build Output directory
data-files Files that will be needed at runtime
doc-files Files needed by your documentation (Doxygen output)
iCompile will not look for source files in directories matching: ['^\\.', '^#', '~$', '^\\.svn$', '^CVS$', '^Debug$', '^Release$', '^graveyard$', '^tmp$', '^temp$', '^doc-files$', '^data-files$', '^\\.icompile-temp$', '^\\.ice-tmp$', '^build$']
You may edit ice.txt and ~/.icompile if your project has unusual configuration
needs. See manual.html or http://ice.sf.net for full information.
hello/ |-- main.cpp CPP and H files may be at the top level | or in subdirectories. |--
build/ |--