Go to the previous, next section.

Newsgroup Commands

The Newsgroup buffer normally lists the newsgroups which you subscribe to and which contain unread articles. But not always--some of the things you can do display additional newsgroups. The commands available in this buffer are mostly concerned with subscribing and unsubscribing.

Browsing Newsgroups

Most of the newsgroup commands operate on the group described by the current line. To use them, you need to move the cursor to the group you want to act on. You can use ordinary Emacs motion commands, or these special commands:

Move point to the next newsgroup containing unread articles (gnus-group-next-unread-group).

Move point to the previous newsgroup containing unread articles (gnus-group-prev-unread-group).

Move point to the next newsgroup (gnus-group-next-group).

Move point to the previous newsgroup (gnus-group-prev-group).

j newsgroup RET
Move point to the newsgroup specified by name (gnus-group-jump-to-group).

Move point to the beginning of the buffer (beginning-of-buffer).

Move point to the end of the buffer (end-of-buffer).

Restrict visible newsgroups to the current region specified by point and the mark (gnus-group-restrict-groups).

The command j (gnus-group-jump-to-group) reads a newsgroup name interactively, and moves point to it. If there is no such newsgroup in the buffer, a line for the newsgroup is inserted at the beginning of the buffer.

The command r (gnus-group-restrict-groups) restricts visibility in the Newsgroup buffer to the region specified by point and mark. It is not quite the same as C-x n; it includes all of the line that the region starts in, and all of the line that the region ends in. Type C-x w (widen) to widen visibility to the whole buffer.

Selecting a Newsgroup

To start reading the articles in a newsgroup, move to that newsgroup in the Newsgroup buffer and type SPC (gnus-group-read-group) or = (gnus-group-select-group).

Select the newsgroup at point, and then select the first unread article automatically (gnus-group-read-group).

Select the newsgroup at point (gnus-group-select-group).

Normally, when you select a newsgroup, GNUS prepares to read only the unread articles (including saved articles). If the newsgroup has no unread articles and you select it anyway, GNUS prepares to read all the articles. You can force GNUS to include all the articles by giving a numeric argument to the commands SPC and = (gnus-group-read-group and gnus-group-select-group).

If the number of articles being selected is larger than the variable gnus-large-newsgroup, GNUS prompts for the number of articles to prepare. If your answer n is positive, GNUS prepares the last n articles. If n is negative, GNUS prepares the first -n articles. If you answer with the empty string, GNUS prepares all articles.

Maintaining Subscriptions

This section explains how to subscribe and unsubscribe, as well as other related activities. Most of the commands operate on the newsgroup listed on the current line.

Mark all newly arrived articles in the newsgroup as read, but don't alter articles explicitly marked as saved (gnus-group-catchup).

Mark all articles in the newsgroup as read (gnus-group-catchup-all).

Show only the newsgroups which you now subscribe to and which now contain unread and saved articles (gnus-group-list-groups).

Show all newsgroups available on your news server (gnus-group-list-all-groups).

Unsubscribe from (or subscribe to) the newsgroup (gnus-group-unsubscribe-current-group).

U newsgroup RET
Unsubscribe from (or subscribe to) the newsgroup named newsgroup (gnus-group-unsubscribe-group).

Kill the newsgroup line that point is in (gnus-group-kill-group).
Kill newsgroups in current region (excluding current line) (gnus-group-kill-region).

Yank the last newsgroup killed (gnus-group-yank-group). It is inserted just before the current line. Successive uses of C-y yank earlier kills, in last-in first-out order.
C-x C-t
Exchange current newsgroup and previous newsgroup. (gnus-group-transpose-groups).

M-x gnus-list-killed-groups
C-c C-l
Display a list of the newsgroups you have killed. This is so you can copy them back into the startup file.

Delete bogus newsgroups (gnus-group-check-bogus-groups).

Get newly arrived articles for all groups (gnus-group-get-new-news).

The commands c and C (gnus-group-catchup and gnus-group-catchup-all) mark all or most of the articles in a newsgroup as read. They are useful if you have been away from news reading for a while, and you don't want to slog through the backlog of old postings. These commands do not take account of the cross-reference information in the `Xref:' field, while the c command in Summary Mode does.

Only subscribed newsgroups containing unread and saved articles are usually displayed in the Newsgroup buffer. Type L (gnus-group-list-all-groups) to show all newsgroups which are currently active. Use l (gnus-group-list-groups) to go back to the usual contents--only groups which have news for you to read.

The command U (gnus-group-unsubscribe-group) reads a newsgroup name interactively, and toggles its subscription flag. This is the usual way to subscribe to new groups. (You can also type L and then use u on the groups you want to read.) You can also arrange to subscribe automatically to some or all newly created newsgroups using the options line in your startup file, `~/.newsrc'. See section The Startup File, for more information.

The command C-k (gnus-group-kill-group) kills a newsgroup from both the Newsgroup buffer and the raw startup file. If you change your mind, type C-y (gnus-group-yank-group); this yanks the last newsgroup killed with the C-k command.

The command C-c C-l (gnus-list-killed-groups) pops up a buffer listing the newsgroups you have killed. You can yank any of these newsgroups by moving point to the entry for the newsgroup you want, and then typing y or C-y (gnus-browse-killed-yank). So a convenient way to change the order of newsgroups is to kill some of them, then go to the list of killed groups and yank them in the order you want.

You are not limited to yanking only the groups that you killed in the current GNUS session. All the groups you have ever killed are remembered in the quick startup file, and you can restore them any time unless you lose the file.

A bogus newsgroup is one not in the list of active newsgroups in the active file. Type b (gnus-group-check-bogus-groups) to delete all the bogus newsgroups that you subscribe to. Bogus newsgroups that you have unsubscribed or killed are deleted also.

The g command rereads the active file to get updated lists of articles available to be read.

Exiting GNUS

Suspend the current GNUS session (gnus-group-suspend).

Update the startup file `.newsrc', and then exit GNUS (gnus-group-exit).

Exit GNUS without updating the startup file `.newsrc' (gnus-group-quit).

Suspending GNUS with z (gnus-group-suspend) kills all GNUS buffers except for the Newsgroup buffer. To resume again, switch to the Newsgroup buffer and type g (gnus-group-get-new-news) to get newly arrived articles. It is a good idea to update the startup file (see section The Startup File) before suspending GNUS.

If you want to forget what you read this GNUS session, exit GNUS by the command Q (gnus-group-quit). Otherwise, exit by the command q (gnus-group-exit) to update the startup file.

The hook gnus-exit-gnus-hook is called when exiting GNUS, and the hook gnus-suspend-gnus-hook is called when suspending GNUS.

Miscellaneous Commands

Other miscellaneous Group mode commands are described here.

Compose a new article (gnus-group-post-news). See section Posting Articles, for more information.

Edit a local kill file (gnus-group-edit-local-kill). See section Kill File, for more information.

Edit your global kill file (gnus-group-edit-global-kill). See section Kill File, for more information.

Go to the previous, next section.