changeset 95912:dd0e2fbdf65e

Updated newsticker.texi
author Ulf Jasper <ulf.jasper@web.de>
date Sat, 14 Jun 2008 10:01:39 +0000
parents dd0b776b5331
children e9cff1f5a026
files doc/misc/ChangeLog doc/misc/newsticker.texi
diffstat 2 files changed, 84 insertions(+), 47 deletions(-) [+]
line wrap: on
line diff
--- a/doc/misc/ChangeLog	Sat Jun 14 08:58:56 2008 +0000
+++ b/doc/misc/ChangeLog	Sat Jun 14 10:01:39 2008 +0000
@@ -1,3 +1,7 @@
+2008-06-14  Ulf Jasper  <ulf.jasper@web.de>
+
+	* newsticker.texi: Updated to match latest newsticker changes.
+
 2008-06-13  Glenn Morris  <rgm@gnu.org>
 
 	* ada-mode.texi, autotype.texi, calc.texi, cc-mode.texi, cl.texi
--- a/doc/misc/newsticker.texi	Sat Jun 14 08:58:56 2008 +0000
+++ b/doc/misc/newsticker.texi	Sat Jun 14 10:01:39 2008 +0000
@@ -1,8 +1,8 @@
 \input texinfo   @c -*-texinfo-*-
 @comment %**start of header
 @setfilename ../../info/newsticker
-@set VERSION 1.9
-@set UPDATED November 2005
+@set VERSION 1.99
+@set UPDATED June 2008
 @settitle Newsticker @value{VERSION}
 @syncodeindex vr cp
 @syncodeindex fn cp
@@ -46,7 +46,7 @@
 @subtitle for version @value{VERSION}, @value{UPDATED}
 @author Ulf Jasper
 @author @email{ulf.jasper@@web.de}
