Contents of /code/branches/pcre16/PrepareRelease

#/bin/sh

# Script to prepare the files for building a PCRE release. It does some
# 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". 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
#             man pages.

# CheckMan    A Perl script that checks man pages for typos in the mark up.

# CleanTxt    A Perl script that cleans up the output of "nroff -man" by
#             removing backspaces and other redundant text so as to produce
#             a readable .txt file.

# Detrail     A Perl script that removes trailing spaces from files.

# doc/index.html.src
#             A file that is copied as index.html into the doc/html directory
#             when the HTML documentation is built. It works like this so that
#             doc/html can be deleted and re-created from scratch.


# First, sort out the documentation. Remove pcredemo.3 first because it won't
# pass the markup check (it is created below, using markup that none of the
# other pages use).

cd doc
echo Processing documentation

/bin/rm -f pcredemo.3

# Check the remaining man pages

perl ../CheckMan *.1 *.3
if [ $? != 0 ] ; then exit 1; fi

# Make Text form of the documentation. It needs some mangling to make it
# tidy for online reading. Concatenate all the .3 stuff, but omit the
# individual function pages.

cat <<End >pcre.txt
-----------------------------------------------------------------------------
This file contains a concatenation of the PCRE man pages, converted to plain
text format for ease of searching with a text editor, or for use on systems
that do not have a man page processor. The small individual files that give
synopses of each function in the library have not been included. Neither has
the pcredemo program. There are separate text files for the pcregrep and
pcretest commands.
-----------------------------------------------------------------------------


End

echo "Making pcre.txt"
for file in pcre pcrebuild pcrematching pcreapi pcrecallout pcrecompat \
            pcrepattern pcresyntax pcreunicode pcrejit pcrepartial \
            pcreprecompile pcreperform pcreposix pcrecpp pcresample \
            pcrelimits pcrestack ; do
  echo "  Processing $file.3"
  nroff -c -man $file.3 >$file.rawtxt
  perl ../CleanTxt <$file.rawtxt >>pcre.txt
  /bin/rm $file.rawtxt
  echo "------------------------------------------------------------------------------" >>pcre.txt
  if [ "$file" != "pcresample" ] ; then
    echo " " >>pcre.txt
    echo " " >>pcre.txt
  fi
done

# The three commands
for file in pcretest pcregrep pcre-config ; do
  echo Making $file.txt
  nroff -c -man $file.1 >$file.rawtxt
  perl ../CleanTxt <$file.rawtxt >$file.txt
  /bin/rm $file.rawtxt
done


# Make pcredemo.3 from the pcredemo.c source file

echo "Making pcredemo.3"
perl <<"END" >pcredemo.3
  open(IN, "../pcredemo.c") || die "Failed to open pcredemo.c\n";
  open(OUT, ">pcredemo.3") || die "Failed to open pcredemo.3\n";
  print OUT ".\\\" Start example.\n" .
            ".de EX\n" .
            ".  nr mE \\\\n(.f\n" .
            ".  nf\n" .
            ".  nh\n" .
            ".  ft CW\n" .
            "..\n" .
            ".\n" .
            ".\n" .
            ".\\\" End example.\n" .
            ".de EE\n" .
            ".  ft \\\\n(mE\n" .
            ".  fi\n" .
            ".  hy \\\\n(HY\n" .
            "..\n" .
            ".\n" .
            ".EX\n" ;
  while (<IN>)
    {
    s/\\/\\e/g;
    print OUT;
    }
  print OUT ".EE\n";
  close(IN);
  close(OUT);
END
if [ $? != 0 ] ; then exit 1; fi


# Make HTML form of the documentation.

