From c1ddea497f0634acc393f15f554553403fbc5943 Mon Sep 17 00:00:00 2001
From: Richard Hughes <richard@hughsie.com>
Date: Thu, 9 Dec 2010 16:21:10 +0000
Subject: [PATCH] Add 'repo:foo' to the specification to be able to return all
 packages in a certain repository and to list them as categories

---
 src/org.freedesktop.PackageKit.Transaction.xml | 15 +++++++++++++++
 1 file changed, 15 insertions(+)

diff --git a/src/org.freedesktop.PackageKit.Transaction.xml b/src/org.freedesktop.PackageKit.Transaction.xml
index b879efa32..da08713c1 100644
--- a/src/org.freedesktop.PackageKit.Transaction.xml
+++ b/src/org.freedesktop.PackageKit.Transaction.xml
@@ -283,6 +283,13 @@
             This method typically emits
             <doc:tt>Categories</doc:tt> and <doc:tt>Error</doc:tt>.
           </doc:para>
+          <doc:para>
+            Note: Categories can be returned that represent groups of
+            packages in a specific repository.
+            These will have a category prefix of <doc:tt>repo:</doc:tt>
+            which should be understood by <doc:tt>SearchGroups</doc:tt>
+            if this feature is used.
+          </doc:para>
       </doc:doc>
     </method>
 
@@ -1205,6 +1212,14 @@
               This is still supported, and backends should continue to support
               category searches like <doc:tt>@web-development</doc:tt>.
             </doc:para>
+            <doc:para>
+              If the values strings are prefixed with <doc:tt>repo:</doc:tt> then
+              the request is treated as a 'repository search', for example:
+              <doc:tt>repo:fedora-debuginfo</doc:tt>.
+              In this instance all packages that were either installed
+              from, or can be installed from the <doc:tt>fedora-debuginfo</doc:tt>
+              source would be returned.
+            </doc:para>
           </doc:summary>
         </doc:doc>
       </arg>