man page improvements

- Some rewording and typo fixes.
- Specify in more detail how sfeed_web detects links from HTML code.

9 files changed, 46 insertions, 41 deletions

diff --git a/sfeed_atom.1 b/sfeed_atom.1
index bfa5317..0a332a0 100644
--- a/sfeed_atom.1
+++ b/sfeed_atom.1
@@ -1,4 +1,4 @@
-.Dd March 15, 2020
+.Dd July 25, 2021
 .Dt SFEED_ATOM 1
 .Os
 .Sh NAME
@@ -6,22 +6,22 @@
 .Nd format feed data to an Atom feed
 .Sh SYNOPSIS
 .Nm
-.Op Ar file...
+.Op Ar
 .Sh DESCRIPTION
 .Nm
 formats feed data (TSV) from
 .Xr sfeed 1
-from stdin or
+from stdin or for each
 .Ar file
 to stdout as an Atom (XML) feed.
 If one or more
 .Ar file
-are specified, the basename of the
+arguments are specified then the basename of the
 .Ar file
 is used as the feed name in the output.
 If no
 .Ar file
-parameters are specified and so the data is read from stdin the feed name
+arguments are specified and so the data is read from stdin then the feed name
 is empty.
 .Pp
 If
diff --git a/sfeed_frames.1 b/sfeed_frames.1
index 0409da3..d140cb4 100644
--- a/sfeed_frames.1
+++ b/sfeed_frames.1
@@ -1,4 +1,4 @@
-.Dd May 30, 2020
+.Dd July 25, 2021
 .Dt SFEED_FRAMES 1
 .Os
 .Sh NAME
@@ -6,19 +6,19 @@
 .Nd format feed data to HTML with frames
 .Sh SYNOPSIS
 .Nm
-.Op Ar file...
+.Op Ar
 .Sh DESCRIPTION
 .Nm
 formats feed data (TSV) from
 .Xr sfeed 1
-to HTML.
-It reads TSV data from stdin or
+from stdin or for each
 .Ar file
-and writes HTML files for the frameset to the current directory.
+to HTML.
+It writes HTML files for the frameset to the current directory.
 If no
 .Ar file
-parameters are specified and therefore the data is read from stdin then the
-menu.html file is not written.
+arguments are specified and so the data is read from stdin then the menu.html
+file is not written.
 .Pp
 Items with a timestamp from the last day compared to the system time at the
 time of formatting are counted and marked as new.
diff --git a/sfeed_gopher.1 b/sfeed_gopher.1
index 40f9c33..54ed333 100644
--- a/sfeed_gopher.1
+++ b/sfeed_gopher.1
@@ -1,4 +1,4 @@
-.Dd January 3, 2021
+.Dd July 25, 2021
 .Dt SFEED_GOPHER 1
 .Os
 .Sh NAME
@@ -6,18 +6,18 @@
 .Nd format feed data to Gopher files
 .Sh SYNOPSIS
 .Nm
-.Op Ar file...
+.Op Ar
 .Sh DESCRIPTION
 .Nm
 formats feed data (TSV) from
 .Xr sfeed 1
-from stdin or
+from stdin or for each
 .Ar file
 to stdout in the raw Gopher output format.
 .Pp
 If one or more
 .Ar file
-are specified, the basename of the
+arguments are specified then the basename of the
 .Ar file
 is used as the feed name in the output.
 .Nm
@@ -26,7 +26,7 @@ the same name as the feedname.
 .Pp
 If no
 .Ar file
-parameters are specified and the data is read from stdin then the data is
+arguments are specified and so the data is read from stdin then the data is
 written to stdout and no files are written.
 .Pp
 Items with a timestamp from the last day compared to the system time at the
diff --git a/sfeed_html.1 b/sfeed_html.1
index f2879ec..d7e2ae8 100644
--- a/sfeed_html.1
+++ b/sfeed_html.1
@@ -1,4 +1,4 @@
-.Dd May 30, 2020
+.Dd July 25, 2021
 .Dt SFEED_HTML 1
 .Os
 .Sh NAME
@@ -6,22 +6,22 @@
 .Nd format feed data to HTML
 .Sh SYNOPSIS
 .Nm
-.Op Ar file...
+.Op Ar
 .Sh DESCRIPTION
 .Nm
 formats feed data (TSV) from
 .Xr sfeed 1
-from stdin or
+from stdin or for each
 .Ar file
 to stdout in HTML.
 If one or more
 .Ar file
-are specified, the basename of the
+arguments are specified then the basename of the
 .Ar file
 is used as the feed name in the output.
 If no
 .Ar file
-parameters are specified and so the data is read from stdin the feed name
+arguments are specified and so the data is read from stdin then the feed name
 is empty.
 .Pp
 Items with a timestamp from the last day compared to the system time at the
diff --git a/sfeed_mbox.1 b/sfeed_mbox.1
index 407f3c5..b410351 100644
--- a/sfeed_mbox.1
+++ b/sfeed_mbox.1
@@ -1,4 +1,4 @@
-.Dd July 6, 2020
+.Dd July 25, 2021
 .Dt SFEED_MBOX 1
 .Os
 .Sh NAME
