From 6deecc0cd94367cf106832ed7e8c4e4b9891bcb7 Mon Sep 17 00:00:00 2001 From: Stefan Majewsky Date: Sat, 19 Aug 2017 21:20:24 +0200 Subject: documentation for prettyprompt --- README.md | 36 ++++++++++++++++++++++++++++++++++++ screenshot-prettyprompt.png | Bin 0 -> 179227 bytes 2 files changed, 36 insertions(+) create mode 100644 README.md create mode 100644 screenshot-prettyprompt.png diff --git a/README.md b/README.md new file mode 100644 index 0000000..057d0ba --- /dev/null +++ b/README.md @@ -0,0 +1,36 @@ +# Gofu + +Gofu is a multibinary containing several utilities that I use everyday. + +## What's with the name? + +A gofu, [according to Wikipedia](https://en.wikipedia.org/wiki/Gofu), is a +type of household amulet or talisman, issued by a Shinto shrine, hung in the +house for protection. + +Alternatively, the name can also be read as +"[Go](https://golang.org)-[fu](http://www.retrologic.com/jargon/F/suffix-fu.html)". + +# List of applets + +## `prettyprompt` + +This renders my shell prompt. Among other things, it identifies the current +host by name and signature color (in the screenshot below, dark green for +Krikkit); highlights path elements inside a Git repo (if any) and path elements +that have been deleted; reports the current Git repo status; and reports the exit +code of the previous command (if it failed). It also heavily saves space where +possible, e.g. if the cwd starts with `$GOPATH/src/`, that is shortened to +`repo:`. A prefix of `$HOME/` is omitted entirely, as is my default user name. + +![prettyprompt screenshot](./screenshot-prettyprompt.png) + +## `rtree` + +TODO: document + +# Installation + +```bash +$ make && make install +``` diff --git a/screenshot-prettyprompt.png b/screenshot-prettyprompt.png new file mode 100644 index 0000000..f7fd993 Binary files /dev/null and b/screenshot-prettyprompt.png differ -- cgit v1.3.1