> > And btw, programs don't write man pages... yet. > > Are you familiar with the conventions that power godoc?
i think what's being said here is that programs don't write the content. without looking at godoc, i'm pretty sure that intended usage and the context are going to be written by a human, even if the formatting is done by a program. - erik