gnus: Foreign Groups

 
 2.9 Foreign Groups
 ==================
 
 If you recall how to subscribe to servers (SeeFinding the News) you
 will remember that ‘gnus-secondary-select-methods’ and
 ‘gnus-select-method’ let you write a definition in Emacs Lisp of what
 servers you want to see when you start up.  The alternate approach is to
 use foreign servers and groups.  “Foreign” here means they are not
 coming from the select methods.  All foreign server configuration and
 subscriptions are stored only in the ‘~/.newsrc.eld’ file.
 
    Below are some group mode commands for making and editing general
 foreign groups, as well as commands to ease the creation of a few
 special-purpose groups.  All these commands insert the newly created
 groups under point—‘gnus-subscribe-newsgroup-method’ is not consulted.
 
    Changes from the group editing commands are stored in ‘~/.newsrc.eld’
 (‘gnus-startup-file’).  An alternative is the variable
 ‘gnus-parameters’, SeeGroup Parameters.
 
 ‘G m’
      Make a new group (‘gnus-group-make-group’).  Gnus will prompt you
      for a name, a method and possibly an “address”.  For an easier way
      to subscribe to NNTP groups (SeeBrowse Foreign Server).
 
 ‘G M’
      Make an ephemeral group (‘gnus-group-read-ephemeral-group’).  Gnus
      will prompt you for a name, a method and an “address”.
 
 ‘G r’
      Rename the current group to something else
      (‘gnus-group-rename-group’).  This is valid only on some
      groups—mail groups mostly.  This command might very well be quite
      slow on some back ends.
 
 ‘G c’
      Customize the group parameters (‘gnus-group-customize’).
 
 ‘G e’
      Enter a buffer where you can edit the select method of the current
      group (‘gnus-group-edit-group-method’).
 
 ‘G p’
      Enter a buffer where you can edit the group parameters
      (‘gnus-group-edit-group-parameters’).
 
 ‘G E’
      Enter a buffer where you can edit the group info
      (‘gnus-group-edit-group’).
 
 ‘G d’
      Make a directory group (SeeDirectory Groups).  You will be
      prompted for a directory name (‘gnus-group-make-directory-group’).
 
 ‘G h’
      Make the Gnus help group (‘gnus-group-make-help-group’).
 
 ‘G D’
      Read an arbitrary directory as if it were a newsgroup with the
      ‘nneething’ back end (‘gnus-group-enter-directory’).  See
      Anything Groups.
 
 ‘G f’
      Make a group based on some file or other
      (‘gnus-group-make-doc-group’).  If you give a prefix to this
      command, you will be prompted for a file name and a file type.
      Currently supported types are ‘mbox’, ‘babyl’, ‘digest’, ‘news’,
      ‘rnews’, ‘mmdf’, ‘forward’, ‘rfc934’, ‘rfc822-forward’,
      ‘mime-parts’, ‘standard-digest’, ‘slack-digest’, ‘clari-briefs’,
      ‘nsmail’, ‘outlook’, ‘oe-dbx’, and ‘mailman’.  If you run this
      command without a prefix, Gnus will guess at the file type.  See
      Document Groups.
 
 ‘G u’
      Create one of the groups mentioned in ‘gnus-useful-groups’
      (‘gnus-group-make-useful-group’).
 
 ‘G w’
      Make an ephemeral group based on a web search
      (‘gnus-group-make-web-group’).  If you give a prefix to this
      command, make a solid group instead.  You will be prompted for the
      search engine type and the search string.  Valid search engine
      types include ‘google’, ‘dejanews’, and ‘gmane’.  SeeWeb
      Searches.
 
      If you use the ‘google’ search engine, you can limit the search to
      a particular group by using a match string like ‘shaving
      group:alt.sysadmin.recovery’.
 
 ‘G R’
      Make a group based on an RSS feed (‘gnus-group-make-rss-group’).
      You will be prompted for an URL.  SeeRSS.
 
 ‘G DEL’
      This function will delete the current group
      (‘gnus-group-delete-group’).  If given a prefix, this function will
      actually delete all the articles in the group, and forcibly remove
      the group itself from the face of the Earth.  Use a prefix only if
      you are absolutely sure of what you are doing.  This command can’t
      be used on read-only groups (like ‘nntp’ groups), though.
 
 ‘G V’
      Make a new, fresh, empty ‘nnvirtual’ group
      (‘gnus-group-make-empty-virtual’).  SeeVirtual Groups.
 
 ‘G v’
      Add the current group to an ‘nnvirtual’ group
      (‘gnus-group-add-to-virtual’).  Uses the process/prefix convention.
 
    SeeSelect Methods, for more information on the various select
 methods.
 
    If ‘gnus-activate-foreign-newsgroups’ is a positive number, Gnus will
 check all foreign groups with this level or lower at startup.  This
 might take quite a while, especially if you subscribe to lots of groups
 from different NNTP servers.  Also SeeGroup Levels;
 ‘gnus-activate-level’ also affects activation of foreign newsgroups.
 
    The following commands create ephemeral groups.  They can be called
 not only from the Group buffer, but in any Gnus buffer.
 
 ‘gnus-read-ephemeral-gmane-group’
      Read an ephemeral group on Gmane.org.  The articles are downloaded
      via HTTP using the URL specified by
      ‘gnus-gmane-group-download-format’.  Gnus will prompt you for a
      group name, the start article number and an the article range.
 
 ‘gnus-read-ephemeral-gmane-group-url’
      This command is similar to ‘gnus-read-ephemeral-gmane-group’, but
      the group name and the article number and range are constructed
      from a given URL.  Supported URL formats include:
      ‘http://thread.gmane.org/gmane.foo.bar/12300/focus=12399’,
      ‘http://thread.gmane.org/gmane.foo.bar/12345/’,
      ‘http://article.gmane.org/gmane.foo.bar/12345/’,
      ‘http://permalink.gmane.org/gmane.foo.bar/12345/’, and
      ‘http://news.gmane.org/group/gmane.foo.bar/thread=12345’.
 
 ‘gnus-read-ephemeral-emacs-bug-group’
      Read an Emacs bug report in an ephemeral group.  Gnus will prompt
      for a bug number.  The default is the number at point.  The URL is
      specified in ‘gnus-bug-group-download-format-alist’.
 
 ‘gnus-read-ephemeral-debian-bug-group’
      Read a Debian bug report in an ephemeral group.  Analog to
      ‘gnus-read-ephemeral-emacs-bug-group’.
 
    Some of these command are also useful for article buttons, See
 Article Buttons.
 
    Here is an example:
      (require 'gnus-art)
      (add-to-list
       'gnus-button-alist
       '("#\\([0-9]+\\)\\>" 1
         (string-match "\\<emacs\\>" (or gnus-newsgroup-name ""))
         gnus-read-ephemeral-emacs-bug-group 1))