aboutsummaryrefslogtreecommitdiffstats
path: root/doc/gawk.1
diff options
context:
space:
mode:
authorAndrew J. Schorr <aschorr@telemetry-investments.com>2012-05-19 23:45:07 -0400
committerAndrew J. Schorr <aschorr@telemetry-investments.com>2012-05-19 23:45:07 -0400
commitcdf892a07fa67c635997e41ee8fe175aaafb2431 (patch)
tree46245d7f88797b98dbb60e60b223b3da9ff13cd1 /doc/gawk.1
parent0f2e51f9b18a1c4e203e0bd0ac3c68db9faa9b6d (diff)
downloadegawk-cdf892a07fa67c635997e41ee8fe175aaafb2431.tar.gz
egawk-cdf892a07fa67c635997e41ee8fe175aaafb2431.tar.bz2
egawk-cdf892a07fa67c635997e41ee8fe175aaafb2431.zip
Add -i option, append .awk if initial search fails, and allow -f repeats.
Diffstat (limited to 'doc/gawk.1')
-rw-r--r--doc/gawk.126
1 files changed, 23 insertions, 3 deletions
diff --git a/doc/gawk.1 b/doc/gawk.1
index dbc2582b..dbc527e1 100644
--- a/doc/gawk.1
+++ b/doc/gawk.1
@@ -323,6 +323,19 @@ the standard output.
these options cause an immediate, successful exit.)
.TP
.PD 0
+.BI "\-i " include-file
+.TP
+.PD
+.BI \-\^\-include " include-file"
+Load an awk source library.
+This searches for the library using the
+.B AWKPATH
+environment variable. If the initial search fails, another attempt will
+be made after appending the ".awk" suffix. The file will be loaded only
+once (i.e. duplicates are eliminated), and the code does not constitute
+the main program source.
+.TP
+.PD 0
.BI "\-l " lib
.TP
.PD
@@ -619,7 +632,9 @@ The environment variable
specifies a search path to use when finding source files named with
the
.B \-f
-option. If this variable does not exist, the default path is
+and
+.B \-i
+options. If this variable does not exist, the default path is
\fB".:/usr/local/share/awk"\fR.
(The actual directory may vary, depending upon how
.I gawk
@@ -3643,9 +3658,14 @@ environment variable can be used to provide a list of directories that
.I gawk
searches when looking for files named via the
.B \-f
-and
+,
.B \-\^\-file
-options.
+,
+.B \-i
+and
+.B \-\^\-include
+options. If the initial search fails, the path is searched again after
+appending ".awk" to the filename.
.PP
The
.B AWKLIBPATH