Adapted to V4.6

build-howto.info

@@ -5,16 +5,23 @@ Written by: Robert Karlsson
 
 The following libraries (devel and runtime) are needed to build Proview:
 
-Berkeley DB (>= v4.0, recommended v4.3)
-antlr (v2.7.5 recommended )
-gtk2-devel (>= v2.4, recommended v2.8)
-alsa (>= 0.9.8, recommended v1.0.6)
+gcc
+g++
+make
+flex
+libgtk2.0-dev
+libdb4.6-dev  (Any Berkeley DB version > 4.3, on Fedora db4-devel)
+libdb4.6++-dev
+libasound2-dev (on Fedora alsa-lib-devel)
+doxygen
+libmysql++dev (optional)
+antlr (version 2.7.7)
+jdk
 
 Proview has been built with the follwing compilers:
 
-gcc v3.3.3
-gcc v3.4.3
-gcc v4.0.2
+gcc v4.3.2
+javac (jdk6)
 
 1. Preparations
 --------------
@@ -28,33 +35,36 @@ g++
 libgtk2.0-dev
 cpp
 libasound2-dev
-libdb4.3-dev
-libdb4.3++-dev
+libdb4.6-dev
+libdb4.6++-dev
 doxygen
+libmysql++-dev (optional)
 
-antlr: Download and build source package antlr-2.7.7 from www.antlr.org
-       On fedora configure with './configure --disable-csharp'.
-       copy includefiles from antlr-2.7.7/lib/cpp/antlr/* 
-       to /usr/include/antlr/
-
-java:  Download jdk-6u2-linux-i586.bin from java.sun.com. Define the 
+java:  Download jdk-6u10-linux-i586.bin from java.sun.com. Define the 
        environment variable jdk to the path where the package is 
        extracted (e.g. /usr/local) and put $jdk/bin in the PATH.
 
-	export jdk=/usr/local/jdk1.6.0_02
+	export jdk=/usr/local/jdk1.6.0_10
 	export PATH=$PATH:$jdk/bin
 
-There has to be a valid display.
+antlr: Download and build source package antlr-2.7.7 from www.antlr.org
+       On fedora configure with './configure --disable-csharp'.
+       Hints: 
+	- You may have to rename /usr/bin/jikes and /usr/bin/java 	
+          temporary during configure.
+        - Include <strings.h> in lib/cpp/antrl/CharScanner.hpp
+
+There has to be a valid display when building proview.
 
 2. Easy way
 -----------
 Unpack the source package
 
-> tar -xzvf pwrsrc_4.4.4.tar.gz
+> tar -xzvf pwrsrc_4.6.0.tar.gz
 
 Enter the sourcecode root directory
 
-> cd pwr_4.4.4
+> cd pwr_4.6.0
 
 Execute the makefile
 
@@ -76,8 +86,8 @@ handle different version of proview.
 The first thing to do is to set up your environment properly. Add the 
 following lines to .bashrc:
 
-# Where /home/robert/x4-4-4 is replaced with wherever you unpacked the sources.
-export pwre_bin="/home/robert/x4-4-4/pwr/src/tools/pwre/src/os_linux"
+# Where /home/robert/x4-6-0 is replaced with wherever you unpacked the sources.
+export pwre_bin="/home/robert/x4-6-0/pwr/src/tools/pwre/src/os_linux"
 export pwre_dir_symbols="$pwre_bin/dir_symbols.mk"
 source $pwre_bin/pwre_function
 export pwre_env_db="/home/robert/pwre_new"
@@ -93,13 +103,13 @@ by sourcing $pwre_bin/pwre_function).
 
 shows all possibilites with the pwre function.
 
-Add environment named 'x442x86' (choose any name you like).
+Add environment named 'x460x86' (choose any name you like).
 
-> pwre add x442x86
+> pwre add x460x86
 
-Source root [...] ? /home/robert/x4-4-4/pwr/src  (where /home/robert/x4-4-4 is
+Source root [...] ? /home/robert/x4-6-0/pwr/src  (where /home/robert/x4-6-0 is
 replaced with wherever you unpacked the sources)
-Build root [...] ? /home/robert/pwr/x4-4-4/rls_dbg  (choose typically .../pwr/version/rls_dbg)
+Build root [...] ? /home/robert/pwr/x4-6-0/rls_dbg  (choose typically .../pwr/version/rls_dbg)
 Build type [dbg] ? 
 OS [linux] ? 
 Hardware [x86] ?
@@ -109,13 +119,13 @@ list all existing environments:
 
 > pwre list
 -- Defined environments:
-   x442x86
+   x460x86
 --
 himBh
 
 Initiate your new environment:
 
-> pwre init x442x86
+> pwre init x460x86
 
 Now, create the build tree
 
@@ -153,9 +163,9 @@ To build all in current module
 
 > pwre build_all
 
-To build parts of current module (for example lib rt in kernel module)
+To build parts of current module (for example lib/rt/src in kernel module)
 
-> pwre build lib rt all	  (command syntax build 'branch' 'subbranch' ['phase'])
+> pwre build lib rt src	  (command syntax build 'branch' 'subbranch' ['phase'] ['flavour')
 
 Each of the modules have their own build tree. When finished your work in a
 specific module this must be merged to the common build tree. This is done
@@ -196,7 +206,7 @@ Copy some files to this directory (if they do not already exist)
 Create a file name pwr_projectlist.dat in this directory and add the following
 line to this file:
 
-%base X4.4.4	/home/robert/pwr/X4-4-4/rls_dbg
+%base X4.6.0	/home/robert/pwr/X4-6-0/rls_dbg
 
 where the path is your build-root ($pwre_broot).
 
@@ -207,3 +217,25 @@ source $pwra_db/pwr_setup.sh
 
 Voila, finished !
 
+
+Building Motif version
+----------------------
+If someone for some unfathomable reason wants to build the old motif version
+the following packages has to be installed
+
+libx11-dev
+libxt-dev
+libmotif-dev
+x11proto-print-dev
+libxmu-dev
+libxmp-dev
+libxp-dev
+
+build with 
+
+> pwre build_all_modules motif
+
+Start wb and motif with
+
+> wb_motif
+> rt_xtt_motif
\ No newline at end of file