Added documentation for attributes and attribute values

diff --git a/docbook/relaxng/docbook/src/msgset.rnc b/docbook/relaxng/docbook/src/msgset.rnc
index 4fbb5026d7b8d18d12c43a8374799395ce50bbd4..f8287680f2e5a28cf80d93cb552b87f0fc0663a5 100644 (file)
--- a/docbook/relaxng/docbook/src/msgset.rnc
+++ b/docbook/relaxng/docbook/src/msgset.rnc
@@ -93,9 +93,24 @@ div {
 div {
 
    db.simplemsgentry.role.attribute = attribute role { text }
-   db.simplemsgentry.audience.attribute = attribute audience { text }
-   db.simplemsgentry.origin.attribute = attribute origin { text }
-   db.simplemsgentry.level.attribute = attribute level { text }
+
+   db.simplemsgentry.audience.attribute =
+      [
+         db:refpurpose [ "The audience to which the message relevant" ]
+      ]
+      attribute audience { text }
+
+   db.simplemsgentry.origin.attribute =
+      [
+         db:refpurpose [ "The origin of the message" ]
+      ]
+      attribute origin { text }
+
+   db.simplemsgentry.level.attribute =
+      [
+         db:refpurpose [ "The level of importance or severity of a message" ]
+      ]
+      attribute level { text }
 
    db.simplemsgentry.attlist =
       db.simplemsgentry.role.attribute?

diff --git a/docbook/relaxng/docbook/src/qandaset.rnc b/docbook/relaxng/docbook/src/qandaset.rnc
index 258aea5482f8b08b9e092429cc3fce8358a9956d..f20bde9da32ff573b666a40695194e0d151fa7b5 100644 (file)
--- a/docbook/relaxng/docbook/src/qandaset.rnc
+++ b/docbook/relaxng/docbook/src/qandaset.rnc
@@ -45,8 +45,18 @@ div {
 
    db.qandaset.role.attribute = attribute role { text }
 
-   db.qandaset.defaultlabel.enumeration = "none" | "number" | "qanda"
+   db.qandaset.defaultlabel.enumeration =
+      ## No labels
+      "none"
+    | ## Numeric labels
+      "number"
+    | ## "Q:" and "A:" labels
+      "qanda"
+
    db.qandaset.defaultlabel.attribute =
+      [
+         db:refpurpose [ "Specifies the default labelling" ]
+      ]
       attribute defaultlabel { db.qandaset.defaultlabel.enumeration }
 
    db.qandaset.attlist =