Add 'metadata/dtd/' from commit 'f8325042cda078a7fa29be8dcb9a092219332112'

git-subtree-dir: metadata/dtd
git-subtree-mainline: 623a6f012e20fa7b517bb6e3b009fe1fc1cad702
git-subtree-split: f8325042cda078a7fa29be8dcb9a092219332112

1 files changed, 90 insertions, 0 deletions

diff --git a/metadata/dtd/metadata.dtd b/metadata/dtd/metadata.dtd
new file mode 100644
index 000000000000..7626a57ca418
--- /dev/null
+++ b/metadata/dtd/metadata.dtd
@@ -0,0 +1,90 @@
+<!-- Metadata for a category -->
+<!ELEMENT catmetadata ( (longdescription)* )>
+<!ATTLIST catmetadata pkgname CDATA "">
+
+<!-- Metadata for a package -->
+<!ELEMENT pkgmetadata ( (maintainer|natural-name|longdescription|slots|use|upstream)* )>
+<!ATTLIST pkgmetadata pkgname CDATA "">
+
+  <!-- One tag for each maintainer of a package, multiple allowed-->
+  <!ELEMENT maintainer ( email, (description| name)* )>
+  <!-- type attribute determines whether the maintainer is a person or a project.
+    Unknown is added to handle <maintainer/>s in <upstream/>s. Using it (or no
+    explicit type) for Gentoo maintainers is prohibited. -->
+  <!ATTLIST maintainer type (person|project|unknown) "unknown">
+
+  <!-- Natural name for package, example: LibreOffice (for app-office/libreoffice) -->
+  <!ELEMENT natural-name (#PCDATA) >
+
+  <!-- A long description of the package in freetext-->
+  <!ELEMENT longdescription (#PCDATA|pkg|cat)* >
+
+  <!-- A description of the packages SLOTs -->
+  <!ELEMENT slots ((slot)*,subslots?) >
+    <!-- A particular SLOT -->
+    <!ELEMENT slot (#PCDATA)* >
+      <!-- name attribute holds the name of the SLOT, for sub-SLOTS use the subslots element -->
+      <!ATTLIST slot name CDATA #REQUIRED >
+    <!-- The meaning of sub-SLOTs for the whole package -->
+    <!ELEMENT subslots (#PCDATA)* >
+
+  <!-- description of what this USE flag does for this package -->
+  <!ELEMENT use (flag)* >
+    <!ELEMENT flag (#PCDATA|pkg|cat)* >
+      <!-- name attribute holds the name of the USE flag -->
+      <!ATTLIST flag name CDATA #REQUIRED >
+
+  <!-- upstream metadata information (maintainers, upstream docs,..) -->
+  <!ELEMENT upstream (maintainer|changelog|doc|bugs-to|remote-id)* >
+    <!-- Due to the limitation of DTD this will also allow a status
+      attribute for the package maintainer element. Please note that
+      the usage of the status attribute is nevertheless _only_ allowed
+      in the upstream maintainer element. -->
+    <!ATTLIST maintainer status (active|inactive|unknown) "unknown" >
+    <!-- URL where the upstream changelog can be found -->
+    <!ELEMENT changelog (#PCDATA)>
+    <!-- URL where the location of the upstream documentation can be found -->
+    <!ELEMENT doc (#PCDATA)>
+      <!ATTLIST doc lang CDATA "C" >
+    <!-- location where to report bugs
+      (may also be an email address prefixed with mailto:) -->
+    <!ELEMENT bugs-to (#PCDATA)>
+    <!-- specify a type of package identification tracker -->
+    <!ELEMENT remote-id (#PCDATA)>
+      <!ATTLIST remote-id type (bitbucket|cpan|cpan-module|cpe|cran|ctan|freecode|freshmeat|github|gitlab|gitorious|google-code|launchpad|pear|pecl|pypi|rubyforge|rubygems|sourceforge|sourceforge-jp|vim) #REQUIRED>
+
+  <!-- category/package information for cross-linking in descriptions
+    and useflag descriptions -->
+  <!ELEMENT pkg (#PCDATA) >
+  <!ELEMENT cat (#PCDATA) >
+          
+<!-- Common attributes -->
+
+<!-- the lang attribute, specifies the language of this tag. This is 
+  only useful for descriptions of various kinds. If a tag with this 
+  attribute is included there must be a description in the default 
+  language "C" or "en", which is equivalent -->
+  <!ATTLIST description lang CDATA "C" >
+  <!ATTLIST longdescription lang CDATA "C" >
+  <!ATTLIST slots lang CDATA "C" >
+  <!ATTLIST use lang CDATA "C" >
+
+<!-- The restrict attribute, this attribute specifies restrictions on 
+  the applicability of tags on versions. The format of this attribute is 
+  equal to the format of DEPEND lines in ebuilds. There is one special 
+  value though: restrict="*". A tag that specifies this only applies if 
+  there are no other tags that apply.
+  
+  For required tags, there must be either an unrestricted version, or a 
+  version that is default restricted. -->
+  <!ATTLIST maintainer restrict CDATA #IMPLIED >
+  <!ATTLIST longdescription restrict CDATA #IMPLIED >
+  <!ATTLIST flag restrict CDATA #IMPLIED >
+
+<!-- standard parts -->
+<!-- an email address -->
+<!ELEMENT email (#PCDATA) >
+<!-- the name of a person (maintainer, contributor) -->
+<!ELEMENT name (#PCDATA) >
+<!-- A description of a maintainer or change -->
+<!ELEMENT description (#PCDATA) >