On Mon, Oct 29, 2018 at 10:20:30AM -0500, David Wright wrote:
> What Brian asked for is an example of a man page that ends with
> "The full documentation for foo is maintained as a Texinfo manual"
> but the info foo output has no more information than man foo.
This used to be more of a problem because dpkg provided an install-info that
couldn't parse the info header used in newer versions of texinfo. This was
obviously a bug but hung around for a while before it was solved. E.g., in
etch the ls man page would point people to the ls info page, but since
install-info didn't parse the index properly, "info ls" couldn't find any ls
info and fell back to displaying the ls man page. It was possible to run
"info coreutils ls", and the coreutils man page tried that later on. This
failed in other cases, which led to the current (awkward) formulation in
which the ls man page references "info '(coreutils) ls invocation'".
Eventually, dpkg's install-info was replaced by the actual texinfo
install-info, so a simple "info ls" also works again.
TL;DR: man pages referencing info pages which are just man pages shouldn't
be a thing anymore.