[xiph-cvs] cvs commit: vorbis/doc/xml Vorbis_I_spec.xml 01-introduction.xml 02-bitpacking.xml 03-codebook.xml 04-codec.xml 05-comment.xml 06-floor0.xml 07-floor1.xml 08-residue.xml 09-helper.xml 10-tables.xml a1-encapsulation_ogg.xml a2-encapsulation_rtp.xml footer.xml

Ralph Giles giles at xiph.org
Sun Oct 27 06:55:31 PST 2002 


giles       02/10/27 09:55:31

  Modified:    doc/xml  Vorbis_I_spec.xml 01-introduction.xml
                        02-bitpacking.xml 03-codebook.xml 04-codec.xml
                        05-comment.xml 06-floor0.xml 07-floor1.xml
                        08-residue.xml 09-helper.xml 10-tables.xml
                        a1-encapsulation_ogg.xml a2-encapsulation_rtp.xml
                        footer.xml
  Log:
  Switch to XInclude from SYSTEM entities for module inclusion to work around
  a bug in xsltproc which prevents xref resolution in complex documents
  (http://bugzilla.gnome.org/show_bug.cgi?id=96925).
  
  This pretty much ties us to xsltproc for the time being. To use another
  XSLT engine, try running the top-level file through 'xmllint --xinclude'
  first.
  
  Running things through 'xmllint --noent' is also an effective work around,
  but xinclude is nicer for most of our purposes.
  
  Also corrects a nesting problem in the residue decode section.

Revision  Changes    Path
1.9       +15 -25    vorbis/doc/xml/Vorbis_I_spec.xml

Index: Vorbis_I_spec.xml
===================================================================
RCS file: /usr/local/cvsroot/vorbis/doc/xml/Vorbis_I_spec.xml,v
retrieving revision 1.8
retrieving revision 1.9
diff -u -r1.8 -r1.9
--- Vorbis_I_spec.xml	26 Oct 2002 13:24:05 -0000	1.8
+++ Vorbis_I_spec.xml	27 Oct 2002 14:55:31 -0000	1.9
@@ -6,18 +6,6 @@
 <!ENTITY uuml "&#x00FC;"> <!-- Latin small letter u with diaeresis -->
 <!-- parser isn't finding %isogrk3; -->
 <!ENTITY pi	"&#x03C0;"> <!-- GREEK SMALL LETTER PI -->
-<!ENTITY intro SYSTEM "01-introduction.xml">
-<!ENTITY bitpacking SYSTEM "02-bitpacking.xml">
-<!ENTITY codebook SYSTEM "03-codebook.xml">
-<!ENTITY codec SYSTEM "04-codec.xml">
-<!ENTITY comment SYSTEM "05-comment.xml">
-<!ENTITY floor0 SYSTEM "06-floor0.xml">
-<!ENTITY floor1 SYSTEM "07-floor1.xml">
-<!ENTITY residue SYSTEM "08-residue.xml">
-<!ENTITY helpers SYSTEM "09-helper.xml">
-<!ENTITY tables SYSTEM "10-tables.xml">
-<!ENTITY oggvorbis SYSTEM "a1-encapsulation_ogg.xml">
-<!ENTITY rtpvorbis SYSTEM "a2-encapsulation_rtp.xml">
 <!ENTITY colophon SYSTEM "footer.xml">
 ]>
 
@@ -27,18 +15,20 @@
   <corpauthor>Xiph.org Foundation</corpauthor>
 </articleinfo>
 
