You are not logged in.

#1 2007-07-01 01:40:55

Anders
Member
From: Sweden
Registered: 2006-05-19
Posts: 48
Website

Why is documentation stripped from packages?

I don't see why documentation should be stripped from the packages. Why?

If it's because you want smaller package sizes, then I propose:

Make makepkg generate *two* packages. <pkgname>.pkg.tar.gz and <pkgname>-docs.tar.gz, containing the files that originally would have been removed.


Running: Arch Linux i686, x86_64, ppc

Offline

#2 2007-07-01 01:49:01

tardo
Member
Registered: 2006-07-15
Posts: 526

Re: Why is documentation stripped from packages?

that creates more work for devs. its easier to just grab the pkgbuild and add options=('docs') and run makepkg again. not many people read local docs anyway.

Offline

#3 2008-04-20 12:00:05

EmaRsk
Member
From: Italy
Registered: 2003-12-07
Posts: 26

Re: Why is documentation stripped from packages?

There ARE packages which have useful docs, though.
For example, many (such as the core gnu tools) have info entries instead of man pages as their main documentation, and stripping them forces the user to time-consumingly surf the web just to recall a command line option (s)he forgot (not to mention that not everyone has permanent internet connection).
In another post I read "We package what upstream gives us.", which obviously is not true, but should be.

Offline

#4 2008-04-20 13:45:07

iphitus
Forum Fellow
From: Melbourne, Australia
Registered: 2004-10-09
Posts: 4,927

Re: Why is documentation stripped from packages?

this has been discussed to death. Search the forums.

Offline

#5 2008-04-20 13:48:25

bender02
Member
From: UK
Registered: 2007-02-04
Posts: 1,328

Re: Why is documentation stripped from packages?

It's been discussed couple of times - this is the last I remember: http://bbs.archlinux.org/viewtopic.php?id=45583
Official FAQ guideline:
http://wiki.archlinux.org/index.php/FAQ … ackages.3F
Summary: you're welcome to do ..-doc package yourself, even submit to AUR if you want.

Offline

#6 2008-04-20 16:41:24

carlocci
Member
From: Padova - Italy
Registered: 2008-02-12
Posts: 368

Re: Why is documentation stripped from packages?

Anders wrote:

I don't see why documentation should be stripped from the packages. Why?

That's a phase everyone's been into around his 20th-30th post.

Some users just hate documentation, with those users being the devs, I believe.
You are free to fork arch linux or to patch this behaviour making -doc packages in aur for binary pkgs and adding the doc option to PKGBUILDs.

Offline

#7 2008-04-20 18:44:02

cactus
Taco Eater
From: t͈̫̹ͨa͖͕͎̱͈ͨ͆ć̥̖̝o̫̫̼s͈̭̱̞͍̃!̰
Registered: 2004-05-25
Posts: 4,622
Website

Re: Why is documentation stripped from packages?

I don't hate documentation...just info pages.


"Be conservative in what you send; be liberal in what you accept." -- Postel's Law
"tacos" -- Cactus' Law
"t̥͍͎̪̪͗a̴̻̩͈͚ͨc̠o̩̙͈ͫͅs͙͎̙͊ ͔͇̫̜t͎̳̀a̜̞̗ͩc̗͍͚o̲̯̿s̖̣̤̙͌ ̖̜̈ț̰̫͓ạ̪͖̳c̲͎͕̰̯̃̈o͉ͅs̪ͪ ̜̻̖̜͕" -- -̖͚̫̙̓-̺̠͇ͤ̃ ̜̪̜ͯZ͔̗̭̞ͪA̝͈̙͖̩L͉̠̺͓G̙̞̦͖O̳̗͍

Offline

Board footer

Powered by FluxBB