From 5e28c047112d679261897741b64d96c84706ed89 Mon Sep 17 00:00:00 2001 From: KatolaZ Date: Thu, 24 Jan 2019 10:46:48 +0000 Subject: add Dependencies in README.md --- README.md | 41 ++++++++++++++++++++++++++++++++++++++--- 1 file changed, 38 insertions(+), 3 deletions(-) diff --git a/README.md b/README.md index 60d0182..bd05d1c 100644 --- a/README.md +++ b/README.md @@ -7,20 +7,42 @@ an ed-based client by Solene Rapenne (gopher://bitreich.org/1/usr/solene/). `gophed` is distributed under the MIT License. A copy of the LICENSE is available in the repo. + + Dependencies +================== + +`gophed` requires only: + + - a POSIX shell (/bin/sh) + - netcat (nc) + - ed (the standard editor!) + - awk + - cut + - sed + + + Usage +=========== The first time you run `gophed` you need to initialise it via: +``` ./gophed -i +``` This will create a few symlinks in the current folder, namely `g`, `v`, and `d`, which will be used as `gophed` commands. Once `gophed` has been initialised, you can start visiting some gopherholes: +``` ./gophed / kalos.mine.nu 70 +``` or equivalently: +``` ./v / kalos.mine.nu 70 +``` This command will download the corresponding resource, and print it on output with line numbers. An excerpt is reported below: @@ -51,8 +73,11 @@ can change the default prompt to any single character by changing the PROMPT variable. Now, if you want to visit the selector at line 23, you would type: +``` !./g % 24 [ENTER] +``` + at the prompt. This will effectively spawn another `gophed` instance, telling it to get the selector at line 23 in the current document, and to load the corresponding resource. In this case we will have something @@ -86,34 +111,46 @@ like: Well, if you want now to go to the resource at line 17, you would type: +``` !./g % 17 [ENTER] +``` when you are done with viewing the current resource, you just type: +``` q [ENTER] +``` at the `gophed` prompt (well, that one is indeed ed(1) prompt...), and you will be back at the gopher resources you had visited before. Typing +``` q [ENTER] +``` again will bring you back in history again. If you give a `q` command on the first page, you will leave `gophed`. If you would instead like to save the resource pointed by a selector, you will use the command: +``` !./d % NUMBER [ENTER] +``` where NUMBER is the number of the line where the selector appears in the current page. The resource will be saved at "HOSTNAME/URI" where HOSTNAME is the name of the host and URI is the path to the resource. If you don't remember which line is which, you can just give: +``` %n [ENTER] +``` at the prompt. If you don't remember which resource you are currently visiting, typing: +``` f [ENTER] +``` at the `gophed` prompt will give some hints. If you are an ed(1) user, you will totally understand what we are up to here, and probably will @@ -121,8 +158,6 @@ now have a good laugh. If you don't know how to use ed(1), instead, then this is probably the right time to start learning it. Remember: ed(1) is the standard editor, and an awesome one at that... -HND +HH KatolaZ - - -- cgit v1.2.3