19.856 text:reference-format - defining "number" - ambiguous language - see description

Presently reads:

"number: displays the list label of the referenced item. To unambiguously identify the referenced item at the document position of the reference field, the list label content for as many superior list levels are added in front as are required to make the reference unambiguous. The required superior levels of the referenced item are the ones, which differ from the superior levels of the document position of the reference field.

The list label of the referenced item may already contain numbers of superior levels. If this is the case, and if n is the level of the most superior level contained in the list label, then no list label content of superior levels smaller or equal than n are added."

I read this while tired and then returned to it when I was better rested. Still deeply troubled text.

1) What is the difference between this and number-all-superior?

2) What is the difference between this and chapter? (They both give the same results in OOo.)

3) Required to make the reference unambiguous is itself ambiguous. To who? For what purpose? For this document?

A more fundamental problem may be that we never explicitly define "list label."

To unravel that knot, see 7.7.5 <text:reference-ref> (I will do a separate bug report on that issue.)

Suggest that we fix the "list label" definition issue and use that to fix all the problems with the text for number, number-all-superior and number-no-superior.