[PATCH] docs: document NetBSD join bug

[Eric Blake]

* doc/autoconf.texi (Limitations of Usual Tools) <join>: Mention
bug in -a parsing.
Reported by J.T. Conklin.

Signed-off-by: Eric Blake <address@hidden>
---

Here's what I'm pushing to autoconf, based on:
http://thread.gmane.org/gmane.comp.lib.gnulib.bugs/26168/focus=26170
and confirmed by my testing on a NetBSD machine.

 ChangeLog         |    7 +++++++
 doc/autoconf.texi |    3 +++
 2 files changed, 10 insertions(+), 0 deletions(-)

diff --git a/ChangeLog b/ChangeLog
index c71bf01..14abf51 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,10 @@
+2011-04-27  Eric Blake  <address@hidden>
+
+       docs: document NetBSD join bug
+       * doc/autoconf.texi (Limitations of Usual Tools) <join>: Mention
+       bug in -a parsing.
+       Reported by J.T. Conklin.
+
 2011-04-13  Eric Blake  <address@hidden>

        maint: reflect recent copyright assignments
diff --git a/doc/autoconf.texi b/doc/autoconf.texi
index d553f4a..b466e56 100644
--- a/doc/autoconf.texi
+++ b/doc/autoconf.texi
@@ -18809,6 +18809,9 @@ Limitations of Usual Tools

 Use @samp{join - file} instead.

+On NetBSD, @command{join -a 1 file1 file2} mistakenly behaves like
address@hidden -a 1 -a 2 1 file1 file2}, resulting in a usage warning;
+the workaround is to use @command{join -a1 file1 file2} instead.

 @item @command{ln}
 @c ---------------
-- 
1.7.4.4