summaryrefslogtreecommitdiff
path: root/sfeed_update.1
blob: 552c81d9f8ce01d92073c6a1b7eb9e778666e9a3 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
.Dd January 24, 2021
.Dt SFEED_UPDATE 1
.Os
.Sh NAME
.Nm sfeed_update
.Nd update feeds and merge with old feeds
.Sh SYNOPSIS
.Nm
.Op Ar sfeedrc
.Sh DESCRIPTION
.Nm
writes TAB-separated feed files and merges new items with the items in any
existing files.
The items are stored in one file per feed in the directory
.Pa $HOME/.sfeed/feeds
by default.
The directory can be changed in the
.Xr sfeedrc 5
file.
.Sh OPTIONS
.Bl -tag -width Ds
.It Ar sfeedrc
Config file.
The default is
.Pa $HOME/.sfeed/sfeedrc .
.El
.Sh FILES READ
.Bl -tag -width Ds
.It Ar sfeedrc
This file is evaluated as a shellscript in
.Nm .
See also the
.Xr sfeedrc 5
man page for a detailed description of the format and an example file.
.El
.Sh FILES WRITTEN
.Bl -tag -width Ds
.It feedname
TAB-separated
.Xr sfeed 5
format containing all items per feed.
The
.Nm
script merges new items with this file.
The feedname cannot contain '/' characters, they will be replaced with '_'.
.El
.Sh ENVIRONMENT VARIABLES
.Bl -tag -width Ds
.It SFEED_UPDATE_INCLUDE
When set
.Nm
can be sourced as a script, but it won't run the
.Fn main
entry-point.
.El
.Sh EXIT STATUS
.Ex -std
.Sh EXAMPLES
To update your feeds and format them in various formats:
.Bd -literal
# Update
sfeed_update "configfile"
# Plain-text list
sfeed_plain $HOME/.sfeed/feeds/* > $HOME/.sfeed/feeds.txt
# HTML
sfeed_html $HOME/.sfeed/feeds/* > $HOME/.sfeed/feeds.html
# HTML with frames
mkdir -p somedir && cd somedir && sfeed_frames $HOME/.sfeed/feeds/*
.Ed
.Sh SEE ALSO
.Xr sfeed 1 ,
.Xr sfeed_frames 1 ,
.Xr sfeed_html 1 ,
.Xr sfeed_plain 1 ,
.Xr sh 1 ,
.Xr sfeed 5 ,
.Xr sfeedrc 5
.Sh AUTHORS
.An Hiltjo Posthuma Aq Mt hiltjo@codemadness.org