GopherProxy

	sfeed_update.1 - sfeed - RSS and Atom parser
	git clone git://git.codemadness.org/sfeed
	Log
	Files
	Refs
	README
	LICENSE
	---
	sfeed_update.1 (1870B)
	---
	1 .Dd October 27, 2024
	2 .Dt SFEED_UPDATE 1
	3 .Os
	4 .Sh NAME
	5 .Nm sfeed_update
	6 .Nd update feeds and merge with old feeds
	7 .Sh SYNOPSIS
	8 .Nm
	9 .Op Ar sfeedrc
	10 .Sh DESCRIPTION
	11 .Nm
	12 writes TAB-separated feed files and merges new items with the items in a…
	13 existing files.
	14 The items are stored as one file per feed in the directory
	15 .Pa $HOME/.sfeed/feeds
	16 by default.
	17 The directory can be changed in the
	18 .Xr sfeedrc 5
	19 file.
	20 .Sh OPTIONS
	21 .Bl -tag -width Ds
	22 .It Ar sfeedrc
	23 Config file.
	24 The default is
	25 .Pa $HOME/.sfeed/sfeedrc .
	26 .El
	27 .Sh FILES READ
	28 .Bl -tag -width Ds
	29 .It Ar sfeedrc
	30 This file is evaluated as a shellscript in
	31 .Nm .
	32 See also the
	33 .Xr sfeedrc 5
	34 man page for a detailed description of the format and an example file.
	35 .El
	36 .Sh FILES WRITTEN
	37 .Bl -tag -width Ds
	38 .It Pa feedname
	39 TAB-separated
	40 .Xr sfeed 5
	41 format containing all items per feed.
	42 The
	43 .Nm
	44 script merges new items with this file.
	45 .El
	46 .Sh ENVIRONMENT VARIABLES
	47 .Bl -tag -width Ds
	48 .It SFEED_UPDATE_INCLUDE
	49 When set to "1"
	50 .Nm
	51 can be sourced as a script, but it won't run the
	52 .Fn main
	53 entry-point.
	54 .El
	55 .Sh LOGGING
	56 When processing a feed it will log failures to stderr and non-failures to
	57 stdout in the format:
	58 .Bd -literal -offset 4n
	59 [HH:MM:SS] feedname message
	60 .Ed
	61 .Sh EXIT STATUS
	62 .Ex -std
	63 If any of the feeds failed to update then the exit status is non-zero.
	64 .Sh EXAMPLES
	65 To update your feeds and format them in various formats:
	66 .Bd -literal -offset 4n
	67 # Update feeds
	68 sfeed_update "configfile"
	69 # Format to a plain-text list
	70 sfeed_plain ~/.sfeed/feeds/* > ~/.sfeed/feeds.txt
	71 # Format to HTML
	72 sfeed_html ~/.sfeed/feeds/* > ~/.sfeed/feeds.html
	73 # Format to HTML with frames
	74 mkdir -p somedir && cd somedir && sfeed_frames ~/.sfeed/feeds/*
	75 .Ed
	76 .Sh SEE ALSO
	77 .Xr sfeed 1 ,
	78 .Xr sfeed_frames 1 ,
	79 .Xr sfeed_html 1 ,
	80 .Xr sfeed_plain 1 ,
	81 .Xr sh 1 ,
	82 .Xr sfeed 5 ,
	83 .Xr sfeedrc 5
	84 .Sh AUTHORS
	85 .An Hiltjo Posthuma Aq Mt [email protected]