docs: document NetBSD join bug

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

Signed-off-by: Eric Blake <eblake@redhat.com>

diff --git a/ChangeLog b/ChangeLog
index c71bf012dba177f61d8fe6b09b552f1e523fa665..14abf514397044ae44b967f9ec65fd076d2211d9 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,10 @@
+2011-04-27  Eric Blake  <eblake@redhat.com>
+
+       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  <eblake@redhat.com>
 
        maint: reflect recent copyright assignments

diff --git a/doc/autoconf.texi b/doc/autoconf.texi
index d553f4aa936ae525aac291c77d3d0d1ff71b1afb..b466e56090f460e8331b2459c71c123f504d413d 100644 (file)
--- a/doc/autoconf.texi
+++ b/doc/autoconf.texi
@@ -18809,6 +18809,9 @@ cat file | join file -
 
 Use @samp{join - file} instead.
 
+On NetBSD, @command{join -a 1 file1 file2} mistakenly behaves like
+@command{join -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 ---------------