gawk-diffs
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

[gawk-diffs] [SCM] gawk branch, extgawk, updated. 94008850575fe9450b52aa


From: Arnold Robbins
Subject: [gawk-diffs] [SCM] gawk branch, extgawk, updated. 94008850575fe9450b52aa83b77f9b08e5e55f6e
Date: Wed, 08 Aug 2012 20:11:59 +0000

This is an automated email from the git hooks/post-receive script. It was
generated because a ref change was pushed to the repository containing
the project "gawk".

The branch, extgawk has been updated
       via  94008850575fe9450b52aa83b77f9b08e5e55f6e (commit)
      from  49658bfd0ef5d4efccd210c48560c43bf455ee16 (commit)

Those revisions listed above that are new to this repository have
not appeared on any other notification email; so we list those
revisions in full, below.

- Log -----------------------------------------------------------------
http://git.sv.gnu.org/cgit/gawk.git/commit/?id=94008850575fe9450b52aa83b77f9b08e5e55f6e

commit 94008850575fe9450b52aa83b77f9b08e5e55f6e
Author: Arnold D. Robbins <address@hidden>
Date:   Wed Aug 8 23:11:31 2012 +0300

    Update extension man pages.

diff --git a/extension/ChangeLog b/extension/ChangeLog
index 22b7201..bc4b060 100644
--- a/extension/ChangeLog
+++ b/extension/ChangeLog
@@ -11,6 +11,9 @@
        * readdir.c (dir_can_take_file): Use members in iobuf.
        * rwarray.c (do_writea): Initialize fp to NULL.
 
+       * filefuncs.3am, fnmatch.3am, fork.3am, ordchr.3am, readdir.3am,
+       readfile.3am, rwarray.3am, time.3am: Updated.
+
 2012-08-03         Andrew J. Schorr     <address@hidden>
 
        * readdir.c (dir_get_record): Fix for systems where ino_t is
diff --git a/extension/filefuncs.3am b/extension/filefuncs.3am
index 7969437..592dc07 100644
--- a/extension/filefuncs.3am
+++ b/extension/filefuncs.3am
@@ -1,4 +1,4 @@
-.TH FILEFUNCS 3am "Jul 15 2012" "Free Software Foundation" "GNU Awk Extension 
Modules"
+.TH FILEFUNCS 3am "Aug 08 2012" "Free Software Foundation" "GNU Awk Extension 
Modules"
 .SH NAME
 filefuncs \- provide some file related functionality to gawk
 .SH SYNOPSIS
@@ -170,7 +170,7 @@ The
 function provides a hook to the
 .IR fts (3)
 set of routines for traversing file heirarchies.
-Instead of returning data about one file at a time in a ``stream,''
+Instead of returning data about one file at a time in a stream,
 it fills in a multi-dimensional array with data about each file and
 directory encountered in the requested heirarchies.
 .PP
@@ -295,7 +295,9 @@ The
 .B fts()
 function returns 0 if there were no errors. Otherwise it returns \-1.
 .SH NOTES
-The AWK extension does not exactly mimic the interface of the
+The AWK
+.B fts()
+extension does not exactly mimic the interface of the
 .IR fts (3)
 routines, choosing instead to provide an interface that is based
 on associative arrays, which should be more comfortable to use from
@@ -306,13 +308,15 @@ already provides powerful array sorting facilities.  
While an
 interface could have been provided, this felt less natural than
 simply creating a multi-dimensional array to represent the file
 heirarchy and its information.
-... .SH BUGS
+.SH BUGS
+There are many more file-related functions for which AWK
+interfaces would be desirable.
 .SH EXAMPLE
-.ft CW
-.nf
-FIXME: NEED AN EXAMPLE
-.fi
-.ft R
+See
+.B test/fts.awk
+in the
+.I gawk
+distribution for an example.
 .SH "SEE ALSO"
 .IR "GAWK: Effective AWK Programming" ,
 .IR fnmatch (3am),
@@ -322,6 +326,10 @@ FIXME: NEED AN EXAMPLE
 .IR readfile (3am),
 .IR rwarray (3am),
 .IR time (3am).
+.PP
+.IR chdir (2),
+.IR fts (3),
+.IR stat (2).
 .SH AUTHOR
 Arnold Robbins,
 .BR address@hidden .
