Explain xen version differences.

There are 5 versions of xen in pkgsrc, which is confusing.  Explain in
DESCR which version is in which package (xenkernel3 contains 3.1), and
which versions support PCI passthrough (only 3.1).  Explain which
versions support non-PAE (3.1) and PAE (3.3, 4.1, 4.2), because the
HOWTO is out of date and it's easy to end up with a non-working system
on a 3.1 to 3.3 update.  Cuation that 2.0 is beyond crufty.

This is a DESCR-only change (with PKGREVISION++ of course).

(ok during freeze agc@)

10 files changed, 32 insertions, 19 deletions

diff --git a/sysutils/xenkernel20/DESCR b/sysutils/xenkernel20/DESCR
index 5aea6bde6c8..05f3042b200 100644
--- a/sysutils/xenkernel20/DESCR
+++ b/sysutils/xenkernel20/DESCR
@@ -8,4 +8,5 @@ domain0).  domain0 has privileges to access the physical hardware (PCI
 and ISA devices), administrate other domains and provide virtual
 devices (disks and network) to other domains.
 
-This package contains the Xen kernel itself.
+This package contains the 2.0 Xen kernel itself.  Xen 2.0 is obsolete
+and well beyond no longer maintained.
diff --git a/sysutils/xenkernel20/Makefile b/sysutils/xenkernel20/Makefile
index 496331feae1..f6bfd19776a 100644
--- a/sysutils/xenkernel20/Makefile
+++ b/sysutils/xenkernel20/Makefile
@@ -1,8 +1,9 @@
-# $NetBSD: Makefile,v 1.7 2012/10/23 19:51:36 asau Exp $
+# $NetBSD: Makefile,v 1.8 2013/06/19 14:03:41 gdt Exp $
 #
 
 DISTNAME=	xen-2.0.7-install-x86_32
 PKGNAME=	xenkernel20-2.0.7
+PKGREVISION=	1
 CATEGORIES=	sysutils
 MASTER_SITES=	http://www.cl.cam.ac.uk/Research/SRG/netos/xen/downloads/
 EXTRACT_SUFX=	.tgz
diff --git a/sysutils/xenkernel3/DESCR b/sysutils/xenkernel3/DESCR
index b200f6ee961..402f7f4d99f 100644
--- a/sysutils/xenkernel3/DESCR
+++ b/sysutils/xenkernel3/DESCR
@@ -8,4 +8,7 @@ domain0).  domain0 has privileges to access the physical hardware (PCI
 and ISA devices), administrate other domains and provide virtual
 devices (disks and network) to other domains.
 
-This package contains the Xen3 kernel itself.
+This package contains the 3.1 Xen3 kernel itself.  PCI passthrough is
+supported.  Both non-PAE and PAE versions of xen are provided for
+i386; one must use XEN3_DOM[0U] and XEN3PAE_DOM[0U] kernels, respectively.
+3.1 is no longer maintained upstream.
diff --git a/sysutils/xenkernel3/Makefile b/sysutils/xenkernel3/Makefile
index c428b9c6f89..76739d39f9b 100644
--- a/sysutils/xenkernel3/Makefile
+++ b/sysutils/xenkernel3/Makefile
@@ -1,10 +1,10 @@
-# $NetBSD: Makefile,v 1.24 2013/04/11 19:57:51 joerg Exp $
+# $NetBSD: Makefile,v 1.25 2013/06/19 14:03:41 gdt Exp $
 #
 
 VERSION=	3.1.4
 DISTNAME=	xen-${VERSION}
 PKGNAME=	xenkernel3-${VERSION}
-PKGREVISION=	7
+PKGREVISION=	8
 CATEGORIES=	sysutils
 MASTER_SITES=	http://bits.xensource.com/oss-xen/release/${VERSION}/
 
diff --git a/sysutils/xenkernel33/DESCR b/sysutils/xenkernel33/DESCR
index b200f6ee961..86b465030ab 100644
--- a/sysutils/xenkernel33/DESCR
+++ b/sysutils/xenkernel33/DESCR
@@ -8,4 +8,6 @@ domain0).  domain0 has privileges to access the physical hardware (PCI
 and ISA devices), administrate other domains and provide virtual
 devices (disks and network) to other domains.
 
