Improve doc on use of SYMTAB.

1 files changed, 21 insertions, 2 deletions

diff --git a/doc/gawk.texi b/doc/gawk.texi
index 92cb57dc..6b2cf3cf 100644
--- a/doc/gawk.texi
+++ b/doc/gawk.texi
@@ -15119,9 +15119,28 @@ function multiply(variable, amount)
 @}
 @end example
 
+@noindent
+You would use it like this:
+
+@example
+BEGIN @{
+    answer = 10.5
+    multiply("answer", 4)
+    print "The answer is", answer
+@}
+@end example
+
+@noindent
+When run, this produces:
+
+@example
+$ @kbd{gawk -f answer.awk}
+@print{} The answer is 42
+@end example
+
 @quotation NOTE
-In order to avoid severe time-travel paradoxes,@footnote{Not to mention difficult
-implementation issues.} neither @code{FUNCTAB} nor @code{SYMTAB}
+In order to avoid severe time-travel paradoxes,@footnote{Not to mention
+difficult implementation issues.} neither @code{FUNCTAB} nor @code{SYMTAB}
 is available as an element within the @code{SYMTAB} array.
 @end quotation
 @end table