Docs: fix up vars-on-top documentation (fixes #1234)

Fixes #1234.