-&intro;
-&bitpacking;
-&codebook;
-&codec;
-&comment;
-&floor0;
-&floor1;
-&residue;
-&helpers;
-&tables;
-&oggvorbis;
-&rtpvorbis;
-&colophon;
+ <xi:include href="01-introduction.xml"  xmlns:xi="http://www.w3.org/2001/XInclude"/> 
+ <xi:include href="02-bitpacking.xml"    xmlns:xi="http://www.w3.org/2001/XInclude"/> 
+ <xi:include href="03-codebook.xml"      xmlns:xi="http://www.w3.org/2001/XInclude"/> 
+ <xi:include href="04-codec.xml"         xmlns:xi="http://www.w3.org/2001/XInclude"/> 
+ <xi:include href="05-comment.xml"       xmlns:xi="http://www.w3.org/2001/XInclude"/> 
+ <xi:include href="06-floor0.xml"        xmlns:xi="http://www.w3.org/2001/XInclude"/> 
+ <xi:include href="07-floor1.xml"        xmlns:xi="http://www.w3.org/2001/XInclude"/> 
+ <xi:include href="08-residue.xml"       xmlns:xi="http://www.w3.org/2001/XInclude"/> 
+ <xi:include href="09-helper.xml"        xmlns:xi="http://www.w3.org/2001/XInclude"/> 
+ <xi:include href="10-tables.xml"        xmlns:xi="http://www.w3.org/2001/XInclude"/> 
+
+ <xi:include href="a1-encapsulation_ogg.xml"  xmlns:xi="http://www.w3.org/2001/XInclude"/> 
+ <xi:include href="a2-encapsulation_rtp.xml"  xmlns:xi="http://www.w3.org/2001/XInclude"/>
+
+ <xi:include href="footer.xml"           xmlns:xi="http://www.w3.org/2001/XInclude"/>
 
 </article>

<p><p>1.5       +9 -3      vorbis/doc/xml/01-introduction.xml

Index: 01-introduction.xml
===================================================================
RCS file: /usr/local/cvsroot/vorbis/doc/xml/01-introduction.xml,v
retrieving revision 1.4
retrieving revision 1.5
diff -u -r1.4 -r1.5
--- 01-introduction.xml	21 Oct 2002 23:36:59 -0000	1.4
+++ 01-introduction.xml	27 Oct 2002 14:55:31 -0000	1.5
@@ -1,7 +1,13 @@
+<?xml version="1.0" standalone="no"?>
+<!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
+                "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd" [
+
+]>
+
 <section id="vorbis-spec-intro">
 <sectioninfo>
 <releaseinfo>
- $Id: 01-introduction.xml,v 1.4 2002/10/21 23:36:59 giles Exp $
+ $Id: 01-introduction.xml,v 1.5 2002/10/27 14:55:31 giles Exp $
 <emphasis>Last update to this document: July 18, 2002</emphasis>
 </releaseinfo>
 </sectioninfo>
@@ -12,8 +18,8 @@
 
 <para>
 This document provides a high level description of the Vorbis codec's
-construction.  A bit-by-bit specification appears beginning in <xref
-linkend="vorbis-spec-codec"/>. The later sections assume a high-level
+construction.  A bit-by-bit specification appears beginning in <xref linkend="vorbis-spec-codec"/>.
+The later sections assume a high-level
 understanding of the Vorbis decode process, which is 
 provided here.</para>
 

<p><p>1.5       +7 -1      vorbis/doc/xml/02-bitpacking.xml

Index: 02-bitpacking.xml
===================================================================
RCS file: /usr/local/cvsroot/vorbis/doc/xml/02-bitpacking.xml,v
retrieving revision 1.4
retrieving revision 1.5
diff -u -r1.4 -r1.5
--- 02-bitpacking.xml	21 Oct 2002 23:37:00 -0000	1.4
+++ 02-bitpacking.xml	27 Oct 2002 14:55:31 -0000	1.5
@@ -1,7 +1,13 @@
+<?xml version="1.0" standalone="no"?>
+<!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
+                "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd" [
+
+]>
+
 <section id="vorbis-spec-bitpacking">
 <sectioninfo>
 <releaseinfo>
- $Id: 02-bitpacking.xml,v 1.4 2002/10/21 23:37:00 giles Exp $
+ $Id: 02-bitpacking.xml,v 1.5 2002/10/27 14:55:31 giles Exp $
  <emphasis>Last update to this document: July 14, 2002</emphasis>
 </releaseinfo>
 </sectioninfo>

<p><p>1.4       +7 -1      vorbis/doc/xml/03-codebook.xml

Index: 03-codebook.xml
===================================================================
RCS file: /usr/local/cvsroot/vorbis/doc/xml/03-codebook.xml,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -r1.3 -r1.4
--- 03-codebook.xml	21 Oct 2002 23:37:00 -0000	1.3
+++ 03-codebook.xml	27 Oct 2002 14:55:31 -0000	1.4
@@ -1,7 +1,13 @@
+<?xml version="1.0" standalone="no"?>
+<!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
+                "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd" [
+
+]>
+
 <section id="vorbis-spec-codebook">
 <sectioninfo>
 <releaseinfo>
