You are not logged in.
As you all might know, Arch believes in having man pages all the way, with almost no packages having their additional documentation (found in 'usr/share/doc' and '/usr/doc').
The reason given is to keep the distro lightweight, however this does remove a lot of extra documentation and example files that developers provide for their programs.
What I'm asking here is whether people would like the extra documentation or not. For a distro which doesn't hand hold they would be useful. On the other hand, their exclusion saves some disk space.
Offline
Why isn't there an option: "I don't care" ?
at least, my vote goes to "I don't care" ==>> so I made it a no
Offline
As you all might know, Arch believes in having man pages all the way, with almost no packages having their additional documentation (found in 'usr/share/doc' and '/usr/doc').
The reason given is to keep the distro lightweight, however this does remove a lot of extra documentation and example files that developers provide for their programs.
What I'm asking here is whether people would like the extra documentation or not. For a distro which doesn't hand hold they would be useful. On the other hand, their exclusion saves some disk space.
Yes, I want it.
Offline
I don't really care. And since you can find almost everything on the net, I voted no.
Offline
On the other hand, their exclusion saves some disk space.
It's not just disk space, but bandwidth too. Those of us with less-than-uber connections prefer the packages to be as lean as possible.
Additionally, I haven't yet had a program I couldn't look up documentation on the net somewhere. I voted no.
Offline
No for me too. Apart from the ease of finding what you need on the net, you're talking about an element of the Arch philosophy. In other words,
Arch + docs + info + etc != Arch.
Offline
Nay.
Frumpus ♥ addict
[mu'.krum.pus], [frum.pus]
Offline
I've never really used the info command help files. when man isn't enough I went directly to google/forums/wiki, so I voted for no.
Have You ever been...?
Offline
Don't care, usually, but a definite NO where the most extensive documentation is the one I usually do not use. ;-)
Offline
I voted no.
I used it some before, just for pyqt examples or something like that back on fedora, but not anymore... I now use manpages for documentation of apps and the web for tutorials, works fine for me.
Offline
This has been discussed about 4 times on the ML as well so I suggest you look at the archives for even more arguements against!
Offline
it appears to me that anyone who has the motivation, skill and strikingly good looks to install Arch is not likely the sort of person who will need docs installed. As opposed to say ubuntususefedora, who are actively targeting experienced as well as new linux users.
fck art, lets dance.
Offline
But how many new users access documentation outside manpages? Not many I'd wager. A lot of the content in doc consists of example config files and scripts - precisely the sort of detailed information that experienced users need.
Offline
it appears to me that anyone who has the motivation, skill and strikingly good looks to install Arch is not likely the sort of person who will need docs installed. As opposed to say ubuntususefedora, who are actively targeting experienced as well as new linux users.
IMO what is wrong if I have documentation for Shorewall for example in /usr/share/doc? Why I need to go everytime if I need something to the web page? It is my opinion.
Offline
Offline
Me, I could never figure out how to use the info viewer, that thing is fricking scary. man pages all the way!
Well, google serves me better than man, now.
Dusty
Offline
Yes. I have some times without Internet, and manpages for GNU utilities are a joke.
Excessive showering, grooming, and toothbrushing is not only vain, it wastes valuable coding time.
Offline
As much as you think this is original content, it's not. People can banter about the relative merits of info docs all day long, problem is, none of the devs want them included, so any sort of vote is vetoed.
PKGBUILDs *can* include a 'keepdocs' option, but that is not to be used all the time, it is there in case man pages fail (i.e. 'man grub' to see what I mean)
On a side note, there is also info2man, which can be used to just get rid of the info pages for GNU utilities.
Offline
Great news, I will look at this program
Excessive showering, grooming, and toothbrushing is not only vain, it wastes valuable coding time.
Offline
If you want them so desperately, use info2man in your PKGBUILDs to install them. Otherwise, no it's not happening.
Info2man is in the aur.
Offline
phrakturem, I don't think this is original content, I checked the past threads and though an ongoing poll will be interesting.
iphitus, thanks for the pointer regarding info2man, will take a look at it.
Offline
short note: I think info2man should be somehow pointed in Arch Packaging... something.. don't remember where this info was... (in the Wiki).
:: / my web presence
Offline