[STDS-802-11-TGM] FW: REVmc comment 5308
--- This message came from the IEEE 802.11 Task Group M Technical Reflector ---
Dear TGmc folks,
We have a bunch of related comments requesting additional words to
"decorate" a reference to a field or structure.
We agreed in principle to avoid unnecessary decoration by creating conventions
in 1.4. I'm looking to create "general purpose" statements to achieve this.
Please have a look at this resolution and see if it helps:
EDITOR: 2015-05-11 23:53:27Z - at 2.53 replace "When “field is” is used in contexts that relate to setting or testing the contents of a field, such as “The XYZ field is set to …” and “If the XYZ field is equal to 1”, these usages should be interpreted as referring to the value contained in the field."
with:
When "<x> is" is used in a context that relates to the testing or setting the value of "<x>", this usage should be interpreted as though written "the value of <x> is". This convention applies when <x> represents a field, subfield or scalar parameter.
When "<x> indicates" is used, this usage should be interpreted as though written "the value of <x> indicates". This convention applies when <x> represents a field, subfield or scalar parameter.
When "<x> indicates" is used, this usage should be interpreted as though written "the contents of <x> indicate". This convention applies when <x> represents an element, subelement or structured parameter.
Best Regards,
Adrian P STEPHENS
Tel: +44 (1793) 404825 (office)
Tel: +1 (971) 330 6025 (mobile) ⇐ please note new number
----------------------------------------------
Intel Corporation (UK) Limited
Registered No. 1134945 (England)
Registered Office: Pipers Way, Swindon SN3 1RJ VAT No: 860 2173 47
-----Original Message-----
From: hunter [mailto:hunter@xxxxxxxxxxxxxx]
Sent: Tuesday, May 12, 2015 8:23 AM
To: Stephens, Adrian P
Cc: hunter
Subject: Re: REVmc comment 5308
Hi Adrian,
I understood the "set to" and "equal to" fudge when it happened because clearly the contents of the field were involved (in fact, usually they were specifically mentioned).
However, I'm afraid I find a problem with the "indicates" fudge, because the related text (usually, if not always) mentions no value, nor, in the case of elements, even what frame the field is found in. And frequently the text does not even indicate that the field was ever transmitted or the primitive invoked. This vagueness has lead to some cases of cited fields, parameters and elements that have apparently never been transmitted (or invoked) indicating things.
If the text in each instance at least said "received field" or "transmitted field" (and in the case of elements, what frames they were transmitted in), I'd find the text at least somewhat determinable. But making these changes to much of the text (to indicate how/when/what the transmission/invocation was) will, I fear, be harder to accomplish than would simply be the text change to referencing the value of the field.
(This also is admittedly a fudge, because we frequently still are left in the air about which transmission of the field or element is being
referenced.)
Honestly, I don't know a 1.4 saying that would solve these problems -- unless, of course, the 1.4 words say something like "when the transmission or invocation of a field, primitive parameter or element (and the frame that incorporates the element) is specifically described, then using the phrase "field indicates", "parameter indicates" or "element indicates" is an acceptable alternative to referring explicitly to the contents of the field, parameter or element."
Sorry, doubt that helps with what you're writing,
Thanks, anyway, for asking,
Hunter
On 5/11/2015 4:57 PM, Stephens, Adrian P wrote:
>
> *comments*
>
> *Selected***
>
>
>
> *CID***
>
>
>
> *Page***
>
>
>
> *Clause***
>
>
>
> *Resn Status***
>
>
>
> *Comment***
>
>
>
> *Proposed Change***
>
>
>
> *Resolution***
>
>
>
> *Owning Ad-hoc***
>
> 0
>
>
>
> 5308
>
>
>
> 738.11
>
>
>
> 8.4.2.20.6
>
>
>
>
> "The Channel Number field indicates": fields don't indicate things,
> but their values do.
>
>
>
> Replace "The Channel" with "The value of the Channel". On line 17
> replace "the Operating" with "the fields of the Operating". On line 22
> replace "Randomization" with "The value of the Randomization".
>
>
>
> EDITOR: 2015-05-11 23:53:27Z - After 2.53 "When “field is” is used in
> contexts that relate to setting or testing the contents of a field,
> such as “The XYZ field is set to …” and “If the XYZ field is equal to
> 1”, these usages should be interpreted as referring to the value
> contained in the field."
>
> Append the following sentence:
>
> When “field indicates” is used to describe the purpose of a field, or
> a condition, this usage should be interpreted as referring to the
> value contained in the field."
>
>
>
> EDITOR
>
> Hello Hunter,
>
> The sentiment of the group, determined at the TGmc telecom is to
> resolve this and similar comments by updating 1.4 to capture the
> convention and
>
> thereby avoid touching lots of places in the standard.
>
> The above is my first stab (which needs extension to other scalar and
> structured types). I’m not overly happy with my wording. Can you
> suggest any
>
> improvement to it?
>
> Best Regards,
>
> Adrian P STEPHENS
>
> Tel: +44 (1793) 404825 (office)
> Tel: +1 (971) 330 6025 (mobile) çplease note new number
>
> ----------------------------------------------
> Intel Corporation (UK) Limited
> Registered No. 1134945 (England)
> Registered Office: Pipers Way, Swindon SN3 1RJ VAT No: 860 2173 47
>
_______________________________________________________________________________
IF YOU WISH to be Removed from this reflector, PLEASE DO NOT send your request to this
CLOSED reflector. We use this valuable tool to communicate on the issues at hand.
SELF SERVICE OPTION:
Point your Browser to - http://listserv.ieee.org/cgi-bin/wa?SUBED1=STDS-802-11-TGM and
then amend your subscription on the form provided. If you require removal from the reflector
press the LEAVE button.
Further information can be found at: http://www.ieee802.org/11/Email_Subscribe.html
_______________________________________________________________________________