- $Id: 03-codebook.xml,v 1.3 2002/10/21 23:37:00 giles Exp $
+ $Id: 03-codebook.xml,v 1.4 2002/10/27 14:55:31 giles Exp $
  <emphasis>Last update to this document: August 8, 2002</emphasis>
 </releaseinfo>
 </sectioninfo>

<p><p>1.6       +7 -1      vorbis/doc/xml/04-codec.xml

Index: 04-codec.xml
===================================================================
RCS file: /usr/local/cvsroot/vorbis/doc/xml/04-codec.xml,v
retrieving revision 1.5
retrieving revision 1.6
diff -u -r1.5 -r1.6
--- 04-codec.xml	25 Oct 2002 14:41:13 -0000	1.5
+++ 04-codec.xml	27 Oct 2002 14:55:31 -0000	1.6
@@ -1,7 +1,13 @@
+<?xml version="1.0" standalone="no"?>
+<!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
+                "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd" [
+<!ENTITY pi     "&#x03C0;"> <!-- GREEK SMALL LETTER PI -->
+]>
+
 <section id="vorbis-spec-codec">
 <sectioninfo>
 <releaseinfo>
- $Id: 04-codec.xml,v 1.5 2002/10/25 14:41:13 giles Exp $
+ $Id: 04-codec.xml,v 1.6 2002/10/27 14:55:31 giles Exp $
  <emphasis>Last update to this document: October 15, 2002</emphasis>
 </releaseinfo>
 </sectioninfo>

<p><p>1.4       +7 -1      vorbis/doc/xml/05-comment.xml

Index: 05-comment.xml
===================================================================
RCS file: /usr/local/cvsroot/vorbis/doc/xml/05-comment.xml,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -r1.3 -r1.4
--- 05-comment.xml	25 Oct 2002 14:41:44 -0000	1.3
+++ 05-comment.xml	27 Oct 2002 14:55:31 -0000	1.4
@@ -1,7 +1,13 @@
+<?xml version="1.0" standalone="no"?>
+<!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
+                "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd" [
+<!ENTITY uuml "&#x00FC;"> <!-- Latin small letter u with diaeresis -->
+]>
+
 <section id="vorbis-spec-comment">
 <sectioninfo>
  <releaseinfo>
- $Id: 05-comment.xml,v 1.3 2002/10/25 14:41:44 giles Exp $
+ $Id: 05-comment.xml,v 1.4 2002/10/27 14:55:31 giles Exp $
  <emphasis>Last update to this document: July 16, 2002</emphasis>
 </releaseinfo>
 </sectioninfo>

<p><p>1.6       +7 -1      vorbis/doc/xml/06-floor0.xml

Index: 06-floor0.xml
===================================================================
RCS file: /usr/local/cvsroot/vorbis/doc/xml/06-floor0.xml,v
retrieving revision 1.5
retrieving revision 1.6
diff -u -r1.5 -r1.6
--- 06-floor0.xml	26 Oct 2002 15:43:57 -0000	1.5
+++ 06-floor0.xml	27 Oct 2002 14:55:31 -0000	1.6
@@ -1,7 +1,13 @@
+<?xml version="1.0" standalone="no"?>
+<!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
+                "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd" [
+
+]>
+
 <section id="vorbis-spec-floor0">
 <sectioninfo>
 <releaseinfo>
-  $Id: 06-floor0.xml,v 1.5 2002/10/26 15:43:57 giles Exp $
+  $Id: 06-floor0.xml,v 1.6 2002/10/27 14:55:31 giles Exp $
   <emphasis>Last update to this document: July 19, 2002</emphasis>
 </releaseinfo>
 </sectioninfo>  

<p><p>1.3       +7 -1      vorbis/doc/xml/07-floor1.xml

Index: 07-floor1.xml
===================================================================
RCS file: /usr/local/cvsroot/vorbis/doc/xml/07-floor1.xml,v
retrieving revision 1.2
retrieving revision 1.3
diff -u -r1.2 -r1.3
--- 07-floor1.xml	18 Oct 2002 00:43:00 -0000	1.2
+++ 07-floor1.xml	27 Oct 2002 14:55:31 -0000	1.3
@@ -1,7 +1,13 @@
+<?xml version="1.0" standalone="no"?>
+<!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
+                "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd" [
+
+]>
+
 <section id="vorbis-spec-floor1">
 <sectioninfo>
 <releaseinfo>
