summaryrefslogtreecommitdiff
path: root/sfeed_tail.1
blob: a9b5f57e6a5dc29c303d0fc70237ba9002208f63 (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
.Dd January 29, 2016
.Dt SFEED_TAIL 1
.Os
.Sh NAME
.Nm sfeed_tail
.Nd format unseen feed data to a plain-text list
.Sh SYNOPSIS
.Nm
.Op Ar file...
.Sh DESCRIPTION
.Nm
formats unseen feed data (TSV) from
.Xr sfeed 1
from stdin or
.Ar file
to stdout as a plain-text list. If one or more
.Ar file
are specified, the basename of the
.Ar file
is used as the feed name in the output. If no
.Ar file
parameters are specified and so the data is read from stdin the feed name
is empty.
.Pp
.Nm
will mark the initial items on the first run as seen. Then it will print the
initial items if data is read from stdin, if the data is read on the first
run by specifying the argument(s)
.Ar file
it will not show the initial seen items.
.Pp
Unseen items are printed per line in a similar format to
.Xr sfeed_plain 1 ,
duplicate items are ignored. The list of unique items is determined by the
fields: feedname, item id and UNIX timestamp of the item date.
.Sh IMPLEMENTATION NOTES
Keep in mind that because
.Nm
keeps a list of all the items it can consume much memory.
.Sh SEE ALSO
.Xr sfeed 1 ,
.Xr sfeed_plain 1 ,
.Xr tail 1
.Sh AUTHORS
.An Hiltjo Posthuma Aq Mt hiltjo@codemadness.org