~ubuntu-branches/ubuntu/wily/tora/wily-proposed

« back to all changes in this revision

Viewing changes to README.CMAKE

  • Committer: Bazaar Package Importer
  • Author(s): Michael Meskes
  • Date: 2009-04-07 13:16:05 UTC
  • mfrom: (1.2.7 upstream) (3.1.3 sid)
  • Revision ID: james.westby@ubuntu.com-20090407131605-u422yigfv7jgg0l0
Tags: 2.0.0-3
* Cleaned up packaging a little bit.
* Added homepage information to control file.
* Bumped Standards-Version to 3.8.1.
* Released to unstable.

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
CMAKE help and hints
 
2
--------------------------------------------------------------
 
3
There is an alternative build method since the TOra's Qt4 port.
 
4
You can use cmake for it (cmake.org).
 
5
 
 
6
Standard usage is very similar to configure/make/make install:
 
7
cmake [options] build_dir
 
8
 
 
9
where "build_dir" can be e.g.: . for TOra source root directory
 
10
or manually created directory to keep build files out of SVN copy.
 
11
 
 
12
Options:
 
13
 
 
14
Cmake installs TOra into /usr/local as default. You can change it
 
15
for your location:
 
16
-DCMAKE_INSTALL_PREFIX:PATH=/home/username/toradevelopment
 
17
If you want to set special paths for help files or whatever see
 
18
"Paths for installation" below.
 
19
 
 
20
Note for Windows: if you don't specify install prefix, you can get
 
21
compile-time errorrs in some cases. It looks like some MSVC
 
22
environments don't like spaces in its default paths
 
23
(C:\Program oieeek, error here).
 
24
 
 
25
 
 
26
Enable compilation with debugging symbols:
 
27
-DWANT_DEBUG=1
 
28
 
 
29
 
 
30
TOra requires QScintilla2. QScintilla2 is the new Qt4 pord of old
 
31
Qt3 release with new API. It's strongly recomended to use standalone
 
32
package of QScintilla2. Unfortunatelly it's sometimes missing in
 
33
older distros. You can use TOra internal copy of QScintilla2 with:
 
34
-DWANT_INTERNAL_QSCINTILLA=1
 
35
 
 
36
 
 
37
TOra can be built against various Oracle clients. Some clients
 
38
(e.g. instant-client) do not provide ORACLE_HOME settings. Cmake will
 
39
warn you in this case so you can specify required paths manually:
 
40
-DORACLE_PATH_INCLUDES=/usr/include/oracle/10.2.0.3/client
 
41
-DORACLE_PATH_LIB=/usr/lib/oracle/10.2.0.3/client/lib
 
42
 
 
43
 
 
44
You have to specify -DORACLE_OCI_VERSION for one of values:
 
45
[8, 8I, 9I, 10G, 10G_R2]. Example:
 
46
-DORACLE_OCI_VERSION=10G_R2
 
47
 
 
48
 
 
49
TOra requires PostgreSQL development environment to enable
 
50
full PgSQL support (native cancel etc.).
 
51
This environment shoud be found automatically on UNIXes. But you can
 
52
specify path for alternative location and/or for Windows too.
 
53
-DPOSTGRESQL_PATH_INCLUDES=/home/devel/pgsql/include
 
54
-DPOSTGRESQL_PATH_INCLUDES=d:\pgsql\include
 
55
-DPOSTGRESQL_PATH_LIB=/home/devel/pgsql/lib
 
56
Windows note: Sometimes (dunno why) it doesn't find pgsql libs.
 
57
              You can use "set LIB=%LIB%;pathtopgsqllibs" then.
 
58
etc.
 
59
 
 
60
 
 
61
Search following for more info:
 
62
http://cmake.org
 
63
http://docs.scribus.net/index.php?lang=en&page=install4
 
64
 
 
65
 
 
66
Paths for installation
 
67
The base install prefix is set with -DCMAKE_INSTALL_PREFIX (see above).
 
68
You can specify installation of additional files with some variables.
 
69
Changing these variables will affects TOra compilation too.
 
70
List of the settings:
 
71
-DTORA_PLUGIN_DIR=path
 
72
    It sets the path for functionality addons (binary plugins (if it's
 
73
    used) or template description files etc.)
 
74
    The default value is CMAKE_INSTALL_PREFIX/share/tora
 
75
-DTORA_DOC_DIR=path
 
76
    It sets the path for basic system-wide documentation fles (README,
 
77
    AUTHORS, LICENSE etc.). It is not read by anybody propably but it's
 
78
    pretty standard for Linux packages ;)
 
79
    The default value is CMAKE_INSTALL_PREFIX/share/doc/tora
 
80
-DTORA_HELP_DIR=path
 
81
    It sets the location of help files (manual and API docs).
 
82
    The default value is TORA_PLUGIN_DIR/help