.\" Automatically generated by Pod::Man 4.10 (Pod::Simple 3.35)
.\"
.\" Standard preamble:
.\" ========================================================================
.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.  \*(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-
.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" ''
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is >0, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{\
.    if \nF \{\
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{\
.            nr % 0
.            nr F 2
.        \}
.    \}
.\}
.rr rF
.\"
.\" 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 "HOOLA 1"
.TH HOOLA 1 "2018-12-25" "EN Tools" "EN Tools"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH "NAME"
WMk \- Website META Language Make
.SH "VERSION"
.IX Header "VERSION"
\&\f(CW@WML_VERSION\fR@
.SH "SYNOPSIS"
.IX Header "SYNOPSIS"
\&\fBwmk\fR
[\fB\-a\fR]
[\fB\-A\fR \fI\s-1WILDMAT\s0\fR]
[\fB\-F\fR \fI\s-1WILDMAT\s0\fR]
[\fB\-x\fR \fI\s-1PATH\s0\fR]
[\fB\-X\fR \fI\s-1PATH\s0\fR]
[\fB\-a\fR]
[\fB\-f\fR]
[\fB\-n\fR]
[\fB\-r\fR]
[\fIWML-options\fR]
[\fIpath\fR ...]
.PP
\&\fBwmk\fR
[\fB\-V\fR]
[\fB\-h\fR]
.SH "DESCRIPTION"
.IX Header "DESCRIPTION"
This is the high-level frontend to the \fIWebsite \s-1META\s0 Language\fR (\s-1WML\s0), a free
\&\s-1HTML\s0 generation toolkit for Unix, internally consisting of 9 independent
languages.  See \fBwml\fR\|(1) for more details on \s-1WML.\s0
.PP
Use this command to run \fIwml\fR on a bunch of \fI.wml\fR files either directly
given on the command line as \fIpath\fR or found via directory traversal in
\&\fIpath\fR.
.PP
WMk recognizes \s-1WML\s0's \fIshebang\fR lines (``\f(CW\*(C`#!wml\*(C'\fR \fIoptions\fR'') in the \fI.wml\fR
files and automatically adds \fIoptions\fR to the command line of \fIwml\fR when
invoking it for this particular file.
.SH "OPTIONS"
.IX Header "OPTIONS"
.IP "\fB\-a\fR, \fB\-\-all\fR" 4
.IX Item "-a, --all"
Specifies that WMk should recursively process \fBall\fR \fI.wml\fR files it finds in
\&\fIpath\fR.
.IP "\fB\-A\fR, \fB\-\-accept=\fR\fI\s-1WILDMAT\s0\fR" 4
.IX Item "-A, --accept=WILDMAT"
Accepts (=includes) all files matched by the shell wildcard pattern \fI\s-1WILDMAT\s0\fR
for processing. WMk always has a pre-configured ``\f(CW\*(C`\-A *.wml\*(C'\fR'' option which
forces it to process all \s-1WML\s0 files per default.   This option is only used
when \fIpath\fR is a directory.
.IP "\fB\-F\fR, \fB\-\-forget=\fR\fI\s-1WILDMAT\s0\fR" 4
.IX Item "-F, --forget=WILDMAT"
Forgets (=exclude) all files and directories matched by the shell wildcard
pattern \fI\s-1WILDMAT\s0\fR which were previously accepted by option \fB\-A\fR.
.IP "\fB\-o\fR, \fB\-\-outputfile=\fR\fI\s-1PATH\s0\fR" 4
.IX Item "-o, --outputfile=PATH"
Specifies output files.  When this flag is used in \fI.wmlrc\fR, the same
flag must be put in \fI.wmkrc\fR to let WMk know when to rebuild these
output files.
.IP "\fB\-x\fR, \fB\-\-exec\-prolog=\fR\fI\s-1PATH\s0\fR" 4
.IX Item "-x, --exec-prolog=PATH"
Executes \fI\s-1PATH\s0\fR in the local context of \fIpath\fR \fBbefore\fR the \s-1WML\s0 commands
are run.  This options is only used when \fIpath\fR is a directory.
.IP "\fB\-X\fR, \fB\-\-exec\-epilog=\fR\fI\s-1PATH\s0\fR" 4
.IX Item "-X, --exec-epilog=PATH"
Executes \fI\s-1PATH\s0\fR in the local context of \fIpath\fR \fBafter\fR the \s-1WML\s0 commands are
run.  This options is only used when \fIpath\fR is a directory.
.IP "\fB\-f\fR, \fB\-\-force\fR" 4
.IX Item "-f, --force"
Forces the creation of output files. Usually WMk tries to determine if the
input file was really modified and skips \s-1WML\s0 invocations if the output files
are still up-to-date.
.IP "\fB\-n\fR, \fB\-\-nop\fR" 4
.IX Item "-n, --nop"
Sets \fIno-operation\fR (nop) where WMk runs as usual but does not actually
invoce the \fIwml\fR commands. Use this option to see what \fIwmk\fR would do.
.IP "\fB\-r\fR, \fB\-\-norcfile\fR" 4
.IX Item "-r, --norcfile"
This forces WMk to ignore all \fI.wmkrc\fR and \s-1WML\s0 to ignore all \fI.wmlrc\fR files.
.IP "\fB\-V\fR, \fB\-\-version\fR" 4
.IX Item "-V, --version"
Gives the version identification string of WMk. Use this to determine the
version of a installed \s-1WML\s0 toolkit.
.IP "\fB\-h\fR, \fB\-\-help\fR" 4
.IX Item "-h, --help"
Prints the usage summary page.
.PP
All \fIWML-options\fR directly correspond to their counterparts in \fIwml\fR(1)
because they are just forwarded by \fIwmk\fR except the \fB\-n\fR and \fB\-o\fR options
which are implicitly created by \fIwmk\fR for each \fIwml\fR invocation.
.SH "USER FILES"
.IX Header "USER FILES"
.IP "\fI\f(CI$HOME\fI/.wmkrc\fR and \fI(../)*.wmkrc\fR" 4
.IX Item "$HOME/.wmkrc and (../)*.wmkrc"
These files can also contain option strings, one option per line.  One
may use this file to exclude some directories from being searched for
input files
.Sp
.Vb 3
\&  \-F images
\&  \-F templates
\&   ...
.Ve
.SH "CAVEAT"
.IX Header "CAVEAT"
Auto-adjusted variables specified as \fB\-DNAME~PATH\fR on the \fIwmk\fR
command-line will not necessarily have the same effect as a similar
definition in a \fI./.wmlrc\fR file.  This is because, when processing
sub-directories, \fIwmk\fR changes its working directory to each of those
directories, which can influence the interpolation of such auto-adjusted
variables.  When specified on the command line, such variables are
interpolated with respect to \fIwml\fR's current working directory at the
time of its invocation.  So, if you wish such variables to be
interpolated relative to \fIwmk\fR's current working directory at the time
of its invocation, one can work-around this issue by specifying
\&\fB\-DNAME~PATH\fR in a \fI.wmlrc\fR in that directory rather than specifying
it on the \fIwmk\fR command-line.
.SH "AUTHORS"
.IX Header "AUTHORS"
.Vb 3
\& Ralf S. Engelschall
\& rse@engelschall.com
\& www.engelschall.com
\&
\& Denis Barbier
\& barbier@engelschall.com
.Ve
.SH "SEE ALSO"
.IX Header "SEE ALSO"
\&\fBwml\fR\|(1), \fBwml_intro\fR\|(1)