Show
Ignore:
Timestamp:
05/18/06 16:19:18 (3 years ago)
Author:
miyoshi
Message:

Sync up with Emacs CVS HEAD.

Files:

Legend:

Unmodified
Added
Removed
Modified
Copied
Moved
  • trunk/man/gnus.texi

    r4073 r4085  
    927927@cindex starting up 
    928928 
     929If you are haven't used Emacs much before using Gnus, read @ref{Emacs 
     930for Heathens} first. 
     931 
    929932@kindex M-x gnus 
    930933@findex gnus 
    931934If your system administrator has set things up properly, starting Gnus 
    932935and reading news is extremely easy---you just type @kbd{M-x gnus} in 
    933 your Emacs. 
     936your Emacs.  If not, you should customize the variable 
     937@code{gnus-select-method} as described in @ref{Finding the News}.  For a 
     938minimal setup for posting should also customize the variables 
     939@code{user-full-name} and @code{user-mail-address}. 
    934940 
    935941@findex gnus-other-frame 
     
    17051711@end menu 
    17061712 
     1713You can customize the Group Mode tool bar, see @kbd{M-x 
     1714customize-apropos RET gnus-group-tool-bar}.  This feature is only 
     1715available in Emacs. 
     1716 
     1717The tool bar icons are now (de)activated correctly depending on the 
     1718cursor position.  Therefore, moving around in the Group Buffer is 
     1719slower.  You can disable this via the variable 
     1720@code{gnus-group-update-tool-bar}.  Its default value depends on your 
     1721Emacs version. 
    17071722 
    17081723@node Group Line Specification 
     
    44474462 
    44484463You can have as many summary buffers open as you wish. 
     4464 
     4465You can customize the Summary Mode tool bar, see @kbd{M-x 
     4466customize-apropos RET gnus-summary-tool-bar}.  This feature is only 
     4467available in Emacs. 
    44494468 
    44504469@kindex v (Summary) 
     
    1198712006@code{From} address in all your outgoing replies, which might be handy 
    1198812007if you fill many roles. 
    11989  
     12008You may also use @code{message-alternative-emails} instead. 
     12009@xref{Message Headers, ,Message Headers, message, Message Manual}. 
    1199012010 
    1199112011@node Drafts 
     
    2600726027@itemize @bullet 
    2600826028 
    26009 @item 
    26010 @kbd{F} (@code{gnus-article-followup-with-original}) and @kbd{R} 
    26011 (@code{gnus-article-reply-with-original}) only yank the text in the 
    26012 region if the region is active. 
    26013  
    26014 @item 
    26015 @code{gnus-group-read-ephemeral-group} can be called interactively, 
    26016 using @kbd{G M}. 
    26017  
    26018 @item 
    26019 In draft groups, @kbd{e} is now bound to @code{gnus-draft-edit-message}. 
    26020 Use @kbd{B w} for @code{gnus-summary-edit-article} instead. 
    26021  
    26022 @item 
    26023 The revised Gnus @acronym{FAQ} is included in the manual, 
    26024 @xref{Frequently Asked Questions}. 
    26025  
     26029@item Installation changes 
     26030@c *********************** 
     26031 
     26032@itemize @bullet 
    2602626033@item 
    2602726034Upgrading from previous (stable) version if you have used Oort. 
     
    2603526042later entry for more information about marks.  Note that downgrading 
    2603626043isn't save in general. 
    26037  
    26038 @item 
    26039 Article Buttons 
    26040  
    26041 More buttons for URLs, mail addresses, Message-IDs, Info links, man 
    26042 pages and Emacs or Gnus related references.  @xref{Article Buttons}.  The 
    26043 variables @code{gnus-button-@var{*}-level} can be used to control the 
    26044 appearance of all article buttons.  @xref{Article Button Levels}. 
    26045  
    26046 @item 
    26047 Dired integration 
    26048  
    26049 @code{gnus-dired-minor-mode} (see @ref{Other modes}) installs key 
    26050 bindings in dired buffers to send a file as an attachment, open a file 
    26051 using the appropriate mailcap entry, and print a file using the mailcap 
    26052 entry. 
    26053  
    26054 @item 
    26055 Gnus can display RSS newsfeeds as a newsgroup.  @xref{RSS}. 
    26056  
    26057 @item 
    26058 Single-part yenc encoded attachments can be decoded. 
    26059  
    26060 @item 
    26061 Picons 
    26062  
    26063 The picons code has been reimplemented to work in GNU Emacs---some of 
    26064 the previous options have been removed or renamed. 
    26065  
    26066 Picons are small ``personal icons'' representing users, domain and 
    26067 newsgroups, which can be displayed in the Article buffer. 
    26068 @xref{Picons}. 
    26069  
    26070 @item 
    26071 If the new option @code{gnus-treat-body-boundary} is non-@code{nil}, a 
    26072 boundary line is drawn at the end of the headers. 
    26073  
    26074 @item 
    26075 Retrieval of charters and control messages 
    26076  
    26077 There are new commands for fetching newsgroup charters (@kbd{H c}) and 
    26078 control messages (@kbd{H C}). 
    26079  
    26080 @item 
    26081 Delayed articles 
    26082  
    26083 You can delay the sending of a message with @kbd{C-c C-j} in the Message 
    26084 buffer.  The messages are delivered at specified time.  This is useful 
    26085 for sending yourself reminders.  @xref{Delayed Articles}. 
    26086  
    26087 @item 
    26088 If @code{auto-compression-mode} is enabled, attachments are automatically 
    26089 decompressed when activated. 
    26090  
    26091 @item 
    26092 If the new option @code{nnml-use-compressed-files} is non-@code{nil}, 
    26093 the nnml back end allows compressed message files. 
    26094  
    26095 @item 
    26096 Signed article headers (X-PGP-Sig) can be verified with @kbd{W p}. 
    26097  
    26098 @item 
    26099 The Summary Buffer uses an arrow in the fringe to indicate the current 
    26100 article.  Use @code{(setq gnus-summary-display-arrow nil)} to disable it. 
    26101  
    26102 @item 
    26103 Warn about email replies to news 
    26104  
    26105 Do you often find yourself replying to news by email by mistake?  Then 
    26106 the new option @code{gnus-confirm-mail-reply-to-news} is just the thing for 
    26107 you. 
    26108  
    26109 @item 
    26110 If the new option @code{gnus-summary-display-while-building} is 
    26111 non-@code{nil}, the summary buffer is shown and updated as it's being 
    26112 built. 
    26113  
    26114 @item 
    26115 The new @code{recent} mark @samp{.} indicates newly arrived messages (as 
    26116 opposed to old but unread messages). 
    26117  
    26118 @item 
    26119 The new option @code{gnus-gcc-mark-as-read} automatically marks 
    26120 Gcc articles as read. 
    26121  
    26122 @item 
    26123 The nndoc back end now supports mailman digests and exim bounces. 
    26124  
    26125 @item 
    26126 Gnus supports RFC 2369 mailing list headers, and adds a number of 
    26127 related commands in mailing list groups.  @xref{Mailing List}. 
    26128  
    26129 @item 
    26130 The Date header can be displayed in a format that can be read aloud 
    26131 in English.  @xref{Article Date}. 
    26132  
    26133 @item 
    26134 The envelope sender address can be customized when using Sendmail. 
    26135 @xref{Mail Variables, Mail Variables,, message, Message Manual}. 
    26136  
    26137 @item 
    26138 diffs are automatically highlighted in groups matching 
    26139 @code{mm-uu-diff-groups-regexp} 
    26140  
    26141 @item 
    26142 @acronym{TLS} wrapper shipped with Gnus 
    26143  
    26144 @acronym{TLS}/@acronym{SSL} is now supported in @acronym{IMAP} and 
    26145 @acronym{NNTP} via @file{tls.el} and GNUTLS.  The old 
    26146 @acronym{TLS}/@acronym{SSL} support via (external third party) 
    26147 @file{ssl.el} and OpenSSL still works. 
    2614826044 
    2614926045@item 
     
    2616626062cycle used under Unix systems. 
    2616726063 
    26168 The new @file{make.bat} makes @file{make-x.bat} superfluous, so it has 
    26169 been removed. 
    26170  
    26171 @item 
    26172 Support for non-@acronym{ASCII} domain names 
    26173  
    26174 Message supports non-@acronym{ASCII} domain names in From:, To: and 
    26175 Cc: and will query you whether to perform encoding when you try to 
    26176 send a message.  The variable @code{message-use-idna} controls this. 
    26177 Gnus will also decode non-@acronym{ASCII} domain names in From:, To: 
    26178 and Cc: when you view a message.  The variable @code{gnus-use-idna} 
    26179 controls this. 
    26180  
    26181 @item 
    26182 Better handling of Microsoft citation styles 
    26183  
    26184 Gnus now tries to recognize the mangled header block that some Microsoft 
    26185 mailers use to indicate that the rest of the message is a citation, even 
    26186 though it is not quoted in any way.  The variable 
    26187 @code{gnus-cite-unsightly-citation-regexp} matches the start of these 
    26188 citations. 
    26189  
    26190 @item 
    26191 @code{gnus-article-skip-boring} 
    26192  
    26193 If you set @code{gnus-article-skip-boring} to @code{t}, then Gnus will 
    26194 not scroll down to show you a page that contains only boring text, 
    26195 which by default means cited text and signature.  You can customize 
    26196 what is skippable using @code{gnus-article-boring-faces}. 
    26197  
    26198 This feature is especially useful if you read many articles that 
    26199 consist of a little new content at the top with a long, untrimmed 
    26200 message cited below. 
    26201  
    26202 @item 
    26203 The format spec @code{%C} for positioning point has changed to @code{%*}. 
     26064The new @file{make.bat} makes @file{make-x.bat} and @file{xemacs.mak} 
     26065superfluous, so they have been removed. 
     26066 
     26067@item 
     26068@file{~/News/overview/} not used. 
     26069 
     26070As a result of the following change, the @file{~/News/overview/} 
     26071directory is not used any more.  You can safely delete the entire 
     26072hierarchy. 
     26073 
     26074@c FIXME: `gnus-load' is mentioned in README, which is not included in 
     26075@c CVS.  We should find a better place for this item. 
     26076@item 
     26077@code{(require 'gnus-load)} 
     26078 
     26079If you use a stand-alone Gnus distribution, you'd better add 
     26080@code{(require 'gnus-load)} into your @file{~/.emacs} after adding the Gnus 
     26081lisp directory into load-path. 
     26082 
     26083File @file{gnus-load.el} contains autoload commands, functions and variables, 
     26084some of which may not be included in distributions of Emacsen. 
     26085 
     26086@end itemize 
     26087 
     26088@item New packages and libraries within Gnus 
     26089@c ***************************************** 
     26090 
     26091@itemize @bullet 
     26092 
     26093@item 
     26094The revised Gnus @acronym{FAQ} is included in the manual, 
     26095@xref{Frequently Asked Questions}. 
     26096 
     26097@item 
     26098@acronym{TLS} wrapper shipped with Gnus 
     26099 
     26100@acronym{TLS}/@acronym{SSL} is now supported in @acronym{IMAP} and 
     26101@acronym{NNTP} via @file{tls.el} and GNUTLS.  The old 
     26102@acronym{TLS}/@acronym{SSL} support via (external third party) 
     26103@file{ssl.el} and OpenSSL still works. 
     26104 
     26105@item 
     26106Improved anti-spam features. 
     26107 
     26108Gnus is now able to take out spam from your mail and news streams 
     26109using a wide variety of programs and filter rules.  Among the supported 
     26110methods are RBL blocklists, bogofilter and white/blacklists.  Hooks 
     26111for easy use of external packages such as SpamAssassin and Hashcash 
     26112are also new.  @xref{Thwarting Email Spam}. 
     26113@c FIXME: @xref{Spam Package}?.  Should this be under Misc? 
     26114 
     26115@item 
     26116Gnus supports server-side mail filtering using Sieve. 
     26117 
     26118Sieve rules can be added as Group Parameters for groups, and the 
     26119complete Sieve script is generated using @kbd{D g} from the Group 
     26120buffer, and then uploaded to the server using @kbd{C-c C-l} in the 
     26121generated Sieve buffer.  @xref{Sieve Commands}, and the new Sieve 
     26122manual @ref{Top, , Top, sieve, Emacs Sieve}. 
     26123 
     26124@end itemize 
     26125 
     26126@item Changes in group mode 
     26127@c ************************ 
     26128 
     26129@itemize @bullet 
     26130 
     26131@item 
     26132@code{gnus-group-read-ephemeral-group} can be called interactively, 
     26133using @kbd{G M}. 
     26134 
     26135@item 
     26136Retrieval of charters and control messages 
     26137 
     26138There are new commands for fetching newsgroup charters (@kbd{H c}) and 
     26139control messages (@kbd{H C}). 
    2620426140 
    2620526141@item 
     
    2622226158 
    2622326159@item 
    26224 Smileys (@samp{:-)}, @samp{;-)} etc) are now iconized for Emacs too. 
     26160Unread count correct in nnimap groups. 
     26161 
     26162The estimated number of unread articles in the group buffer should now 
     26163be correct for nnimap groups.  This is achieved by calling 
     26164@code{nnimap-fixup-unread-after-getting-new-news} from the 
     26165@code{gnus-setup-news-hook} (called on startup) and 
     26166@code{gnus-after-getting-new-news-hook}. (called after getting new 
     26167mail).  If you have modified those variables from the default, you may 
     26168want to add @code{nnimap-fixup-unread-after-getting-new-news} again.  If 
     26169you were happy with the estimate and want to save some (minimal) time 
     26170when getting new mail, remove the function. 
     26171 
     26172@item 
     26173Group names are treated as UTF-8 by default. 
     26174 
     26175This is supposedly what USEFOR wanted to migrate to.  See 
     26176@code{gnus-group-name-charset-group-alist} and 
     26177@code{gnus-group-name-charset-method-alist} for customization. 
     26178 
     26179@item 
     26180@code{gnus-group-charset-alist} and 
     26181@code{gnus-group-ignored-charsets-alist}. 
     26182 
     26183The regexps in these variables are compared with full group names 
     26184instead of real group names in 5.8.  Users who customize these 
     26185variables should change those regexps accordingly.  For example: 
     26186@lisp 
     26187("^han\\>" euc-kr) -> ("\\(^\\|:\\)han\\>" euc-kr) 
     26188@end lisp 
     26189 
     26190@end itemize 
     26191 
     26192@item Changes in summary and article mode 
     26193@c ************************************** 
     26194 
     26195@itemize @bullet 
     26196 
     26197@item 
     26198@kbd{F} (@code{gnus-article-followup-with-original}) and @kbd{R} 
     26199(@code{gnus-article-reply-with-original}) only yank the text in the 
     26200region if the region is active. 
     26201 
     26202@item 
     26203In draft groups, @kbd{e} is now bound to @code{gnus-draft-edit-message}. 
     26204Use @kbd{B w} for @code{gnus-summary-edit-article} instead. 
     26205 
     26206@item 
     26207Article Buttons 
     26208 
     26209More buttons for URLs, mail addresses, Message-IDs, Info links, man 
     26210pages and Emacs or Gnus related references.  @xref{Article Buttons}.  The 
     26211variables @code{gnus-button-@var{*}-level} can be used to control the 
     26212appearance of all article buttons.  @xref{Article Button Levels}. 
     26213 
     26214@item 
     26215Single-part yenc encoded attachments can be decoded. 
     26216 
     26217@item 
     26218Picons 
     26219 
     26220The picons code has been reimplemented to work in GNU Emacs---some of 
     26221the previous options have been removed or renamed. 
     26222 
     26223Picons are small ``personal icons'' representing users, domain and 
     26224newsgroups, which can be displayed in the Article buffer. 
     26225@xref{Picons}. 
     26226 
     26227@item 
     26228If the new option @code{gnus-treat-body-boundary} is non-@code{nil}, a 
     26229boundary line is drawn at the end of the headers. 
     26230 
     26231@item 
     26232Signed article headers (X-PGP-Sig) can be verified with @kbd{W p}. 
     26233 
     26234@item 
     26235The Summary Buffer uses an arrow in the fringe to indicate the current 
     26236article.  Use @code{(setq gnus-summary-display-arrow nil)} to disable it. 
     26237 
     26238@item 
     26239Warn about email replies to news 
     26240 
     26241Do you often find yourself replying to news by email by mistake?  Then 
     26242the new option @code{gnus-confirm-mail-reply-to-news} is just the thing for 
     26243you. 
     26244 
     26245@item 
     26246If the new option @code{gnus-summary-display-while-building} is 
     26247non-@code{nil}, the summary buffer is shown and updated as it's being 
     26248built. 
     26249 
     26250@item 
     26251The new @code{recent} mark @samp{.} indicates newly arrived messages (as 
     26252opposed to old but unread messages). 
     26253 
     26254@item 
     26255Gnus supports RFC 2369 mailing list headers, and adds a number of 
     26256related commands in mailing list groups.  @xref{Mailing List}. 
     26257 
     26258@item 
     26259The Date header can be displayed in a format that can be read aloud 
     26260in English.  @xref{Article Date}. 
     26261 
     26262@item 
     26263diffs are automatically highlighted in groups matching 
     26264@code{mm-uu-diff-groups-regexp} 
     26265 
     26266@item 
     26267Better handling of Microsoft citation styles 
     26268 
     26269Gnus now tries to recognize the mangled header block that some Microsoft 
     26270mailers use to indicate that the rest of the message is a citation, even 
     26271though it is not quoted in any way.  The variable 
     26272@code{gnus-cite-unsightly-citation-regexp} matches the start of these 
     26273citations. 
     26274 
     26275The new command @kbd{W Y f} 
     26276(@code{gnus-article-outlook-deuglify-article}) allows deuglifying broken 
     26277Outlook (Express) articles. 
     26278 
     26279@item 
     26280@code{gnus-article-skip-boring} 
     26281 
     26282If you set @code{gnus-article-skip-boring} to @code{t}, then Gnus will 
     26283not scroll down to show you a page that contains only boring text, 
     26284which by default means cited text and signature.  You can customize 
     26285what is skippable using @code{gnus-article-boring-faces}. 
     26286 
     26287This feature is especially useful if you read many articles that 
     26288consist of a little new content at the top with a long, untrimmed 
     26289message cited below. 
     26290 
     26291@item 
     26292Smileys (@samp{:-)}, @samp{;-)} etc) are now displayed graphically in 
     26293Emacs too. 
    2622526294 
    2622626295Put @code{(setq gnus-treat-display-smileys nil)} in @file{~/.gnus.el} to 
    2622726296disable it. 
     26297 
     26298@item 
     26299Face headers handling.  @xref{Face}. 
     26300 
     26301@item 
     26302In the summary buffer, the new command @kbd{/ N} inserts new messages 
     26303and @kbd{/ o} inserts old messages. 
     26304 
     26305@item 
     26306Gnus decodes morse encoded messages if you press @kbd{W m}. 
     26307 
     26308@item 
     26309@code{gnus-summary-line-format} 
     26310 
     26311The default value changed to @samp{%U%R%z%I%(%[%4L: %-23,23f%]%) 
     26312%s\n}.  Moreover @code{gnus-extra-headers}, 
     26313@code{nnmail-extra-headers} and @code{gnus-ignored-from-addresses} 
     26314changed their default so that the users name will be replaced by the 
     26315recipient's name or the group name posting to for @acronym{NNTP} 
     26316groups. 
     26317 
     26318@item 
     26319Deleting of attachments. 
     26320 
     26321The command @code{gnus-mime-save-part-and-strip} (bound to @kbd{C-o} 
     26322on @acronym{MIME} buttons) saves a part and replaces the part with an 
     26323external one.  @code{gnus-mime-delete-part} (bound to @kbd{d} on 
     26324@acronym{MIME} buttons) removes a part.  It works only on back ends 
     26325that support editing. 
     26326 
     26327@item 
     26328@code{gnus-default-charset} 
     26329 
     26330The default value is determined from the 
     26331@code{current-language-environment} variable, instead of 
     26332@code{iso-8859-1}.  Also the @samp{.*} item in 
     26333@code{gnus-group-charset-alist} is removed. 
     26334 
     26335@item 
     26336Printing capabilities are enhanced. 
     26337 
     26338Gnus supports Muttprint natively with @kbd{O P} from the Summary and 
     26339Article buffers.  Also, each individual @acronym{MIME} part can be 
     26340printed using @kbd{p} on the @acronym{MIME} button. 
     26341 
     26342@item 
     26343Extended format specs. 
     26344 
     26345Format spec @samp{%&user-date;} is added into 
     26346@code{gnus-summary-line-format-alist}.  Also, user defined extended 
     26347format specs are supported.  The extended format specs look like 
     26348@samp{%u&foo;}, which invokes function 
     26349@code{gnus-user-format-function-@var{foo}}.  Because @samp{&} is used as the 
     26350escape character, old user defined format @samp{%u&} is no longer supported. 
     26351 
     26352@item 
     26353@kbd{/ *} (@code{gnus-summary-limit-include-cached}) is rewritten. 
     26354@c FIXME: Was this a user-visible change? 
     26355 
     26356It was aliased to @kbd{Y c} 
     26357(@code{gnus-summary-insert-cached-articles}).  The new function filters 
     26358out other articles. 
     26359 
     26360@item 
     26361Some limiting commands accept a @kbd{C-u} prefix to negate the match. 
     26362 
     26363If @kbd{C-u} is used on subject, author or extra headers, i.e., @kbd{/ 
     26364s}, @kbd{/ a}, and @kbd{/ x} 
     26365(@code{gnus-summary-limit-to-@{subject,author,extra@}}) respectively, the 
     26366result will be to display all articles that do not match the expression. 
     26367 
     26368@item 
     26369Gnus inlines external parts (message/external). 
     26370 
     26371@end itemize 
     26372 
     26373@item Changes in Message mode and related Gnus features 
     26374@c **************************************************** 
     26375 
     26376@itemize @bullet 
     26377 
     26378@item 
     26379Delayed articles 
     26380 
     26381You can delay the sending of a message with @kbd{C-c C-j} in the Message 
     26382buffer.  The messages are delivered at specified time.  This is useful 
     26383for sending yourself reminders.  @xref{Delayed Articles}. 
     26384 
     26385@item 
     26386If the new option @code{nnml-use-compressed-files} is non-@code{nil}, 
     26387the nnml back end allows compressed message files. 
     26388 
     26389@item 
     26390The new option @code{gnus-gcc-mark-as-read} automatically marks 
     26391Gcc articles as read. 
     26392 
     26393@item 
     26394Externalizing of attachments 
     26395 
     26396If @code{gnus-gcc-externalize-attachments} or 
     26397@code{message-fcc-externalize-attachments} is non-@code{nil}, attach 
     26398local files as external parts. 
     26399 
     26400@item 
     26401The envelope sender address can be customized when using Sendmail. 
     26402@xref{Mail Variables, Mail Variables,, message, Message Manual}. 
    2622826403 
    2622926404@item 
     
    2625626431 
    2625726432@item 
    26258 Improved anti-spam features. 
    26259  
    26260 Gnus is now able to take out spam from your mail and news streams 
    26261 using a wide variety of programs and filter rules.  Among the supported 
    26262 methods are RBL blocklists, bogofilter and white/blacklists.  Hooks 
    26263 for easy use of external packages such as SpamAssassin and Hashcash 
    26264 are also new.  @xref{Thwarting Email Spam}. 
    26265  
    26266 @item 
    26267 Easy inclusion of X-Faces headers. 
    26268  
    26269 @item 
    26270 Face headers handling. 
    26271  
    26272 @item 
    26273 In the summary buffer, the new command @kbd{/ N} inserts new messages 
    26274 and @kbd{/ o} inserts old messages. 
    26275  
    26276 @item 
    26277 Gnus decodes morse encoded messages if you press @kbd{W m}. 
    26278  
    26279 @item 
    26280 Unread count correct in nnimap groups. 
    26281  
    26282 The estimated number of unread articles in the group buffer should now 
    26283 be correct for nnimap groups.  This is achieved by calling 
    26284 @code{nnimap-fixup-unread-after-getting-new-news} from the 
    26285 @code{gnus-setup-news-hook} (called on startup) and 
    26286 @code{gnus-after-getting-new-news-hook}. (called after getting new 
    26287 mail).  If you have modified those variables from the default, you may 
    26288 want to add @code{nnimap-fixup-unread-after-getting-new-news} again.  If 
    26289 you were happy with the estimate and want to save some (minimal) time 
    26290 when getting new mail, remove the function. 
     26433Easy inclusion of X-Faces headers.  @xref{X-Face}. 
    2629126434 
    2629226435@item 
     
    2630526448 
    2630626449@item 
    26307 @file{~/News/overview/} not used. 
    26308  
    26309 As a result of the following change, the @file{~/News/overview/} 
    26310 directory is not used any more.  You can safely delete the entire 
    26311 hierarchy. 
     26450@code{message-insinuate-rmail} 
     26451 
     26452Adding @code{(message-insinuate-rmail)} and @code{(setq 
     26453mail-user-agent 'gnus-user-agent)} in @file{.emacs} convinces Rmail to 
     26454compose, reply and forward messages in message-mode, where you can 
     26455enjoy the power of @acronym{MML}. 
     26456 
     26457@item 
     26458@code{message-minibuffer-local-map} 
     26459 
     26460The line below enables BBDB in resending a message: 
     26461@lisp 
     26462(define-key message-minibuffer-local-map [(tab)] 
     26463  'bbdb-complete-name) 
     26464@end lisp 
     26465 
     26466@item 
     26467@code{gnus-posting-styles} 
     26468 
     26469Add a new format of match like 
     26470@lisp 
     26471((header "to" "larsi.*org") 
     26472 (Organization "Somewhere, Inc.")) 
     26473@end lisp 
     26474The old format like the lines below is obsolete, but still accepted. 
     26475@lisp 
     26476(header "to" "larsi.*org" 
     26477        (Organization "Somewhere, Inc.")) 
     26478@end lisp 
     26479 
     26480@item 
     26481@code{message-ignored-news-headers} and @code{message-ignored-mail-headers} 
     26482 
     26483@samp{X-Draft-From} and @samp{X-Gnus-Agent-Meta-Information} have been 
     26484added into these two variables.  If you customized those, perhaps you 
     26485need add those two headers too. 
     26486 
     26487@item 
     26488Gnus supports the ``format=flowed'' (RFC 2646) parameter.  On 
     26489composing messages, it is enabled by @code{use-hard-newlines}. 
     26490Decoding format=flowed was present but not documented in earlier 
     26491versions. 
     26492 
     26493@item 
     26494The option @code{mm-fill-flowed} can be used to disable treatment of 
     26495``format=flowed'' messages.  Also, flowed text is disabled when sending 
     26496inline PGP signed messages.  (New in Gnus 5.10.7) 
     26497 
     26498@item 
     26499Gnus supports the generation of RFC 2298 Disposition Notification requests. 
     26500 
     26501This is invoked with the @kbd{C-c M-n} key binding from message mode. 
     26502 
     26503@item 
     26504Message supports the Importance: (RFC 2156) header. 
     26505 
     26506In the message buffer, @kbd{C-c C-f C-i} or @kbd{C-c C-u} cycles through 
     26507the valid values. 
     26508 
     26509@item 
     26510Gnus supports Cancel Locks in News. 
     26511 
     26512This means a header @samp{Cancel-Lock} is inserted in news posting.  It is 
     26513used to determine if you wrote an article or not (for canceling and 
     26514superseding).  Gnus generates a random password string the first time 
     26515you post a message, and saves it in your @file{~/.emacs} using the Custom 
     26516system.  While the variable is called @code{canlock-password}, it is not 
     26517security sensitive data.  Publishing your canlock string on the web 
     26518will not allow anyone to be able to anything she could not already do. 
     26519The behavior can be changed by customizing @code{message-insert-canlock}. 
     26520 
     26521@item 
     26522Gnus supports @acronym{PGP} (RFC 1991/2440), @acronym{PGP/MIME} (RFC 
     265232015/3156) and @acronym{S/MIME} (RFC 2630-2633). 
     26524 
     26525It needs an external @acronym{S/MIME} and OpenPGP implementation, but no 
     26526additional Lisp libraries.  This add several menu items to the 
     26527Attachments menu, and @kbd{C-c RET} key bindings, when composing 
     26528messages.  This also obsoletes @code{gnus-article-hide-pgp-hook}. 
     26529 
     26530@item 
     26531@acronym{MML} (Mime compose) prefix changed from @kbd{M-m} to @kbd{C-c 
     26532C-m}. 
     26533 
     26534This change was made to avoid conflict with the standard binding of 
     26535@code{back-to-indentation}, which is also useful in message mode. 
     26536 
     26537@item 
     26538The default for @code{message-forward-show-mml} changed to the symbol 
     26539@code{best}. 
     26540 
     26541The behavior for the @code{best} value is to show @acronym{MML} (i.e., 
     26542convert to @acronym{MIME}) when appropriate.  @acronym{MML} will not be 
     26543used when forwarding signed or encrypted messages, as the conversion 
     26544invalidate the digital signature. 
     26545 
     26546@item 
     26547If @code{auto-compression-mode} is enabled, attachments are automatically 
     26548decompressed when activated. 
     26549@c FIXME: Does this affect article or message mode? 
     26550 
     26551@item 
     26552Support for non-@acronym{ASCII} domain names 
     26553 
     26554Message supports non-@acronym{ASCII} domain names in From:, To: and 
     26555Cc: and will query you whether to perform encoding when you try to 
     26556send a message.  The variable @code{message-use-idna} controls this. 
     26557Gnus will also decode non-@acronym{ASCII} domain names in From:, To: 
     26558and Cc: when you view a message.  The variable @code{gnus-use-idna} 
     26559controls this. 
     26560 
     26561@item You can now drag and drop attachments to the Message buffer. 
     26562See @code{mml-dnd-protocol-alist} and @code{mml-dnd-attach-options}. 
     26563@xref{MIME, ,MIME, message, Message Manual}. 
     26564@c New in 5.10.9 / 5.11 
     26565 
     26566@end itemize 
     26567 
     26568@item Changes in back ends 
     26569@c *********************** 
     26570 
     26571@itemize @bullet 
     26572@item 
     26573Gnus can display RSS newsfeeds as a newsgroup.  @xref{RSS}. 
     26574 
     26575@item 
     26576The nndoc back end now supports mailman digests and exim bounces. 
     26577 
     26578@item 
     26579Gnus supports Maildir groups. 
     26580 
     26581Gnus includes a new back end @file{nnmaildir.el}.  @xref{Maildir}. 
     26582 
     26583@item 
     26584The nnml and nnfolder back ends store marks for each groups. 
     26585 
     26586This makes it possible to take backup of nnml/nnfolder servers/groups 
     26587separately of @file{~/.newsrc.eld}, while preserving marks.  It also 
     26588makes it possible to share articles and marks between users (without 
     26589sharing the @file{~/.newsrc.eld} file) within e.g. a department.  It 
     26590works by storing the marks stored in @file{~/.newsrc.eld} in a per-group 
     26591file @file{.marks} (for nnml) and @file{@var{groupname}.mrk} (for 
     26592nnfolder, named @var{groupname}).  If the nnml/nnfolder is moved to 
     26593another machine, Gnus will automatically use the @file{.marks} or 
     26594@file{.mrk} file instead of the information in @file{~/.newsrc.eld}. 
     26595The new server variables @code{nnml-marks-is-evil} and 
     26596@code{nnfolder-marks-is-evil} can be used to disable this feature. 
     26597 
     26598@end itemize 
     26599 
     26600@item Appearance 
     26601@c ************* 
     26602 
     26603@itemize @bullet 
     26604 
     26605@item 
     26606The menu bar item (in Group and Summary buffer) named ``Misc'' has 
     26607been renamed to ``Gnus''. 
     26608 
     26609@item 
     26610The menu bar item (in Message mode) named ``@acronym{MML}'' has been 
     26611renamed to ``Attachments''.  Note that this menu also contains security 
     26612related stuff, like signing and encryption (@pxref{Security, Security,, 
     26613message, Message Manual}). 
     26614 
     26615@item 
     26616The tool bars have been updated to use GNOME icons in Group, Summary and 
     26617Message mode.  You can also customize the tool bars.  This is a new 
     26618feature in Gnus 5.10.9.  (Only for Emacs, not in XEmacs.) 
     26619 
     26620@item The tool bar icons are now (de)activated correctly 
     26621in the group buffer, see the variable @code{gnus-group-update-tool-bar}. 
     26622Its default value depends on your Emacs version.  This is a new feature 
     26623in Gnus 5.10.9. 
     26624@end itemize 
     26625 
     26626 
     26627@item Miscellaneous changes 
     26628@c ************************ 
     26629 
     26630@itemize @bullet 
    2631226631 
    2631326632@item 
     
    2633026649 
    2633126650@item 
    26332 @code{gnus-summary-line-format} 
    26333  
    26334 The default value changed to @samp{%U%R%z%I%(%[%4L: %-23,23f%]%) 
    26335 %s\n}.  Moreover @code{gnus-extra-headers}, 
    26336 @code{nnmail-extra-headers} and @code{gnus-ignored-from-addresses} 
    26337 changed their default so that the users name will be replaced by the 
    26338 recipient's name or the group name posting to for @acronym{NNTP} 
    26339 groups. 
    26340  
    26341 @item 
    26342 @file{deuglify.el} (@code{gnus-article-outlook-deuglify-article}) 
    26343  
    26344 A new file from Raymond Scholz @email{rscholz@@zonix.de} for deuglifying 
    26345 broken Outlook (Express) articles. 
    26346  
    26347 @c FIXME: `gnus-load' is mentioned in README, which is not included in 
    26348 @c CVS.  We should find a better place for this item. 
    26349 @item 
    26350 @code{(require 'gnus-load)} 
    26351  
    26352 If you use a stand-alone Gnus distribution, you'd better add 
    26353 @code{(require 'gnus-load)} into your @file{~/.emacs} after adding the Gnus 
    26354 lisp directory into load-path. 
    26355  
    26356 File @file{gnus-load.el} contains autoload commands, functions and variables, 
    26357 some of which may not be included in distributions of Emacsen. 
    26358  
    26359 @item 
    26360 @code{gnus-slave-unplugged} 
    26361  
    26362 A new command which starts Gnus offline in slave mode. 
    26363  
    26364 @item 
    26365 @code{message-insinuate-rmail} 
    26366  
    26367 Adding @code{(message-insinuate-rmail)} and @code{(setq 
    26368 mail-user-agent 'gnus-user-agent)} in @file{.emacs} convinces Rmail to 
    26369 compose, reply and forward messages in message-mode, where you can 
    26370 enjoy the power of @acronym{MML}. 
    26371  
    26372 @item 
    26373 @code{message-minibuffer-local-map} 
    26374  
    26375 The line below enables BBDB in resending a message: 
    26376 @lisp 
    26377 (define-key message-minibuffer-local-map [(tab)] 
    26378   'bbdb-complete-name) 
    26379 @end lisp 
    26380  
    26381 @item 
    26382 Externalizing and deleting of attachments. 
    26383  
    26384 If @code{gnus-gcc-externalize-attachments} or 
    26385 @code{message-fcc-externalize-attachments} is non-@code{nil}, attach 
    26386 local files as external parts. 
    26387  
    26388 The command @code{gnus-mime-save-part-and-strip} (bound to @kbd{C-o} 
    26389 on @acronym{MIME} buttons) saves a part and replaces the part with an 
    26390 external one.  @code{gnus-mime-delete-part} (bound to @kbd{d} on 
    26391 @acronym{MIME} buttons) removes a part.  It works only on back ends 
    26392 that support editing. 
    26393  
    26394 @item 
    26395 @code{gnus-default-charset} 
    26396  
    26397 The default value is determined from the 
    26398 @code{current-language-environment} variable, instead of 
    26399 @code{iso-8859-1}.  Also the @samp{.*} item in 
    26400 @code{gnus-group-charset-alist} is removed. 
    26401  
    26402 @item 
    26403 @code{gnus-posting-styles} 
    26404  
    26405 Add a new format of match like 
    26406 @lisp 
    26407 ((header "to" "larsi.*org") 
    26408  (Organization "Somewhere, Inc.")) 
    26409 @end lisp 
    26410 The old format like the lines below is obsolete, but still accepted. 
    26411 @lisp 
    26412 (header "to" "larsi.*org" 
    26413         (Organization "Somewhere, Inc.")) 
    26414 @end lisp 
    26415  
    26416 @item 
    26417 @code{message-ignored-news-headers} and @code{message-ignored-mail-headers} 
    26418  
    26419 @samp{X-Draft-From} and @samp{X-Gnus-Agent-Meta-Information} have been 
    26420 added into these two variables.  If you customized those, perhaps you 
    26421 need add those two headers too. 
    26422  
    26423 @item 
    2642426651Gnus reads the @acronym{NOV} and articles in the Agent if plugged. 
    2642526652 
     
    2642926656 
    2643026657@item 
    26431 Gnus supports the ``format=flowed'' (RFC 2646) parameter.  On 
    26432 composing messages, it is enabled by @code{use-hard-newlines}. 
    26433 Decoding format=flowed was present but not documented in earlier 
    26434 versions. 
    26435  
    26436 @item 
    26437 The option @code{mm-fill-flowed} can be used to disable treatment of 
    26438 ``format=flowed'' messages.  Also, flowed text is disabled when sending 
    26439 inline PGP signed messages.  (New in Gnus 5.10.7) 
    26440  
    26441 @item 
    26442 Gnus supports the generation of RFC 2298 Disposition Notification requests. 
    26443  
    26444 This is invoked with the @kbd{C-c M-n} key binding from message mode. 
    26445  
    26446 @item 
    26447 Gnus supports Maildir groups. 
    26448  
    26449 Gnus includes a new back end @file{nnmaildir.el}.  @xref{Maildir}. 
    26450  
    26451 @item 
    26452 Printing capabilities are enhanced. 
    26453  
    26454 Gnus supports Muttprint natively with @kbd{O P} from the Summary and 
    26455 Article buffers.  Also, each individual @acronym{MIME} part can be 
    26456 printed using @kbd{p} on the @acronym{MIME} button. 
    26457  
    26458 @item 
    26459 Message supports the Importance: (RFC 2156) header. 
    26460  
    26461 In the message buffer, @kbd{C-c C-f C-i} or @kbd{C-c C-u} cycles through 
    26462 the valid values. 
    26463  
    26464 @item 
    26465 Gnus supports Cancel Locks in News. 
    26466  
    26467 This means a header @samp{Cancel-Lock} is inserted in news posting.  It is 
    26468 used to determine if you wrote an article or not (for canceling and 
    26469 superseding).  Gnus generates a random password string the first time 
    26470 you post a message, and saves it in your @file{~/.emacs} using the Custom 
    26471 system.  While the variable is called @code{canlock-password}, it is not 
    26472 security sensitive data.  Publishing your canlock string on the web 
    26473 will not allow anyone to be able to anything she could not already do. 
    26474 The behavior can be changed by customizing @code{message-insert-canlock}. 
    26475  
    26476 @item 
    26477 Gnus supports server-side mail filtering using Sieve. 
    26478  
    26479 Sieve rules can be added as Group Parameters for groups, and the 
    26480 complete Sieve script is generated using @kbd{D g} from the Group 
    26481 buffer, and then uploaded to the server using @kbd{C-c C-l} in the 
    26482 generated Sieve buffer.  @xref{Sieve Commands}, and the new Sieve 
    26483 manual @ref{Top, , Top, sieve, Emacs Sieve}. 
    26484  
    26485 @item 
    26486 Extended format specs. 
    26487  
    26488 Format spec @samp{%&user-date;} is added into 
    26489 @code{gnus-summary-line-format-alist}.  Also, user defined extended 
    26490 format specs are supported.  The extended format specs look like 
    26491 @samp{%u&foo;}, which invokes function 
    26492 @code{gnus-user-format-function-@var{foo}}.  Because @samp{&} is used as the 
    26493 escape character, old user defined format @samp{%u&} is no longer supported. 
    26494  
    26495 @item 
    26496 @kbd{/ *} (@code{gnus-summary-limit-include-cached}) is rewritten. 
    26497  
    26498 It was aliased to @kbd{Y c} 
    26499 (@code{gnus-summary-insert-cached-articles}).  The new function filters 
    26500 out other articles. 
    26501  
    26502 @item 
    26503 Some limiting commands accept a @kbd{C-u} prefix to negate the match. 
    26504  
    26505 If @kbd{C-u} is used on subject, author or extra headers, i.e., @kbd{/ 
    26506 s}, @kbd{/ a}, and @kbd{/ x} 
    26507 (@code{gnus-summary-limit-to-@{subject,author,extra@}}) respectively, the 
    26508 result will be to display all articles that do not match the expression. 
    26509  
    26510 @item 
    26511 Group names are treated as UTF-8 by default. 
    26512  
    26513 This is supposedly what USEFOR wanted to migrate to.  See 
    26514 @code{gnus-group-name-charset-group-alist} and 
    26515 @code{gnus-group-name-charset-method-alist} for customization. 
    26516  
    26517 @item 
    26518 The nnml and nnfolder back ends store marks for each groups. 
    26519  
    26520 This makes it possible to take backup of nnml/nnfolder servers/groups 
    26521 separately of @file{~/.newsrc.eld}, while preserving marks.  It also 
    26522 makes it possible to share articles and marks between users (without 
    26523 sharing the @file{~/.newsrc.eld} file) within e.g. a department.  It 
    26524 works by storing the marks stored in @file{~/.newsrc.eld} in a per-group 
    26525 file @file{.marks} (for nnml) and @file{@var{groupname}.mrk} (for 
    26526 nnfolder, named @var{groupname}).  If the nnml/nnfolder is moved to 
    26527 another machine, Gnus will automatically use the @file{.marks} or 
    26528 @file{.mrk} file instead of the information in @file{~/.newsrc.eld}. 
    26529 The new server variables @code{nnml-marks-is-evil} and 
    26530 @code{nnfolder-marks-is-evil} can be used to disable this feature. 
    26531  
    26532 @item 
    26533 The menu bar item (in Group and Summary buffer) named ``Misc'' has 
    26534 been renamed to ``Gnus''. 
    26535  
    26536 @item 
    26537 The menu bar item (in Message mode) named ``@acronym{MML}'' has been 
    26538 renamed to ``Attachments''.  Note that this menu also contains security 
    26539 related stuff, like signing and encryption (@pxref{Security, Security,, 
    26540 message, Message Manual}). 
    26541  
    26542 @item 
    26543 @code{gnus-group-charset-alist} and 
    26544 @code{gnus-group-ignored-charsets-alist}. 
    26545  
    26546 The regexps in these variables are compared with full group names 
    26547 instead of real group names in 5.8.  Users who customize these 
    26548 variables should change those regexps accordingly.  For example: 
    26549 @lisp 
    26550 ("^han\\>" euc-kr) -> ("\\(^\\|:\\)han\\>" euc-kr) 
    26551 @end lisp 
    26552  
    26553 @item 
    26554 Gnus supports @acronym{PGP} (RFC 1991/2440), @acronym{PGP/MIME} (RFC 
    26555 2015/3156) and @acronym{S/MIME} (RFC 2630-2633). 
    26556  
    26557 It needs an external @acronym{S/MIME} and OpenPGP implementation, but no 
    26558 additional Lisp libraries.  This add several menu items to the 
    26559 Attachments menu, and @kbd{C-c RET} key bindings, when composing 
    26560 messages.  This also obsoletes @code{gnus-article-hide-pgp-hook}. 
    26561  
    26562 @item 
    26563 Gnus inlines external parts (message/external). 
    26564  
    26565 @item 
    26566 @acronym{MML} (Mime compose) prefix changed from @kbd{M-m} to @kbd{C-c 
    26567 C-m}. 
    26568  
    26569 This change was made to avoid conflict with the standard binding of 
    26570 @code{back-to-indentation}, which is also useful in message mode. 
    26571  
    26572 @item 
    26573 The default for @code{message-forward-show-mml} changed to symbol @code{best}. 
    26574  
    26575 The behavior for the @code{best} value is to show @acronym{MML} (i.e., 
    26576 convert to @acronym{MIME}) when appropriate.  @acronym{MML} will not be 
    26577 used when forwarding signed or encrypted messages, as the conversion 
    26578 invalidate the digital signature. 
     26658Dired integration 
     26659 
     26660@code{gnus-dired-minor-mode} (see @ref{Other modes}) installs key 
     26661bindings in dired buffers to send a file as an attachment, open a file 
     26662using the appropriate mailcap entry, and print a file using the mailcap 
     26663entry. 
     26664 
     26665@item 
     26666The format spec @code{%C} for positioning point has changed to @code{%*}. 
     26667 
     26668@item 
     26669@code{gnus-slave-unplugged} 
     26670 
     26671A new command which starts Gnus offline in slave mode. 
     26672 
     26673@end itemize 
     26674 
    2657926675@end itemize 
    2658026676