--- code/trunk/doc/pcresample.3	2008/01/23 18:02:23	312
+++ code/trunk/doc/pcresample.3	2010/05/26 10:50:24	525
@@ -5,7 +5,13 @@
 .rs
 .sp
 A simple, complete demonstration program, to get you started with using PCRE,
-is supplied in the file \fIpcredemo.c\fP in the PCRE distribution.
+is supplied in the file \fIpcredemo.c\fP in the PCRE distribution. A listing of
+this program is given in the
+.\" HREF
+\fBpcredemo\fP
+.\"
+documentation. If you do not have a copy of the PCRE distribution, you can save
+this listing to re-create \fIpcredemo.c\fP.
 .P
 The program compiles the regular expression that is its first argument, and
 matches it against the subject string in its second argument. No PCRE options
@@ -19,8 +25,8 @@
 an empty string. Comments in the code explain what is going on.
 .P
 If PCRE is installed in the standard include and library directories for your
-system, you should be able to compile the demonstration program using this
-command:
+operating system, you should be able to compile the demonstration program using
+this command:
 .sp
   gcc -o pcredemo pcredemo.c -lpcre
 .sp
@@ -33,8 +39,14 @@
   gcc -o pcredemo -I/usr/local/include pcredemo.c \e
       -L/usr/local/lib -lpcre
 .sp
-Once you have compiled the demonstration program, you can run simple tests like
-this:
+In a Windows environment, if you want to statically link the program against a
+non-dll \fBpcre.a\fP file, you must uncomment the line that defines PCRE_STATIC
+before including \fBpcre.h\fP, because otherwise the \fBpcre_malloc()\fP and
+\fBpcre_free()\fP exported functions will be declared
+\fB__declspec(dllimport)\fP, with unwanted results.
+.P
+Once you have compiled and linked the demonstration program, you can run simple
+tests like this:
 .sp
   ./pcredemo 'cat|dog' 'the cat sat on the mat'
   ./pcredemo -g 'cat|dog' 'the dog sat on the cat'
@@ -44,12 +56,18 @@
 \fBpcretest\fP,
 .\"
 which supports many more facilities for testing regular expressions and the
-PCRE library. The \fBpcredemo\fP program is provided as a simple coding
-example.
+PCRE library. The
+.\" HREF
+\fBpcredemo\fP
+.\"
+program is provided as a simple coding example.
 .P
-On some operating systems (e.g. Solaris), when PCRE is not installed in the
-standard library directory, you may get an error like this when you try to run
-\fBpcredemo\fP:
+When you try to run
+.\" HREF
+\fBpcredemo\fP
+.\"
+when PCRE is not installed in the standard library directory, you may get an
+error like this on some operating systems (e.g. Solaris):
 .sp
   ld.so.1: a.out: fatal: libpcre.so.0: open failed: No such file or directory
 .sp
@@ -75,6 +93,6 @@
 .rs
 .sp
 .nf
-Last updated: 23 January 2008
-Copyright (c) 1997-2008 University of Cambridge.
+Last updated: 26 May 2010
+Copyright (c) 1997-2010 University of Cambridge.
 .fi