diff --git a/extension/fnmatch.3am b/extension/fnmatch.3am
index d438497..b35f626 100644
--- a/extension/fnmatch.3am
+++ b/extension/fnmatch.3am
@@ -1,10 +1,10 @@
-.TH FNMATCH 3am "Jul 12 2012" "Free Software Foundation" "GNU Awk Extension 
Modules"
+.TH FNMATCH 3am "Aug 08 2012" "Free Software Foundation" "GNU Awk Extension 
Modules"
 .SH NAME
 fnmatch \- compare a string against a filename wildcard
 .SH SYNOPSIS
 .ft CW
 @load "fnmatch"
-.br
+.sp
 result = fnmatch(pattern, string, flags)
 .ft R
 .SH DESCRIPTION
@@ -89,6 +89,8 @@ if (fnmatch("*.a", "foo.c", flags) == FNM_NOMATCH)
 .IR readfile (3am),
 .IR rwarray (3am),
 .IR time (3am).
+.PP
+.IR fnmatch (3).
 .SH AUTHOR
 Arnold Robbins,
 .BR address@hidden .
diff --git a/extension/fork.3am b/extension/fork.3am
index 804ad0c..9e545a1 100644
--- a/extension/fork.3am
+++ b/extension/fork.3am
@@ -1,10 +1,10 @@
-.TH FORK 3am "Jul 30 2012" "Free Software Foundation" "GNU Awk Extension 
Modules"
+.TH FORK 3am "Aug 08 2012" "Free Software Foundation" "GNU Awk Extension 
Modules"
 .SH NAME
 fork, wait, waitpid \- basic process management
 .SH SYNOPSIS
 .ft CW
 @load "fork"
-.br
+.sp
 pid = fork()
 .sp
 ret = waitpid(pid)
@@ -42,7 +42,8 @@ There is no corresponding
 .B exec()
 function.
 .PP
-The interfaces could be enhanced to provide more facilities.
+The interfaces could be enhanced to provide more facilities,
+including pulling out the various bits of the return status.
 .SH EXAMPLE
 .ft CW
 .nf
@@ -63,6 +64,10 @@ else
 .IR readfile (3am),
 .IR rwarray (3am),
 .IR time (3am).
+.PP
+.IR fork (2),
+.IR wait (2),
+.IR waitpid (2).
 .SH AUTHOR
 Arnold Robbins,
 .BR address@hidden .
diff --git a/extension/ordchr.3am b/extension/ordchr.3am
index a7d7b90..343c49b 100644
--- a/extension/ordchr.3am
+++ b/extension/ordchr.3am
@@ -1,10 +1,10 @@
-.TH ORDCHR 3am "Jul 11 2012" "Free Software Foundation" "GNU Awk Extension 
Modules"
+.TH ORDCHR 3am "Aug 08 2012" "Free Software Foundation" "GNU Awk Extension 
Modules"
 .SH NAME
 ordchr \- convert characters to strings and vice versa
 .SH SYNOPSIS
 .ft CW
 @load "ordchr"
-.br
+.sp
 number = ord("A")
 .br
 string = chr(65)
diff --git a/extension/readdir.3am b/extension/readdir.3am
index 57c61f3..5f6ae06 100644
--- a/extension/readdir.3am
+++ b/extension/readdir.3am
@@ -1,10 +1,10 @@
-.TH READDIR 3am "Jul 30 2012" "Free Software Foundation" "GNU Awk Extension 
Modules"
+.TH READDIR 3am "Aug 08 2012" "Free Software Foundation" "GNU Awk Extension 
Modules"
 .SH NAME
 readdir \- directory input parser for gawk
 .SH SYNOPSIS
 .ft CW
 @load "readdir"
-.br
+.sp
 readdir_do_ftype(1)    # or 0
 .ft R
 .SH DESCRIPTION
@@ -28,7 +28,19 @@ file:
 .B f
 for file,
 .B d
-for directory, and so on.
+for directory,
+.B b
+for a block device,
+.B c
+for a character device,
+.B p
+for a FIFO,
+.B l
+for a symbolic link,
+.B s
+for a socket, and
+.B u
+(unknown) for anything else.
 .PP
 On systems without the file type information, calling
 .B readdir_do_ftype(1)
