You are viewing a plain text version of this content. The canonical link for it is here.
Posted to site-cvs@tcl.apache.org by mx...@apache.org on 2017/10/28 20:34:29 UTC
svn commit: r1813658 - in /tcl/rivet/trunk: ChangeLog doc/xml/cmake.xml
doc/xml/installation.xml doc/xml/internals.xml
Author: mxmanghi
Date: Sat Oct 28 20:34:29 2017
New Revision: 1813658
URL: http://svn.apache.org/viewvc?rev=1813658&view=rev
Log:
* docs/xml/cmake.xml: draft manual page for cmake build system
Modified:
tcl/rivet/trunk/ChangeLog
tcl/rivet/trunk/doc/xml/cmake.xml
tcl/rivet/trunk/doc/xml/installation.xml
tcl/rivet/trunk/doc/xml/internals.xml
Modified: tcl/rivet/trunk/ChangeLog
URL: http://svn.apache.org/viewvc/tcl/rivet/trunk/ChangeLog?rev=1813658&r1=1813657&r2=1813658&view=diff
==============================================================================
--- tcl/rivet/trunk/ChangeLog (original)
+++ tcl/rivet/trunk/ChangeLog Sat Oct 28 20:34:29 2017
@@ -1,3 +1,6 @@
+2017-10-28 Massimo Manghi <mx...@apache.org>
+ * docs/xml/cmake.xml: draft manual page for cmake build system
+
2017-10-22 Massimo Manghi <mx...@apache.org>
* rivet/init.tcl.in: Following Jeff Lawson's suggestion we check
if init.tcl is loaded from within mod_rivet. If we're not running
Modified: tcl/rivet/trunk/doc/xml/cmake.xml
URL: http://svn.apache.org/viewvc/tcl/rivet/trunk/doc/xml/cmake.xml?rev=1813658&r1=1813657&r2=1813658&view=diff
==============================================================================
--- tcl/rivet/trunk/doc/xml/cmake.xml (original)
+++ tcl/rivet/trunk/doc/xml/cmake.xml Sat Oct 28 20:34:29 2017
@@ -0,0 +1,41 @@
+<section id="cmake">
+ <title>Building Rivet &version; with CMake</title>
+ <section>
+ <para>
+ With this version Rivet has adopted <ulink href="http://cmake.org/">CMake</ulink>
+ as an alternate build system. The choice of introducing also CMake was motivated by the
+ need of an easy to use and reliable build system for Windows installations. Nonetheless the usability of
+ CMake is by no means restricted to that OS and user familiar with this alternative can
+ adopt it to build mod_rivet also on Linux and other systems. The current CMake script
+ requires CMake 3.2 or later. The <ulink href="https://cmake.org/documentation/">CMake documentation</ulink>
+ page has a complete reference of CMake features
+ </para>
+ <title>CMake build procedure and examples</title>
+ <para>Before running the build script cd into the cmake directory
+ <programlisting>cd cmake</programlisting>
+ </para>
+ <para>With default arguments run the following sequence of commands that prepare the build directory
+ build the code and install the binary and application library
+ <programlisting>cmake -E make_directory build
+cmake -E chdir build cmake ..
+cmake --build build --target all --clean-first
+cmake --build build --target install</programlisting>
+ </para>
+ <para>
+ Installation on a Windows system with using a custom installation of the Apache HTTP web server
+ <programlisting>cmake -E make_directory build
+cmake -E chdir build cmake -DAPACHE_ROOT=G:/Apache24 ..
+cmake --build build --config Release --target install</programlisting>
+ </para>
+ <para>
+ Building rivet on Windows with a 64 bit build of Apache requires specific
+ directives to the Microsoft C compiler
+ <programlisting>cmake -E make_directory build_64
+cmake -E chdir build_64 cmake -DAPACHE_ROOT=G:/Apache24 -G "Visual Studio 15 2017 Win64" ..
+cmake --build build_64 --config Release --target install</programlisting>
+ -G "..." can be set to any of the available 64-bit generators available under the platform
+ depending on your Windows version and Apache build
+ </para>
+ </section>
+</section>
+
Modified: tcl/rivet/trunk/doc/xml/installation.xml
URL: http://svn.apache.org/viewvc/tcl/rivet/trunk/doc/xml/installation.xml?rev=1813658&r1=1813657&r2=1813658&view=diff
==============================================================================
--- tcl/rivet/trunk/doc/xml/installation.xml (original)
+++ tcl/rivet/trunk/doc/xml/installation.xml Sat Oct 28 20:34:29 2017
@@ -1,5 +1,5 @@
<section id="installation">
- <title>Apache Rivet Installation</title>
+ <title>Apache Rivet &version; Installation</title>
<procedure>
<para>
Rivet &version; runs with the Apache 2.2.x and 2.4.x HTTP web servers.
Modified: tcl/rivet/trunk/doc/xml/internals.xml
URL: http://svn.apache.org/viewvc/tcl/rivet/trunk/doc/xml/internals.xml?rev=1813658&r1=1813657&r2=1813658&view=diff
==============================================================================
--- tcl/rivet/trunk/doc/xml/internals.xml (original)
+++ tcl/rivet/trunk/doc/xml/internals.xml Sat Oct 28 20:34:29 2017
@@ -1,4 +1,4 @@
-<!-- $ Id: $ -->
+<!-- $Id: $ -->
<section id="internals">
<title>Rivet Internals</title>
---------------------------------------------------------------------
To unsubscribe, e-mail: site-cvs-unsubscribe@tcl.apache.org
For additional commands, e-mail: site-cvs-help@tcl.apache.org