"Fossies" - the Fresh Open Source Software Archive

Member "evolution-brutus-1.2.35/docs/building_from_source" (13 May 2008, 7651 Bytes) of archive /linux/misc/old/evolution-brutus-1.2.35.tar.gz:


As a special service "Fossies" has tried to format the requested text file into HTML format (style: standard) with prefixed line numbers. Alternatively you can here view or download the uninterpreted source code file.

    1 
    2 
    3          ***   Building the Evolution Brutus Connector  ***
    4 
    5                Copyright (C) 2005-2007 OMC Denmark ApS
    6 
    7 
    8 Your rights
    9 ===========
   10 
   11 Copying and distribution of this file, with or without modification, 
   12 are permitted in any medium without royalty provided the copyright 
   13 notice and this notice are preserved.
   14                 
   15 
   16 How to build and install the Evolution Brutus Connector
   17 =======================================================
   18 
   19 The easy way
   20 ============
   21 
   22 Normally you would only need to do this:
   23 
   24     ./autogen.sh --prefix=/usr 
   25     make 
   26     make install (as root)
   27 
   28 
   29 The hard way
   30 ============
   31 
   32 This is how to build evolution-brutus and all of its dependencies. I'm 
   33 assuming that you want to build different versions than what are already
   34 installed in your system.
   35 
   36 Your first task is to ensure that you are working on a system with the 
   37 required software development packages installed. This guide is written 
   38 on the assumption that you want to compile the evolution-brutus build 
   39 and run prerequisites from Gnome Subversion and that your shell is Bash.
   40 
   41 Everything will be build from SVN and installed into "$HOME/opt". $HOME 
   42 is assumed to be "/home/$USER". Please adjust according to your own 
   43 environment if needed.
   44 
   45 The following are step-by-step instructions to build the evolution-brutus 
   46 requirements and evolution-brutus from source.
   47 
   48 Please refer to:
   49 
   50    http://www.go-evolution.org/Compiling_Evolution_from_CVS
   51 
   52 or
   53 
   54    http://www.go-evolution.org/Compiling_Evolution_from_SVN
   55 
   56 for more or less up-to-date documentation for building Evolution.
   57 
   58 
   59 Reporting problems
   60 ==================
   61 
   62 You can always help by reporting problems to <bugs@42tools.com> or preferably to
   63 the 42tools bugzilla: 
   64 
   65     <http://bugzilla.42tools.net/>
   66 
   67 or by subscribing to the brutus mailing list and posting your problem to the list:
   68 
   69    <http://www.42tools.com/mailman/listinfo/brutus/>
   70 
   71 evolution-brutus, if build with debugging support, will generate a nice log that 
   72 you are encouraged to attach to your problem report. To tell evolution-brutus to 
   73 generate the log just create a file named ".brutus-do-debug" in your home 
   74 directory. It doesn't need to be a regular file. It could be a directory or a 
   75 link.
   76 
   77 All log output will be appended to "~/.brutus-logd/brutus.log" by the Brutus Log 
   78 daemon. Please append this file to all bug reports and describe how to reproduce 
   79 the problem if possible.
   80 
   81 You can tell the log daemon to restart itself and start all over with an empty 
   82 log file. Just send SIGUSR2 to the log daemon:
   83 
   84       $ kill -s USR2 $(cat ~/.brutus-logd/brutus-logd.pid)
   85 
   86 But first you will have to build the source. Please read the remaining sections 
   87 on how to do just that.
   88 
   89 
   90 =========================================================================
   91 =                                                                       =
   92 =                         Build Instructions                            =
   93 =                                                                       =
   94 =========================================================================
   95 
   96 
   97 Bash environment
   98 ================
   99 
  100 * Fix ~/.bashrc:
  101     # Gnome
  102     WANT_AUTOCONF="2.5"
  103     export WANT_AUTOCONF
  104 
  105     PKG_CONFIG_PATH=/home/$USER/opt/lib/pkgconfig/
  106     export PKG_CONFIG_PATH
  107 
  108     ACLOCAL_FLAGS="-I /home/$USER/opt/share/aclocal"
  109     export ACLOCAL_FLAGS
  110 
  111     BONOBO_ACTIVATION_PATH=/home/$USER/opt/lib/bonobo/servers
  112     export BONOBO_ACTIVATION_PATH
  113 
  114     CVS_RSH=ssh
  115     export CVS_RSH
  116 
  117     LIBDIR="/home/$USER/opt/lib"
  118     export LIBDIR
  119 
  120     # Here you must insert the correct Evolution version number such as "2.12"
  121     EVOLIBS="/home/$USER/opt/lib/evolution/<EVOLUTION VERSION>/plugins"
  122     export EVOLIBS
  123 
  124     LD_LIBRARY_PATH="$EVOLIBS:$LIBDIR:$LD_LIBRARY_PATH"
  125     export LD_LIBRARY_PATH
  126 
  127     LD_RUN_PATH="$EVOLIBS:$LIBDIR:$LD_RUN_PATH"
  128     export LD_RUN_PATH
  129 
  130     PATH=/home/$USER/opt/bin:$PATH
  131     export PATH
  132 
  133     # Insane amounts of debug information
  134     ORBIT2_DEBUG=all
  135     export ORBIT2_DEBUG
  136 
  137     BRUTUS_DEBUG=yes
  138     export BRUTUS_DEBUG
  139 
  140     CAMEL_DEBUG=all
  141     export CAMEL_DEBUG
  142 
  143     SRC_DIR="/home/$USER/work/src/evolution-brutus"
  144     export SRC_DIR
  145 
  146 
  147 Get the source code
  148 ===================
  149 
  150 * Check out from SVN:
  151 
  152     svn co http://svn.42tools.com/repos/brutus-keyring/trunk brutus-keyring
  153     svn co http://svn.42tools.com/repos/evolution-brutus/trunk evolution-brutus
  154     svn co http://svn.gnome.org/svn/gnome-common/trunk gnome-common
  155     svn co http://svn.gnome.org/svn/libIDL/trunk libIDL
  156     svn co http://svn.gnome.org/svn/ORBit2/trunk ORBit2
  157     svn co http://svn.gnome.org/svn/evolution/trunk evolution
  158     svn co http://svn.gnome.org/svn/evolution-data-server/trunk evolution-data-server
  159     svn co http://svn.gnome.org/svn/gtkhtml/trunk gtkhtml
  160     svn co http://svn.gnome.org/svn/libsoup/trunk libsoup
  161 
  162     and optionally:
  163     
  164     svn co http://svn.gnome.org/svn/evolution-exchange/trunk evolution-exchange
  165 
  166 
  167 Compile and install the prerequisites
  168 =====================================
  169 
  170 * Install gnome-common:
  171     unset PKG_CONFIG_PATH
  172     unset ACLOCAL_FLAGS
  173     cd gnome-common
  174     ./autogen.sh --prefix=/home/$USER/opt
  175     make
  176     make install
  177     cd ..
  178     export PKG_CONFIG_PATH=/home/$USER/opt/lib/pkgconfig/
  179     export ACLOCAL_FLAGS="-I /home/$USER/opt/share/aclocal"
  180 
  181 * Install libIDL:
  182     cd libIDL
  183     ./autogen.sh --prefix=/home/$USER/opt
  184     make
  185     make install
  186     cd ..
  187 
  188 * Install ORBit2:
  189     cd ORBit2
  190     ./autogen.sh --prefix=/home/$USER/opt
  191     make
  192     make install
  193     cd ..
  194 
  195 * Install libsoup:
  196     cd libsoup
  197     ./autogen.sh --prefix=/home/$USER/opt
  198     make 
  199     make install
  200     cd ..
  201 
  202 * Install gtkhtml:
  203     cd gtkhtml
  204     ./autogen.sh --prefix=/home/$USER/opt
  205     make 
  206     make install
  207     cd ..
  208 
  209 * Install evolution-data-server (with Exchange enabled for comparison):
  210     cd evolution-data-server
  211     On Gentoo:
  212        CFLAGS="-ggdb -O1" ./autogen.sh --prefix=/home/$USER/opt --with-openldap=yes --with-exchange=yes --enable-nss=yes --with-nspr-includes=/usr/lib/mozilla/include/nspr --with-nspr-libs=/usr/lib/mozilla --with-nss-includes=/usr/lib/mozilla/include/nss --with-nss-libs=/usr/lib/mozilla --enable-gtk-doc
  213     On FC5: 
  214        CFLAGS="-ggdb -O1" ./autogen.sh --prefix=/home/$USER/opt --with-openldap=yes --with-exchange=yes --enable-nss=yes --with-nspr-includes=/usr/includes/nspr4 --enable-gtk-doc
  215     make
  216     make install
  217     cd ..
  218 
  219 * Install evolution (with Exchange enabled for comparison):
  220     cd evolution
  221     CFLAGS="-ggdb -O1" ./autogen.sh  --prefix=/home/$USER/opt  --with-openldap=yes  --enable-ipv6=yes  --enable-test-component=no  --disable-default-binary  --without-kde-applnk-path  --enable-mono=no --enable-exchange=yes --enable-plugins=base --enable-smime=yes --enable-nss=yes --with-nspr-includes=/usr/lib/mozilla/include/nspr --with-nspr-libs=/usr/lib/mozilla --with-nss-includes=/usr/lib/mozilla/include/nss --with-nss-libs=/usr/lib/mozilla --enable-gtk-doc
  222     make 
  223     make install
  224     cd ..
  225 
  226 * Optionally install evolution-exchange for comparison (Kerberos 5 or Heimdal is a prerequisite):
  227     cd evolution-exchange
  228     CFLAGS="-g -O0" ./autogen.sh --prefix=/home/$USER/opt 
  229     make 
  230     make install
  231     cd ..
  232 
  233 * Install brutus-keyring:
  234     cd $SRC_DIR/brutus-keyring
  235     ./autogen.sh --prefix=/home/$USER/opt --enable-brutus-devel=yes --enable-brutus-debug=yes
  236     make 
  237     make install
  238     cd ..
  239 
  240 
  241 evolution-brutus
  242 ================
  243 
  244 * Install evolution-brutus:
  245     cd $SRC_DIR/evolution-brutus
  246     ./autogen.sh --prefix=/home/$USER/opt --enable-brutus-devel=yes --enable-brutus-debug=yes --enable-brutus-spy=no
  247     make 
  248     make install
  249     cd ..
  250