iadd README - 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 f73faa7a82282660413e4056486e452af61832c0 /scm/gramscii/commit/f73faa7a82282660413e4056486e452af61832c0.gph bitreich.org 70 1parent 4cb5948229fea24c9a2eb3413d6dbe53613bada7 /scm/gramscii/commit/4cb5948229fea24c9a2eb3413d6dbe53613bada7.gph bitreich.org 70 hAuthor: KatolaZ URL:mailto:katolaz@freaknet.org bitreich.org 70 iDate: Sun, 21 Jul 2019 08:43:44 +0100 Err bitreich.org 70 i Err bitreich.org 70 iadd README Err bitreich.org 70 i Err bitreich.org 70 iDiffstat: Err bitreich.org 70 i M README | 55 +++++++++++++++++++++++++++++-- Err bitreich.org 70 i Err bitreich.org 70 i1 file changed, 53 insertions(+), 2 deletions(-) Err bitreich.org 70 i--- Err bitreich.org 70 1diff --git a/README b/README /scm/gramscii/file/README.gph bitreich.org 70 i@@ -1,2 +1,53 @@ Err bitreich.org 70 i-Simple tool to draw ascii box plots from the terminal. Err bitreich.org 70 i-No need to use 1 million line of javascript code on a browser. 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+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+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 another finger on ```SHIFT```. You start Err bitreich.org 70 i+drawing a box with ```b```, and you place an arrow with ```a```. For Err bitreich.org 70 i+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+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+and a VT100 terminal emulator. 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+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+ Err bitreich.org 70 i+At the same time, there has been a recent proliferation of browser-based Err bitreich.org 70 i+point-and-click tools to draw ASCII charts. Like, are you serious? Why Err bitreich.org 70 i+on Earth should people accept to load 1 million LOCs of obscure Err bitreich.org 70 i+javascript code on a hyper-bloated web browser and use a fancy Err bitreich.org 70 i+point-and-click interface to produce......guess what......ASCII charts Err bitreich.org 70 i+that are best-viewed viewed on a VT100 terminal? Err bitreich.org 70 i+ Err bitreich.org 70 i+We must say no to madness. We must repudiate bloat. We must reject Err bitreich.org 70 i+useless featurism. Software must be reasonable, simple, small, and Err bitreich.org 70 i+functional. Err bitreich.org 70 i+ Err bitreich.org 70 i+But wait... Err bitreich.org 70 i+============ Err bitreich.org 70 i+ Err bitreich.org 70 i+If you have noticed that the name ```gramscii``` is too much reminiscent Err bitreich.org 70 i+of Antonio Gramsci, the phylosopher and politician who was among the Err bitreich.org 70 i+founders of the Italian Communist Party in 1921, who strongly believed Err bitreich.org 70 i+that every single human is an intellectual, a philosopher, and an Err bitreich.org 70 i+artist, and who maintained that societal changes are only possible when Err bitreich.org 70 i+a class exerts intellectual and moral leadership over its Err bitreich.org 70 i+contemporaries, well then just get rid of all your shiny iPointless Err bitreich.org 70 i+things and come back to reality. Err bitreich.org 70 .