-This package contains the Xen3 kernel itself.
+This package contains the 3.3 Xen3 kernel itself.  PCI passthrough is
+not supported.  PAE is mandatory; on i386 one must use XEN3PAE_DOM[0U].
+3.3 is no longer maintained upstream.
diff --git a/sysutils/xenkernel33/Makefile b/sysutils/xenkernel33/Makefile
index 6ecafe8cd67..9f9d79e3241 100644
--- a/sysutils/xenkernel33/Makefile
+++ b/sysutils/xenkernel33/Makefile
@@ -1,10 +1,10 @@
-# $NetBSD: Makefile,v 1.22 2013/05/10 20:07:34 riastradh Exp $
+# $NetBSD: Makefile,v 1.23 2013/06/19 14:03:41 gdt Exp $
 #
 
 VERSION=	3.3.2
 DISTNAME=	xen-${VERSION}
 PKGNAME=	xenkernel33-${VERSION}
-PKGREVISION=	6
+PKGREVISION=	7
 CATEGORIES=	sysutils
 MASTER_SITES=	http://bits.xensource.com/oss-xen/release/${VERSION}/
 
diff --git a/sysutils/xenkernel41/DESCR b/sysutils/xenkernel41/DESCR
index a1e45de75cf..543eb12f86e 100644
--- a/sysutils/xenkernel41/DESCR
+++ b/sysutils/xenkernel41/DESCR
@@ -1,9 +1,12 @@
-Xen is a virtual machine monitor which supports running multiple guests
-operating systems on a single machine. Guest OSes (also called "domains")
-require a modified kernel which supports Xen hypercalls in replacement to access
-to the physical hardware. At boot, the xen kernel is loaded along with the guest
-kernel for the first domain (called domain0). domain0 has privileges to access
-the physical hardware (PCI and ISA devices), administrate other domains and
-provide virtual devices (disks and network) to other domains.
+Xen is a virtual machine monitor which supports running multiple
+guests operating systems on a single machine. Guest OSes (also
+called "domains") require a modified kernel which supports Xen
+hypercalls in replacement to access to the physical hardware. At
+boot, the xen kernel is loaded along with the guest kernel for the
+first domain (called domain0). domain0 has privileges to access
+the physical hardware (PCI and ISA devices), administrate other
+domains and provide virtual devices (disks and network) to other
+domains.
 
-This package contains the Xen4 kernel itself.
+This package contains the 4.1 Xen4 kernel itself.  PCI passthrough is
+not supported.  PAE is mandatory; on i386 one must use XEN3PAE_DOM0[0U].
diff --git a/sysutils/xenkernel41/Makefile b/sysutils/xenkernel41/Makefile
index cc77a796e99..b0401c6e002 100644
--- a/sysutils/xenkernel41/Makefile
+++ b/sysutils/xenkernel41/Makefile
@@ -1,9 +1,10 @@
-# $NetBSD: Makefile,v 1.22 2013/05/10 20:07:34 riastradh Exp $
+# $NetBSD: Makefile,v 1.23 2013/06/19 14:03:41 gdt Exp $
 #
 
 VERSION=	4.1.5
 DISTNAME=	xen-${VERSION}
 PKGNAME=	xenkernel41-${VERSION}
+PKGREVISION=	1
 CATEGORIES=	sysutils
 MASTER_SITES=	http://bits.xensource.com/oss-xen/release/${VERSION}/
 
diff --git a/sysutils/xenkernel42/DESCR b/sysutils/xenkernel42/DESCR
index f5f85ae3726..95eb395daec 100644
--- a/sysutils/xenkernel42/DESCR
+++ b/sysutils/xenkernel42/DESCR
@@ -8,4 +8,5 @@ the physical hardware (PCI and ISA devices), administrate other
 domains and provide virtual devices (disks and network) to other
 domains.
 
-This package contains the Xen4 kernel itself.
+This package contains the 4.2 Xen4 kernel itself.  PCI passthrough is
+not supported.  PAE is mandatory; on i386 one must use XEN3PAE_DOM[0U].
diff --git a/sysutils/xenkernel42/Makefile b/sysutils/xenkernel42/Makefile
index 378a5f6a9bb..337cebe42f5 100644
--- a/sysutils/xenkernel42/Makefile
+++ b/sysutils/xenkernel42/Makefile
@@ -1,9 +1,10 @@
-# $NetBSD: Makefile,v 1.1.1.1 2013/05/15 05:32:12 jnemeth Exp $
+# $NetBSD: Makefile,v 1.2 2013/06/19 14:03:41 gdt Exp $
 #
 
 VERSION=	4.2.2
 DISTNAME=	xen-${VERSION}
 PKGNAME=	xenkernel42-${VERSION}
+PKREVISION=	1
 CATEGORIES=	sysutils
 MASTER_SITES=	http://bits.xensource.com/oss-xen/release/${VERSION}/