FS#5392 - manpage issues

Attached to Project: Arch Linux
Opened by Jens Adam (byte) - Monday, 11 September 2006, 23:07 GMT
Last edited by Jan de Groot (JGC) - Monday, 08 June 2009, 08:33 GMT
Task Type Bug Report
Category Documentation
Status Closed
Assigned To Aaron Griffin (phrakture)
Architecture All
Severity Low
Priority Normal
Reported Version 0.7.2 Gimmick
Due in Version Undecided
Due Date 2009-01-05
Percent Complete 100%
Votes 0
Private No

Details

The saslauthd (cyrus-sasl) manpage looks broken and I noticed that many manpages are not gzipped:

bc
diffutils
e2fsprogs
ed
gzip
heimdal
jfsutils
patch
perl
psutils
rdate
snarf
sudo
tcl
tk

I'll look for more on my desktop computer that has a lot different pkgs.
The command: find /usr/man/ -type f ! -name '*.gz' | grep -v /whatis$ | xargs pacman -Qo | cut -d' ' -f5 | sort | uniq > ~/unzipped-manpages
(slow as hell, if your mind is brighter you better parse /var/lib/pacman/local/*/files)
This task depends upon

Closed by  Jan de Groot (JGC)
Monday, 08 June 2009, 08:33 GMT
Reason for closing:  Deferred
Additional comments about closing:  Most have been fixed already, or will get fixed soon. There's no point in keeping a bug open for random packages with this bug.
Comment by Jens Adam (byte) - Monday, 11 September 2006, 23:31 GMT
Hey, this is better:
pacman -Ql | grep ' /usr/man/' | grep -vE '\.gz$|/$' | cut -d' ' -f1 | uniq > ~/unzipped-manpages

rec.1 (sox) and slogin.1 (openssh) are symlinks and don't work.
Comment by Jens Adam (byte) - Wednesday, 13 September 2006, 05:35 GMT
Just two more: normalize (pkg from 2002) and emelfm2 (.bz2 even)
Comment by Jens Adam (byte) - Thursday, 01 February 2007, 10:12 GMT Comment by Andrew Fyfe (space-m0nkey) - Sunday, 08 April 2007, 22:49 GMT
This is actualy an issue with makepkg.

- pages compressed with bz2 are not changed
- pages that are installed (by pkgs make install) as hard links are not compressed

Comment by Francois Charette (Firmicus) - Wednesday, 10 October 2007, 18:31 GMT
Two more :
* ghostscript --- see  bug 8280 
* vi --- see  bug 8282 

I also opened one for sox ( bug 8281 ) but it was already mentioned above...
Comment by Jens Adam (byte) - Monday, 03 December 2007, 01:42 GMT
- Gimp is another candidate (gimp-console/gimptool)

- /usr/man/man8/traceroute.8.gz (iputils) has 444 perms and owner bin:bin

Run 'find /usr/man/ -type f ! -perm 644 -ls' or something similar to find a lot more of those.
Comment by Dan McGee (toofishes) - Wednesday, 05 December 2007, 13:54 GMT
See the following commit to makepkg:
<http://projects.archlinux.org/git/?p=pacman.git;a=commit;h=9615d82343148301884bfc79d87e2f408aad64bd>
Comment by Dan McGee (toofishes) - Thursday, 03 January 2008, 06:26 GMT
From a pacman point of view, I don't think there is much more we can do here. manpage permissions are really the job of the packager and/or package itself- we shouldn't artificially muck with permissions. I'm going to remove this from the 3.1 release bug as we have made several advances there, including the gzipping of the hard linked manpages.
Comment by Dan McGee (toofishes) - Friday, 08 February 2008, 19:09 GMT
Anything actionable here? If not I'd like to close this. If there is, an updated list of packages with broken manpages would be nice and I can open up a TODO list for that.
Comment by Jens Adam (byte) - Saturday, 09 February 2008, 05:27 GMT
This was never intended as a pacman/makepkg bug, so there's still a few pkgs left. Following are those I found with this line:
$ find /usr/man/ /usr/share/man/ -type f ! -perm 644 | xargs pacman -Qo | awk '{print $5}' | sort -u

cairo-perl
csup
device-mapper
dhcpcd
frozen-bubble
glade-perl
glib-perl
gtk2-perl
imagemagick
iputils
lvm2
mt-st
newsbeuter
perl-libxml-common
perl-xml-sax
procps
qemu
sudo
tcl
tk
tzdata

Obviously I didn't check every single repo pkg, but I might add more comments with results from my other PCs. A quick check with Fedora 8 and Debian 4.0 revealed that both obey FHS paths with /usr/share/man and Debian is really anal with 644 permissions (0 hits) while Fedora isn't (TCL for example).

As for the non-gzipped ones; those should get fixed over time with pkgs rebuilds, they're mostly hardlinks.
Comment by Jens Adam (byte) - Saturday, 09 February 2008, 07:31 GMT
foomatic-filters
gocr
net-snmp
p7zip
ppp
privoxy
rdiff-backup
root-tail
schedtool
sdl_perl
subversion
vectoroids
(sorry for being too lazy to mark the ones from community)
Comment by Roman Kyrylych (Romashka) - Saturday, 09 February 2008, 09:14 GMT
Just FYI, TODO list for Core/Extra is created already.
Comment by Gavin Bisesi (Daenyth) - Wednesday, 04 June 2008, 17:54 GMT
What's the status on this?
Comment by Gavin Bisesi (Daenyth) - Tuesday, 07 October 2008, 15:41 GMT
Bump
Comment by Glenn Matthys (RedShift) - Friday, 05 December 2008, 11:51 GMT
I've assigned this bug to the maintainers of the packages in the report. Note that rdate is not in core/extra.
Comment by Allan McRae (Allan) - Friday, 05 December 2008, 11:58 GMT
Any package built since pacman 3.1 will have this fixed.
Comment by Dan McGee (toofishes) - Friday, 05 December 2008, 13:19 GMT
Very true. Do we need to explicitly address these, or just slowly let them be brought up to date as we go here?
Comment by Gavin Bisesi (Daenyth) - Friday, 05 December 2008, 13:23 GMT
I think it's fine to just let them get updated as the package is updated. Perhaps some sort of time limit though would be in order, for software with long release schedules.
Comment by Glenn Matthys (RedShift) - Friday, 05 December 2008, 13:26 GMT
I've set the due date to the 5th of january.
Comment by Glenn Matthys (RedShift) - Friday, 05 December 2008, 13:31 GMT
Most of these packages already have correct gzip'ed manpages. Only the snarf package has no gzip'ed manpage. I'm removing all the assignees that have their packages fixed.
Comment by Jens Adam (byte) - Friday, 05 December 2008, 13:47 GMT
I still get many unzipped manpages, even in recent packages. Might be that some devs still don't have 'zipman' in makepkg.conf.
The ones with wrong (well, mostly 444) permissions are more of an Makefile patch issue, true.
Comment by Glenn Matthys (RedShift) - Friday, 05 December 2008, 13:51 GMT
Can you post a list of the packages you are talking about? In the list above they all are OK.
Comment by Jens Adam (byte) - Friday, 05 December 2008, 14:51 GMT
ca-certificates
clive
deluge
emerald
file
hal
lame
logrotate
mlocate
mplayer
namcap
openssh
opera
p7zip
postfix
run-parts
shadow
stellarium
wireshark
zsh

(i686 without [testing])
Comment by Jens Adam (byte) - Friday, 05 December 2008, 16:02 GMT
Also:

mpg123
mysql (FHS!)
nasm
testdisk
Comment by Glenn Matthys (RedShift) - Friday, 05 December 2008, 23:03 GMT
Aaron, will these packages be rebuilt to fix this detail or will these get fixed along the way?
Comment by Jens Adam (byte) - Saturday, 06 December 2008, 01:48 GMT
...
dnsmasq
dsniff (community)
optipng (community, FHS!)
sysstat (community)
unshield (community)

A few notes for packages I mentioned before:
- ca-certificates and hal are fixed in testing
- openssh needs FHS-fixing
- clive, emerald, testdisk -> [community]

(this and my small comment before were also for i686 machines, with testing enabled)

IMO it's nothing serious, so fix it in trunk only.
Comment by Andreas Radke (AndyRTR) - Tuesday, 23 December 2008, 08:37 GMT
fixed diffutils
Comment by Aaron Griffin (phrakture) - Tuesday, 23 December 2008, 17:32 GMT
I imagine they'll get fixed along the way... trickle-down is easier on all the maintainers. Unless, of course, someone wants to power through a bunch of these at once 8)
Comment by Andreas Radke (AndyRTR) - Wednesday, 18 February 2009, 22:24 GMT
Are there packages from the official repos left? Other packages should be listed each in a new report and should be assigned to the corresponding TU.
Comment by Allan McRae (Allan) - Thursday, 19 February 2009, 09:41 GMT
From downloading the filelists on the mirrors and running:
grep -R -e "usr/man" -e "usr/share/man" * | grep -v ".gz" | grep -v "/$" | cut -f1 -d"/" | uniq

packages in core without gzipped man pages:
libarchive
logrotate
madwifi-utils
module-init-tools
pcmciautils
run-parts
shadow
syslog-ng
wlan-ng-utils
xfsprogs
Comment by Dan McGee (toofishes) - Thursday, 19 February 2009, 13:30 GMT
I have no idea how libarchive ended up non-gzipped, but if I rebuild it locally they get gzipped, so that is odd.

I'll take care of that on the next rebuild. It might be fine just to close this bug and let the rest go as they are rebuilt, although surely some of these have been rebuilt within the last year.
Comment by Andreas Radke (AndyRTR) - Thursday, 19 February 2009, 16:19 GMT
maybe not everybody has added zipman option to the makepkg.conf when merging with the .pacnew.

anyway I'm also fine with closing this one. maybe we should send this pkg list to the public list or to the maintainers to check their chroots. none of these package is mine. going to remove myself from this bug.

Loading...