On the Command Guide page, there are multiple sections with links to the different documentation pages available for LLVM tools. The "Basic Tools" section includes tools like llvm-objdump, llvm-nm and so on. The "Developer Tools" section contains things like FileCheck and lit. This change moves llvm-readobj into the former block, from the latter.
Since llvm-objdump and llvm-nm are in the "Basic Commands" list, and llvm-readobj is used in various test directories: CodeGen/DebugInfo/MC/LTO/..., I think it qualifies as a Basic Command :)
Are you saying LLVM developers aren't people? :p
I actually wonder if we should split out all the binary utilities to a separate section. We should try to advertise the replacement-ness of all the tools we have.
Haha, sorry, that first bit should say "by people outside of LLVM development" or something...
That's probably not a bad shout, though we'd have to figure out exactly what we mean by "binary utilities" as I suspect everybody has a slightly different interpretation of this. Maybe a section labelled "GNU replacements" (note that llvm-readobj wouldn't actually qualify under this!)?
SGTM. There's a definitive list of that here: https://www.gnu.org/software/binutils/
(note that llvm-readobj wouldn't actually qualify under this!)?
I think that's fine -- we should list llvm-readelf in the GNU replacement with a simple page that explains the difference and links to llvm-readobj (see the doc we have for llvm-addr2line for instance)
Actually, maybe I'll just rephrase this in the form of a patch...