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

Bug 36307

Summary: PDEPEND not mentioned in the ebuild howto
Product: [OLD] Docs-developer Reporter: Heinrich Wendel (RETIRED) <lanius>
Component: Portage DocumentationAssignee: Sven Vermeulen (RETIRED) <swift>
Status: RESOLVED WONTFIX    
Severity: normal CC: creidieki+gentoobugs, docs-team
Priority: High    
Version: unspecified   
Hardware: All   
OS: All   
URL: http://www.gentoo.org/doc/en/gentoo-howto.xml
Whiteboard:
Package list:
Runtime testing required: ---
Attachments: Patch to gentoo-howto

Description Heinrich Wendel (RETIRED) gentoo-dev 2003-12-22 09:13:21 UTC
This should be added to the ebuild howto (from ebuild(5)):

PDEPEND:

This should contain a list of all packages that will have to  be
installed after the program has been merged.
You  may  use the same syntax to vary dependencies as seen above
in DEPEND.
Comment 1 Sven Vermeulen (RETIRED) gentoo-dev 2003-12-22 10:59:16 UTC
Created attachment 22550 [details, diff]
Patch to gentoo-howto

Patch that adds information about PDEPEND. If a docdev can review?
Comment 2 Erwin (RETIRED) gentoo-dev 2003-12-22 20:53:17 UTC
patch looks good.
Comment 3 SpanKY gentoo-dev 2003-12-22 22:12:15 UTC
i would disagree about adding PDEPEND to the HOWTO ...

the howto is exactly that, a howto ... it isnt the manual, thats what the manpage is for ... PDEPEND can be found in a very small minority of ebuilds where as DEPEND and RDEPEND can be found in a very large majority ...

in other words, adding uncommond stuff like this to the howto just adds more for people to try to ingest when learning 'howto make an ebuild' for the first time
Comment 4 Sven Vermeulen (RETIRED) gentoo-dev 2003-12-23 00:36:56 UTC
I personally have no real opinion on this subject. I'll mark it as wontfix then and point to spanky vapier as he's more involved with ebuilds and such than me :)
Comment 5 Heinrich Wendel (RETIRED) gentoo-dev 2003-12-23 02:29:56 UTC
In this case it should be clear that it does not listen all portage stuff (btw. there is listed a lot of uncommon stuff) and point to the ebuild man page. I assumed it is a full reference of portage. 
Comment 6 Sven Vermeulen (RETIRED) gentoo-dev 2003-12-23 02:41:42 UTC
It already mentions that:

"""
Contents of an ebuild File 

Note: This section is an introduction to ebuilds. For the full listing of everything possible in an ebuild, there is a manpage which talks about the internal format, variables, and functions in an ebuild script: man 5 ebuild. 
"""
Comment 7 SpanKY gentoo-dev 2004-06-27 12:56:59 UTC
*** Bug 55331 has been marked as a duplicate of this bug. ***