Add more explanation about recursive subpatterns, and make it possible to

process the documenation without building a whole release.


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

1 files changed, 6 insertions, 3 deletions

diff --git a/PrepareRelease b/PrepareRelease
index de63e78..b083095 100755
--- a/PrepareRelease
+++ b/PrepareRelease
@@ -4,8 +4,9 @@
 # processing of the documentation, detrails files, and creates pcre.h.generic
 # and config.h.generic (for use by builders who can't run ./configure).
 
-# You must run this script before runnning "make dist". It makes use of the
-# following files:
+# You must run this script before runnning "make dist". If its first argument
+# is "doc", it stops after preparing the documentation. There are no other
+# arguments. The script makes use of the following files:
 
 # 132html     A Perl script that converts a .1 or .3 man page into HTML. It
 #             "knows" the relevant troff constructs that are used in the PCRE
@@ -119,6 +120,7 @@ done
 # Exclude table of contents for function summaries. It seems that expr
 # forces an anchored regex. Also exclude them for small pages that have
 # only one section.
+
 for file in *.3 ; do
   base=`basename $file .3`
   toc=-toc
@@ -134,10 +136,11 @@ for file in *.3 ; do
   if [ $? != 0 ] ; then exit 1; fi
 done
 
-# End of documentation processing
+# End of documentation processing; stop if only documentation required.
 
 cd ..
 echo Documentation done
+if [ "$1" = "doc" ] ; then exit; fi
 
 # These files are detrailed; do not detrail the test data because there may be
 # significant trailing spaces. The configure files are also omitted from the