From: Lars Magne Ingebrigtsen <larsi@stories.gnus.org>
Date: Sun, 11 Sep 2011 16:28:08 +0000 (+0200)
Subject: Explain `gnus-group-list-limit'.
X-Git-Url: http://cgit.sxemacs.org/?p=gnus;a=commitdiff_plain;h=345595ad11af745d40c0b0d888de421d26253eb9;hp=7f7c2dbc8535976fca271bb8c60716cbe2ba2db2

Explain `gnus-group-list-limit'.
---

diff --git a/lisp/ChangeLog b/lisp/ChangeLog
index a98a33940..d84f9c31d 100644
--- a/lisp/ChangeLog
+++ b/lisp/ChangeLog
@@ -1,5 +1,8 @@
 2011-09-11  Lars Magne Ingebrigtsen  <larsi@gnus.org>
 
+	* gnus-group.el (gnus-group-list-limit): Explain what the command
+	does.
+
 	* gnus-sum.el (gnus-fetch-headers): Bump message level.
 
 2011-09-10  Lars Magne Ingebrigtsen  <larsi@gnus.org>
diff --git a/lisp/gnus-group.el b/lisp/gnus-group.el
index 36fb9e834..f6cf7248a 100644
--- a/lisp/gnus-group.el
+++ b/lisp/gnus-group.el
@@ -4636,7 +4636,12 @@ This command may read the active file."
     (gnus-group-list-plus args)))
 
 (defun gnus-group-list-limit (&optional args)
-  "List groups limited within the current selection."
+  "List groups limited within the current selection.
+If you've limited the groups, you can further limit the selection
+with this command.  If you've first limited to groups with
+dormant articles with `A ?', you can then further limit with
+`A / c', which will then limit to groups with cached articles, giving
+you the groups that have both dormant articles and cached articles."
   (interactive "P")
   (let ((gnus-group-list-option 'limit))
     (gnus-group-list-plus args)))
diff --git a/texi/ChangeLog b/texi/ChangeLog
index 49537a2e3..353cdb235 100644
--- a/texi/ChangeLog
+++ b/texi/ChangeLog
@@ -1,3 +1,7 @@
+2011-09-11  Lars Magne Ingebrigtsen  <larsi@gnus.org>
+
+	* gnus.texi (Listing Groups): Explain `gnus-group-list-limit'.
+
 2011-09-10  Lars Magne Ingebrigtsen  <larsi@gnus.org>
 
 	* gnus.texi: Remove mentions of `recent', which are now obsolete.
diff --git a/texi/gnus.texi b/texi/gnus.texi
index 7ce75ac63..f42ff6edc 100644
--- a/texi/gnus.texi
+++ b/texi/gnus.texi
@@ -3335,8 +3335,12 @@ List all groups with ticked articles (@code{gnus-group-list-ticked}).
 @item A /
 @kindex A / (Group)
 @findex gnus-group-list-limit
-List groups limited within the current selection
-(@code{gnus-group-list-limit}).
+Further limit groups within the current selection
+(@code{gnus-group-list-limit}).  If you've first limited to groups
+with dormant articles with @kbd{A ?}, you can then further limit with
+@kbd{A / c}, which will then limit to groups with cached articles,
+giving you the groups that have both dormant articles and cached
+articles.
 
 @item A f
 @kindex A f (Group)