OASIS Mailing List ArchivesView the OASIS mailing list archive below
or browse/search using MarkMail.

 


Help: OASIS Mailing Lists Help | MarkMail Help

office message

[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]


Subject: [OASIS Issue Tracker] Commented: (OFFICE-2917) 19.856text:reference-format - defining "number" - ambiguous language - seedescription



    [ http://tools.oasis-open.org/issues/browse/OFFICE-2917?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=20328#action_20328 ] 

Michael Stahl  commented on OFFICE-2917:
----------------------------------------

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

"number" only includes the superior labels as, uhm, "necessary" relative to the position of the field,
while "number-all-superior" always includes all superior labels.

example:
1. foo
  a. bar
    i. baz
    ii. ref to baz (number): i.                          (on the same level as i, so i is unambiguous)
    iii. ref to baz (number-no-superior): i.
    iv. ref to baz (number-all-superior): 1.a.i.
  b. ref  to baz (number): a.i.                        (one level up, so need to include a.)
  c. ref  to baz (number-no-superior): i.
  d. ref  to baz (number-all-superior): 1.a.i.

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

for me it gives different results.
have you perhaps used the same numbering symbols for outline numbering as for the list?
in that case it's difficult to tell :)

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

unambiguous in the context of the list structure and the position of the referenced list item and the position of the reference field.
in other words: the path from the reference field to the referenced item must be "obvious".
perhaps the wording could be improved, but i don't know how.

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

in the text:reference-format description there is this:

"If the referenced item is contained in a list or a numbered paragraph, the list label is the formatted number of the paragraph which contains the referenced item. If the referenced item is not contained in a list or numbered paragraph, the list label is empty, and the referenced field therefore displays nothing."

but there does not seem to be a definition of "list label" in section "5.3 Lists"...

> 19.856 text:reference-format - defining "number" - ambiguous language - see description
> ---------------------------------------------------------------------------------------
>
>                 Key: OFFICE-2917
>                 URL: http://tools.oasis-open.org/issues/browse/OFFICE-2917
>             Project: OASIS Open Document Format for Office Applications (OpenDocument) TC
>          Issue Type: Bug
>          Components: Text
>    Affects Versions: ODF 1.2 CD 05
>            Reporter: Patrick Durusau
>             Fix For: ODF 1.2 CD 06
>
>
> 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. 

-- 
This message is automatically generated by JIRA.
-
If you think it was sent incorrectly contact one of the administrators: http://tools.oasis-open.org/issues/secure/Administrators.jspa
-
For more information on JIRA, see: http://www.atlassian.com/software/jira

        


[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]