Subject: join(1) info page -o: too hazy at first

From: Dan Jacobson <[email-masked]>
Date: Sat, 27 Apr 2024 06:11:50 +0800

The join main page is really clear,

       -o FORMAT
              obey FORMAT while constructing output line

A base hit on the first pitch. The info page on the other hand,

‘-o FIELD-LIST’
‘-o auto’
     If the keyword ‘auto’ is specified, infer the output format from
     the first line in each file.  This is the same as the default
     output format but also ensures the same number of fields are output
     for each line.  Missing fields are replaced with the ‘-e’ option
     and extra fields are discarded.

even after reading down to here, hasn't tipped the user off that it is
talking about the output format! It's its turn up to bat but it's still
drinking coffee in the bullpen.

In fact FIELD-LIST vs FORMAT make the user double check that they are
actually looking at the same commands' documentation.