CMAKE help and hints
--------------------------------------------------------------
There is an alternative build method since the TOra's Qt4 port.
You can use cmake for it (cmake.org).

Standard usage is very similar to configure/make/make install:
cmake [options] build_dir

where "build_dir" can be e.g.: . for TOra source root directory
or manually created directory to keep build files out of SVN copy.

Make targets:
 * make
 * make install
 * make dist

Options:

Cmake installs TOra into /usr/local as default. You can change it
for your location:
-DCMAKE_INSTALL_PREFIX:PATH=/home/username/toradevelopment
If you want to set special paths for help files or whatever see
"Paths for installation" below.

Note for Windows: if you don't specify install prefix, you can get
compile-time errorrs in some cases. It looks like some MSVC
environments don't like spaces in its default paths
(C:\Program oieeek, error here).


Enable compilation with debugging symbols:
-DWANT_DEBUG=1


TOra requires QScintilla2. QScintilla2 is the new Qt4 pord of old
Qt3 release with new API. It's strongly recomended to use standalone
package of QScintilla2. Unfortunatelly it's sometimes missing in
older distros. You can use TOra internal copy of QScintilla2 with:
-DWANT_INTERNAL_QSCINTILLA=1


TOra can be built against various Oracle clients. Some clients
(e.g. instant-client) do not provide ORACLE_HOME settings. Cmake will
warn you in this case so you can specify required paths manually:
-DORACLE_PATH_INCLUDES=/usr/include/oracle/10.2.0.3/client
-DORACLE_PATH_LIB=/usr/lib/oracle/10.2.0.3/client/lib


You have to specify -DORACLE_OCI_VERSION for one of values:
[8, 8I, 9I, 10G, 10G_R2]. Example:
-DORACLE_OCI_VERSION=10G_R2

You can switch off Oracle support with:
-DENABLE_ORACLE=0


TOra requires PostgreSQL development environment to enable
full PgSQL support (native cancel etc.).
This environment shoud be found automatically on UNIXes. But you can
specify path for alternative location and/or for Windows too.
-DPOSTGRESQL_PATH_INCLUDES=/home/devel/pgsql/include
-DPOSTGRESQL_PATH_INCLUDES=d:\pgsql\include
-DPOSTGRESQL_PATH_LIB=/home/devel/pgsql/lib
Windows note: Sometimes (dunno why) it doesn't find pgsql libs.
              You can use "set LIB=%LIB%;pathtopgsqllibs" then.
etc.
Native PostgreSQL support can be disabled with:
-DENABLE_PGSQL=0


TOra allows to be built as "bundle" application on Mac OS X.
-DWANT_BUNDLE=1
The bundle will be created in the CMAKE_INSTALL_PREFIX. The bundle
will contain all dependencies (Qt libs, DB clients libs etc.).
If there is WANT_BUNDLE specified, it can be set not to pack
all required libraries into the bundle location with:
-DWANT_BUNDLE_STANDALONE=1


Search following for more info:
http://cmake.org
http://docs.scribus.net/index.php?lang=en&page=install4


Paths for installation
The base install prefix is set with -DCMAKE_INSTALL_PREFIX (see above).
You can specify installation of additional files with some variables.
Changing these variables will affects TOra compilation too.
List of the settings:
-DTORA_PLUGIN_DIR=path
    It sets the path for functionality addons (binary plugins (if it's
    used) or template description files etc.)
    The default value is CMAKE_INSTALL_PREFIX/share/tora
-DTORA_DOC_DIR=path
    It sets the path for basic system-wide documentation fles (README,
    AUTHORS, LICENSE etc.). It is not read by anybody propably but it's
    pretty standard for Linux packages ;)
    The default value is CMAKE_INSTALL_PREFIX/share/doc/tora
-DTORA_HELP_DIR=path
    It sets the location of help files (manual and API docs).
    The default value is TORA_PLUGIN_DIR/help