Variable: newsticker-url-list

newsticker-url-list is a customizable variable defined in newst-backend.el.gz.

Value

nil

Documentation

The news feeds which you like to watch.

This alist will be used in addition to selection made customizing newsticker-url-list-defaults.

This is an alist. Each element consists of two items: a LABEL and a URL, optionally followed by a START-TIME, INTERVAL specifier and WGET-ARGUMENTS.

The LABEL gives the name of the news feed. It can be an arbitrary string.

The URL gives the location of the news feed. It must point to a valid RSS or Atom file. The file is retrieved by calling wget, or whatever you specify as newsticker-wget-name.

URL may also be a function which returns news data. In this case newsticker-retrieval-method etc. are ignored for this feed.

The START-TIME can be either a string, or nil. If it is a string it specifies a fixed time at which this feed shall be retrieved for the
first time. (Examples: "11:00pm", "23:00".) If it is nil (or
unspecified), this feed will be retrieved immediately after calling newsticker-start.

The INTERVAL specifies the time between retrievals for this feed. If it is nil (or unspecified) the default interval value as set in newsticker-retrieval-interval is used.

(newsticker.el calls run-at-time. The newsticker-parameters START-TIME
and INTERVAL correspond to the run-at-time-parameters TIME and REPEAT.)

WGET-ARGUMENTS specifies arguments for wget (see newsticker-wget-name) which apply for this feed only, overriding the value of newsticker-wget-arguments.

Source Code

;; Defined in /usr/src/emacs/lisp/net/newst-backend.el.gz
(defcustom newsticker-url-list nil
  "The news feeds which you like to watch.

This alist will be used in addition to selection made customizing
`newsticker-url-list-defaults'.

This is an alist.  Each element consists of two items: a LABEL and a URL,
optionally followed by a START-TIME, INTERVAL specifier and WGET-ARGUMENTS.

The LABEL gives the name of the news feed.  It can be an arbitrary string.

The URL gives the location of the news feed.  It must point to a valid
RSS or Atom file.  The file is retrieved by calling wget, or whatever you
specify as `newsticker-wget-name'.

URL may also be a function which returns news data.  In this case
`newsticker-retrieval-method' etc. are ignored for this feed.

The START-TIME can be either a string, or nil.  If it is a string it
specifies a fixed time at which this feed shall be retrieved for the
first time.  (Examples: \"11:00pm\", \"23:00\".)  If it is nil (or
unspecified), this feed will be retrieved immediately after calling
`newsticker-start'.

The INTERVAL specifies the time between retrievals for this feed.  If it
is nil (or unspecified) the default interval value as set in
`newsticker-retrieval-interval' is used.

\(newsticker.el calls `run-at-time'. The newsticker-parameters START-TIME
and INTERVAL correspond to the `run-at-time'-parameters TIME and REPEAT.)

WGET-ARGUMENTS specifies arguments for wget (see `newsticker-wget-name')
which apply for this feed only, overriding the value of
`newsticker-wget-arguments'."
  :type '(repeat (list :tag "News feed"
                       (string :tag "Label")
                       (choice :tag "URI"
                               (string :tag "String")
                               (function :tag "Function"))
                       (choice :tag "Start"
                               (const   :tag "Default" nil)
                               (string  :tag "Fixed Time"))
                       (choice :tag "Interval"
                               (const   :tag "Default" nil)
                               (const   :tag "Hourly" 3600)
                               (const   :tag "Daily" 86400)
                               (const   :tag "Weekly" 604800)
                               (integer :tag "Interval"))
                       (choice :tag "Wget Arguments"
                               (const  :tag "Default arguments" nil)
                               (repeat :tag "Special arguments" string))))
  :set #'newsticker--set-customvar-retrieval
  :group 'newsticker-retrieval)