Documentation updates.

5 files changed, 22 insertions, 82 deletions

diff --git a/FUTURES b/FUTURES
index bae8769a..12b9dfa3 100644
--- a/FUTURES
+++ b/FUTURES
@@ -1,4 +1,4 @@
-  Copyright (C) 2005, 2006, 2010 Free Software Foundation, Inc.
+  Copyright (C) 2005, 2006, 2010, 2011 Free Software Foundation, Inc.
   
   Copying and distribution of this file, with or without modification,
   are permitted in any medium without royalty provided the copyright
@@ -9,80 +9,21 @@ in roughly the order they will be done for a given release.  This file is
 mainly for use by the developers to help keep themselves on track, please
 don't bug us too much about schedules or what all this really means.
 
-With the 3.0 release, we are acknowledging that awk is not PERL, nor should
-it become PERL.  (To paraphrase Dennis Ritchie, "If you want PERL, you
-know where to get it.")
-
-The focus on the future is thus narrowed to performance and functional
-enhancements, with only minor plans for significant new features.
-
-(OK, so 3.1 had a bad case of feature-itis.  I think I'm mostly over it
-now, though. :-)
-
-For 3.1.8 + bytecode
-====================
-	DONE: Performance fixes / improvements
-
-	DONE: Change @sourcefile to @include per awk.info poll
-
-	DONE: Document @include
-
-	DONE: Update copyrights
-
-	DONE: Document dgawk
-
-For 4.0
+For 4.1
 =======
-	DONE: Add a single letter option for all long options & document them.
-
-	DONE: Add an FPAT variable and patsplit function where the regex
-	describes the fields, not the separators.
-
-	DONE: Remove support for all unsupported systems.
-
-	DONE: Remove all old README* files.
-
-	DONE: Remove --copyleft, leaving just --copyright.
-
-	DONE: Enable \s, \S in regexes (regcomp.c and dfa.c) and document them.
-
-	DONE: Integrate byte code changes and dgawk
-		Indirect functions
-		BEGINFILE, ENDFILE
+	Merge gawk/pgawk/dgawk into one executable
 
-	DONE: Simplify awk.h.
+	Consider removing use of and/or need for the protos.h file.
 
 	Consider moving var_value info into Node_var itself
 	to reduce memory usage.
 
-	Consider removing use of and/or need for the protos.h file.
-
-	DONE: Make POSIX 2001 behavior the default for sub/gsub.
-
-	DONE: Add IPv6 support.
-
-	DONE: Add true multidimensional arrays.
-
-	Gnulib?
-
-	DONE: Move to git.
-
-	Additional manual features:
-		DONE: Remove all page breaks
-		Review internal notes about reorganization
-		DONE: Full front to back read through - before editing
-		Full front to back read through - after editing
-
-For 4.1
-=======
-	Third arg for asort and asorti to specify sort direction
-
-	Merge gawk/pgawk/dgawk into one executable
-
 	Merge xmlgawk -l feature
 
 	Merge xmlgawk XML extensions
 
+For 4.2
+=======
 	Implement designed API for loadable modules
 
 	Redo the loadable modules interface from the awk level.
@@ -103,9 +44,7 @@ For 4.1
 
 	?? Use a new or improved dfa and/or regex library.
 
-For 4.x:
-========
-	Look at ISO C 99 printf features.
+	??? Gnulib
 
 Probably never:
 ===============
@@ -119,9 +58,3 @@ Probably never:
 
 	Add a lint check if the return value of a function is used but
 	the function did not supply a value.
-
-	Additional manual features:
-		? A section on where gawk is bounded
-			regex
-			i/o
-			sun fp conversions
diff --git a/README b/README
index 9e2ac919..d5c72a57 100644
--- a/README
+++ b/README
@@ -19,7 +19,7 @@ version are summarized in the NEWS file. Please read the LIMITATIONS file.
 Read the file POSIX.STD for a discussion of issues where the standard
 says one thing but gawk does something different.
 
-To format the documentation with TeX, use at least version 2000-10-27.17
+To format the documentation with TeX, use at least version 2010-12-23.17
 of texinfo.tex. There is a usable copy of texinfo.tex in the doc directory.
 
 INSTALLATION:
@@ -35,7 +35,7 @@ generated with bison, and has no proprietary code in it.  (Note that
 modifying awkgram.y without bison or yacc will be difficult, at best.
 You might want to get a copy of bison from the FSF too.)
 
-If you have an MS-DOS or OS/2 system, use the stuff in the `pc'
+If you have an MS-DOS, MS-Windows, or OS/2 system, use the stuff in the `pc'
 directory.  Similarly, there is a separate directory for VMS.
 
 Appendix B of ``GAWK: Effective Awk Programming'' discusses configuration
diff --git a/doc/ChangeLog b/doc/ChangeLog
index cdc4fd39..d6581376 100644
--- a/doc/ChangeLog
+++ b/doc/ChangeLog
@@ -1,3 +1,8 @@
+Wed Apr 27 21:49:23 2011  Arnold D. Robbins  <arnold@skeeve.com>
+
+	* gawk.1: Minor edit.
+	* awkcard.in: Document third arg to asort and asorti.
+
 Thu Apr  7 21:55:27 2011  Arnold D. Robbins  <arnold@skeeve.com>
 
 	* gawk.texi (Nextfile Function): Removed, along with all references,
diff --git a/doc/awkcard.in b/doc/awkcard.in
index d057eee1..57d0c028 100644
--- a/doc/awkcard.in
+++ b/doc/awkcard.in
@@ -1599,15 +1599,16 @@ T}
 .fi
 .in +.2i
 .ti -.2i
