Re: Name for maxRetransmitTime (Re: New editor's draft (v20140321))

On 26 Mar 2014, at 13:39, Harald Alvestrand <harald@alvestrand.no> wrote:

> OK, I've created https://www.w3.org/Bugs/Public/show_bug.cgi?id=25155 to track this.
> 
> I dislike the name "maxLifeTime", because it's hard to tell that this is the lifetime of a packet, and not something else. Would you be equally happy if it was "maxPacketLifeTime"?
Sure, no problem.

Best regards
Michael
> 
> I frankly regard the accuracy of the description as more important than the name, but naming tends to be somewhat important too.
> 
> On 03/24/2014 07:31 PM, Michael Tuexen wrote:
>> Replace
>> maxRetransmitTime
>> by
>> maxLifeTime.
>> 
>> Replace
>> ... or set a time during which retransmissions are allowed (maxRetransmitTime).
>> by
>> ... or set a time during which transmissions and retransmissions are allowed (maxLifeTime).
>> 
>> Replace
>> maxRetransmitTime of type unsigned, readonly , nullable
>> The RTCDataChannel.maxRetransmitTime attribute returns the length of the time window (in milliseconds) during which retransmissions may occur in unreliable mode, or null if unset. The attribute MUST be initialized to null by default and MUST return the value to which it was set when the RTCDataChannel was created.
>> 
>> by
>> 
>> maxLifeTime of type unsigned, readonly , nullable
>> The RTCDataChannel.maxLifeTime attribute returns the length of the time window (in milliseconds) during which transmissions and retransmissions may occur in unreliable mode, or null if unset. The attribute MUST be initialized to null by default and MUST return the value to which it was set when the RTCDataChannel was created.
>> 
>> Replace
>> 
>> maxRetransmitTime of type unsigned short
>> Limits the time during which the channel will retransmit data if not successfully delivered. This value may be clamped if it exceeds the maximum value supported by the user agent.
>> 
>> by
>> 
>> maxLifeTime of type unsigned short
>> Limits the time during which the channel will transmit or retransmit data if not acknowledged. This value may be clamped if it exceeds the maximum value supported by the user agent.
> 
> 
> 

Received on Wednesday, 26 March 2014 15:50:42 UTC