[rkward-cvs] SF.net SVN: rkward:  branches/KDE4_port
tfry at users.sourceforge.net
tfry at users.sourceforge.net
Mon Nov 19 19:57:38 UTC 2007
Date: 2007-11-19 11:57:38 -0800 (Mon, 19 Nov 2007)
Add some compilation / installation instructions
--- 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 @@
-- 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).
-# make install
+For an in-source build, do
+> cd path_to_rkward_sources
+> cmake . [options] # see below
+> 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
+> 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)
+The cmake command offers a number of parameters to control the build process. Some commonly needed are:
-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)
--- 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.
--- 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
--- branches/KDE4_port/configure (rev 0)
+++ branches/KDE4_port/configure 2007-11-19 19:57:38 UTC (rev 2251)
@@ -0,0 +1,10 @@
+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
This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site.
More information about the rkward-tracker