Documentation tidies and clarifications.

git-svn-id: svn://vcs.exim.org/pcre/code/trunk@260 2f5784b3-3f2a-0410-8824-cb99058d5e15

1 files changed, 18 insertions, 10 deletions

diff --git a/NON-UNIX-USE b/NON-UNIX-USE
index b31546e..1a3ca85 100644
--- a/NON-UNIX-USE
+++ b/NON-UNIX-USE
@@ -9,7 +9,7 @@ This document contains the following sections:
   Building for virtual Pascal
   Stack size in Windows environments
   Comments about Win32 builds
-  Building PCRE with Cmake
+  Building PCRE with CMake
   Building under Windows with BCC5.5
   Building PCRE on OpenVMS
 
@@ -31,10 +31,10 @@ library consists entirely of code written in Standard C, and so should compile
 successfully on any system that has a Standard C compiler and library. The C++
 wrapper functions are a separate issue (see below).
 
-The PCRE distribution contains some experimental support for "cmake", but this
-is incomplete and not fully documented. However if you are a "cmake" user you
-might like to try building with "cmake". There are some instructions in the
-section entitled "Building PCRE with Cmake" below.
+The PCRE distribution includes support for CMake. This support is relatively
+new, but has already been used successfully to build PCRE in multiple build
+environments on Windows. There are some instructions in the section entitled
+"Building PCRE with CMake" below.
 
 
 GENERIC INSTRUCTIONS FOR THE PCRE C LIBRARY
@@ -169,11 +169,15 @@ fail because of this. Normally, running out of stack causes a crash, but there
 have been cases where the test program has just died silently. See your linker
 documentation for how to increase stack size if you experience problems. The
 Linux default of 8Mb is a reasonable choice for the stack, though even that can
-be too small for some pattern/subject combinations. There is more about stack
-usage in the "pcrestack" documentation.
+be too small for some pattern/subject combinations. 
 
+PCRE has a compile configuration option to disable the use of stack for
+recursion so that heap is used instead. However, pattern matching is
+significantly slower when this is done. There is more about stack usage in the
+"pcrestack" documentation.
 
-COMMENTS ABOUT WIN32 BUILDS
+
+COMMENTS ABOUT WIN32 BUILDS (see also "BUILDING PCRE WITH CMAKE" below)
 
 There are two ways of building PCRE using the "configure, make, make install"
 paradigm on Windows systems: using MinGW or using Cygwin. These are not at all
@@ -250,7 +254,11 @@ things in this area in future.
 
 BUILDING PCRE WITH CMAKE
 
-These instructions were contributed by a PCRE user.
+CMake is an alternative build facility that can be used instead of the
+traditional Unix "configure". CMake version 2.4.7 supports Borland makefiles,
+MinGW makefiles, MSYS makefiles, NMake makefiles, UNIX makefiles, Visual Studio
+6, Visual Studio 7, Visual Studio 8, and Watcom W8. The following instructions
+were contributed by a PCRE user.
 
 1. Download CMake 2.4.7 or above from http://www.cmake.org/, install and ensure
    that cmake\bin is on your path.
@@ -376,5 +384,5 @@ $!   Locale could not be set to fr
 $!
 =========================
 
-Last Updated: 17 September 2007
+Last Updated: 21 September 2007
 ****