In the last few days I finally had a bit of time to spend on a project I
had been thinking about for a while: an editor for ASCII box-and-arrow
charts. The result is `gramscii`:

  git clone git://cgit.mine.nu/gramscii
  gopher://cgit.mine.nu/1/cgit-70.cgi?url=gramscii/
  https://cgit.mine.nu/gramscii

Just clone the repo and go through the README and the manpage.
Alternatively, you can grasp the basics of `gramscii` by reading the
little "man poem" I wrote for it, which I also presented at the last
bitreich conference 2019. It is reported below. I am definitely not good
at poetry, but I am convinced we need more of it in programming ;P


                           -------------
              ###########  -------------
              ###########  -------------
              ###########  -------------
        !!!!!!#####              -------
        !!!!!!#####  a man poem  -------
        !!!!!!#####              -------
        !!!!!!!!!!!      for     -------
        !!!!!@@@@@@              -------
        !!!!!@@@@@@   gramscii   -------
             @@@@@@              
             @@@@@@@@@...........
             @@@@@@@@@@@
             @@@@@@@@@@@
        

   'a' is for arrow                    +------->  
                                                  
   'b' is for box                      +-------+  
                                       |       |<---+
                                       +-------+    |
    these are the gramscii's                        |
                                 +----+         +---+---+
    main building blocks.        |    |         |       |
                                 |    +-------->|       |
                                 +----+         |       |
                                                +-------+
 
    'C' is to crop,               _    ___  
                                 (_)  / _ \ 
    to get rid of crap,           _  |  __/ 
                                 (_)  \___| 
    'e' is to edit                 
     
    a previous file back.
       



   'g' is to go                          ^
                                         |
   wherever you like                     |
                                    <----o--------->
   just add a direction                  |
                                         |
   and prepare for the hike              v
    
    
    
                                         
   'h'-'j'-'k'-'l'                       ___   ___                                  
                                        ( @ \v/ m )                                 
   work like in vi(1)                    \__+|+__/                                  
                                          {_/ \_}                                   
   but if you hold [SHIFT]                                                          
   
   you'll feel like you are flying



   'm' is for middle                  (\ 
                                      \'\ 
   but only after 'g'                  \'\     __________ 
                                       / '|   ()_________) 
   'N' starts afresh                   \ '/    \ ~~~~~~~~ \ 
                                         \       \ ~~~~~~   \ 
   'i' inserts text.                     ==).      \__________\ 
                                        (__)       ()__________) 
                                       
                                                  
    
   'p' is to put                         _  __      ____ _  
                                        (_) \ \ /\ / / _` | 
   whatever you have yanked              _   \ V  V / (_| | 
                                        (_)   \_/\_/ \__, | 
   'q' is to quit                                       |_| 
    
   after gramscii you have thanked.




   'Q' is like 'q'                              _  
                                    _    __ _  | | 
   but gramscii'll shut up         (_)  / _` | | | 
                                    _  | (_| | |_| 
   'R' will redraw                 (_)  \__, | (_) 
                                           |_|     
   a screen that's fuck'd up. 
                           
                           
                           
   'u' is to undo                   /|     |\
                                   / +-----+ \
   if you have lost your track     \ +-----+ / 
                                    \|     |/ 
   'U' will re-do 
    
   and get your stuff back. 
    

 
   'v' is for VISUAL                   __         __                
                                      /.-'       `-.\         
   as you do in vim(1)               //             \\              
                                    /j_______________j\       
   to cut, yank, and crop          /o.-==-. .-. .-==-.o\            
                                   ||      )) ((      ||      
   and to fill-up your screen.      \\____//   \\____//   hjw       
                                     `-==-'     `-==-'        
    
    
                                   ___________________ 
   'w' is to save                 |,-------.          |            
                                  || m1a   |          |
   your work in a file            |`-------'          [             
                                  |        .-.        |
   'W' you can use                |       |   |       |             
                                  |        `-' o      |
   if you feel 'agile'.           |        .-.        |             
                                  |        : :        |
                                  |        :_;        |
                                  |_______.___._______ 
                                                      

 
   'x' is to erase                      _    _ 
                                       (_)  / ) 
   the stuff you don't need              | (_/  
                                        _+/   
   'y' is to yank                      //|\ 
                                      // | ) 
   but only after 'v'.               (/  |/      s-v 
    
    
    
    
   '-', '|', and '+'               /| |\         |   |         |   |                 
                                  ( \./ )       ( \ / )       (.\ /.)         
   will dress up your lines        \ : /         \\*//         \   /                 
                                   ) : (         ))*((         ) . (          
   '<>'                           /  :  \       ///|\\\       /  v  \                
                                  |__:__|      ////|\\\\     /.......\ hmmm...
   will care of end-points.                                                          
                                       Riitta Rasimus                                 



   be careful though              \ 
                                   '-.__.-' 
   this is just new stuff          /oo |--.--,--,--. 
                                   \_.-'._i__i__i_.' 
   if you find a bug                     """""""""   
                               fsc
   send over a patch. 
    
    
    
    
   this is gramscii in brief        _ \ __ __|  ____|   \  |  
                                   |   |   |    |      |\/ |  
   just in one page                __ <    |    __|    |   |  
                                  _| \_\  _|   _|     _|  _|  
   but don't foul yourself 
    
   go RTFM!


  ---------------------------------------------------------------------
          DISCLAIMER: most ASCII arts are (c) by their original 
                      authors. If no author is indicated, it is 
                      either unknown or myself. In the latter 
                      cases the ASCII arts are free for all.