echo "Making HTML documentation"
/bin/rm html/*
cp index.html.src html/index.html

for file in *.1 ; do
  base=`basename $file .1`
  echo "  Making $base.html"
  perl ../132html -toc $base <$file >html/$base.html
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
  if [ `expr $base : '.*_'` -ne 0 ] ; then toc="" ; fi
  if [ "$base" = "pcresample" ]  || \
     [ "$base" = "pcrestack" ]   || \
     [ "$base" = "pcrecompat" ]  || \
     [ "$base" = "pcrelimits" ]  || \
     [ "$base" = "pcreperform" ] || \
     [ "$base" = "pcreunicode" ] ; then
    toc=""
  fi
  echo "  Making $base.html"
  perl ../132html $toc $base <$file >html/$base.html
  if [ $? != 0 ] ; then exit 1; fi
done

# 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. Do not detrail RunTest.bat, because it has CRLF
# line endings and the detrail script removes all trailing white space. The
# configure files are also omitted from the detrailing.

files="\
  Makefile.am \
  Makefile.in \
  configure.ac \
  README \
  LICENCE \
  COPYING \
  AUTHORS \
  NEWS \
  NON-UNIX-USE \
  INSTALL \
  132html \
  CleanTxt \
  Detrail \
  ChangeLog \
  CMakeLists.txt \
  RunGrepTest \
  RunTest \
  pcre-config.in \
  libpcre.pc.in \
  libpcreposix.pc.in \
  libpcrecpp.pc.in \
  config.h.in \
  pcre_printint.src \
  pcre_chartables.c.dist \
  pcredemo.c \
  pcregrep.c \
  pcretest.c \
  dftables.c \
  pcreposix.c \
  pcreposix.h \
  pcre.h.in \
  pcre_internal.h
  pcre_byte_order.c \
  pcre_compile.c \
  pcre_config.c \
  pcre_dfa_exec.c \
  pcre_exec.c \
  pcre_fullinfo.c \
  pcre_get.c \
  pcre_globals.c \
  pcre_info.c \
  pcre_jit_compile.c \
  pcre_jit_test.c \
  pcre_maketables.c \
  pcre_newline.c \
  pcre_ord2utf8.c \
  pcre_refcount.c \
  pcre_study.c \
  pcre_tables.c \
  pcre_ucp_searchfuncs.c \
  pcre_valid_utf8.c \
  pcre_version.c \
  pcre_xclass.c \
  pcre_scanner.cc \
  pcre_scanner.h \
  pcre_scanner_unittest.cc \
  pcrecpp.cc \
  pcrecpp.h \
  pcrecpparg.h.in \
  pcrecpp_unittest.cc \
  pcre_stringpiece.cc \
  pcre_stringpiece.h.in \
  pcre_stringpiece_unittest.cc \
  perltest.pl \
  ucp.h \
  ucpinternal.h \
  ucptable.h \
  makevp.bat \
  pcre.def \
  libpcre.def \
  libpcreposix.def"

echo Detrailing
perl ./Detrail $files doc/p* doc/html/*

echo Doing basic configure to get default pcre.h and config.h
# This is in case the caller has set aliases (as I do - PH)
unset cp ls mv rm
./configure >/dev/null

echo Converting pcre.h and config.h to generic forms
cp -f pcre.h pcre.h.generic

perl <<'END'
  open(IN, "<config.h") || die "Can't open config.h: $!\n";
  open(OUT, ">config.h.generic") || die "Can't open config.h.generic: $!\n";
  while (<IN>)
    {
    if (/^#define\s(?!PACKAGE)(\w+)/)
      {
      print OUT "#ifndef $1\n";
      print OUT;
      print OUT "#endif\n";
      }
    else
      {
      print OUT;
      }
    }
  close IN;
  close OUT;
END

echo Done

#End
1	#/bin/sh
2
3	# Script to prepare the files for building a PCRE release. It does some
4	# processing of the documentation, detrails files, and creates pcre.h.generic
5	# and config.h.generic (for use by builders who can't run ./configure).
6
7	# You must run this script before runnning "make dist". If its first argument
8	# is "doc", it stops after preparing the documentation. There are no other
9	# arguments. The script makes use of the following files:
10
11	# 132html A Perl script that converts a .1 or .3 man page into HTML. It
12	# "knows" the relevant troff constructs that are used in the PCRE
13	# man pages.
14
15	# CheckMan A Perl script that checks man pages for typos in the mark up.
16
17	# CleanTxt A Perl script that cleans up the output of "nroff -man" by
18	# removing backspaces and other redundant text so as to produce
19	# a readable .txt file.
20
21	# Detrail A Perl script that removes trailing spaces from files.
22
23	# doc/index.html.src
24	# A file that is copied as index.html into the doc/html directory
25	# when the HTML documentation is built. It works like this so that
26	# doc/html can be deleted and re-created from scratch.
27
28
29	# First, sort out the documentation. Remove pcredemo.3 first because it won't
30	# pass the markup check (it is created below, using markup that none of the
31	# other pages use).
32
33	cd doc
34	echo Processing documentation
35
36	/bin/rm -f pcredemo.3
37
38	# Check the remaining man pages
39
40	perl ../CheckMan .1 .3
41	if [ $? != 0 ] ; then exit 1; fi
42
43	# Make Text form of the documentation. It needs some mangling to make it
44	# tidy for online reading. Concatenate all the .3 stuff, but omit the
45	# individual function pages.
46
47	cat <<End >pcre.txt
48	-----------------------------------------------------------------------------
49	This file contains a concatenation of the PCRE man pages, converted to plain
50	text format for ease of searching with a text editor, or for use on systems
51	that do not have a man page processor. The small individual files that give
52	synopses of each function in the library have not been included. Neither has
53	the pcredemo program. There are separate text files for the pcregrep and
54	pcretest commands.
55	-----------------------------------------------------------------------------
56
57
58	End
59
60	echo "Making pcre.txt"
61	for file in pcre pcrebuild pcrematching pcreapi pcrecallout pcrecompat \
62	pcrepattern pcresyntax pcreunicode pcrejit pcrepartial \
63	pcreprecompile pcreperform pcreposix pcrecpp pcresample \
64	pcrelimits pcrestack ; do
65	echo " Processing $file.3"
66	nroff -c -man $file.3 >$file.rawtxt
67	perl ../CleanTxt <$file.rawtxt >>pcre.txt
68	/bin/rm $file.rawtxt
69	echo "------------------------------------------------------------------------------" >>pcre.txt
70	if [ "$file" != "pcresample" ] ; then
71	echo " " >>pcre.txt
72	echo " " >>pcre.txt
73	fi
74	done
75
76	# The three commands
77	for file in pcretest pcregrep pcre-config ; do
78	echo Making $file.txt
79	nroff -c -man $file.1 >$file.rawtxt
80	perl ../CleanTxt <$file.rawtxt >$file.txt
81	/bin/rm $file.rawtxt
82	done
83
84
85	# Make pcredemo.3 from the pcredemo.c source file
86
87	echo "Making pcredemo.3"
88	perl <<"END" >pcredemo.3
89	open(IN, "../pcredemo.c") \|\| die "Failed to open pcredemo.c\n";
90	open(OUT, ">pcredemo.3") \|\| die "Failed to open pcredemo.3\n";
91	print OUT ".\\\" Start example.\n" .
92	".de EX\n" .
93	". nr mE \\\\n(.f\n" .
94	". nf\n" .
95	". nh\n" .
96	". ft CW\n" .
97	"..\n" .
98	".\n" .
99	".\n" .
100	".\\\" End example.\n" .
101	".de EE\n" .
102	". ft \\\\n(mE\n" .
103	". fi\n" .
104	". hy \\\\n(HY\n" .
105	"..\n" .
106	".\n" .
107	".EX\n" ;
108	while (<IN>)
109	{
110	s/\\/\\e/g;
111	print OUT;
112	}
113	print OUT ".EE\n";
114	close(IN);
115	close(OUT);
116	END
117	if [ $? != 0 ] ; then exit 1; fi
118
119
120	# Make HTML form of the documentation.
121
122	echo "Making HTML documentation"
123	/bin/rm html/*
124	cp index.html.src html/index.html
125
126	for file in *.1 ; do
127	base=`basename $file .1`
128	echo " Making $base.html"
129	perl ../132html -toc $base <$file >html/$base.html
130	done
131
132	# Exclude table of contents for function summaries. It seems that expr
133	# forces an anchored regex. Also exclude them for small pages that have
134	# only one section.
135
136	for file in *.3 ; do
137	base=`basename $file .3`
138	toc=-toc
139	if [ `expr $base : '.*_'` -ne 0 ] ; then toc="" ; fi
140	if [ "$base" = "pcresample" ] \|\| \
141	[ "$base" = "pcrestack" ] \|\| \
142	[ "$base" = "pcrecompat" ] \|\| \
143	[ "$base" = "pcrelimits" ] \|\| \
144	[ "$base" = "pcreperform" ] \|\| \
145	[ "$base" = "pcreunicode" ] ; then
146	toc=""
147	fi
148	echo " Making $base.html"
149	perl ../132html $toc $base <$file >html/$base.html
150	if [ $? != 0 ] ; then exit 1; fi
151	done
152
153	# End of documentation processing; stop if only documentation required.
154
155	cd ..
156	echo Documentation done
157	if [ "$1" = "doc" ] ; then exit; fi
158
159	# These files are detrailed; do not detrail the test data because there may be
160	# significant trailing spaces. Do not detrail RunTest.bat, because it has CRLF
161	# line endings and the detrail script removes all trailing white space. The
162	# configure files are also omitted from the detrailing.
163
164	files="\
165	Makefile.am \
166	Makefile.in \
167	configure.ac \
168	README \
169	LICENCE \
170	COPYING \
171	AUTHORS \
172	NEWS \
173	NON-UNIX-USE \
174	INSTALL \
175	132html \
176	CleanTxt \
177	Detrail \
178	ChangeLog \
179	CMakeLists.txt \
180	RunGrepTest \
181	RunTest \
182	pcre-config.in \
183	libpcre.pc.in \
184	libpcreposix.pc.in \
185	libpcrecpp.pc.in \
186	config.h.in \
187	pcre_printint.src \
188	pcre_chartables.c.dist \
189	pcredemo.c \
190	pcregrep.c \
191	pcretest.c \
192	dftables.c \
193	pcreposix.c \
194	pcreposix.h \
195	pcre.h.in \
196	pcre_internal.h
197	pcre_byte_order.c \
198	pcre_compile.c \
199	pcre_config.c \
200	pcre_dfa_exec.c \
201	pcre_exec.c \
202	pcre_fullinfo.c \
203	pcre_get.c \
204	pcre_globals.c \
205	pcre_info.c \
206	pcre_jit_compile.c \
207	pcre_jit_test.c \
208	pcre_maketables.c \
209	pcre_newline.c \
210	pcre_ord2utf8.c \
211	pcre_refcount.c \
212	pcre_study.c \
213	pcre_tables.c \
214	pcre_ucp_searchfuncs.c \
215	pcre_valid_utf8.c \
216	pcre_version.c \
217	pcre_xclass.c \
218	pcre_scanner.cc \
219	pcre_scanner.h \
220	pcre_scanner_unittest.cc \
221	pcrecpp.cc \
222	pcrecpp.h \
223	pcrecpparg.h.in \
224	pcrecpp_unittest.cc \
225	pcre_stringpiece.cc \
226	pcre_stringpiece.h.in \
227	pcre_stringpiece_unittest.cc \
228	perltest.pl \
229	ucp.h \
230	ucpinternal.h \
231	ucptable.h \
232	makevp.bat \
233	pcre.def \
234	libpcre.def \
235	libpcreposix.def"
236
237	echo Detrailing
238	perl ./Detrail $files doc/p* doc/html/*
239
240	echo Doing basic configure to get default pcre.h and config.h
241	# This is in case the caller has set aliases (as I do - PH)
242	unset cp ls mv rm
243	./configure >/dev/null
244
245	echo Converting pcre.h and config.h to generic forms
246	cp -f pcre.h pcre.h.generic
247
248	perl <<'END'
249	open(IN, "<config.h") \|\| die "Can't open config.h: $!\n";
250	open(OUT, ">config.h.generic") \|\| die "Can't open config.h.generic: $!\n";
251	while (<IN>)
252	{
253	if (/^#define\s(?!PACKAGE)(\w+)/)
254	{
255	print OUT "#ifndef $1\n";
256	print OUT;
257	print OUT "#endif\n";
258	}
259	else
260	{
261	print OUT;
262	}
263	}
264	close IN;
265	close OUT;
266	END
267
268	echo Done
269
270	#End