1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120
|
RapidSVN
INTRODUCTION
RapidSVN is a cross-platform GUI front-end for the Subversion revision system
(http://subversion.tigris.org/) written in C++ using the wxWindows GUI
framework. It is distributed under the Apache Software License, Version 1.1.
See LICENSE.txt for more details.
Currently it compiles under Windows and it does so with Linux but there are a
few runtime issues that are currently being worked out. Eventually this
should run on the Mac and several other flavors of *NIX.
WHY WXWINDOWS?
Many of you are probably curious why we would choose wxWindows as the platform
in which to build this project. Since the beginning the goal of Subversion
was to build a client that would improve source control for operating system
platform. By using the Apache Portable Runtime and a load of #ifdef's this
goal has been effectively accomplished. With RapidSVN we would like to
continue this theme.
In order to get people to transfer over to product to make it easier the
program should conform to whatever platform they are using. wxWindows is the
perfect platform for this. It uses GDI on Windows so the Windows guys never
even think for a second that they are using a non-Windows tool and GTK for
all the Unix guys. There is even an effort to use QT as well. This makes
the best of both worlds without messing with a person's personal
environment.
For developers wxWindows is great. It is easy to learn and quite powerful for
any platform. It made the choice easy.
BUILDING AND INSTALLING
* The RapidSVN source code is stored in a Subversion repository (of course!)
so in order to get it code you have to download a svn client from the
Subversion project page:
http://subversion.tigris.org/servlets/ProjectDocumentList
* Download the source code for RapidSVN. You can do this by running the
following svn command:
% svn co http://svn.collab.net/repos/rapidsvn/trunk rapidsvn
* Download the wxWindows 2.3.3 (or >= 2.4.0) libraries: http://www.wxwindows.org/
If you are building wxWindows on linux, you will need to specify
the --disable-no-exceptions parameter to configure (see
http://www.wxwindows.org/faqgen.htm#exceptions). For development
you will probably also want --enable-debug.
* Download the latest Subversion source tree. Here are the directions:
http://subversion.tigris.org/project_source.html
* Once you have Subversion the download all the files just as the directions in
the Subversion INSTALL file so you have the directory structure below. Note:
the db4-win32 directory name is for MS VC++.
/subversion
/apr (apache.org CVS)
/apr-iconv (apache.org CVS)
/apr-util (apache.org CVS)
/db4-win32 (http://www.sleepycat.com/)
/neon (from http://www.webdav.org/neon/)
/rapidsvn
* If you are running Windows and you have dependency problems like a missing
shfolder.lib then your system very likely does not have the necessary files.
In this case you can get them by downloading the MS Platform SDK from
http://www.microsoft.com/msdownload/platformsdk/sdkupdate/ by
choosing Core SDK. Watch out though, because the download is
enormous, around 400 MB. It would be best if you just got this from
an MSDN CD if possible.
If you have the cvs client installed on your machine then you can download the
apr libraries with the following commands:
% cvs -d :pserver:anoncvs@cvs.apache.org:/home/cvspublic co apr
% cvs -d :pserver:anoncvs@cvs.apache.org:/home/cvspublic co apr-util
% cvs -d :pserver:anoncvs@cvs.apache.org:/home/cvspublic co apr-iconv
* Two environmental variables must be set as well:
SUBVERSION - SVN libraries root directory
WX - wxWindows libraries directory
On Windows you can add the following to autoexec.bat or through the
Environmental Variables editor.
set WX=C:\Program Files\wx2
set SUBVERSION=D:\dev\subversion
BUILDING ON LINUX/UNIX
* Download all of the Subversion code and build it. Note: it is much easier if
you download the RPMs provided on the Subversion site:
http://subversion.tigris.org/servlets/ProjectDocumentList
* Download the source code for RapidSVN. You can do this by running the
following svn command:
% svn co http://svn.collab.net/repos/rapidsvn/trunk rapidsvn
* Go to the rapidsvn directory and run:
% ./autogen.sh
% ./configure
* The configure script might complain about apps/paths it didnt find
% ./configure --help
will return a list of options you might want to set-
* Then go to the src/ directory and run 'make'
* If it is built and you get an error like 'could not find something.so' then
you probably need to add the Apache lib directory into /etc/ld.so.conf and
then run 'ldconfig'. This is especially true for newer versions of APR.
If you dont want to touch ld.so.conf you can add the path to the environment
variable "LD_LIBRARY_PATH".
Example: export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/usr/local/apr/lib
* If you get strange segmentation faults after updating or after change
some of the code: try to rebuild rapidsvn (make clean; make all).
|