diff options
| author | Kaz Kylheku <kaz@kylheku.com> | 2022-03-26 21:24:05 -0700 |
|---|---|---|
| committer | Kaz Kylheku <kaz@kylheku.com> | 2022-03-26 21:24:05 -0700 |
| commit | ad1f44a45130a41e56fc1e9349b61ec160897a43 (patch) | |
| tree | 39a09669589cf68dffc2e37ede81461f26202b54 /cppawk.1 | |
| parent | 603d641fedf27029eac66938bcd4d93ef117b26e (diff) | |
| download | cppawk-ad1f44a45130a41e56fc1e9349b61ec160897a43.tar.gz cppawk-ad1f44a45130a41e56fc1e9349b61ec160897a43.tar.bz2 cppawk-ad1f44a45130a41e56fc1e9349b61ec160897a43.zip | |
man page: revise BUGS section.
Diffstat (limited to 'cppawk.1')
| -rw-r--r-- | cppawk.1 | 49 |
1 files changed, 15 insertions, 34 deletions
@@ -261,7 +261,21 @@ is "C-like", there is a lot of compatibility between that and Awk syntax, which is why .B cppawk works at all; however, there may be corner cases where some issue arises -because of this. +because of this. One example is that double quote characters may be used +in Awk regular expressions such as + + /abc\(dq/ + +but the preprocessor rejects this as a literal with a missing closing +quote. The workaround for that situation is to use an escape sequence +to encode the quote: + + /abc\e042/ + +Awk implementations reports errors against lines an anonymous filename +associated with the preprocessed stream, rather than the original lines in the +original file. Although the preprocessed output indicates source file and line +number information, Awks do not understand this. The default choices of .B gawk @@ -276,39 +290,6 @@ and .BI --prepro command line options. -The C preprocessor's -.BR "#include \(dq...\(dq" -directive is expected to search in the same directory as the file in which it -is located, which is critically important feature. However, -.B cppawk -feeds the Awk code to -.B cpp -via a pipe, even in the case when source is specified via the -.BI -f -option. The reason is that the Awk source is filtered to remove the -.BI #! -("hash bang") line, which -.B cpp -doesn't like. To make sure -.BR #include -works as expected, -.B cppawk -inserts a preprocessor option to add the original directory into the -include file search path: the current working directory in the case of -Awk code specified in the command line, or else the directory of the file -specified via the -.BI -f -option. In the default configuration, which assumes the GNU C Preprocessor, -the -.BI -iquote -option is used for this; but in a configuration using some preprocessor which does not -have that option, it may have to be done via the more heavy-handed -.BI -I -option. These options are inserted before any preprocessor options that -come from the -.B cppawk -command line. - .SH AUTHOR Kaz Kylheku <kaz@kylheku.com> |