Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Clarify documentation of container removal flags #498

Merged
merged 2 commits into from
Jan 16, 2025

Conversation

vmsh0
Copy link
Contributor

@vmsh0 vmsh0 commented Jan 10, 2025

This addresses the issue described in detail in #496, by updating the docstring for the create() and run() operations of Container.

vmsh0 added 2 commits January 12, 2025 13:43
This commit removes the `remove` flag from the docstring entirely, as
the create() operation doesn't support the `remove` flag. It is
tolerated as an input because run() supports it and it internally calls
the start() operation relaying its own kwargs.

Signed-off-by: Riccardo Paolo Bestetti <pbl@bestov.io>
This commit specifies more in depth the semantics of the `remove` flag
of the run() operation:
- it describes its interaction with detach=True
- it clarifies that it is a client-initiated operation
- it specifies that a similar daemon-side flag also exists with the name
  of `auto_remove`

Signed-off-by: Riccardo Paolo Bestetti <pbl@bestov.io>
@vmsh0 vmsh0 force-pushed the container-removal-flags branch from 7edab3c to 7eaad53 Compare January 12, 2025 12:43
@rhatdan
Copy link
Member

rhatdan commented Jan 14, 2025

/approve
LGTM
Thanks @vmsh0
@jwhonce @umohnani8 @Luap99 PTAL

@inknos inknos self-requested a review January 15, 2025 14:45
@inknos
Copy link
Contributor

inknos commented Jan 16, 2025

/approve
/lgtm

Copy link
Contributor

openshift-ci bot commented Jan 16, 2025

[APPROVALNOTIFIER] This PR is APPROVED

This pull-request has been approved by: inknos, rhatdan, vmsh0

The full list of commands accepted by this bot can be found here.

The pull request process is described here

Needs approval from an approver in each of these files:

Approvers can indicate their approval by writing /approve in a comment
Approvers can cancel approval by writing /approve cancel in a comment

@openshift-merge-bot openshift-merge-bot bot merged commit c6db9c2 into containers:main Jan 16, 2025
16 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants