A few minor errors in and suggestions for the spec document
-----------------------------------------------------------

                 Key: AVRO-85
                 URL: https://issues.apache.org/jira/browse/AVRO-85
             Project: Avro
          Issue Type: Bug
            Reporter: Thiruvalluvan M. G.


There are a few minor errors in the specifications document:

   - The 32-bit and 64-bit floating point numbers should mention the exact IEEE 
standard (i.e IEEE 754 instead of plain IEEE).
   - It'll be clearer if we state that the long value preceding string or bytes 
is the number of bytes being encoded.
   - In the binary serialization example for unicode string "foo" the length 3 
will get encoded as 0x06 not 0x0c.
   - We should be more specific about how one serializes float and double, 
Unfortunately, the IEEE 754 does not specify byte ordering. At least we can 
point to {html} <a 
href="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Double.html#doubleToRawLongBits%28double%29";
 /> {html} for details.
  - In the resolution section, we should mention how default values for record 
fields get used
 - There is a sudden mention of "method parameters" in the resolution of 
records; the reader won't have a clue what it refers to.

-- 
This message is automatically generated by JIRA.
-
You can reply to this email to add a comment to the issue online.

Reply via email to