Doc update: better distinction between package and lexical variable behaviors