asubst(3) EN Tools asubst(3)NAME
asubst - Area Substitution
SYNOPSIS
asubst [-o outputfile] [-v] [inputfile]
DESCRIPTION
The asubst program reads inputfile or from "stdin" and performs the following action: Characters and substrings are substituted according
to Perl-like substitution commands enclosed by surrounding area delimiters. The substitution commands recognized are
[[s/pattern/string/options]]
[[tr/input/output/options]]
and the areas are defined by blocks delimited via
{: ... :}
EXAMPLE
{: [[s/ae/ä/]] [[s/ue/ü/]]
Foo Bar Baz Quux with Umlauts ae and ue
:}
OPTIONS -o outputfile
This redirects the output to outputfile. Usually the output will be send to "stdout" if no such option is specified or outputfile is
""-"".
-v This sets verbose mode where some processing information will be given on the console.
AUTHOR
Ralf S. Engelschall
rse@engelschall.com
www.engelschall.com
EN Tools 2014-04-16 asubst(3)
Check Out this Related Man Page
wml::std::tags(3) EN Tools wml::std::tags(3)NAME
wml::std::tags - Standard Support Tags
SYNOPSIS
#use wml::std::tags
# Pass 2: advanced if constructs
<ifdef varname thenval elseval>
# Pass 3: support tag
<perl> ... </perl>
<say> ... </say>
# Pass 4: support tag
<m4> ... </m4>
# Pass 4: symbols
<symbol name value>
<symbol name undef>
# Pass 5: diversions
<dump NAME>
<enter NAME> ... <leave>
<divert NAME> ... </divert>
# Pass 6: support tag
<asubst ...> ... </asubst>
# Client-Side JavaScript: support tag
<javascript [version=..] [language=..]
[type=..] [src=...] [defer] [nohead] [nolang]>
...
</javascript>
# Resynchronize line numbers for more accurate pass 3 warnings
<sync-lines>
DESCRIPTION
This include file defines some standard support tags one needs all the time. All tags are self-explanatory and briefly mentioned in
wml_intro(1), except the last two which are described below.
"<javascript>":
This tag was primarily a shorthand for "<script type="text/javascript" language="JavaScript">" but it has evolved. If the "<head>" tag is
defined and is a complex macro, e.g. when calling "wml::std::page", then Javascript code is automatically passed to this macro and should
be diverted to the HEAD section of HTML documents. This diversion preserve lang slices in multi-lingual documents. Those features may be
disabled by the ``nohead'' and ``nolang'' attributes.
"<sync-lines>":
WML tries to print information on input file and line numbers when warnings or errors are reported in passes 2 and 3. Some special
sentences containing file names and line numbers are inserted during pass 1. So pass 2 have an accurate knowledge of where warnings appear
in input file. But it also filters it without preserving lines, so after pass 2 information is almost unusable. By putting "<sync-lines>"
in input file, it forces pass 2 to resynchronize information on line numbers. So for debugging pass 3, it could be of some help to insert
"<sync-lines>" before ePerl code.
AUTHORS
Ralf S. Engelschall
rse@engelschall.com
www.engelschall.com
Denis Barbier
barbier@engelschall.com
REQUIRES
Internal: P1, P2, P3, P4, P6
External: --
SEE ALSO wml(1)EN Tools 2014-04-16 wml::std::tags(3)