comparison man/gnus.texi @ 61424:ad05d91d3598

Revision: miles@gnu.org--gnu-2005/emacs--cvs-trunk--0--patch-243 Merge from gnus--rel--5.10 Patches applied: * gnus--rel--5.10 (patch 59) - Update from CVS 2005-04-06 Katsumi Yamaoka <yamaoka@jpl.org> * lisp/calendar/time-date.el (time-to-seconds): Don't use the #xhhhh syntax which Emacs 20 doesn't support. (seconds-to-time, days-to-time, time-subtract, time-add): Ditto. 2005-04-06 Katsumi Yamaoka <yamaoka@jpl.org> * lisp/gnus/mm-util.el (mm-coding-system-p): Don't return binary for the nil argument in XEmacs. * lisp/gnus/nnrss.el (nnrss-compatible-encoding-alist): New variable. (nnrss-request-group): Decode group name first. (nnrss-request-article): Make a text/plain article if mml-to-mime failed. (nnrss-get-encoding): Return a compatible encoding according to nnrss-compatible-encoding-alist. (nnrss-opml-export): Use dolist. (nnrss-find-el): Use consp instead of listp. (nnrss-order-hrefs): Use dolist. 2005-04-06 Arne J,Ax(Brgensen <arne@arnested.dk> * lisp/gnus/nnrss.el (nnrss-verbose): Remove. (nnrss-request-group): Use `nnheader-message' instead. 2005-04-06 Mark Plaksin <happy@usg.edu> (tiny change) * lisp/gnus/nnrss.el (nnrss-verbose): New variable. (nnrss-request-group): Make it say nnrss is requesting a group. 2005-04-06 Katsumi Yamaoka <yamaoka@jpl.org> * lisp/gnus/gnus-agent.el (gnus-agent-group-path): Decode group name. (gnus-agent-group-pathname): Ditto. * lisp/gnus/gnus-cache.el (gnus-cache-file-name): Decode group name. * lisp/gnus/gnus-group.el (gnus-group-line-format-alist): Use decoded group name for only %g and %c. (gnus-group-insert-group-line): Bind gnus-tmp-decoded-group instead of gnus-tmp-group to decoded group name. (gnus-group-make-group): Decode group name. (gnus-group-delete-group): Ditto. (gnus-group-make-rss-group): Exclude `/'s from group names; register the group data after opening the nnrss group; unify non-ASCII group names; encode group name. (gnus-group-catchup-current): Decode group name. (gnus-group-expire-articles-1): Ditto. (gnus-group-set-current-level): Ditto. (gnus-group-kill-group): Ditto. * lisp/gnus/gnus-spec.el (gnus-update-format-specifications): Flush the group format spec cache if it doesn't support decoded group names. * lisp/gnus/mm-url.el (mm-url-predefined-programs): Add --silent arg to curl. * lisp/gnus/nnrss.el: Require rfc2047 and mml. (nnrss-file-coding-system): New variable. (nnrss-format-string): Redefine it as an inline function. (nnrss-decode-group-name): New function. (nnrss-string-as-multibyte): Remove. (nnrss-retrieve-headers): Decode group name; don't use nnrss-format-string. (nnrss-request-group): Decode group name. (nnrss-request-article): Decode group name; allow a Message-ID as well as an article number; don't use nnrss-format-string; encode a Message-ID string which may contain non-ASCII characters; use mml-to-mime to compose a MIME article; use search-forward instead of re-search-forward. (nnrss-request-expire-articles): Decode group name. (nnrss-request-delete-group): Delete entries in nnrss-group-alist as well; decode group name. (nnrss-get-encoding): Fix regexp. (nnrss-fetch): Clarify error message. (nnrss-read-server-data): Use insert-file-contents instead of load; bind file-name-coding-system; use multibyte buffer. (nnrss-save-server-data): Insert newline; bind coding-system-for-write to the value of nnrss-file-coding-system; bind file-name-coding-system; add coding cookie. (nnrss-read-group-data): Use insert-file-contents instead of load; bind file-name-coding-system; use multibyte buffer. (nnrss-save-group-data): Bind coding-system-for-write to the value of nnrss-file-coding-system; bind file-name-coding-system. (nnrss-decode-entities-string): Rename from n-d-e-unibyte-string; make it work with non-ASCII text. (nnrss-opml-export): Use mm-set-buffer-file-coding-system instead of set-buffer-file-coding-system. (nnrss-find-el): Check carefully whether there's a list of string which old xml.el may return rather than a string; make it work with old xml.el as well. 2005-04-06 Tsuyoshi AKIHO <akiho@kawachi.zaq.ne.jp> * lisp/gnus/gnus-sum.el (gnus-summary-walk-group-buffer): Decode group name. * lisp/gnus/nnrss.el (nnrss-get-encoding): New function. (nnrss-fetch): Use unibyte buffer initially; bind coding-system-for-read while performing mm-url-insert; remove ^Ms; decode contents according to the encoding attribute. (nnrss-save-group-data): Add coding cookie. (nnrss-mime-encode-string): New function. (nnrss-check-group): Use it to encode subject and author. 2005-04-06 Maciek Pasternacki <maciekp@japhy.fnord.org> (tiny change) * lisp/gnus/nnrss.el (nnrss-fetch): Signal an error if w3-parse-buffer also failed. 2005-04-06 Jesper Harder <harder@ifa.au.dk> * lisp/gnus/mm-util.el (mm-subst-char-in-string): Support inplace. * lisp/gnus/nnrss.el: Pedantic docstring and whitespace fixes (courtesy of checkdoc.el). (nnrss-request-article): Cleanup. (nnrss-request-delete-group): Use nnrss-make-filename. (nnrss-read-server-data): Use nnrss-make-filename; use load. (nnrss-save-server-data): Use nnrss-make-filename; use gnus-prin1. (nnrss-read-group-data): Fix off-by-one error. From Joakim Verona <joakim@verona.se>; hash on description if link is missing; use nnrss-make-filename; use load. (nnrss-save-group-data): Use nnrss-make-filename; use gnus-prin1. (nnrss-make-filename): New function. (nnrss-close): New function. (nnrss-check-group): Hash on description if link is missing. (nnrss-get-namespace-prefix): Use string= to compare strings! Reported by David D. Smith <davidsmith@acm.org>. (nnrss-opml-export): Turn on sgml-mode. 2005-04-06 Mark A. Hershberger <mah@everybody.org> * lisp/gnus/nnrss.el (nnrss-opml-import, nnrss-opml-export): New functions. 2005-04-06 Katsumi Yamaoka <yamaoka@jpl.org> * man/gnus.texi (RSS): Addition.
author Miles Bader <miles@gnu.org>
date Sun, 10 Apr 2005 04:20:14 +0000
parents bae786986f2e
children c8b57e4594b8 146c086df160
comparison
equal deleted inserted replaced
61423:f2d616f518a5 61424:ad05d91d3598
15871 changes to a wiki (e.g. @url{http://cliki.net/recent-changes.rdf}). 15871 changes to a wiki (e.g. @url{http://cliki.net/recent-changes.rdf}).
15872 15872
15873 @acronym{RSS} has a quite regular and nice interface, and it's 15873 @acronym{RSS} has a quite regular and nice interface, and it's
15874 possible to get the information Gnus needs to keep groups updated. 15874 possible to get the information Gnus needs to keep groups updated.
15875 15875
15876 Note: you had better use Emacs which supports the @code{utf-8} coding
15877 system because @acronym{RSS} uses UTF-8 for encoding non-@acronym{ASCII}
15878 text by default. It is also used by default for non-@acronym{ASCII}
15879 group names.
15880
15876 @kindex G R (Summary) 15881 @kindex G R (Summary)
15877 Use @kbd{G R} from the summary buffer to subscribe to a feed---you 15882 Use @kbd{G R} from the summary buffer to subscribe to a feed---you will
15878 will be prompted for the location of the feed. 15883 be prompted for the location, the title and the description of the feed.
15884 The title, which allows any characters, will be used for the group name
15885 and the name of the group data file. The description can be omitted.
15879 15886
15880 An easy way to get started with @code{nnrss} is to say something like 15887 An easy way to get started with @code{nnrss} is to say something like
15881 the following in the group buffer: @kbd{B nnrss RET RET y}, then 15888 the following in the group buffer: @kbd{B nnrss RET RET y}, then
15882 subscribe to groups. 15889 subscribe to groups.
15890
15891 The @code{nnrss} back end saves the group data file in
15892 @code{nnrss-directory} (see below) for each @code{nnrss} group. File
15893 names containing non-@acronym{ASCII} characters will be encoded by the
15894 coding system specified with the @code{nnmail-pathname-coding-system}
15895 variable. If it is @code{nil}, in Emacs the coding system defaults to
15896 the value of @code{default-file-name-coding-system}. If you are using
15897 XEmacs and want to use non-@acronym{ASCII} group names, you should set
15898 the value for the @code{nnmail-pathname-coding-system} variable properly.
15899
15900 @cindex OPML
15901 You can also use the following commands to import and export your
15902 subscriptions from a file in @acronym{OPML} format (Outline Processor
15903 Markup Language).
15904
15905 @defun nnrss-opml-import file
15906 Prompt for an @acronym{OPML} file, and subscribe to each feed in the
15907 file.
15908 @end defun
15909
15910 @defun nnrss-opml-export
15911 Write your current @acronym{RSS} subscriptions to a buffer in
15912 @acronym{OPML} format.
15913 @end defun
15883 15914
15884 The following @code{nnrss} variables can be altered: 15915 The following @code{nnrss} variables can be altered:
15885 15916
15886 @table @code 15917 @table @code
15887 @item nnrss-directory 15918 @item nnrss-directory
15888 @vindex nnrss-directory 15919 @vindex nnrss-directory
15889 The directory where @code{nnrss} stores its files. The default is 15920 The directory where @code{nnrss} stores its files. The default is
15890 @file{~/News/rss/}. 15921 @file{~/News/rss/}.
15922
15923 @item nnrss-file-coding-system
15924 @vindex nnrss-file-coding-system
15925 The coding system used when reading and writing the @code{nnrss} groups
15926 data files. The default is the value of
15927 @code{mm-universal-coding-system} (which defaults to @code{emacs-mule}
15928 in Emacs or @code{escape-quoted} in XEmacs).
15891 15929
15892 @item nnrss-use-local 15930 @item nnrss-use-local
15893 @vindex nnrss-use-local 15931 @vindex nnrss-use-local
15894 @findex nnrss-generate-download-script 15932 @findex nnrss-generate-download-script
15895 If you set @code{nnrss-use-local} to @code{t}, @code{nnrss} will read 15933 If you set @code{nnrss-use-local} to @code{t}, @code{nnrss} will read