[pkgsrc/trunk]: pkgsrc/mk/defaults Updated the ABI documentation, which also ...

[rillig <rillig%pkgsrc.org@localhost>]

details:   https://anonhg.NetBSD.org/pkgsrc/rev/af3ff8b2aafa
branches:  trunk
changeset: 525718:af3ff8b2aafa
user:      rillig <rillig%pkgsrc.org@localhost>
date:      Thu Feb 22 07:05:57 2007 +0000

description:
Updated the ABI documentation, which also works on Solaris.

diffstat:

 mk/defaults/mk.conf |  24 +++++++++++++++++++-----
 1 files changed, 19 insertions(+), 5 deletions(-)

diffs (40 lines):

diff -r 194493b33677 -r af3ff8b2aafa mk/defaults/mk.conf
--- a/mk/defaults/mk.conf       Thu Feb 22 04:25:56 2007 +0000
+++ b/mk/defaults/mk.conf       Thu Feb 22 07:05:57 2007 +0000
@@ -1,4 +1,4 @@
-# $NetBSD: mk.conf,v 1.148 2007/02/04 23:23:40 rillig Exp $
+# $NetBSD: mk.conf,v 1.149 2007/02/22 07:05:57 rillig Exp $
 #
 
 # This file provides default values for variables that may be overridden
@@ -100,12 +100,26 @@
 #
 
 #ABI=
-# The ABI to be used, if supported by the Operating System and/or compiler.
-# Currently only used under IRIX and explicitly set during bootstrapping
+# The Application Binary Interface (ABI) to be used, if supported by the
+# Operating System and/or compiler.
+#
 # Only change this if you really know what you're doing -- libraries of
 # one ABI can not be linked with libraries of another!
-# Possible: 64 (64 bit ABI), 32 (SGI's N32 ABI), undefined (SGI's old o32 ABI)
-# Default: determined during bootstrapping
+#
+# Currently only usable on IRIX or Solaris. On IRIX, it is set
+# automatically by the bootstrap script, on Solaris, it is not.
+#
+# If you change it, be sure that _all_ the installed libraries and
+# programs have the same API and use consistent compiler options. It is
+# recommended that this variable be only changed directly after
+# bootstrapping pkgsrc.
+#
+# Possible values:
+#      * 64 (64 bit ABI; both IRIX or Solaris)
+#      * 32 (SGI's N32 ABI; only IRIX)
+#      * undefined (SGI's old o32 ABI; only IRIX)
+#
+# Default: undefined, but see above.
 
 #PKG_DEVELOPER=        yes
 #