- $Id: 07-floor1.xml,v 1.2 2002/10/18 00:43:00 giles Exp $
+ $Id: 07-floor1.xml,v 1.3 2002/10/27 14:55:31 giles Exp $
  <emphasis>Last update to this document: October 15, 2002</emphasis>
 </releaseinfo>
 </sectioninfo>

<p><p>1.3       +9 -3      vorbis/doc/xml/08-residue.xml

Index: 08-residue.xml
===================================================================
RCS file: /usr/local/cvsroot/vorbis/doc/xml/08-residue.xml,v
retrieving revision 1.2
retrieving revision 1.3
diff -u -r1.2 -r1.3
--- 08-residue.xml	13 Oct 2002 15:18:47 -0000	1.2
+++ 08-residue.xml	27 Oct 2002 14:55:31 -0000	1.3
@@ -1,7 +1,13 @@
+<?xml version="1.0" standalone="no"?>
+<!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
+                "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd" [
+
+]>
+
 <section id="vorbis-spec-residue">
 <sectioninfo>
  <releaseinfo>
-  $Id: 08-residue.xml,v 1.2 2002/10/13 15:18:47 giles Exp $
+  $Id: 08-residue.xml,v 1.3 2002/10/27 14:55:31 giles Exp $
   <emphasis>Last update to this document: July 19, 2002</emphasis>
  </releaseinfo>
 </sectioninfo>
@@ -176,8 +182,6 @@
 
 </section>
 
-</section>
-
 <section>
 <title>Residue decode</title>
 
@@ -447,6 +451,8 @@
 1; if all vectors are marked 'do not decode', no decode occurrs.
 However, if at least one vector is to be decoded, all the vectors are
 decoded.</para>
+
+</section>
 
 </section>
 

<p><p>1.4       +7 -1      vorbis/doc/xml/09-helper.xml

Index: 09-helper.xml
===================================================================
RCS file: /usr/local/cvsroot/vorbis/doc/xml/09-helper.xml,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -r1.3 -r1.4
--- 09-helper.xml	16 Oct 2002 21:43:32 -0000	1.3
+++ 09-helper.xml	27 Oct 2002 14:55:31 -0000	1.4
@@ -1,7 +1,13 @@
+<?xml version="1.0" standalone="no"?>
+<!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
+                "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd" [
+
+]>
+
 <section id="vorbis-spec-helper">
 <sectioninfo>
 <releaseinfo>
- $Id: 09-helper.xml,v 1.3 2002/10/16 21:43:32 giles Exp $
+ $Id: 09-helper.xml,v 1.4 2002/10/27 14:55:31 giles Exp $
  <emphasis>Last update to this document: October 15, 2002</emphasis>
 </releaseinfo>
 </sectioninfo>

<p><p>1.2       +7 -1      vorbis/doc/xml/10-tables.xml

Index: 10-tables.xml
===================================================================
RCS file: /usr/local/cvsroot/vorbis/doc/xml/10-tables.xml,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- 10-tables.xml	12 Oct 2002 20:37:11 -0000	1.1
+++ 10-tables.xml	27 Oct 2002 14:55:31 -0000	1.2
@@ -1,7 +1,13 @@
+<?xml version="1.0" standalone="no"?>
+<!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
+                "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd" [
+
+]>
+
 <section id="vorbis-spec-tables">
 <sectioninfo>
  <releaseinfo>
-  $Id: 10-tables.xml,v 1.1 2002/10/12 20:37:11 giles Exp $
+  $Id: 10-tables.xml,v 1.2 2002/10/27 14:55:31 giles Exp $
   <emphasis>Last update to this document: July 18, 2002</emphasis>
  </releaseinfo>
 </sectioninfo>

<p><p>1.2       +7 -2      vorbis/doc/xml/a1-encapsulation_ogg.xml

