3.27 Various Summary Stuff

gnus-summary-display-while-building

If non-nil, show and update the summary buffer as it’s being built. If t, update the buffer after every line is inserted. If the value is an integer, n, update the display every n lines. The default is nil.

gnus-summary-display-arrow

If non-nil, display an arrow in the fringe to indicate the current article.

gnus-summary-mode-hook

This hook is called when creating a summary mode buffer.

gnus-summary-generate-hook

This is called as the last thing before doing the threading and the generation of the summary buffer. It’s quite convenient for customizing the threading variables based on what data the newsgroup has. This hook is called from the summary buffer after most summary buffer variables have been set.

gnus-summary-prepare-hook

It is called after the summary buffer has been generated. You might use it to, for instance, highlight lines or modify the look of the buffer in some other ungodly manner. I don’t care.

gnus-summary-prepared-hook

A hook called as the very last thing after the summary buffer has been generated.

gnus-summary-ignore-duplicates

When Gnus discovers two articles that have the same Message-ID, it has to do something drastic. No articles are allowed to have the same Message-ID, but this may happen when reading mail from some sources. Gnus allows you to customize what happens with this variable. If it is nil (which is the default), Gnus will rename the Message-ID (for display purposes only) and display the article as any other article. If this variable is t, it won’t display the article—it’ll be as if it never existed.

gnus-alter-articles-to-read-function

This function, which takes two parameters (the group name and the list of articles to be selected), is called to allow the user to alter the list of articles to be selected.

For instance, the following function adds the list of cached articles to the list in one particular group:

(defun my-add-cached-articles (group articles) (if (string= group "some.group") (append gnus-newsgroup-cached articles) articles))

gnus-newsgroup-variables

A list of newsgroup (summary buffer) local variables, or cons of variables and their default expressions to be evalled (when the default values are not nil), that should be made global while the summary buffer is active.

Note: The default expressions will be evaluated (using function eval) before assignment to the local variable rather than just assigned to it. If the default expression is the symbol global, that symbol will not be evaluated but the global value of the local variable will be used instead.

These variables can be used to set variables in the group parameters while still allowing them to affect operations done in other buffers. For example:

(setq gnus-newsgroup-variables '(message-use-followup-to (gnus-visible-headers . "^From:\\|^Newsgroups:\\|^Subject:\\|^Date:\\|^To:")))

Also see section Group Parameters.

3.27.1 Summary Group Information

H d

Give a brief description of the current group (gnus-summary-describe-group). If given a prefix, force rereading the description from the server.

H h

Give an extremely brief description of the most important summary keystrokes (gnus-summary-describe-briefly).

H i

Go to the Gnus info node (gnus-info-find-node).

3.27.2 Searching for Articles

M-s

Search through all subsequent (raw) articles for a regexp (gnus-summary-search-article-forward).

M-r

Search through all previous (raw) articles for a regexp (gnus-summary-search-article-backward).

M-S

Repeat the previous search forwards (gnus-summary-repeat-search-article-forward).

M-R

Repeat the previous search backwards (gnus-summary-repeat-search-article-backward).

&

This command will prompt you for a header, a regular expression to match on this field, and a command to be executed if the match is made (gnus-summary-execute-command). If the header is an empty string, the match is done on the entire article. If given a prefix, search backward instead.

For instance, & RET some.*string RET # will put the process mark on all articles that have heads or bodies that match ‘some.*string’.

M-&

Perform any operation on all articles that have been marked with the process mark (gnus-summary-universal-argument).

3.27.3 Summary Generation Commands

Y g

Regenerate the current summary buffer (gnus-summary-prepare).

Y c

Pull all cached articles (for the current group) into the summary buffer (gnus-summary-insert-cached-articles).

Y d

Pull all dormant articles (for the current group) into the summary buffer (gnus-summary-insert-dormant-articles).

Y t

Pull all ticked articles (for the current group) into the summary buffer (gnus-summary-insert-ticked-articles).

3.27.4 Really Various Summary Commands

A D

C-d

If the current article is a collection of other articles (for instance, a digest), you might use this command to enter a group based on the that article (gnus-summary-enter-digest-group). Gnus will try to guess what article type is currently displayed unless you give a prefix to this command, which forces a “digest” interpretation. Basically, whenever you see a message that is a collection of other messages of some format, you C-d and read these messages in a more convenient fashion.

The variable gnus-auto-select-on-ephemeral-exit controls what article should be selected after exiting a digest group. Valid values include:

next

Select the next article.

next-unread

Select the next unread article.

next-noselect

Move the cursor to the next article. This is the default.

next-unread-noselect

Move the cursor to the next unread article.

If it has any other value or there is no next (unread) article, the article selected before entering to the digest group will appear.

C-M-d

This command is very similar to the one above, but lets you gather several documents into one biiig group (gnus-summary-read-document). It does this by opening several nndoc groups for each document, and then opening an nnvirtual group on top of these nndoc groups. This command understands the process/prefix convention (see section Process/Prefix).

C-t

Toggle truncation of summary lines (gnus-summary-toggle-truncation). This will probably confuse the line centering function in the summary buffer, so it’s not a good idea to have truncation switched off while reading articles.

=

Expand the summary buffer window (gnus-summary-expand-window). If given a prefix, force an article window configuration.

C-M-e

Edit the group parameters (see section Group Parameters) of the current group (gnus-summary-edit-parameters).

C-M-a

Customize the group parameters (see section Group Parameters) of the current group (gnus-summary-customize-parameters).

This document was generated on January 25, 2015 using texi2html 1.82.