--- devmanual/ebuild-writing/common-mistakes/text.xml +++ devmanual/ebuild-writing/common-mistakes/text.xml @@ -349,6 +349,23 @@ + +Pkgconfig files + + +

+Pkgconfig files (foo.pc) are common interfaces to standardize access to libraries +across distros. It is important that these are never modified, created or renamed +anywhere except upstream. Report bugs, write patches and send them upstream, but +don't mess with them in your ebuild unless it's a trivial (like adding libsuffix) +or unavoidable fix (which should be discussed with other devs first).

+

+Ignoring this policy can result in breakage for other distros and also breaks +the purpose of this interface, because it is not reliable anymore. +

+ + +