Doc on workaround for debugger -f limitation.

1 files changed, 14 insertions, 0 deletions

diff --git a/doc/gawktexi.in b/doc/gawktexi.in
index 0408d61c..6b17f5ea 100644
--- a/doc/gawktexi.in
+++ b/doc/gawktexi.in
@@ -30733,6 +30733,18 @@ executing, short programs.
 
 @item
 The @command{gawk} debugger only accepts source code supplied with the @option{-f} option.
+If you have a shell script that provides an @command{awk} program as a command
+line parameter, and you need to use the debugger, you can write the script
+to a temporary file, and use that as the program, with the @option{-f} option. This
+might look like this:
+
+@example
+cat << \EOF > /tmp/script.$$
+@dots{}                                  @ii{Your program here}
+EOF
+gawk -D -f /tmp/script.$$
+rm /tmp/script.$$
+@end example
 @end itemize
 
 @ignore
@@ -44151,3 +44163,5 @@ Add a section explaining recursion from ground zero. Probably
 easiest to do it with factorial as the example. Explain that
 recursion needs a stopping condition. Thanks to
 Bill Duncan <bduncan@beachnet.org> for the suggestion.
+
+4/2109: Go through and check @print{} vs. @error{} in examples