sfeed_update1

Usage

Overview

sfeed_update writes TAB-separated feed files and merges new items with the items in any existing files. The items are stored as one file per feed in the directory $HOME/.sfeed/feeds by default. The directory can be changed in the sfeedrc(5) file.

Options

sfeedrc

Config file. The default is $HOME/.sfeed/sfeedrc.

Files read

sfeedrc

This file is evaluated as a shellscript in sfeed_update. See also the sfeedrc(5) man page for a detailed description of the format and an example file.

Files written

feedname

TAB-separated sfeed(5) format containing all items per feed. The sfeed_update script merges new items with this file.

Environment

SFEED_UPDATE_INCLUDE

When set to "1" sfeed_update can be sourced as a script, but it won't run the main() entry-point.

Logging

When processing a feed it will log failures to stderr and non-failures to stdout in the format:

[HH:MM:SS] feedname message

Exit status

The sfeed_update utility exits 0 on success, and >0 if an error occurs. If any of the feeds failed to update then the exit status is non-zero.

Examples

To update your feeds and format them in various formats:

# Update feeds
sfeed_update "configfile"
# Format to a plain-text list
sfeed_plain ~/.sfeed/feeds/* > ~/.sfeed/feeds.txt
# Format to HTML
sfeed_html ~/.sfeed/feeds/* > ~/.sfeed/feeds.html
# Format to HTML with frames
mkdir -p somedir && cd somedir && sfeed_frames ~/.sfeed/feeds/*