Contents of /code/trunk/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". It makes use of the
# following files:

# 132html     A Perl script that converts a .1 or .3 man page into HTML. It
#             is called from MakeRelease. It "knows" the relevant troff
#             constructs that are used in the PCRE man pages.

# 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

cd doc
echo Processing documentation

# 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. 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 pcrepartial pcreprecompile \
            pcreperform pcreposix pcrecpp pcresample pcrestack ; do
  echo "  Processing $file.3"
  nroff -c -man $file.3 >$file.rawtxt
  ../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
  ../CleanTxt <$file.rawtxt >$file.txt
  /bin/rm $file.rawtxt
done


# 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"
  ../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" = "pcreperform" ] ; then
    toc=""
  fi
  echo "  Making $base.html"
  ../132html $toc $base <$file >html/$base.html
  if [ $? != 0 ] ; then exit 1; fi
done

# End of documentation processing

cd ..
echo Documentation done

# 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
# 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 \
  RunTest.bat \
  pcre-config.in \
  libpcre.pc.in \
  libpcrecpp.pc.in \
  config.h \
  config.h.in \
  pcre_printint.src \
  pcre_chartables.c.dist \
  pcredemo.c \
  pcregrep.c \
  pcretest.c \
  dftables.c \
  pcreposix.c \
  pcreposix.h \
  pcre.h \
  pcre.h.in \
  pcre_internal.h
  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_maketables.c \
  pcre_newline.c \
  pcre_ord2utf8.c \
  pcre_refcount.c \
  pcre_study.c \
  pcre_tables.c \
  pcre_try_flipped.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
