bugfix + minor docs change.  This appears to work now.