Index: a1-encapsulation_ogg.xml
===================================================================
RCS file: /usr/local/cvsroot/vorbis/doc/xml/a1-encapsulation_ogg.xml,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- a1-encapsulation_ogg.xml	16 Oct 2002 22:46:44 -0000	1.1
+++ a1-encapsulation_ogg.xml	27 Oct 2002 14:55:31 -0000	1.2
@@ -1,9 +1,14 @@
-<?xml version="1.0" ?>
+<?xml version="1.0" standalone="no"?>
+<!DOCTYPE appendix PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
+                "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd" [
+
+]>
+
 <appendix id="vorbis-over-ogg">
 <appendixinfo>
  <releaseinfo>
   <emphasis>Last update to this document: July 14, 2002</emphasis>
-  $Id: a1-encapsulation_ogg.xml,v 1.1 2002/10/16 22:46:44 giles Exp $
+  $Id: a1-encapsulation_ogg.xml,v 1.2 2002/10/27 14:55:31 giles Exp $
  </releaseinfo>
 </appendixinfo>
 <title>Embedding Vorbis into an Ogg stream</title>

<p><p>1.3       +8 -3      vorbis/doc/xml/a2-encapsulation_rtp.xml

Index: a2-encapsulation_rtp.xml
===================================================================
RCS file: /usr/local/cvsroot/vorbis/doc/xml/a2-encapsulation_rtp.xml,v
retrieving revision 1.2
retrieving revision 1.3
diff -u -r1.2 -r1.3
--- a2-encapsulation_rtp.xml	26 Oct 2002 13:21:35 -0000	1.2
+++ a2-encapsulation_rtp.xml	27 Oct 2002 14:55:31 -0000	1.3
@@ -1,14 +1,19 @@
-<?xml version="1.0" ?>
+<?xml version="1.0" standalone="no"?>
+<!DOCTYPE appendix PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
+                "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd" [
+
+]>
+
 <appendix id="vorbis-over-rtp">
 <appendixinfo>
  <releaseinfo>
-  <emphasis>$Id: a2-encapsulation_rtp.xml,v 1.2 2002/10/26 13:21:35 giles Exp $</emphasis>
+  <emphasis>$Id: a2-encapsulation_rtp.xml,v 1.3 2002/10/27 14:55:31 giles Exp $</emphasis>
  </releaseinfo>
 </appendixinfo>
 <title>Vorbis encapsulation in RTP</title>
 
 <literallayout class="monospaced">
-<!-- this works with extensions implemented in Saxon and Xalan 
+<!-- this works with extensions implemented in Saxon and Xalan
 <textobject><textdata fileref="../draft-moffitt-vorbis-rtp-00.txt"/></textobject> -->
 <!-- this works with xinclude, implemented in xsltproc -->
 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"

<p><p>1.3       +10 -2     vorbis/doc/xml/footer.xml

Index: footer.xml
===================================================================
RCS file: /usr/local/cvsroot/vorbis/doc/xml/footer.xml,v
retrieving revision 1.2
retrieving revision 1.3
diff -u -r1.2 -r1.3
--- footer.xml	16 Oct 2002 22:46:44 -0000	1.2
+++ footer.xml	27 Oct 2002 14:55:31 -0000	1.3
@@ -1,4 +1,11 @@
-<!-- articles can't have an explicit colophon -->
+<?xml version="1.0" standalone="no"?>
+<!DOCTYPE appendix PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
+                "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd" [
+
+]>
+<!-- footer or colophon for xiph.org documents -->
+
+<!-- articles aren't permitted an explicit colophon -->
 <appendix id="footer">
 <title>Colophon</title>
 
@@ -19,7 +26,7 @@
 </mediaobject>
 
 <para>
-Ogg is a <ulink url="http://www.xiph.org">Xiph.org Foundation</ulink> effort
+Ogg is a <ulink url="http://www.xiph.org/">Xiph.org Foundation</ulink> effort
 to protect essential tenets of Internet multimedia from corporate
 hostage-taking; Open Source is the net's greatest tool to keep
 everyone honest. See <ulink url="http://www.xiph.org/about.html">About
@@ -50,3 +57,4 @@
 </para>
 
 </appendix>
+<!-- end of colophon -->

<p><p>--- >8 ----
List archives:  http://www.xiph.org/archives/
Ogg project homepage: http://www.xiph.org/ogg/
To unsubscribe from this list, send a message to 'cvs-request at xiph.org'
containing only the word 'unsubscribe' in the body.  No subject is needed.
Unsubscribe messages sent to the list will be ignored/filtered.

More information about the commits mailing list