./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". It makes use of the
8	# following files:
9
10	# 132html A Perl script that converts a .1 or .3 man page into HTML. It
11	# is called from MakeRelease. It "knows" the relevant troff
12	# constructs that are used in the PCRE man pages.
13
14	# CleanTxt A Perl script that cleans up the output of "nroff -man" by
15	# removing backspaces and other redundant text so as to produce
16	# a readable .txt file.
17
18	# Detrail A Perl script that removes trailing spaces from files.
19
20	# doc/index.html.src
21	# A file that is copied as index.html into the doc/html directory
22	# when the HTML documentation is built. It works like this so that
23	# doc/html can be deleted and re-created from scratch.
24
25
26	# First, sort out the documentation
27
28	cd doc
29	echo Processing documentation
30
31	# Make Text form of the documentation. It needs some mangling to make it
32	# tidy for online reading. Concatenate all the .3 stuff, but omit the
33	# individual function pages.
34
35	cat <<End >pcre.txt
36	-----------------------------------------------------------------------------
37	This file contains a concatenation of the PCRE man pages, converted to plain
38	text format for ease of searching with a text editor, or for use on systems
39	that do not have a man page processor. The small individual files that give
40	synopses of each function in the library have not been included. There are
41	separate text files for the pcregrep and pcretest commands.
42	-----------------------------------------------------------------------------
43
44
45	End
46
47	echo "Making pcre.txt"
48	for file in pcre pcrebuild pcrematching pcreapi pcrecallout pcrecompat \
49	pcrepattern pcrepartial pcreprecompile \
50	pcreperform pcreposix pcrecpp pcresample pcrestack ; do
51	echo " Processing $file.3"
52	nroff -c -man $file.3 >$file.rawtxt
53	../CleanTxt <$file.rawtxt >>pcre.txt
54	/bin/rm $file.rawtxt
55	echo "------------------------------------------------------------------------------" >>pcre.txt
56	if [ "$file" != "pcresample" ] ; then
57	echo " " >>pcre.txt
58	echo " " >>pcre.txt
59	fi
60	done
61
62	# The three commands
63	for file in pcretest pcregrep pcre-config ; do
64	echo Making $file.txt
65	nroff -c -man $file.1 >$file.rawtxt
66	../CleanTxt <$file.rawtxt >$file.txt
67	/bin/rm $file.rawtxt
68	done
69
70
71	# Make HTML form of the documentation.
72
73	echo "Making HTML documentation"
74	/bin/rm html/*
75	cp index.html.src html/index.html
76
77	for file in *.1 ; do
78	base=`basename $file .1`
79	echo " Making $base.html"
80	../132html -toc $base <$file >html/$base.html
81	done
82
83	# Exclude table of contents for function summaries. It seems that expr
84	# forces an anchored regex. Also exclude them for small pages that have
85	# only one section.
86	for file in *.3 ; do
87	base=`basename $file .3`
88	toc=-toc
89	if [ `expr $base : '.*_'` -ne 0 ] ; then toc="" ; fi
90	if [ "$base" = "pcresample" ] \|\| \
91	[ "$base" = "pcrestack" ] \|\| \
92	[ "$base" = "pcrecompat" ] \|\| \
93	[ "$base" = "pcreperform" ] ; then
94	toc=""
95	fi
96	echo " Making $base.html"
97	../132html $toc $base <$file >html/$base.html
98	if [ $? != 0 ] ; then exit 1; fi
99	done
100
101	# End of documentation processing
102
103	cd ..
104	echo Documentation done
105
106	# These files are detrailed; do not detrail the test data because there may be
107	# significant trailing spaces. The configure files are also omitted from the
108	# detrailing.
109
110	files="\
111	Makefile.am \
112	Makefile.in \
113	configure.ac \
114	README \
115	LICENCE \
116	COPYING \
117	AUTHORS \
118	NEWS \
119	NON-UNIX-USE \
120	INSTALL \
121	132html \
122	CleanTxt \
123	Detrail \
124	ChangeLog \
125	CMakeLists.txt \
126	RunGrepTest \
127	RunTest \
128	RunTest.bat \
129	pcre-config.in \
130	libpcre.pc.in \
131	libpcrecpp.pc.in \
132	config.h \
133	config.h.in \
134	pcre_printint.src \
135	pcre_chartables.c.dist \
136	pcredemo.c \
137	pcregrep.c \
138	pcretest.c \
139	dftables.c \
140	pcreposix.c \
141	pcreposix.h \
142	pcre.h \
143	pcre.h.in \
144	pcre_internal.h
145	pcre_compile.c \
146	pcre_config.c \
147	pcre_dfa_exec.c \
148	pcre_exec.c \
149	pcre_fullinfo.c \
150	pcre_get.c \
151	pcre_globals.c \
152	pcre_info.c \
153	pcre_maketables.c \
154	pcre_newline.c \
155	pcre_ord2utf8.c \
156	pcre_refcount.c \
157	pcre_study.c \
158	pcre_tables.c \
159	pcre_try_flipped.c \
160	pcre_ucp_searchfuncs.c \
161	pcre_valid_utf8.c \
162	pcre_version.c \
163	pcre_xclass.c \
164	pcre_scanner.cc \
165	pcre_scanner.h \
166	pcre_scanner_unittest.cc \
167	pcrecpp.cc \
168	pcrecpp.h \
169	pcrecpparg.h.in \
170	pcrecpp_unittest.cc \
171	pcre_stringpiece.cc \
172	pcre_stringpiece.h.in \
173	pcre_stringpiece_unittest.cc \
174	perltest.pl \
175	ucp.h \
176	ucpinternal.h \
177	ucptable.h \
178	makevp.bat \
179	pcre.def \
180	libpcre.def \
181	libpcreposix.def"
182
183	echo Detrailing
184	./Detrail $files doc/p* doc/html/*
185
186	echo Doing basic configure to get default pcre.h and config.h
187	# This is in case the caller has set aliases (as I do - PH)
188	unset cp ls mv rm
189	./configure >/dev/null
190
191	echo Converting pcre.h and config.h to generic forms
192	cp -f pcre.h pcre.h.generic
193
194	perl <<'END'
195	open(IN, "<config.h") \|\| die "Can't open config.h: $!\n";
196	open(OUT, ">config.h.generic") \|\| die "Can't open config.h.generic: $!\n";
197	while (<IN>)
198	{
199	if (/^#define\s(?!PACKAGE)(\w+)/)
200	{
201	print OUT "#ifndef $1\n";
202	print OUT;
203	print OUT "#endif\n";
204	}
205	else
206	{
207	print OUT;
208	}
209	}
210	close IN;
211	close OUT;
212	END
213
214	echo Done
215
216	#End