@@ -6,22 +6,22 @@
 .Nd format feed data to mboxrd
 .Sh SYNOPSIS
 .Nm
-.Op Ar file...
+.Op Ar
 .Sh DESCRIPTION
 .Nm
 formats feed data (TSV) from
 .Xr sfeed 1
-from stdin or
+from stdin or for each
 .Ar file
 to stdout in the mboxrd format.
 If one or more
 .Ar file
-are specified, the basename of the
+arguments are specified then the basename of the
 .Ar file
 is used as the feed name in the output.
 If no
 .Ar file
-parameters are specified and so the data is read from stdin the feed name
+arguments are specified and so the data is read from stdin then the feed name
 is empty.
 The mbox data can be further processed by tools like
 .Xr procmail 1
diff --git a/sfeed_plain.1 b/sfeed_plain.1
index c551804..124463d 100644
--- a/sfeed_plain.1
+++ b/sfeed_plain.1
@@ -1,4 +1,4 @@
-.Dd January 1, 2021
+.Dd July 25, 2021
 .Dt SFEED_PLAIN 1
 .Os
 .Sh NAME
@@ -6,22 +6,22 @@
 .Nd format feed data to a plain-text list
 .Sh SYNOPSIS
 .Nm
-.Op Ar file...
+.Op Ar
 .Sh DESCRIPTION
 .Nm
 formats feed data (TSV) from
 .Xr sfeed 1
-from stdin or
+from stdin or for each
 .Ar file
 to stdout as a plain-text list.
 If one or more
 .Ar file
-are specified, the basename of the
+arguments are specified then the basename of the
 .Ar file
 is used as the feed name in the output.
 If no
 .Ar file
-parameters are specified and so the data is read from stdin the feed name
+arguments are specified and so the data is read from stdin then the feed name
 is empty.
 .Pp
 Items with a timestamp from the last day compared to the system time at the
diff --git a/sfeed_twtxt.1 b/sfeed_twtxt.1
index c0544a9..38ec4c9 100644
--- a/sfeed_twtxt.1
+++ b/sfeed_twtxt.1
@@ -1,4 +1,4 @@
-.Dd March 15, 2020
+.Dd July 25, 2021
 .Dt SFEED_TWTXT 1
 .Os
 .Sh NAME
@@ -6,22 +6,22 @@
 .Nd format feed data to a twtxt feed
 .Sh SYNOPSIS
 .Nm
-.Op Ar file...
+.Op Ar
 .Sh DESCRIPTION
 .Nm
 formats feed data (TSV) from
 .Xr sfeed 1
-from stdin or
+from stdin or for each
 .Ar file
 to stdout as a twtxt feed.
 If one or more
 .Ar file
-are specified, the basename of the
+arguments are specified then the basename of the
 .Ar file
 is used as the feed name in the output.
 If no
 .Ar file
-parameters are specified and so the data is read from stdin the feed name
+arguments are specified and so the data is read from stdin then the feed name
 is empty.
 .Sh EXIT STATUS
 .Ex -std
diff --git a/sfeed_web.1 b/sfeed_web.1
index 3a83ca7..c48b0f9 100644
--- a/sfeed_web.1
+++ b/sfeed_web.1
@@ -1,4 +1,4 @@
-.Dd July 24, 2021
+.Dd July 25, 2021
 .Dt SFEED_WEB 1
 .Os
 .Sh NAME
@@ -11,6 +11,11 @@
 .Nm
 reads the HTML website as XML or HTML data from stdin and writes the found
 URLs to stdout.
+.Pp
+Such a link reference in HTML code looks like:
+.Bd -literal
+        <link rel="alternate" href="atom.xml" type="application/atom+xml" />
+.Ed
 .Sh OPTIONS
 .Bl -tag -width 8n
 .It Ar baseurl
@@ -33,7 +38,7 @@ Usually application/atom+xml or application/rss+xml.
 .Sh EXIT STATUS
 .Ex -std
 .Sh EXAMPLES
-Get URLs from xkcd website:
+Get URLs from a website:
 .Bd -literal
 curl -s -L 'https://codemadness.org/' | sfeed_web 'https://codemadness.org/'
 .Ed
diff --git a/sfeed_xmlenc.1 b/sfeed_xmlenc.1
index faaa26d..10133cf 100644
--- a/sfeed_xmlenc.1
+++ b/sfeed_xmlenc.1
@@ -1,4 +1,4 @@
-.Dd July 24, 2021
+.Dd July 25, 2021
 .Dt SFEED_XMLENC 1
 .Os
 .Sh NAME
@@ -14,7 +14,7 @@ which are not allowed in an encoding-name.
 .Sh EXIT STATUS
 .Ex -std
 .Sh EXAMPLES
-Get text-encoding from xkcd Atom feed:
+Get text-encoding from an Atom feed:
 .Bd -literal
 curl -s -L 'https://codemadness.org/atom.xml' | sfeed_xmlenc
 .Ed