fix scope accounting bug and documentation per Konrad's request

Signed-off-by: Nikolaj Bjorner <nbjorner@microsoft.com>