Project

General

Profile

Bug #16823

Bundler related manual pages are corrupted

Added by Kulikjak (Jakub Kulik) 2 months ago. Updated about 2 months ago.

Status:
Closed
Priority:
Normal
Assignee:
-
Target version:
-
ruby -v:
ruby 2.6.5p114 (2019-10-01 revision 67812) [amd64-solaris2.11]
[ruby-core:98095]

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) about 2 months ago

I've confirmed this bug and submitted a pull request to fix it: https://github.com/ruby/ruby/pull/3147

#2

Updated by jeremyevans (Jeremy Evans) about 2 months 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]

Also available in: Atom PDF