> * The fact that is so confusing implies that the Assembler Services > Guide is not doing a good job of explaining it. It is hard to > understand because it defies expectations. What you *expect* is that > you have a value that describes the format of a structure, and by > implication, its length.
I can understand that someone might have that expectation before starting to read about the interface, but once you read how it actually works, it is up to you to drop your expectation and go with what the documentation says. You might say to yourself, "Oh, that's the way it works? That surprises me, but okay." You should not say to yourself, "That can't be the way it works, so I'll proceed under the assumption the documentation is incorrect." Of course, if you feel that the Assembler Services Guide is hard to understand because it's vague, self-contradictory, incomplete, etc., you should definitely submit a Reader Comment Form. - mb
