diff --git a/en_US.ISO8859-1/books/porters-handbook/book.sgml b/en_US.ISO8859-1/books/porters-handbook/book.sgml index 10ae5c82b0..93c6c8db8e 100644 --- a/en_US.ISO8859-1/books/porters-handbook/book.sgml +++ b/en_US.ISO8859-1/books/porters-handbook/book.sgml @@ -3825,12 +3825,20 @@ ${PREFIX}/man/ja/man4/baz.4.gz the inclusion of bsd.port.pre.mk. The WITH_* and WITHOUT_* variables can only be tested after the inclusion of - bsd.port.pre.mk. Due to a deficiency - in the infrastructure, you can only test - WITH_* variables for options, which are + bsd.port.pre.mk. + + + Due to a deficiency in the infrastructure, you can only test + WITH_* variables for options which are OFF by default, and - WITHOUT_* variables for options, which - defaults to ON. + WITHOUT_* variables for options which + default to ON. The reasoning behind this: + when packages are built with PACKAGE_BUILDING or + BATCH defined, the config + target is not run, and therefore no OPTIONS + are selected. This would cause make depends and + make describe to break for ports not following + the aforementioned rule. Example