Make internal fieldnames more transparent or at least add some comments to the struct definitions

[andreasnoack]

Converted to issue from #500

[nalimilan]

What does this issue imply exactly? Rename internal fields to use more explicit names? That's not breaking IMO.