document PROPERTIES

2 files changed, 39 insertions, 4 deletions

diff --git a/share/man/man5/bsd.port.arch.mk.5 b/share/man/man5/bsd.port.arch.mk.5
index 54e3a0b72b3..9fdb5dcf75e 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.2 2011/09/25 18:12:12 jmc Exp $
+.\" $OpenBSD: bsd.port.arch.mk.5,v 1.3 2011/10/16 07:13:12 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: September 25 2011 $
+.Dd $Mdocdate: October 16 2011 $
 .Dt BSD.PORT.ARCH.MK 5
 .Os
 .Sh NAME
@@ -79,6 +79,7 @@ It will set up the following variables for use in the rest of the
 .It Ev LP64_ARCHS
 .It Ev NO_SHARED_ARCHS
 .It Ev NO_SHARED_LIBS
+.It Ev PROPERTIES
 .It Ev IGNORE-<sub>
 .It Ev BUILD_PACKAGES
 .El
diff --git a/share/man/man5/bsd.port.mk.5 b/share/man/man5/bsd.port.mk.5
index 65105176e98..0466fe320e7 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.289 2011/09/25 16:53:13 jmc Exp $
+.\" $OpenBSD: bsd.port.mk.5,v 1.290 2011/10/16 07:13:12 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 25 2011 $
+.Dd $Mdocdate: October 16 2011 $
 .Dt BSD.PORT.MK 5
 .Os
 .Sh NAME
@@ -1750,6 +1750,40 @@ Forces commands like
 .Xr ftp 1 ,
 .Xr pkg_create 1 ...
 to use their progress-meter even in the absence of a terminal.
+.It Ev PROPERTIES
+List of properties specific to a given machine architecture.
+Most often obtained through
+.Xr bsd.port.arch.mk 5 .
+These can be checked like this
+.Bd -literal -offset indent
+\&.include <bsd.port.arch.mk>
+\&.if ${PROPERTIES:Mapm}
+# then add build options specific to apm arches
+\&...
+\&.if !${PROPERTIES:Mlp64}
+# build options specific to lp32 arches
+\&...
+.Ed
+For
+.Ev MULTI_PACKAGES
+setup, use of
+.Ev ONLY_FOR_ARCHS-sub
+and
+.Ev BUILD_PACKAGES
+is generally prefered (and simpler).
+Possible properties include
+.Bl -tag -width no_shared
+.It apm
+architecture possesses suspend (apm) support.
+.It gccN
+gccN architecture.
+.It lp64
+lp64 architecture.
+.It no_shared
+architecture has no shared library support.
+.It mono
+there is mono support on this architecture.
+.El
 .It Ev PSEUDO_FLAVORS
 Extra list of flavors that do not register in package names, but are still
 used to control build logic, and e.g., working directory names.