be more forceful in pointing people at MULTI_PACKAGES/ONLY_FOR_ARCHS

interaction.

1 files changed, 13 insertions, 3 deletions

diff --git a/share/man/man5/bsd.port.mk.5 b/share/man/man5/bsd.port.mk.5
index 8a23a859730..b2c3dedffc3 100644
--- a/share/man/man5/bsd.port.mk.5
+++ b/share/man/man5/bsd.port.mk.5
@@ -1,4 +1,4 @@
-.\" $OpenBSD: bsd.port.mk.5,v 1.262 2010/09/06 16:28:21 espie Exp $
+.\" $OpenBSD: bsd.port.mk.5,v 1.263 2010/10/04 10:32:47 espie Exp $
 .\"
 .\" Copyright (c) 2000-2008 Marc Espie
 .\"
@@ -24,7 +24,7 @@
 .\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
 .\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 .\"
-.Dd $Mdocdate: September 6 2010 $
+.Dd $Mdocdate: October 4 2010 $
 .Dt BSD.PORT.MK 5
 .Os
 .Sh NAME
@@ -1407,6 +1407,9 @@ Set to a list of package extensions for ports that create multiple packages.
 See
 .Qq Flavors and multi-packages
 below.
+Especially read the part about
+.Ev ONLY_FOR_ARCHS
+is some of the packages only exist for some architectures.
 .It Ev NOT_FOR_ARCHS
 List of architectures on which this port does not build.
 See also
@@ -1465,6 +1468,10 @@ Port does not build with systrace enabled build targets.
 List of architectures on which this port builds.
 Can hold both processor-specific information (e.g., m68k), and more
 specific model information (e.g., hp300).
+This is subpackage dependent.
+Read the corresponding part of
+.Qq Flavors and multi-packages
+if some subpackages should only be built on some architectures.
 .It Ev OSREV
 Revision number of
 .Ox .
@@ -2770,9 +2777,12 @@ The infrastructure will automatically filter subpackages
 that are not suitable for the current architecture.
 Thus,
 .Ev MULTI_PACKAGES
-should list all subpackages,
+should always list all subpackages,
 even things not buildable on the current architecture,
 for indexing purposes.
+Note that
+.Xr dpb 1
+will break if all subpackages are not properly listed.
 .Sh THE GENERATION OF PACKAGE INFORMATION
 Starting after
 .Ox 4.1