-\*(CB\*(FCasort(\*(FIs\*(FC \*(FR[\*(FC, \*(FId\*(FR]\*(FC)\*(FR
+\*(CB\*(FCasort(\*(FIs \*(FR[\*(FC,\*(FI d \*(FR[\*(FC,\*(FI comp\*(FR]]\*(FC)\*(FR
 .br
 Sort the source array \*(FIs\*(FR, replacing the indices with numeric
 values 1 through \*(FIn\*(FR (the number of elements in the array),
 and return the number of elements.
 If destination \*(FId\*(FR is supplied, copy \*(FIs\*(FR to \*(FId\*(FR,
-sort \*(FId\*(FR, and leave \*(FIs\*(FR unchanged.\*(CD
+sort \*(FId\*(FR, and leave \*(FIs\*(FR unchanged.
+Use \*(FIcomp\*(FR to compare indices and elements.\*(CD
 .ti -.2i
-\*(CB\*(FCasorti(\*(FIs\*(FC \*(FR[\*(FC, \*(FId\*(FR]\*(FC)\*(FR
+\*(CB\*(FCasorti(\*(FIs \*(FR[\*(FC,\*(FI d \*(FR[\*(FC,\*(FI comp\*(FR]]\*(FC)\*(FR
 .br
 Like \*(FCasort()\*(FR, but sort on the indices, not
 the values.  The original values are thrown array, so provide a
diff --git a/doc/gawk.1 b/doc/gawk.1
index 57231524..f7ec6d18 100644
--- a/doc/gawk.1
+++ b/doc/gawk.1
@@ -14,7 +14,7 @@
 .		if \w'\(rq' .ds rq "\(rq
 .	\}
 .\}
-.TH GAWK 1 "Apr 24 2011" "Free Software Foundation" "Utility Commands"
+.TH GAWK 1 "Apr 29 2011" "Free Software Foundation" "Utility Commands"
 .SH NAME
 gawk \- pattern scanning and processing language
 .SH SYNOPSIS
@@ -309,13 +309,14 @@ This option disables command-line variable assignments.
 .PD
 .B \-\^\-gen\-pot
 Scan and parse the \*(AK program, and generate a \*(GN
-.B \&.po
+.B \&.pot
+(Portable Object Template)
 format file on standard output with entries for all localizable
 strings in the program.  The program itself is not executed.
 See the \*(GN
 .I gettext
 distribution for more information on
-.B \&.po
+.B \&.pot
 files.
 .TP
 .PD 0