From: matto Date: Mon, 28 Feb 2022 20:42:16 +0000 (+0100) Subject: some small text changes X-Git-Url: http://www.git.stargrave.org/?p=feeder.git;a=commitdiff_plain;h=45e04d81a1096baa8c7551afc92fe28368f669b2 some small text changes --- diff --git a/doc/index.texi b/doc/index.texi index a8b603c..de4dcea 100644 --- a/doc/index.texi +++ b/doc/index.texi @@ -9,7 +9,7 @@ Copyright @copyright{} 2022 @email{stargrave@@stargrave.org, Sergey Matveev} @node Top @top feeder -@command{feeder} is free software newsfeeds aggregator. +@command{feeder} is a free software newsfeeds aggregator. I wrote it solely for my personal needs, so currently probably there is some hard-code in the scripts. @@ -19,8 +19,8 @@ old version. I also saw @url{https://codemadness.org/git/sfeed/file/README.html, sfeed} project, that tries to reuse many already existing tools (like @command{curl}), be @url{https://suckless.org/philosophy/, suckless} and Unix-friendly, -but failed somewhere during the try and asked myself if it is really so -hard to make that kind of software. It was written for less than a day, +but failed somewhere during the try, and asked myself if it is really so +hard to make that kind of software. It was written in less than a day, completely replacing Newsboat, with much higher performance and great flexibility. @@ -38,7 +38,7 @@ Its architecture is very simple: @item @url{https://www.djcbsoftware.nl/code/mu/, mu} utilities perform indexing and searching among the messages. Of course it would be trivial to use @url{https://www.lesbonscomptes.com/recoll/, recoll} - or @url{https://notmuchmail.org/, notmuch} instead. If you need that. + or @url{https://notmuchmail.org/, notmuch} instead, if you need that. @item Bunch of optional @url{https://www.zsh.org/, Zsh} helper scripts. @end itemize diff --git a/doc/mail.texi b/doc/mail.texi index c70f8ca..d45466a 100644 --- a/doc/mail.texi +++ b/doc/mail.texi @@ -17,7 +17,7 @@ Base64-encoded item's content. That is HTML as a rule. @end verbatim Each message is placed under @code{HEX(SHA512/2(title+content))} filename. -Unfortunately many feeds does not provide any date information at all. +Unfortunately many feeds do not provide any date information at all. Often multiple entries contain the same date. So you can not solely depend on update/publish date. diff --git a/doc/storage.texi b/doc/storage.texi index d8741fb..ff051b1 100644 --- a/doc/storage.texi +++ b/doc/storage.texi @@ -2,7 +2,7 @@ @unnumbered Storage Each feed is kept in separate subdirectory in the @file{feeds/}. Its -name is not important, but human readable is preferable choice. It +name is not important, but human readable is a preferable choice. It contains: @table @file diff --git a/doc/usage/browse.texi b/doc/usage/browse.texi index 9dedde4..16050f4 100644 --- a/doc/usage/browse.texi +++ b/doc/usage/browse.texi @@ -11,9 +11,9 @@ $ ./feeds-browse.sh labels/titles. Also it contains contains @code{auto_view text/html}, that expects -proper @file{mailcap} configuration file with @code{text/html} entry to +a proper @file{mailcap} configuration file with @code{text/html} entry to exists. Mutt has some built-in default search paths for, but you can -override them with @env{$MAILCAPS} environment variable. There is +override them with @env{$MAILCAPS} environment variable. See the example @file{contrib/mailcap}. Mutt will be started in mailboxes browser mode (I will skip many entries): diff --git a/doc/usage/encs.texi b/doc/usage/encs.texi index 77cc9af..42bba52 100644 --- a/doc/usage/encs.texi +++ b/doc/usage/encs.texi @@ -2,7 +2,7 @@ @section Enclosures Many feeds include links to so-called enclosures, like audio files for -podcasts. While you mail is not processed by MUA, its @file{new/} +podcasts. While your mail is not processed by MUA, its @file{new/} messages are still there, so you can run enclosure downloading process, that uses @url{https://www.gnu.org/software/wget/, GNU Wget}. Each enclosure's filename is more or less filesystem-friendly with the diff --git a/doc/usage/install.texi b/doc/usage/install.texi index ffe5dc0..c062d80 100644 --- a/doc/usage/install.texi +++ b/doc/usage/install.texi @@ -1,7 +1,7 @@ @node Install @section Install -Currently I am lazy enough to create tarballs. Just get its source code: +Currently I am too lazy to create tarballs. Just get its source code: @example $ git clone git://git.stargrave.org/feeder.git diff --git a/doc/usage/options.texi b/doc/usage/options.texi index 29d775b..2b1a4df 100644 --- a/doc/usage/options.texi +++ b/doc/usage/options.texi @@ -1,7 +1,7 @@ @node Options @section Options -There few configuration options taken from @file{cmd/env.rc}. You can +There are a few configuration options defined in @file{cmd/env.rc}. You can override them either with environment variables, or by editing that file directly. You can override @command{curl}, @command{wget}, @command{zstd}, @command{parallel} command invocations, diff --git a/doc/usage/reindex.texi b/doc/usage/reindex.texi index 2686bf9..fceeb6f 100644 --- a/doc/usage/reindex.texi +++ b/doc/usage/reindex.texi @@ -8,5 +8,5 @@ $ ./feeds-index.sh @end example That will create @file{mu/} and @file{search/} directories and run -@command{mu index} indexing, that is safely can be done incrementally +@command{mu index} indexing, that safely can be done incrementally after each download/parse cycle. diff --git a/doc/usage/search.texi b/doc/usage/search.texi index ee974c7..de92775 100644 --- a/doc/usage/search.texi +++ b/doc/usage/search.texi @@ -6,7 +6,7 @@ Let's search for articles mentioning @url{https://en.wikipedia.org/wiki/Planetfall, Planetfall} during 2019-2021 period: @code{Planetfall date:2019..2021}. @command{mu} will create symbolic links in @file{search/} subdirectory to the message. -Press @code{} to switch that mailbox: +Press @code{} to switch to that mailbox: @verbatim 1 [2021-12-20 07:08] Missed Classic: Stationfall - When Food Dispensers Attack (The Adventurers Guild) @@ -20,5 +20,5 @@ Press @code{} to switch that mailbox: -%-Mutt: =search [Nachr:8 215K]--- @end verbatim -Pay attention that there is different index format, lacking unnecessary -message flags display and adding name of the feed in parenthesis. +Pay attention that `this uses a different index format, lacking unnecessary +message flags display and adding the name of the feed in parenthesis. diff --git a/doc/usage/warcs.texi b/doc/usage/warcs.texi index 77ccb6f..e8142df 100644 --- a/doc/usage/warcs.texi +++ b/doc/usage/warcs.texi @@ -3,9 +3,9 @@ Similarly to @ref{Enclosures, enclosures} downloading, you may run downloading of @code{X-URL} URLs, pointing to the article itself. If it -is HTML document, then it can depend on various other resources, like +is a HTML document, it can depend on various other resources, like images and stylesheets. @url{https://www.gnu.org/software/wget/, GNU Wget} -has ability to download it with all required requisites. Moreover it is +has the ability to download it with all required requisites. Moreover it is able to output the whole document in @url{https://en.wikipedia.org/wiki/Web_ARChive, WARC} format.