Explain `gnus-group-list-limit'.

diff --git a/lisp/ChangeLog b/lisp/ChangeLog
index a98a339..d84f9c3 100644 (file)
--- 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 36fb9e8..f6cf724 100644 (file)
--- 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 49537a2..353cdb2 100644 (file)
--- 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 7ce75ac..f42ff6e 100644 (file)
--- 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)