List style resolution

[Svante Schubert <svante.schubert@gmail.com>]

Before writing a JIRA issue, I would like to briefly discuss the following with you:

In our ODF 1.2 specification the resolution for the list style being used to create a list label, is described among

http://docs.oasis-open.org/office/v1.2/os/OpenDocument-v1.2-os-part1.html#ListDefaultStyle
and
http://docs.oasis-open.org/office/v1.2/os/OpenDocument-v1.2-os-part1.html#ListItemStyleRules

I would suggest following improvements:

1. Join both sections as they describe the solution of the same problem: the resolution of the list style to create a label before the first paragraph/heading of a list item
   
2. Mention the usage of the attribute http://docs.oasis-open.org/office/v1.2/os/OpenDocument-v1.2-os-part1.html#attribute-style_list-style-name more explicitly (currently described as third point within 5.3.2 Default List Style - first reference above), e.g. and reference to the attribute.
3. Mention the usage of the attribute http://docs.oasis-open.org/office/v1.2/os/OpenDocument-v1.2-os-part1.html#attribute-text_style-override  and reference to the attribute.
   

Let me try to explain how the list style is being resolved:
List styles are in general resolved similar as in CSS - choosing the closest definition (to the label or the first paragraph) as highest priority.
(This behavior is explicitly described at the last paragraph of http://docs.oasis-open.org/office/v1.2/os/OpenDocument-v1.2-os-part1.html#element-text_list "Every list, including sub lists, may have a list style which is applied to its list items and sub lists. A list style specified for a sub list overrides the list style specified for the list in which the sub list is contained."). Only the reference within the paragraph is an anomaly as the closest reference has the lowest priority.

Therefore from my understanding a list style to determine the label before the first paragraph/heading would be resolved in the following order:

1. The paragraph/heading's list style reference from its closest <text:list> or <text:list-item> ancestor is taken. <text:list> uses the attribute @text:style-name and <text:list-item> the attribute @text:style-override respectively.
   
2. If no list style was given by any <text:list> nor <text:list-item> ancestor the list-style reference of the paragraph style is being chosen, i.e. the @style:list-style-name attribute within the paragraph style <style:style> element.

After the list style is determined the correct style properties for the appropriate list level have to be chosen, but here I found no ambiguity and it should be neglected to focus on the above improvement.

Regards,
Svante