comparison man/gnus.texi @ 40705:421e0a91a1d1

Replace M-C- with C-M-

40704:b2731291b2d0

@findex gnus-group-visible-select-group
This is yet one more command that does the same as the @key{RET}
command, but this one does it without expunging and hiding dormants
(@code{gnus-group-visible-select-group}).

@item M-C-@key{RET}
@kindex M-C-@key{RET} @r{(Group)}
@findex gnus-group-select-group-ephemerally
Finally, this command selects the current group ephemerally without
doing any processing of its contents
(@code{gnus-group-select-group-ephemerally}).  Even threading has been
turned off.  Everything you do in the group after selecting it in this

@kindex C-c C-x @r{(Group)}
@findex gnus-group-expire-articles
Run all expirable articles in the current group through the expiry
process (if any) (@code{gnus-group-expire-articles}).

@item C-c M-C-x
@kindex C-c M-C-x @r{(Group)}
@findex gnus-group-expire-all-groups
Run all articles in all groups through the expiry process
(@code{gnus-group-expire-all-groups}).

@end table

@cindex thread commands

@table @kbd

@item T k
@itemx M-C-k
@kindex T k @r{(Summary)}
@kindex M-C-k @r{(Summary)}
@findex gnus-summary-kill-thread
Mark all articles in the current (sub-)thread as read
(@code{gnus-summary-kill-thread}).  If the prefix argument is positive,
remove all marks instead.  If the prefix argument is negative, tick
articles instead.

@item T l
@itemx M-C-l
@kindex T l @r{(Summary)}
@kindex M-C-l @r{(Summary)}
@findex gnus-summary-lower-thread
Lower the score of the current (sub-)thread
(@code{gnus-summary-lower-thread}).

@item T i

@table @kbd

@item T n
@kindex T n @r{(Summary)}
@itemx M-C-n
@kindex M-C-n @r{(Summary)}
@itemx M-down
@kindex M-down @r{(Summary)}
@findex gnus-summary-next-thread
Go to the next thread (@code{gnus-summary-next-thread}).

@item T p
@kindex T p @r{(Summary)}
@itemx M-C-p
@kindex M-C-p @r{(Summary)}
@itemx M-up
@kindex M-up @r{(Summary)}
@findex gnus-summary-prev-thread
Go to the previous thread (@code{gnus-summary-prev-thread}).

@kindex B e @r{(Summary)}
@findex gnus-summary-expire-articles
Expire all expirable articles in the group
(@code{gnus-summary-expire-articles}).

@item B M-C-e
@kindex B M-C-e @r{(Summary)}
@findex gnus-summary-expire-articles-now
Delete all the expirable articles in the group
(@code{gnus-summary-expire-articles-now}).  This means that @strong{all}
articles eligible for expiry in the current group will
disappear forever into that big @file{/dev/null} in the sky.

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 @kbd{C-d} and read these messages in a more convenient
fashion.

@item M-C-d
@kindex M-C-d @r{(Summary)}
@findex gnus-summary-read-document
This command is very similar to the one above, but lets you gather
several documents into one biiig group
(@code{gnus-summary-read-document}).  It does this by opening several
@code{nndoc} groups for each document, and then opening an

@kindex = @r{(Summary)}
@findex gnus-summary-expand-window
Expand the summary buffer window (@code{gnus-summary-expand-window}).
If given a prefix, force an @code{article} window configuration.

@item M-C-e
@kindex M-C-e @r{(Summary)}
@findex gnus-summary-edit-parameters
Edit the group parameters (@pxref{Group Parameters}) of the current
group (@code{gnus-summary-edit-parameters}).

@item M-C-a
@kindex M-C-a @r{(Summary)}
@findex gnus-summary-customize-parameters
Customize the group parameters (@pxref{Group Parameters}) of the current
group (@code{gnus-summary-customize-parameters}).

@end table

@kindex M-i @r{(Summary)}
@findex gnus-symbolic-argument
I'm not, so I've added a second prefix---the @dfn{symbolic prefix}.  The
prefix key is @kbd{M-i} (@code{gnus-symbolic-argument}), and the next
character typed in is the value.  You can stack as many @kbd{M-i}
prefixes as you want.  @kbd{M-i a M-C-u} means ``feed the @kbd{M-C-u}
command the symbolic prefix @code{a}''.  @kbd{M-i a M-i b M-C-u} means
``feed the @kbd{M-C-u} command the symbolic prefixes @code{a} and
@code{b}''.  You get the drift.

Typing in symbolic prefixes to commands that don't accept them doesn't
hurt, but it doesn't do any good either.  Currently not many Gnus
functions make use of the symbolic prefix.

