Package: ruby2.1 Version: 2.1.2-2 Severity: normal Right now, ruby-defaults is creating symlinks for every binary, linking to the manpages being provided the default ruby version. This works fine for ruby1.8 and ruby1.9.1, because the manpages are manually included in the debian directory (upstream did not include them). With ruby2.1, no manpages have been included in debian/, presumably because we're relying on the manpages now provided byupstream. The problem is, upstream is not providing a manpage for every binary. As a result, ruby-defaults is creating broken symlinks, and some binaries do not have manpages.
For example, >$ man gem > man: warning: /usr/share/man/man1/gem.1.gz is a dangling symlink > No manual entry for gem > See 'man 7 undocumented' for help when manual pages are not > available. >$ ls -l /usr/share/man/man1/gem.1.gz > lrwxrwxrwx 1 root root 11 May 10 13:13 /usr/share/man/man1/gem.1.gz > -> gem2.1.1.gz >$ ls -l /usr/share/man/man1/gem.2.1.1.gz > ls: cannot access /usr/share/man/man1/gem.2.1.1.gz: No such file or > directory Debian policy says each binary should have a manpage. Therefore, ruby2.1 should be providing manpages for those that don't exist upstream: gem, testrb*, and rdoc. * Caveat: /bin/testrb has actually now been removed upstream, so this may be a pointless endeavour. Some possible approaches: - look at the packages for earlier versions of ruby. The ruby1.8 and 1.9.1 packages both provide the missing manpages. Obviously, these would need to be updated. - use help2man I have labelled this as "normal" for now. Technically, this is a policy violation. However, I know this is one aspect of policy that people tend to turn a blind eye on. -- System Information: Debian Release: jessie/sid APT prefers testing APT policy: (990, 'testing') Architecture: amd64 (x86_64) Kernel: Linux 3.14-1-amd64 (SMP w/2 CPU cores) Locale: LANG=en_CA.UTF-8, LC_CTYPE=en_CA.UTF-8 (charmap=UTF-8) Shell: /bin/sh linked to /bin/dash Versions of packages ruby2.1 depends on: ii libc6 2.19-7 ii libgmp10 2:6.0.0+dfsg-4 ii libruby2.1 2.1.2-2 ii ruby 1:2.1.0.1 ii ruby1.8 [ruby] 1.8.7.358-7.1+deb7u1 ii rubygems-integration 1.7 ruby2.1 recommends no packages. ruby2.1 suggests no packages. -- no debconf information -- To UNSUBSCRIBE, email to debian-bugs-dist-requ...@lists.debian.org with a subject of "unsubscribe". Trouble? Contact listmas...@lists.debian.org
