Merge branch 'xgawk'

1 files changed, 24 insertions, 5 deletions

diff --git a/doc/gawk.1 b/doc/gawk.1
index f01ffbfe..dbc2582b 100644
--- a/doc/gawk.1
+++ b/doc/gawk.1
@@ -330,11 +330,10 @@ these options cause an immediate, successful exit.)
 Load a shared library
 .IR lib .
 This searches for the library using the
-.B AWKPATH
-environment variable. The suffix 
-.I .so
-in the library name is optional, and
-the library initialization routine is expected to be named
+.B AWKLIBPATH
+environment variable.  If the initial search fails, another attempt will
+be made after appending the default shared library suffix for the platform.
+The library initialization routine is expected to be named
 .BR dlload() .
 .TP
 .PD 0
@@ -574,6 +573,9 @@ and optional function definitions.
 .RS
 .PP
 \fB@include "\fIfilename\fB"
+.br
+\fB@load "\fIfilename\fB"
+.br
 \fIpattern\fB	{ \fIaction statements\fB }\fR
 .br
 \fBfunction \fIname\fB(\fIparameter list\fB) { \fIstatements\fB }\fR
@@ -605,6 +607,13 @@ In addition, lines beginning with
 may be used to include other source files into your program,
 making library use even easier.
 .PP
+Lines beginning with
+.B @load
+may be used to load shared libraries into your program.  This is equivalent
+to using the
+.B \-l 
+option.
+.PP
 The environment variable
 .B AWKPATH
 specifies a search path to use when finding source files named with
@@ -3639,6 +3648,16 @@ and
 options.
 .PP
 The
+.B AWKLIBPATH
+environment variable can be used to provide a list of directories that
+.I gawk
+searches when looking for files named via the
+.B \-l
+and
+.B \-\^\-load
+options.
+.PP
+The
 .B GAWK_READ_TIMEOUT
 environment variable can be used to specify a timeout
 in milliseconds for reading input from a terminal, pipe