You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
godoc could automatically flag structs containing sync values. This would prevent
situations like issue #8794 from arising.
Open questions:
1. Worth it?
2. Flag all structs with sync value fields, or only structs containing unexported sync
value fields?
3. What does the godoc output look like (command line + http)?
My instinct is:
1. Yes.
2. All.
3. Append a paragraph to the end of the type's doc saying (roughly) "T contains a
sync value and should not be copied.", to be rendered as appropriate for the medium.
Input requested.
The text was updated successfully, but these errors were encountered:
Exported data structures containing locks should be adequately documented by the author
of the package.
I am not against having godoc mark structs with locks (doing it right requires full type
info); but the question arises, where do we stop? For instance, what about structs
containing shared data structures? File descriptors? Fundamentally they have the same
problem.
The text was updated successfully, but these errors were encountered: