diff options
| author | Julian Andres Klode <jak@debian.org> | 2019-12-02 14:49:07 +0000 |
|---|---|---|
| committer | Julian Andres Klode <jak@debian.org> | 2019-12-02 14:49:07 +0000 |
| commit | b59be3af284d13988182d99fcd2ab5948a0f6a83 (patch) | |
| tree | 2d74708f5355c069363cf4a70df78b96793450ce /doc | |
| parent | 203ed6e094e0e5a332ddae9e4f08df5694b84ba9 (diff) | |
| parent | a93b4443c18ee211691f7b336b161fea7d1df699 (diff) | |
Merge branch 'pu/patterns-phase2' into 'master'
Pu/patterns phase2
See merge request apt-team/apt!85
Diffstat (limited to 'doc')
| -rw-r--r-- | doc/apt-patterns.7.xml | 46 |
1 files changed, 46 insertions, 0 deletions
diff --git a/doc/apt-patterns.7.xml b/doc/apt-patterns.7.xml index efd4293dc..219d2c209 100644 --- a/doc/apt-patterns.7.xml +++ b/doc/apt-patterns.7.xml @@ -61,6 +61,23 @@ </variablelist> </refsect1> <refsect1> + <title>Narrowing patterns</title> + <para> + </para> + <variablelist> + <varlistentry><term><code>?all-versions(PATTERN)</code></term> + <listitem><para>Selects packages where all versions match PATTERN. When matching versions instead, same as PATTERN.</para></listitem> + </varlistentry> + <varlistentry><term><code>?any-version(PATTERN)</code></term> + <listitem><para>Selects any version where the pattern matches on the version.</para> + <para>For example, while <code>?and(?version(1),?version(2))</code> matches a package which has one version containing 1 and one version containing 2, <code>?any-version(?and(?version(1),?version(2)))</code> restricts the <code>?and</code> to act on the same version.</para></listitem> + </varlistentry> + <varlistentry><term><code>?narrow(PATTERN...)</code></term> + <listitem><para>Selects any version matching all PATTERNs, short for<code>?any-version(?and(PATTERN...))</code>.</para></listitem> + </varlistentry> + </variablelist> + </refsect1> + <refsect1> <title>Package patterns</title> <para> These patterns select specific packages. @@ -106,6 +123,32 @@ </varlistentry> </variablelist> </refsect1> + <refsect1> + <title>Version patterns</title> + <para> + These patterns select specific versions of a package. + </para> + <variablelist> + <varlistentry><term><code>?archive(REGEX)</code></term> + <listitem><para>Selects versions that come from the archive that matches the specified regular expression. Archive, here, means the values after <code>a=</code> in <command>apt-cache policy</command>.</para></listitem> + </varlistentry> + <varlistentry><term><code>?origin(REGEX)</code></term> + <listitem><para>Selects versions that come from the origin that matches the specified regular expression. Origin, here, means the values after <code>o=</code> in <command>apt-cache policy</command>.</para></listitem> + </varlistentry> + <varlistentry><term><code>?section(REGEX)</code></term> + <listitem><para>Selects versions where the section matches the specified regular expression.</para></listitem> + </varlistentry> + <varlistentry><term><code>?source-package(REGEX)</code></term> + <listitem><para>Selects versions where the source package name matches the specified regular expression.</para></listitem> + </varlistentry> + <varlistentry><term><code>?source-version(REGEX)</code></term> + <listitem><para>Selects versions where the source package version matches the specified regular expression.</para></listitem> + </varlistentry> + <varlistentry><term><code>?version(REGEX)</code></term> + <listitem><para>Selects versions where the version string matching the specified regular expression.</para></listitem> + </varlistentry> + </variablelist> + </refsect1> <refsect1><title>Examples</title> @@ -147,6 +190,9 @@ <listitem> <para>A trailing comma is allowed in argument lists</para> </listitem> + <listitem> + <para>?narrow accepts infinite arguments</para> + </listitem> </itemizedlist> </refsect1> |