I think this comment applies to nearly all technology today. If it doesn't have a `man` page, good `-h` notes, or a manual released with each version, I basically assume I'm going to have a hellish time Googling around for anything. This doesn't really solve the issue though, since a lot of manuals written are outdated by sources changes that were rushed and forgotten.
We need to come to terms with the fact that the way we as programmers acquire information about our tools is in a dire need of help. Search indices are just not valid references for us. We should never have learned this method of learning in the first place, but it was easy and painless in the beginning.
People need to just slow down a bit and become more methodical one thinks.