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] |