remove comments
clarify ro vs. rw
die if argument are passed to read-only sub
add validate interface