# HG changeset patch # User Dave Love # Date 980530407 0 # Node ID 64758b6d401ff59d0f938784beca8b0f4beb182a # Parent afe32e7ffa6c2e5d655833ff81960e442fc73bec *** empty log message *** diff -r afe32e7ffa6c -r 64758b6d401f man/gnus.texi --- a/man/gnus.texi Fri Jan 26 14:41:54 2001 +0000 +++ b/man/gnus.texi Fri Jan 26 17:33:27 2001 +0000 @@ -593,7 +593,6 @@ Composing Messages * Mail:: Mailing and replying. -* Post:: Posting and following up. * Posting Server:: What server should you post via? * Mail and Post:: Mailing and posting at the same time. * Archived Messages:: Where Gnus stores the messages you've sent. @@ -1725,6 +1724,9 @@ @samp{%} (@code{gnus-new-mail-mark}) if there has arrived new mail to the group lately. +@item p +@samp{#} (@code{gnus-process-mark}) if the group is process marked. + @item d A string that says when you last read the group (@pxref{Group Timestamp}). @@ -2702,6 +2704,13 @@ (signature "Funky Signature")) @end example +@item banner +An item like @code{(banner . "regex")} causes any part of an article +that matches the regular expression "regex" to be stripped. Instead of +"regex", you can also use the symbol @code{signature} which strips the +last signature or any of the elements of the alist +@code{gnus-article-banner-alist}. + @end table Use the @kbd{G p} command to edit group parameters of a group. You @@ -3839,7 +3848,8 @@ * Tree Display:: A more visual display of threads. * Mail Group Commands:: Some commands can only be used in mail groups. * Various Summary Stuff:: What didn't fit anywhere else. -* Exiting the Summary Buffer:: Returning to the Group buffer. +* Exiting the Summary Buffer:: Returning to the Group buffer, + or reselecting the current group. * Crosspost Handling:: How crossposted articles are dealt with. * Duplicate Suppression:: An alternative when crosspost handling fails. @end menu @@ -4290,6 +4300,9 @@ None of the following movement commands understand the numeric prefix, and they all select and display an article. +If you want to fetch new articles or redisplay the group, see +@ref{Exiting the Summary Buffer}. + @table @kbd @item SPACE @kindex SPACE (Summary) @@ -7311,7 +7324,15 @@ something else'', but normally results in something looking better. Cleaner, perhaps. -@table @kbd +@xref{Customizing Articles}, if you want to change how Gnus displays +articles by default. + +@table @kbd + +@item C-u g +This is not really washing, it's sort of the opposite of washing. If +you type this, you see the article exactly as it exists on disk or on +the server. @item W l @kindex W l (Summary) @@ -7366,6 +7387,12 @@ whether a character is a sm*rtq**t* or not, so it should only be used interactively. +In reality, this function is translates a subset of the subset of the +@code{cp1252} (or @code{Windows-1252}) character set that isn't in ISO +Latin-1, including the quote characters @code{\222} and @code{\264}. +Messages in this character set often have a MIME header saying that +they are Latin-1. + @item W w @kindex W w (Summary) @findex gnus-article-fill-cited-article @@ -9512,7 +9539,6 @@ @menu * Mail:: Mailing and replying. -* Post:: Posting and following up. * Posting Server:: What server should you post via? * Mail and Post:: Mailing and posting at the same time. * Archived Messages:: Where Gnus stores the messages you've sent. @@ -9541,37 +9567,6 @@ If non-@code{nil}, add a @code{to-list} group parameter to mail groups that have none when you do a @kbd{a}. -@item message-send-mail-partially-limit -@vindex message-send-mail-partially-limit -The limitation of messages sent as message/partial. -The lower bound of message size in characters, beyond which the message -should be sent in several parts. If it is nil, the size is unlimited. - -@end table - - -@node Post -@section Post - -Variables for composing news articles: - -@table @code -@item gnus-sent-message-ids-file -@vindex gnus-sent-message-ids-file -Gnus will keep a @code{Message-ID} history file of all the mails it has -sent. If it discovers that it has already sent a mail, it will ask the -user whether to re-send the mail. (This is primarily useful when -dealing with @sc{soup} packets and the like where one is apt to send the -same packet multiple times.) This variable says what the name of this -history file is. It is @file{~/News/Sent-Message-IDs} by default. Set -this variable to @code{nil} if you don't want Gnus to keep a history -file. - -@item gnus-sent-message-ids-length -@vindex gnus-sent-message-ids-length -This variable says how many @code{Message-ID}s to keep in the history -file. It is 1000 by default. - @end table @@ -9890,16 +9885,24 @@ ((message-news-p) (signature my-news-signature)) (header "From\\|To" "larsi.*org" - (Organization "Somewhere, Inc.")) + (Organization "Somewhere, Inc.")) ((posting-from-work-p) (signature-file "~/.work-signature") (address "user@@bar.foo") (body "You are fired.\n\nSincerely, your boss.") (organization "Important Work, Inc")) + ("nnml:.*" + (From (save-excursion + (set-buffer gnus-article-buffer) + (message-fetch-field "to")))) ("^nn.+:" (signature-file "~/.mail-signature")))) @end lisp +The @samp{nnml:.*} rule means that you use the @code{To} address as the +@code{From} address in all your outgoing replies, which might be handy +if you fill many roles. + @node Drafts @section Drafts @@ -10475,6 +10478,8 @@ The file contains one or more line, each of which define one server. @item +Each line may contain an arbitrary number of token/value pairs. + The valid tokens include @samp{machine}, @samp{login}, @samp{password}, @samp{default}. In addition Gnus introduces two new tokens, not present in the original @file{.netrc}/@code{ftp} syntax, namely @samp{port} and @@ -11430,7 +11435,7 @@ @end table @end table -@subsubheading Function Interface +@subsubsection Function Interface Some of the above keywords specify a Lisp function to be executed. For each keyword @code{:foo}, the Lisp variable @code{foo} is bound to @@ -14508,7 +14513,7 @@ @code{gnus-agent} has been loaded via @code{(gnus-agentize)}) @lisp -(defvar gnus-category-predicate-alist +(setq gnus-category-predicate-alist (append gnus-category-predicate-alist '((old . my-article-old-p)))) @end lisp @@ -15897,7 +15902,7 @@ might look something like this: @lisp -(defvar gnus-default-adaptive-score-alist +(setq gnus-default-adaptive-score-alist '((gnus-unread-mark) (gnus-ticked-mark (from 4)) (gnus-dormant-mark (from 5)) @@ -16152,7 +16157,11 @@ @vindex message-sent-hook These two functions are both primarily meant to be used in hooks like -@code{message-sent-hook}. +@code{message-sent-hook}, like this: +@lisp +(add-hook 'message-sent-hook 'gnus-score-followup-thread) +@end lisp + If you look closely at your own @code{Message-ID}, you'll notice that the first two or three characters are always the same. Here's two of @@ -16169,7 +16178,7 @@ @lisp ("references" - ("" + ("" 1000 nil r)) @end lisp @@ -20317,9 +20326,9 @@ when replying to several messages at once, put the "other" message-ids into a See-Also header. @item - support setext: @url{http://www.bsdi.com/setext/} -@item - support ProleText: @url{http://proletext.clari.net/prole/proletext.html} + support setext: @uref{http://www.bsdi.com/setext/} +@item + support ProleText: @uref{http://proletext.clari.net/prole/proletext.html} @item when browsing a foreign server, the groups that are already subscribed should be listed as such and not as "K". @@ -20932,7 +20941,7 @@ version branches as threading, checkin date as the date, etc. @item -@url{http://www.dejanews.com/forms/dnsetfilter_exp.html}? +@uref{http://www.dejanews.com/forms/dnsetfilter_exp.html}? This filter allows one to construct advance queries on the Dejanews database such as specifying start and end dates, subject, author, and/or newsgroup name. diff -r afe32e7ffa6c -r 64758b6d401f man/message.texi --- a/man/message.texi Fri Jan 26 14:41:54 2001 +0000 +++ b/man/message.texi Fri Jan 26 17:33:27 2001 +0000 @@ -319,6 +319,7 @@ @chapter Commands @menu +* Buffer Entry:: Commands after entering a Message buffer. * Header Commands:: Commands for moving to headers. * Movement:: Moving around in message buffers. * Insertion:: Inserting things into message buffers. @@ -326,9 +327,25 @@ * Various Commands:: Various things. * Sending:: Actually sending the message. * Mail Aliases:: How to use mail aliases. +* Spelling:: Having Emacs check your spelling. @end menu +@node Buffer Entry +@section Buffer Entry +@cindex undo +@kindex C-_ + +You most often end up in a Message buffer when responding to some other +message of some sort. Message does lots of handling of quoted text, and +may remove signatures, reformat the text, or the like---depending on +which used settings you're using. Message usually gets things right, +but sometimes it stumbles. To help the user unwind these stumblings, +Message sets the undo boundary before each major automatic action it +takes. If you press the undo key (usually located at @kbd{C-_}) a few +times, you will get back the un-edited message you're responding to. + + @node Header Commands @section Header Commands @@ -693,6 +710,51 @@ expansions have to be done explicitly. +@node Spelling +@section Spelling +@cindex spelling +@findex ispell-message + +There are two popular ways to have Emacs spell-check your messages: +@code{ispell} and @code{flyspell}. @code{ispell} is the older and +probably more popular package. You typically first write the message, +and then run the entire thing through @code{ispell} and fix all the +typos. To have this happen automatically when you send a message, put +something like the following in your @file{.emacs} file: + +@lisp +(add-hook 'message-send-hook 'ispell-message) +@end lisp + +@vindex ispell-message-dictionary-alist +If you're in the habit of writing in different languages, this can be +controlled by the @code{ispell-message-dictionary-alist} variable: + +@lisp +(setq ispell-message-dictionary-alist + '(("^Newsgroups:.*\\bde\\." . "deutsch8") + (".*" . "default"))) +@end lisp + +@code{ispell} depends on having the external @samp{ispell} command +installed. + +The other popular method is using @code{flyspell}. This package checks +your spelling while you're writing, and marks any mis-spelled words in +various ways. + +To use @code{flyspell}, put something like the following in your +@file{.emacs} file: + +@lisp +(defun my-message-setup-routine () + (flyspell-mode 1)) +(add-hook 'message-setup-hook 'my-message-setup-routine) +@end lisp + +@code{flyspell} depends on having the external @samp{ispell} command +installed. + @node Variables @chapter Variables @@ -768,7 +830,7 @@ @item message-subject-re-regexp @vindex message-subject-re-regexp Responses to messages have subjects that start with @samp{Re: }. This -is @emph{not} an abbreviation of the English word ``response'', but in +is @emph{not} an abbreviation of the English word ``response'', but is Latin, and means ``in response to''. Some illiterate nincompoops have failed to grasp this fact, and have ``internationalized'' their software to use abonimations like @samp{Aw: } (``antwort'') or @samp{Sv: } @@ -793,7 +855,7 @@ @vindex message-required-mail-headers @xref{News Headers}, for the syntax of this variable. It is @code{(From Date Subject (optional . In-Reply-To) Message-ID Lines -(optional . X-Mailer))} by default. +(optional . User-Agent))} by default. @item message-ignored-mail-headers @vindex message-ignored-mail-headers @@ -826,6 +888,13 @@ messages via MH. Set it to @code{nil} if your MH can handle these headers. +@item message-send-mail-partially-limit +@vindex message-send-mail-partially-limit +The limit on the size of messages sent as @samp{message/partial}. +This is the minimum message size in characters beyond which the +message should be sent in several parts. If it is @code{nil}, the +size is unlimited. + @end table @@ -881,16 +950,11 @@ this isn't a fully qualified domain name (FQDN), Message will use @code{mail-host-address} as the FQDN of the machine. -@item X-Newsreader -@cindex X-Newsreader +@item User-Agent +@cindex User-Agent This optional header will be filled out according to the @code{message-newsreader} local variable. -@item X-Mailer -This optional header will be filled out according to the -@code{message-mailer} local variable, unless there already is an -@code{X-Newsreader} header present. - @item In-Reply-To This optional header is filled out using the @code{Date} and @code{From} header of the article being replied to. @@ -1103,9 +1167,8 @@ @lisp (add-hook 'message-send-hook 'my-message-add-content) (defun my-message-add-content () - (message-add-header - "X-In-No-Sense: Nonsense" - "X-Whatever: no")) + (message-add-header "X-In-No-Sense: Nonsense") + (message-add-header "X-Whatever: no")) @end lisp This function won't add the header if the header is already present.