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