renewed proposal: new attributes text:style-override and text:list-id

[Oliver-Rainer Wittmann - Software engineer - Sun Microsystems Inc<Oliver-Rainer.Wittmann@Sun.COM>]

Dear TC members,

I want to renew my proposal - see 
http://www.oasis-open.org/archives/office/200702/msg00130.html - about 
the introduction of the following new attributes:
- text:list-id for numbered paragraphs - <text:numbered-paragraph>
- text:style-override for list items - <text:list-item>
Beside these new attributes this proposal also includes some
clarifications regarding lists in ODF.

The content of the proposal isn't changed. I've only added some 
references to chapters, in which the new attributes and clarifications 
should be inserted. I also included the clarification I've given in my 
reply to Thomas Zander's request - see posting 
http://www.oasis-open.org/archives/office/200702/msg00139.html


The proposal is the result of the discussion during the TC calls and 
on this mailing list of two initial proposals. One is about 
text:list-id - see 
http://www.oasis-open.org/archives/office/200611/msg00052.html. The
other one is about text:style-override - see
http://www.oasis-open.org/archives/office/200611/msg00053.html.
Posting http://lists.oasis-open.org/archives/office/200701/msg00010.html
tries to find a compromis, but some additional clarifications about
lists in ODF are discussed - see mailing list thread started with
posting http://lists.oasis-open.org/archives/office/200702/msg00046.html


Proposal:
(1) Introduce new mandatory attribute text:list-id for
<text:numbered-paragraph>. The purpose of this attribute is to group
certain instances of <text:numbered-paragraph> together to one list.
Thus, all numbered paragraphs with the same list-id form a list and 
each list-id defines one counter domain.
For the start values of the counter domain defined by a list-id it's
proposed to use the start values of the list style of the first 
numbered paragraph of the list.
For text documents in previous ODF versions, which doesn't contain the
list-id attribute, the following handling is proposed:
- A series of numbered paragraphs using the same list style can easily
be implied to be part of the same list.
- A numbered paragraph that does not have a list-id gets the list-id 
of the last numbered-paragraph on that same level using the same 
style. If the previous has a different style, then a new list is started.

Insert this new attribute, its explanation and the handling of text 
documents in previous ODF versions in chapter 4.3.4 "Numbered 
Paragraphs", referencing ODF 1.1 specification document.


(2) If a numbered paragraph doesn't specify a list style, it's 
proposed to use the list style, which is applied to the numbered 
paragraph on the superior list level of the same list. If no such 
numbered paragraph exists, a default list style is applied.

Insert this clarification also into chapter 4.3.4 "Numbered Paragraphs".


(3) Introduce new optional attribute text:style-override for
<text:list-item>. The purpose of this attribute is that each list item
can override the defined list style of its list block by a certain 
list style. The complete list level definitions of the overriding list 
style is used to override the definitions of the overriden list style. 
If the overriding list style only contains the definition for one list 
level, only the list level definition of this list level is overriden. 
Thus, the list style, which is applied to the list item is a somehow a 
list style, which is formed by taking the list style of the list block
overriden by the list level definitions of the list style given in the
text:style-override attribute.

Insert this new attribute and its explanation into chapter 4.3.2 "List 
Item", referencing to ODF 1.1 specification document.


(4) Each top-most list block denotes a certain list and defines the
counter domain for its including list items and sub lists. The list
style, which will be applied to this list, can define start values for
each list level. A specified list style on a certain sub list 
overrides a possible given start value for its list level, if it 
contains the list definition for this list level. Each sub list 
restarts the counter for its list level.

Each sub list can have its own list style and it's proposed that the
complete list level definitions of this list style are applied to its
list items. E.g., a sub list on list level 3 defines an own list style
containing list level definitions for list level 2 and 3. Thus, these
list level definitions are used, if needed, to build the list label of
its list items and to layout its list items.

Insert this clarifications into chapter 4.3.1 "List Block", 
referencing to ODF 1.1 specification document.


(5) The ODF specification 1.1 - see chapter 4.3.1 about list blocks - 
states that only the counter domain of the direct preceding list can 
be continued using attribute text:continue-numbering.
It's proposed that with the use of attribute 
text:continue-numbered="true" the counter domain of one of the 
preceding lists is continued. Such a preceding list has to fulfill the 
condition, that is applies the same list style. If more than one of 
such a preceding list exists, the one is chosen, which is found first 
in stepping backward in the document. If no such preceding list exists 
no counter domain is continued.


(6) List styles contain definitions for certain list levels. The list 
level definitions don't have to be complete. E.g., a certain list 
style can contain the list level definitions for list level 2 and 3.
Thus, it can happen, that such a list style is applied to a certain 
list item and a missing list level definition is needed to build the 
contents of the list label. E.g., a list style only containing list 
level definition for list level 2 is applied on a list item on list 
level 2. But, it's specified, that the list label should contain the 
number of superior list level 1. Thus, list level definition for list 
level 1 is needed to determine the number format.
It's proposed use the list level definition for list level 1, which is
applied the parent/superior list item on list level 1. If no
parent/superior list item on list level 1 exists, use a default list
style. This is the same default list style, which is mentioned in
chapter 4.3.1 of ODF specification 1.1 about list blocks. The same
should be applied to numbered paragraphs of a certain list.

This clarification should be inserted into chapter 4.3.2 "List Item", 
referencing to ODF 1.1 specification document. A link to this 
clarification should be added to chapter 4.3.4 "Numbered Paragraphs"


Please support this proposal and vote on it.

Regards, Oliver.