[rkward-cvs] SF.net SVN: rkward: [2251] branches/KDE4_port

tfry at users.sourceforge.net tfry at users.sourceforge.net
Mon Nov 19 19:57:38 UTC 2007

Revision: 2251
Author:   tfry
Date:     2007-11-19 11:57:38 -0800 (Mon, 19 Nov 2007)

Log Message:
Add some compilation / installation instructions

Modified Paths:

Added Paths:

Modified: branches/KDE4_port/INSTALL
--- branches/KDE4_port/INSTALL	2007-11-19 15:33:59 UTC (rev 2250)
+++ branches/KDE4_port/INSTALL	2007-11-19 19:57:38 UTC (rev 2251)
@@ -1,41 +1,57 @@
 RKWard requires:
-- KDE-libraries and headers (>= 3.x) (http://www.kde.org)
-- Qt-libraries and headers (>= 3.x) (http://www.trolltech.com)
+- KDE-libraries and headers (>= 4.0) (http://www.kde.org)
+- Qt-libraries and headers (>= 4.3) (http://www.trolltech.com)
 - R and headers (http://www.r-project.org)
 - PHP with commandline-interface (http://www.php.net)
+- CMake (http://cmake.org)
 IMPORTANT: You will need to have the R shared library installed. This is typically located in a place like /usr/lib/R/lib/libR.so. Unfortunately, some distributions do not yet ship their R binary with the shared library. In those (rare) cases, you'll have to compile and install R on your own with the option --enable-R-shlib.
-Compilation / installation is basically just a
+Compilation can be done "in-source" or "out-of-source" (recommended).
-# ./configure
-# make
-# make install
+For an in-source build, do
+> cd path_to_rkward_sources
+> cmake . [options]		# see below
+> make
+> sudo make install
-and in 95% of the cases this should be all you need. Here are some ./configure options you may need to set in the other 5%:
+For an out-of-source build, do
+> mkdir build; cd build
+> cmake path_to_rkward_sources [options]	# see below
+> make
+> sudo make install
-defaults to 1) $KDEDIR or if that is not set 2) the output of "kde-config --prefix". If you have multiple versions of KDE installed, or need to specify the kde-directory for any other reason, you need to set this option explicitely.
+CMake options (configuring)
-One some systems you might also have to specify your qt (3) directory, passing the commandline-option
---with-qt-dir=/usr/lib/qt3			(or similar)
-to configure.
+The cmake command offers a number of parameters to control the build process. Some commonly needed are:
-The options
-can be used to configure the details of your R installation. Usually these settings should be detected automatically, but especially if you have several versions of R installed, these may be relevant. NOTE: --with-r-libdir does not refer to the location of the shared R library, but rather to where the rkward R package should be installed to. By default, the first entry in .libPaths () will be used, (typically something like /usr/lib/R/site-library), but in case you keep several dedicated library paths, this allows you to specify, which one to install to.
+	set the installation base directory. Generally -DCMAKE_INSTALL_PREFIX=$KDEDIR should be correct
+	type of build. Useful settings include -DCMAKE_BUILD_TYPE=Release and -DCMAKE_BUILD_TYPE=debugfull
+In some cases you may want to set the following options:
+	path to the R executable. You may want to set this, if you have multiple versions of R installed, or R is not in your path. Example -DR_EXECUTABLE=/usr/bin/R
+	directory where R packages should be installed. Generally, this option should not be needed.
+	R home directory. Almost certainly this option is not needed.
+	path to R include files. Almost certainly this option is not needed.
@@ -43,7 +59,7 @@
 As root run:
 # make install
-Make sure you have set the correct path in ./configure (the --prefix=... option)
+Make sure you have set the correct path in cmake (the -DCMAKE_INSTALL_PREFIX option)

Modified: branches/KDE4_port/NOTES
--- branches/KDE4_port/NOTES	2007-11-19 15:33:59 UTC (rev 2250)
+++ branches/KDE4_port/NOTES	2007-11-19 19:57:38 UTC (rev 2251)
@@ -1,6 +1,8 @@
 Notes about changes in RKWard that existing users need to adapt to:
 *** From 0.4.x to 0.5.0 ***
+- Versions of RKWard 0.5.0 or higher are designed for KDE 4, and cannot be used with KDE 3. For KDE 3 use the 0.4.x versions.
+- The build system was changed to CMake. Read INSTALL for details on how to build RKWard.
 - Due to clashes with kate default shortcuts, the shortcuts for Run->Run Line, Run Selection, and Run All were changed to Shift+F7, Shift+F8, Shift+F9, respectively.
 - The tabs in the main workplace view no longer have a close button that is shown when hovering the mouse over the respective icon. Rather, there is a single button to close the current tab, shown at the right of the tab bar.

Modified: branches/KDE4_port/TODO_KDE4
--- branches/KDE4_port/TODO_KDE4	2007-11-19 15:33:59 UTC (rev 2250)
+++ branches/KDE4_port/TODO_KDE4	2007-11-19 19:57:38 UTC (rev 2251)
@@ -1,6 +1,4 @@
-- message extraction
-- po file handling
 - test
 	- configuration
 		- R

Added: branches/KDE4_port/configure
--- branches/KDE4_port/configure	                        (rev 0)
+++ branches/KDE4_port/configure	2007-11-19 19:57:38 UTC (rev 2251)
@@ -0,0 +1,10 @@
+echo "
+RKWard now uses CMake (http://cmake.org) for compilation and installation.
+Please refer to the file INSTALL in this directory for details.
+If you need help, please check http://rkward.sourceforge.net/wiki/index.php?title=General_FAQ, or write to rkward-users AT lists DOT sourceforget DOT net.
\ No newline at end of file

Property changes on: branches/KDE4_port/configure
Name: svn:executable
   + *

This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site.

More information about the rkward-tracker mailing list