[OASIS Issue Tracker] Commented: (OFFICE-3462) 19.310form:step-size and 19.300 form:page-step-size ill-defined

[OASIS Issues Tracker <workgroup_mailer@lists.oasis-open.org>]

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

Patrick Durusau commented on OFFICE-3462:
-----------------------------------------

Dennis, 

The choice of "a" isn't entirely free from doubt in all cases.

The distinction I have been trying to draw is:

1) When we are taking about any instance of either an element or attribute, and

2) When we are taking about a particular instance of an element or attribute.

For example:

"The draw:notify-on-update-of-ranges attribute specifies that a <draw:object> will be notified if content within a given ranges changes. "

Note: "a <draw:object>" (any draw:object element) and "a given range" (any range).

Contrast with what I consider to be incorrect phrasing:

"The draw:notify-on-update-of-ranges attribute specifies the <draw:object> will be notified if content within a given ranges changes. "

So, which "the <draw:object>" are we talking about? 

As a standard we should be announcing the rule for all <draw:object> elements.

Here is a good example of "the" :

"The extrusion color is defined by the draw:secondary-fill-color attribute specified in a custom shape's graphic style."

Note "the draw:secondary-fill-color attribute" because we are talking about the specific draw:secondary-fill-color" attribute on a graphic style. We don't know which graphic style but it isn't just some random draw:secondary-fill-color attribute.

I doubt in over 1200 pages I have been entirely consistent but that is the distinction I have been trying to use. 

> 19.310 form:step-size and 19.300 form:page-step-size ill-defined
> ----------------------------------------------------------------
>
>                 Key: OFFICE-3462
>                 URL: http://tools.oasis-open.org/issues/browse/OFFICE-3462
>             Project: OASIS Open Document Format for Office Applications (OpenDocument) TC
>          Issue Type: Bug
>          Components: Forms, Part 1 (Schema)
>    Affects Versions: ODF 1.2 CD 05
>            Reporter: Dennis Hamilton
>            Assignee: Patrick Durusau
>             Fix For: ODF 1.2 CD 06
>
>
> The form:page-step-size and form:step-size attributes are not defined well enough to understand their function.  
> These appear to be involved with regard to stepping through values as part of UI activity in which the value is chosen.   The analogy of form:page-step-size with "page down" functionality means something different depending on whether there is a drop-down of values offered versus whether the value in a spinner is being adjusted.  
> Since these attributes are only used for <form:value-range>, maybe they need to be descibed better in terms of what their (optional) functionality is for such a control.  I have no objection to change to double, but we also need to know what these are provided for and whether they are intended as constraints or simply aids for assisting users in selecting/entering a value.
> See also OFFICE-3412 where there is a related issue.

-- 
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