@@ -57,6 +69,10 @@ BEGIN { FS = "/" }
 .IR readfile (3am),
 .IR rwarray (3am),
 .IR time (3am).
+.PP
+.IR opendir (3),
+.IR readdir (3),
+.IR stat (2).
 .SH AUTHOR
 Arnold Robbins,
 .BR address@hidden .
diff --git a/extension/readfile.3am b/extension/readfile.3am
index 1bcb94f..f68850a 100644
--- a/extension/readfile.3am
+++ b/extension/readfile.3am
@@ -1,10 +1,10 @@
-.TH READFILE 3am "Jul 11 2012" "Free Software Foundation" "GNU Awk Extension 
Modules"
+.TH READFILE 3am "Aug 08 2012" "Free Software Foundation" "GNU Awk Extension 
Modules"
 .SH NAME
 readfile \- return the entire contents of a file as a string
 .SH SYNOPSIS
 .ft CW
 @load "readfile"
-.br
+.sp
 result = readfile("/some/path")
 .ft R
 .SH DESCRIPTION
diff --git a/extension/rwarray.3am b/extension/rwarray.3am
index b897760..c68e4b4 100644
--- a/extension/rwarray.3am
+++ b/extension/rwarray.3am
@@ -1,12 +1,12 @@
-.TH RWARRAY 3am "Aug 01 2012" "Free Software Foundation" "GNU Awk Extension 
Modules"
+.TH RWARRAY 3am "Aug 08 2012" "Free Software Foundation" "GNU Awk Extension 
Modules"
 .SH NAME
 writea, reada \- write and read gawk arrays to/from files
 .SH SYNOPSIS
 .ft CW
 @load "rwarray"
-.br
-ret = writea(file, array)
 .sp
+ret = writea(file, array)
+.br
 ret = reada(file, array)
 .ft R
 .SH DESCRIPTION
@@ -34,6 +34,19 @@ the array named as the second argument. It clears the array
 first.
 Here too, the return value is 1 on success and 0 on failure.
 .SH NOTES
+The array created by
+.B reada()
+is identical to that written by
+.B writea()
+in the sense that the contents are the same. However, due
+to implementation issues, the array traversal order of the recreated
+array will likely be different from that of the original array.
+As array traversal order in AWK is by default undefined, this is
+not (technically) a problem.  If you need to guarantee a particular
+traversal order, use the array sorting features in
+.I gawk
+to do so.
+.PP
 The file contains binary data.  All integral values are written
 in network byte order.
 However, double precision floating-point values are written as
diff --git a/extension/time.3am b/extension/time.3am
index 53cd175..eba015b 100644
--- a/extension/time.3am
+++ b/extension/time.3am
@@ -1,12 +1,12 @@
-.TH TIME 3am "Jul 30 2012" "Free Software Foundation" "GNU Awk Extension 
Modules"
+.TH TIME 3am "Aug 08 2012" "Free Software Foundation" "GNU Awk Extension 
Modules"
 .SH NAME
 time \- time functions for gawk
 .SH SYNOPSIS
 .ft CW
 @load "time"
-.br
-time = gettimeofday()
 .sp
+time = gettimeofday()
+.br
 ret = sleep(amount)
 .ft R
 .SH DESCRIPTION
@@ -55,6 +55,10 @@ printf "Pausing for a while... " ; sleep(2.5) ; print "done"
 .IR readdir (3am),
 .IR readfile (3am),
 .IR rwarray (3am).
+.PP
+.IR gettimeofday (2),
+.IR nanosleep (2),
+.IR select (2).
 .SH AUTHOR
 Arnold Robbins,
 .BR address@hidden .

-----------------------------------------------------------------------

Summary of changes:
 extension/ChangeLog     |    3 +++
 extension/filefuncs.3am |   26 +++++++++++++++++---------
 extension/fnmatch.3am   |    6 ++++--
 extension/fork.3am      |   11 ++++++++---
 extension/ordchr.3am    |    4 ++--
 extension/readdir.3am   |   22 +++++++++++++++++++---
 extension/readfile.3am  |    4 ++--
 extension/rwarray.3am   |   19 ++++++++++++++++---
 extension/time.3am      |   10 +++++++---
 9 files changed, 78 insertions(+), 27 deletions(-)


hooks/post-receive
-- 
gawk



reply via email to

[Prev in Thread] Current Thread [Next in Thread]