some godoc changes and add an example