From 141956bbd8675bd4e02d1c6a1576e9f3792c94a4 Mon Sep 17 00:00:00 2001 From: Paul Eggert Date: Wed, 10 Jan 2024 17:45:34 -0800 Subject: [PATCH] doc: mention join bug MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit * doc/autoconf.texi: Mention BSD ‘join’ bug . --- doc/autoconf.texi | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/doc/autoconf.texi b/doc/autoconf.texi index f3ef59e2..bcd35195 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, -- 2.43.0