Clarify some doc comments.
Clarify some doc comments.

reedobrien/juju,gabriel-samfira/juju,mikemccracken/juju,macgreagoir/juju,mjs/juju,frankban/juju,bac/juju,kat-co/juju,makyo/juju,mikemccracken/juju,howbazaar/juju,alesstimec/juju,howbazaar/juju,perrito666/juju,macgreagoir/juju,waigani/juju,bogdanteleaga/juju,bz2/juju,davecheney/juju,bz2/juju,mikemccracken/juju,mjs/juju,alesstimec/juju,gabriel-samfira/juju,AdamIsrael/juju,bac/juju,bac/juju,dimitern/juju,waigani/juju,dimitern/juju,axw/juju,howbazaar/juju,frankban/juju,AdamIsrael/juju,reedobrien/juju,gabriel-samfira/juju,kat-co/juju,mikemccracken/juju,gabriel-samfira/juju,reedobrien/juju,axw/juju,dooferlad/juju,axw/juju,howbazaar/juju,dimitern/juju,perrito666/juju,makyo/juju,axw/juju,bz2/juju,macgreagoir/juju,waigani/juju,dimitern/juju,marcmolla/juju,anastasiamac/juju,kat-co/juju,bz2/juju,reedobrien/juju,marcmolla/juju,anastasiamac/juju,dooferlad/juju,AdamIsrael/juju,mjs/juju,mjs/juju,perrito666/juju,alesstimec/juju,bogdanteleaga/juju,anastasiamac/juju,frankban/juju,bogdanteleaga/juju,bac/juju,alesstimec/juju,axw/juju,kat-co/juju,waigani/juju,davecheney/juju,bogdanteleaga/juju,perrito666/juju,perrito666/juju,makyo/juju,dooferlad/juju,ericsnowcurrently/juju,gabriel-samfira/juju,macgreagoir/juju,howbazaar/juju,dimitern/juju,mjs/juju,kat-co/juju,davecheney/juju,ericsnowcurrently/juju,mjs/juju,marcmolla/juju,bac/juju,mikemccracken/juju,frankban/juju,alesstimec/juju,frankban/juju,ericsnowcurrently/juju,anastasiamac/juju,ericsnowcurrently/juju,AdamIsrael/juju,anastasiamac/juju,macgreagoir/juju,marcmolla/juju,reedobrien/juju,dooferlad/juju,bz2/juju,mjs/juju,marcmolla/juju,dooferlad/juju,makyo/juju,ericsnowcurrently/juju,davecheney/juju