Gentoo Websites Logo
Go to: Gentoo Home Documentation Forums Lists Bugs Planet Store Wiki Get Gentoo!

Bug 465764

Summary: Add tips for checking correct ebuild dependencies
Product: Documentation Reporter: Pacho Ramos <pacho>
Component: DevmanualAssignee: Gentoo Devmanual Team <devmanual>
Status: RESOLVED FIXED    
Severity: enhancement CC: recruiters
Priority: Normal    
Version: unspecified   
Hardware: All   
OS: Linux   
See Also: https://bugs.gentoo.org/show_bug.cgi?id=571300
https://github.com/gentoo/devmanual/pull/168
Whiteboard:
Package list:
Runtime testing required: ---

Description Pacho Ramos gentoo-dev 2013-04-13 10:11:29 UTC
ebuild-quiz still asks for:
16.	How can you verify an ebuild has correct run time dependencies
	(RDEPEND) for all installed binaries?

docs: handbook

That info was present in the past:
https://gentoo-handbook.lugons.org/proj/en/devrel/handbook/handbook.xml?style=printable&part=2&chap=1#doc_chap5

But, now, I cannot find it:
http://www.gentoo.org/proj/en/devrel/handbook/handbook.xml?part=2&chap=1

Reproducible: Always
Comment 1 nm (RETIRED) gentoo-dev 2013-04-14 07:10:01 UTC
docs in /proj/ are the responsibility of those projects. you'll have to ask a devrel member that knows the motivation for that text removal.
Comment 2 Markos Chandras (RETIRED) gentoo-dev 2014-01-05 00:37:00 UTC
The lugons.org link is dead. Looking at the history in CVS I can't see when tips about finding correct dependencies was ever present in that document (although I may have done poor research)

However, this section in handbook is not updated and needs to be moved to devmanual. So lets fix devmanual instead

Reassigning...
Comment 3 Pacho Ramos gentoo-dev 2014-01-05 09:58:03 UTC
I found an entry in flameeyes blog that maybe would be interesting:
https://blog.flameeyes.eu/2009/02/rdepend-safety

But couldn't find the old entry in old handbook :(
Comment 4 Markos Chandras (RETIRED) gentoo-dev 2014-01-05 09:59:41 UTC
(In reply to Pacho Ramos from comment #3)
> I found an entry in flameeyes blog that maybe would be interesting:
> https://blog.flameeyes.eu/2009/02/rdepend-safety
> 
> But couldn't find the old entry in old handbook :(

Yep me neither. Lets treat this bug as a "feature request" for devmanual.
Comment 5 Göktürk Yüksek archtester gentoo-dev 2016-08-06 16:58:03 UTC
(In reply to Markos Chandras from comment #4)
> (In reply to Pacho Ramos from comment #3)
> > I found an entry in flameeyes blog that maybe would be interesting:
> > https://blog.flameeyes.eu/2009/02/rdepend-safety
> > 
> > But couldn't find the old entry in old handbook :(
> 
> Yep me neither. Lets treat this bug as a "feature request" for devmanual.

The old devrel handbook has a section for this:
https://github.com/gktrk/devrel-handbook/blob/35345715b7c2533a130068f50a5488db4e21b490/hb-guide-ebuild.xml#L1847

Should we consider including it in devmanual?
Comment 6 Pacho Ramos gentoo-dev 2016-08-07 09:55:40 UTC
Yes please, include it if possible :)

Thanks a lot
Comment 7 Ulrich Müller gentoo-dev 2020-01-23 12:17:28 UTC
(In reply to Göktürk Yüksek from comment #5)
> The old devrel handbook has a section for this:
> https://github.com/gktrk/devrel-handbook/blob/
> 35345715b7c2533a130068f50a5488db4e21b490/hb-guide-ebuild.xml#L1847
> 
> Should we consider including it in devmanual?

Ping. Any progress here?
Comment 8 Göktürk Yüksek archtester gentoo-dev 2020-01-27 21:34:18 UTC
(In reply to Ulrich Müller from comment #7)
> (In reply to Göktürk Yüksek from comment #5)
> > The old devrel handbook has a section for this:
> > https://github.com/gktrk/devrel-handbook/blob/
> > 35345715b7c2533a130068f50a5488db4e21b490/hb-guide-ebuild.xml#L1847
> > 
> > Should we consider including it in devmanual?
> 
> Ping. Any progress here?

Let me CC recruiters here as it pertains to the quiz as well.
The text I linked to in devrel-handbook still reads somewhat relevant but it's not complete. I think it will never be complete given the diversity of languages and build systems we support. A newcomer reading a small chapter about checking for correct ebuild dependencies is unlikely to get the full picture.

I suggest that we do not try to document something that will always be incomplete and change the quiz question's "docs" hint to the mentor of the candidate. Alternatively, I'd be ok with a more general list of methods, rather than ELF and autotools centric information, to be listed in the devmanual and still ask the candidate to contact the mentor in addition to devmanual. That still leaves recruiters with the ability to ask more detailed questions about each generic step that would be mentioned in devmanual.
Comment 9 Larry the Git Cow gentoo-dev 2020-05-25 15:43:26 UTC
The bug has been closed via the following commit(s):

https://gitweb.gentoo.org/proj/devmanual.git/commit/?id=3dc3be9929eaa97576882ab23ac02d9f51368f2d

commit 3dc3be9929eaa97576882ab23ac02d9f51368f2d
Author:     Ulrich Müller <ulm@gentoo.org>
AuthorDate: 2020-04-15 18:25:07 +0000
Commit:     Ulrich Müller <ulm@gentoo.org>
CommitDate: 2020-05-09 11:06:19 +0000

    general-concepts/dependencies: Tips for checking dependencies.
    
    This is taken from the Gentoo Developer Handbook, chapter
    "Ebuild HOWTO" (proj/en/devrel/handbook/hb-guide-ebuild.xml),
    section "Package Dependencies", subsection "Important Notes",
    which in turn had been copied from chapter "Common ebuild Mistakes"
    (proj/en/devrel/handbook/hb-guide-common-mistakes.xml), section
    "Common Ebuild Writing Mistakes", subsection "DEPEND is incomplete".
    
    Permission to reuse the CC-BY-SA-1.0 work under CC BY-SA version 2.0
    or any later version of that license obtained from author plasmaroo
    per e-mail on 2015-04-16, Message-ID
    <CAGV+WHCJ61hvw7kh+Wz=uO2esihwc1dXsCWJJWeFAA7UOyyayw@mail.gmail.com>.
    
    Closes: https://bugs.gentoo.org/465764
    Signed-off-by: Ulrich Müller <ulm@gentoo.org>

 general-concepts/dependencies/text.xml | 51 ++++++++++++++++++++++++++++++++++
 1 file changed, 51 insertions(+)