@findex gnus-undo-mode
@vindex gnus-use-undo
@findex gnus-undo
The undoability is provided by the @code{gnus-undo-mode} minor mode.  It
is used if @code{gnus-use-undo} is non-@code{nil}, which is the
default.  The @kbd{M-C-_} key performs the @code{gnus-undo} 
command, which should feel kinda like the normal Emacs @code{undo}
command.


@node Moderation

@item
There's a way now to specify that ``uninteresting'' fields be suppressed
when generating lines in buffers (@pxref{Advanced Formatting}).

@item
Several commands in the group buffer can be undone with @kbd{M-C-_}
(@pxref{Undo}).

@item
Scoring can be done on words using the new score type @code{w}
(@pxref{Score File Format}).

A new command has been added to remove all data on articles from
the native server (@pxref{Changing Servers}).

@item
A new command for reading collections of documents
(@code{nndoc} with @code{nnvirtual} on top) has been added---@kbd{M-C-d}
(@pxref{Really Various Summary Commands}).

@item
Process mark sets can be pushed and popped (@pxref{Setting Process
Marks}).

@node Emacs for Heathens
@section Emacs for Heathens

Believe it or not, but some people who use Gnus haven't really used
Emacs much before they embarked on their journey on the Gnus Love Boat.
If you are one of those unfortunates whom ``@kbd{M-C-a}'', ``kill the
region'', and ``set @code{gnus-flargblossen} to an alist where the key
is a regexp that is used for matching on the group name'' are magical
phrases with little or no meaning, then this appendix is for you.  If
you are already familiar with Emacs, just ignore this and go fondle your
cat instead.

keyboard.  The one I'm currently at has a key that's marked ``Alt'',
which is the meta key on this keyboard.  It's usually located somewhere
to the left hand side of the keyboard, usually on the bottom row.

Now, us Emacs people don't say ``press the meta-control-m key'',
because that's just too inconvenient.  We say ``press the @kbd{M-C-m}
key''.  @kbd{M-} is the prefix that means ``meta'' and ``C-'' is the
prefix that means ``control''.  So ``press @kbd{C-k}'' means ``press
down the control key, and hold it down while you press @kbd{k}''.
``Press @kbd{M-C-k}'' means ``press down and hold down the meta key and
the control key and then press @kbd{k}''.  Simple, ay?

This is somewhat complicated by the fact that not all keyboards have a
meta key.  In that case you can use the ``escape'' key.  Then @kbd{M-k}
means ``press escape, release escape, press @kbd{k}''.  That's much more

40705:421e0a91a1d1

@findex gnus-group-visible-select-group
This is yet one more command that does the same as the @key{RET}
command, but this one does it without expunging and hiding dormants
(@code{gnus-group-visible-select-group}).

@item C-M-@key{RET}
@kindex C-M-@key{RET} @r{(Group)}
@findex gnus-group-select-group-ephemerally
Finally, this command selects the current group ephemerally without
doing any processing of its contents
(@code{gnus-group-select-group-ephemerally}).  Even threading has been
turned off.  Everything you do in the group after selecting it in this

@kindex C-c C-x @r{(Group)}
@findex gnus-group-expire-articles
Run all expirable articles in the current group through the expiry
process (if any) (@code{gnus-group-expire-articles}).

@item C-c C-M-x
@kindex C-c C-M-x @r{(Group)}
@findex gnus-group-expire-all-groups
Run all articles in all groups through the expiry process
(@code{gnus-group-expire-all-groups}).

@end table

@cindex thread commands

@table @kbd

@item T k
@itemx C-M-k
@kindex T k @r{(Summary)}
@kindex C-M-k @r{(Summary)}
@findex gnus-summary-kill-thread
Mark all articles in the current (sub-)thread as read
(@code{gnus-summary-kill-thread}).  If the prefix argument is positive,
remove all marks instead.  If the prefix argument is negative, tick
articles instead.

@item T l
@itemx C-M-l
@kindex T l @r{(Summary)}
@kindex C-M-l @r{(Summary)}
@findex gnus-summary-lower-thread
Lower the score of the current (sub-)thread
(@code{gnus-summary-lower-thread}).

@item T i

@table @kbd

@item T n
@kindex T n @r{(Summary)}
@itemx C-M-n
@kindex C-M-n @r{(Summary)}
@itemx M-down
@kindex M-down @r{(Summary)}
@findex gnus-summary-next-thread
Go to the next thread (@code{gnus-summary-next-thread}).

@item T p
@kindex T p @r{(Summary)}
@itemx C-M-p
@kindex C-M-p @r{(Summary)}
@itemx M-up
@kindex M-up @r{(Summary)}
@findex gnus-summary-prev-thread
Go to the previous thread (@code{gnus-summary-prev-thread}).

@kindex B e @r{(Summary)}
@findex gnus-summary-expire-articles
Expire all expirable articles in the group
(@code{gnus-summary-expire-articles}).

