document() and update example reference output

document() and update example reference output #827