File: sfeed_mbox.1

package info (click to toggle)
sfeed 2.3-1
  • links: PTS
  • area: main
  • in suites: forky, sid
  • size: 412 kB
  • sloc: ansic: 5,176; sh: 275; makefile: 126; xml: 58
file content (85 lines) | stat: -rw-r--r-- 2,016 bytes parent folder | download
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
80
81
82
83
84
85
.Dd December 26, 2025
.Dt SFEED_MBOX 1
.Os
.Sh NAME
.Nm sfeed_mbox
.Nd format feed data to mboxrd
.Sh SYNOPSIS
.Nm
.Op Ar
.Sh DESCRIPTION
.Nm
formats feed data (TSV) from
.Xr sfeed 1
from stdin or for each
.Ar file
to stdout in the mboxrd format.
If one or more
.Ar file
arguments are specified then the basename of the
.Ar file
is used as the feed name in the output.
If no
.Ar file
arguments are specified and so the data is read from stdin then the feed name
is empty.
The mbox data can be further processed by tools like
.Xr procmail 1
or
.Xr fdm 1
for example.
See the README file for some examples.
.Sh CUSTOM HEADERS
To make further filtering simpler some custom headers are set:
.Bl -tag -width Ds
.It X-Feedname
The feed name, this is the basename of the feed
.Ar file .
.It X-RSS-Author
Item author, if it is set.
.It X-RSS-Enclosure
Item, first enclosure, if it is set.
.It X-RSS-ID
RSS item GUID or Atom id, if it is set.
.It X-RSS-TAGS
Category field, the '|' separator is replaced by a comma (',').
.It X-RSS-URL
Item link, if it is set.
.El
.Sh ENVIRONMENT VARIABLES
.Bl -tag -width Ds
.It Ev SFEED_MBOX_CONTENT
Include the content.
This can be insecure for some of the mail clients that interpret HTML code in
an unsafe way.
By default this is set to "0".
.It Ev SFEED_MBOX_FROM
Override the "From" header.
The default is the author of the item (if it has one) and
the e-mail "<anonymous@localhost>".
Some unsafe characters are removed from the author field.
.It Ev SFEED_MBOX_TO
Override the "To" header.
The default is "<anonymous@localhost>".
.El
.Sh EXIT STATUS
.Ex -std
.Sh EXAMPLES
Example:
.Bd -literal -offset 4n
sfeed_mbox ~/.sfeed/feeds/*
.Ed
.Pp
Below is an example to include the content.
This can be insecure for some of the mail clients that interpret HTML code in
an unsafe way:
.Bd -literal -offset 4n
SFEED_MBOX_CONTENT=1 sfeed_mbox ~/.sfeed/feeds/*
.Ed
.Sh SEE ALSO
.Xr fdm 1 ,
.Xr procmail 1 ,
.Xr sfeed 1 ,
.Xr sfeed 5
.Sh AUTHORS
.An Hiltjo Posthuma Aq Mt hiltjo@codemadness.org