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