diff options
-rw-r--r-- | cppawk.1 | 18 |
1 files changed, 18 insertions, 0 deletions
@@ -271,6 +271,24 @@ contains: #define rule(\fIcond\fP) if (\fIcond\fP) .ft R +Produce an informative banner in generated output, as an Awk comment block. +This is very useful when output is being generated and retained instead of +being immediately executed, for instance for installation on a target system +which has no preprocessor: + +.ft B + #define HASH # + HASH################################################### + HASH DO NOT EDIT! + HASH This file was generated from __FILE__ on __DATE__ + HASH################################################### +.ft R + +Note: this was tested to work with the GNU preprocessor. A spurious blank line +may appear. The material in the Awk comments isn't a comment to the C +preprocessor; it must consist of valid C preprocessor tokens, so the text must +be chosen accordingly. + .SH "SEE ALSO" awk(1), cpp(6), cppawk-narg(1), cppawk-case(1), cppawk-cons(1) |