runtime: Cleanup.Stop does not document whether it's idempotent

Go version

go version go1.26.8 linux/amd64

Output of `go env` in your module/workspace:

Not relevant, but happy to provide.

What did you do?

The documentation of runtime/Cleanup.Stop does not specify whether it is fine to call it multiple times on the same finaliser.

What did you see happen?

I looked at the source. It looks to me like it is fine, but I'm not quite sure.

What did you expect to see?

A clear statement that says that calling Stop multiple times is equivalent to calling it once.

Related Issues

runtime: document explicitly that finalizers and cleanups can hold up other finalizers and cleanups #72950 (closed)

_{(Emoji vote if this was helpful or unhelpful; more detailed feedback welcome in this discussion.)}

Change https://go.dev/cl/840105 mentions this issue: runtime: document that Cleanup.Stop is idempotent

cc @golang/runtime

Navigation Menu

Repository navigation

runtime: Cleanup.Stop does not document whether it's idempotent #81789

Go version

Output of `go env` in your module/workspace:

What did you do?

What did you see happen?

What did you expect to see?

Metadata

Assignees

Labels

Type

Projects

Milestone

Relationships

Development

runtime: Cleanup.Stop does not document whether it's idempotent #81789

Description

Go version

Output of go env in your module/workspace:

What did you do?

What did you see happen?

What did you expect to see?

Activity

gabyhelp commented on Sep 27, 2026

gopherbot commented on Sep 28, 2026

prattmic commented on Sep 29, 2026

Metadata

Metadata

Assignees

Labels

Type

Projects

Milestone

Relationships

Development

Issue actions

Output of `go env` in your module/workspace: