gnus: Gnus Utility Functions
11.7.1 Gnus Utility Functions
-----------------------------
When writing small functions to be run from hooks (and stuff), it’s
vital to have access to the Gnus internal functions and variables.
Below is a list of the most common ones.
‘gnus-newsgroup-name’
This variable holds the name of the current newsgroup.
‘gnus-find-method-for-group’
A function that returns the select method for GROUP.
‘gnus-group-real-name’
Takes a full (prefixed) Gnus group name, and returns the unprefixed
name.
‘gnus-group-prefixed-name’
Takes an unprefixed group name and a select method, and returns the
full (prefixed) Gnus group name.
‘gnus-get-info’
Returns the group info list for GROUP (Group Info).
‘gnus-group-unread’
The number of unread articles in GROUP, or ‘t’ if that is unknown.
‘gnus-active’
The active entry (i.e., a cons cell containing the lowest and
highest article numbers) for GROUP.
‘gnus-set-active’
Set the active entry for GROUP.
‘gnus-add-current-to-buffer-list’
Adds the current buffer to the list of buffers to be killed on Gnus
exit.
‘gnus-continuum-version’
Takes a Gnus version string as a parameter and returns a floating
point number. Earlier versions will always get a lower number than
later versions.
‘gnus-group-read-only-p’
Says whether GROUP is read-only or not.
‘gnus-news-group-p’
Says whether GROUP came from a news back end.
‘gnus-ephemeral-group-p’
Says whether GROUP is ephemeral or not.
‘gnus-server-to-method’
Returns the select method corresponding to SERVER.
‘gnus-server-equal’
Says whether two virtual servers are essentially equal. For
instance, two virtual servers may have server parameters in
different order, but this function will consider them equal.
‘gnus-group-native-p’
Says whether GROUP is native or not.
‘gnus-group-secondary-p’
Says whether GROUP is secondary or not.
‘gnus-group-foreign-p’
Says whether GROUP is foreign or not.
‘gnus-group-find-parameter’
Returns the parameter list of GROUP (Group Parameters). If
given a second parameter, returns the value of that parameter for
GROUP.
‘gnus-group-set-parameter’
Takes three parameters; GROUP, PARAMETER and VALUE.
‘gnus-narrow-to-body’
Narrows the current buffer to the body of the article.
‘gnus-check-backend-function’
Takes two parameters, FUNCTION and GROUP. If the back end GROUP
comes from supports FUNCTION, return non-‘nil’.
(gnus-check-backend-function "request-scan" "nnml:misc")
⇒ t
‘gnus-read-method’
Prompts the user for a select method.