summaryrefslogtreecommitdiffstats
path: root/ansible_collections/community/general/plugins/modules/apk.py
diff options
context:
space:
mode:
Diffstat (limited to 'ansible_collections/community/general/plugins/modules/apk.py')
-rw-r--r--ansible_collections/community/general/plugins/modules/apk.py18
1 files changed, 10 insertions, 8 deletions
diff --git a/ansible_collections/community/general/plugins/modules/apk.py b/ansible_collections/community/general/plugins/modules/apk.py
index e56b2165d..a6b058b93 100644
--- a/ansible_collections/community/general/plugins/modules/apk.py
+++ b/ansible_collections/community/general/plugins/modules/apk.py
@@ -17,7 +17,7 @@ DOCUMENTATION = '''
module: apk
short_description: Manages apk packages
description:
- - Manages I(apk) packages for Alpine Linux.
+ - Manages C(apk) packages for Alpine Linux.
author: "Kevin Brebanov (@kbrebanov)"
extends_documentation_fragment:
- community.general.attributes
@@ -35,7 +35,9 @@ options:
default: false
name:
description:
- - A package name, like C(foo), or multiple packages, like C(foo, bar).
+ - A package name, like V(foo), or multiple packages, like V(foo,bar).
+ - Do not include additional whitespace when specifying multiple packages as a string.
+ Prefer YAML lists over comma-separating multiple package names.
type: list
elements: str
no_cache:
@@ -53,15 +55,15 @@ options:
state:
description:
- Indicates the desired package(s) state.
- - C(present) ensures the package(s) is/are present. C(installed) can be used as an alias.
- - C(absent) ensures the package(s) is/are absent. C(removed) can be used as an alias.
- - C(latest) ensures the package(s) is/are present and the latest version(s).
+ - V(present) ensures the package(s) is/are present. V(installed) can be used as an alias.
+ - V(absent) ensures the package(s) is/are absent. V(removed) can be used as an alias.
+ - V(latest) ensures the package(s) is/are present and the latest version(s).
default: present
choices: [ "present", "absent", "latest", "installed", "removed" ]
type: str
update_cache:
description:
- - Update repository indexes. Can be run with other steps or on it's own.
+ - Update repository indexes. Can be run with other steps or on its own.
type: bool
default: false
upgrade:
@@ -76,8 +78,8 @@ options:
default: /etc/apk/world
version_added: 5.4.0
notes:
- - 'I(name) and I(upgrade) are mutually exclusive.'
- - When used with a C(loop:) each package will be processed individually, it is much more efficient to pass the list directly to the I(name) option.
+ - 'O(name) and O(upgrade) are mutually exclusive.'
+ - When used with a C(loop:) each package will be processed individually, it is much more efficient to pass the list directly to the O(name) option.
'''
EXAMPLES = '''