From: Eric Blake <eblake@redhat.com>
Date: Wed, 27 Apr 2011 16:26:42 +0000 (-0600)
Subject: docs: document NetBSD join bug
X-Git-Tag: v2.68b~77
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=5daf0f340412e5733da4e3e474ebbb867c2ebf86;p=thirdparty%2Fautoconf.git

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 c71bf012..14abf514 100644
--- 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 d553f4aa..b466e560 100644
--- 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 ---------------