lib: Expand various documentation comments
lib: Expand various documentation comments

There are now no documentation warnings. While the documentation is not
as expansive as it could be, it does at least have complete coverage
now.

pwithnall/walbottle