ireplace in README.md - gramscii - A simple editor for ASCII box-and-arrow charts Err bitreich.org 70 1Log /scm/gramscii/log.gph bitreich.org 70 1Files /scm/gramscii/files.gph bitreich.org 70 1Refs /scm/gramscii/refs.gph bitreich.org 70 1Tags /scm/gramscii/tag bitreich.org 70 1README /scm/gramscii/file/README.md.gph bitreich.org 70 1LICENSE /scm/gramscii/file/COPYING.gph bitreich.org 70 i--- Err bitreich.org 70 1commit 11bc65417241ce068ebd65ef4670d7d3e7c9ae8d /scm/gramscii/commit/11bc65417241ce068ebd65ef4670d7d3e7c9ae8d.gph bitreich.org 70 1parent 00b84065d6b6b216df2c65eaa49dd6f2cd5725b5 /scm/gramscii/commit/00b84065d6b6b216df2c65eaa49dd6f2cd5725b5.gph bitreich.org 70 hAuthor: KatolaZ URL:mailto:katolaz@freaknet.org bitreich.org 70 iDate: Wed, 24 Jul 2019 13:06:03 +0100 Err bitreich.org 70 i Err bitreich.org 70 ireplace in README.md Err bitreich.org 70 i Err bitreich.org 70 iDiffstat: Err bitreich.org 70 i M README.md | 34 ++++++++++++++++---------------- Err bitreich.org 70 i Err bitreich.org 70 i1 file changed, 17 insertions(+), 17 deletions(-) Err bitreich.org 70 i--- Err bitreich.org 70 1diff --git a/README.md b/README.md /scm/gramscii/file/README.md.gph bitreich.org 70 i@@ -1,54 +1,54 @@ Err bitreich.org 70 i gramscii -- interactive tool for ASCII box-and-arrows charts Err bitreich.org 70 i ============================================================ Err bitreich.org 70 i Err bitreich.org 70 i-```gramscii``` (pronounced "grrr'a(m)sky", more or less like "ASCII" but Err bitreich.org 70 i+`gramscii` (pronounced "grrr'a(m)sky", more or less like "ASCII" but Err bitreich.org 70 i with a leading "grrr") is a simple CLI tool to create and edit Err bitreich.org 70 i box-and-arrows charts using ASCII characters. Err bitreich.org 70 i Err bitreich.org 70 i-```gramscii``` is interactive and its commands are quite intuitive to Err bitreich.org 70 i+`gramscii` is interactive and its commands are quite intuitive to Err bitreich.org 70 i anybody who does not need a mouse to be productive. You can move around Err bitreich.org 70 i-the screen with the usual ```hjkl``` keys, but you will travel at Err bitreich.org 70 i-ligthning speed by placing one of your other fingers on ```SHIFT```. You Err bitreich.org 70 i-start drawing a box with ```b```, and you place an arrow with ```a```. Err bitreich.org 70 i+the screen with the usual `hjkl` keys, but you will travel at Err bitreich.org 70 i+ligthning speed by placing one of your other fingers on `SHIFT`. You Err bitreich.org 70 i+start drawing a box with `b`, and you place an arrow with `a`. Err bitreich.org 70 i For more information, just read the manpage. Err bitreich.org 70 i Err bitreich.org 70 i-```gramscii``` aims at remaining small, avoiding bloat, and being Err bitreich.org 70 i+`gramscii` aims at remaining small, avoiding bloat, and being Err bitreich.org 70 i portable. It is written in ASCII C90, it requires only an ANSI Err bitreich.org 70 i VT100-compatible terminal (real or virtual), and it does not use any Err bitreich.org 70 i external library (nope, not even ncurses!). Hence, you should be able to Err bitreich.org 70 i-compile and run ```gramscii``` on any operating system with a C90 libc Err bitreich.org 70 i+compile and run `gramscii` on any operating system with a C90 libc Err bitreich.org 70 i and a VT100 terminal emulator. Err bitreich.org 70 i Err bitreich.org 70 i-I have tested it on Linux and *BSD, compiled with ```gcc```, Err bitreich.org 70 i-```clang```, and ```tcc```, and linked it against ```glibc```, Err bitreich.org 70 i-```musl```, and whatever libc was available on FreeBSD, OpenBSD, and Err bitreich.org 70 i+I have tested it on Linux and *BSD, compiled with `gcc`, Err bitreich.org 70 i+`clang`, and `tcc`, and linked it against `glibc`, Err bitreich.org 70 i+`musl`, and whatever libc was available on FreeBSD, OpenBSD, and Err bitreich.org 70 i NetBSD. It just worked. Err bitreich.org 70 i Err bitreich.org 70 i INSTALL Err bitreich.org 70 i ======= Err bitreich.org 70 i Err bitreich.org 70 i-Edit ```config.h``` and/or ```config.mk``` to suit your preferences. Err bitreich.org 70 i+Edit `config.h` and/or `config.mk` to suit your preferences. Err bitreich.org 70 i Then just: Err bitreich.org 70 i ``` Err bitreich.org 70 i make Err bitreich.org 70 i ``` Err bitreich.org 70 i Err bitreich.org 70 i-to build ```gramsci``` and: Err bitreich.org 70 i+to build `gramsci` and: Err bitreich.org 70 i ``` Err bitreich.org 70 i ./gramscii Err bitreich.org 70 i ``` Err bitreich.org 70 i-to execute it. ```man``` is your friend. Err bitreich.org 70 i+to execute it. `man` is your friend. Err bitreich.org 70 i Err bitreich.org 70 i Err bitreich.org 70 i WHY? Err bitreich.org 70 i ==== Err bitreich.org 70 i Err bitreich.org 70 i-As most of the software out there, ```gramscii``` comes out of Err bitreich.org 70 i+As most of the software out there, `gramscii` comes out of Err bitreich.org 70 i frustration and pain. Err bitreich.org 70 i Err bitreich.org 70 i I have been producing box-and-arrow diagrams in ASCII for quite a while. Err bitreich.org 70 i-I know that there exist ad-hoc plugins for ```vim(1)``` and Err bitreich.org 70 i-```emacs(1)```, but I was not happy with any of them, to say the least. Err bitreich.org 70 i+I know that there exist ad-hoc plugins for `vim(1)` and Err bitreich.org 70 i+`emacs(1)`, but I was not happy with any of them, to say the least. Err bitreich.org 70 i There are also a few point-and-click GUI tools to do the same, but most Err bitreich.org 70 i of them depend on a variety of libraries/modules. And again, why would Err bitreich.org 70 i you need a fancy GUI to create ASCII charts? Err bitreich.org 70 i@@ -67,7 +67,7 @@ functional. Err bitreich.org 70 i But wait... Err bitreich.org 70 i ============ Err bitreich.org 70 i Err bitreich.org 70 i-You might have noticed that the name ```gramscii``` is reminiscent of Err bitreich.org 70 i+You might have noticed that the name `gramscii` is reminiscent of Err bitreich.org 70 i Antonio Gramsci, the phylosopher and politician who was among the Err bitreich.org 70 i founders of the Italian Communist Party in 1921. Now, Gramscii (the Err bitreich.org 70 i philosopher) strongly believed that every single human is an Err bitreich.org 70 .