Markup and formatting improvements.
authorJesper Harder <harder@ifa.au.dk>
Wed, 30 Apr 2003 23:31:31 +0000 (23:31 +0000)
committerJesper Harder <harder@ifa.au.dk>
Wed, 30 Apr 2003 23:31:31 +0000 (23:31 +0000)
texi/ChangeLog
texi/gnus.texi

index 5abc72f..4adfa0c 100644 (file)
@@ -1,3 +1,7 @@
+2003-05-01  Jesper Harder  <harder@ifa.au.dk>
+
+       * gnus.texi: Markup and formatting improvements.
+
 2003-04-30  Reiner Steib  <Reiner.Steib@gmx.de>
 
        * gnus.texi (Top, Appendices): Fixed Gnus FAQ entry.
index 67392f3..0d11ee5 100644 (file)
@@ -6044,6 +6044,7 @@ article, you could say something like:
 @end group
 @end lisp
 
+@noindent
 or
 
 @lisp
@@ -19997,10 +19998,12 @@ Let's say you want to increase the score of articles written by Lars
 when he's talking about Gnus:
 
 @example
+@group
 ((&
   ("from" "Lars Ingebrigtsen")
   ("subject" "Gnus"))
  1000)
+@end group
 @end example
 
 Quite simple, huh?
@@ -23165,8 +23168,10 @@ For instance, if @samp{:} is invalid as a file character in file names
 on your system (you OS/2 user you), you could say something like:
 
 @lisp
