sfeed_plain.1 1.2 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354
  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. Items are marked as new with the prefix "N" at the start of the line.
  30. .Pp
  31. .Nm
  32. aligns the output.
  33. It shows a maximum of 70 column-wide characters for the title and outputs
  34. an ellipsis symbol if the title is longer and truncated.
  35. Make sure the environment variable
  36. .Ev LC_CTYPE
  37. is set to a UTF-8 locale, so it can determine the proper column-width
  38. per rune, using
  39. .Xr mbtowc 3
  40. and
  41. .Xr wcwidth 3 .
  42. .Sh EXIT STATUS
  43. .Ex -std
  44. .Sh EXAMPLES
  45. .Bd -literal
  46. curl -s 'https://codemadness.org/atom.xml' | sfeed | sfeed_plain
  47. .Ed
  48. .Sh SEE ALSO
  49. .Xr sfeed 1 ,
  50. .Xr sfeed_html 1 ,
  51. .Xr sfeed 5
  52. .Sh AUTHORS
  53. .An Hiltjo Posthuma Aq Mt hiltjo@codemadness.org