• Update documentation: Differentiateunless-stopped fromalways - containers stopped by the user before a reboot will not restart.
• Addshould-start-on-boot filter: Identify containers that require a restart after a system reboot.
• Update command documentation: Addrestart-policy andlabel! filters to the documentation for container commands (rm, ps, start, stop, pause, unpause, restart).
• Addrestart-policy andshoud-start-on-boot to completions.
• Update service: Updatepodman-restart.service to use theneeds-restart=true filter.
• Preserve state: Preserve theStoppedByUser state across reboots.
• Update API: Add aShouldStartOnBoot() method to the Container API.
• Update documentation: Add descriptions for theshould-start-on-boot filter.

Fixes:https://issues.redhat.com/browse/RHEL-129405
Fixes:#20418

Checklist

Ensure you have completed the following checklist for your pull request to be reviewed:

• Certify you wrote the patch or otherwise have the right to pass it on as an open-source patch by signing all
  commits. (git commit -s). (If needed, usegit commit -s --amend). The author email must match
  the sign-off email address. SeeCONTRIBUTING.md
  for more information.
• Referenced issues usingFixes: #00000 in commit message (if applicable)
• Tests have been added/updated (or no tests are needed)
• Documentation has been updated (or no documentation changes are needed)
• All commits passmake validatepr (format/lint checks)
• Release note entered in the section below (orNone if no user-facing changes)

Does this PR introduce a user-facing change?

The `unless-stopped` restart policy now correctly matches Docker behavior by preserving the user-stopped state across reboots, and includes a new `should-start-on-boot` filter.