@item B C-M-e
@kindex B C-M-e @r{(Summary)}
@findex gnus-summary-expire-articles-now
Delete all the expirable articles in the group
(@code{gnus-summary-expire-articles-now}).  This means that @strong{all}
articles eligible for expiry in the current group will
disappear forever into that big @file{/dev/null} in the sky.

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 @kbd{C-d} and read these messages in a more convenient
fashion.

@item C-M-d
@kindex C-M-d @r{(Summary)}
@findex gnus-summary-read-document
This command is very similar to the one above, but lets you gather
several documents into one biiig group
(@code{gnus-summary-read-document}).  It does this by opening several
@code{nndoc} groups for each document, and then opening an

@kindex = @r{(Summary)}
@findex gnus-summary-expand-window
Expand the summary buffer window (@code{gnus-summary-expand-window}).
If given a prefix, force an @code{article} window configuration.

@item C-M-e
@kindex C-M-e @r{(Summary)}
@findex gnus-summary-edit-parameters
Edit the group parameters (@pxref{Group Parameters}) of the current
group (@code{gnus-summary-edit-parameters}).

@item C-M-a
@kindex C-M-a @r{(Summary)}
@findex gnus-summary-customize-parameters
Customize the group parameters (@pxref{Group Parameters}) of the current
group (@code{gnus-summary-customize-parameters}).

@end table

@kindex M-i @r{(Summary)}
@findex gnus-symbolic-argument
I'm not, so I've added a second prefix---the @dfn{symbolic prefix}.  The
prefix key is @kbd{M-i} (@code{gnus-symbolic-argument}), and the next
character typed in is the value.  You can stack as many @kbd{M-i}
prefixes as you want.  @kbd{M-i a C-M-u} means ``feed the @kbd{C-M-u}
command the symbolic prefix @code{a}''.  @kbd{M-i a M-i b C-M-u} means
``feed the @kbd{C-M-u} command the symbolic prefixes @code{a} and
@code{b}''.  You get the drift.

Typing in symbolic prefixes to commands that don't accept them doesn't
hurt, but it doesn't do any good either.  Currently not many Gnus
functions make use of the symbolic prefix.

@findex gnus-undo-mode
@vindex gnus-use-undo
@findex gnus-undo
The undoability is provided by the @code{gnus-undo-mode} minor mode.  It
is used if @code{gnus-use-undo} is non-@code{nil}, which is the
default.  The @kbd{C-M-_} key performs the @code{gnus-undo} 
command, which should feel kinda like the normal Emacs @code{undo}
command.


@node Moderation

@item
There's a way now to specify that ``uninteresting'' fields be suppressed
when generating lines in buffers (@pxref{Advanced Formatting}).

@item
Several commands in the group buffer can be undone with @kbd{C-M-_}
(@pxref{Undo}).

@item
Scoring can be done on words using the new score type @code{w}
(@pxref{Score File Format}).

A new command has been added to remove all data on articles from
the native server (@pxref{Changing Servers}).

@item
A new command for reading collections of documents
(@code{nndoc} with @code{nnvirtual} on top) has been added---@kbd{C-M-d}
(@pxref{Really Various Summary Commands}).

@item
Process mark sets can be pushed and popped (@pxref{Setting Process
Marks}).

@node Emacs for Heathens
@section Emacs for Heathens

Believe it or not, but some people who use Gnus haven't really used
Emacs much before they embarked on their journey on the Gnus Love Boat.
If you are one of those unfortunates whom ``@kbd{C-M-a}'', ``kill the
region'', and ``set @code{gnus-flargblossen} to an alist where the key
is a regexp that is used for matching on the group name'' are magical
phrases with little or no meaning, then this appendix is for you.  If
you are already familiar with Emacs, just ignore this and go fondle your
cat instead.

keyboard.  The one I'm currently at has a key that's marked ``Alt'',
which is the meta key on this keyboard.  It's usually located somewhere
to the left hand side of the keyboard, usually on the bottom row.

Now, us Emacs people don't say ``press the meta-control-m key'',
because that's just too inconvenient.  We say ``press the @kbd{C-M-m}
key''.  @kbd{M-} is the prefix that means ``meta'' and ``C-'' is the
prefix that means ``control''.  So ``press @kbd{C-k}'' means ``press
down the control key, and hold it down while you press @kbd{k}''.
``Press @kbd{C-M-k}'' means ``press down and hold down the meta key and
the control key and then press @kbd{k}''.  Simple, ay?

This is somewhat complicated by the fact that not all keyboards have a
meta key.  In that case you can use the ``escape'' key.  Then @kbd{M-k}
means ``press escape, release escape, press @kbd{k}''.  That's much more