aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
-rw-r--r--extension/ChangeLog4
-rw-r--r--extension/revtwoway.3am61
2 files changed, 65 insertions, 0 deletions
diff --git a/extension/ChangeLog b/extension/ChangeLog
index d83b1942..0874ed1a 100644
--- a/extension/ChangeLog
+++ b/extension/ChangeLog
@@ -1,3 +1,7 @@
+2012-10-24 Arnold D. Robbins <arnold@skeeve.com>
+
+ * revtwoway.3am: New file.
+
2012-10-21 Arnold D. Robbins <arnold@skeeve.com>
* filefuncs.c (do_stat): Always clear the array.
diff --git a/extension/revtwoway.3am b/extension/revtwoway.3am
new file mode 100644
index 00000000..89b92583
--- /dev/null
+++ b/extension/revtwoway.3am
@@ -0,0 +1,61 @@
+.TH REVTWOWAY 3am "Oct 24 2012" "Free Software Foundation" "GNU Awk Extension Modules"
+.SH NAME
+revtwoway \- Reverse strings sample two-way processor extension
+.SH SYNOPSIS
+.ft CW
+@load "revtwoway"
+.sp
+.nf
+BEGIN {
+ print "hello, world" |& "/magic/morrir"
+ "/magic/mirror" |& getline result
+ print result
+}
+.fi
+.ft R
+.SH DESCRIPTION
+The
+.I revtwoway
+extension
+adds a simple two-way processor that reverses the characters
+in each line sent to it for reading back by the AWK program.
+It's main purpose is to show how to write a two-way extension, although
+it may also be mildy amusing.
+... .SH BUGS
+.SH "SEE ALSO"
+.IR "GAWK: Effective AWK Programming" ,
+.IR filefuncs (3am),
+.IR fnmatch (3am),
+.IR fork (3am),
+.IR ordchr (3am),
+.IR readdir (3am),
+.IR readfile (3am),
+.IR revoutput (3am),
+.IR rwarray (3am),
+.IR time (3am).
+.SH AUTHOR
+Arnold Robbins,
+.BR arnold@skeeve.com .
+.SH COPYING PERMISSIONS
+Copyright \(co 2012
+Free Software Foundation, Inc.
+.PP
+Permission is granted to make and distribute verbatim copies of
+this manual page provided the copyright notice and this permission
+notice are preserved on all copies.
+.ig
+Permission is granted to process this file through troff and print the
+results, provided the printed document carries copying permission
+notice identical to this one except for the removal of this paragraph
+(this paragraph not being relevant to the printed manual page).
+..
+.PP
+Permission is granted to copy and distribute modified versions of this
+manual page under the conditions for verbatim copying, provided that
+the entire resulting derived work is distributed under the terms of a
+permission notice identical to this one.
+.PP
+Permission is granted to copy and distribute translations of this
+manual page into another language, under the above conditions for
+modified versions, except that this permission notice may be stated in
+a translation approved by the Foundation.