+@group
 (setq nnheader-file-name-translation-alist
       '((?: . ?_)))
+@end group
 @end lisp
 
 In fact, this is the default value for this variable on OS/2 and MS
@@ -24655,14 +24660,15 @@ Gnus can now read @acronym{IMAP} mail via @code{nnimap}.
 
 @node Oort Gnus
 @subsubsection Oort Gnus
+@cindex Oort
 
 New features in Gnus 5.10:
 
 @itemize @bullet
 
 @item
-The revised Gnus FAQ is included in the manual, @xref{Frequently Asked
-Questions}.
+The revised Gnus @acronym{FAQ} is included in the manual,
+@xref{Frequently Asked Questions}.
 
 @item
 Upgrading from previous (stable) version if you have used Oort.
@@ -24696,8 +24702,7 @@ mailcap entry (@kbd{C-c C-f}), and print a file using the mailcap entry
 @end lisp
 
 @item
-Gnus can display RSS newsfeeds as a newsgroup.  To get started do @kbd{B
-nnrss RET RET} in the Group buffer.
+Gnus can display RSS newsfeeds as a newsgroup.  @xref{RSS}.
 
 @item
 Single-part yenc encoded attachments can be decoded.
@@ -24708,11 +24713,9 @@ Picons
 The picons code has been reimplemented to work in GNU Emacs -- some of
 the previous options have been removed or renamed.
 
-Picons are small "personal icons" representing users, domain and
-newsgroups, which can be displayed in the Article buffer.  To enable
-picons, install the picons database from
-@url{http://www.cs.indiana.edu/picons/ftp/index.html} and point
-@code{gnus-picon-databases} to that location.
+Picons are small ``personal icons'' representing users, domain and
+newsgroups, which can be displayed in the Article buffer.
+@xref{Picons}.
 
 @item
 If the new option @code{gnus-treat-body-boundary} is non-@code{nil}, a
@@ -24729,7 +24732,7 @@ Delayed articles
 
 You can delay the sending of a message with @kbd{C-c C-j} in the Message
 buffer.  The messages are delivered at specified time.  This is useful
-for sending yourself reminders.  Setup with @code{(gnus-delay-initialize)}.
+for sending yourself reminders.  @xref{Delayed Articles}.
 
 @item
 If @code{auto-compression-mode} is enabled, attachments are automatically
@@ -24740,7 +24743,7 @@ If the new option @code{nnml-use-compressed-files} is non-@code{nil},
 the nnml back end allows compressed message files.
 
 @item
-Signed article headers (X-PGP-Sig) can be verified with @code{W p}.
+Signed article headers (X-PGP-Sig) can be verified with @kbd{W p}.
 
 @item
 The Summary Buffer uses an arrow in the fringe to indicate the current 
@@ -24759,7 +24762,7 @@ non-@code{nil}, the summary buffer is shown and updated as it's being
 built.
 
 @item
-The new @code{recent} mark "." indicates newly arrived messages (as
+The new @code{recent} mark @samp{.} indicates newly arrived messages (as
 opposed to old but unread messages).
 
 @item
@@ -24775,11 +24778,11 @@ related commands in mailing list groups.
 
 @item
 The Date header can be displayed in a format that can be read aloud
-in English, see @code{gnus-treat-date-english}.
+in English.  @xref{Article Date}.
 
 @item
-The envelope sender address can be customized when using Sendmail, see 
-@code{message-sendmail-envelope-from}.
+The envelope sender address can be customized when using Sendmail.
+@xref{Mail Variables, Mail Variables,, message, Message Manual}.
 
 @item
 diffs are automatically highlighted in groups matching
@@ -24788,9 +24791,9 @@ diffs are automatically highlighted in groups matching
 @item
 TLS wrapper shipped with Gnus
 
-TLS/SSL is now supported in IMAP and NNTP via @file{tls.el} and GNUTLS.  The
-old TLS/SSL support via (external third party) @file{ssl.el} and OpenSSL
-still works.
+TLS/SSL is now supported in @acronym{IMAP} and @acronym{NNTP} via
+@file{tls.el} and GNUTLS.  The old TLS/SSL support via (external third
+party) @file{ssl.el} and OpenSSL still works.
 
 @item
 New @file{make.bat} for compiling and installing Gnus under MS Windows
@@ -24815,13 +24818,14 @@ The new @file{make.bat} makes @file{make-x.bat} superfluous, so it has
 been removed.
 
 @item
-Support for non-ASCII domain names
+Support for non-@acronym{ASCII} domain names
 
-Message supports non-ASCII domain names in From:, To: and Cc: and will
-query you whether to perform encoding when you try to send a message.
-The variable @code{message-use-idna} controls this.  Gnus will also decode
-non-ASCII domain names in From:, To: and Cc: when you view a message.
-The variable @code{gnus-use-idna} controls this.
+Message supports non-@acronym{ASCII} domain names in From:, To: and
+Cc: and will query you whether to perform encoding when you try to
+send a message.  The variable @code{message-use-idna} controls this.
+Gnus will also decode non-@acronym{ASCII} domain names in From:, To:
+and Cc: when you view a message.  The variable @code{gnus-use-idna}
+controls this.
 
 @item
 Better handling of Microsoft citation styles
@@ -24835,10 +24839,10 @@ citations.
 @item
 @code{gnus-article-skip-boring}
 
-If you set @code{gnus-article-skip-boring} to t, then Gnus will not scroll
-down to show you a page that contains only boring text, which by
-default means cited text and signature.  You can customize what is
-skippable using @code{gnus-article-boring-faces}.
+If you set @code{gnus-article-skip-boring} to @code{t}, then Gnus will
+not scroll down to show you a page that contains only boring text,
+which by default means cited text and signature.  You can customize
+what is skippable using @code{gnus-article-boring-faces}.
 
 This feature is especially useful if you read many articles that
 consist of a little new content at the top with a long, untrimmed
@@ -24850,7 +24854,7 @@ The format spec @code{%C} for positioning point has changed to @code{%*}.
 @item
 The new variable @code{gnus-parameters} can be used to set group parameters.
 
-Earlier this was done only via @code{G p} (or @code{G c}), which stored
+Earlier this was done only via @kbd{G p} (or @kbd{G c}), which stored
 the parameters in @file{~/.newsrc.eld}, but via this variable you can
 enjoy the powers of customize, and simplified backups since you set the
 variable in @file{~/.emacs} instead of @file{~/.newsrc.eld}.  The
@@ -24866,9 +24870,10 @@ parameters, a'la:
 @end lisp
 
 @item
-Smileys (":-)", ";-)" etc) are now iconized for Emacs too.
+Smileys (@samp{:-)}, @samp{;-)} etc) are now iconized for Emacs too.
 
-Put @code{(setq gnus-treat-display-smileys nil)} in @file{~/.emacs} to disable it.
+Put @code{(setq gnus-treat-display-smileys nil)} in @file{~/.emacs} to
+disable it.
 
 @item
 Gnus no longer generate the Sender: header automatically.
@@ -24880,12 +24885,13 @@ only use of the Sender: header was to check if you are entitled to
 cancel/supersede news (which is now solved by Cancel Locks instead,
 see another entry), generation of the header has been disabled by
 default.  See the variables @code{message-required-headers},
-@code{message-required-news-headers}, and @code{message-required-mail-headers}.
+@code{message-required-news-headers}, and
+@code{message-required-mail-headers}.
 
 @item
 Features from third party @file{message-utils.el} added to @file{message.el}.
 
-Message now asks if you wish to remove "(was: <old subject>)" from
+Message now asks if you wish to remove @samp{(was: <old subject>)} from
 subject lines (see @code{message-subject-trailing-was-query}).  @kbd{C-c
 M-m} and @kbd{C-c M-f} inserts markers indicating included text.
 @kbd{C-c C-f a} adds a X-No-Archive: header.  @kbd{C-c C-f x} inserts
@@ -24904,7 +24910,7 @@ Gnus is now able to take out spam from your mail and news streams
 using a wide variety of programs and filter rules. Among the supported
 methods are RBL blocklists, bogofilter and white/blacklists.  Hooks
 for easy use of external packages such as SpamAssassin and Hashcash
-are also new.
+are also new.  @xref{Thwarting Email Spam}.
 
 @item
 Easy inclusion of X-Faces headers.
@@ -24936,11 +24942,12 @@ To support groups that contains SPC and other weird characters, groups
 are quoted before they are placed in the Gcc: header.  This means
 variables such as @code{gnus-message-archive-group} should no longer
 contain quote characters to make groups containing SPC work.  Also, if
-you are using the string "nnml:foo, nnml:bar" (indicating Gcc into two
-groups) you must change it to return the list ("nnml:foo" "nnml:bar"),
-otherwise the Gcc: line will be quoted incorrectly.  Note that
-returning the string "nnml:foo, nnml:bar" was incorrect earlier, it
-just didn't generate any problems since it was inserted directly.
+you are using the string @samp{nnml:foo, nnml:bar} (indicating Gcc
+into two groups) you must change it to return the list
+@code{("nnml:foo" "nnml:bar")}, otherwise the Gcc: line will be quoted
+incorrectly.  Note that returning the string @samp{nnml:foo, nnml:bar}
+was incorrect earlier, it just didn't generate any problems since it
+was inserted directly.
 
 @item
 @file{~/News/overview/} not used.
@@ -24953,27 +24960,29 @@ hierarchy.
 @code{gnus-agent}
 
 The Gnus Agent has seen a major updated and is now enabled by default,
-and all nntp and nnimap servers from gnus-select-method and
-gnus-secondary-select-method are agentized by default. Earlier only the
-server in gnus-select-method was agentized by the default, and the agent
-was disabled by default.  When the agent is enabled, headers are now
-also retrieved from the Agent cache instead of the backends when
-possible. Earlier this only happened in the unplugged state.  You can
-enroll or remove servers with @kbd{J a} and @kbd{J r} in the server
-buffer.  Gnus will not download articles into the Agent cache, unless
-you instruct it to do so, though, by using @kbd{J u} or @kbd{J s} from
-the Group buffer.  You revert to the old behaviour of having the Agent
-disabled with @kbd{(setq gnus-agent nil)}.  Note that putting
-@code{(gnus-agentize)} in @file{~/.gnus.el} is not needed any more.
+and all nntp and nnimap servers from @code{gnus-select-method} and
+@code{gnus-secondary-select-method} are agentized by default. Earlier
+only the server in @code{gnus-select-method} was agentized by the
+default, and the agent was disabled by default.  When the agent is
+enabled, headers are now also retrieved from the Agent cache instead
+of the back ends when possible. Earlier this only happened in the
+unplugged state.  You can enroll or remove servers with @kbd{J a} and
+@kbd{J r} in the server buffer.  Gnus will not download articles into
+the Agent cache, unless you instruct it to do so, though, by using
+@kbd{J u} or @kbd{J s} from the Group buffer.  You revert to the old
+behaviour of having the Agent disabled with @code{(setq gnus-agent
+nil)}.  Note that putting @code{(gnus-agentize)} in @file{~/.gnus.el}
+is not needed any more.
 
 @item
 @code{gnus-summary-line-format}
 
-The default value changed to "%U%R%z%I%(%[%4L: %-23,23f%]%) %s\n".
-Moreover @code{gnus-extra-headers}, @code{nnmail-extra-headers} and
-@code{gnus-ignored-from-addresses} changed their default so that the users
-name will be replaced by the recipient's name or the group name
-posting to for NNTP groups.
+The default value changed to @samp{%U%R%z%I%(%[%4L: %-23,23f%]%)
+%s\n}.  Moreover @code{gnus-extra-headers},
+@code{nnmail-extra-headers} and @code{gnus-ignored-from-addresses}
+changed their default so that the users name will be replaced by the
+recipient's name or the group name posting to for @acronym{NNTP}
+groups.
 
 @item
 @file{deuglify.el} (@code{gnus-article-outlook-deuglify-article})
@@ -24994,15 +25003,15 @@ some of which may not be included in distributions of Emacsen.
 @item
 @code{gnus-slave-unplugged}
 
-A new command which starts gnus offline in slave mode.
+A new command which starts Gnus offline in slave mode.
 
 @item
 @code{message-insinuate-rmail}
 
-Adding @code{(message-insinuate-rmail)} and @code{(setq mail-user-agent
-'gnus-user-agent)} in .emacs convinces Rmail to compose, reply and
-forward messages in message-mode, where you can enjoy the power of
-@acronym{MML}.
+Adding @code{(message-insinuate-rmail)} and @code{(setq
+mail-user-agent 'gnus-user-agent)} in @file{.emacs} convinces Rmail to
+compose, reply and forward messages in message-mode, where you can
+enjoy the power of @acronym{MML}.
 
 @item
 @code{message-minibuffer-local-map}
@@ -25016,20 +25025,22 @@ The line below enables BBDB in resending a message:
 @item
 Externalizing and deleting of attachments.
 
-If @code{gnus-gcc-externalize-attachments} (or
-@code{message-fcc-externalize-attachments}) is non-@code{nil}, attach
+If @code{gnus-gcc-externalize-attachments} or
+@code{message-fcc-externalize-attachments} is non-@code{nil}, attach
 local files as external parts.
 
-The command @code{gnus-mime-save-part-and-strip} (bound to @kbd{C-o} on
-@acronym{MIME} buttons) saves a part and replaces the part with an external one.
-@code{gnus-mime-delete-part} (bound to @kbd{d} on @acronym{MIME} buttons) removes
-a part. It works only on back ends that support editing.
+The command @code{gnus-mime-save-part-and-strip} (bound to @kbd{C-o}
+on @acronym{MIME} buttons) saves a part and replaces the part with an
+external one.  @code{gnus-mime-delete-part} (bound to @kbd{d} on
+@acronym{MIME} buttons) removes a part. It works only on back ends
+that support editing.
 
 @item
 @code{gnus-default-charset}
 
-The default value is determined from the current-language-environment
-variable, instead of 'iso-8859-1. Also the ".*" item in
+The default value is determined from the
+@code{current-language-environment} variable, instead of
+@code{iso-8859-1}.  Also the @samp{.*} item in
 @code{gnus-group-charset-alist} is removed.
 
 @item
@@ -25049,19 +25060,19 @@ The old format like the lines below is obsolete, but still accepted.
 @item
 @code{message-ignored-news-headers} and @code{message-ignored-mail-headers}
 
-X-Draft-From and X-Gnus-Agent-Meta-Information have been added into
-these two variables. If you customized those, perhaps you need add
-those two headers too.
+@samp{X-Draft-From} and @samp{X-Gnus-Agent-Meta-Information} have been
+added into these two variables. If you customized those, perhaps you
+need add those two headers too.
 
 @item
-Gnus reads the NOV and articles in the Agent if plugged.
+Gnus reads the @acronym{NOV} and articles in the Agent if plugged.
 
 If one reads an article while plugged, and the article already exists
 in the Agent, it won't get downloaded once more.  @code{(setq
 gnus-agent-cache nil)} reverts to the old behavior.
 
 @item
-Gnus supports the "format=flowed" (RFC 2646) parameter.
+Gnus supports the ``format=flowed'' (RFC 2646) parameter.
 
 On composing messages, it is enabled by @code{use-hard-newlines}.  Decoding
 format=flowed was present but not documented in earlier versions.
@@ -25074,14 +25085,14 @@ This is invoked with the @kbd{C-c M-n} key binding from message mode.
 @item
 Gnus supports Maildir groups.
 
-Gnus includes a new backend @file{nnmaildir.el}.
+Gnus includes a new back end @file{nnmaildir.el}.  @xref{Maildir}.
 
 @item
 Printing capabilities are enhanced.
 
 Gnus supports Muttprint natively with @kbd{O P} from the Summary and
-Article buffers.  Also, each individual @acronym{MIME} part can be printed using
-@kbd{p} on the @acronym{MIME} button.
+Article buffers.  Also, each individual @acronym{MIME} part can be
+printed using @kbd{p} on the @acronym{MIME} button.
 
 @item
 Message supports the Importance: (RFC 2156) header.
@@ -25092,7 +25103,7 @@ the valid values.
 @item
 Gnus supports Cancel Locks in News.
 
-This means a header "Cancel-Lock" is inserted in news posting.  It is
+This means a header @samp{Cancel-Lock} is inserted in news posting.  It is
 used to determine if you wrote a article or not (for cancelling and
 superseding).  Gnus generates a random password string the first time
 you post a message, and saves it in your @file{~/.emacs} using the Custom
@@ -25105,25 +25116,25 @@ The behaviour can be changed by customizing @code{message-insert-canlock}.
 Gnus supports server-side mail filtering using Sieve.
 
 Sieve rules can be added as Group Parameters for groups, and the
-complete Sieve script is generated using @code{D g} from the Group buffer,
-and then uploaded to the server using @kbd{C-c C-l} in the generated Sieve
-buffer.  Search the online Gnus manual for "sieve", and see the new
-Sieve manual, for more information.
+complete Sieve script is generated using @kbd{D g} from the Group
+buffer, and then uploaded to the server using @kbd{C-c C-l} in the
+generated Sieve buffer.  @xref{Sieve Commands}, and the new Sieve
+manual @ref{Top, , Top, sieve, Emacs Sieve}.
 
 @item
 Extended format specs.
 
-Format spec "%&user-date;" is added into
+Format spec @samp{%&user-date;} is added into
 @code{gnus-summary-line-format-alist}.  Also, user defined extended
 format specs are supported.  The extended format specs look like
-"%u&foo;", which invokes function
-@code{gnus-user-format-function-@var{foo}}.  Because "&" is used as the
-escape character, old user defined format "%u&" is no longer supported.
+@samp{%u&foo;}, which invokes function
+@code{gnus-user-format-function-@var{foo}}.  Because @samp{&} is used as the
+escape character, old user defined format @samp{%u&} is no longer supported.
 
 @item
-@code{/ *} (@code{gnus-summary-limit-include-cached}) is rewritten.
+@kbd{/ *} (@code{gnus-summary-limit-include-cached}) is rewritten.
 
-It was aliased to @code{Y c}
+It was aliased to @kbd{Y c}
 (@code{gnus-summary-insert-cached-articles}). The new function filters
 out other articles.
 
@@ -25150,12 +25161,12 @@ The new server variables @code{nnml-marks-is-evil} and
 @code{nnfolder-marks-is-evil} can be used to disable this feature.
 
 @item
-The menu bar item (in Group and Summary buffer) named "Misc" has
-been renamed to "Gnus".
+The menu bar item (in Group and Summary buffer) named ``Misc'' has
+been renamed to ``Gnus''.
 
 @item
-The menu bar item (in Message mode) named "@acronym{MML}" has been
-renamed to "Attachments".  Note that this menu also contains security
+The menu bar item (in Message mode) named ``@acronym{MML}'' has been
+renamed to ``Attachments''.  Note that this menu also contains security
 related stuff, like signing and encryption (@pxref{Security, Security,,
 message, Message Manual}).