sfeed_gopher.1 - sfeed - RSS and Atom parser
 (HTM) git clone git://git.codemadness.org/sfeed
 (DIR) Log
 (DIR) Files
 (DIR) Refs
 (DIR) README
 (DIR) LICENSE
       ---
       sfeed_gopher.1 (2017B)
       ---
            1 .Dd September 21, 2025
            2 .Dt SFEED_GOPHER 1
            3 .Os
            4 .Sh NAME
            5 .Nm sfeed_gopher
            6 .Nd format feed data to Gopher files
            7 .Sh SYNOPSIS
            8 .Nm
            9 .Op Ar
           10 .Sh DESCRIPTION
           11 .Nm
           12 formats feed data (TSV) from
           13 .Xr sfeed 1
           14 from stdin or for each
           15 .Ar file
           16 to stdout in the raw Gopher output format.
           17 .Pp
           18 If one or more
           19 .Ar file
           20 arguments are specified then the basename of the
           21 .Ar file
           22 is used as the feed name in the output.
           23 .Nm
           24 creates an index file named "index" and for each feed it creates a file with
           25 the same name as the basename of the feed
           26 .Ar file .
           27 .Pp
           28 If no
           29 .Ar file
           30 arguments are specified and so the data is read from stdin then the data is
           31 written to stdout and no files are written.
           32 .Pp
           33 Items with a timestamp from the last day compared to the system time at the
           34 time of formatting are counted and marked as new.
           35 This value might be overridden through environment variables.
           36 Items are marked as new with the prefix "N" at the start of the line.
           37 If an index file is used then feeds with new items are marked as new with the
           38 prefix "N" at the start of the line.
           39 .Sh ENVIRONMENT
           40 .Bl -tag -width Ds
           41 .It Ev SFEED_GOPHER_PATH
           42 This environment variable can be used as the prefix for each path in the
           43 index file.
           44 The default is "/".
           45 .It Ev SFEED_GOPHER_HOST
           46 This environment variable can be used as the Gopher Host field.
           47 The default is "127.0.0.1".
           48 .It Ev SFEED_GOPHER_PORT
           49 This environment variable can be used as the Gopher Port field.
           50 The default is "70".
           51 .It Ev SFEED_NEW_AGE
           52 Overwrite the maximum age in seconds to mark feeds as new.
           53 By default this is 86400, which equals one day.
           54 .El
           55 .Sh EXIT STATUS
           56 .Ex -std
           57 .Sh EXAMPLES
           58 .Bd -literal
           59 SFEED_GOPHER_HOST="codemadness.org" SFEED_GOPHER_PATH="/feeds/" \e
           60         sfeed_gopher ~/.sfeed/feeds/*
           61 .Ed
           62 .Sh SEE ALSO
           63 .Xr sfeed 1 ,
           64 .Xr sfeed 5
           65 .Sh STANDARDS
           66 .Rs
           67 .%D March 1993
           68 .%R RFC 1436
           69 .%T The Internet Gopher Protocol
           70 .Re
           71 .Sh AUTHORS
           72 .An Hiltjo Posthuma Aq Mt hiltjo@codemadness.org
           73 .Sh CAVEATS
           74 The common-used 'h' and 'i' types are used in this program.
           75 These types are an extension to Gopher.