diff --git a/README b/README index 9d9520fc6..7b1bbad3b 100644 --- a/README +++ b/README @@ -16,11 +16,10 @@ All libraries come with a test suite and a number of sample programs. The basic directory layout is as follows: -build/ the build system for Unix/OpenVMS and additional utility scripts +build/ the build system for Unix and additional utility scripts config/ build configurations for various Unix platforms rules/ common build rules for all platforms scripts/ build and utility scripts - vms/ OpenVMS build system scripts vxconfig/ VxWorks build configurations bin/ all executables (dynamic link libraries on Windows) @@ -93,14 +92,14 @@ libraries) being installed to build properly: - Data/MySQL requires the MySQL client. Most Unix/Linux systems already have OpenSSL preinstalled. If your system -does not have OpenSSL, please get it from http://www.openssl.org or +does not have OpenSSL, please get it from or another source. You do not have to build OpenSSL yourself - a binary distribution is fine (e.g., apt-get install openssl libssl-dev). The easiest way to install OpenSSL on Windows is to use a binary (prebuild) release, for example the one from Shining Light Productions that comes with a Windows installer -(http://www.slproweb.com/products/Win32OpenSSL.html). +. Depending on where you have installed the OpenSSL libraries, you might have to edit the build script (buildwin.cmd), or add the necessary paths to the INCLUDE and LIB environment variables. @@ -122,17 +121,17 @@ accordingly. BUILDING ON WINDOWS =================== -Microsoft Visual Studio 7.1 (2003), 8.0 (2005), 9.0 (2008) or 10.0 (2010) is required to -build the POCO C++ Libraries on Windows platforms. Solution and project files for all -versions are included. For Visual Studio 2008 and 2010, 64-bit (x64) builds are -supported as well. +Microsoft Visual Studio 7.1 (2003), 8.0 (2005), 9.0 (2008), 10.0 (2010) or 11.0 (2012) +is required to build the POCO C++ Libraries on Windows platforms. Solution and project +files for all versions are included. For Visual Studio 2008 and later, 64-bit (x64) builds +are supported as well. You can either build from within Visual Studio (Build->Batch Build->Select All;Rebuild) or from the command line. To build from the command line, start the -Visual Studio .NET 2003 (or 2005/2008/2010) Command Prompt and cd to the directory where you -have extracted the POCO C++ Libraries sources. Then, simply start the buildwin.cmd script -and pass as argument the version of visual studio (71, 80, 90 or 100). You can customize -what is being built by buildwin.cmd by passing appropriate command line arguments to -it. Call buildwin.cmd without arguments to see what is available. +Visual Studio .NET 2003 (or 2005/2008/2010/2012) Command Prompt and cd to the directory +where you have extracted the POCO C++ Libraries sources. Then, simply start the buildwin.cmd +script and pass as argument the version of visual studio (71, 80, 90, 100 or 110). You can +customize what is being built by buildwin.cmd by passing appropriate command line arguments +to it. Call buildwin.cmd without arguments to see what is available. To disable certain components (e.g., NetSSL_OpenSSL or Data/MySQL) from the build, edit the file named "components" and remove the respective lines. @@ -157,7 +156,7 @@ BUILDING FOR WINDOWS CE Building for Windows CE is supported with Microsoft Visual Studio 2008. Unless you have the Digi JumpStart Windows CE 6.0 SDK installed, you'll have to modify the included Visual Studio project and solution files. -Please see the SDK Reference Documentation (http://pocoproject.org/documentation) +Please see the SDK Reference Documentation for instructions. @@ -167,8 +166,7 @@ BUILDING ON UNIX/LINUX/MAC OS X For building on Unix platforms, the POCO C++ Libraries come with their own build system. The build system is based on GNU Make 3.80 (or newer), with the help from a few shell scripts. If you do not have GNU Make 3.80 (or later) installed on -your machine, you will need to download it from -http://directory.fsf.org/devel/build/make.html>, +your machine, you will need to download it from , build and install it prior to building the POCO C++ Libraries. You can check the version of GNU Make installed on your system with @@ -208,7 +206,7 @@ on your system. To do this, use the --omit argument to configure: To build on Mac OS X 10.3 with GCC 3, do the following: -(NOTE: This only affects 10.3; for 10.4/10.5 see above) +(NOTE: This only affects 10.3; for 10.4 or newer see above) > ./configure --config=Darwin7 > make -s @@ -252,37 +250,6 @@ more information. The Reference Documentation can be found online at . -BUILDING ON OPENVMS -=================== - -OpenVMS is no longer supported in recent versions of POCO, due to both a -lack of interest and a lack of contributors. The following -instructions are here for historical reasons. - -The POCO C++ Libraries come with their own build system for OpenVMS, implemented -by a bunch of DCL scripts. The scripts can be found in the build/vms directory. - -To build the POCO C++ Libraries on OpenVMS, follow the following steps. - -1) Download the .zip distribution of the POCO C++ Libraries - -2) Unzip the archive - $ unzip -aa poco-0_91_4.zip - -3) Change the directory - $ set def [.poco-0_01_4] - -4) Create a lib directory - $ create/dir [.lib] - -5) Run the buildvms.com script - $ @buildvms - -This will build the debug versions of the libraries. To build the release -versions, use - $ @buildvms -release - - MORE INFORMATION ================ @@ -291,4 +258,4 @@ at . -- -$Id: //poco/1.4/dist/README#4 $ +$Id: //poco/1.4/dist/README#5 $