X-Git-Url: http://www.git.stargrave.org/?a=blobdiff_plain;f=doc%2Fusage.texi;h=280cce0e80e82491046af4fb150c27b6fd89fe93;hb=e18c7b0710b49655fd3b66896b8404381174e982;hp=c99e5a8e1f306c2b9ffc5c61699cf891d3a6ed60;hpb=8b501568df035fbec5895d0c3cb2fdb28ba76477;p=feeder.git diff --git a/doc/usage.texi b/doc/usage.texi index c99e5a8..280cce0 100644 --- a/doc/usage.texi +++ b/doc/usage.texi @@ -38,42 +38,21 @@ http://blog.stargrave.org/russian/feed.atom @item Download your feed(s) data -Downloading is implemented in @command{redo}'s -@file{default.download.do} file. Probably you want to change its default -@env{$PROXY} value. It uses @command{curl}, that is aware of -@code{If-Modified-Since} and @code{ETag} headers, compressed content -encodings and HTTP redirections. - -You can invoke feed downloading like that: - @example -$ redo feeds/blog.stargrave.org_russian_feed.atom/feed.download +$ cmd/download.sh feeds/blog.stargrave.org_russian_feed.atom +$ ./feeds-download.zsh # to invoke parallel downloading of everything @end example +Probably you want to change its default @env{$PROXY} value. It uses +@command{curl}, that is aware of @code{If-Modified-Since} and +@code{ETag} headers, compressed content encodings and HTTP redirections. If you want to see verbose output, then set @env{FEEDER_CURL_VERBOSE=1}. -As a rule, you wish to run all feeds downloading in parallel. You can -use @file{feeds-download.zsh}, that just invokes @command{redo-ifchange} -with @option{-f} option (forceful rebuild). Why that? Because most -@command{redo} implementations (that forces target building) do not -parallelize specified targets build. But you can also use @command{parallel}: - -@example -$ parallel "redo @{@}/feed.download" ::: feeds/* -@end example - @item Parse your feeds -Parsing (and Maildir filling) is implemented in @command{redo}'s -@file{default.parse.do} file. It calls @command{cmd/feed2mdir/feed2mdir} -utility, that read @file{feeds/FEED/feed} from stdin, takes Maildir -directory as its first argument and prints feed's title. - -You can use @file{feeds-parse.zsh} helper or invoke @command{parallel} -as in example above, replacing @code{.download} with @code{.parse}. - @example -$ ./feeds-parse.zsh +$ cmd/parse.sh feeds/blog.stargrave.org_russian_feed.atom +$ ./feeds-parse.zsh # to parse all feeds in parallel @end example @item Run Mutt @@ -170,7 +149,7 @@ workers. @command{cmd/feed2mdir/feed2mdir} command by default has @item If you want to clean download state @example -$ redo feeds/FEED/feed.clean +$ cmd/download-clean.sh feed/FEED @end example @end table