From e01ea2ab73482dbfc40d2480e2f05a0c9ec4120c Mon Sep 17 00:00:00 2001 From: Runxi Yu Date: Thu, 13 Mar 2025 19:32:21 +0800 Subject: [PATCH] Update documentation for htmplgen.1 --- htmplgen/htmplgen.1 | 19 ++++++++----------- diff --git a/htmplgen/htmplgen.1 b/htmplgen/htmplgen.1 index 50fdc8265002cd6ea0126959d9325c13a30f838f..eeb374ed381a86b21eea1c26471eea54e506fc2c 100644 --- a/htmplgen/htmplgen.1 +++ b/htmplgen/htmplgen.1 @@ -37,9 +37,6 @@ The options are as follows: .Bl -tag -width Ds .It Fl G Do not emit debug info in the generated source. -It's disabled by default, unless -.Nm -is reading from standard input. .It Fl o Ar out Write output to file. .Ar out @@ -53,27 +50,27 @@ .Sh SEE ALSO .Xr htmpl 7 .Sh AUTHORS .An -nosplit -The -.Nm -utility was written by -.An Omar Polo Aq Mt op@openbsd.org . +.An Omar Polo Aq Mt op@openbsd.org +wrote the original version in C. +.An Runxi Yu Aq Mt me@runxiyu.org +ported it to Hare. .Sh CAVEATS The compiler is very naive, so there are quite a few shortcomings: .Bl -bullet -compact .It -No attempt is made to validate the C code provided inline, nor the +No attempt is made to validate the Hare code provided inline, nor the validity of the arguments to many constructs. .It The generated code assumes that a variable called -.Va tp +.Va handle of type -.Vt struct template * +.Vt io::handle is in scope inside each block. .It Each block may have additional variables used for the template generation implicitly defined: to avoid clashes, don't name variables or arguments with the -.Sq tp_ +.Sq _htmpl_ prefix. .It Blanks are, in most cases, trimmed. -- 2.48.1