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_update.1 (raw) (1870B)


   1 .Dd October 27, 2024
   2 .Dt SFEED_UPDATE 1
   3 .Os
   4 .Sh NAME
   5 .Nm sfeed_update
   6 .Nd update feeds and merge with old feeds
   7 .Sh SYNOPSIS
   8 .Nm
   9 .Op Ar sfeedrc
  10 .Sh DESCRIPTION
  11 .Nm
  12 writes TAB-separated feed files and merges new items with the items in any
  13 existing files.
  14 The items are stored as one file per feed in the directory
  15 .Pa $HOME/.sfeed/feeds
  16 by default.
  17 The directory can be changed in the
  18 .Xr sfeedrc 5
  19 file.
  20 .Sh OPTIONS
  21 .Bl -tag -width Ds
  22 .It Ar sfeedrc
  23 Config file.
  24 The default is
  25 .Pa $HOME/.sfeed/sfeedrc .
  26 .El
  27 .Sh FILES READ
  28 .Bl -tag -width Ds
  29 .It Ar sfeedrc
  30 This file is evaluated as a shellscript in
  31 .Nm .
  32 See also the
  33 .Xr sfeedrc 5
  34 man page for a detailed description of the format and an example file.
  35 .El
  36 .Sh FILES WRITTEN
  37 .Bl -tag -width Ds
  38 .It Pa feedname
  39 TAB-separated
  40 .Xr sfeed 5
  41 format containing all items per feed.
  42 The
  43 .Nm
  44 script merges new items with this file.
  45 .El
  46 .Sh ENVIRONMENT VARIABLES
  47 .Bl -tag -width Ds
  48 .It SFEED_UPDATE_INCLUDE
  49 When set to "1"
  50 .Nm
  51 can be sourced as a script, but it won't run the
  52 .Fn main
  53 entry-point.
  54 .El
  55 .Sh LOGGING
  56 When processing a feed it will log failures to stderr and non-failures to
  57 stdout in the format:
  58 .Bd -literal -offset 4n
  59 [HH:MM:SS] feedname message
  60 .Ed
  61 .Sh EXIT STATUS
  62 .Ex -std
  63 If any of the feeds failed to update then the exit status is non-zero.
  64 .Sh EXAMPLES
  65 To update your feeds and format them in various formats:
  66 .Bd -literal -offset 4n
  67 # Update feeds
  68 sfeed_update "configfile"
  69 # Format to a plain-text list
  70 sfeed_plain ~/.sfeed/feeds/* > ~/.sfeed/feeds.txt
  71 # Format to HTML
  72 sfeed_html ~/.sfeed/feeds/* > ~/.sfeed/feeds.html
  73 # Format to HTML with frames
  74 mkdir -p somedir && cd somedir && sfeed_frames ~/.sfeed/feeds/*
  75 .Ed
  76 .Sh SEE ALSO
  77 .Xr sfeed 1 ,
  78 .Xr sfeed_frames 1 ,
  79 .Xr sfeed_html 1 ,
  80 .Xr sfeed_plain 1 ,
  81 .Xr sh 1 ,
  82 .Xr sfeed 5 ,
  83 .Xr sfeedrc 5
  84 .Sh AUTHORS
  85 .An Hiltjo Posthuma Aq Mt hiltjo@codemadness.org