From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from lists.gentoo.org (pigeon.gentoo.org [208.92.234.80]) by finch.gentoo.org (Postfix) with ESMTP id 297BB13800E for ; Wed, 8 Aug 2012 19:20:39 +0000 (UTC) Received: from pigeon.gentoo.org (localhost [127.0.0.1]) by pigeon.gentoo.org (Postfix) with SMTP id 7E54CE08DA; Wed, 8 Aug 2012 19:20:30 +0000 (UTC) Received: from smtp.gentoo.org (smtp.gentoo.org [140.211.166.183]) by pigeon.gentoo.org (Postfix) with ESMTP id 482D6E08DA for ; Wed, 8 Aug 2012 19:20:30 +0000 (UTC) Received: from hornbill.gentoo.org (hornbill.gentoo.org [94.100.119.163]) (using TLSv1 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by smtp.gentoo.org (Postfix) with ESMTPS id A7F291B4024 for ; Wed, 8 Aug 2012 19:20:29 +0000 (UTC) Received: from localhost.localdomain (localhost [127.0.0.1]) by hornbill.gentoo.org (Postfix) with ESMTP id 5EB7BE5439 for ; Wed, 8 Aug 2012 19:20:28 +0000 (UTC) From: "Markos Chandras" To: gentoo-commits@lists.gentoo.org Content-Transfer-Encoding: 8bit Content-type: text/plain; charset=UTF-8 Reply-To: gentoo-dev@lists.gentoo.org, "Markos Chandras" Message-ID: <1344453604.a3ac99ece5056880cb0ad1a64ef39d59b574af7d.hwoarang@gentoo> Subject: [gentoo-commits] proj/devmanual:master commit in: ebuild-writing/common-mistakes/ X-VCS-Repository: proj/devmanual X-VCS-Files: ebuild-writing/common-mistakes/text.xml X-VCS-Directories: ebuild-writing/common-mistakes/ X-VCS-Committer: hwoarang X-VCS-Committer-Name: Markos Chandras X-VCS-Revision: a3ac99ece5056880cb0ad1a64ef39d59b574af7d X-VCS-Branch: master Date: Wed, 8 Aug 2012 19:20:28 +0000 (UTC) Precedence: bulk List-Post: List-Help: List-Unsubscribe: List-Subscribe: List-Id: Gentoo Linux mail X-BeenThere: gentoo-commits@lists.gentoo.org X-Archives-Salt: 9a3496fd-6fd9-41b7-b1d8-2b8eb9d241a6 X-Archives-Hash: 34a800bef1fcbb7977b5a5fd1a4615ca commit: a3ac99ece5056880cb0ad1a64ef39d59b574af7d Author: Julian Ospald gentoo org> AuthorDate: Sat Aug 4 00:33:15 2012 +0000 Commit: Markos Chandras gentoo org> CommitDate: Wed Aug 8 19:20:04 2012 +0000 URL: http://git.overlays.gentoo.org/gitweb/?p=proj/devmanual.git;a=commit;h=a3ac99ec devmanual document necessity to force all build logs verbose --- ebuild-writing/common-mistakes/text.xml | 31 +++++++++++++++++++++++++++++++ 1 files changed, 31 insertions(+), 0 deletions(-) diff --git a/ebuild-writing/common-mistakes/text.xml b/ebuild-writing/common-mistakes/text.xml index d2f5fcf..fb4f0d2 100644 --- a/ebuild-writing/common-mistakes/text.xml +++ b/ebuild-writing/common-mistakes/text.xml @@ -57,6 +57,37 @@ elog "They are listed in the INSTALL file in /usr/share/doc/${PF}" +
+Build log not verbose + +When writing ebuilds, you should always check the build log, because the build +system might ignore CC/CXX/LD/CFLAGS/LDFLAGS and such or add undesired flags +by default. In order to analyze this and have complete information, in case +someone reports a bug for your package, the build log must always be verbose. +

+There are several ways to fix non-verbose build logs depending on the build system: +

+

+For cmake based build systems it should be sufficient that the ebuild calls +cmake-utils_src_compile which picks up the cmake-utils.eclass variable 'CMAKE_VERBOSE=1' +by default. If you call emake directly for whatever reason, you can do 'emake VERBOSE=1' +(note that cmake-utils_src_compile takes arguments as well which are passed to make). +

+ +

+For autotools based build systems you can pass '--disable-silent-rules' to econf +until a new EAPI does that automatically. 'emake V=1' should also work. +

+ +

+For custom Makefiles you often have to write a patch. Try to get upstream to include an +option like 'V=1' to enable full verbosity. +

+ If you notice non-verbose build log in any package open a bug and make it block the +tracker bug #429308 + +
+