From 9583f1582f529d1bfe2443fc2f58fb438501d418 Mon Sep 17 00:00:00 2001
From: Murray Stokely <murray@FreeBSD.org>
Date: Sun, 20 Apr 2008 22:22:35 +0000
Subject: [PATCH] Add comment about the new schema for usergroups.xml. Clean up
 commented out code from previous commit.

---
 share/sgml/libcommon.xsl            |  8 +-------
 share/sgml/templates.usergroups.xsl |  3 +--
 share/sgml/usergroups.xml           | 25 ++++++++++++++++++++++++-
 3 files changed, 26 insertions(+), 10 deletions(-)

diff --git a/share/sgml/libcommon.xsl b/share/sgml/libcommon.xsl
index 9b54e0e53d..00757a63d2 100644
--- a/share/sgml/libcommon.xsl
+++ b/share/sgml/libcommon.xsl
@@ -1,7 +1,7 @@
 <?xml version="1.0" encoding="ISO-8859-1" ?>
 <!DOCTYPE xsl:stylesheet PUBLIC "-//FreeBSD//DTD FreeBSD XSLT 1.0 DTD//EN"
 				"http://www.FreeBSD.org/XML/www/share/sgml/xslt10-freebsd.dtd">
-<!-- $FreeBSD: www/share/sgml/libcommon.xsl,v 1.17 2008/04/20 01:28:57 murray Exp $ -->
+<!-- $FreeBSD: www/share/sgml/libcommon.xsl,v 1.18 2008/04/20 22:14:54 murray Exp $ -->
 
 <xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
   version="1.0"
@@ -141,12 +141,6 @@
 
       <dl>
         <xsl:for-each select="country/entry">
-<!--	  <xsl:sort select="@name" order="ascending"/>
-
-          <h4><xsl:value-of select="@name" /></h4>
-          <xsl:for-each select="entry">
-	    <xsl:sort select="name" order="ascending"/>
--->
 
 	  <xsl:variable name="id"><xsl:value-of select="@id" /></xsl:variable>
 
diff --git a/share/sgml/templates.usergroups.xsl b/share/sgml/templates.usergroups.xsl
index 7207291059..2e2ffb6b23 100644
--- a/share/sgml/templates.usergroups.xsl
+++ b/share/sgml/templates.usergroups.xsl
@@ -3,11 +3,10 @@
                                 "http://www.FreeBSD.org/XML/www/share/sgml/xslt10-freebsd.dtd" [
 <!ENTITY title "User Groups">
 <!ENTITY email "freebsd-www">
-<!ENTITY base "http://www.FreeBSD.org/">
 <!ENTITY % navinclude.community "INCLUDE">
 ]>
 
-<!-- $FreeBSD: www/share/sgml/templates.usergroups.xsl,v 1.8 2006/08/21 18:27:43 hrs Exp $ -->
+<!-- $FreeBSD: www/share/sgml/templates.usergroups.xsl,v 1.9 2008/04/20 22:14:54 murray Exp $ -->
 
 <xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" version="1.0"
   xmlns:cvs="http://www.FreeBSD.org/XML/CVS"
diff --git a/share/sgml/usergroups.xml b/share/sgml/usergroups.xml
index fac4bbb071..cd665c3aef 100644
--- a/share/sgml/usergroups.xml
+++ b/share/sgml/usergroups.xml
@@ -5,10 +5,33 @@
 <usergroups>
   <cvs:keywords xmlns:cvs="http://www.FreeBSD.org/XML/CVS" version="1.0">
     <cvs:keyword name="freebsd">
-      $FreeBSD: www/share/sgml/usergroups.xml,v 1.65 2008/04/20 01:55:19 murray Exp $
+      $FreeBSD: www/share/sgml/usergroups.xml,v 1.66 2008/04/20 22:14:54 murray Exp $
     </cvs:keyword>
   </cvs:keywords>
 
+<!--
+
+Please keep this file sorted. The schema is quite simple.
+
+<usergroups>
+  <continent name="foo">
+    <country code="XX" name="bar">
+      <entry id="baz">
+
+      </entry>
+      ...
+    </country>
+    ...
+  </continent>
+  ...
+</usergroups>
+
+The country codes are precise ISO3166 codes from, e.g.
+
+  http://code.google.com/apis/chart/#iso_codes
+
+-->
+
 <continent name="Global">
   <country name="Global">
   <entry id="metabug" continent="North America">