roebe 0.5.109

data/doc/todo/todo_for_the_roebe_shell.md

@@ -0,0 +1,1216 @@
+------------------------------------------------------------------------
+(1) History support should be tested on windows more thoroughly.
+    Then this entry can be removed.
+------------------------------------------------------------------------
+(2) Ensure that "1" and "2" work and cd to the first or
+    second directory, respectively.
+------------------------------------------------------------------------
+(3) ^^^  enable windows-installer actions ... first hardcode
+    them on a fresh windows install, then perhaps add into
+    a yaml file or so.
+------------------------------------------------------------------------
+(4)   LOGFILE_FOR_HISTORY =
+^^^^ fix this constant; probably remove it
+------------------------------------------------------------------------
+(5) make sure that 
+suiadoa
+^^^ works for the given input
+------------------------------------------------------------------------
+(6) ->  dia --silent-startup
+this should work.
+------------------------------------------------------------------------
+(7)
+
+      this_file = "#{DIA_BASE}menu/menu.rb"
+      available_menu_options = CaseParser.parse(
+        this_file, :continue
+      )
+      
+^^^ hmm reconsider this again
+------------------------------------------------------------------------
+(8) cat2
+    ^^^ port cat2 into cat().
+------------------------------------------------------------------------
+- support:
+
+require 'foobar'
+
+AND
+
+require foobar
+
+^^^ both should work
+------------------------------------------------------------------------
+(9)
+add: 
+use_colours.yml
+to make it work...
+and query this from the commandline
+AND enable toggle functionality.
+------------------------------------------------------------------------
+(10) - wenn wir radio stations mittels
+radio? anzeigen
+und dann zum beispiel elektieren
+per anfrage oder so...
+hmmm oder einfach den name
+der station eingeben und das dann abspielen
+
+das muss man dann im case/when menu registrieren
+-------------------------------------------------------------------------------
+(11) string_colour_parser should be fully integrated
+     into the dia-shell, then the gem should be removed.
+-------------------------------------------------------------------------------
+(12) /home/Programs
+
+^^^ here we must replace all these eventually
+with some more generic way.
+-------------------------------------------------------------------------------
+(13) Try out diamond shell as init system
+
+A perpetually running shell, like bash.
+BUT WHERE and HOW.
+
+hhmnmmmmmmmmm
+
+test this early on ...
+This is on the todo list:
+------------------------------------------------------------------------------
+(14) add a way to dump the configuration into a 
+HASH; for display
+
+^^^ ok this is possible via:
+  raw_config
+AND also save it into the HOME dir of the user
+(2) use that as config, rather than 
+/Programs/Ruby, if the latter is NOT readable
+to the user...
+-------------------------------------------------------------------------------
+(15) Consider adding asciitable again, for the help section. 
+
+oder rewrite asciitable... und gibt es in
+ascii_paradise
+update asciiparadise
+dann schau das hier nochmals an.
+-------------------------------------------------------------------------------
+(16) Der prompt sollte ne configuration option werden, so das wir den
+immer speichern. Gibt es diese option jedoch nit, dann müssen wir
+eben einen default Wert annehmen.
+-------------------------------------------------------------------------------
+(17)  - THE FOLLOWING REQUIRES RUBY 1.9 TESTING:
+  
+  When someone presses "cd", then adds an empty char ' ' then 
+  somethinglike qt<TAB>, we want to list ONLY dirs and NOT files.
+  cd would never work. :>
+
+      rffruby tabcompletion
+  I think this does not work yet (see readline_dir.rb) because
+  if we make a new space char, we CAN NOT GET THE COMPLETE INPUT LINE.
+  It works after 1.9.x though, so we try again later.
+
+-------------------------------------------------------------------------------
+
+  @xx = []
+  @xx << "hi"
+
+
+ 
+The above should work. And it works since Nov 2015.
+
+I think we need a mini-irb class for this.
+
+started, called:
+  $RSRC/mini_irb/mini_irb.rb
+
+Also, Session may exist and work as well.
+
+-------------------------------------------------------------------------------
+(18) must create diamondrc file
+
+then also must make sure that we can load it.
+
+--> have to add more options... perhaps also autogenerate the
+existing diamondrc values.
+
+-------------------------------------------------------------------------------
+(19) RC-file loading
+
+DiamondShell.config.should_load_rc is a boolean option determining whether the rc
+file (.diamondrc) should be loaded.
+
+Setting it to false disables RC file loading.
+
+
+^^^^ should be added and documented, perhaps add a new subsection in the
+diatut altogether about rc files
+
+-------------------------------------------------------------------------------
+(20) irb einbetten so das an also irb starten kann von
+     der diamond_shell.rb aus.
+-------------------------------------------------------------------------------
+(21) -  we need a way to use and set arrays.
+      x = []
+
+class RubyParser
+end
+^^^ also via pry
+
+
+-------------------------------------------------------------------------------
+
+The help option shall become dynamic.
+
+We will simply register this in an Array:
+
+register_this_help_option(
+  ['touch','this does bla']
+)
+^^^ so that '?' works
+
+-------------------------------------------------------------------------------
+(22) Command Shell Integration
+
+A line of input that begins with a '.' will be forwarded to the command shell.
+
+`` also works like that and has already been enabled.
+
+
+`cat foo.txt | grep bar`
+ .cat #{Dir['*.*'].sample} | wc -l
+
+^^^ this should work 
+
+This enables us to navigate the file system, spawn editors, and run git
+and rake directly from within Pry.
+
+Further, we can use the shell-mode command to incorporate the present
+working directory into the Pry prompt and bring in (limited at this
+stage, sorry) file name completion.
+
+We can also interpolate Ruby code directly into the shell by using the
+normal #{} string interpolation syntax.
+
+In the code below we're going to switch to shell-mode and edit the .pryrc
+file in the home directory. We'll then cat its contents and reload the file.
+
+pry(main)> shell-mode
+pry main:/home/john/ruby/projects/pry $ .cd ~
+pry main:/home/john $ .emacsclient .pryrc
+pry main:/home/john $ .cat .pryrc
+def hello_world
+  puts "hello world!"
+end
+pry main:/home/john $ load ".pryrc"
+=> true
+pry main:/home/john $ hello_world
+hello world!
+
+We can also interpolate Ruby code into the shell. In the example
+below we use the shell command cat on a random file from the
+current directory and count the number of lines in that file
+with wc:
+
+pry main:/home/john $ .cat #{Dir['*.*'].sample} | wc -l
+44
+
+
+-------------------------------------------------------------------------------
+(23) -norc
+
+rda -noconfig 
+
+Don't read the `~/.bashrc' initialization file in an 
+interactive shell. This is on by default if the shell
+is invoked as sh.
+ 
+^^^ This means dont read in the config data.
+
+^^ Da gibt es aber einen bug - die commandline aktionen
+werden erst dann evaluiert nachdem wir die
+config eingelesen wurde. Bzw es ist noch nicht perfekt abgestimmt.
+
+Perhaps we have to rewrite this but probably not. It works
+partially now, will have to continue to remain active.
+Also, we need to give us the possibility to read in from
+a file called /~.diamondshellrc
+-------------------------------------------------------------------------------
+(24) Long Term Goal for Version 1.0 of the DiaShell:
+
+ - COMPLETELY replace bash with DiaShell for my personal use.
+
+What all is required for this to happen?
+
+  - More flexible way to display file/directory listing.
+    We need to simulate "ls --help" behaviour.
+  - Manage background jobs.
+  - Enable Ruby code as-is, so that we have an embedded pry
+    or embedded irb. For this we need to investigate pry
+    more closely.
+
+Along with the single character shell command-line options there are
+several other options that you can use. These options must appear on
+the command line before the single character command options to be
+recognized.
+
+-rcfile filename
+Execute commands from filename (instead of `~/.bashrc')
+in an interactive shell. 
+
+-noprofile 
+Don't load the system-wide startup file `/etc/profile' or any 
+of the personal initialization files `~/.bash_profile', 
+`~/.bash_login', or `~/.profile' when bash is invoked as a login shell. 
+
+-login 
+Make this shell act as if it were directly invoked from login.
+This is equivalent to `exec - bash' but can be issued from another 
+shell, such as csh. If you wanted to replace your current login
+shell with a Bash login shell, you would say `exec bash -login'. 
+
+-nobraceexpansion
+Do not perform curly brace expansion (see section Brace Expansion). 
+
+-nolineediting
+
+Do not use the GNU Readline library (see section Command Line
+Editing) to read interactive command lines. 
+
+-posix 
+
+Change the behavior of Bash where the default operation 
+differs from the Posix 1003.2 standard to match the standard. 
+This is intended to make Bash behave as a strict superset
+of that standard.
+
+ --no-pager               Disable pager for long output
+
+
+-------------------------------------------------------------------------------
+(25) consider adding:
+
+  ??collapse
+  
+  to show "extended documentation"
+  for this to work, we may have to grab the content of 
+  the tutorial. hmmm.
+  
+  content = serve(:dia_tut)
+  index = content.scan(/<!-- Header for: collapse -->/)
+  # grab afterwards
+  # finish at the last section
+  
+-------------------------------------------------------------------------------
+(26) -> add tab completion support for ruby stdlib docu
+
+So we can look at the docu from within DiaShell
+THEN document it as well.
+Hmm this works except for the docu-finding part.
+
+this works via
+  show-doc
+  [17] pry(main)> show-doc String#inspect
+
+From:       string.c (C Method):
+Owner:      String
+Visibility: public
+Signature:  inspect()
+Number of lines: 6
+
+Returns a printable version of _str_, surrounded by quote marks,
+with special characters escaped.
+
+   str = "hello"
+   str[3] = "\b"
+   str.inspect       #=> "\"hel\\bo\""
+[18] pry(main)> show-doc Array#pop
+
+From: array.c (C Method):
+Owner: Array
+Visibility: public
+Signature: pop(*arg1)
+Number of lines: 11
+
+Removes the last element from self and returns it, or
+nil if the array is empty.
+
+If a number n is given, returns an array of the last n elements
+(or less) just like array.slice!(-n, n) does. See also
+Array#push for the opposite effect.
+
+   a = [ "a", "b", "c", "d" ]
+   a.pop     #=> "d"
+   a.pop(2)  #=> ["b", "c"]
+   a         #=> ["a"]
+[19] pry(main)> 
+
+^^^ but the formatting can be improved
+
+
+-------------------------------------------------------------------------------
+
+Überlegen ob wir threads in einer yaml datei oder so registrieren
+so das auch nach Beendigung der DiaShell diese tasks weiterlaufen
+
+"in 10 years do"
+"HAPPY BIRTHDAY ROEBE FROM 10 YEARS AGO."
+hmmmmmm.
+
+cd /Users/x/STUDIUM/UNI_WIEN/; cd *Hyg*
+
+#<ArgumentError: invalid byte sequence in UTF-8>
+#<ArgumentError: invalid byte sequence in UTF-8>
+We can only change directory if it is extracted, thus we will extract it now.
+Now extracting 320107_Allgemeine_Mikrobiologie_und_Hygiene.tar.xz.
+Extracter: tar -xvf /Users/x/STUDIUM/UNI_WIEN/320107_Allgemeine_Mikrobiologie_und_Hygiene.tar.xz -C /Users/x/STUDIUM/UNI_WIEN/
+Finished extracting 320107_Allgemeine_Mikrobiologie_und_Hygiene.tar.xz!
+No directory called `330065_Mikrobiologie_und_Hygiene` was found.
+Thus, we can not enter it.
+/Users/x/STUDIUM/UNI_WIEN/320107_Allgemeine_Mikrobiologie_und_Hygiene/
+
+^^^ das stimmt nit weil es ein dir gibt
+ein dir sollten wir ZEURST zu cd geben, dann erst
+irgend etwas anderes.
+
+^^^ ok wurde korrigiert... es passt aber noch immer nit genau...
+
+-------------------------------------------------------------------------------
+
+Restart dia-shell on exit as config-option, you can toggle
+this then.
+
+restart?
+
+^^^ e 'We will restart on exit.'
+-------------------------------------------------------------------------------
+
+=== Improve on the copy-subsection. Make it kick ass. Make it user
+    friendly. Document it on the features.
+
+And make the below work again:
+
+  cp all to here
+
+^^^ copy all from @_ to the current directory.
+
+document this, then publish
+
+^^^ irgendwie geht das aber nit...
+
+-------------------------------------------------------------------------------
+
+- We should be able to upload a whole .cgi project to a remote site.
+
+  But what about converting a whole .cgi project to a remote site? 
+
+  That requires more thought hmm. We can probably use my ftp scripts.
+
+  Und dann wenn das in diashell geht, in std_ftp.rb auslagern
+
+  Syntax suggestions:
+
+      upload project ? # list available projects for that. also show where to upload.
+      upload project rbt
+      upload project dia
+
+    upload bla.page
+
+    tostd; bl *ftp*
+  
+  This works partially in std_ftp.rb
+
+  Does not yet work in DiaShell completely but I will work on this later.
+  Danach das kommentieren und entfernen.
+
+  Also, einzelne Dateien uploaden geht relativ einfach.
+  Das testen wir noch besser aus, und dann machen wir das eventuell
+  für ganze directories.
+
+^^^ das funktioniert gar nicht mal so schlecht...
+die classe "correct_image_entries_in_html_file"
+ist dafür brauchbar
+
+gibt nen bug:
+  <img src="/Users/x/DATA/IMG/GAMES/DSA/DSA3_RIVA/amulett_gruen.gif"></td>
+-------------------------------------------------------------------------------
+ - fix:
+ 
+aliases? | nl
+
+^^^ note: this will be done with the master pipe.
+
+if master_pipe.does_not_know_about? 'aliases?'
+  then substitute with the dia shell first
+  and THEN send this data to the master pipe.
+  @result
+end
+
+Interconnect it with the DiamondShell.
+
+
+-------------------------------------------------------------------------------
+
+Add my custom IRB. But I don't have one!!!
+
+
+-------------------------------------------------------------------------------
+
+- Test from fish and learn from it, especially the colours part.
+  i .e when we type, the colours flash up somehow!
+
+    HOW COOL IS THAT!
+
+
+google fish shell
+
+
+  The cool part is that if the command is unknown, the input
+  appears to be red, but if the cmd is known it will become green.
+  Is this even possible with ruby alone? Seems as if one has to
+  use crappy-ncurses for this.
+
+  Anyway, once this is realized, it will be removed from this list.
+
+  DAS COOLE DARAN IST ist das fish das ganze highlighted - wenn ein 
+  command bekannt ist, dann gibt es ein highlight - das ist wirklich 
+  hilfreich. Das muss natürlich konfigurierbar sein, so das man
+  das einschalten/ausschalten können.
+
+
+-------------------------------------------------------------------------------
+  
+  Zudem sollte es so einen colour-dropdown box geben:
+
+      http://upload.wikimedia.org/wikipedia/commons/a/a8/Friendlyinteractiveshell.png
+
+  Das ist ähnlich wie rush aber nicht ident.
+   
+  Also see disco_prompt.rb
+
+
+
+-------------------------------------------------------------------------------
+
+ - Via master pipe we can do something like
+      "50 years | days?".
+
+    50 years | days?
+
+This should one day be integrated into the DiaShell,
+once it is finished and then added to the
+      dia tutorial page hmmmm
+         bl mastertask
+
+
+
+-------------------------------------------------------------------------------
+
+Ensure that the wecker works well:
+
+      in 7 stunden trigger wecker
+      in 1 minute tosongs
+
+      at 13:50:22 18.11.2011 do something
+
+^^^ must add this feature.
+
+   <shevy> hmm jeden Dienstag?
+ + <unkie> every 5mins
+   <unkie> oder sowas
+
+-------------------------------------------------------------------------------
+
+- The shell should be standalone like Xterm, and embeddable in GUIs.   
+
+-------------------------------------------------------------------------------
+
+- Get to understand _RPROMPT_ in zsh again and then look at 
+  a way to implement this in the diashell in an easy way.
+
+
+
+   
+-------------------------------------------------------------------------------
+
+- React on mouse button click event when the user clicks on a string, which
+  displays the dir.
+
+  We then trigger the action "enter directory"
+
+  Ok, aber wie machen wir das? Mir fällt da nur ncurses ein.
+
+  Wir sollten das uns in C anschauen - klipper aus KDE Konsole
+  erlaubt dies auch. Auch xdotool erlaubt dies.
+
+-------------------------------------------------------------------------------
+
+- Add support for mouse-only interactions (GUI?)
+
+
+-------------------------------------------------------------------------------
+
+- Use C to put jobs into background and foreground.
+
+
+-------------------------------------------------------------------------------
+- Decent help
+
+  Fish doesn't use man for help, it uses a text-mode browser with
+  hyperlinks. Why the hell doesn't every program's documentation
+  have hyperlinks? Goddamn, even Microsoft's caught onto the value
+  of an HTML help system.
+
+  ^^^ Rausfinden wie das geht, also das man UNDERLINE im browser
+      anzeigen kann.
+
+  This can be done via:
+
+    puts "\e[4mTesting underline:\e[0m and this is normal again"
+
+
+
+-------------------------------------------------------------------------------
+
+require 'yaml'
+
+yaml = <<-END_OF_YAML
+threads:
+  -
+    - puts: 'Thread 1 started'
+    - sleep: 1
+    - puts: ['Slept for 1 second', 'Thread 1 is done']
+
+  -
+    - puts: 'Thread 1 started'
+    - sleep: 1
+    - puts: Thread 2 is done
+END_OF_YAML
+
+config = YAML.load(yaml)
+
+config['threads'].each do |actions|
+  Thread.new do
+    actions.each do |action|
+      method, args = action.first
+      args = [args] unless args.is_a? Array
+      send(method, *args)
+    end
+  end.join
+end # From Defusal
+    # don't waste
+    #  it. learn from it, and mold it into something 
+    #  that suites your specific use case well
+    
+
+
+
+-------------------------------------------------------------------------------
+english <TAB>
+
+^^^ should list all available words there in the diashell.
+
+
+
+-------------------------------------------------------------------------------
+
+- Support ranges again, and document this in .cgi. 
+
+
+-------------------------------------------------------------------------------
+
+- da gibt es ein problem
+
+  "all" wird immer als "get all files from current dir" verwendet
+  Das is natürlich ein conflict wenn wir zu einer klasse all übergeben möchten.
+  Keine Ahnung wie wir dieses Problem lösen werden.
+ 
+-------------------------------------------------------------------------------
+
+- we must be able to intercept ALL exceptions when we are inside of DiamondShell
+
+
+-------------------------------------------------------------------------------
+
+- consider making cyberweb optional, also rbt optional
+
+
+-------------------------------------------------------------------------------
+
+
+-------------------------------------------------------------------------------
+
+save_config :display_index
+
+^^^ wir brauchen einen index, wenn wir etwas saven wollen,
+    so das wir nur diese Datei kopieren.
+wtf?
+
+ich glaub ich mein das ich nur eine einzige sache speicher oder so
+Das funktioniert jetzt oder? Hmmm. Bin mir da nicht sicher.
+
+
+
+-------------------------------------------------------------------------------
+zur zeit wird jedes mal set_prompt
+
+gesetzt nachdem wir enter drückendas is natürlich ein Grober Unfug
+
+wir setzen den prompt nur einmal beim startup
+und später nur wenn der user es so gewünscht hat!
+
+
+-------------------------------------------------------------------------------
+
+Universal variables
+
+Fish has a feature known as universal variables, which allow a user
+to permanently assign a value to a variable across all the user's
+running fish shells. The variable value is remembered across
+logouts and reboots, and updates are immediately propagated
+to all running shells.
+
+^^^ add a way to find out which other shells are running, from
+ruby.
+^^^ perhaps store the ID and such
+
+# This will make emacs the default text editor. The '-U' tells
+# fish to make this a universal variable.
+> set -U EDITOR emacs
+
+# This command will make the current working directory part of the fish
+# prompt turn blue on all running fish instances.
+> set -U fish_color_cwd blue
+
+^^^ Add this then also add this to documentation.
+But how shall it be implemented?
+
+
+-------------------------------------------------------------------------------
+
+ - mv /Depot/jjj/poppler-0.24.4.tar.xz $MY_TEMP
+
+   Right now, if you press tab, nothing happens.
+
+   Once we are on ruby 1.9.x this should work by expanding 
+   to the proper path immediately.
+
+
+
+-------------------------------------------------------------------------------
+ Also add ruby-gtk bindings, through VTE we can do the diashell.
+-------------------------------------------------------------------------------
+
+- We need a way to globally suppress stdout.. or redirect.
+  example for this:
+
+    "stdout.silent"
+    "silent stdout"
+
+  this should suppress stdout completely.
+
+  Also, we may want to log everything to a file and have the
+  user modify this on runtime.
+   
+  -> Google this how to do blabla.
+
+  Hmm, add logging to a file. But this exists already, the history.
+
+-------------------------------------------------------------------------------
+
+-> Wir müssen die DiaShell auch auf Windows testen!
+   insbesondere das das kompilieren funktioniert, das sollten
+   wir austesten.
+
+Am besten am Laptop.
+
+Und danach diesen Punkt hier entfernen.
+
+(Sicherstellen das zumindest der mplayer auf windows funktioniert)
+
+Und - die DiaShell muss auch zum aufsetzen eines systems helfen
+
+^^^ das testen wir gerade
+
+danach wieder mal uploaden.
+
+-------------------------------------------------------------------------------
+
+do_task_later
+
+^^^ implement this
+
+
+
+-------------------------------------------------------------------------------
+
+- re-enable multiline input again
+  
+  das müssen wir uns aber überlegen wie das geht
+  also zerstmal alles öffnen.
+  Also, wir scheinen nun \\ als end-chars zu verwenden.
+  ^^^ already works hmm.... is this finished?
+    multilineinput
+
+-------------------------------------------------------------------------------
+(27) Wir sollten auch ein Bash-spezifisches Verhalten aufweisen
+
+Also GENAU so ein listing:
+
+So das ich bash mit der diashell 1:1 austauschen kann.
+
+    "bashlisting"
+
+    enable bash
+
+Also add a from-bash-to-diashell section
+
+     http://stackoverflow.com/questions/211378/hidden-features-of-bash
+
+-> This sets tab completion to not be case sensitive. It's really
+   great for quickly typing directory paths, especially on a Mac
+   where the file system is not case sensitive by default. I put
+   this in .inputrc in my home folder.
+ 
+   but "cd Y"<tab> does not work :<
+
+-------------------------------------------------------------------------------
+-> ruby_token_parser currently has a bug 
+
+I think I must rewrite this; do not raise an error per se, instead
+store it, and then decide whether to raise or whether to not raise.
+
+This may require a total rewrite because I have no idea
+how the code looks like... it was not written by me after all.
+
+-------------------------------------------------------------------------------
+
+- Sometimes the configuration gem may not be installed yet, for instance when
+  I set it up on a completely new system.
+  Thus we should be able to offer a simple way to download AND
+  install this gem, even if we are on such a system.
+  This entry here shall be kept in place until
+  it is gone.
+
+
+-------------------------------------------------------------------------------
+
+Add:
+
+      update windows
+      winupdate
+
+  Das soll meine ruby scripts auf Windows aktualisieren, also am 
+  wichtigsten im Moment ist das es die DiaShell Scripts kopiert.
+
+  TESTEN, DANN DEN PUNKT HIER ENTFERNEN!!!
+  Eventuell sollten wir den Windows Rechner mal nach oben schleppen.
+----------------------------------------------------------------------------
+- A gem has failed to load, most likely because it does not exist.
+
+^^^ too unspecific
+-------------------------------------------------------------------------------
+- keeping pids, does not seem to work properly.
+  But why not? Hmmm. Not sure ...
+  A "kill -9" will lead to this....
+  hmmmm. We now have a method that gets rid of
+  unused PIDs, but we still sorta have to connect this better.
+
+-------------------------------------------------------------------------------
+/Depot/Video/Realvids/ls *Naked*
+/Programs/Ruby/2.3.0/lib/ruby/site_ruby/2.3.0/diamond_shell/base/show_directory_content.rb:96:in
+`show_directory_content': undefined method `apply_filter' for #<ShowDirectoryContent:0x00000005c86ae0> (NoMethodError)
+
+Did you mean?  append_file
+        from /Programs/Ruby/2.3.0/lib/ruby/site_ruby/2.3.0/diamond_shell/menu/menu.rb:1399:in `menu'
+        from /Programs/Ruby/2.3.0/lib/ruby/site_ruby/2.3.0/diamond_shell/base/run.rb:77:in `block in run_main_loop'
+        from /Programs/Ruby/2.3.0/lib/ruby/site_ruby/2.3.0/diamond_shell/base/run.rb:74:in `loop'
+        from /Programs/Ruby/2.3.0/lib/ruby/site_ruby/2.3.0/diamond_shell/base/run.rb:74:in `run_main_loop'
+        from /Programs/Ruby/2.3.0/lib/ruby/site_ruby/2.3.0/diamond_shell/run/run.rb:15:in `run'
+        from /Programs/Ruby/2.3.0/lib/ruby/site_ruby/2.3.0/diamond_shell/initialize/initialize.rb:35:in `initialize'
+        from /Programs/Ruby/2.3.0/lib/ruby/site_ruby/2.3.0/diamond_shell/base/run.rb:92:in `new'
+        from /Programs/Ruby/2.3.0/lib/ruby/site_ruby/2.3.0/diamond_shell/base/run.rb:92:in `run'
+        from /System/Executables/dia:36:in `<main>'
+
+^^^ error
+
+-------------------------------------------------------------------------------
+
+
+
+from old diashell, port:
+
+"# Assume clipboard functionality here. (clipboard tag)"
+
+from old diashell
+port:
+
+from old diashell, in shell.rb,
+port:
+
+- All commandline options and THEN when they were ported,
+  look through the diacgi tutorial, and see if they were
+  properly documented!
+-------------------------------------------------------------------------------
+
+@shell_prompt = 'disco'
+
+^^^ consider doing a disco prompt again.
+
+
+
+-------------------------------------------------------------------------------
+
+- Audio based instructions would be awesome.
+
+      https://github.com/CarlFK/veyepar/blob/master/dj/
+      https://github.com/CarlFK/veyepar/blob/master/dj/scripts/run_tests.py#L319
+
+For this to work, we should first capture audio instructions such as:
+
+  cut
+  enter
+  quit
+
+
+-------------------------------------------------------------------------------
+
+enable 
+
+?upcase
+
+this should fetch the documentation for this method
+
+for now, this is hardcoded, but one day it should become
+generalized.
+
+?upcase
+
+
+-------------------------------------------------------------------------------
+
+add support for
+  (a) Dir.clone
+  (b) Dir.<TAB_PRESS_HERE> ^^^ then complete to the above.
+      Dir.c<TAB>
+
+^^ this works sorta; what is missing is to add the rest of ruby classes
+   to it.
+
+
+
+-------------------------------------------------------------------------------
+OLD_DIA.rb integrieren, und dann das removen
+
+
+-------------------------------------------------------------------------------
+add "cd object" so that we can explore objects
+
+in the diamond shell
+
+cd @original_input
+
+e 'Now entering an instance variable (@original_input).'
+
+'ls -i'
+
+
+-------------------------------------------------------------------------------
+CMake Error
+
+^^^ when compiling something with easycompile
+and seeing such an error, feedback that error
+
+-----------------------------------------------------------------------------
+
+Wir können den ascii counter prompt zur zeit nit verändern.
+
+Gott ist das langweilig!!!!!
+
+Verbessern wir mal den fucking prompt.
+
+
+
+
+
+
+
+
+-----------------------------------------------------------------------------
+- IRB DROP:
+
+  fully add irb_drop and document it, 
+  but not as an external variant
+  probably enable two variants
+  one via binding.irb_drop
+  and another one that goes like
+
+  Example:
+
+    Roebe::Shell.irb_drop
+
+  or something like that.
+
+
+
+
+
+
+
+
+
+-----------------------------------------------------------------------------
+
+
+=== We must be able to do everything that bash and the unix tools
+    allow us to do.
+
+What is missing?
+
+-> grep: that is leading the list.
+
+The rest, hmmm ..... is not so important.
+
+lalala > foo
+echo lalala > foo
+
+Redirections must work.
+>> works.
+
+And interconnect with the pipe_shell.
+
+
+
+
+
+
+-----------------------------------------------------------------------------
+
+consider using an alias:
+Dia
+
+so that we can do.
+
+Dia.config
+
+Pry.config.color is a boolean option determining whether color will be used. Setting it to false disables color (i.e syntax highlighting and other color effects).
+
+^^^ enable this
+
+Dia.config
+  and
+Dia.config?
+
+-----------------------------------------------------------------------------
+
+
+<blubjr> is there a way to look at older return values than the last in the repl
+<djellemah> blubjr: assign variables? Otherwise not as far as I know.
+<blubjr> hm hm
+<blubjr> ok
+<djellemah> blubjr: if you're using pry, _out_ might do what you want. TIL.
+<blubjr> whats til
+<djellemah> Thing I Learned
+<blubjr> oh
+
+-------------------------------------------------------------------------------
+
+diamondrc in home dir
+
+can have stuff such as:
+
+
+  colours: false
+  colors:  false
+
+  which_shell: xterm
+
+^^^ document it
+
+the idea is that a user can permanently alter such things
+without having to depend on the individual yaml files
+
+in other words, the diamondrc will overrule other settings,
+should it exist
+
+this works. but we may have to add more options
+
+perhaps look through config, then add a few elements
+then document it more then remove.
+then upload! ^^^^^^^
+
+DOCUMENT IT MORE!!!
+
+rf dia diamondrc
+
+^^^ this works semi-ok... continue lateron.
+
+-------------------------------------------------------------------------------
+
+
+-------------------------------------------------------------------------------
+
+For Diashell:
+
+  Directory browsing
+
+  Press "Alt-Left" to go back a directory, and Alt-Right to go forward
+  a directory. Alt-Left now works. Must probably be better documented?
+  Let's see. It is now documented.
+  
+  Alt-right, not sure what this means.
+
+  You can move back with ALT + Left Arrrow and forward with ALT + Right
+  Arrow between working directories. ( just like we move back and forth
+  between pages in a web browser)
+
+  ^^^ ok so perhaps alt right means to cycle through the base
+  dirs instead...
+  
+  It's exactly like the back and forward buttons in webpages. Brilliant!
+  
+  o in fish you dont even need to type cd! Just keying the name of 
+    the directory, it will __highlight green__ as a valid command, 
+    and pressing enter will cd into it.
+    ^^^ highlight green is missing
+
+  To those screaming about pushd and popd commands - because let's 
+  be honest, you're never going to type a 6-character pushd over 
+  a 2-character cd. Hell, in fish you don't even need to type cd!
+  Just keying the name of the directory, IT WILL HIGHLIGHT GREEN
+  AS A VALID COMMAND, and pressing enter will cd into it.
+
+
+-------------------------------------------------------------------------------
+
+ - Gmail Emails holen.
+      bl $RUBY_EMAIL/LinuxmailFetcher.rb; rffruby mechanize
+    ^^^ auf linuxmail scheissen. gmail ist es.
+
+Hmmm. Gmail.
+
+
+-------------------------------------------------------------------------------
+
+- make it possible to use a chroot for diashell
+or so, at the least in oder to compile stuff... eprhaps
+this should be part of rbt... hmm
+
+This sorta works semi-ish. We have to extend this in rbt
+first, and then eventually we consider how to do this
+via the diashell as well.
+
+
+
+
+-------------------------------------------------------------------------------
+
+- learn from irb too.
+  investigate the source of IRB!
+  So boring...
+    bl /Programs/Ruby/Current/lib/ruby/2.3.0/irb.rb
+
+
+
+
+
+-------------------------------------------------------------------------------
+ - "help | grep bla" on the result
+
+    bl masterpipe_task
+
+  All | need to be done via the masterpipe.
+
+  First, we must write a grep in ruby.
+  We have that via "rack", on github.
+
+  Second, we must set help here, which is data that is fetched to the 
+  master pipe from the dia shell. Not sure how to do this ... could
+  write it into a file and the masterpipe uses it then. Hmmm. I
+  will think more about it once grep is finished.
+
+
+
+
+
+
+
+-------------------------------------------------------------------------------
+
+For Windows, allow a way to set a specific video file like the
+_FULL_ path to mplayer.
+
+When this works, add it to win-config.
+
+   setvid c::/mplayer/mplayer.exe
+
+^^^ must test this first though.
+    when this works, copy it.
+
+first, set up windows again.
+
+also ... add ?setvid or
+something like that for docu help.
+
+
+
+
+
+
+-------------------------------------------------------------------------------
+
+
+^^^ we should disable reading the config file if
+-norc is used.
+
+dia --norc
+
+^^^ das funktioniert soweit, ist aber nicht gut durchdacht.
+
+^^^ manche optionen failen... das müsste man berücksichtigen.
+^^^ und dann nicht configuration requiren... hmmmm.
+
+also neu schreiben...
+YUP - die komplette diashell neu schreiben!
+und auf Geschwindigkeit achten...
+aber damit erst anfangen wenn wir mit bioroebe-rewrite
+ fertig sind
+
+^^^ work through this
+
+ok ok diashell rewriten... und schneller machen...
+-------------------------------------------------------------------------------
+(29) We found these Birthday candidates (14 days in advance):
+  
+Today is the 08.10.2017 (Sunday)
+
+Studium::AnmeldungAb: The following registries for exams/courses are upcoming in
+Studium::AnmeldungAb: the next 18 days - you may register soon.
+
+
+^^^ only show an anmeldung if we have an exam to report
+else DO NOT SHOW IT
+
+-------------------------------------------------------------------------------
+source $HOME/DiamondShell/completion_for_diamond_shell.sh
+^^^ re-enable this again one day
+-------------------------------------------------------------------------------
+(28) AND fix --help too
+^^^^ fix it so that it works in the gtk-shell too.
+-------------------------------------------------------------------------------
+(25) Continue with the GTK part of roebe-shell
+------------------------------------------------------------------------
+(26) In the gtk-part of roebe-shell, add something like cuiterm for
+the shell:
+
+    http://freshmeat.sourceforge.net/screenshots/ac/be/acbe6fa02d8b726cc520cf23aadeeee8_medium.png?1237057318
+    the rotation can be done via:
+    .left_angle 90
+    but we have to also  allow the user to toggle-control set this
+    behaviour.
+    ^^^ not just in this regard, but also so that we can add
+       a small combo-box entry widget thingy when renaming / removing
+       files. a bit like MC gidnight commander or so, but within the view-file widget.
+       
+------------------------------------------------------------------------
+rdia --debug
+^^^ this should work properly AND feedback the configuration base
+    directory that is to be used
+------------------------------------------------------------------------