Index: en_US.ISO8859-1/books/porters-handbook/porting-dads/chapter.xml
===================================================================
--- en_US.ISO8859-1/books/porters-handbook/porting-dads/chapter.xml
+++ en_US.ISO8859-1/books/porters-handbook/porting-dads/chapter.xml
@@ -322,6 +322,33 @@
CFLAGS+= -DHAVE_SOUND
+
+ Verbose Build Logs
+
+ The port should always output as much information as
+ possible during the build, for build logs are crucial to
+ debugging port problems. Some build systems hide executed
+ build commands and only display non-informative summary,
+ this behavior should be inhibited.
+
+ Non-informative build log example:
+
+ CC source1.o
+ CC source2.o
+ CCLD someprogram
+
+ Verbose build log example:
+
+ cc -O2 -pipe -I/usr/local/include -c -o source1.o source1.c
+cc -O2 -pipe -I/usr/local/include -c -o source2.o source2.c
+cc -o someprogram source1.o source2.o -L/usr/local/lib -lsomelib
+
+ For instance, for GNU_CONFIGURE-using
+ ports verbose logs may usually be enabled with
+
+ CONFIGURE_ARGS+= --disable-silent-rules
+
+
Feedback