Refine docs even more

This commit is contained in:
fancsali 2021-07-05 15:28:05 +02:00
parent b726697e07
commit 521241d741

View file

@ -3,12 +3,12 @@ cdist-type__apt_pin(7)
NAME NAME
---- ----
cdist-type__apt_pin - TODO cdist-type__apt_pin - Manage apt pinning rules
DESCRIPTION DESCRIPTION
----------- -----------
This space intentionally left blank. Adds/removes/edits rules to pin some packages to a specific distribution. Useful if using multiple debian repositories at the same time. (Useful, if one wants to use a few specific packages from backports or perhaps Debain testing... or even sid.)
REQUIRED PARAMETERS REQUIRED PARAMETERS
@ -20,7 +20,7 @@ distribution
OPTIONAL PARAMETERS OPTIONAL PARAMETERS
------------------- -------------------
package package
Package name or glob/RE expression to match multiple packages. If not specified `__object_id` is used. Package name, glob or regular expression to match (multiple) packages. If not specified `__object_id` is used.
priority priority
The priority value to assign to matching packages. Deafults to 500. (To match the default target distro's priority) The priority value to assign to matching packages. Deafults to 500. (To match the default target distro's priority)
@ -28,7 +28,6 @@ priority
state state
Will be passed to underlying `__file` type; see there for valid values and defaults. Will be passed to underlying `__file` type; see there for valid values and defaults.
None.
BOOLEAN PARAMETERS BOOLEAN PARAMETERS
@ -41,8 +40,8 @@ EXAMPLES
.. code-block:: sh .. code-block:: sh
# Add the bullseye repo to buster, but do not install any pacakges by default # Add the bullseye repo to buster, but do not install any packages by default,
# only if explicitely asked for # only if explicitely asked for (-1 means "never" for apt)
__apt_pin bullseye-default \ __apt_pin bullseye-default \
--package "*" \ --package "*" \
--distribution bullseye \ --distribution bullseye \
@ -52,19 +51,19 @@ EXAMPLES
--uri http://deb.debian.org/debian/ \ --uri http://deb.debian.org/debian/ \
--distribution bullseye \ --distribution bullseye \
--component main --component main
# TODO
__apt_pin
__apt_pin foo --package "foo foo-*" --distribution bullseye __apt_pin foo --package "foo foo-*" --distribution bullseye
__foo # Installs the `foo` package internally __foo # Assuming, this installs the `foo` package internally
__package foo-plugin-extras __package foo-plugin-extras # Assuming we also need some extra stuff
SEE ALSO SEE ALSO
-------- --------
:strong:`apt_preferences`\ (7) :strong:`apt_preferences`\ (5)
:strong:`cdist-type__apt_source`\ (7)
:strong:`cdist-type__apt_backports`\ (7)
:strong:`cdist-type__file`\ (7) :strong:`cdist-type__file`\ (7)
AUTHORS AUTHORS