This is a bit perplexing, because the transition to /usr/share/man completed before Ubuntu even existed; I think it even predates my taking over maintainership of man-db 20 years ago or so. Is it really easier to go through all of this mess with symlinks rather than just updating a few extremely old scripts? I know reflexes can be harder, but still, it's been 20 years.
We can perhaps improve some documentation, but I don't currently think it's going to be worth the development effort to improve handling of the case where somebody has manually inserted a /usr/man symlink.
This is a bit perplexing, because the transition to /usr/share/man completed before Ubuntu even existed; I think it even predates my taking over maintainership of man-db 20 years ago or so. Is it really easier to go through all of this mess with symlinks rather than just updating a few extremely old scripts? I know reflexes can be harder, but still, it's been 20 years.
We can perhaps improve some documentation, but I don't currently think it's going to be worth the development effort to improve handling of the case where somebody has manually inserted a /usr/man symlink.