summaryrefslogtreecommitdiffstats
path: root/ansible_collections/community/general/plugins/modules/pkgng.py
diff options
context:
space:
mode:
Diffstat (limited to 'ansible_collections/community/general/plugins/modules/pkgng.py')
-rw-r--r--ansible_collections/community/general/plugins/modules/pkgng.py23
1 files changed, 8 insertions, 15 deletions
diff --git a/ansible_collections/community/general/plugins/modules/pkgng.py b/ansible_collections/community/general/plugins/modules/pkgng.py
index b9d4422c0..88c9b8e3b 100644
--- a/ansible_collections/community/general/plugins/modules/pkgng.py
+++ b/ansible_collections/community/general/plugins/modules/pkgng.py
@@ -31,13 +31,7 @@ options:
name:
description:
- Name or list of names of packages to install/remove.
- - "With I(name=*), I(state=latest) will operate, but I(state=present) and I(state=absent) will be noops."
- - >
- Warning: In Ansible 2.9 and earlier this module had a misfeature
- where I(name=*) with I(state=latest) or I(state=present) would
- install every package from every package repository, filling up
- the machines disk. Avoid using them unless you are certain that
- your role will only be used with newer versions.
+ - "With O(name=*), O(state=latest) will operate, but O(state=present) and O(state=absent) will be noops."
required: true
aliases: [pkg]
type: list
@@ -45,7 +39,6 @@ options:
state:
description:
- State of the package.
- - 'Note: C(latest) added in 2.7.'
choices: [ 'present', 'latest', 'absent' ]
required: false
default: present
@@ -59,8 +52,8 @@ options:
annotation:
description:
- A list of keyvalue-pairs of the form
- C(<+/-/:><key>[=<value>]). A C(+) denotes adding an annotation, a
- C(-) denotes removing an annotation, and C(:) denotes modifying an
+ C(<+/-/:><key>[=<value>]). A V(+) denotes adding an annotation, a
+ V(-) denotes removing an annotation, and V(:) denotes modifying an
annotation.
If setting or modifying annotations, a value must be provided.
required: false
@@ -79,19 +72,19 @@ options:
description:
- For pkgng versions 1.5 and later, pkg will install all packages
within the specified root directory.
- - Can not be used together with I(chroot) or I(jail) options.
+ - Can not be used together with O(chroot) or O(jail) options.
required: false
type: path
chroot:
description:
- Pkg will chroot in the specified environment.
- - Can not be used together with I(rootdir) or I(jail) options.
+ - Can not be used together with O(rootdir) or O(jail) options.
required: false
type: path
jail:
description:
- Pkg will execute in the given jail name or id.
- - Can not be used together with I(chroot) or I(rootdir) options.
+ - Can not be used together with O(chroot) or O(rootdir) options.
type: str
autoremove:
description:
@@ -102,7 +95,7 @@ options:
ignore_osver:
description:
- Ignore FreeBSD OS version check, useful on -STABLE and -CURRENT branches.
- - Defines the C(IGNORE_OSVERSION) environment variable.
+ - Defines the E(IGNORE_OSVERSION) environment variable.
required: false
type: bool
default: false
@@ -111,7 +104,7 @@ author: "bleader (@bleader)"
notes:
- When using pkgsite, be careful that already in cache packages won't be downloaded again.
- 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.
+ it is much more efficient to pass the list directly to the O(name) option.
'''
EXAMPLES = '''