Clarify a few doc comments.
Clarify a few doc comments.

mjs/juju,wwitzel3/juju,alesstimec/juju,axw/juju,bogdanteleaga/juju,marcmolla/juju,perrito666/juju,bz2/juju,mikemccracken/juju,davecheney/juju,marcmolla/juju,wwitzel3/juju,alesstimec/juju,kat-co/juju,davecheney/juju,reedobrien/juju,kat-co/juju,ericsnowcurrently/juju,gabriel-samfira/juju,anastasiamac/juju,sinzui/juju,voidspace/juju,ericsnowcurrently/juju,dooferlad/juju,AdamIsrael/juju,frankban/juju,cmars/juju,marcmolla/juju,marcoceppi/juju,cloud-green/juju,frankban/juju,mhilton/juju-juju,macgreagoir/juju,frankban/juju,bac/juju,frankban/juju-tmp,davecheney/juju,ericsnowcurrently/juju,axw/juju,macgreagoir/juju,bac/juju,perrito666/juju,thomnico/juju,voidspace/juju,ericsnowcurrently/juju,kat-co/juju,frankban/juju-tmp,anastasiamac/juju,cherylj/juju,mjs/juju,thomnico/juju,kat-co/juju,tsakas/juju,tasdomas/juju,dooferlad/juju,mikemccracken/juju,mikemccracken/juju,cmars/juju,tsakas/juju,macgreagoir/juju,makyo/juju,howbazaar/juju,mhilton/juju-juju,sinzui/juju,axw/juju,perrito666/juju,bz2/juju,Altoros/juju-vmware,dimitern/juju,tych0/juju,mhilton/juju,tasdomas/juju,reedobrien/juju,bz2/juju,gabriel-samfira/juju,thomnico/juju,tasdomas/juju,voidspace/juju,Altoros/juju-cloudsigma,sinzui/juju,cmars/juju,tych0/juju,fwereade/juju,dimitern/juju,reedobrien/juju,howbazaar/juju,reedobrien/juju,axw/juju,Altoros/juju-vmware,mhilton/juju,dooferlad/juju,anastasiamac/juju,macgreagoir/juju,frankban/juju-tmp,waigani/juju,Altoros/juju-cloudsigma,marcoceppi/juju,fwereade/juju,howbazaar/juju,mhilton/juju,cherylj/juju,makyo/juju,perrito666/juju,alesstimec/juju,marcoceppi/juju,wwitzel3/juju,mhilton/juju,davecheney/juju,bz2/juju,frankban/juju,kat-co/juju,makyo/juju,tsakas/juju,frankban/juju-tmp,makyo/juju,bogdanteleaga/juju,waigani/juju,bogdanteleaga/juju,cloud-green/juju,fwereade/juju,wwitzel3/juju,waigani/juju,perrito666/juju,mhilton/juju-juju,cmars/juju,cherylj/juju,dooferlad/juju,Altoros/juju-vmware,dooferlad/juju,Altoros/juju-cloudsigma,mjs/juju,anastasiamac/juju,bz2/juju,macgreagoir/juju,dimitern/juju,mjs/juju,mjs/juju,alesstimec/juju,gabriel-samfira/juju,howbazaar/juju,AdamIsrael/juju,bac/juju,ericsnowcurrently/juju,marcoceppi/juju,Altoros/juju-vmware,bac/juju,bac/juju,gabriel-samfira/juju,mikemccracken/juju,mikemccracken/juju,tych0/juju,thomnico/juju,marcmolla/juju,mjs/juju,frankban/juju,tych0/juju,cherylj/juju,reedobrien/juju,AdamIsrael/juju,mjs/juju,tsakas/juju,sinzui/juju,voidspace/juju,cloud-green/juju,cloud-green/juju,dimitern/juju,tasdomas/juju,waigani/juju,Altoros/juju-cloudsigma,anastasiamac/juju,axw/juju,marcmolla/juju,mhilton/juju-juju,howbazaar/juju,fwereade/juju,gabriel-samfira/juju,alesstimec/juju,AdamIsrael/juju,bogdanteleaga/juju,dimitern/juju