add "Pkgconfig files" section wrt #445130

related discussion [RFC: new eclass - pkgconfig.eclass] at -dev ML
gentoo · Dec 4, 2012 · b0a5198 · b0a5198
1 parent 6e448cc
commit b0a5198
Showing 1 changed file with 17 additions and 0 deletions.
diff --git a/ebuild-writing/common-mistakes/text.xml b/ebuild-writing/common-mistakes/text.xml
@@ -349,6 +349,23 @@ running <c>dodoc</c>/<c>doins</c>.
 </body>
 </subsection>
 
+<subsection>
+<title>Pkgconfig files</title>
+<body>
+
+<p>
+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).</p>
+<p>
+Ignoring this policy can result in breakage for other distros and also breaks
+the purpose of this interface, because it is not reliable anymore.
+</p>
+</body>
+</subsection>
+
 </body>
 </section>