Please add "Examples" documentation :)

[daniel-santos]

I'm new to Go and having to build this software in a hurry, so the copy/paste helps a lot! As I will need to do the same for my code, I've found the instructions for adding such examples to the godocs.

Also, THANK YOU for the trick to snag the file descriptor in your code! I was really upset when I didn't see a way to get it from the damn Go net library and thought I was going to just have to (further) hack the Go sources for my project. The Go language provides for some interesting idioms -- I'm still learning.