37.11.1 Making Summaries

Here are the commands to create a summary for the current Rmail file. Once the Rmail file has a summary buffer, changes in the Rmail file (such as deleting or expunging messages, and getting new mail) automatically update the summary.

h

C-M-h

Summarize all messages (rmail-summary).

l labels <RET>

C-M-l labels <RET>

Summarize messages that have one or more of the specified labels (rmail-summary-by-labels).

C-M-r rcpts <RET>

Summarize messages that have one or more of the specified recipients (rmail-summary-by-recipients).

C-M-t topic <RET>

Summarize messages that have a match for the specified regexp topic in their subjects (rmail-summary-by-topic).

C-M-s regexp

Summarize messages whose headers and the subject line match the specified regular expression regexp (rmail-summary-by-regexp).

The h or C-M-h (rmail-summary) command fills the summary buffer for the current Rmail file with a summary of all the messages in the file. It then displays and selects the summary buffer in another window.

C-M-l labels <RET> (rmail-summary-by-labels) makes a partial summary mentioning only the messages that have one or more of the labels labels. labels should contain label names separated by commas.

C-M-r rcpts <RET> (rmail-summary-by-recipients) makes a partial summary mentioning only the messages that have one or more of the recipients rcpts. rcpts should contain mailing addresses separated by commas.

C-M-t topic <RET> (rmail-summary-by-topic) makes a partial summary mentioning only the messages whose subjects have a match for the regular expression topic.

C-M-s regexp <RET> (rmail-summary-by-regexp) makes a partial summary which mentions only the messages whose headers (including the date and the subject lines) match the regular expression regexp.

Note that there is only one summary buffer for any Rmail file; making one kind of summary discards any previously made summary.

The variable rmail-summary-window-size says how many lines to use for the summary window. The variable rmail-summary-line-count-flag controls whether the summary line for a message should include the line count of the message.