Re: Confusing illustration for 3.2.11

Taras Tielkes <[email protected]> Wed, 28 Aug 2002 21:01:05 +0200
Newsgroups gmane.comp.windows.devel.dime
Message-ID <011501c24ec5$493db5a0$0201a8c0@anneli>
Hi Henrik,

Yes, that would be an improvement.

Taras
----- Original Message -----
From: "Henrik Frystyk Nielsen" <[email protected]>
To: <[email protected]>
Sent: Wednesday, August 28, 2002 5:26 PM
Subject: Re: [DIME] Confusing illustration for 3.2.11


> You are right that the illustration is not correct with respect to
> representing the ELEMENT_DATA field: It is not padded and does not
have
> to be aligned to 4 octets. Only the overall OPTIONS element is 4
octet
> aligned.
>
> Would this diagram be better:
>
> 0                   1                   2                   3
> 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
> +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
> |            ELEMENT_T          |         ELEMENT_LENGTH        |
> +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
> |                         ELEMENT_DATA    ...
> +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+- ...
>
> Henrik
>
> >In the draft there's a illustration in section 3.2.11 showing
> >the layout of ELEMENT_T, ELEMENT_LENGTH and ELEMENT_DATA.
> >
> >The ELEMENT_DATA block has "/" left and right borders,
> >indicating a padding on a 4-byte boundry.
> >
> >The text that accompanies the illustration says:
> >
> >"....
> >The length of each element does not have to be a multiple of 4
> >     octets and there is no padding between elements. However, the
size
> >     of the OPTIONS field MUST be a multiple of 4 octets. If the
length
> >     of all the elements is not a multiple of 4 octets, the
generator
> >     MUST pad the OPTIONS field value with all zero octets. Padding
is
> >     not included in the OPTIONS_LENGTH field (see section 3.2.7).
..."
> >
> >The text *before* the illustration indicates:
> >
> >"The OPTIONS field contains 0 or more option elements where each
> >     element follows the layout in Figure 4 (see section 2.4 for a
> >     description of option elements): "
> >
> >If the illustration is an example of a single element (as I
> >read this), then the "'/' walls" indicating padding should not
> >be there. They should only be in the illustration for 3.2.
>