Proposal for foot- and endnote configuration

[Michael Brauer <michael.brauer@sun.com>]

Dear TC members,

as agreed in the last con call, here is a proposal how to merge
foot- and endote configurations.

In the current specification, the <text:endnotes-configuration>
element is a subset of the <text:footnotes-configuration>
element. Compared to the footnotes element, the following is missing in 
the endnotes element:

- There is no attribute "text:footnotes-position" that specifies
   whether notes should be collected at the end of the document or
   at the end of each page. Endnotes are always collected at the end
   of the document.
- There is no attribute "text:start-numbering-at" that specifies
   whether note numbers should start with one at the beginning of
   each document, chapter or page. Endnotes always get unique numbers
   in the whole document.
- There are no child elements
   <text:footnote-continuation-notice-forward> and
   <text:footnote-continuation-notice-backward>. These elements specify
   texts that are used if a single footnote has to be distributed over
   more than one page. The forward text is appended to the footnote text
   that is displayed on the first page, the backward text is prepended to
   the rest of the footnote at the second page.

So what I propose is
- to remove the <text:endnotes-configuration> element,
- to rename <text:footnotes-configuration> to <text:notes-configuration>
   element, and to remove "foot" from all its attribute and child element
   names,
- to add a "text:type" attribute to the <text:endnotes-configuration>
   element that takes the value "footnote" and "endnote".
- to add for both note types information to the specification document
   - regarding the attributes/elements that are supported by the note
     type
   - regarding the implied default values of the attributes for the note
     type

An Relax-NG schema that corresponds to the OpenOffice.org DTD as well as
a proposal for the new schema is attached.

Best regards

Michael

----------------------------------------------
   <!-- OpenOffice.org schema -->

   <!-- footnote configuration -->
   <define name="text.footnotes-configuration">
     <element name="text:footnotes-configuration">
       <ref name="text.notes-configuration-attlist"/>
       <ref name="text.footnotes-configuration-attlist"/>
       <optional>
         <element name="text:footnote-continuation-notice-forward">
           <text/>
         </element>
         <element name="text:footnote-continuation-notice-backward">
           <text/>
         </element>
       </optional>
     </element>
   </define>

   <!-- endnote configuration -->
   <define name="text.endnotes-configuration">
     <element name="text:endnotes-configuration">
       <ref name="text.notes-configuration-attlist"/>
       <empty/>
     </element>
   </define>

   <!-- attributes common to foot and endnotes -->
   <define name="text.notes-configuration-attlist" combine="interleave">
     <optional>
       <attribute name="style:num-prefix">
         <ref name="string"/>
       </attribute>
       <attribute name="style:num-suffix">
         <ref name="string"/>
       </attribute>
       <attribute name="style:num-format">
         <ref name="string"/>
       </attribute>
       <attribute name="style:num-letter-sync">
         <ref name="string"/>
       </attribute>
       <attribute name="text:citation-body-style-name">
         <ref name="styleName"/>
       </attribute>
       <attribute name="text:citation-style-name">
         <ref name="styleName"/>
       </attribute>
       <attribute name="text:default-style-name">
         <ref name="styleName"/>
       </attribute>
       <attribute name="text:master-page-name">
         <ref name="styleName"/>
       </attribute>
       <attribute name="text:start-value">
         <ref name="integer"/>
       </attribute>
     </optional>
   </define>

   <!-- extra attributes for footnote configuration only -->
   <define name="text.footnotes-configuration-attlist" combine="interleave">
     <optional>
       <attribute name="text:footnotes-position" a:defaultValue="page">
         <choice>
           <value>document</value>
           <value>page</value>
         </choice>
       </attribute>
       <attribute name="text:start-numbering-at" a:defaultValue="document">
         <choice>
           <value>document</value>
           <value>chapter</value>
           <value>page</value>
         </choice>
       </attribute>
     </optional>
   </define>

----------------------------------------------
   <!-- proposed new schema -->

   <!-- notes configuration -->
   <define name="text.notes-configuration">
     <element name="text:notes-configuration">
       <ref name="text.notes-configuration-attlist"/>
       <optional>
         <element name="text:note-continuation-notice-forward">
           <text/>
         </element>
         <element name="text:note-continuation-notice-backward">
           <text/>
         </element>
       </optional>
     </element>
   </define>

   <!-- attributes common to foot and endnotes -->
   <define name="text.notes-configuration-attlist" combine="interleave">
     <optional>
	  <attribute name="text:type">
         <choice>
           <value>footnote</value>
           <value>endnote</value>
         </choice>
       </attribute>
       <attribute name="style:num-prefix">
         <ref name="string"/>
       </attribute>
       <attribute name="style:num-suffix">
         <ref name="string"/>
       </attribute>
       <attribute name="style:num-format">
         <ref name="string"/>
       </attribute>
       <attribute name="style:num-letter-sync">
         <ref name="string"/>
       </attribute>
       <attribute name="text:citation-body-style-name">
         <ref name="styleName"/>
       </attribute>
       <attribute name="text:citation-style-name">
         <ref name="styleName"/>
       </attribute>
       <attribute name="text:default-style-name">
         <ref name="styleName"/>
       </attribute>
       <attribute name="text:master-page-name">
         <ref name="styleName"/>
       </attribute>
       <attribute name="text:start-value">
         <ref name="integer"/>
       </attribute>
       <attribute name="text:notes-position" a:defaultValue="page">
         <choice>
           <value>document</value>
           <value>page</value>
         </choice>
       </attribute>
       <attribute name="text:start-numbering-at" a:defaultValue="document">
         <choice>
           <value>document</value>
           <value>chapter</value>
           <value>page</value>
         </choice>
       </attribute>
     </optional>
   </define>