see Changelog

Author: Koen Deforche

CMakeLists.txt

@@ -23,6 +23,7 @@ SET(WTISAPI_SOVERSION 7)
 SET(WTDBO_SOVERSION 30)
 SET(WTDBOSQLITE3_SOVERSION 30)
 SET(WTDBOPOSTGRES_SOVERSION 30)
+SET(WTDBOFIREBIRD_SOVERSION 30)
 SET(WTTEST_SOVERSION 1)
 
 IF(NOT SHARED_LIBS)
@@ -94,6 +95,7 @@ OPTION(ENABLE_PANGO "Enable Pango Library, which is used for improved font suppo
 OPTION(ENABLE_EXT "Build Wt Ext library with JavaScript-only widgets (http://extjs.com/)" ON)
 OPTION(ENABLE_SQLITE "Build SQLite3 backend for Wt::Dbo" ON)
 OPTION(ENABLE_POSTGRES "Build PostgreSQL backend for Wt::Dbo" ON)
+OPTION(ENABLE_FIREBIRD "Build FirebirdSQL backend for Wt::Dbo (requires both Firebird and IBPP)" ON)
 OPTION(ENABLE_QT4 "Build Qt4 interworking library (libwtwithqt" ON)
 OPTION(WT_NO_STD_LOCALE "Build Wt to run on a system without std::locale support" OFF)
 OPTION(WT_NO_STD_WSTRING "Build Wt to run on a system without std::wstring support" OFF)
@@ -124,6 +126,7 @@ IF(NOT SHARED_LIBS)
   SET(WTDBO_STATIC true)
   SET(WTDBOSQLITE3_STATIC true)
   SET(WTDBOPOSTGRES_STATIC true)
+  SET(WTDBOFIREBIRD_STATIC true)
 ENDIF(NOT SHARED_LIBS)
 
 IF(NOT MULTI_THREADED)
@@ -220,6 +223,10 @@ SET(FCGI_PREFIX ${USERLIB_PREFIX} CACHE PATH
   "Installation prefix of fcgi library (overrides USERLIB_PREFIX)")
 SET(POSTGRES_PREFIX ${USERLIB_PREFIX} CACHE PATH
   "Installation prefix of postgresql library (overrides USERLIB_PREFIX)")
+SET(FIREBIRD_PREFIX ${USERLIB_PREFIX} CACHE PATH
+  "Installation prefix of FirebirdSql library. See also IBPP_SRC_DIRECTORY. (overrides USERLIB_PREFIX)")
+SET(IBPP_SRC_DIRECTORY CACHE PATH
+  "Path to the SOURCE directory of IBPP (req for FireBird) library. See www.ibpp.org.")
 SET(MYSQL_PREFIX ${USERLIB_PREFIX} CACHE PATH
   "Installation prefix of mysql and mysql++ libraries "
   "(overrides USERLIB_PREFIX)")
@@ -273,6 +280,7 @@ INCLUDE(cmake/WtFindZlib.txt)
 INCLUDE(cmake/WtFindSsl.txt)
 INCLUDE(cmake/WtFindMysqlpp.txt)
 INCLUDE(cmake/WtFindPostgresql.txt)
+INCLUDE(cmake/WtFindFirebirdSql.txt)
 INCLUDE(cmake/WtFindAsciidoc.txt)
 INCLUDE(cmake/WtFindHaru.txt)
 INCLUDE(cmake/WtFindGm.txt)

Changelog

@@ -1,3 +1,27 @@
+21-11-2011:
+	* Wt/Dbo/backend/Firebird: merged Firebird backend contributed by
+	Lukasz Matuszewski.
+
+	* Wt/WLogger: the library now uses macros that wrap around
+	Wt::log() by default for internal logging, but this could be
+	adapted to use another logging system of your choice. We also
+	abide the third law of logging libraries: that they will expand
+	their features until they become unusable: we added configurations
+	options to enable or disable specific logging.
+
+	* WServer: support catching SIGHUP (on unix-like) systems to
+	reread the configuration file.
+
+	* httpd: implement newer (and newest) WebSocket drafts (protocol
+	versions 7, 8 and 13)
+
+	* all: closed several bugs and feature requests (#956, #1015,
+	#1018, #1064)
+
+18-11-2011:
+	* WString: we now store arguments as WString so they are also
+	properly i18n-ed (#1059).
+
 07-11-2011:
 	* WException: new, public exception class (was previously an internal
 	one)

INSTALL

@@ -1,10 +1,10 @@
                Wt Installation instructions on Unix-like systems
 
-   This page lists the instructions for building and installing Wt 3.0.0.
-   It is organized in 3 sections:
-     * Requirements
-     * Building and installing the library
-     * Trying the examples (or your own Wt application)
+   This page lists the instructions for building and installing Wt. It is
+   organized in 3 sections:
+     * [1]Requirements
+     * [2]Building and installing the library
+     * [3]Trying the examples (or your own Wt application)
 
 Requirements
 
@@ -34,21 +34,35 @@ Requirements
 
      * Compiler: gcc-3.3.4 or higher, or gcc-4.1.x or higher, or other
        Ansi C++ compiler that can deal with boost-like C++ code.
-     * [1]CMake cross-platform build system:
+     * [4]CMake cross-platform build system:
        Preferably CMake 2.6, which comes with a usable script for finding
        boost libraries, but CMake 2.4 is still supported using Wt's own
        boost find script.
-     * [2]C++ boost library (version 1.36 or higher), preferably with
-       thread support enabled. You can verify you have a thread-enabled
+     * [5]C++ boost library (preferably version 1.41 or higher), with or
+       without thread support. You can verify you have a thread-enabled
        boost installation by locating the libboost_thread library. Thread
        support is not essential: Wt functionality is not affected except
        for exotic things like server push and reentrant event loops. Most
        importantly, even without thread support Wt can handle multiple
        concurrent sessions.
-     * Optionally, [3]Haru Free PDF Library, which is used to provide
+       Older versions of boost, up until 1.36 are also supported, but some
+       features will be disabled that depend on the revised versions of
+       spirit, namely JSON parsing and improved SQL parsing (for Wt::Dbo).
+     * Optionally, [6]OpenSSL, which is used to support the HTTPS protocol
+       in the web client, the HTTPS protocol in the built-in wthttpd
+       connector, additional cryptographic hash functions in the Auth
+       library, and WebSockets (which requires a SHA-1 hash
+       implementation).
+     * Optionally, [7]Haru Free PDF Library, which is used to provide
        support for painting to PDF (WPdfImage).
-     * Optionally, [4]GraphicsMagick, for supporting painting to raster
+     * Optionally, [8]GraphicsMagick, for supporting painting to raster
        images (PNG, GIF, ...) (WRasterImage).
+     * Optionally, [9]PostgreSQL, for the PostgreSQL backend for Wt::Dbo
+       (Dbo::backend::Postgres).
+     * Optionally, [10]Firebird, for the Firebird backend for Wt::Dbo
+       (Dbo::backend::Firebird).
+     * Optionally, [11]Pango, for improved font support in the WPdfImage
+       and WRasterImage paint devices.
 
     1a Using FastCGI
 
@@ -57,20 +71,21 @@ Requirements
 
    Given that Apache is still the most popular webserver, below are the
    requirements for apache, for other web servers the list is similar:
-     * FCGI library, including C++ bindings (libfcgi++)
-     * Fastcgi or mod_fcgi plugin for Apache.
+     * [12]FCGI library, including C++ bindings (libfcgi++)
+     * A suitable plugin for your web server.
 
     1b Using wthttpd
 
    When using the built-in webserver, two more libraries may be installed
    to enable optional features (you can also build without them), but
    otherwise no extra dependencies are required.
-     * Optionally, libz, for compression over HTTP.
-     * Optionally, openssl, for supporting HTTPS.
+     * Optionally, zlib (libz), for compression over HTTP.
+     * Optionally, OpenSSL (libopenssl), for HTTPS and WebSockets (which
+       requires a SHA-1 hash implementation).
 
   2 Additional and optional requirements for some of the examples
 
-     * libmysql++-2.x (hangman)
+     * Qt, for the libwtwithqt interopability layer
      __________________________________________________________________
 
 Building and installing the Wt library
@@ -170,14 +185,6 @@ Building and installing the Wt library
           Location of the wthttpd configuration file (default is
           /etc/wt/wthttpd)
 
-   HTTP_WITH_SSL
-          Compile with support for SSL, for secure HTTP (HTTPS). This
-          requires an OpenSSL library.
-
-   HTTP_WITH_ZLIB
-          Compile with support for compression over HTTP. This requires
-          the libz library.
-
    To change any entry, use [Enter]. To save and quit, do [c] followed by
    [g].
 
@@ -210,10 +217,10 @@ Trying the examples (or your own Wt application)
    the build option EXAMPLES_CONNECTOR (see supra).
 
    Some examples need third-party JavaScript libraries (ExtJS or TinyMCE).
-     * Download ExtJS from [5]http://yogurtearl.com/ext-2.0.2.zip, and
+     * Download ExtJS from [13]http://yogurtearl.com/ext-2.0.2.zip, and
        install it according to these instructions:
-       [6]http://www.webtoolkit.eu/wt/doc/reference/html/group__ext.html
-     * Download TinyMCE from [7]http://tinymce.moxiecode.com/ and install
+       [14]http://www.webtoolkit.eu/wt/doc/reference/html/group__ext.html
+     * Download TinyMCE from [15]http://tinymce.moxiecode.com/ and install
        its tiny_mce folder into the resources/ folder.
 
    You will notice 404 File not Found errors for ext/ or
@@ -273,7 +280,7 @@ N/foobar/
 -http-port 8080
 
    This will start a httpd server listening on all local interfaces, on
-   port 8080, and you may browse the example at [8]http://127.0.0.1:8080/
+   port 8080, and you may browse the example at [16]http://127.0.0.1:8080/
 
    You will notice 404 File not Found errors for resources/ files if you
    are missing the resources files.
@@ -326,11 +333,19 @@ HTTPS server options:
 
 References
 
-   1. http://www.cmake.org/
-   2. http://www.boost.org/
-   3. http://libharu.org/
-   4. http://www.graphicsmagick.org/
-   5. http://yogurtearl.com/ext-2.0.2.zip
-   6. http://www.webtoolkit.eu/wt/doc/reference/html/group__ext.html
-   7. http://tinymce.moxiecode.com/
-   8. http://127.0.0.1:8080/
+   1. file://localhost/home/koen/project/wt/git/wt/INSTALL.html#requirements
+   2. file://localhost/home/koen/project/wt/git/wt/INSTALL.html#build
+   3. file://localhost/home/koen/project/wt/git/wt/INSTALL.html#examples
+   4. http://www.cmake.org/
+   5. http://www.boost.org/
+   6. http://www.openssl.org/
+   7. http://libharu.org/
+   8. http://www.graphicsmagick.org/
+   9. http://www.posgresql.org/
+  10. http://www.firebirdsql.org/
+  11. http://www.pango.org/
+  12. http://www.fastcgi.com/
+  13. http://yogurtearl.com/ext-2.0.2.zip
+  14. http://www.webtoolkit.eu/wt/doc/reference/html/group__ext.html
+  15. http://tinymce.moxiecode.com/
+  16. http://127.0.0.1:8080/

INSTALL.html

@@ -6,12 +6,14 @@
 <body>
 <h1>Wt Installation instructions on Unix-like systems</h1>
 
-This page lists the instructions for building and installing Wt 3.0.0.
-It is organized in 3 sections:
+This page lists the instructions for building and installing Wt. It is
+organized in 3 sections:
+
 <ul>
-<li>Requirements</li>
-<li>Building and installing the library</li>
-<li>Trying the examples (or your own Wt application)</li>
+<li><a href="#requirements">Requirements</a></li>
+<li><a href="#build">Building and installing</a> the library</li>
+<li><a href="#examples">Trying the examples</a> (or your own Wt
+  application)</li>
 </ul>
 
 <a name="requirements"></a><h2>Requirements</h2>
@@ -56,15 +58,33 @@ <h3>1 Wt requirements</h3>
     Wt's own boost find script.
   </div>
 </li>
-<li><a href="http://www.boost.org/">C++ boost library</a> (version
-  1.36 or higher), preferably with thread support enabled. You can
+<li><a href="http://www.boost.org/">C++ boost library</a> (preferably
+  version 1.41 or higher), with or without thread support. You can
   verify you have a thread-enabled boost installation by locating the
   libboost_thread library. Thread support is not essential: Wt
   functionality is not affected except for exotic things like server
   push and reentrant event loops. Most importantly, even without
-  thread support Wt can handle multiple concurrent sessions.</li>
-<li>Optionally, <a href="http://libharu.org/">Haru Free PDF Library</a>, which is used to provide support for painting to PDF (WPdfImage).</li>
-<li>Optionally, <a href="http://www.graphicsmagick.org/">GraphicsMagick</a>, for supporting painting to raster images (PNG, GIF, ...) (WRasterImage).</li>
+  thread support Wt can handle multiple concurrent sessions. <br/>
+  Older versions of boost, up until 1.36 are also supported, but some
+  features will be disabled that depend on the revised versions of
+  spirit, namely JSON parsing and improved SQL parsing (for Wt::Dbo).
+</li>
+<li>Optionally, <a href="http://www.openssl.org">OpenSSL</a>, which is
+used to support the HTTPS protocol in the web client, the HTTPS
+protocol in the built-in wthttpd connector, additional cryptographic
+hash functions in the Auth library, and WebSockets (which requires a
+SHA-1 hash implementation).</li>
+<li>Optionally, <a href="http://libharu.org/">Haru Free PDF Library</a>,
+which is used to provide support for painting to PDF (WPdfImage).</li>
+<li>Optionally, <a href="http://www.graphicsmagick.org/">GraphicsMagick</a>,
+for supporting painting to raster images (PNG, GIF, ...) (WRasterImage).</li>
+<li>Optionally, <a href="http://www.posgresql.org/">PostgreSQL</a>,
+for the PostgreSQL backend for Wt::Dbo (Dbo::backend::Postgres).</li>
+<li>Optionally, <a href="http://www.firebirdsql.org/">Firebird</a>,
+for the Firebird backend for Wt::Dbo (Dbo::backend::Firebird).</li>
+<li>Optionally, <a href="http://www.pango.org/">Pango</a>, for
+improved font support in the WPdfImage and WRasterImage paint
+devices.</li>
 </ul>
 
 <h4>1a Using FastCGI</h4>
@@ -77,8 +97,9 @@ <h4>1a Using FastCGI</h4>
 similar:</p>
 
 <ul>
-<li>FCGI library, including C++ bindings (libfcgi++)</li>
-<li>Fastcgi or mod_fcgi plugin for Apache.</li>
+<li><a href="http://www.fastcgi.com/">FCGI library</a>, including C++
+bindings (libfcgi++)</li>
+<li>A suitable plugin for your web server.</li>
 </ul>
 
 <h4>1b Using wthttpd</h4>
@@ -88,13 +109,14 @@ <h4>1b Using wthttpd</h4>
 otherwise no extra dependencies are required.
 
 <ul>
-<li>Optionally, libz, for compression over HTTP.</li>
-<li>Optionally, openssl, for supporting HTTPS.</li>
+<li>Optionally, zlib (libz), for compression over HTTP.</li>
+<li>Optionally, OpenSSL (libopenssl), for HTTPS and WebSockets (which
+requires a SHA-1 hash implementation).</li>
 </ul>
 
 <h3>2 Additional and optional requirements for some of the examples</h3>
 <ul>
-<li>libmysql++-2.x (hangman)</li>
+<li>Qt, for the libwtwithqt interopability layer</li>
 </ul>
 
 <hr />
@@ -185,9 +207,6 @@ <h4>2. Configure the library</h4>
 recommended, you may want to disable this for example if you suspect
 threading problems. Note that recursive event loops (most notably when
 using Dialog::exec()) are not possible without thread support.</dd>
-<dt><strong>ENABLE_SSL</strong></dt>
-<dd>Compile with support for SSL, enabling secure HTTP (HTTPS), and cryptographic functions
-for Wt::Auth. This requires an OpenSSL library.</dd>
 </dl>
 
 The following variables apply to the FastCGI connector:
@@ -206,9 +225,6 @@ <h4>2. Configure the library</h4>
 <dl>
 <dt><strong>WTHTTP_CONFIGURATION</strong></dt>
 <dd>Location of the wthttpd configuration file (default is /etc/wt/wthttpd)</dd>
-<dt><strong>HTTP_WITH_ZLIB</strong></dt>
-<dd>Compile with support for compression over HTTP. This requires the
-libz library.</dd>
 </dl>
 
 To change any entry, use [Enter]. To save and quit, do [c] followed by [g].

README.md

@@ -0,0 +1,61 @@
+What is Wt ?
+------------
+
+Wt is a C++ library for developing web applications. It consists of:
+
+- libwt, a widget/rendering library
+- libwthttp, an (async I/O) HTTP/WebSockets server
+- libwtfcgi, a FastCGI connector library (Unix)
+- libwtisapi, an ISAPI connector library (Windows)
+- libwttest, a test connector environment
+
+It also contains a C++ ORM, which can be used in a web application
+(obviously), but can also be used on its own:
+
+- libwtdbo, a C++ ORM
+- libwtdbopostgres, PostgreSQL backend
+- libwtdbosqlite3, Sqlite3 backend
+- libwtdbofirebird, Firebird backend
+
+For more information, see [the homepage](http://www.webtoolkit.eu/wt
+"Wt homepage").
+
+Dependencies
+------------
+
+To build Wt from source you will need at least
+[CMake](http://www.cmake.org/CMake) (>= 2.4), and
+[boost](http://www.boost.org) (version >= 1.41).
+
+Optionally, you may want to add:
+
+- [OpenSSL](http://www.openssl.org) for SSL and WebSockets support in
+  the built-in httpd, the HTTP(S) client, and additional cryptographic
+  hashes in the authentication module
+- [Haru PDF library](http://libharu.org) which is used for painting to PDF
+- [GraphicsMagick](http://www.graphicsmagick.org/) which is used for painting
+  to PNG, GIF
+- [PostgreSQL](http://www.posgresql.org/) for a PostgreSQL backend
+- [Firebird](http://www.firebirdsql.org/) for a Firebird backend
+- [Pango](http://www.pango.org/) for improved font support in PDF and raster
+  image painting
+- [ZLib](http://zlib.net/) for compression in the built-in httpd.
+
+For the FastCGI connector, you also need:
+
+- [FastCGI development kit](http://www.fastcgi.com/): you need the
+  C/C++ library (libfcgi++)
+
+Building
+--------
+
+Generic instructions for [Unix-like
+platforms](http://www.webtoolkit.eu/wt/doc/reference/html/InstallationUnix.html)
+or [Windows
+platforms](http://www.webtoolkit.eu/wt/doc/reference/html/InstallationWindows.html).
+
+Demos, examples
+---------------
+
+[The homepage](http://www.webtoolkit.eu/wt), itself a Wt application,
+contains also [various examples](http://www.webtoolkit.eu/wt/examples).