there, should be crystal clear

1 files changed, 30 insertions, 8 deletions

diff --git a/share/man/man5/bsd.port.arch.mk.5 b/share/man/man5/bsd.port.arch.mk.5
index a0eac08edb7..59d28976455 100644
--- a/share/man/man5/bsd.port.arch.mk.5
+++ b/share/man/man5/bsd.port.arch.mk.5
@@ -1,4 +1,4 @@
-.\" $OpenBSD: bsd.port.arch.mk.5,v 1.6 2012/06/04 18:42:13 pascal Exp $
+.\" $OpenBSD: bsd.port.arch.mk.5,v 1.7 2012/09/30 09:28:20 espie Exp $
 .\"
 .\" Copyright (c) 2011 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: June 4 2012 $
+.Dd $Mdocdate: September 30 2012 $
 .Dt BSD.PORT.ARCH.MK 5
 .Os
 .Sh NAME
@@ -52,6 +52,14 @@ holds the logic used for arch-dependent builds in the ports tree.
 It is normally included as part of the larger
 .Xr bsd.port.mk 5 ,
 but it is also available separately for ports that require it.
+.Bl -bullet
+.It
+multi-packages ports that need to remove some subpackages based
+on pseudo-flavors or architecture constraints.
+.It
+ports that need to make explicit tests on arch-dependent constants.
+.El
+.Pp
 .Nm
 assumes the following variables are already defined:
 .Bl -tag -offset indent -compact -width ONLY_FOR_ARCH-<sub>
@@ -59,13 +67,13 @@ assumes the following variables are already defined:
 .It FLAVOR
 .It FLAVORS
 .It PSEUDO_FLAVORS
-.It Ev NOT_FOR_ARCHS-<sub>
-.It Ev ONLY_FOR_ARCHS-<sub>
+.It Ev NOT_FOR_ARCHS[-<sub>]
+.It Ev ONLY_FOR_ARCHS[-<sub>]
 .El
 and optionally, if the default won't be appropriate
 .Bl -tag -offset indent -compact -width ONLY_FOR_ARCH-<sub>
 .It Ev NO_SHARED_LIBS
-.It Ev IGNORE-<sub>
+.It Ev IGNORE[-<sub>]
 .El
 .Pp
 It will set up the following variables for use in the rest of the
@@ -91,9 +99,9 @@ It will set up the following variables for use in the rest of the
 Most importantly,
 .Ev BUILD_PACKAGES
 will be correctly set up, taking
-.Ev ONLY_FOR_ARCHS-<sub>
+.Ev ONLY_FOR_ARCHS[-<sub>]
 and
-.Ev NOT_FOR_ARCHS-<sub>
+.Ev NOT_FOR_ARCHS[-<sub>]
 limitations into account, as well as pseudo-flavors.
 .Pp
 Note that thanks to the way
@@ -101,12 +109,26 @@ Note that thanks to the way
 variables are evaluated, a setup such as
 .Bd -literal -offset indent
 ONLY_FOR_ARCHS-foo = ${LP64_ARCHS}
+\&.include <bsd.port.arch.mk>
 .Ed
 .Pp
-is perfectly admissible, since it will be used only after
+is perfectly admissible, since
+.Ev ONLY_FOR_ARCHS-foo
+will be used only after
 .Ev LP64_ARCHS
 is defined.
 .Pp
+Also, you do not need to explicitly include
+.Pa bsd.port.arch.mk
+just to define
+.Bd -literal -offset indent
+ONLY_FOR_ARCHS = ${LP64_ARCHS}
+.Ed
+.Pp
+since
+.Pa bsd.port.mk
+does define arch constants before evaluating
+.Ev ONLY_FOR_ARCHS .
 A more detailed description of each variable is available in
 .Xr bsd.port.mk 5 .
 .Pp