Bug 243380 – sys-apps/portage-2.1.4.5: documentation for fixpackages missing

• Product: Portage Development
• Status: RESOLVED OBSOLETE

[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) 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:
http://www.gentoo.org/doc/en/handbook/handbook-x86.xml?part=3&chap=4

[Comment 2 Jan Kundrát (RETIRED) 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 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 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.