Installing from CVS

(this only applies to the KDE3 version)

What's CVS ?

CVS is a means for you to get the latest bleeding edge sources that the developers are working on. This 'snapshot' of the developers code may not work or even compile but is the best way to see the new features available and can even save time when getting newer versions.

We also maintain a branch of the stable version on CVS. This allows you to have access to fixes prior to the release of a new tar-ball version. Changes on the stable branch are tested thoroughly by the developers and we take great care that this version of the application compiles.

To get the latest sources you instruct your local copy of cvs to connect to a server and download the sources. Once these sources have been downloaded you are able to compile the project and then run it as usual. When you next need to get the sources you can just download the changed files by instructing cvs to only download the files that have changed. The central server is called repository and your local copy is called sandbox.

If you don't specify a specific branch or version during the initial checkout, you will retrieve the bleeding edge sources which we refer to as CVS HEAD. In order to get the stable source branch, you will have to supply a release tag when you initially get the sources. Currently this tag is rel-0-8-branch and we refer to it as the 0.8 branch. When you later update your sandbox, there is no need to specify this tag anymore.


Sounds good, how do I get the source to KMyMoney?

Move into a directory where you wish to store the kmymoney source directory and type the following:

cvs -d:pserver:anonymous@kmymoney2.cvs.sourceforge.net:/cvsroot/kmymoney2 login

The password is empty, so just hit RETURN if asked for the password.

After anonymously logging in type:

cvs -z8 -d:pserver:anonymous@kmymoney2.cvs.sourceforge.net:/cvsroot/kmymoney2 co kmymoney2

After the initial checkout of the sources, you can change into the kmymoney2 directory and execute cvs commands without the -d option. For example:

cvs update

because the local cvs software will know the remote machine from the CVS sub-directory within the current directory.

As mentioned, KMyMoney uses different branches for the stable and development versions. Here is the initial command to check out the stable 0.8 branch of the application.

cvs -z8 -d:pserver:anonymous@kmymoney2.cvs.sourceforge.net:/cvsroot/kmymoney2 co -r rel-0-8-branch kmymoney2

Please see the project handbook for detailed information on how to use CVS and branches.


Is there a Web interface to CVS ?

Yes and you can find it at http://cvs.sourceforge.net/cgi-bin/viewcvs.cgi/kmymoney2 or by clicking on the navigation bar link to the left of the screen.


Yes and you can find it at http://kmymoney2.cvs.sourceforge.net/kmymoney2/ or by clicking on the navigation bar link to the left of the screen.

How do I build the sources from CVS ?

To build the sources from CVS you must first build the configure program. To do this type:

  make -f Makefile.dist

in the top kmymoney directory. The configure program is now built and you can build as normal by typing:

  ./configure  --prefix=[your kde dir] --with-qt-dir=[your qt3 dir]
  make
  su
  make install
  exit

Usually, it's not necessary to specify any options. More instructions about the options can be found in the README file.

Don't forget you can use ./configure --help to get information on the available options.

Kconfigure is also available to provide a one click interface to building software and you can find this program at kconfigure.sourceforge.net.

How to update your CVS version ?

First, uninstall previous CVS version :

  su
  make uninstall
  make clean
  exit

Then, you can update sources : (be sure to include the '-d' option in case new directories were added)

  cvs up -d

Now recompile the whole application :

  make -f Makefile.dist
  ./configure  --prefix=[your kde dir] --with-qt-dir=[your qt3 dir]
  make
  su
  make install
  exit