CROSSBOW(1)              General Commands Manual (urm)             CROSSBOW(1)

NAME
     crossbow-fetch ? Request, parse and process all registered feeds

SYNOPSIS
     crossbow fetch [-d] [-h] [-i identifier] [-v]

DESCRIPTION
     The crossbow-fetch command is part of crossbow(1), the cron(8)-friendly
     RSS aggregator.  It is responsible for retrieving, parsing, and
     processing all new items of the tracked feeds.  In order to be tracked, a
     feed must be registered via crossbow-set(1).

     If crossbow-fetch is invoked without options all registered feeds are
     updated.  By supplying an identifier via the -i flag, only the
     corresponding feed is updated.

     A feed is updated by the following sequence of actions:

     ?   The URL is fetched, and the obtained XML is parsed into a set of feed
         items.

     ?   The obtained set is compared with the one retrieved on the previous
         execution.  Items appearing in the former but not in the latter are
         marked as "fresh".

     ?   Unless dry-run mode is enabled (-d), the updated set is stored in
         place of the previous, so it can be used for the same comparison on
         the next execution.

     ?   The "fresh" items are processed according to the set-up defined via
         crossbow-set(1).

OPTIONS
     -d    When this flag is in use, crossbow-fetch will not store updates in
           the save-file.  This is useful when testing connectivity or the
           configuration of the feed.  It is worth noting that, even though -d
           stands for dry-run, the subproc and pipe output modes will still
           result in the execution of the supplied sub-command.  See
           crossbow-set(1)

     -h    Prints the synopsis and exits.

     -i identifier
           Only fetch the feed identified by identified.

     -v    Increase verbosity

EXAMPLES
     Place this string in your crontab in oroder to check for updates from all
     feeds every two hours.

         0 0-23/2 * * * crossbow-fetch

     If the local mail is configured properly, the output produced by the
     invocation should be delivered in the user's mailbox.

SEE ALSO
     crossbow(1), crossbow-del(1), crossbow-query(1), crossbow-set(1),
     crossbow-outfmt(5)

                                 June 15, 2020