document xz support, explain why it's generally a bad idea

1 files changed, 7 insertions, 3 deletions

diff --git a/share/man/man5/bsd.port.mk.5 b/share/man/man5/bsd.port.mk.5
index d125958bd24..aceca9a8401 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.279 2011/05/13 14:40:29 sthen Exp $
+.\" $OpenBSD: bsd.port.mk.5,v 1.280 2011/06/01 12:05:13 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: May 13 2011 $
+.Dd $Mdocdate: June 1 2011 $
 .Dt BSD.PORT.MK 5
 .Os
 .Sh NAME
@@ -1088,7 +1088,7 @@ ERRORS+="Fatal: Missing comment"
 In the normal extraction stage (when
 .Ev EXTRACT_ONLY
 is not empty), this is the contents of a case statement, used to extract files.
-Fragments are automatically appended to extract tar and zip
+Fragments are automatically appended to extract tar, xz and zip
 archives, so that the default case is equivalent to the following shell
 fragment:
 .Bd -literal
@@ -1097,6 +1097,8 @@ cd ${WRKDIR}
 for archive in ${EXTRACT_ONLY}
 do
     case $$archive in
+    	*.tar.xz) 
+	  xzcat ${FULLDISTDIR}/$$archive| tar xf -;;
 	*.zip)
 	  unzip -q ${FULLDISTDIR}/$$archive -d ${WRKDIR};;
 	*.tar.bz2)
@@ -1112,6 +1114,8 @@ do
     esac
 done
 .Ed
+The use of xz archives is discouraged, as it makes things impossible to
+build on vax and very annoying on sparc.
 .It Ev EXTRACT_ONLY
 Set if not all ${DISTFILES} should be extracted at do-extract stage.
 Default value is ${DISTFILES}.