From f3e67f694188a16e426e92fda846998fd26db50d Mon Sep 17 00:00:00 2001
From: Boris Kolpackov <boris@codesynthesis.com>
Date: Tue, 12 Jan 2010 15:14:06 +0200
Subject: Include file component in regex strings for schema being compiled

---
 documentation/xsd.1     | 32 +++++++-------------------------
 documentation/xsd.xhtml | 27 +++++++--------------------
 2 files changed, 14 insertions(+), 45 deletions(-)

(limited to 'documentation')

diff --git a/documentation/xsd.1 b/documentation/xsd.1
index 021f76a..743f1af 100644
--- a/documentation/xsd.1
+++ b/documentation/xsd.1
@@ -198,23 +198,19 @@ expressions are applied to a string in the form
 
 .I filename namespace
 
-For example,
-
-.B XMLSchema.xsd http://www.w3.org/2001/XMLSchema
-
-The
-.I filename
-for the current translation unit is empty. For example, if you have file
+For example, if you have file
 .B hello.xsd
 with namespace
 .B http://example.com/hello
 and you run
 .B xsd
-on this file, then the string in question would be:
+on this file, then the string in question will be:
 
-.B \ http://example.com/hello
+.B hello.xsd. http://example.com/hello
 
-Note the leading space.
+For the built-in XML Schema namespace the string is:
+
+.B XMLSchema.xsd http://www.w3.org/2001/XMLSchema
 
 The following three steps are performed for each regular expression until
 the match is found:
@@ -582,26 +578,12 @@ in the form
 
 .I filename namespace xpath
 
-For example,
+For instance:
 
 .B hello.xsd http://example.com/hello element
 
 .B hello.xsd http://example.com/hello type/element
 
-The
-.I filename
-for the current translation unit is empty. For example, if you have file
-.B hello.xsd
-with namespace
-.B http://example.com/hello
-and you run
-.B xsd
-on this file, then the string in question would be:
-
-.B \ http://example.com/hello element
-
-Note the leading space.
-
 As an example, the following expression makes all the derived
 names start with capital letters. This could be useful when
 your naming convention requires type names to start with
diff --git a/documentation/xsd.xhtml b/documentation/xsd.xhtml
index 99c19b0..1f1c5f8 100644
--- a/documentation/xsd.xhtml
+++ b/documentation/xsd.xhtml
@@ -172,19 +172,16 @@
 
       <p><code><i>filename</i> <i>namespace</i></code></p>
 
-      <p>For example,</p>
-
-      <p><code><b>XMLSchema.xsd http://www.w3.org/2001/XMLSchema</b></code></p>
-
-      <p>The <code><i>filename</i></code> for the current translation unit
-        is empty. For example, if you have file <code><b>hello.xsd</b></code>
+      <p>For example, if you have file <code><b>hello.xsd</b></code>
         with namespace <code><b>http://example.com/hello</b></code> and you run
         <code><b>xsd</b></code> on this file, then the string in question
-        would be:</p>
+        will be:</p>
 
-      <p><code>&nbsp;<b>http://example.com/hello</b></code></p>
+      <p><code><b>hello.xsd. http://example.com/hello</b></code></p>
 
-      <p>Note the leading space.</p>
+      <p>For the built-in XML Schema namespace the string is:</p>
+
+      <p><code><b>XMLSchema.xsd http://www.w3.org/2001/XMLSchema</b></code></p>
 
       <p>The following three steps are performed for each regular expression
         until the match is found:</p>
@@ -517,21 +514,11 @@
 
       <p><code><i>filename</i> <i>namespace</i> <i>xpath</i></code></p>
 
-      <p>For example,</p>
+      <p>For instance:</p>
 
       <p><code><b>hello.xsd http://example.com/hello element</b></code></p>
       <p><code><b>hello.xsd http://example.com/hello type/element</b></code></p>
 
-      <p>The <code><i>filename</i></code> for the current translation unit
-        is empty. For example, if you have file <code><b>hello.xsd</b></code>
-        with namespace <code><b>http://example.com/hello</b></code> and you run
-        <code><b>xsd</b></code> on this file, then the string in question
-        would be:</p>
-
-      <p><code>&nbsp;<b>http://example.com/hello element</b></code></p>
-
-      <p>Note the leading space.</p>
-
       <p>As an example, the following expression makes all the derived
          names start with capital letters. This could be useful when
          your naming convention requires type names to start with
-- 
cgit v1.1