Gentoo Websites Logo
Go to: Gentoo Home Documentation Forums Lists Bugs Planet Store Wiki Get Gentoo!
Bug 243380 - sys-apps/portage- documentation for fixpackages missing
Summary: sys-apps/portage- documentation for fixpackages missing
Alias: None
Product: Portage Development
Classification: Unclassified
Component: Documentation (show other bugs)
Hardware: All Linux
: High normal (vote)
Assignee: Portage team
Depends on:
Reported: 2008-10-23 13:03 UTC by Stephan Springer
Modified: 2011-10-12 12:50 UTC (History)
1 user (show)

See Also:
Package list:
Runtime testing required: ---


Note You need to log in before you can comment on or make changes to this bug.
Description Stephan Springer 2008-10-23 13:03:18 UTC
There is no man page for /usr/sbin/fixpackages and I can't find anything in the online documentation either.  There is only a tiny paragraph describing the *feature* called fixpackages in make.conf(5), but the details about what this feature (and script?) does and why or when it should be done are absent.

Additionally, calling "fixpackages --help" doesn't give any help either.  Instead it just seams to start doing its work.

Expected result: All scripts in sys-apps/portage have a man-page and honor the "standard" options --help and --version.
Comment 1 Wormo (RETIRED) gentoo-dev 2008-10-24 06:43:39 UTC
The fixpackages script does what that entry in make.conf man page says:

"script that will fix the dependencies in all binary packages"

Also a hint why dependencies might be broken and need fixing:

"run whenever packages are moved around in the portage tree"

You are not the only one who can't find anything about fixpackages in the excellent online Gentoo docs, but I think this could be a good place for it to be added:
Comment 2 Jan Kundrát (RETIRED) gentoo-dev 2008-10-29 08:46:26 UTC
This is about a missing Portage manpage. If you Portage guys feel that it's GDP's turn to document this in the Handbook, just re-assign it back to us. See you.
Comment 3 Zac Medico gentoo-dev 2008-10-29 18:45:10 UTC
In portage-2.2_rc the fixpackages functionality is available as `emaint --fix movebin`, so we might consider dropping fixpackages and updating the messages to suggest emaint instead of fixpackages. The emaint manpage currently only mentions "all" and "world" targets, so we should update it to document the new targets that have been added in portage-2.2_rc.
Comment 4 Sebastian Luther (few) 2010-05-01 19:09:41 UTC
Is there any reason to keep fixpackages?
Comment 5 Zac Medico gentoo-dev 2010-05-01 19:13:38 UTC
(In reply to comment #4)
> Is there any reason to keep fixpackages?

No, let's remove it.
Comment 6 Benny Pedersen 2010-05-03 18:26:34 UTC
if fixpakages will get removed its no need for me to make a bug more for it, sys-apps/portage (fixpakages) does need python compiled with ssl to work in stable amd64, thats a know issue for me, but its not a killing ground :)
Comment 7 Sebastian Luther (few) 2011-10-12 12:50:37 UTC
FEATURES="fixpackages" has been removed. Closing.