user manual. fixes feature request #2