====== Psi+ on Fedora Linux ======

=====  Psi+ Build Instructions =====


==== Installing required packages for build ====

<code>
$yum install gcc gcc-c++ libgcc qt-devel -y
</code>

==== Installation of GIT utility for download Psi source code ====

<code>
$yum install git -y
</code>

==== Create a folder for building process ====

<code>
$mkdir ~/psi-dev
</code>

==== Downloading the source code from the Psi GIT repository ====

<code>
$cd ~/psi-dev
$git clone git://git.psi-im.org/psi.git psi
$cd psi
$git submodule init
$git submodule update
$git pull
$git submodule update
</code>

==== Applying Patches ====

<code>
$cd ~/psi-dev
$svn co http://psi-dev.googlecode.com/svn/trunk/patches/
$cp ~/psi-dev/patches/*diff ~/psi-dev/psi
$cd ~/psi-dev/psi
$cat *.diff|patch -p1
</code>

==== Assigning revision number ====

(Except in the version information will be Psi + 0.15.xxx)

<code>
$pkgrel=`svnversion "home/$USER/psi-dev/patches"`
$cd src
$sed "s/\(.xxx\)/.${pkgrel}/" -i "applicationinfo.cpp"
</code>

==== Compiling source code and configuration ====

<code>
$cd ~/psi-dev/psi
$qconf
$./configure --enable-plugins --enable-qtwebkit
</code>

=== Build options ===

  * --enable-plugins - plugins support
  * --enable-qtwebkit - support for animated emoticons

Type this for see all other options:

<code>
$./configure --help
</code>

If the configuration is successful then in the end we see:

<code>
Good, your configure finished. Now run /usr/bin/gmake.
</code>

If it so then proceed to the compilation.



==== Compilation ====

<code>
$make
</code>

If the compilation done without errors then proceed to install.


==== Installation ====

<code>
$su -c ' make install'
</code>


===== Installing additional components =====

==== Emoticons and iconsets for Psi+ ====

  * At the installation stage:

<code>
$cd ~/psi-dev/psi
$svn co --force http://psi-dev.googlecode.com/svn/trunk/iconsets/ iconsets
</code>

or

  * After installation:

<code>
$cd /usr/share/psi/
$svn co --force http://psi-dev.googlecode.com/svn/trunk/iconsets/ iconsets
</code>

If the iconsets does not appear then copy the **/usr/local/share/psi/** .

==== Psi+ Plugins ====

Before the build plugin you must comply with paragraphs 1-5 of the basic instructions and at the same time fulfill:

<code>
$mkdir /usr/share/psi/plugins
</code>

Then download the source code of plugin (look at the example of Stop Spam Plugin):

<code>
$cd ~/psi-dev/psi/src/plugins/generic/
$svn co http://psi-dev.googlecode.com/svn/trunk/generic/stopspamplugin
$cd stopspamplugin/
$qmake-qt4
$make
$cp lib*.so /usr/share/psi/plugins/
</code>

__**Note**__: Do not forget to add the option **-- enable-plugins** before build.

If the plugin does not appear in Psi+ then run the following command:

<code>
$cp lib*.so /usr/local/share/psi/plugins/
</code>




==== Russian localization ====

<code>
$cd /usr/share/psi
$wget http://psi-ru.googlecode.com/svn/branches/psi-plus/psi_ru.qm
$wget http://psi-ru.googlecode.com/svn/branches/psi-plus/psi_ru.ts
</code>

If you need to install Russian localization only for myself then put the files in **~/.psi**, instead **/usr/...**

===== Automatic script for Psi+ building =====

This script will automatically build Psi+ with iconsets and emoticons

<code>
#!/bin/sh
mkdir ~/psi-dev
cd ~/psi-dev
git clone git://git.psi-im.org/psi.git
cd psi
git submodule init
git submodule update
git pull
git submodule update
cd ~/psi-dev
svn co http://psi-dev.googlecode.com/svn/trunk/patches/
cp ~/psi-dev/patches/*diff ~/psi-dev/psi
cd ~/psi-dev/psi
cat *.diff|patch -p1
pkgrel=`svnversion "home/$USER/psi-dev/patches"`
cd src
sed "s/\(.xxx\)/.${pkgrel}/" -i "applicationinfo.cpp"
cd ..
svn co --force http://psi-dev.googlecode.com/svn/trunk/iconsets/ iconsets
./configure
make
make install
</code>