[PR #10463/d288555f backport][stable-11] doc style adjustments: modules p* (#10468)

doc style adjustments: modules p* (#10463)

* doc style adjustments: modules p*

* Update plugins/modules/pacemaker_resource.py

* Update plugins/modules/pagerduty_alert.py

* Update plugins/modules/pear.py

* Update plugins/modules/portage.py

* reformat

* adjustment from review

* Update plugins/modules/pkg5_publisher.py



---------


(cherry picked from commit d288555fd9)

Co-authored-by: Alexei Znamensky <103110+russoz@users.noreply.github.com>
Co-authored-by: Peter Oliver <github.com@mavit.org.uk>
This commit is contained in:
patchback[bot] 2025-07-27 12:13:47 +02:00 committed by GitHub
commit 6d8ae5d639
No known key found for this signature in database
GPG key ID: B5690EEEBB952194
30 changed files with 161 additions and 155 deletions

View file

@ -41,9 +41,9 @@ options:
state:
description:
- Whether to install (V(present) or V(installed), V(latest)), or remove (V(absent) or V(removed)) a package.
- V(present) and V(installed) will simply ensure that a desired package is installed.
- V(latest) will update the specified package if it is not of the latest available version.
- V(absent) and V(removed) will remove the specified package.
- V(present) and V(installed) simply ensure that a desired package is installed.
- V(latest) updates the specified package if it is not of the latest available version.
- V(absent) and V(removed) remove the specified package.
default: present
choices: [absent, installed, latest, present, removed]
type: str
@ -116,15 +116,14 @@ options:
reason_for:
description:
- Set the install reason for V(all) packages or only for V(new) packages.
- In case of O(state=latest) already installed packages which will be updated to a newer version are not counted as
V(new).
- In case of O(state=latest) already installed packages which are updated to a newer version are not counted as V(new).
default: new
choices: [all, new]
type: str
version_added: 5.4.0
notes:
- When used with a C(loop:) each package will be processed individually, it is much more efficient to pass the list directly
- When used with a C(loop:) each package is processed individually, it is much more efficient to pass the list directly
to the O(name) option.
- To use an AUR helper (O(executable) option), a few extra setup steps might be required beforehand. For example, a dedicated
build user with permissions to install packages could be necessary.
@ -142,7 +141,7 @@ packages:
returned: success and O(name) is specified or O(upgrade=true)
type: list
elements: str
sample: [package, other-package]
sample: ["package", "other-package"]
cache_updated:
description: