roebe 0.5.123

data/doc/old_tutorial/old_diashell_tutorial.cgi

@@ -0,0 +1,2105 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# http://localhost/programming/ruby/src/roebe/doc/old_tutorial/old_diashell_tutorial.cgi
+# =========================================================================== #
+require 'cyberweb/autoinclude'
+
+english('The old DiaShell Tutorial') {
+created_on '16.08.2022' # Tuesday.
+autoextend
+ruby_favicon
+template1 '
+pre {font-size:1.25em}
+p  { margin-left:1em;}
+h2 { color: yellow; margin-top:0.2em; margin-bottom:0px; }
+body { width:98%;}
+div {
+  padding:5px;
+  margin-bottom:10px;
+}
+span.directory {
+  color: orange;
+}
+span.file, b.file {
+  color: lightgreen;
+}
+b.cmd,b.variables {
+  color: orange;
+}
+
+.thin_orange_border {
+  border:     1px solid orange;
+  box-shadow: 0 1px 1px red;
+}
+'
+body_css_class 'pad1em BG_Black White'
+font_size '1.05em'
+
+GREEN_SQUARE = sg(:green_square, 'marr8px')
+CMD_COLOUR = 'lightblue'
+CMD  = 'marl2em BO '+CMD_COLOUR
+CMD2 = 'marl4em BO '+CMD_COLOUR
+Cyberweb.cmd2 = CMD2
+
+# =========================================================================== #
+# === in_file
+# =========================================================================== #
+def in_file(this_file)
+  e dot(102, 'marr6px')+this_file,'orange BO'
+end
+
+# =========================================================================== #
+# === sin_file
+# =========================================================================== #
+def sin_file(i)
+  return string_s2(i,'orange BO')
+end
+
+ARRAY_HEADER_IDS = []
+
+# =========================================================================== #
+# === command
+# =========================================================================== #
+def command(this_command, optional_id = '')
+  e this_command, CMD, optional_id
+end; alias cmd command # === cmd
+
+# =========================================================================== #
+# === header
+# =========================================================================== #
+def header(content)
+  spacer :center
+  id = content.downcase
+  if id.include? '<' # split at first <
+    index = id.index '<'
+    id = id[0,index]
+  end
+  id = id.gsub(/ /,'_').sub(/^the_/,'')  
+  ARRAY_HEADER_IDS << id
+  # ========================================================================= #
+  # Add a HTML comment to the subsection. This may allow us to
+  # identify the section in a simple way.
+  # ========================================================================= #
+  ee Cyberweb.html_comment('Header for: '+id.to_s, :newline)
+  h2 GREEN_SQUARE+'<a class="marl5px yel" href="#'+id+'">'+content+'</a>','marb8px',id
+end; alias personal_header header # For now, we keep this as alias, but in the future we may use an own header.
+
+doc('mar0px pad0px s0_2em') {
+  h1 dot(106, 'marr8px')+
+     'The old DiaShell Tutorial',
+     'mart1px marb0_5em gold'
+  div {
+    dimg 'PC/DIAMOND_SHELL/DIAMOND_SHELL_LOGO.png','marl3em' # The logo.
+  }
+  p_default {
+    anm 'This is a tutorial for the Diamond Shell (also called Roebe::Shell), 
+    which is a shell written in the programming language Ruby.', margin_left: '2em'
+    br
+    anm 'Please note that this tutorial assumes that you have a Diamond Shell
+    instance running.', margin_left: '3em'
+    br
+    e 'That is, after you have started it, for instance by typing <b>dia</b>
+    in a terminal, you can type in the following commands.'
+  }
+# ========================================================================= #
+  # === Diamond Shell Features tag.
+  # ========================================================================= #
+  header 'Features'
+  p_default {
+    e 'Listing the most important <b>features</b> of the <b>Diamond Shell</b>:'; br 
+    le3br '# - backup audio, or data, to usb or hdd.'
+    le3br '# - Compiles apps and chain_compiles even more apps.'
+    le3br '# - Type news to open some webpages for news stuff.'
+    le3br '# - Vim "support", which means you use vim to edit stuff.'
+    le3br '# - Trigger certain events. '
+    le3br '# - On startup of this shell, you can define some actions which'
+    le3br '#   need to be done, i.e "rdia rsong" to play random songs. More'
+    le3br '#   about this, please see the section here called "startup".'
+    le3br '# - ISO Creation, CD and DVD burning.'
+    le3br '# - ri-like browsing behaviour.'
+    le3br '# - Open your favourite files by specifing something like "blxorg"'
+    le3br '# - Open a local page in your editor by issuing "rf keyword"'
+    le3br '# - InBuilt help file.'
+    le3br '# use "songs" to view your local songs and songs 44-48
+    to play song 44 up to including song 48'
+    br
+    e 'It really has a lot more features, it is best to look at 
+    the page here - have a look around.'
+    br
+    e 'It should include all what is necessary - and if not, then 
+    I will add this information here.'  
+  }
+  # ========================================================================= #
+  # === Design tag
+  # ========================================================================= #
+  header 'Design Statements and Philosophy'
+  p_default {
+    e '<b class="orange">@aliases</b> should contain ALL aliases.'
+    br
+    e 'Every string data that the shell gathers - before it is sent
+    to the user - will be stored in a variable. This way you can tap
+    into this variable and make further use of it, for whatever 
+    purpose.'
+    br
+    e '<b class="orange">@this_file</b> points to the last
+    assigned or otherwise used file. Only this, and only
+    one variable may refer to the last used file.'
+  }
+# ========================================================================= #
+  # === History tag
+  #   rf diacgi history
+  # ========================================================================= #
+  header 'History Support'
+  p('','history') {
+    e 'The Diamond Shell will, by default, log all commands that you
+    did enter via a keyboard interface.'
+    br
+    e 'This behaviour can be <b>turned off</b> by setting <b>enable_history_logging</b>
+    to false in the config file; you can also do this at <b>runtime</b> if
+    you do input <b class="cmd">disable logging</b> or <b>no logging</b>).'
+    br
+    e 'To access this information of your history, you can issue either of
+    these synonymous commands:'
+    br
+    cmd '  h'
+    cmd '  history?'
+    br
+    e 'This will then display the input-history.'
+    br
+    e 'You can also use a position of the history at, i.e. place 5,
+    like this:'
+    br
+    cmd '  history 5'
+    br
+    e 'This will '+sg(:dice,'marr6px')+'<b>substitute</b> the history
+    command of position 5. In other words, this allows you to use history
+    you already did input at an earlier time.'
+    br
+    e 'You can also use the bash equivalent here:'
+    br
+    cmd '  !-2'
+    br
+    e 'Personally I find this less readable, but if you are coming
+    from bash and like this functionality, you can use this in
+    the Diamond Shell as well.'
+    br
+    anm 'Please note - we wont append to the history log if the last
+    command entered is the same as the last entry in the history log
+    (keeping duplicates is not so useful).'
+    br
+    e 'You can empty/clear the history any given time by doing:'
+    br
+    cmd '  empty history'
+    br
+    e 'You can also disable logging of the history by doing:'
+    br
+    cmd '  disable history'
+    br
+    e 'And of course you can disable history support on startup
+    of the Diamond Shell as well:'
+    br
+    cmd '  rda --nohistory # or one of the aliases towards --nohistory'
+    br
+    anm 'We log all commands into the file <b>last_commands.yml</b>.'
+  }
+  # ========================================================================= #
+  # === Gzip Tag
+  # ========================================================================= #
+  header 'Gzip'
+  p_default {
+    e 'You can compress a string using gzip/zlib:'
+    br
+    cmd 'gzip bla'
+    br
+    e 'However right now I can not think for a good usage scenario 
+    for this ...'
+  }
+  # ========================================================================= #
+  # === Generate Tag
+  # ========================================================================= #
+  header 'Generate Part'
+  p_default {
+    e 'To generate a new page, issue:'
+    br
+    cmd '  generate BIOS.cgi'
+    br
+    e 'This will simply generate a new .cgi file.'
+  }
+  # ========================================================================= #
+  # === Feedback Tag, Documentation tag
+  # ========================================================================= #
+  header 'Feedback Part'
+  p_default {
+    e 'To get feedback about every Xorg component, do this:'
+    br
+    cmd 'gfeedback all_of_xorg'
+    br
+    anm 'Note that this will also generate a .html page.'
+    e 'As usual, using "<i>gfeedback help</i>" or "<i>gfeedback ?</i>"
+    will give you some help about this method.'
+    br
+    e 'To feedback the version of a program, do this:'
+    br
+    cmd '  programversion cups'
+    br
+    e 'To feedback the available programs, do:'
+    br
+    cmd 'aprograms'
+    br
+    e 'You can also get feedback about the documentation of Ruby.'
+    br
+    cmd '  docu? Array#sort'
+    br
+    anm 'You can also omit the leading docu? identifier and just
+    use this instead:'
+    br
+    cmd '  Array#sort'
+    br
+    e 'The above would use Ri to feedback information about Ruby.'
+    br
+    e 'This syntax here also works:'
+    br
+    cmd '  docu? Array.sort'
+    cmd '  showdoc Dir.chdir'
+    br
+    e 'And you can also <b>grab</b> the documentation for .rb files:'
+    br
+    cmd '  docu? foobar.rb'
+    br
+  }
+  # ========================================================================= #
+  # === Startup Tag
+  # ========================================================================= #
+  header 'Startup' # rf diatut startup
+  p_default {
+    e 'The Diamond Shell will allow some things to be done at startup
+    time.'
+    br
+    e 'Please keep in mind that there are aliases possible for your
+    convenience. For instance, the option nocolours and nocolors are
+    synonymous. Also, you can use either - or --, for instance
+    --nocolours will be the same as -nocolours.'
+    br
+    e 'You can decide what you prefer on your own.'
+    br
+    # ======================================================================= #
+    # Commandline options. rf diacgi commandline_options
+    # ======================================================================= #
+    e 'Following comes a table with the currently supported Commandline-Options:'
+    table2 'mart1em pad4px','commandline_options',
+           'margin-left: 6.5em; border-spacing: 12pt',
+      '<i>--version</i>','<b class="lightred">Display the version 
+       number of this shell.</b>',
+      '<i>--time</i>','<b class="lightred">show the current time, in
+       HH:MM:SS notation</b>', 
+      '<i>--nocolours</i>','<b class="lightred">disable colours.</b>',
+      '<i>--run_method</i>','<b class="lightred">run a specific
+       method, then exit.</b>',
+      '<i>--norc</i>','<b class="lightred">do not load the
+       configuration file(s) on startup. This also will ignore
+       the file diamondrc, should it exist.</b>',
+      '<i>--extract</i>','<b class="lightred">simply extract 
+       something, with the aid of the DiamondShell, such
+       as: rda extract all.</b>',
+      '<i>--help</i>','<b class="lightred">show the various help
+       options, then exit</b>',
+      '<i>--debug</i>','<b class="lightred">enable debugging
+       for this Diamond Shell instance</b>',
+      '<i>--silent-startup</i>','<b class="lightred">we will be rather
+       silent on startup</b>'
+    br
+    anm 'If you use a -- option that does not exist, the Diamond Shell
+    will notify you that it does not exist.'
+    br
+    e 'You can also invoke a specific method from the Diamond Shell from
+    the commandline.'
+    br
+    e 'Examples:'
+    br
+    cmd '  rdia --runmethod run_pkg_config'
+    cmd '  rdia --norc'
+    br
+    e 'You can also get tab completion on the commandline.'
+    br
+    e 'For instance, type this:'
+    br
+    cmd Cyberweb.escape_html('  rda --<TAB>')
+    br
+    e 'This will complete to --help'
+    br
+    e 'This will also work if you wish to tab-complete on the 
+    current files in the working directory of your shell.'
+    br
+    e 'So if you have a file called foo.txt, this will work:'
+    br
+    cmd '  rda fo<TAB>'
+    br
+    e 'The startup-related code will also attempt to
+    generated a hash that can be used for swift
+    filesystem-navigation.'
+  }
+  # ========================================================================= #
+  # Method name Format. Methods tag.
+  # ========================================================================= #
+  header 'Call any method'
+  p_default {
+    e 'You can call any method by its name from within the Diamond Shell.'
+    br
+    e 'The <b>general syntax</b> for this procedure is:'
+    br
+    cmd '  cmethod <span class="yel">name</span>'
+    br
+    e 'Examples:'
+    br
+    cmd '  cmethod foobar # would call the method foobar, if it exists.'
+    cmd '  cmethod clear_history'
+    cmd '  cmethod preformed_action?'
+    cmd '  cmethod history?'
+    cmd '  cmethod upload_screenshots?'
+    br
+    anm 'method and cmethod works the same, method is just an alias
+    to cmethod.'
+    br
+    e 'To list all available methods (which you could then call
+    with <b>cmethod</b>), do this:'
+    cmd '  all_methods'
+    br
+    e 'Also note that you can get feedback about a method since August
+    2015 if you pass the name:'
+    br
+    cmd '  method? yel'
+    cmd '  method? clear_history'
+  }
+  # ========================================================================= #
+  # === Compile Format                                          (compile tag)
+  # ========================================================================= #
+  header 'Compile'
+  p_default {
+    img 'PC/OS/LINUX/COMPILE.png', '', :drag_and_highlight; br
+    br
+    e 'If you want to get a list of all programs which can be 
+    compiled, do this:'
+    br
+    cmd '  compile help'
+    br
+    e 'You can compile i.e. nano by doing:'
+    br
+    cmd '  compile nano'
+    br
+    e 'In general the syntax is:'
+    br
+    cmd Cyberweb.escape_html('   compile <name>')
+  }
+  # ========================================================================= #
+  # Weekday tag
+  # ========================================================================= #
+  header 'Weekday'
+  p_default {
+    e 'You can find out the weekday of any date like so:'
+    br
+    cmd  '  wday 13.11.2011'
+    cmd2 '  This day is a Sunday.'
+    br
+    cmd  '  wday today'
+    cmd2 '  This day is a Sunday.'
+    br
+    cmd  '  wday today?'
+    cmd2 '  This day is a Saturday.'
+  }
+  # ========================================================================= #
+  # Prompt tag
+  # ========================================================================= #
+  header 'Prompt'
+  p_default {
+    e 'You can modify the prompt by doing something like this here:'
+    br
+    cmd '  prompt foo'
+    br
+    e 'Some options exist in regards to the prompt. For a listing of these,
+    query via help, such as this:'
+    cmd '  prompt help'
+    br
+    anm 'The Disco Prompt may be fun to try out.'
+    br
+    e 'You can set a mixed prompt, meaning that directories
+    will be colourized as default, but the / between them
+    will have another colour.'
+    br
+    e "Let's look at a screenshot for this:"
+    img 'PC/DIAMOND_SHELL/DIAMOND_SHELL_MIXED_PROMPT.png',
+        'mar0_5em marl3em'; br
+    e 'And now the code for this:'
+    cmd 'setprompt mixed'
+    br
+    e 'If you wish to clear the prompt again, do this:'
+    cmd '  prompt nil'
+  }
+  # ========================================================================= #
+  # === Run tag
+  # ========================================================================= #
+  header 'Run'
+  p_default {
+    e 'You can "run" a file, and we attempt to run this file with the 
+    default application that was registered.'
+    br
+    e 'For example, if you do:'
+    br
+    cmd 'run foo.pdf'
+    br
+    e 'Then we would open this file.'
+    br
+    anm 'This is a bit similar to the command open, but run specifically
+    also works when we have files like .rb files, .py files and so on.<br>
+    It is a bit like an <span class="BG_Black pad1px pads4px orange">
+    instruction to <b>execute that file</b></span>.', :error_box
+    br
+    e 'Since as of September 2016 you can also use a require-statement
+    to start up a new instance of the Diamondshell.'
+    br
+    e 'Do the following:'
+    br
+    cmd "  require 'diamond_shell/run'"
+  }
+  # ========================================================================= #
+  # === Stat tag.
+  # ========================================================================= #
+  header 'Stat'
+  p_default {
+    e 'Stat is used similar to the <b>UNIX command stat</b>.'
+    br
+    cmd 'stat some_file'
+    br
+    e 'Additionally, we include information from <b>class BeautifulUrl</b>
+    so whatever you did add to that class will work with the stat command
+    too, no matter where that file is.'
+    br
+    e 'You can also apply stat on the @_ token, like:'
+    br
+    cmd '  stat @_'
+    br
+    e 'Additionally, you can do this:'
+    br
+    cmd '  stat {1,2}'
+    cmd '  stat 1,2'
+    br
+    e 'The above commands would stat the position 1 and 2.'
+    br
+    anm 'Note that leading file: entries will be removed from the
+    given input.'
+  }
+  # ========================================================================= #
+  # === Triggering Events
+  # ========================================================================= #
+  header 'Triggering Events'
+  p_default {
+    e 'You can trigger (and register) certain events. For instance.'
+    cmd 'in 5 sekunden trigger wecker'
+    e 'Would register this action to be run in 5 seconds from the time 
+    of entering the input..'
+    br
+    e 'A german variant of this works as well:'
+    cmd '  in 3 sekunden starte wecker'
+    br
+    e 'Aside from triggering events, we also have some event-like options
+    that can be used to configure the DiamondShell.'
+    br
+    e 'These can be stored in the configuration file <b>events.yml</b>'
+    e 'For instance, the event :on_remove_directory
+    will invoke a cleanup script, whenever a directory is removed
+    under the /Programs hierarchy (or more accurately, whatever
+    value was set to PROGRAMS_DIR)'
+  }
+  # ========================================================================= #
+  # Information about programs
+  # ========================================================================= #
+  header 'Information about Programs'
+  p_default {
+    e 'You can get information about programs like this:'
+    br
+    cmd '  pinfo libassuan'
+    br
+    e 'You can also use purl, which gives you the url of a program:'
+    br
+    cmd 'purl wine'
+    br
+    e 'And to also open this URL, do this:'
+    br
+    cmd '  purl wine open'
+    br
+    anm 'This will also set the variable <b class="variables">@last_url</b>.'
+    br
+    e 'In fact, anything that stores a URL should also keep this
+    information in @last_url. At any time you can retrieve this URL
+    by issuing something like:'
+    br
+    cmd '  open_url'
+    cmd '  openurl'
+    br
+    e 'Note that certain other commands also set this url. A rule of 
+    thumb is, that whenever you notice an URL output, then this variable
+    will also be set, and you can then simply use openurl on it easily.'
+    e 'Also note that two commands exist here "url" and "purl". The
+    current way is that if you use "url", and we do not find an URL for 
+    it, we will automatically invoke "purl". I added it because gaining 
+    information was more convenient to me if I only have to type once.'
+  }
+  # ========================================================================= #
+  # === Wecker Tag. Time tag.
+  # ========================================================================= #
+  header 'Wecker and Time'
+  p(id:'wecker'){
+    e 'You can set a Wecker, like when you want to wake up at a 
+    specific time.'
+    br
+    e 'This wecker formula is quite flexible right now:'
+    cmd '  wecker 6 std 8 minuten'
+    cmd '  wecker 855 minuten'
+    cmd '  wecker 2 tage 8 stunden'
+    br
+    e 'Time-related queries also work nicely.'
+    br
+    e 'For instance, if you wish to find out when the next Weekday is, try:'
+    br
+    cmd '  next sonntag'
+    cmd '  next sunday'
+  }
+  # ========================================================================= #
+  # Serve local pages Tag
+  # ========================================================================= #
+  header 'Serve local pages'
+  p(id: 'serve') {
+    e 'You can serve local .cgi pages, just do this:'
+    br
+    cmd '  serve foobar.cgi'
+    cmd '  serve PC.cgi'
+    cmd '  serve /Users/x/DATA/SCIENCE/THINKING_METHODS.cgi'
+    cmd '  serve http://localhost/GAMES/DSA/DSA_COMPUTERSPIELE.cgi'
+    br
+    e 'By default this will output the html code onto your
+    console. Additionally, it will save the result into a
+    .html page, within the directory of the DiamondShell log
+    directory.'
+  }
+  # ========================================================================= #
+  # Notification Format
+  # ========================================================================= #
+  header 'Notification Format and Notifications'
+  p_default {
+    in_file 'notify.rb'
+    br
+    e 'Right now the format is rather primitive.'
+    br
+    e 'One can use this:'
+    marl1em 'At 06.07.2008 15:00:34 send "hey your kitchen burns"'
+    marl1em 'In 20 seconds send "hey your kitchen is really burning!"'
+    br
+    anm 'If you omit the time, we will assume <b class="lightgreen">
+    12:00:00</b> as the default.','marl2em'
+    anm 'If you use "in 1000 seconds" then we will calculate 
+    the proper time automatically.','marl2em'
+  }
+  # ========================================================================= #
+  # === Open tag.
+  # ========================================================================= #
+  header 'Open'
+  p_default {
+    e 'The command <b>open</b> allows you to open files.'
+    br
+    e 'Some keywords are used for it, for example:'
+    br
+    cmd 'open last'
+    br
+    e 'Would open the last file. This may be useful when you have
+    opened a local page via some shortcut and want to refer to it.
+    In this case, "last" refers to that file.'
+    br
+    e 'This works also for programs and their project URL, for example
+    try this:'
+    br
+    cmd 'pinfo php open'
+    br
+    e 'This would give you some information about php, and open the webpage
+    in a browser.'
+    br
+    e 'Popular open-related actions include the following:'
+    br
+    cmd 'open wikipedia'
+    cmd 'open pdf'
+    cmd 'open html'
+    br
+    anm 'Note that you can also open URLs - in this case, we will fire
+    up the browser to load it.'
+    br
+    e 'You can open the last assigned file by doing either of the following:'
+    br
+    cmd '  open LAST_FILE'
+    cmd '  open ?'
+    br
+    e 'Note that we will try to glob towards an existing file
+    if we did not find a valid file to open otherwise.'
+  }
+  # ========================================================================= #
+  # === Create tag. create file tag.
+  # ========================================================================= #
+  header 'Create something with the Diamond Shell'
+  p_default {
+    e 'To <b>create a webpage</b>:'
+    br
+    cmd '  createw location'
+    cmd '  createw $IMG/FUN/ANIMALS'
+    cmd '  createw $IMG/NJOY/'
+    br
+    e 'You can also give a file and split it up. Example:'
+    br
+    cmd '  createw TANRIEL 3'
+    br
+    e 'Would split this file into 3 .html pages.'
+    br
+    e 'You can also create simple files. In UNIX Environments, 
+    you commonly use "touch file_name" to create a file.'
+    br
+    e 'This works when you use quotes too, for instance:'
+    cmd 'touch "foo bar"'
+    e 'Will create a file called "foo bar", including the space.'
+    br
+    e 'You can also create multiple files like so:'
+    br
+    cmd '  touch {temp1,temp2,temp3,temp4}'
+    br
+    e 'The Diamond Shell also tries to be "smart" when it notices you want 
+    to create a file. For instance, when you try to create a .rb file, 
+    we automatically insert a program skeleton into that .rb file.'
+    br
+    e 'This behaviour can be adapted and changed by you.'
+  }
+  # ========================================================================= #
+  # Disable tag
+  # ========================================================================= #
+  header 'Disable'
+  p_default {
+    e 'Currently if you want to generate certain files, such as 
+    <b>foo.rb</b>, we create a default layout for that.'
+    br
+    e 'This is done by the <b class="file">class CreateFileSkeleton</b>.'
+    br
+    e 'This is usually useful, but can sometimes be annoying. In
+    that case, you can simply disable the autogeneration via:'
+    br
+    cmd '  disable autogeneration'
+    br
+    e 'To find out whether we will autogenerate files/content for
+    files, do this:'
+    br
+    cmd '  autogeneration?'
+    br
+    anm 'To show all available actions for disable, do:'
+    br
+    cmd '  disable HELP'
+  }
+  # ========================================================================= #
+  # Burning tag
+  # ========================================================================= #
+  header 'Burning'
+  p_default {
+    e 'The Diamond Shell currently relies on i.e. libburn or cdrskin
+    and growisofs to burn CD and DVD iso files.'
+    br
+    e 'You can simulate a "test" run issuing:'
+    br
+    cmd '  burn test'
+    br
+    e 'The program to burn CDs and DVDs can be set in the configuration
+    file.'
+    br
+    e 'You can get its current value by doing:'
+    br
+    cmd '  dvd_burn?'
+    br
+    e 'Alternatively, you can set the run_simulation variable
+    to true like so:'
+    br
+    cmd '  run_simulation = true'
+  }
+  # ========================================================================= #
+  # === Iso tag
+  # ========================================================================= #
+  header 'Creating ISO files'
+  p_default {
+    e 'You can create .iso files with the Diamond Shell easily.'
+    br
+    e 'One way is to call the following method:'
+    br
+    cmd '  create_interactive_iso'
+    br
+    e 'You can also directly create an iso by doing this:'
+    br
+    cmd '  make_iso /path/to/directory/here'
+    cmd '  make_iso /tmp'
+    cmd '  make_iso /Depot/Games'
+    cmd '  make_iso /Users/x/DATA'
+  }
+  # ========================================================================= #
+  # System tag
+  # ========================================================================= #
+  header 'System Information'
+  p_default {
+    e 'To get System Information do this:'
+    cmd '  system?'
+    br
+    e 'This will use the following class:'
+    cmd '  SystemChecker.new'
+  }
+  # ========================================================================= #
+  # Input tag, User input tag. Multiline input.
+  # rf dia input
+  # ========================================================================= #
+  header 'Input'
+  p_default {
+    e 'A few words should be given about user input to the Diamond Shell.'
+    e 'These may be useful to understand certain design decisions.'
+    br
+    e '- Everything that comes after the first encountered <b>#</b> 
+    character will be regarded as a comment.'
+    e 'For instance:'
+    cmd '  exit # we will exit here. What comes after the # is ignored.'
+    br
+    e 'The above command would assume that the user wanted to exit
+    the shell, and the dia-shell will ignore everything that comes
+    after the # (and the # character will also be ignored)'
+    br
+    e 'This is basically the same behaviour you can find in other
+    shells as well.'
+    br
+    e 'The character <b class="yel">;</b> is treated as an 
+    <b>instruction_separator</b>, unless it is found as part of
+    an URL. For example:'
+    cmd 'cd $J; ll'
+    e 'Is assumed to be two different commands: first a change_directory
+    instruction, then a listing_content of a directory instruction.
+    This is consistent with how other shells act.'
+  } 
+  # ========================================================================= #
+  # === Recipe Creation tag
+  # ========================================================================= #
+  header 'Recipe Creation'
+  p_default {
+    e 'To create a recipe interactively (i.e. write up information about
+    it in a step-by-step fashion), run this command:'
+    br
+    cmd '  interactive_recipe'
+    cmd '  irecipe'
+    br
+    anm 'This is part of the Cookbooks project. We can use this to create
+    a new recipe for installing/compiling a program.'
+  }
+  # ========================================================================= #
+  # Superuser tag. Users tag.
+  # ========================================================================= #
+  header 'Superuser'
+  p_default {
+    e 'To change the superusername (on UNIX like systems), do this:'
+    br
+    cmd 'become new_name'
+    cmd 'become god # now the superusername would be called "god"'
+    br
+    e 'You can also show which users are available on a given system.'
+    br
+    e 'To do this, issue the following command:'
+    br
+    cmd '  users?'
+    br
+    e 'And you can find a specific User ID, such as User ID 11:'
+    cmd '  user 11'
+    cmd '  user_id 11'
+  }
+  # ========================================================================= #
+  # All tag
+  # ========================================================================= #
+  header 'All'
+  p_default {
+    e 'You can use a special keyword "all" as alias towards *.'
+    br
+    e 'That way you can apply a common operation on several file 
+    objects, for instance:'
+    cmd '  tovilla; bl 4/all*'
+    br
+    e 'This would open all files within the directory at position 
+    4 in the bluefish editor (or whatever else is your defined
+    editor under @config.editor).'
+    br
+    anmerkung_box('In general, "all" is considered a shortcut for "*",
+      unless a file exists with that name in question.','mart1px','',
+      'width:45%') { :enable_drag_and_drop }
+  }
+  # ========================================================================= #
+  # === Subdirectory tag
+  # ========================================================================= #
+  header 'Showing the size of a subdirectory'
+  p_default {
+    e 'You can show the file size of a subdirectory.'
+    br
+    cmd '  subdir_size?'
+    cmd '  ssize'
+    br
+    e 'I found this useful because sometimes I need to know how many
+    files are in a subdirectory.'
+  }
+  # ========================================================================= #
+  # === URL tag
+  # ========================================================================= #
+  header 'Program URLs'
+  p_default {
+    e 'To get the URL of a program, do this:'
+    br
+    cmd '  programurl wine'
+    cmd '  programurl ruby'
+    cmd '  programurl php'
+  }
+  # ========================================================================= #
+  # === Colours
+  #
+  # All about colours in the DiamondShell project.
+  # Colours tag Colors tag. rf diatut colours
+  # ========================================================================= #
+  header 'Colours'
+  p_default {
+    e 'The Diamond Shell will use colours if you specified that you want
+    to use colours.'
+    br
+    e 'This can set inside of the Diamond Shell, and it can be queried through
+    the method called <b>use_colours?</b>.'
+    br
+    e 'This option can be customized within the config file and it can
+    also be changed at run-time (see the coming section how to do that).'
+    br
+    anm 'If you do not want to use colours, set the variable
+    <b>use_colours</b> to false. This can also be done by 
+    issuing'
+    br
+    e '<b class="marl4em">disable colours</b>','FI'
+    br
+    e 'in your <b class="slateblue">running shell</b>.'
+    br
+    e 'To enable the colours, logically, you can do
+    <b>enable colours</b> again.'
+    br
+    e 'Currently, directories and files will have different colours,
+    as defined in the config file:'
+    br
+    cmd '  colours.yml'
+    cmd '  cat $DIA/YAML/colours.yml # Lets display the content.'
+    br
+    e 'To get a listing of which colours are used in the shell, do:'
+    br
+    cmd '  colours?'
+    br
+    e 'This will display the colours in use too, for instance:'
+    img 'PC/DIAMOND_SHELL/DIASHELL_COLOURS.png','marl2em',
+        'drag_roebeshell_colours'; br
+    br
+    e 'You can then set a new colour live, by doing something like:'
+    cmd '  colour_for_directories = red'
+    br
+    e 'From this point on, all directories will be displayed in red.'
+    br
+    e 'For fun and giggles, you can also randomly switch the colours,
+    just to try out how things will look.'
+    br
+    e 'For this, do:'
+    br
+    cmd '  switch colours'
+    cmd '  rotate colours'
+    cmd '  switch'
+    cmd '  rotate'
+    cmd '  scolours'
+  }
+  # ========================================================================= #
+  # Ascii tag
+  # ========================================================================= #
+  header 'ASCII'
+  p_default {
+    e 'You can use ascii art too:'
+    cmd '  to_ascii some_image.jpg'
+    cmd '  to_ascii 1'
+    cmd '  to_ascii 2'
+    cmd '  to_ascii all'
+    e 'Just try these.'
+    br
+    e 'In case we do not find any match, we will try to use a glob(),
+    before we fail finally.'
+  }
+  # ========================================================================= #
+  # IRC TAG.
+  # ========================================================================= #
+  header 'IRC'
+  p_default {
+    e 'You can use IRC from the Diamond Shell.'
+    br
+    e 'To do this, do:'
+    cmd 'irc channel_name_here'
+    cmd 'irc ruby-lang'
+    cmd 'irc ruby'
+  }
+  # ========================================================================= #
+  # Exiting the shell
+  # ========================================================================= #
+  header 'Exiting the shell'
+  p_default {
+    e 'To exit the shell do one of these:'
+    cmd 'q'
+    cmd 'exit'
+  }
+  # ========================================================================= #
+  # Password tag, Passwords tag.
+  # ========================================================================= #
+  header 'Passwords'
+  p_default {
+    e 'To clear the password of your user account, do:'
+    cmd 'nopasswd'
+    anm 'This will simply delete the password.'
+    br
+    e 'To show all available passwords, you may also
+    do:'
+    cmd 'passwords?'
+  }
+  # ========================================================================= #
+  # Fetching all .ogg/mp3 files in a given dir
+  # ========================================================================= #
+  header 'Fetching all .ogg/mp3 files in a given dir'
+  p_default {
+    cmd 'all ogg'
+    cmd 'all mp3'
+    anmerkung 'Of course you can apply other 
+    criterias as well, such as "all php" or something.'
+    br
+    e 'The result will be stored in <b class="variables">@file_listing</b> 
+    which you can manipulate lateron.'
+    e 'To retrieve it, simply type it in the shell.'
+    cmd '  @file_listing'
+    e 'Since Sep 2011 the following also works:'
+    cmd '  @_'
+    anm 'Since Jan 2012 we allow to shuffle the dataset stored in
+    <b class="variables">@file_listing</b> by doing:'
+    cmd 'shuffle'
+  }
+  # ========================================================================= #
+  # === Download tag downloading tag down tag load tag.
+  # ========================================================================= #
+  header 'Downloading'
+  p_default {
+    e 'You can download a package like so:'
+    br
+    cmd 'download http://ftp.gnome.org/pub/gnome/sources/pygtksourceview/2.3/pygtksourceview-2.3.0.tar.bz2'
+    br
+    e 'If you want to download <b>to</b> a specific directory, 
+    use the "<b>to</b>" keyword like this:'
+    br
+    cmd '
+    download 
+    http://ftp.gnome.org/pub/GNOME/sources/gtk+/3.15/gtk+-3.15.4.tar.xz
+    to /Depot/j'
+    cmd 'download  
+    http://ftp.gnome.org/pub/GNOME/sources/gtkmm/3.17/gtkmm-3.17.50.tar.xz
+    to /Depot/j'
+    br
+    anm 'Note that this can work with special targets/variables
+    as well for your conenvience. For example:'
+    cmd 'url = http://www.calno.com/evilvte/evilvte-0.3.1.tar.gz'
+    cmd 'download url to 1'
+    anm "would download to the location saved at slot 1, which defaults 
+    to ENV['MY_SRC'], or expanded, would become /Users/x/SRC on my system."
+    e '<b>url</b> in this case is a variable which was asigned to some url
+    before.'
+    br
+    e 'Whenever we download something, we will also set the variable
+    @last_downloaded.'
+    br
+    e 'You can then use this variable to manipulate the file in question.'
+    br
+    e 'For example, to <b>download</b>, and then <b>extract</b> the file, you
+    can use this:'
+    br
+    cmd 'download ftp://ftp.astron.com/pub/file/file-5.03.tar.gz to /Depot/j'
+    cmd '  extract last_downloaded'
+    br
+    e 'Also note that you can download Youtube videos by just passing
+    in the URL of it.'
+    br
+    e 'The Diamond Shell will automatically try to download and also
+    extract the audio file into a .mp3 file.'    
+  }
+  # ========================================================================= #
+  # === Displaying file content
+  #
+  # Header tag. Head Tag. cat tag.
+  # ========================================================================= #
+  header 'Displaying File Content'+sg(:develop,'marl1em')
+  p_default {
+    e 'Use cat or get_file_content to display the file content
+    of a file '+sg(:file)+'.'
+    br
+    e 'For example, if the file is called <b>foobar.txt</b>, do this:'
+    br
+    cmd '  cat foobar.txt'
+    br
+    e 'You can specify a range:'
+    br
+    cmd '  cat file 10-20'
+    br
+    e 'This would display only line 10 up to 20.'
+    br
+    anm '  This works only on files, i.e. not on directories.','marl2em'
+    br
+    anm '  Also note that this slicing for files should work in general,
+    and can even be extended. Look at playing video for an example.'
+    br
+    e 'You can also read a header, via:'
+    br
+    cmd '  header foo'
+    cmd '  header 5'
+    br
+    e 'How many lines will we display that way? By default we will
+    show the first 25 lines, but you can change this setting, by
+    doing something like:'
+    br
+    cmd '  header? 10'
+    br
+    e 'This setting can be saved, by issuing <b>save</b>.'
+    br
+    anm 'Note that if the file is a .rb file, we will try to use
+    the Coderay gem to parse the result.'
+    br
+    e 'As of August 2014, we will also allow you to use the
+    last file that was assigned when you use ?:'
+    br
+    cmd 'cat ?'
+    br
+    e 'You can append into a file directly by doing this:'
+    br
+    cmd '  cat this_file >> ~/A_FILE_IN_MY_HOME_DIR'
+    cmd '  cat 4 >> ~/A_FILE_IN_MY_HOME_DIR'
+  }
+  # ========================================================================= #
+  # Show source tag
+  # ========================================================================= #
+  header 'show-source'
+  p_default {
+    e 'You can show the source of a <b>ruby method</b> by
+    issuing this command:'
+    br
+    cmd '  show-source run'
+  }
+  # ========================================================================= #
+  # Undo tag
+  # ========================================================================= #
+  header 'undo'
+  p_default {
+    e 'You can undo certain actions. Right now <span class="ud">only</span>
+    file-move actions can be undone. For instance, let us assume that you
+    have a file called "test" in the directory /tmp, and that you moved
+    this file to the directory /home, like so:'
+    br
+    cmd '  mv /tmp/test /home'
+    br
+    e 'Now you can do this command:'
+    br
+    cmd 'undo'
+    br
+    e 'And the file will be moved back to its old place.'
+    br
+    e 'This is not extremely useful yet, but I will probably add code
+    to allow a more general purpose undo action at a later time.'
+  }
+  # ========================================================================= #
+  # Move tag, mv tag.
+  # ========================================================================= #
+  header 'Move'
+  p_default {
+    e 'You can move files and directories to new locations.'
+    br
+    e 'This can be done like so:'
+    br
+    cmd '  mv foo /tmp'
+    br
+    e 'The above command would move the file foo to the directory
+    <b>/tmp</b>. This is similar to how bash or zsh acts.'
+    br
+    e 'Note that you can also move multiple files.'
+    br
+    e 'The syntax for this would be:'
+    br
+    cmd 'mv temp{1,2,3,4} $JJJ'
+    br
+    e 'This would try to move these directories or files to
+    whatever value is stored in $JJJ (which, on my system,
+    points to the directory /Depot/jjj).'
+  }
+  # ========================================================================= #
+  # === Screenshot tag
+  # ========================================================================= #
+  header 'Screenshot'
+  p_default {
+    e 'You can use `scrot` to make a screenshot. A common alias is:'
+    br
+    cmd 'shot'
+    br
+    e 'The first argument is an <i>optional</i> name for the .png file
+    that will be created:'
+    br
+    cmd 'shot my_desktop'
+    br
+    e 'The second argument is an optional delay (in seconds)'
+    br
+    cmd 'shot my_desktop 5 # 5 seconds delay'
+    br
+    anm 'Note that as of April 2014, we will automatically upload that
+    screenshot to a remote host if the environmental variable
+    <b>IS_ROEBE</b> is set to 1.'
+    br
+    anm 'The code for screenshots is stored in the file
+    <b>screenshot.rb</b>.'
+  }
+  # ========================================================================= #
+  # === Keywords tag
+  # ========================================================================= #
+  header 'Ruby keywords'
+  p_default {
+    e 'To get a list of all ruby keywords, do this:'
+    br
+    cmd '  keywords?'
+  }
+  # ========================================================================= #
+  # === Save tag
+  # ========================================================================= #
+  header 'Saving'
+  p_default {
+    e 'You can save to a file, for instance, like this:'
+    br
+    cmd 'save to $J/foo'
+    br
+    e 'This would save whatever is inside <b class="variables">
+    @usher.string</b> into this file. (By default it will append,
+    though this behaviour may change lateron.)' 
+  }  
+  # ========================================================================= #
+  # === Merging files tag
+  # ========================================================================= #
+  header 'Merging files'
+  p_default {
+    e 'Merging ogg files can be done like so:'
+    br
+    cmd '  merge x.ogg file1.ogg file2.ogg file3.ogg'
+    br
+    e 'You can omit arguments too as in:'
+    br
+    cmd '  vobmerge # will pickup all .vob files in the directory'
+  }
+  # ========================================================================= #
+  # === Ftp tag. rf diatut ftp
+  # ========================================================================= #
+  personal_header 'Ftp'
+  p_default {
+    e "Now let's talk a bit about the FTP functionality in the Diamond Shell."
+    br
+    e 'You can upload a whole project by issuing this:'
+    br
+    cmd '  ftp_upload project dia'
+    br
+    e 'Of course that task must have been registered somewhere first.'
+    br
+    e 'To show all available tasks, do either of these:'
+    br
+    cmd '  show available tasks'
+    cmd '  stasks'
+    br
+    anm 'Note that upload is an alias.'
+    br
+    anm 'Tab-completion may be possible.'
+  }
+  # ========================================================================= #
+  # === Birthdays tag.
+  # ========================================================================= #
+  personal_header 'Birthdays'
+  p_default {
+    e 'The Diamond Shall has the - not too overfuly useful - option to
+    display upcoming Birthdays. This requires one to write or define a
+    custom yaml file.'
+    br
+    e 'Currently this is set to 5 days in advance.'
+    br
+    e 'It will report in ways like:'
+    br
+    cmd  '  We found these Birthday candidates:'                                                                               
+    cmd2 '  Wolfgang: 23.01.2012'
+    br
+    e 'To query this, you can do this:'
+    br
+    cmd '  bday?'
+    br
+    e 'If you wish to look n days into the future, you can pass it as
+    an argument:'
+    br
+    cmd '  bday? 30'
+    cmd '  bday? 120'
+    br
+    anm 'Do note that the whole Birthday subsection will only work if you
+    actually have such a yaml file defined. If you have not, the whole
+    subsection will be ignored.'
+  }
+  # ========================================================================= #
+  # === Aliases tag. Unalias tag.
+  # ========================================================================= #
+  header 'Aliases'
+  p_default {
+    e 'All aliases are kept in the instance variable
+    <b class="variables">@aliases</b>.'
+    br
+    e 'You can display this variable any time by issuing
+    either of the following two commands:'
+    br
+    cmd '  @aliases'
+    cmd '  aliases?'
+    br
+    e 'To get the content of an alias, either type this:'
+    br
+    cmd '  alias name_of_alias'
+    cmd '  alias pwr'
+    br
+    e 'Positional arguments are also possible (if an
+    alias with that number does not exist, that is):'
+    br
+    cmd '  alias 567'
+    br
+    e 'Or simply type the following to get all these aliases:'
+    br
+    cmd '  @aliases'
+    br
+    e 'You can of course also unset an alias. I recommend you 
+    use this syntax:'
+    br
+    cmd '  unalias name_of_alias'
+    cmd '  unalias pwr'
+    br
+    e 'You can also unalias if you give a number instead.
+    unalias 123 would try to unset the alias at position
+    123.'
+    br
+    e 'To set an alias, you can do something like this:'
+    br
+    cmd '  alias foo=55'
+    br
+    e 'This would set the key <b>foo</b> to the value
+    of 55.'
+    br
+    anm 'As of January 2014, I can <b>download my remote
+    aliases</b> by issuing:'
+    br
+    cmd '  download_aliases'
+  }
+  # ========================================================================= #
+  # === buffer tag
+  #
+  #   rf diacgi buffer
+  # ========================================================================= #
+  header 'The Clipboard buffer'
+  p(id: 'buffer') {
+    e 'The Diamond Shell uses a <b>Clipboard buffer</b>.'
+    br
+    lem2 'This file is stored at
+    `<b class="file">diamond_shell/base/clipboard.rb</b>`.'
+    br
+    e 'You can obtain the current value of the Clipboard buffer
+    via:'
+    br
+    cmd 'buffer?'
+    cmd 'b?'
+    br
+    e 'If you want to assign it to a specific string, do start
+    this with the token:'
+    br
+    cmd '{'
+    br
+    e 'Yup, this is the start command for the buffer. I thought that
+    using {} as delimiter to enter into the Buffer directly would be
+    nice, so that is why I added that featre.'
+    br
+    e 'Also note that since December 2011 we will additionally try
+    to use xclip when using the buffer. This way, you should be
+    able to manipulate the buffer on your own.'
+    br
+    e 'You can clear the buffer any time by doing:'
+    br
+    cmd 'clear buffer'
+    br
+    e 'Since <b>March 2012</b> we also use a file called <b class="file">
+    buffer.yml</b>. If this file exists on startup, then we will load it
+    into the current buffer.'
+    br
+    e 'Note that we also use the Xorg buffer on Linux.'
+    br
+    e 'This Xorg buffer understands some special commands such as:'
+    br
+    cmd '  buffer generate ruby'
+    br
+    e 'This will generate ruby code.'
+    br
+    e 'You can store this buffer to a file, as in the following way:'
+    br
+    cmd '  save buffer to $J/jtj.rb'
+  }
+  # ========================================================================= #
+  # === index tag.
+  # ========================================================================= #
+  header 'Index'
+  p_default {
+    e 'By default, Diamond Shell assigns every entry in a given 
+    directory a number, the so-called
+    <i class="orange">index number</i>.'
+    br
+    e 'This number is displayed on the left side usually, and it 
+    may be used by you as a shortcut to access a specific file as
+    well.'
+    br
+    e 'For example, if you have two files in a given directory,
+    called "long_name_of_a_file_1" and "long_name_of_a_file_2"
+    you can use numbers to work with them instead, like so:'
+    br
+    cmd '  cat 1'
+    cmd '  cat 2'
+    br
+    e 'The following small screenshot shows this - the <i class="orange">
+    index number</i> can be seen in green colour:'
+    imgbr 'PC/DIAMOND_SHELL/DIAMOND_SHELL_INDEX_NUMBER.png',
+          'thin_orange_border pad1em marl4em mart1em',:drag
+    br
+    cmd '  cp 2 $J # This would copy the file at second position
+    to whatever value is contained in $J.'
+    lem 'On my system, this defaults to the directory <b>/Depot/j</b>.'
+    br
+    anm 'Do note that you can turn off showing the index in your config
+    file (look at the configuration option <b>display_index</b>):'
+    br
+    cmd '  disable display_index'
+    cmd '  no index'
+  }
+  # ========================================================================= #
+  # === pc packages tag
+  # ========================================================================= #
+  header 'Query .pc Packages'
+  p_default {
+    e 'You can query <b>.pc files</b> in a simple manner through the Diamond
+    Shell. pkg-config allows you to query installed libraries on
+    your computer, in partcular software that was compiled from source.'
+    br
+    e 'In order to do so and query the information found in .pc files
+    and whether it is available on your system, you can simply append
+    a <b>?</b> to the name.'
+    br
+    e 'For instance:'
+    br
+    cmd2 '  libpng?'
+    cmd2 '  mono?'
+    cmd2 '  xtables?'
+    cmd2 '  ruby?'
+    br
+    anm 'This will not always work, but it will probably make your life 
+    a bit easier sometimes, whenever you want to know which .pc files
+    are installed on your system.'
+    br
+    anm 'Note that on Windows the above will not work - the reason for
+    this is that most ruby-users on Windows will possibly not have
+    pkg-config .pc files.'
+  }
+  # ========================================================================= #
+  # === Appending to a file
+  # ========================================================================= #
+  header 'Appending to a file'
+  p_default {
+    e 'As it is the case with other shells, you can use >> to save
+    something to a file:'
+    br
+    cmd2 'foobar >> this_new_file'
+    br
+    e 'This would save foobar into the file
+    `<span class="file">this_new_file</span>`'
+    br
+    e 'As a reminder, in Bash it works a bit differently, in that the
+    stream is redirected. In Diamond Shell, we use a simplified approach.'
+    br
+    e 'Also note that you can use macros here, such as the 
+    <b>@buffer</b> macro.'
+    br
+    e 'For instance, if you do:'
+    br
+    cmd '@buffer >> foo'
+    br
+    e 'Then we will store the content of the buffer into the
+    file <b>foo</b>.'
+    br
+    anm 'Note that you can also use > which will create a new 
+    file and then add the content to that file.'
+  }
+  # ========================================================================= #
+  # === copy tag cp tag.
+  # ========================================================================= #
+  header 'Copy'+sg(:copy, 'marl1em','drag_copy')
+  p_default {
+    e 'You can copy a complete directory. By default, we will copy to 
+    the current working directory if no argument was given.'
+    br
+    e 'You can test this by doing something like:'
+    br
+    cmd '  cp to $JJ'
+    br
+    cmd '  copy_dir to $JJ'
+    br
+    anm 'It is recommended to use the second variant if you wish to copy
+    a directory; copy_dir is a shortcut for copy_directory. Both variants
+    would work.'
+    br
+    e 'You can also copy whatever is stored inside 
+    <b class="orange">@file_listing</b> to another target.'
+    br
+    e 'The following example shows this, by first entering to your directory
+    containing all audio songs, then fetching all .ogg files, then copying
+    them to whatever is held in the environment variable J:'
+    br
+    cmd '  cd $SONGS'
+    cmd '  all ogg'
+    cmd '  cp to $J'
+    cmd '  cp here to # this willc opy the content of @_ variable
+    to the current working directory'
+    cmd '  cp to here # Same as above'
+    cmd '  cp all to $JJ # this copies the content of this directory to 
+    the environment variable $JJ'
+    cmd '  cp all to here # Copy to the current directory'
+    br
+    anm 'More about the environment can be read 
+    <a href="#environment" class="slateblue">here</a>.'
+    br
+    e 'Please also note that the variable @target_directory can be 
+    set to a specific directory like so:'
+    br
+    cmd '  target /Depot/Song'
+    br
+    e 'The effect is that this variable can now be used to copy files 
+    or directories to this target. So after you have done the above,
+    you can then do this:'
+    br
+    cmd '  cp /Home/OldSongs/'
+    br
+    e 'And it will, <b>in this situation</b>, copy it to this directory.
+    If this was not set, a notification will alert the user that the
+    target directory is missing in this action.'
+    br
+    e 'Of course, if you manually give another target, then we 
+    will use this instead.'
+    br
+    e 'If for some reason you want to copy all images under 
+    a specific directory to a new target, use this:'
+    br
+    cmd 'cp_images'
+    br
+    e 'Note that this will copy to the directory you are in.'
+    br
+    e 'Useful to have is that you can also assign all current files in a
+    directory, and then copy these to somewhere else even at a later time.'
+    br
+    e 'This works like so:'
+    br
+    cmd '  assign all'
+    cmd '  cp to here'
+    cmd '  cp to $J # you can use absolute targets too, of course.'
+  }
+  # ========================================================================= #
+  # === Help tag. rf diacgi help
+  # ========================================================================= #
+  header 'Help'
+  p_default {
+    e 'The helpfile section can be invoked via:'
+    br
+    cmd 'help'
+    br
+    e 'The colouring of the helpfile section is done via the class
+    DiamondHeader.'
+    br
+    e 'Additionally, we can display useful help information before we startup.'
+    br
+    e 'We do this via:'
+    br
+    cmd 'rda --help'
+    br
+    e 'Below is a (partial) screenshot from how the Diamond Shell Help Menu
+    looked in <b>April 2014</b>:'
+    br
+    img 'PC/DIAMOND_SHELL/DIAMOND_SHELL_HELP_MENU.png',
+        'marl5em bblack2', :drag
+    br
+    e 'As of September 2014, documentation was added for the commands
+    displayed when the input "help" is issued. This documentation is
+    stored in the <b>class DocumentedHelpOptions</b>, residing in the file
+    <b class="file">
+    standalone_classes/documented_help_options.rb
+    </b>.'
+    br
+    e 'You can obtain a slightly longer explanation for most of these options
+    by <b>prefix</b> a leading <b>?</b>, so for instance:'
+    br
+    cmd2 '  ?touch'
+    cmd2 '  ?grabc'
+    cmd2 '  ?symlink'
+    cmd2 '  ?windows'
+  }
+  # ========================================================================= #
+  # Gist tag.
+  # ========================================================================= #
+  header 'Gist'
+  p_default {
+    e 'You can use Gist from the Diamond Shell, via the gist gem.'
+    br
+    e 'Example:'
+    br
+    cmd 'gist foobar.rb'
+    br
+    anm 'This would upload the foobar.rb file to gist github.'
+  }
+  # ========================================================================= #
+  # === Modes tag.
+  # ========================================================================= #
+  header 'Modes'
+  p_default {
+    e 'There are several modes in the Diamond Shell, even a hidden mode - 
+    the play mode.'
+    br
+    e 'If the play mode is active, we will try to play all video
+    files in the currenty directory.'
+    br
+    e 'You can set a specific mode by doing something like this:'
+    br
+    cmd '  mode = editor'
+    br
+    e 'You can query the currently active mode like so:'
+    br
+    cmd 'mode?'
+    br
+    e 'This would output "edit" in the above example.'
+    br
+    anm 'Mode-specific code can be found in the file <b>mode.rb</b>.'
+    br
+    e 'The idea behind the modes is that we will attempt to provide a
+    "default action" onto a target file when otherwise no action
+    is associated with that file type.'
+    br
+    e 'If you type in the name of an existing .mp3 file, we will
+    try to play it. But what if you have some unknown file?
+    In this case, we may try to open it in the browser, or
+    open it in the editor. And this is the reasoning behind
+    the modes in Diamond Shell.'
+    br
+    e 'The default mode is edit by the way, so the Diamond Shell
+    will assume that you attempt to edit an existing file.'
+  }
+  # ========================================================================= #
+  # === View map
+  # ========================================================================= #
+  header 'Viewing a Map'
+  p_default {
+    e 'You can view a map (Stadtplan):'
+    br
+    cmd '  stadtplan landstrasse 22'
+    br
+    e 'Right now this defaults to Vienna, my hometown.'
+    br
+    e 'If anyone requires this for another town, well. Write to me so
+    that I can add it.'
+  }
+  # ========================================================================= #
+  # === Emails tag
+  # ========================================================================= #
+  header 'Emails'
+  p_default {
+    e 'Thanks to the mail gem, we can send emails to other people (or to
+    yourself).'
+    br
+    e 'Currently this is somewhat limited - simply type "email" and
+    an interactive section can be used.'
+    br
+    e 'I will possibly extend this lateron (Current date: December 2015)'
+  }
+  # ========================================================================= #
+  # Show tag. Output tag.
+  # ========================================================================= #
+  header 'Show something'
+  p_default {
+    e 'You can show files by doing something like:'
+    br
+    cmd 'll'
+    br
+    e 'By default this will <b>not show hidden files</b>. There are at least
+    two ways to show hidden files though, since obviously this is an important
+    part of working with a filesystem.'
+    br
+    e 'The first way is to explicitely tell the shell once that
+    you want to see hidden files.'
+    br
+    e 'You can do this simply by issuing:'
+    br
+    cmd '  show hidden'
+    br
+    e 'From this point onwards, you will always see hidden files.'
+    br
+    e 'The other way is to use a switch, such as:'
+    br
+    cmd '  ll --almost-all'
+    br
+    e 'This is akin to <b>Bash</b>.'
+    br
+    e 'You can show the content of a file via <b>cat</b>, as in:'
+    br
+    cmd '  cat foo.rb'
+    br
+    e 'If the file <b>foo.rb</b> does exist, this command will show
+    you the content of that file. If coderay is installed, and if
+    you enabled colours, we will use Coderay on the terminal output
+    to also display colours.'
+    br
+    anm 'You can disable coderay output, which will try to 
+    colourize ruby-code on the commandline, by doing:'
+    br
+    cmd '  disable Coderay'
+    cmd '  disable coderay # this also works'
+    br
+    e 'You can sort the output by doing something like:'
+    br
+    cmd '  sort_by size'
+    br
+    e 'Obviously, the above command will <b>sort by size</b>.'
+  }
+  # ========================================================================= #
+  # Removing directory tag. Remove Tag.
+  # ========================================================================= #
+  header 'Removing something - removing files or directories'
+  p_default {
+    e 'You can remove directories via the <b>remove</b> subcomponent
+    i.e. by doing this:'
+    br
+    cmd 'remove foobar/'
+    cmd 'remove /tmp'
+    br
+    in_file 'protected_directories.yml'
+    br
+    e 'You can specify directories which should <b>never</b> be removed,
+    within the file <b>protected_directories.yml</b>. I recommend to
+    add the directory / to that yaml file.'
+    br
+    e 'You can also <b>add new directories</b> to this list:'
+    br
+    cmd '  protect /some/directory'
+    cmd '  protect /tmp'
+    br
+    e 'Please also note that you can specify a number as well, e. g.
+    the following would remove the first entry in a directory:'
+    br
+    cmd '  remove 1'
+    br
+    anm 'This can sometimes be a bit confusing, so in this case you
+    can just use the real name; I once wanted to be able to also
+    make use of numbers, so this is why this functionality exists.'
+    br
+    e 'Syntactic sugar also exists. To remove all directories in a
+    given directory, you can issue the following command:'
+    br
+    cmd '  remove all directories'
+    br
+    anm 'Note that german words also work as aliases to these actions.'
+    br
+    e 'You can also remove files that contain a " " character.
+    For instance, consider a file that is called <b>foo bar.txt</b>.'
+    br
+    e 'In order to remove such a file, try this, including the quotes:'
+    br
+    cmd '  rm "foo bar.txt"'
+  }
+  # ========================================================================= #
+  # Reading content tag
+  # ========================================================================= #
+  header 'Reading content'
+  p_default {
+    e 'The most obvious way for reading content is by reading a file.'
+    br
+    e 'To do this one would do something like:'
+    br
+    cmd '  read_file /location/of/file.txt'
+    cmd '  read_file /Users/x/DATA/STD.bfproject'
+    cmd '  rfile /etc/hosts'
+    br
+    e 'Some aliases exist for this, i.e. "readfile" would work also,
+    as would "cat".'; br
+    e 'The configuration option "padding" is also used to pad the file
+    to the left.'
+    br
+    e 'You can obtain the current value of padding by doing:'
+    br
+    cmd 'padding?'
+    br
+    e 'And you can set it to a new value by doing something like this
+    here:'
+    br
+    cmd '  padding = 15'
+    br
+    anm 'As of January 2014, the padding of input is done when we
+    read in a file. This may change at a later time again.'
+    br
+    anm 'If you do not like any padding at all, you can either
+    set padding to 0, or do this:'
+    br
+    cmd '  disable padding'
+    br
+    e 'Disable is the general way to disable some functionality, either
+    as part of the Diamond Shell, or from the underlying system.'
+  }
+  # ========================================================================= #
+  # === Downcasing tag.
+  # ========================================================================= #
+  header 'Downcasing'
+  p_default {
+    e 'To <b>downcase every file in a given directory</b> (might be useful if
+    you want to downcase VIDEO1.VOB to video1.vob, for instance), simply do
+    one of the following variants:'
+    br
+    cmd '  downcase *'
+    cmd '  downcase all'
+    cmd '  downcase everything'
+  }
+  # ========================================================================= #
+  # === Find tag
+  # ========================================================================= #
+  div {
+    header 'Find - finding something'+sg(:huhn, 'marl1em')
+    br
+    e 'We can find something in the Roebe::Shell, by doing something
+    like:'
+    br
+    cmd '  dfind threads.rb'
+    br
+    e 'This will find threads.rb on your HDD and also set it to the
+    @last_file used, which you can query via <b>file?</b>.'
+    br
+    e 'You can also find where binaries may be, similar to the UNIX
+    where_is.'
+    br
+    e 'Do either of the following, in order to find the binary
+    called <b>tar</b>:'
+    br
+    cmd '   where is tar?'
+    cmd '   where is tar'
+    cmd '   where? tar'
+  }
+  # ========================================================================= #
+  # === Repeat last action. (repeat tag)
+  # ========================================================================= #
+  div {
+    header 'Repeat last action'
+    e 'You can repeat the last action by doing:'
+    br
+    cmd'  ~'
+    cmd'  +'
+    cmd'  -'
+    cmd'  ++'
+    cmd'  --'
+    br
+    e 'Positional modifiers work too, to some extent. +30 would mean "play
+    the song at position +30 in relative terms to the last song played".'
+  }
+  # ========================================================================= #
+  # === DiamondShell Parameters Tag.
+  # ========================================================================= #
+  div {
+    header 'DiamondShell Parameters'
+    br
+    e 'You can get all the parameters of the methods in the DiamondShell.'
+    br
+    e 'In order to do this, do the following command from within a 
+    running instance of DiamondShell:'
+    br
+    cmd '  parameters?'
+    br
+    e 'Here is a <b>partial screenshot</b> showing the output of that
+    command:'
+    br
+    dimg 'PC/DIAMOND_SHELL/DIAMOND_SHELL_PARAMETERS.png',
+         'marl6em' # The Parameters.
+  }
+  # ========================================================================= #
+  # === Upcasing tag, Upcase tag.
+  # ========================================================================= #
+  header 'Upcasing'
+  p_default {
+    e 'You can upcase directory and file names by doing something like
+    this:'
+    br
+    cmd 'upcase all directories'
+    br
+    e 'This would upcase all directories '+sg(:directory)+' in the current
+    directory.'
+    br
+    e 'Obviously you can also upcase single files too:'
+    br
+    cmd '  touch test_file'
+    cmd '  upcase test_file'
+    br
+    e 'Now you will have a file called <b>TEST_FILE</b>.'
+  }
+  # ========================================================================= #
+  # === Backtick tag, Backticks tag.
+  # ========================================================================= #
+  header 'Backticks'
+  p_default {
+    e 'You can use `` backticks to run a command, similar as to
+    how ruby allows you to do.'
+    br
+    e 'Usage example:'
+    br
+    cmd '`ls`'
+  }
+  # ========================================================================= #
+  # === Config tag. Configuration tag.
+  #
+  # Important Configuration Files for the Diamond Shell.
+  #
+  # Will also have a subsection about diamondrc.
+  # ========================================================================= #
+  div(id: 'config') {
+    header 'Configuration'
+    br
+    le 'Important Configuration Files for the DiamondShell and how to
+    handle them.'
+    br
+    s2 'default_applications.yml','BO orange'
+    e sg(:pfeil8)+'This file will include your favourite applications 
+    for specific file types.'
+    br
+    e 'In here you can specify which program to use whenever you
+    want to open a .pdf file, open a .png file and so on.'
+    br
+    cmd '  bl $RUBY_DIA/lib/diamond_shell/YAML/default_applications.yml'
+    br
+    e 'To show the current values set in that file, you can do this:'
+    br
+    cmd 'default_applications?'
+    br
+    e 'Note that you can reload the yaml config by doing:'
+    br
+    cmd '  reload configuration'
+    br
+    e 'This will also reload the aliases at run-time.'
+    br
+    e 'Another configuration option allows you to display shorter 
+    file names, i.e. if a file name is too long we will simply 
+    truncate it.' # truncate tag.
+    br
+    e 'Every available configuration option can be found in the
+    <b>main configuration directory</b>.'
+    br
+    cmd '  cd $RUBY_DIA/lib/diamond_shell/yaml/configuration'
+    br
+    e 'For local use I recommend you to only use the saving option.
+    The following example illustrates this:'
+    br
+    cmd '  config.debug = true'
+    br
+    e 'This changes the configuration of the shell during runtime.'
+    br
+    e 'To make this change permanent, do this:'
+    br
+    cmd '  save'
+    br
+    e 'or'
+    br
+    cmd '  save config'
+    br
+    e 'Now, on next startup, we will load this saved config file.'
+    br
+    e 'You can also save individual components. For instance,
+    you can save the debug value, or the padding value.'
+    br
+    cmd '  save debug'
+    cmd '  save padding'
+    br
+    anm 'But this is no longer that useful. Since March 2014, I
+    recommend you to simply to just "save" alone.'
+    br
+    e 'If you have set shorten_directory_names to true, then a 
+    leading * will indicate that the name was shortened.'
+    br
+    e 'You can toggle this at run-time too, and untoggle again,
+    as in:'
+    br
+    cmd 'shorten'
+    cmd 'unshorten # or "longen"'
+    br
+    anm 'Note that <b>shorten</b> will also get rid of the ModTime
+    information.'
+    br
+    anm 'You can also deliberately disable the display of the
+    modification time. In order to do so, do:'
+    br
+    cmd 'no_mod_time'
+    br
+    e 'And to undo, do:'
+    br
+    cmd 'show_mod_time'
+    br
+    e 'You can modify every configuration option directly like so:'
+    br
+    cmd '  config.use_colours = false'
+    br
+    e 'To feedback this option, do this:'
+    br
+    cmd '  config.use_colours'
+    br
+    e 'You can also append a <b>?</b> if you want to:'
+    br
+    cmd '  config.use_colours?'
+    br
+    e 'Rather than use <b>config.</b>, some aliases exist, such as
+    @configuration, @config and so on. Use whatever suits you best,
+    although <b>config.</b> is probably the shortest and simplest
+    notation for accessing the Roebe::Shell Configuration Settings.'
+    br
+    e 'Of course, if you want to disable the colours, you could
+    also use this:'
+    br
+    cmd '  disable colours'
+    br
+    e 'You can reload your original configuration by issuing this:'
+    br
+    cmd '  reload config'
+    br
+    e 'This will also reload the colours, so you can use it to
+    change the currently running shell.'
+    br
+    e 'The option <b>run_simulation</b> is used to run in a 
+    simulation mode - currently this means that we do not
+    actually burn a CD or DVD, no. It means we will feedback
+    which command we would use.'
+    br
+    e 'Also note that when you are on windows, you could do 
+    something like:'
+    br
+    cmd '  config windows'
+    br
+    e 'To conveniently switch to a windows-based configuration.'
+    br
+    e 'If you look at the configuration, it is a simple key => value
+    mapping, a hash. You can modify values of this hash in a fairly
+    simple manner:'
+    br
+    cmd '  editor = bluefish'
+    br
+    e 'This would set your editor to bluefish.'
+    br
+    e 'You can change specific parts of the config by using aliases.
+    For instance, this will work to change the location of Firefox:'
+    br
+    cmd '  firefox.location = /Programs/Firefox/Current/bin','browser'
+    br
+    e 'Another option is to simply use this instead:'
+    br
+    cmd '  set_browser /Programs/Firefox/Current/bin'
+    cmd '  set_firefox /Programs/Firefox/Current/bin'
+    br
+    e 'Since <i>March 2012</i> we are using a specialized class called
+    <b class="orange">Configuration</b> to handle all configuration
+    aspects of the Diamond Shell.'
+    br
+    e 'You can also query the config directly by issuing a command
+    query such as the following:'
+    br
+    cmd '  config.padding?'
+    cmd '  config.use_irc?'
+    br
+    e 'An alternative syntax also exists such as:'
+    br
+    cmd '  Diamond.configuration.padding = 5'
+    br
+    e 'You can designate another Encoding format to use via the
+    configuration option preferred_encoding.'
+    br
+    e 'Additionally, you can overrule the encoding via the
+    method <b>DiamondShell.set_encoding()</b>. For instance,
+    to designate to the binary encoding, use this:'
+    br
+    cmd '  DiamondShell.set_encoding :binary'
+    br
+    e 'I tend to use an ISO encoding, you may use UTF there
+    instead.'
+    br
+    e 'This encoding format will be used several times during
+    a DiamondShell session so make sure to have it properly
+    set.'
+    br
+    # ======================================================================= #
+    # === diamondrc file
+    #
+    # rf diatut diamondrc
+    # ======================================================================= #
+    lem 'If a file called <b id="diamondrc">diamondrc</b> exists in the base
+    directory of the DiamondShell home directory, then we will try to
+    <b>parse it</b> and use its values. For instance, if you set
+    "colours: false" in this diamondrc file, then we will not make
+    use of colours. (You can also use US spelling such as "colors: false")'
+    br
+    lem 'This is similar to using the yaml files to control the
+    behaviour or other instructions such as "disable colours"
+    at runtime. More about this in the <b>disable-subsection</b>.'
+    br
+    e 'The class responsible for the parsing is stored here:'
+    br
+    cmd '  $DIA/diamondrc_parser/diamondrc_parser.rb'
+    br
+    e 'You can dump the configuration options by issuing:'
+    br
+    cmd '  dump_config'
+  }
+  # ========================================================================= #
+  # === Debug tag
+  #
+  # Enable or disable debug.
+  # ========================================================================= #
+  div(id: 'debug') {
+    h2 'Debugging'
+    e 'You can enable or disable debugging.'
+    br
+    e 'The command may be:'
+    br
+    cmd '  debug+'
+    br
+    e 'To enable debugging.'
+    br
+    cmd '  debug-'
+    br
+    e 'To disable debugging.'
+    br
+    e 'You can also use the longer variants such as enable_debugging or
+    enable debugging. And of course also disable debuggung - see the
+    other entries for <b>enable</b> and <b>disable</b> functionality.'
+  }
+  # ========================================================================= #
+  # === Conventions for the Diamond Shell
+  # ========================================================================= #
+  div {
+    h2 'Conventions for the Diamond Shell','mart1px slategray',
+       'conventions' # Conventions tag.
+    p('s0_5em'){
+      e '- All * are meant to be a shortcut for "all files". Or
+      more precisely, all files, directories and symlinks.'
+      br
+      e '- @this_file and @_. Not sure about the differences.
+      I think @this_file is used to denote the main file right
+      now, whereas @_ is more like a <b>throwaway variable</b>.'
+    }
+  }
+}}