aboutsummaryrefslogtreecommitdiff
path: root/man/man1
diff options
context:
space:
mode:
authorTom Ryder <tom@sanctum.geek.nz>2017-06-02 23:35:33 +1200
committerTom Ryder <tom@sanctum.geek.nz>2017-06-02 23:35:33 +1200
commit31460b8e225813a63cc28331b794769246447397 (patch)
tree89ac5278d97f4c30daafa2194b95cb1090f3fc2b /man/man1
parentAdd another mi5(1df) caveat (diff)
downloaddotfiles-31460b8e225813a63cc28331b794769246447397.tar.gz
dotfiles-31460b8e225813a63cc28331b794769246447397.zip
Allow custom delimiters for mi5(1df)
Diffstat (limited to 'man/man1')
-rw-r--r--man/man1/mi5.1df12
1 files changed, 8 insertions, 4 deletions
diff --git a/man/man1/mi5.1df b/man/man1/mi5.1df
index fddcf725..8c9c1c5c 100644
--- a/man/man1/mi5.1df
+++ b/man/man1/mi5.1df
@@ -7,6 +7,9 @@
FILE > out.m4
.br
.B mi5
+-v open='{{{' -v shut='}}}' FILE > out.m4
+.br
+.B mi5
FILE1 FILE2 > out.m4
.br
prog |
@@ -23,9 +26,10 @@ covers almost every usage case for the author. It's written to work with any
POSIX awk and to generate output for any POSIX m4.
.P
mi5 inverts m4's usual approach by approaching most of the file as if it were
-part of an m4 quote, with <% and %> as the delimiters to specify markers in
-which macro expansion should occur. This is therefore a way to shoehorn m4 into
-working in a way reminiscent of templating libraries or languages like PHP.
+part of an m4 quote, with <% and %> as the (default) delimiters to specify
+markers in which macro expansion should occur. This is therefore a way to
+shoehorn m4 into working in a way reminiscent of templating libraries or
+languages like PHP.
.P
Macros can be expanded as blocks:
.P
@@ -52,7 +56,7 @@ are not inserted for inline blocks.
Ideally, you do your complex macro definition in a block at the top of your
file, and your simple macro expansion of those results in an inline.
.SH CAVEATS
-The <% delimiters %> are hardcoded for now, and there's no way to escape them.
+There's no way to escape the delimiters.
.P
Inline expansions cannot span multiple lines. Use blocks for that.
.P