I happened to see mention of revdep-rebuild on the gentoo-dev mailing list. This useful program is not described in any of Gentoo's user or developer docs (sez Google), but it should be! I also didn't find any documentation of how it works beyond the source code itself and a brief help message. A man page would be wonderful. Reproducible: Always Steps to Reproduce: 1. 2. 3.
I'll see what revdep-rebuild does (by looking at the code, 'cause I don't know what it does either).
Created attachment 20179 [details, diff] gentoo-howto patch This patch adds "revdep-rebuild" to the list of usefull tools. I don't see the need for a manpage, especially because I can't find any more usefull information to place in such a manpage that isn't described by the "revdep-rebuild --help" output...
If a docdev can agree with this, I can commit
i dont see why you're putting it with the gentoo howto ... that doc file is 'how to make ebuilds' ... revdep-rebuild is about rebuilding packages that have been broken by libraries going missing ...
Hrmpf... also true. It should be placed in portage-manual then, right next to the qpkg and other tools, no?
that'll do it for me
well, it'll work for me if you update the description ;) revdep-rebuild was not designed because of portage bugs or because someone screwed up ... it was made to update packages that were broken when updating libraries that have incompatible binary API's (in general) ... for example, openssl or directfb ... they remove the linked libraries because the newer package is not binary API compatible with previous versions and the package is not designed to have both versions installed at the same time
Can I just rip that description? :)
Created attachment 20366 [details, diff] Patch to portage-manual Okay, this one just adds a line about revdep-rebuild. I don't know how to explain further as the tool just... does what it should do (although I couldn't use it when my openssl-library broke -- but perhaps it's not meant to do this). Is this patch okay? At least we then mention the tool...
patch looks good
Committed. Thanks for reporting.
"I don't see the need for a manpage, especially because I can't find any more usefull information to place in such a manpage that isn't described by the "revdep-rebuild --help" output..." Well? Put the revdep-rebuild --help output _into_ the manual page instead? Makes no sense it tells you there is no help available.
You should actually create a new bugreport for this; manpages isn't for the documentation team and the main objective of this bug (describing revdep-rebuild in the docs) has been fixed.
why document that same exact thing in a manpage that is in --help ? all it leads to is more maintenance and bugs, especially if the writer updates the pkg and thus --help but forgets the manpage