Annotation of embedaddon/pcre/PrepareRelease, revision 1.1.1.1
1.1 misho 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_compile.c \
198: pcre_config.c \
199: pcre_dfa_exec.c \
200: pcre_exec.c \
201: pcre_fullinfo.c \
202: pcre_get.c \
203: pcre_globals.c \
204: pcre_info.c \
205: pcre_jit_compile.c \
206: pcre_jit_test.c \
207: pcre_maketables.c \
208: pcre_newline.c \
209: pcre_ord2utf8.c \
210: pcre_refcount.c \
211: pcre_study.c \
212: pcre_tables.c \
213: pcre_try_flipped.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
FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>
![[BACK]](/icons/cvsweb/back.gif){kind=icon}
Return to PrepareRelease CVS log ![[TXT]](/icons/cvsweb/text.gif){kind=icon}
![[DIR]](/icons/cvsweb/dir.gif){kind=icon}
Up to [ELWIX - Embedded LightWeight unIX -] / embedaddon / pcre