add sfeed_gopher: generic gopher formatting program, remove sfeed_gph

1 files changed, 59 insertions, 0 deletions

diff --git a/sfeed_gopher.1 b/sfeed_gopher.1
new file mode 100644
index 0000000..a57340a
--- /dev/null
+++ b/sfeed_gopher.1
@@ -0,0 +1,59 @@
+.Dd January 18, 2020
+.Dt SFEED_GOPHER 1
+.Os
+.Sh NAME
+.Nm sfeed_gopher
+.Nd format feed data to Gopher files
+.Sh SYNOPSIS
+.Nm
+.Op Ar file...
+.Sh DESCRIPTION
+.Nm
+formats feed data (TSV) from
+.Xr sfeed 1
+from stdin or
+.Ar file
+to stdout in the raw Gopher output format.
+.Pp
+If one or more
+.Ar file
+are specified, the basename of the
+.Ar file
+is used as the feed name in the output.
+.Nm
+creates a index index file and for each feed creates a file in the
+format feedname.
+.Pp
+If no
+.Ar file
+parameters are specified and 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
+time of formatting are counted and marked as new.
+.Bl -tag -width Ds
+.It Ev SFEED_GOPHER_PATH
+This environment variable can be used as the prefix for each path in the
+index file.
+The default is "/".
+.It Ev SFEED_GOPHER_HOST
+This environment variable can be used as the Gopher Host field.
+The default is "127.0.0.1".
+.It Ev SFEED_GOPHER_PORT
+This environment variable can be used as the Gopher Port field.
+The default is "70".
+.El
+.Sh SEE ALSO
+.Xr sfeed 1 ,
+.Xr sfeed 5
+.Sh STANDARDS
+.Rs
+.%D March 1993
+.%R RFC 1436
+.%T The Internet Gopher Protocol
+.Re
+.Sh AUTHORS
+.An Hiltjo Posthuma Aq Mt hiltjo@codemadness.org
+.Sh CAVEATS
+The common-used 'h' and 'i' types are used in this program.
+These types are an extension to Gopher.