-@author @uref{http://de.geocities.com/ulf_jasper}
+@author @uref{http://ulf.epplejasper.de/}
 @page
 @vskip 0pt plus 1filll
 @insertcopying
@@ -81,7 +81,7 @@
 
 Headlines consist of a title and (possibly) a small description.  They
 are contained in "RSS" (RDF Site Summary) or "Atom" files.  Newsticker
-should work with the following RSS formats:
+works with the following RSS formats:
 
 @itemize
 @item RSS 0.91 (see @uref{http://backend.userland.com/rss091} or
@@ -97,8 +97,8 @@
 @uref{http://www.ietf.org/internet-drafts/draft-ietf-atompub-format-11.txt}).
 @end itemize
 
-That makes Newsticker.el an "Atom aggregator, "RSS reader", or "RSS
-aggregator".
+That makes Newsticker.el an ``Atom aggregator'', ``RSS reader'', ``Feed
+aggregator'', or ``Feed reader''.
 
 Newsticker provides several commands for reading headlines, navigating
 through them, marking them as read/unread, hiding old headlines etc.
@@ -131,9 +131,11 @@
 you are using XEmacs you want to get the @file{net-utils} package
 which contains @file{xml.el} for XEmacs.
 
-Newsticker requires a program which can retrieve files via http and
-prints them to stdout.  By default Newsticker will use
-@uref{http://www.gnu.org/software/wget/wget.html, wget} for this task.
+Newsticker retrieves headlines either via Emacs' built-in retrieval
+functions, by an arbitrary external program that retrieves files via
+http and prints them to stdout (like
+@uref{http://www.gnu.org/software/wget/wget.html, wget}, or -- on a
+per feed basis -- via an arbitrary Lisp command.
 
 
 @node Installation
@@ -157,12 +159,22 @@
 
 @findex newsticker-show-news
 The command @code{newsticker-show-news} will display all available
-headlines in a special buffer, called @samp{*newsticker*}.  It will
-also start the asynchronous download of headlines.  The modeline in
-the @samp{*newsticker*} buffer informs whenever new headlines have
-arrived.  Clicking mouse-button 2 or pressing RET in this buffer on a
-headline will call @code{browse-url} to load the corresponding news
-story in your favourite web browser.
+headlines.  It will also start the asynchronous download of headlines.
+
+You can choose between two different frontends for reading headlines:
+@itemize
+@item Newsticker's @emph{treeview} uses separate windows for the
+feeds (in tree form), a list of headlines for the current feed, and
+the content of the current headline. Feeds can be placed into groups
+which itself can be placed in groups and so on. 
+@item Newsticker's @emph{plainview} displays all headlines in a
+single buffer, called @samp{*newsticker*}. The modeline in the
+@samp{*newsticker*} buffer informs whenever new headlines have
+arrived.
+@end itemize
+In both views clicking mouse-button 2 or pressing RET on a headline
+will call @code{browse-url} to load the corresponding news story in
+your favourite web browser.
 
 @findex newsticker-start-ticker
 @findex newsticker-stop-ticker
@@ -189,12 +201,13 @@
 cases it is not necessary to customize settings before starting Newsticker
 for the first time.
 
-Newsticker options are organized in the following groups.
+The following list shows the available groups of newsticker options
+and some of the most important options.
 
 @itemize
 
 @item
-@code{newsticker-feed} contains options that define which news
+@code{newsticker-retrieval} contains options that define which news
 feeds are retrieved and how this is done.  
 
 @itemize
@@ -203,6 +216,11 @@
 @code{newsticker-url-list} defines the list of headlines which are
 retrieved.
 @item
+@vindex newsticker-retrieval-method
+@code{newsticker-retrieval-method} defines how headlines are
+retrieved. This is either done using Emacs' built-in download
+capabilities or using an external tool.
+@item
 @vindex newsticker-retrieval-interval
 @code{newsticker-retrieval-interval} defines how often headlines
 are retrieved.
@@ -218,30 +236,10 @@
 @code{newsticker-keep-obsolete-items} decides whether unread
 headlines that have been removed from the feed are kept in the
 Newsticker cache.
-@end itemize
-
 @item
-@code{newsticker-layout} contains options that define how the
-buffer for reading news headlines is formatted.
-
-@itemize
-@item
-@vindex newsticker-heading-format
-@code{newsticker-item-format} defines how the title of a headline
-is formatted.
-@end itemize
-
-@item
-@code{newsticker-ticker} contains options that define how headlines
-are shown in the echo area.
-
-@itemize
-@item
-@vindex newsticker-display-interval
-@vindex newsticker-scroll-smoothly
-@code{newsticker-display-interval} and
-@code{newsticker-scroll-smoothly} define how headlines are shown in
-the echo area.
+@vindex newsticker-auto-mark-filter-list
+@code{newsticker-auto-mark-filter-list} provides the possibility to
+automatically mark headlines as immortal or old.
 @end itemize
 
 @item
@@ -253,24 +251,59 @@
 @code{newsticker-new-item-functions} allows for automatic
 processing of headlines. See `newsticker-download-images', and
 `newsticker-download-enclosures' for sample functions.
+@item
+@vindex newsticker-plainview-hooks
+The subgroup @code{newsticker-plainview-hooks} contains hook which
+apply to the plainview reader only.
 @end itemize
 
 @item
 @code{newsticker-miscellaneous} contains other Newsticker options.
 
+@item
+@code{newsticker-ticker} contains options that define how headlines
+are shown in the echo area, i.e. the ``ticker''.
+
+@itemize
+@item
+@vindex newsticker-display-interval
+@vindex newsticker-scroll-smoothly
+@code{newsticker-ticker-interval} and
+@code{newsticker-scroll-smoothly} define how headlines are shown in
+the echo area.
 @end itemize
 
-Please have a look at the customization buffers for the complete list
-of options.
+
+@item
+@code{newsticker-reader} contains options for adjusting the headline reader.
+
+@itemize
+@item
+@vindex newsticker-frontend
+@code{newsticker-frontend} determines the actual headline reader. The
+``plainview'' reader uses a single buffer, the ``treeview'' uses
+separate buffers and windows.
+@end itemize
+
+@itemize
+@item
+@vindex newsticker-plainview
+The subgroup @code{newsticker-plainview} contains options for the
+plainview reader.
+@item
+@vindex newsticker-treeview
+The subgroup @code{newsticker-treeview} contains options for the
+treeview reader.
+@end itemize
+
+@end itemize
+
+For the complete list of options please have a look at the
+customization buffers.
 
 @node Remarks
 @chapter Remarks
 
-This newsticker is designed do its job silently in the background
-without disturbing you.  However, it is probably impossible to prevent
-such a tool from slightly attenuating your Editor's responsiveness
-every once in a while.
-
 Byte-compiling newsticker.el is recommended.
 
 @node GNU Free Documentation License