(The problem of spam): Fix, reported by Cheng Gao
[gnus] / texi / gnusref.tex
index bc904a5..955e240 100644 (file)
@@ -1,7 +1,7 @@
 %% include file for the Gnus refcard and booklet
 
 \def\progver{5.10}\def\refver{5.10-1} % program and refcard versions
-\def\date{Oct 13th, 2001}
+\def\date{Jan, 2004}
 \def\author{Gnus Bugfixing Girls + Boys $<$bugs@gnus.org$>$}
 
 %%
@@ -37,7 +37,7 @@
     Copyright \copyright\ 1995 Vladimir Alexiev
     $<$vladimir@cs.ualberta.ca$>$.\\*
     Copyright \copyright\ 2000 Felix Natter $<$fnatter@gmx.net$>$.\\*
-    Copyright \copyright\ 2001, 2002 \author.\\*
+    Copyright \copyright\ 2001, 2002, 2003, 2004 \author.\\*
     Created from the Gnus manual Copyright \copyright\ 1994 Lars Magne
     Ingebrigtsen.\\*
     and the Emacs Help Bindings feature (C-h b).\\*
 \newcommand{\Notes}{%
   \subsection*{Notes}
   {\esamepage
-    Gnus is complex. Currently it has some 346 interactive (user-callable)
-    functions. Of these 279 are in the two major modes (Group and
+    Gnus is complex. Currently it has some 876 interactive (user-callable)
+    functions. Of these 618 are in the two major modes (Group and
     Summary/Article). Many of these functions have more than one binding, some
-    have 3 or even 4 bindings. The total number of keybindings is 389. So in
+    have 3 or even 4 bindings. The total number of keybindings is 677. So in
     order to save 40\% space, every function is listed only once on this
     \guide, under the ``more logical'' binding. Alternative bindings are given
     in parentheses in the beginning of the description.
       ?   & (?, M ?) Dormant (only followups are interesting).\\
       E   & (E, M e, M x) {\bf Expirable}. Only has effect in mail groups.\\
       G   & (C, B DEL) Canceled article (or deleted in mailgroups).\\
+      \$  & (M-d, M s x, S x).  Marked as spam.\\
       \hline\hline
       \multicolumn{2}{|p{\markdblcolwidth}|}
       {The marks below mean that the article
       \#  & (\#, M \#, M P p) Processable (will be affected by the next operation).
       [2]\\
       A   & {\bf Answered} (followed-up or replied). [2]\\
+      F   & Forwarded. [2]\\
       $\ast$  & Cached. [2]\\
       S   & Saved. [2]\\
       N   & Recently arrived. [2]\\
     C-c C-i & Gnus online-manual ({\bf info}).\\
     C-x C-t & {\bf Transpose} two groups.\\
     H f     & Fetch this group's {\bf FAQ} (using ange-ftp).\\
+    H c     & Display this group's {\bf charter}. [Prefix: query for group]\\
+    H C     & Display this group's {\bf control message} (using
+    ange-ftp). [Prefix: query for group]\\
     H v     & (V) Display the Gnus {\bf version} number.\\
     H d     & (C-c C-d) Show the {\bf description} of this group
     [Prefix: re-read from server].\\ 
         G V     & Make a new empty {\bf virtual} group. (nnvirtual)\\
         G w     & Create ephemeral group based on web-search. [Prefix: make solid group
         instead]\\
+        G R     & Make an {\bf RSS} group.\\
         G DEL   & {\bf Delete} group [Prefix: delete all articles as well].\\
         G x     & Expunge all deleted articles in an nnimap mailbox.\\
         G l     & Edit ACL (Access Control {\bf List}) for an nnimap mailbox.\\
   \newcommand{\GroupTopicsGeneral}{%
     {\esamepage
       Topics are ``categories'' for groups. Press t in the group-buffer to
-      toggle gnus-topic-mode (C-c C-i g Group Topics RET).
+      toggle gnus-topic-mode (C-c C-i g Group Topics RET).\\*
       \begin{keys}{C-c C-x}
         T n     & Prompt for topic {\bf name} and create it.\\
         T m     & {\bf Move} the current group to some other topic [p/p].\\
         Y c     & Insert all cached articles into the summary-buffer.\\
                                 %
         M-C-e   & {\bf Edit} the group-parameters.\\
-        M-C-g   & Customize the group-parameters.\\
+        M-C-a   & Customize the group-parameters.\\
                                 %
                                 % article handling
                                 %
         K $\mid$ & Pipe the MIME part to an external command.\\
         K b      & Make all the MIME parts have buttons in front of them.\\
         K m      & Try to repair {\bf multipart-headers}.\\
-        K C      & View the MIME part using a differenct {\bf charset}.\\
+        K C      & View the MIME part using a different {\bf charset}.\\
         X m      & Save all parts matching a MIME type to a directory. [p/p]\\
         M-t      & Toggle the buttonized display of the article buffer.\\
         W M w    & Decode RFC2047-encoded words in the article headers.\\
         C-c C-s C-c & Sort the summary-buffer by length.\\
         C-c C-s C-n & Sort the summary-buffer by article {\bf number}.\\
         C-c C-s C-s & Sort the summary-buffer by {\bf subject}.\\
+        C-c C-s C-r & Sort the summary-buffer {\bf randomly}.\\
         C-c C-s C-o & Sort the summary-buffer using the default method.\\
       \end{keys}
       With a prefix these functions sort in reverse order.
         W d     & Treat {\bf dumbquotes}.\\
         W e     & Treat {\bf emphasized} text.\\
         W h     & Treat {\bf HTML}.\\
-        W k     & Deuglify broken Outlook (Express) articles and redisplay.\\
         W l     & (w) Remove page breaks ({\bf\^{}L}) from the article.\\
-        W m     & Toggle {\bf MIME} processing.\\
+        W m     & {\bf Morse} decode article.\\
         W o     & Treat {\bf overstrike} or underline (\^{}H\_) in the article.\\
         W p     & Verify X-{\bf PGP}-Sig header.\\
         W q     & Treat {\bf quoted}-printable in the article.\\
         W G u   & {\bf Unfold} folded header lines.\\
         W G f   & {\bf Fold} all header lines.\\
         W G n   & Unfold {\bf Newsgroups:} and Follow-Up-To:.\\
+                                %
+        W Y c   & Repair broken {\bf citations}.\\
+        W Y a   & Repair broken {\bf attribution} lines.\\
+        W Y u   & {\bf Unwrap} broken citation lines.\\
+        W Y f   & Do a {\bf full} deuglification (W Y c, W Y a, W Y u).\\
       \end{keys}
       }
     }
       \begin{keys}{W D D}
         W D s   & (W g) Display {\bf smilies}.\\
         W D x   & (W f) Look for and display any X-{\bf Face} headers.\\
+        W D d   & Display any Face headers.\\
         W D n   & Toggle picons in {\bf Newsgroups} and Followup-To.\\
         W D m   & Toggle picons in {\bf mail} headers (To and Cc).\\
         W D f   & Toggle picons in {\bf From}.\\
         W W b   & Hide {\bf boring} headers.\\
         W W s   & Hide {\bf signature}.\\
         W W l   & Hide {\bf list} identifiers in subject-header.\\
-        W W p   & Hide {\bf PGP}-signatures.\\
         W W P   & Hide {\bf PEM} (privacy enhanced messages).\\
         W W B   & Hide banner specified by group parameter.\\
         W W c   & Hide {\bf citation}.\\
         W W C-c & Hide {\bf citation} using a more intelligent algorithm.\\
         W W C   & Hide cited text in articles that aren't roots.\\
-                                %
-        W e     & {\bf Emphasize} article.\\
-                                %
         W H a   & Highlight {\bf all} parts. Calls W b, W H c, W H h, W H s.\\
         W H c   & Highlight article {\bf citations}.\\
         W H h   & Highlight article {\bf headers}.\\
 
   \newcommand{\MIMEArticleMode}{%
     {\esamepage
-      \begin{keys}{M-RET}
+      \begin{keys}{RET}
         RET     & (BUTTON-2) Toggle display of the MIME object.\\
-        v       & (M-RET) Prompt for a method and then view object using this method.\\
+        v       & Prompt for a method and then view object using this method.\\
         o       & Prompt for a filename and save the MIME object.\\
-        C-o       & Prompt for a filename to save the MIME object to and remove it.\\
+        C-o     & Prompt for a filename to save the MIME object to and remove it.\\
+        d       & {\bf Delete} the MIME object.\\
         c       & {\bf Copy} the MIME object to a new buffer and display this buffer.\\
         i       & Display the MIME object in this buffer.\\
         C       & Copy the MIME object to a new buffer and display this buffer using {\bf Charset} \\
       /x   & Limit depending on ``extra'' headers.\\
       /u   & (x) Limit to {\bf unread} articles.
       [Prefix: also exclude ticked and dormant articles]\\
+      /.   & Limit to unseen articles.\\
       /m   & Limit to articles marked with specified {\bf mark}.\\
       /t   & Ask for a number and exclude articles younger than that many days.
       [Prefix: exclude older articles]\\
       /o   & Insert all {\bf old} articles. [Prefix: how many]\\
       /N   & Insert all {\bf new} articles.\\
       /p   & Limit to articles {\bf predicated} in the `display' group parameter.\\
+      /r   & Limit to {\bf replied} articles. [Prefix: unreplied]\\
     \end{keys}
     }
   }
 \newcommand{\PostReplyetc}{% formerly \Ssubmap
   {\esamepage
     These commands put you in a separate news or mail buffer. See the section
-    about composing messages for more information.
+    about composing messages for more information.\\*
                                 %After
                                 %editing the article, send it by pressing C-c C-c.  If you are in a
                                 %foreign group and want to post the article using the foreign server, give
     \end{keys}
     The four letters stand for:\\*
     \quad \B{A}ction: I)ncrease, L)ower;\\*
-    \quad \B{p}art: a)utor (from), s)ubject, x)refs (cross-posting), d)ate, l)ines,
+    \quad \B{p}art: a)uthor (from), s)ubject, x)refs (cross-posting), d)ate, l)ines,
     message-i)d, t)references (parent), f)ollowup, b)ody, h)ead (all headers);\\*
     \quad \B{m}atch type:\\*
     \qquad string: s)ubstring, e)xact, r)egexp, f)uzzy,\\*
       Z P     & Exit and go to the {\bf previous} group.\\
                                 %
       Z G     & (M-g) Check for new articles in this group ({\bf get}).\\
-      Z R     & Exit this group, and then enter it again ({\bf reenter}).
+      Z R     & (C-x C-s) Exit this group, and then enter it again ({\bf reenter}).
       [Prefix: select all articles, read and unread.]\\
       Z s     & Update and save the dribble buffer. [Prefix: save .newsrc* as well]\\
     \end{keys}
   }
 
 \newcommand{\MsgCompositionGeneral}{%
-  Press C-c ? in the composition-buffer to get this information.
+  Press C-c ? in the composition-buffer to get this information.\\*
   {\esamepage
     \begin{keys}{C-c C-m}
                                 % sending
   }
 
 \newcommand{\MsgCompositionMovementArticle}{%
-  The following functions create the header-field if necessary.
+  The following functions create the header-field if necessary.\\*
   {\esamepage
     \begin{keys}{C-c C-f C-u}
       C-c TAB & Move to \textbf{signature}.\\
       C-c C-f C-d & Move to \textbf{Distribution:}.\\
       C-c C-f C-m & Move to \textbf{Mail-Followup-To:}.\\
       C-c C-f C-o & Move to \textbf{From:}.\\
-      C-c C-f C-a & Insert a resonable \textbf{Mail-Followup-To:} for
+      C-c C-f C-a & Insert a reasonable \textbf{Mail-Followup-To:} for
       an unsubscribed list. [Prefix: include addresses in \textbf{Cc:}]\\
       C-c C-f TAB & (C-c C-u) Move to \textbf{Importance:}.\\
       C-c M-n     & Insert \textbf{Disposition-Notification-To:}
       C-c C-m m   & Insert \textbf{multi}-part.\\
       C-c C-m q   & \textbf{Quote} region.\\
       C-c C-m c s & Encrypt message using \textbf{S/MIME}.\\
-      C-c C-m c o & Encrypt message usging PGP.\\
+      C-c C-m c o & Encrypt message using PGP.\\
       C-c C-m c p & Encrypt message using \textbf{PGP/MIME}.\\
       C-c C-m s s & Sign message using \textbf{S/MIME}.\\
       C-c C-m s o & Sign message using PGP.\\