* src/augeas.h: improve some comments
* src/augeas.h: improve some comments

jjlin/augeas,pevalme/augeas,hercules-team/augeas-do-not-use,camptocamp/augeas,lutter/augeas,jjlin/augeas,MikaelSmith/augeas,hercules-team/augeas-do-not-use,kumy/augeas,camptocamp/augeas,lutter/augeas,jjlin/augeas,dafugg/augeas,domcleal/augeas,dafugg/augeas,kunkku/augeas,ptoscano/augeas,hercules-team/augeas,raphink/augeas,GeoffWilliams/augeas,camptocamp/augeas,mchf/augeas,ptoscano/augeas,mlichvar/augeas,dafugg/augeas,mlichvar/augeas,manandbytes/augeas,bkearney/augeas,jtopjian/augeas,kumy/augeas,kunkku/augeas,mchf/augeas,kumy/augeas,camptocamp/augeas,kumy/augeas,jasperla/augeas,bkearney/augeas,bkearney/augeas,jasperla/augeas,domcleal/augeas,domcleal/augeas,kunkku/augeas,MikaelSmith/augeas,GeoffWilliams/augeas,raphink/augeas,bkearney/augeas,pevalme/augeas,manandbytes/augeas,pevalme/augeas,lutter/augeas,hercules-team/augeas-do-not-use,jtopjian/augeas,hercules-team/augeas,mlichvar/augeas,ptoscano/augeas