aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorhasufell <julian.ospald@googlemail.com>2012-12-04 20:26:22 +0100
committerhasufell <julian.ospald@googlemail.com>2012-12-04 20:26:22 +0100
commitb0a519807f82c2190129dfa662922c8b061eb368 (patch)
treeeebbb51eb70d9dc6b491fcb7cf9d23ea0f759956 /ebuild-writing/common-mistakes
parentsrc_compile: Add note that flag-o-matic eclass is required (diff)
downloaddevmanual-b0a519807f82c2190129dfa662922c8b061eb368.tar.gz
devmanual-b0a519807f82c2190129dfa662922c8b061eb368.tar.bz2
devmanual-b0a519807f82c2190129dfa662922c8b061eb368.zip
add "Pkgconfig files" section wrt #445130
related discussion [RFC: new eclass - pkgconfig.eclass] at -dev ML
Diffstat (limited to 'ebuild-writing/common-mistakes')
-rw-r--r--ebuild-writing/common-mistakes/text.xml17
1 files changed, 17 insertions, 0 deletions
diff --git a/ebuild-writing/common-mistakes/text.xml b/ebuild-writing/common-mistakes/text.xml
index 6855cf2..b486a7e 100644
--- 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>