sfeed

simple feed reader - forked from git.codemadness.org/sfeed
git clone git://src.gearsix.net/sfeedsfeed.zip
Log | Files | Refs | Atom | README | LICENSE

sfeed_plain.1 (raw) (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
  12 formats feed data (TSV) from
  13 .Xr sfeed 1
  14 from stdin or for each
  15 .Ar file
  16 to stdout as a plain-text list.
  17 If one or more
  18 .Ar file
  19 arguments are specified then the basename of the
  20 .Ar file
  21 is used as the feed name in the output.
  22 If no
  23 .Ar file
  24 arguments are specified and so the data is read from stdin then the feed name
  25 is empty.
  26 .Pp
  27 Items with a timestamp from the last day compared to the system time at the
  28 time of formatting are marked as new.
  29 This value might be overridden through environment variables.
  30 Items are marked as new with the prefix "N" at the start of the line.
  31 .Pp
  32 .Nm
  33 aligns the output.
  34 It shows a maximum of 70 column-wide characters for the title and outputs
  35 an ellipsis symbol if the title is longer and truncated.
  36 Make sure the environment variable
  37 .Ev LC_CTYPE
  38 is set to a UTF-8 locale, so it can determine the proper column-width
  39 per rune, using
  40 .Xr mbtowc 3
  41 and
  42 .Xr wcwidth 3 .
  43 .Sh ENVIRONMENT VARIABLES
  44 .Bl -tag -width Ds
  45 .It Ev SFEED_NEW_AGE
  46 Overwrite the maximum age in seconds to mark feeds as new.
  47 By default this is 86400, which equals one day.
  48 .El
  49 .Sh EXIT STATUS
  50 .Ex -std
  51 .Sh EXAMPLES
  52 .Bd -literal
  53 curl -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