I'm always confused whether I should use log.Print or log.Println (and I've been coding small Golang apps for years). Today I spend some time digging into the difference and I had to do human word-by-word comparison to conclude that they are doing the exact same thing. https://golang.org/pkg/log/#Print and https://golang.org/pkg/log/#Println both state

X calls Output to print to the standard logger. Arguments are handled in the manner of fmt.Println.

Proposal to improve the documentation:

• Either change https://golang.org/pkg/log/#Println to "Println is an alias for Print"; or
• Modify both docs to something like "X calls Output to print to the standard logger. Arguments are handled in the manner of fmt.Println. This function does the same as Y."

Also, this entire issue is under the assumption that one of the methods shouldn't be deprecated (I assume they are both being used in a lot of places).