Bug #16823
closed
Bundler related manual pages are corrupted
Description
We recently found out that bundler related manual pages we get by building and installing ruby 2.6 (and as far as I can tell all newer versions as well) are corrupted (we are building with --with-mantype=man).
The reason is that, e.g. ruby.1 (in the downloaded source) is not in the man format and must be passed through mdoc2man, bundle.1 is already valid man format, and passing it through mdoc2man corrupts it. The difference can be seen in the repo (those are different formats):
https://github.com/ruby/ruby/blob/master/man/ruby.1
https://github.com/ruby/ruby/blob/master/man/bundle.1
It seems like all man pages are always passed through mdoc2man no matter their content.
This happens to us on Solaris, although I cannot see how this can be isolated just to us (unless I am doing something wrong). We solved this simply by overwriting corrupted manpages with those directly downloaded, but I guess that they should be correct right after the installation.
Updated by jeremyevans0 (Jeremy Evans) over 4 years ago
I've confirmed this bug and submitted a pull request to fix it: https://github.com/ruby/ruby/pull/3147
Updated by jeremyevans (Jeremy Evans) over 4 years ago
- Status changed from Open to Closed
Applied in changeset git|e0b40ef5d8173aff304c81f93516e1246e3c042c.
Don't convert bundler man pages from mdoc to man
These man pages are already in man format and assuming they are
mdoc format breaks things.
Fixes [Bug #16823]