Documentation matters? [ SOLVED ]

freakcode · 2008-06-12 00:27:18

I'm wondering what's the rationale behind striping man pages from packages. Recently I enjoyed how great is FreeBSD documentation, both online documentation (FreeBSD handbook) and offline documentation with great covering of man pages.

While here, the package doesn't include a man page that is VITAL for something like Awesome, and the associated 'awesomerc'. Looking online is not an alternative, because the site doesn't contain direct access for the same content that is on the man pages. I'm using the Awesome case, but that happens with other packages.

Does documentation matter less for Arch? If so, why?

Last edited by freakcode (2008-06-12 01:00:20)

Allan · 2008-06-12 00:32:43

The package should include man pages as it is generally Arch policy that man pages are enough... So I would file a bug report for the package without them. First do a "pacman -Ql <package>" to make sure man pages are not there but being missed somehow.

freakcode · 2008-06-12 00:43:36

The man page exists (/usr/share/man/man5), but I can't access. In fact, I can't access *various* man pages, beside the fact the files exists.

Any idea? Do I need to generate a catalog or something to 'man' start locating the files? From my past experience with Linux I guessed man was something that 'just works'.

Allan · 2008-06-12 00:45:01

Check that you have merged /etc/profile.pacnew with /etc/profile and MANPATH is unset

freakcode · 2008-06-12 01:00:05

Right on the point. Now I can access most man pages I need.

Barrucadu · 2008-06-12 06:51:38

I am having a similar problem, but that didn't fix it. I can only access manpages by running "sudo man", even when operating as root!

Allan · 2008-06-12 07:05:01

Run "echo $MANPATH" and if it prints anything, find where it is set and nuke it.

MoonSwan · 2008-06-12 23:32:16

There are online man pages too if you ever have need to use them due to space constraints or some other reason(s).

Arch Linux

#1 2008-06-12 00:27:18

Documentation matters? [ SOLVED ]

#2 2008-06-12 00:32:43

Re: Documentation matters? [ SOLVED ]

#3 2008-06-12 00:43:36

Re: Documentation matters? [ SOLVED ]

#4 2008-06-12 00:45:01

Re: Documentation matters? [ SOLVED ]

#5 2008-06-12 01:00:05

Re: Documentation matters? [ SOLVED ]

#6 2008-06-12 06:51:38

Re: Documentation matters? [ SOLVED ]

#7 2008-06-12 07:05:01

Re: Documentation matters? [ SOLVED ]

#8 2008-06-12 23:32:16

Re: Documentation matters? [ SOLVED ]

Board footer