sfeed

Simple RSS and Atom feed parser
git clone https://git.sinitax.com/codemadness/sfeed
Log | Files | Refs | README | LICENSE | Upstream | sfeed.txt

sfeed_plain.1 (1471B)


      1.Dd May 14, 2022
      2.Dt SFEED_PLAIN 1
      3.Os
      4.Sh NAME
      5.Nm sfeed_plain
      6.Nd format feed data to a plain-text list
      7.Sh SYNOPSIS
      8.Nm
      9.Op Ar
     10.Sh DESCRIPTION
     11.Nm
     12formats feed data (TSV) from
     13.Xr sfeed 1
     14from stdin or for each
     15.Ar file
     16to stdout as a plain-text list.
     17If one or more
     18.Ar file
     19arguments are specified then the basename of the
     20.Ar file
     21is used as the feed name in the output.
     22If no
     23.Ar file
     24arguments are specified and so the data is read from stdin then the feed name
     25is empty.
     26.Pp
     27Items with a timestamp from the last day compared to the system time at the
     28time of formatting are marked as new.
     29This value might be overridden through environment variables.
     30Items are marked as new with the prefix "N" at the start of the line.
     31.Pp
     32.Nm
     33aligns the output.
     34It shows a maximum of 70 column-wide characters for the title and outputs
     35an ellipsis symbol if the title is longer and truncated.
     36Make sure the environment variable
     37.Ev LC_CTYPE
     38is set to a UTF-8 locale, so it can determine the proper column-width
     39per rune, using
     40.Xr mbtowc 3
     41and
     42.Xr wcwidth 3 .
     43.Sh ENVIRONMENT VARIABLES
     44.Bl -tag -width Ds
     45.It Ev SFEED_NEW_AGE
     46Overwrite the maximum age in seconds to mark feeds as new.
     47By default this is 86400, which equals one day.
     48.El
     49.Sh EXIT STATUS
     50.Ex -std
     51.Sh EXAMPLES
     52.Bd -literal
     53curl -s 'https://codemadness.org/atom.xml' | sfeed | sfeed_plain
     54.Ed
     55.Sh SEE ALSO
     56.Xr sfeed 1 ,
     57.Xr sfeed_html 1 ,
     58.Xr sfeed 5
     59.Sh AUTHORS
     60.An Hiltjo Posthuma Aq Mt hiltjo@codemadness.org