From: Paul Eggert <eggert@cs.ucla.edu>
Date: Thu, 11 Jan 2024 01:45:34 +0000 (-0800)
Subject: doc: mention join bug
X-Git-Tag: v2.72.90~121
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=d8f27addf9c5a6ae838158e0158bf75235b654dd;p=thirdparty%2Fautoconf.git

doc: mention join bug

* doc/autoconf.texi: Mention BSD ‘join’ bug
<https://lists.gnu.org/r/bug-gnulib/2024-01/msg00028.html>.
---

diff --git a/doc/autoconf.texi b/doc/autoconf.texi
index f3ef59e2c..bcd351958 100644
--- a/doc/autoconf.texi
+++ b/doc/autoconf.texi
@@ -19705,6 +19705,11 @@ 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.
 
+On some circa-2020 BSD-based systems @command{join} mishandles inputs
+with missing fields.  For example, an empty line is not treated as
+containing an empty join field.  As a workaround, input lines should
+always have a join field.
+
 On platforms with the BusyBox tools, the @command{join} command is
 entirely missing.  As a workaround, you can simulate special cases of the
 @command{join} command using an @command{awk} script.  For an example,