--- devmanual/ebuild-writing/common-mistakes/text.xml +++ devmanual/ebuild-writing/common-mistakes/text.xml @@ -349,6 +349,23 @@ + +Modifying/Adding/Renaming 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.

+

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

+ + +