--- xml/htdocs/proj/en/devrel/handbook/hb-guide-metadata.xml	2009/10/30 17:46:11	1.16
+++ xml/htdocs/proj/en/devrel/handbook/hb-guide-metadata.xml	2012/04/27 17:43:42	1.18
@@ -1,6 +1,6 @@
 <?xml version='1.0' encoding='UTF-8'?>
 <!DOCTYPE sections SYSTEM "/dtd/book.dtd">
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/proj/en/devrel/handbook/Attic/hb-guide-metadata.xml,v 1.16 2009/10/30 17:46:11 betelgeuse Exp $-->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/proj/en/devrel/handbook/Attic/hb-guide-metadata.xml,v 1.18 2012/04/27 17:43:42 hwoarang Exp $-->
 
 <!-- The content of this document is licensed under the CC-BY-SA license -->
 <!-- See http://creativecommons.org/licenses/by-sa/1.0 -->
@@ -10,8 +10,8 @@
 -->
 
 <sections>
-<version>1.0.7</version>
-<date>2008-09-11</date>
+<version>1.0.9</version>
+<date>2012-04-27</date>
 
 <section>
 <title>Why the need for metadata.xml?</title>
@@ -49,13 +49,15 @@
   </ti>
   <ti>
     This is the root element of the <path>metadata.xml</path> file for
-    packages. It has no attributes. Its required subtag is:
-    <brite>&lt;herd&gt;</brite>.  Furthermore, the following subtags are
-    allowed: <brite>&lt;email&gt;</brite> for a general herd email address,
+    packages. It has no attributes. The following subtags are
+    allowed:
+    <brite>&lt;herd&gt;</brite>,
     <brite>&lt;maintainer&gt;</brite>,
     <brite>&lt;longdescription&gt;</brite>,
     <brite>&lt;use&gt;</brite>, and
     <brite>&lt;upstream&gt;</brite>.
+    There should be at least one <brite>&lt;herd&gt;</brite> or
+    <brite>&lt;maintainer&gt;</brite> subtag.
   </ti>
 </tr>
 <tr>
@@ -75,10 +77,11 @@
     <brite>&lt;herd&gt;</brite>
   </ti>
   <ti>
-    There must at least be one herd subtag. The contents of this tag must be
-    the name of a herd as specified in the <uri 
+    If a package is maintained by one or more herds, names of these herds
+    can be specified with the <brite>&lt;herd&gt;</brite> tag. The names
+    used in this tag must be the same as specified in the <uri 
     link="http://sources.gentoo.org/viewcvs.py/*checkout*/gentoo/xml/htdocs/proj/en/metastructure/herds/herds.xml?content-type=text/plain&amp;rev=HEAD">herds.xml</uri>
-    file or the "no-herd" herd. It must occur at least once.
+    file.
   </ti>
 </tr>
 <tr>
@@ -135,7 +138,7 @@
   <ti>
     This tag contains a description of how the named USE flag affects this
     package. It is required if the <brite>&lt;use&gt;</brite> tag is specified.
-    It alos requires the USE flag to be named in the <c>name</c> attribute.
+    It also requires the USE flag to be named in the <c>name</c> attribute.
     This tag has two optional subtags: <brite>&lt;pkg&gt;</brite> and
     <brite>&lt;cat&gt;</brite>.
   </ti>