From 80602156780ec1ccd6488adc6b337a010b817a65 Mon Sep 17 00:00:00 2001
From: Jirka Kosek <jirka@kosek.cz>
Date: Sun, 28 Oct 2007 10:20:08 +0000
Subject: [PATCH] Information about referencing DocBook schema

---
 docbook/relaxng/docbook/howto/howto.xml | 12 +++++++++++-
 1 file changed, 11 insertions(+), 1 deletion(-)

diff --git a/docbook/relaxng/docbook/howto/howto.xml b/docbook/relaxng/docbook/howto/howto.xml
index da22dbc43..698a835ef 100644
--- a/docbook/relaxng/docbook/howto/howto.xml
+++ b/docbook/relaxng/docbook/howto/howto.xml
@@ -1248,7 +1248,17 @@ linkend="convert4to5"/>.
     except define the name spaces and include the standard DocBook schema.
     The <tag class="attribute">href</tag> attribute of the
     <tag condition="nolink">include</tag> element points to
-    the location of the standard DocBook V5.0 schema.
+    the location of the standard DocBook V5.0
+    schema.<footnote><para>Examples below use
+    <filename>docbook.rng</filename> as schema location. If you want
+    to create portable schema customization you should use standard
+    web-accessible location like
+    <uri>http://docbook.org/xml/&version;/rng/docbook.rng</uri> and
+    then use <link
+    xl:href="http://www.oasis-open.org/committees/download.php/14809/xml-catalogs.html">XML
+    catalogs</link> to resolve this location to your local copy of the
+    schema for improved perfomance. Unfortunatelly at the time of
+    this writing not all RELAX NG validators support XML catalogs.</para></footnote>
     All of the examples are given in both RNG and RNC form.
 <example xml:id="ex-empty"><title>Empty customization file</title>
 <programlisting language="rng"><![CDATA[<?xml version="1.0" encoding="UTF-8"?>
-- 
2.40.0