Update base.theme.bash

Faster Mercurial status
Can you add a couple of comments to describe what the function does, and what it returns? I think this would be helpful and great for maintenance.