sfeed_update.1 (raw) (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 any 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 hiltjo@codemadness.org