iAdd description of new parser and escaping rule for gph links. - geomyidae - A small C-based gopherd. Err bitreich.org 70 hgit clone git://bitreich.org/geomyidae/ git://enlrupgkhuxnvlhsf6lc3fziv5h2hhfrinws65d7roiv6bfj7d652fid.onion/geomyidae/ URL:git://bitreich.org/geomyidae/ git://enlrupgkhuxnvlhsf6lc3fziv5h2hhfrinws65d7roiv6bfj7d652fid.onion/geomyidae/ bitreich.org 70 1Log /scm/geomyidae/log.gph bitreich.org 70 1Files /scm/geomyidae/files.gph bitreich.org 70 1Refs /scm/geomyidae/refs.gph bitreich.org 70 1Tags /scm/geomyidae/tag bitreich.org 70 1README /scm/geomyidae/file/README.gph bitreich.org 70 1LICENSE /scm/geomyidae/file/LICENSE.gph bitreich.org 70 i--- Err bitreich.org 70 1commit 157431d0ab6a420c93d1f188a3042d3f2252ebfb /scm/geomyidae/commit/157431d0ab6a420c93d1f188a3042d3f2252ebfb.gph bitreich.org 70 1parent ca5a2fc2bbcaf990979b29c43c8f0e4b69c2761e /scm/geomyidae/commit/ca5a2fc2bbcaf990979b29c43c8f0e4b69c2761e.gph bitreich.org 70 hAuthor: Christoph Lohmann <20h@r-36.net> URL:mailto:20h@r-36.net bitreich.org 70 iDate: Tue, 10 Oct 2017 20:10:08 +0200 Err bitreich.org 70 i Err bitreich.org 70 iAdd description of new parser and escaping rule for gph links. Err bitreich.org 70 i Err bitreich.org 70 iDiffstat: Err bitreich.org 70 i M geomyidae.8 | 33 ++++++++++++++++++++----------- Err bitreich.org 70 i Err bitreich.org 70 i1 file changed, 21 insertions(+), 12 deletions(-) Err bitreich.org 70 i--- Err bitreich.org 70 1diff --git a/geomyidae.8 b/geomyidae.8 /scm/geomyidae/file/geomyidae.8.gph bitreich.org 70 i@@ -199,18 +199,6 @@ In addition, geomyidae provides these: Err bitreich.org 70 i Unknown file types default to Type "9" (binary). Err bitreich.org 70 i .Ed Err bitreich.org 70 i . Err bitreich.org 70 i-.Bd -filled Err bitreich.org 70 i-Note: geomyidae doesn't require "informational" text to be formally Err bitreich.org 70 i-Typed as "[i|...]"; any line Err bitreich.org 70 i-.Em not Err bitreich.org 70 i-beginning with "[" is treated as informational, greatly simplifying the Err bitreich.org 70 i-formatting of index.gph files. However, if a line begins with a "t", this Err bitreich.org 70 i-"t" is left out. This quirk is there to allow "informational" text lines Err bitreich.org 70 i-beginning with a "[" to display. For dynamically generated index files Err bitreich.org 70 i-it may be desirable to either formally Type informational text or run Err bitreich.org 70 i-it through a filter to add a second "t" - .ie sed 's/^t/&&/' . Err bitreich.org 70 i-.Ed Err bitreich.org 70 i-. Err bitreich.org 70 i .It Ic Err bitreich.org 70 i = description of gopher item. Most printable characters should work. Err bitreich.org 70 i . Err bitreich.org 70 i@@ -235,6 +223,27 @@ If this is set to Err bitreich.org 70 i , the default port of the server is used. Err bitreich.org 70 i .El Err bitreich.org 70 i . Err bitreich.org 70 i+.Bd -filled Err bitreich.org 70 i+Note: geomyidae doesn't require "informational" text to be formally Err bitreich.org 70 i+Typed as "[i|...]"; any line Err bitreich.org 70 i+.Em not Err bitreich.org 70 i+beginning with "[" is treated as informational, greatly simplifying the Err bitreich.org 70 i+formatting of index.gph files. However, if a line begins with a "t", this Err bitreich.org 70 i+"t" is left out. This quirk is there to allow "informational" text lines Err bitreich.org 70 i+beginning with a "[" to display. For dynamically generated index files Err bitreich.org 70 i+it may be desirable to either formally Type informational text or run Err bitreich.org 70 i+it through a filter to add a second "t" - .ie sed 's/^t/&&/' . Err bitreich.org 70 i+.Ed Err bitreich.org 70 i+.Bd -filled Err bitreich.org 70 i+Note 2: You can escape a pipe ("|") character in for example a Err bitreich.org 70 i+.Em Err bitreich.org 70 i+field by prepending a slash ("\\"). Err bitreich.org 70 i+.Ed Err bitreich.org 70 i+.Bd -filled Err bitreich.org 70 i+Note 3: The gph parser is very forgiving. If the link structure is not parsed Err bitreich.org 70 i+correctly, then the original line is printed. Err bitreich.org 70 i+.Ed Err bitreich.org 70 i+. Err bitreich.org 70 i .Ss index.gph Example Err bitreich.org 70 i A root.gph file for a server running on host=frog.bog, port=70. Note use Err bitreich.org 70 i of optional [i]nformational Item (line 2) for vertical space insertion: Err bitreich.org 70 .