.\" Automatically generated by Pod::Man v1.37, Pod::Parser v1.14 .\" .\" Standard preamble: .\" ======================================================================== .de Sh \" Subsection heading .br .if t .Sp .ne 5 .PP \fB\\$1\fR .PP .. .de Sp \" Vertical space (when we can't use .PP) .if t .sp .5v .if n .sp .. .de Vb \" Begin verbatim text .ft CW .nf .ne \\$1 .. .de Ve \" End verbatim text .ft R .fi .. .\" Set up some character translations and predefined strings. \*(-- will .\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left .\" double quote, and \*(R" will give a right double quote. | will give a .\" real vertical bar. \*(C+ will give a nicer C++. Capital omega is used to .\" do unbreakable dashes and therefore won't be available. \*(C` and \*(C' .\" expand to `' in nroff, nothing in troff, for use with C<>. .tr \(*W-|\(bv\*(Tr .ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p' .ie n \{\ . ds -- \(*W- . ds PI pi . if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch . if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch . ds L" "" . ds R" "" . ds C` "" . ds C' "" 'br\} .el\{\ . ds -- \|\(em\| . ds PI \(*p . ds L" `` . ds R" '' 'br\} .\" .\" If the F register is turned on, we'll generate index entries on stderr for .\" titles (.TH), headers (.SH), subsections (.Sh), items (.Ip), and index .\" entries marked with X<> in POD. Of course, you'll have to process the .\" output yourself in some meaningful fashion. .if \nF \{\ . de IX . tm Index:\\$1\t\\n%\t"\\$2" .. . nr % 0 . rr F .\} .\" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .hy 0 .if n .na .\" .\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2). .\" Fear. Run. Save yourself. No user-serviceable parts. . \" fudge factors for nroff and troff .if n \{\ . ds #H 0 . ds #V .8m . ds #F .3m . ds #[ \f1 . ds #] \fP .\} .if t \{\ . ds #H ((1u-(\\\\n(.fu%2u))*.13m) . ds #V .6m . ds #F 0 . ds #[ \& . ds #] \& .\} . \" simple accents for nroff and troff .if n \{\ . ds ' \& . ds ` \& . ds ^ \& . ds , \& . ds ~ ~ . ds / .\} .if t \{\ . ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u" . ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u' . ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u' . ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u' . ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u' . ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u' .\} . \" troff and (daisy-wheel) nroff accents .ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V' .ds 8 \h'\*(#H'\(*b\h'-\*(#H' .ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#] .ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H' .ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u' .ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#] .ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#] .ds ae a\h'-(\w'a'u*4/10)'e .ds Ae A\h'-(\w'A'u*4/10)'E . \" corrections for vroff .if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u' .if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u' . \" for low resolution devices (crt and lpr) .if \n(.H>23 .if \n(.V>19 \ \{\ . ds : e . ds 8 ss . ds o a . ds d- d\h'-1'\(ga . ds D- D\h'-1'\(hy . ds th \o'bp' . ds Th \o'LP' . ds ae ae . ds Ae AE .\} .rm #[ #] #H #V #F C .\" ======================================================================== .\" .IX Title "WPP 1" .TH WPP 1 "2004-07-09" "perl v5.8.3" "User Contributed Perl Documentation" .SH "NAME" WPP \- The Web Preprocessor .SH "SYNOPSIS" .IX Header "SYNOPSIS" \&\fBwpp\fR [\s-1POSIX\s0\ or\ \s-1GNU\s0\ style\ options] file ... .SH "DESCRIPTION" .IX Header "DESCRIPTION" \&\s-1WPP\s0 is a small perl5 script that allows preprocessing of html files. It's useful for giving an uniform layout to different html pages. It allows you to define \*(L"variables\*(R", which are abbreviations for longer constructs, and include common html fragments. .PP \&\s-1WPP\s0 provides four separate facilities that you can use as you fit: inclusion of templates, variables expansion, conditional generation and macro expansion. .PP It can be used into cgi scripts for dynamic generation of pages. With less html code inside them you can make more flexible and readable cgi\-scripts. .PP \&\s-1WPP\s0 is distributed under the terms of the \s-1GNU\s0 General Public License (\s-1GPL\s0). As such, you can use this program free of charge but there is no warranty. .SH "OPTIONS" .IX Header "OPTIONS" \&\-c\ \fB\s-1FILE\s0\fR,\ \-\-config=\fB\s-1FILE\s0\fR Use \s-1FILE\s0 as config file (default is 'config'). .PP \&\-D\ \fB\s-1CONST\s0\fR=\fB\s-1VAL\s0\fR,\ \-D\ \fB\s-1CONST\s0\fR,\ \-\-define\ \fB\s-1CONST\s0\fR=\fB\s-1VAL\s0\fR,\ \-\-define\ \fB\s-1CONST\s0\fR Declare a constant \fB\s-1CONST\s0\fR with the optional associated value \fB\s-1VAL\s0\fR. .PP \&\-d,\ \-\-depend Generate dependencies for make. .PP \&\-F\ \fB\s-1FL\s0\fR,\ \-\-pre\-filter=\fB\s-1FL\s0\fR Preprocess input data through \s-1FL\s0 filters. Each filter should be separated by a pipe ('|') char. Example: .PP .Vb 1 \& wpp -F "filter1 | filter2 -opt" in.raw .Ve .PP \&\-f\ \fB\s-1FL\s0\fR,\ \-\-post\-filter=\fB\s-1FL\s0\fR Postprocess output data through \s-1FL\s0 filters. Each filter should be separated by a pipe ('|') char. Example: .PP .Vb 1 \& wpp -f "filter1 | filter2 -opt" in.raw .Ve .PP \&\-g,\ \-\-debug Enable the debugging output of the internal parser. .PP \&\-h,\ \-\-help Print the list of command line switches with a short description. .PP \&\-q,\ \-\-quiet Run without printing any message and warning. .PP \&\-v,\ \-\-version Print the version number of wpp and exit. .PP \&\-W\ all,\ \-\-warn=all Enable printing all warnings. .PP \&\-W\ none,\ \-\-warn=none Disable warnings. .PP \&\-W\ \fB\s-1LEV\s0\fR,\ \-\-warn=\fB\s-1LEV\s0\fR Set warning level \fB\s-1LEV\s0\fR: 0 = none 4 = notice 1 = fatal 5 = message 2 = error 6 = debug 3 = warning (*) 7 = all .PP .Vb 1 \& (*) default warning level .Ve .PP \&\-x,\ \-\-xhtml Enable \s-1XHTML\s0 compliant output for built-in macros. .PP \&\- Read raw data from the standard input, html file is written to the standard output. .SH "AUTHOR" .IX Header "AUTHOR" Marco Lamberto .SH "OFFICIAL WEB SITE" .IX Header "OFFICIAL WEB SITE" http://the.sunnyspot.org/wpp/