attempt to eliminate racae conditition using lock; intuition dictates there is a better solution
fixing reader symbol
adding codox
adding source lines to docs