anton and I are pretty sure this call can fail
add first version of ring buffer spec
tweak
tweaks
updates
add a call to get ring size

add remarks about wrapping
revisions
add implementation details from today
Merge branch 'master' into leif2