aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorMark Loeser <halcy0n@gentoo.org>2007-12-16 02:59:36 +0000
committerMark Loeser <halcy0n@gentoo.org>2007-12-16 02:59:36 +0000
commitc58aabab4f305d802a040e031af0acf8ba7ffa5d (patch)
treecbca956ad9fc9f87b2d0d43ec12dfb16c9b83e2d
parentMention ESVN_OPTIONS; fixes bug #156657 (diff)
downloaddevmanual-c58aabab4f305d802a040e031af0acf8ba7ffa5d.tar.gz
devmanual-c58aabab4f305d802a040e031af0acf8ba7ffa5d.tar.bz2
devmanual-c58aabab4f305d802a040e031af0acf8ba7ffa5d.zip
Add in a common mistakes section and mention invalid usage of the "static" use
flag; bug #165361 git-svn-id: svn+ssh://svn.gentoo.org/var/svnroot/devmanual/trunk@108 176d3534-300d-0410-8db8-84e73ed771c3
-rw-r--r--ebuild-writing/common-mistakes/text.xml24
-rw-r--r--ebuild-writing/text.xml1
2 files changed, 25 insertions, 0 deletions
diff --git a/ebuild-writing/common-mistakes/text.xml b/ebuild-writing/common-mistakes/text.xml
new file mode 100644
index 0000000..4b7a645
--- /dev/null
+++ b/ebuild-writing/common-mistakes/text.xml
@@ -0,0 +1,24 @@
+<?xml version="1.0"?>
+<guide self="ebuild-writing/common-mistakes/">
+<chapter>
+<title>Common Mistakes</title>
+
+<body>
+<p>
+This section contains information on the common mistakes developers make when
+writing ebuilds.
+</p>
+</body>
+
+<section>
+<title>Invalid use of <c>static</c> use-flag</title>
+<body>
+The <c>static</c> use-flag should only be used to make a binary use static
+linking instead of dynamic linking. It should not be used to make a library
+install static libraries. The package should always (if possible) install both
+the dynamic and static libraries.
+</body>
+</section>
+</chapter>
+
+</guide>
diff --git a/ebuild-writing/text.xml b/ebuild-writing/text.xml
index 8ed134d..c76336e 100644
--- a/ebuild-writing/text.xml
+++ b/ebuild-writing/text.xml
@@ -28,4 +28,5 @@ with some general notes and extended examples.
<include href="using-eclasses/"/>
<include href="functions/"/>
<include href="misc-files/"/>
+<include href="common-mistakes/"/>
</guide>