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 <katolaz@freaknet.org> 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
.
Response:
text/plain