iamend README and rename to 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 00b84065d6b6b216df2c65eaa49dd6f2cd5725b5 /scm/gramscii/commit/00b84065d6b6b216df2c65eaa49dd6f2cd5725b5.gph bitreich.org 70 1parent 6cda4416b3aa5644adee5579225c145c9c448ede /scm/gramscii/commit/6cda4416b3aa5644adee5579225c145c9c448ede.gph bitreich.org 70 hAuthor: KatolaZ URL:mailto:katolaz@freaknet.org bitreich.org 70 iDate: Wed, 24 Jul 2019 13:02:07 +0100 Err bitreich.org 70 i Err bitreich.org 70 iamend README and rename to README.md Err bitreich.org 70 i Err bitreich.org 70 iDiffstat: Err bitreich.org 70 i D README | 53 ------------------------------ Err bitreich.org 70 i A README.md | 77 +++++++++++++++++++++++++++++++ Err bitreich.org 70 i Err bitreich.org 70 i2 files changed, 77 insertions(+), 53 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,53 +0,0 @@ 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 1diff --git a/README.md b/README.md /scm/gramscii/file/README.md.gph bitreich.org 70 i@@ -0,0 +1,77 @@ 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 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+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+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+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+``` 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+ 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+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+ Err bitreich.org 70 i+There has been a recent proliferation of browser-based point-and-click Err bitreich.org 70 i+tools to draw ASCII charts. Like, are you serious? Why on Earth should Err bitreich.org 70 i+people accept to load hundred thousands LOCs of obscure javascript code Err bitreich.org 70 i+on a hyper-bloated web browser and use a fancy point-and-click interface Err bitreich.org 70 i+to produce......guess what......ASCII charts that are best-viewed viewed Err bitreich.org 70 i+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+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 i+intellectual, a philosopher, and an artist, and maintained that societal Err bitreich.org 70 i+changes are only possible when a class exerts intellectual and moral Err bitreich.org 70 i+leadership over its contemporaries. So just get rid of all your shiny Err bitreich.org 70 i+iPointless things and come back to reality. Err bitreich.org 70 .