From b0b627bf6ca8e34e8114726de6bd0ce18cdc0adf Mon Sep 17 00:00:00 2001
From: Norman Walsh <ndw@nwalsh.com>
Date: Thu, 14 Jul 2005 00:12:57 +0000
Subject: [PATCH] More documentation improvements

---
 docbook/relaxng/docbook/src/pool.rnc | 19 +++++++++++++------
 1 file changed, 13 insertions(+), 6 deletions(-)

diff --git a/docbook/relaxng/docbook/src/pool.rnc b/docbook/relaxng/docbook/src/pool.rnc
index f00f54c36..b2a540ae8 100644
--- a/docbook/relaxng/docbook/src/pool.rnc
+++ b/docbook/relaxng/docbook/src/pool.rnc
@@ -301,7 +301,7 @@ db.verbatim.continuation.attribute =
 db.verbatim.linenumbering.enumeration =
    ## Lines are numbered.
    "numbered"
- | ## Lines are not numbered
+ | ## Lines are not numbered.
    "unnumbered"
 
 db.verbatim.linenumbering.attribute =
@@ -318,15 +318,18 @@ db.verbatim.startinglinenumber.attribute =
 
 db.verbatim.language.attribute =
    [
-      db:refpurpose [ "Identifies the language (i.e. programming language) of the verbatim content" ]
+      db:refpurpose [ "Identifies the language (i.e. programming language) of the verbatim content." ]
    ]
    attribute language { text }
 
 db.verbatim.xml.space.attribute =
    [
-      db:refpurpose [ "Specifies that whitespace in the verbatim environment is preserved" ]
+      db:refpurpose [ "Can be used to indicate explicitly that whitespace in the verbatim environment is preserved. Whitespace must always be preserved in verbatim environments whether this attribute is specified or not." ]
    ]
-   attribute xml:space { "preserve" }
+   attribute xml:space {
+      ## Whitespace must be preserved.
+      "preserve"
+   }
 
 db.verbatim.attributes =
    db.verbatim.continuation.attribute?
@@ -363,7 +366,7 @@ db.pgwide.attribute =
 
 db.language.attribute =
    [
-      db:refpurpose [ "Identifies the language (i.e. programming language) of the content" ]
+      db:refpurpose [ "Identifies the language (i.e. programming language) of the content." ]
    ]
    attribute language { text }
 
@@ -2180,7 +2183,11 @@ div {
 div {
 
    db.screen.role.attribute = attribute role { text }
-   db.screen.width.attribute = attribute width { text }
+   db.screen.width.attribute =
+      [
+         db:refpurpose [ "Specifies the width (in characters) of the longest line (formatters may use this value to determine scaling or rotation)." ]
+      ]
+      attribute width { text }
 
    db.screen.attlist =
       db.screen.role.attribute?
-- 
2.40.0