Gentoo Archives: gentoo-commits

From: "Ulrich Müller" <ulm@g.o>
To: gentoo-commits@l.g.o
Subject: [gentoo-commits] proj/devmanual:master commit in: ebuild-writing/common-mistakes/
Date: Tue, 30 Mar 2021 18:15:53
Message-Id: 1617128092.196e48b1418b58a2d32efd21cec47af1b6bd8f1c.ulm@gentoo
1 commit: 196e48b1418b58a2d32efd21cec47af1b6bd8f1c
2 Author: Sam James <sam <AT> gentoo <DOT> org>
3 AuthorDate: Sun Mar 21 02:34:53 2021 +0000
4 Commit: Ulrich Müller <ulm <AT> gentoo <DOT> org>
5 CommitDate: Tue Mar 30 18:14:52 2021 +0000
6 URL: https://gitweb.gentoo.org/proj/devmanual.git/commit/?id=196e48b1
7
8 ebuild-writing/common-mistakes: convert 'build log not verbose' to list
9
10 Signed-off-by: Sam James <sam <AT> gentoo.org>
11 Signed-off-by: Ulrich Müller <ulm <AT> gentoo.org>
12
13 ebuild-writing/common-mistakes/text.xml | 28 ++++++++++++++--------------
14 1 file changed, 14 insertions(+), 14 deletions(-)
15
16 diff --git a/ebuild-writing/common-mistakes/text.xml b/ebuild-writing/common-mistakes/text.xml
17 index c92813f..9ff6608 100644
18 --- a/ebuild-writing/common-mistakes/text.xml
19 +++ b/ebuild-writing/common-mistakes/text.xml
20 @@ -81,22 +81,22 @@ someone reports a bug for your package, the <b>build log must always be verbose.
21 <p>
22 There are several ways to fix non-verbose build logs depending on the build system:
23 </p>
24 -<p>
25 -For <c>cmake</c> based build systems it should be sufficient that the ebuild calls
26 -cmake-utils_src_compile which picks up the cmake-utils.eclass variable 'CMAKE_VERBOSE=1'
27 -by default. If you call emake directly for whatever reason, you can do 'emake VERBOSE=1'
28 -(note that cmake-utils_src_compile takes arguments as well which are passed to make).
29 -</p>
30
31 -<p>
32 -For <c>autotools</c> based build systems you can pass '--disable-silent-rules' to econf,
33 -or use EAPI 5 where that argument is passed automatically. 'emake V=1' should also work.
34 -</p>
35 +<ul>
36 + <li>For <c>cmake</c> based build systems it should be sufficient that
37 + the ebuild calls cmake-utils_src_compile which picks up the cmake-utils.eclass
38 + variable 'CMAKE_VERBOSE=1' by default. If you call emake directly for
39 + whatever reason, you can do 'emake VERBOSE=1' (note that
40 + cmake-utils_src_compile takes arguments as well which are passed to make).</li>
41 +
42 + <li>For <c>autotools</c> based build systems you can pass
43 + '--disable-silent-rules' to econf, or use EAPI 5 where that argument is
44 + passed automatically. 'emake V=1' should also work.</li>
45 +
46 + <li>For custom Makefiles you often have to write a patch. Try to get
47 + upstream to include an option like 'V=1' to enable full verbosity.</li>
48 +</ul>
49
50 -<p>
51 -For custom Makefiles you often have to write a patch. Try to get upstream to include an
52 -option like 'V=1' to enable full verbosity.
53 -</p>
54 <note>In case you encounter an affected package which uses a build system not
55 controllable by Portage or eclasses you should file a bug (preferably with a patch)
56 and make it block the tracker bug #429308. Solutions above ebuild level are