roebe 0.5.123

data/lib/roebe/www/compiling/compiling.rb

@@ -0,0 +1,2578 @@
+# =========================================================================== #
+# === MAIN_BACKGROUND_COLOR
+# =========================================================================== #
+MAIN_BACKGROUND_COLOR = 'background-color: #e7e5e2'
+
+german('Compiling') {
+autoextend
+css_style TEMPLATE2.to_s+'
+td { padding-left:3px;padding-right:3px;}
+img  {border:0px solid black;}
+span {font-weight:400;}
+pre {font-size:1.15em;}
+div {line-height:inherit;}
+
+div.default {
+  border:1px solid slateblue;
+  padding:     0.75em;
+  padding-top: 0.3em;
+  margin-top:  0.4em;
+  color: black;
+  '+MAIN_BACKGROUND_COLOR+'
+}
+
+p.default {
+  margin-left:0.5em;
+  text-indent:5px;
+  padding: 12px;
+  font-weight:normal;
+  color: black;
+  '+MAIN_BACKGROUND_COLOR+'
+}
+
+
+p {
+  margin-left:0.5em;
+  text-indent:5px;
+  font-weight:normal;
+  color: black;
+  '+MAIN_BACKGROUND_COLOR+'
+}
+
+body {
+  line-height:110%;
+  padding-right: 1.5em;
+}
+tt {font-weight:600}
+
+
+a  { text-decoration: none; }
+
+'
+favicon 'PC/OS/LINUX/COMPILING_FAVICON.png'
+body_css_class 'FW5 mar0px pad0px BG_Black'
+body_css_style MAIN_BACKGROUND_COLOR
+font_size 'default'
+
+# =========================================================================== #
+# === GLIBC_REPLY
+# =========================================================================== #
+GLIBC_REPLY = 'marl2em'
+
+# =========================================================================== #
+# === command
+# =========================================================================== #
+def command(i);  e i, CMD; end
+  alias cmd command
+
+# =========================================================================== #
+# === command2
+# =========================================================================== #
+def command2(i)
+  e i, CMD2
+end; alias cmd2 command2
+
+# =========================================================================== #
+# === frage
+# =========================================================================== #
+def frage(i, optional_id = '')
+  br
+  e sg(:yel,'bblack2 marr4px')+i,
+    'FS1_4em BO BLOCK s0_5em',
+    optional_id,
+   'color: darkblue'
+end
+
+# =========================================================================== #
+# Dots
+# =========================================================================== #
+DOT109 = dot 109, 'marr8px'
+DOT108 = dot 108, 'marr8px'
+DOT107 = dot 107, 'marr8px'
+DOT106 = dot 106, 'marr8px'
+DOT105 = dot 105, 'marr8px'
+DOT104 = dot 104, 'marr8px'
+
+# =========================================================================== #
+# === COMPILE_HEADER2
+# =========================================================================== #
+COMPILE_HEADER2 = 'mars0_1em pad2px BO darkblue FW4'
+# =========================================================================== #
+# === COMPILE_HEADER3
+# =========================================================================== #
+COMPILE_HEADER3 = 'mars0_5em slateblue pad4px FI martb3px BO BG_White Black'
+
+# =========================================================================== #
+# === compile_header4
+# =========================================================================== #
+def compile_header4(i, extra_css = '')
+  h4 i,'mars2_5em darkgreen pad2px martb3px FW4 ind0px '+extra_css
+end
+compile_header5='mars3em pad2px FW4 martb3px'
+# =========================================================================== #
+# === PKG_CSS_ANSWER_CLASS
+# =========================================================================== #
+PKG_CSS_ANSWER_CLASS='s1em martb1px'
+CMD  = 'marl1em BO'
+CMD2 = 'marl2em BO'
+CMD3 = 'marl3em BO'
+
+# =========================================================================== #
+# === head
+# =========================================================================== #
+def head(i)
+  h3 dot(103,'marr8px')+i,'FI'
+end
+
+# =========================================================================== #
+# === display_internal_sitemap
+# =========================================================================== #
+def display_internal_sitemap
+  div('posab mar5px pad0_5em','','top:3.5em;right:30px;
+       background-color:#c9c2b7; border:3px solid slateblue') {
+    h2 'Sitemap','padl0_5em FI mart1px marb1em'
+    # ===================================================================== # 
+    # SITEMAP TAG
+    # ===================================================================== #
+    abr '#gcc_compile',
+         content: 'GCC'
+    abr '#autoconf',
+         content: 'Autoconfigure'
+    abr '#distributed_compiling',
+         content: 'Distributed Compiling'
+    abr '#configure_ac',   content: 'configure.ac'
+    abr '#CFLAGS',         content: 'CFLAGS'
+    abr '#distcc',         content: 'DISTCC'
+    abr '#make',           content: 'Make'
+    abr '#kobject',        content: 'KObject'
+    abr '#kd',             content: 'Der LD Linker'
+    abr '#pkg',            content: 'PKG'
+    abr '#pkgconfig',      content: 'Pkgconfig'
+    abr '#bootstrapping',  content: 'Bootstrapping'
+    abr '#crosscompiling', content: 'Crosscompiling'
+    abr '#glibc',          content: 'Glibc'
+    abr '#uclibc',         content: 'Uclibc'
+    abr '#elf',            content: 'ELF'
+    abr '#libtool', content: 'Libtool'
+    abr '#shared_libs', content: 'Shared Libraries'
+    abr '#appendix_compiling', content: 'Anhang zu Compiling'
+    abr '#chroot', content: 'Chroot'
+    abr '#libiconv',
+         content: 'Libiconv'
+  }
+end
+
+doc('pad5px s0_5em mar1px FW5 BG_Black padtb0_5em',
+    'compiling') {
+  h2 'Compiling',
+     'martb2px'
+  display_internal_sitemap
+  h1 sg(:angry_smiley,'padr1em', :drag)+'Compiling','yel mart4px'
+  div('mar0_2em pad10px s1em FW4 VERD mart1px','compilation',
+      'border-top: 10px solid slateblue;
+       border-left:6px solid slateblue;
+       border-right:4px solid slateblue;
+       border-bottom:4px solid slateblue;'+
+       MAIN_BACKGROUND_COLOR){
+    # ======================================================================= #
+    # ALLGEMEINES ZUM KONFIGURIEREN VON SOURCE DATEIEN
+    # ======================================================================= #
+    p('mart1px') {
+      h2 dot(106, 'marr8px')+'Allgemein lassen sich zu der Ambition,
+      Programme aus den Quellen heraus zu kompilieren,
+      einige Punkte feststellen:','bigger BO black'
+    }
+    div('ind1em marl1em') {
+      e 'Beginnen wir mit <b>GNU autoconfigure</b>.'
+      br
+      e '<b>configure</b> ist ein script, welches durch 
+      <b>GNU autoconfigure</b> bereitgestellt wird.'
+      br
+      e 'Es überprüft das System, und erstellt ein <b>Makefile</b>, 
+      das ans System angepasst ist.
+      Es ist somit ein script in einem aktuellen Verzeichnis
+      und sollte mit <b>./configure</b> aufgerufen 
+      werden (sofern man sich in diesem Verzeichnis befindet.)'; br
+      e '<b>Make</b> wiederum ist ein Programm, das zb typischerweise 
+      in <b>/usr/bin/make</b> residiert - bei mir hingegen auf 
+      <b>/Programs/Make/Current/bin/make</b>.'
+      br
+      e 'Das <b>eigentliche Kompilieren</b> eines Programmes kann 
+      nun bis zu <b>vier Phasen</b> umfassen, die immer in 
+      dieser Reihenfolge abgearbeitet werden:'
+      br
+      css_class = 'marl3em slateblue BOLD'
+      counter_li '  preprocessing',css_class
+      counter_li '  compilation',css_class
+      counter_li '  assembly',css_class
+      counter_li '  linking',css_class
+      p_default {
+        e 'Der <b>Vorteil von GNU autoconfigure</b> liegt darin, 
+        das der selbe Source Code auf <i>verschiedenen</i> 
+        Plattformen kompiliert werden kann.'
+        br
+        anm 'Man erkennt Autoconf Dateien an der Endung <b>.ac</b>' 
+      }
+      p {
+        e 'Die Gesamtaufgabe der portablen Konfiguration, Übersetzung 
+        und Installation von Programmen und Bibliotheken wird von
+        insgesamt <b>drei</b> Programmen erledigt:'
+        e 'Autoconf erzeugt aus einem Beschreibungsfile 
+        (<b>configure.in</b>) ein <b>Shell-Skript</b> - das 
+        vielleicht bereits bekannte <b>./configure</b> Skript, 
+        welches wiederum durch kurze Test-Programme und -Skripten 
+        die Eigenschaften des Ziel-Betriebssystems feststellt, 
+        unter anderen werden auch einige headerfiles kontrolliert.'
+        br
+        anm 'Übrigens, fehlt einmal die <b>configure Datei</b>, 
+        kann man sie unter Umständen mittels: 
+        <b>aclocal; autoconf; ./autogen.sh</b>'
+        br
+        e '<b>aclocal</b> erzeugt dabei aus dem Inhalt von configure.in 
+        Dateien die entsprechenden aclocal.m4-Dateien.','','configure_in'
+        e 'Aus den nun generierten Makefile-Fragmenten 
+        (Makefile.in) wird endgültige Makefile erzeugt.'
+        e 'Automake erlaubt es, aus einer knappen Spezifikation 
+        der zu erzeugenden Programme und der Quellfiles,'
+        e 'aus denen sie gebaut werden sollen (Makefile.am), 
+        Makefile.ins zu erzeugen, die den GNU Coding Standards 
+        entsprechen.'
+        e 'Mit anderen Worten, aus Makefile.am wird ein 
+        Makefile.in. (Makefile.am -> Makefile.in)'      
+      }
+      p {
+        s2 '<b>Libtool</b> erlaubt schließlich die portable 
+        Erzeugung von Shared Libraries. Mehr zu Libtool '
+        abr 'hier',
+             content: 'hier', css_class: 'BO slateblue'
+      }
+      p {
+        e 'Der <b>Runtine Linker</b> muss auch imstande sein, diese 
+        Shared Libraries zu finden.'
+        e 'Shared Libraries werden von dem <b>Loader /lib/ld-linux.so.X</b> 
+        gefunden.'
+        br
+        e 'ld-linux.so sucht ALLE verwendeten Libraries von dem 
+        aufgerufenen Programm.'
+      }
+      p {
+        e 'Folgendes Bild mag einem helfen, Autoconfigure 
+        besser zu verstehen:'
+        br
+        dimg 'PC/OS/LINUX/AUTOCONFIGURE_IMAGE.png',
+             'bblack3 mart5px marl5em'
+      }
+      p {
+        e 'Zu <b>configure.in</b> ist zu sagen, das es von dem m4 
+        Macro Processor bearbeitet wird.'
+        br
+        e 'Abgesehen von diesen Macros ist es einfach nur ein shell
+        script.'
+        e 'Die Macros sind M4 Macros und ein Entwickler der mit GNU
+        Autoconfigure arbeitet muss diese Macros verwenden.'
+        e '(Es wird empfohlen mit einer bestehenden configure.in 
+        Datei anzufangen und diese den Bedürfnissen 
+        entsprechend anzupassen.)','marl1em','m4' # rfcompile m4 
+        e 'M4 Macros sehen hässlich aus und sind es auch. 
+        Kommentare geschehen nach dem Schlüsselwort dnl.'
+        e 'Per Konvention beginnen alle Macros von Autoconf
+        mit <b>AC_</b>'
+        br
+        e 'Die (spezifischen) Macros von <b>automake</b> 
+        beginnen allesamt mit <b>AM_</b>'
+        e 'Man sollte auch bedenken das AC_CHECK_HEADER
+        und die andere AC_* Macros immer in [] Quotes gesetzt 
+        werden sollten.'
+      }
+      p {
+        e 'Beispiel für <b>configure.in</b> Strukturen:'
+        cmd 'AC_INIT(libfoo.h)'
+        e 'libfoo.h sollte hier mit einer Header Datei ersetzt 
+        werden, die in der Library mitgeliefert wird. Der Zweck 
+        von AC_INIT ist es, Autoconf zu initialisieren.'
+        anm ' AC_INIT muss immer als erstes in 
+        configure.in stehen!'
+        cmd 'AM_CONFIG_HEADER(config.h)'
+        e 'Dies hier erzeugt eine .config.h Datei'
+        br
+        e 'Mittels'
+        cmd 'AM_INIT_AUTOMAKE(libfoo,0.0.0)'
+        e 'gibt man den <darkblue>Namen des Projekt</> zu 
+        automake an (inklusive Version Numbering).'
+        br
+        e 'Das was dahinter kommt sind die Versionen - 
+        in Reihenfolge die "major", "minor", "micro" Versionen.'
+        br
+        e 'Die folgenden 3 Macros initialisieren 
+        den C compiler und libtool:'
+        br
+        cmd 'AC_PROG_CC'
+        cmd2 'Erlaubt auch optional die Angabe anderer 
+        Compile: <b>AC_PROG_CC(cl egcs gcc cc)</b>'
+        cmd 'AC_PROG_CPP'
+        cmd 'AM_PROG_LIBTOOL'
+        br
+        e 'Die CPP Line setzt den C Präprozessor 
+        fest, der für einige Library Tests notwendig ist.'
+        br
+        e 'AM_MAINTAINER_MODE schaltet den Maintainer Mode ein:'
+        br
+        cmd 'AC_CHECK_LIB(appname, test_function)'
+        br
+        e '# Find out about the host we are building on:'
+        br
+        cmd 'AC_CANONICAL_HOST'
+        br
+        cmd 'AC_ARG_ENABLE(opi,[ --enable-opi include support for OPI comments]'
+      }
+      div('pad1em BG_Black','','color:#B0E0E6') {
+        e 'Um ./configure mit einem bestimmten Ziel zu 
+        kompilieren ist die --prefix=/target Option wichtig.'
+        br
+        e 'Hat man noch Libraries, muss man eventuell 
+        <a href="#LDCONFIG" class="slateblue">ldconfig</a> verwenden, damit
+        diese auch gefunden werden  (post-make install method)'
+      }
+      div {
+        e '<b>Autoconf</b> setzt ausserdem selbst einige Variablen, wie 
+        zB die Variable <b>prefix</b>, die im Makefile.in als 
+        <b>@prefix@</b> gekennzeichnet ist.'
+        br
+        e 'Ein Makefile wiederum ist eine Datei, die das Programm 
+        <b>make</b> benutzt, um Programme zu kompilieren. 
+        Ändert man eine Datei, die Bestandteil des Programm ist, 
+        kann man wiederum make aufrufen, um nur jene Teile zu 
+        ändern, die auch <b>geändert werden müssen</b>.'
+        e 'Das war der Hauptgrund für die Entwicklung von make. 
+        Mit anderen Worten kann man den Make Prozess getrost 
+        unterbrechen und ihn <b>später</b> wieder neu starten.'
+        e 'Im <a href="#makefile">Anhang</a> findet man eine Liste 
+        von Makros und ein Beispiel für ein gutes Makefile.'
+        br
+        e 'C Programme die in mehrere Dateien aufgeteilt 
+        sind, lassen sich mittels gcc auch kompilieren.'
+        e 'header Files muss man dabei nicht angeben, da sie in 
+        der .c Quelldatei beschrieben werden, allerdings muss man 
+        die .c Dateien alle angeben, zb:'
+        cmd '  gcc -Wall main.c hello_fn.c -o newhello'
+        cmd '  gcc -Wall foobar1.c foobar2.c foobar_n.c -o newhello'
+        br
+        lem 'Dies ist bei grossen Programmen nicht mehr wirklich 
+        praktisch, da man bei jeder Änderungen in der .c Datei alles 
+        neu kompilieren müsste.'
+        br
+      }
+    }
+  }
+  div('default') {
+    dimg 'PC/OS/LINUX/COMPILING_SOFTWARE.png','bblack3 FLR'
+    h2 DOT108+'Compilation / Kompilierung | Configuration / Konfiguration',
+       COMPILE_HEADER3+' mars0_5em','', 'border-bottom:1px dotted darkgreen'
+    h3 'Was bedeuten die verschiedenen Compile / Configure 
+    options?',COMPILE_HEADER3,'autoconfigure' #autoconfigure tag
+    table2 's3em FS1em FW5','autoconf','',
+    '--prefix=/usr,--prefix=$HOME, 
+     <b class="firebrick">--prefix=$PROGRAMS/NAME_DES_PROGRAMMES</b>',
+    'Wo installieren wir Binaries, Libraries und weitere Dateien hin? 
+     Eben genau dorthin, oder in dein $HOME dir.',
+    '--with-','Gibt an, welche zusätzlichen Libraries mit 
+     installiert werden sollen.
+     Manchmal gibt man mittels --with auch an, wo 
+     verschiedene Bibliotheken zu finden sind, zB: 
+     --with-qt=/opt/qt3',
+    '--enable-confdir=LOCATION','setzt wohin Konfigurationsdateien gehen sollen.',
+    '--cache-file=FILE','cache test results in FILE. Configure
+    unterstützt caching, und hier teilt man mit wo der Cache liegt.'
+  e 'Allgemeiner kann man dies hier nutzen um die Installation eines
+     Programmes zu adaptieren:'
+  p('ind0px marl1em'){
+    cmd3 '<b>--bindir=DIR</b>         user executables [EPREFIX/bin]'
+    cmd3 '<b>--datadir=DIR</b>        read-only architecture-independent data [PREFIX/share]'
+    cmd3 '<b>--infodir=DIR </b>       info documentation [PREFIX/info]'
+    cmd3 '<b>--libdir=DIR      </b>   object code libraries [EPREFIX/lib]'
+    cmd3 '<b>--libexecdir=DIR </b>    program executables [EPREFIX/libexec]'
+    cmd3 '<b>--localstatedir=DIR </b> modifiable single-machine data [PREFIX/var]'
+    cmd3 '<b>--sbindir=DIR    </b>    system admin executables [EPREFIX/sbin]'
+    cmd3 '<b>--sysconfdir=DIR     </b>read-only single-machine data [PREFIX/etc]'
+    cmd3 '<b>--sharedstatedir=DIR</b> modifiable architecture-independent data [PREFIX/com]'
+    cmd3 '<b>--includedir=DIR  </b>   C header files [PREFIX/include]'
+    cmd3 '<b>--oldincludedir=DIR </b> C header files for non-gcc [/usr/include]'
+    cmd3 '<b>--mandir=DIR  </b> man documentation [PREFIX/man]'
+  }
+  e 'Will man in einem <b>configure.ac Script</b> eine Variable 
+     setzen geht dies so:'
+  br
+  cmd 'DEINE_VARIABLE="-L/irgendein/Wert"'
+  br
+  h3 'Beispiele:',COMPILE_HEADER3,'','configure'
+    compile_header4 'configure --prefix=$PROGRAMS/SDL-1.2.8'
+  }
+  # ========================================================================= #
+  # GCC TAG gcc tag
+  # ========================================================================= #
+  # GCC ist das A und O.
+  # ========================================================================= #
+  div('default mart5px'){
+    e sg(:pfeil10,'marr1em')+'Kommen wir nun zu GCC - der compiler Suite ...'
+    h1 sg('PC/OS/LINUX/GCC_FAVICON.png','',:drag)+
+    'About GCC / Über GCC',COMPILE_HEADER3+' mars0_5em mart1em wid60',
+    'gcc_compile','border-bottom:2px solid slateblue'
+    br
+    e 'Man kann Programme in .o Objekt Dateien kompilieren, und diese 
+    .o Dateien später verknüpfen (<b>linking</b>).'
+    br
+    e 'Dieses Erstellen von <b>.o Dateien</b> geht mit 
+    der <b>-c Option</b> so:'
+    br
+    cmd '  gcc -Wall -c test1.c'
+    br
+    e 'Die entstehenden .o Dateien kann man nun wie folgt verknüpfen:'
+      br
+      cmd '  gcc main.o hello_fn.o -o hello'
+      br
+      e '(Beim Verlinken macht die -Wall Option keinen Sinn, da ja bereits 
+      vorher die Quelldateien überprüft wurden - hoffentlich. Objekt Dateien 
+      enhalten bereits den Maschinencode.)'
+      br
+      e 'Mittels -l können Libraries verlinkt werden. Alternativ 
+      kann der reelle Pfad angeben werden, dies ist aber nicht 
+      besonders praktisch.'
+      br
+      e 'Um zum Beispiel gegen die Math Library zu linken würde das hier
+      funktionieren:'   
+      cmd 'gcc -Wall calc.c -lm -o calc'
+      br
+      e 'Übrigens linkt -l default mässig nur gegen .a Libraries, nicht
+      gegen .so Libraries.'
+      e '-Wall findet auch keine Problem während des Erstellen 
+      des Programmcodes, zb bei einem NULL Pointer.'
+      br
+      e 'Auch hier kommt es auf die Reihenfolge an - Bibliotheken 
+      die zuerst erscheinen (von links nach rechts) werden zuerst 
+      eingebunden.'
+      br
+      e 'Wie findet gcc die Libraries und Include Dateien?'
+      e 'Defaultmässig sucht gcc für header Dateien 
+      (Include Path) in:' 
+      cmd '  /usr/local/include/'
+      cmd '  /usr/include/'
+      e 'Für Libraries (Link Path) nutzt gcc:'
+      cmd '  /usr/local/lib/'
+      cmd '  /usr/lib/'
+      e 'Die /local Varianten werden zuerst '+sg(:rufzeichen)+'
+      durchsucht.'
+      br
+      e 'Gibt es Bibliotheken, die in anderen Verzeichnissen residieren, 
+      muss man die <b>Suchpfade erweitern</b>. Dazu nutzt man -I und -L, 
+      wobei der ld Linker manchmal nicht die Dateien finden kann, und 
+      zb so einen Fehler ausgibt:'
+      cmd '  /usr/bin/ld: cannot find -lgdbm'
+      br
+      e 'Den absoluten Pfad von header Files in 
+      <b>#include</b> anzugeben ist nicht so gut, da dies 
+      auf anderen Systemen meistens nicht mehr funktioniert.'
+      br
+      e 'Mittels <b>"-nostdinc"</b> kann man normale 
+      Suchpfade ignorieren, das mag wichtig sein wenn man 
+      alternative Include Verzeichnisse verwenden will.'
+      br
+      e 'Den <b>C Include Path</b> kann man auch weiters so setzen:'
+      cmd ' C_INCLUDE_PATH=/opt/gdbm-1.8.3/include'
+      br
+      e 'Ähnliches geht auch mit <b>CPLUS_INCLUDE_PATH</b> für CPP Dateien.
+      Diese beiden Variablen werden erst nach /usr/local/include und
+      /usr/include durchsucht.'
+      e 'Um mehrere Verzeichnisse anzugeben können 
+      die Einträge mit <b>:</b> getrennt werden.'
+      br
+      e 'Statische Libraries haben einige Nachteile, der 
+      prominenteste Nachteil ist, das Programme viel grösser werden.' 
+      e 'Gcc versucht daher immer, shared Libraries zu 
+      nutzen (by default). Wann immer ein libNAME.a vorhanden 
+      ist, versucht gcc herauszufinden ob es nicht eine 
+      libNAME.so Version davon gibt. Gibt es diese, so 
+      wird sie anstatt von libNAME.a benutzt.' 
+      e 'Dieses Verhalten kann aber ausgeschalten werden, 
+      indem man gcc mitteilt, dies nicht zu tun (-static):'
+      cmd 'gcc -Wall -static -L/opt/gdbm-1.8.3/lib/ 
+      dbmain.c -lgdbm'
+      e 'Will man 64 Bit Binaries mit GCC erzeugen, verwendet
+      man die <b>-m64</b> flag.'
+      cmd 'gcc -m64 foobar.c -o foobar'
+      e 'GNU GCC hat einige Dialekte drauf, die mit -ansi und -pedantic 
+      kontrolliert werden können. -ansi zb schaltet bestimmte Keywörter 
+      im GNU GCC aus, wie asm, und erlaubt somit die Verwendung einer 
+      Variablen die asm genannt wird.'
+      e 'Weitere GNU GCC Variablen, die nicht in Ansi vorkommen, 
+      sind <b>inline, typeof, unix und vax</b>.'
+      e 'Die Verwendung von -pedantic und -ansi sorgt 
+      dafür das alle GNU C Extensions zurückgewiesen werden.'
+      e 'Dies hilft, wirklich portablen C Code zu schreiben.'
+      e '-Wall kombiniert man oft mit -W, die zwei sind 
+      leider nicht das selbe.'
+      br
+      e 'Ansonsten kann man testweise probieren, sein C Programm 
+      mit <b>jenen folgenden Optionen</b> zu kompilieren (aliased 
+      auf <b>gccbig</b>):'
+      cmd '  gcc -ansi -pedantic -Wall -W -Wconversion 
+      -Wshadow -Wcast-qual -Wwrite-strings'
+      e 'Debug Information kann man nutzen, 
+      und zwar mittels -g. Dies bläht aber das Executable auf.'
+      e 'Crashed ein Program, dann kann das 
+      OS ein core file (.core) schreiben. '
+      br
+      e 'Wird kein core dump file erstellt, liegt dies wohl 
+      an einem Bash setting, welches man hiermit beseitigen kann:'
+      cmd '  ulimit -c unlimited'
+      e 'Nun kann man <i>gdb</i> nutzen:'
+      cmd '  gdb EXECUTABLE-FILE CORE-FILE'
+      cmd '  gdb a.out core.32214'
+      e 'Ein breakpoint stoppt das Exekutieren eines Programmes, und 
+      gibt die Kontrolle zurück zu dem Debugger. Das Kommando dazu 
+      ist <b>break</b>'
+      e 'Seit GCC 4 gibt es die Compile Option 
+      <b>-fvisibility=hidden</b>. Erstellt man eine shared 
+      library mit dieser Flag, dann versteckt GCC alle 
+      Symbole die nicht explizit als visible markiert sind.'
+      e '-fvisibility=hidden verkürzt oft die Ladezeiten, 
+      insofern ist es eine nützliche Compiler Option.'
+      e '-Wc++-compat ist auch recht nützlich, denn es gibt einem 
+      Warnungen über Constructs die einen C++ Compiler stören könnten.'
+      e 'Der GCC ld-wrapper ist collect2.'
+      # 32 Bit Applikationen kompilieren, mittels -m32.
+      frage 'Wie kompiliere ich eine 32-Bit Applikation mittels GCC 
+      auf einem 64-bit System?','m32'
+      e 'Dies erfolgt mittels der <b>-m32</b> bzw. der <b>-m64</b> Option.'
+      br
+      e 'Diese Optionen generieren Code für eine 32-bit oder eben
+      für eine 64-bit Umgebung.'
+      br
+      lem 'Die 32-bit Umgebung setzt int, long und pointer zu 32 bits 
+      and erstellt Code der auf jedem i386 System läuft.'
+      lem 'Die 64-bit Umgebung sets int to 32 bits and long 
+      and pointer to 64 bits and generates code for AMDs x86-64 
+      architecture.'
+      br
+      e 'Hier Beispiele.'
+      br
+      e 'Kompilieren für eine <b>32 bit Version</b>:'
+      cmd '  gcc -m32 -o output32 hello.c'
+      e 'Kompilieren für eine <b>64 bit Version</b>:'
+      cmd ' gcc -m64 -o output64 hello.c'
+      br
+      e 'Und das Resultat ruft man wie folgt auf:'
+      cmd '  ./output32'
+      # ======================================================================= #
+      # CODING STANDARDS zu GCC
+      # ======================================================================= #
+      h2 sg(:scale,'marr8px')+'Coding Standards für GCC',COMPILE_HEADER3,'coding_standards'
+      compile_header4 '<a href="http://www.gnu.org/prep/standards/standards.html#Preface">
+      http://www.gnu.org/prep/standards/</a>'
+      # ======================================================================= #
+      # GCC FLAGS.
+      # ======================================================================= #
+      h4 'Was gibt es zu gcc und den gcc Flags zu sagen?',
+         COMPILE_HEADER3,'gcc'
+      compile_header4 'GCC ist das *nix Tool schlecht hin zum Erstellen von 
+      ausführbaren Dateien aus .c oder .gcc Dateien. 
+      Als solches ist gcc lediglich ein <b>Front End</b>. 
+      Es handelt sich bei GCC (<b>GNU Compiler Collection</b>) um einen 
+      ANSI C compiler mit Unterstützung für K&R C, C++, Objective C, 
+      Java, Fortran, Ada, treelang.
+      GCC analysiert welche Sources man hat und bestimmt dann den 
+      passenden Compiler dazu.
+      Beispiel - der Ada compiler heisst gnat1 und der 
+      C compiler heisst cc1.<br/>
+      GCC ist auch gut beim Erstellen von Debugging Information, und
+      unterstützt auch Intel IA-64 Prozessoren. 
+      Die erste Version erschien am <b>22. März 1987</b>. 
+      Mittlerweile umfasst GCC über 25.000 Dateien mit mehr als 
+      2,1 Millionen Zeilen Code. <br/>
+      Mit dem <b>Tree-SSA-Projekt</b>, das ab GCC 4.0 verwendet wird,
+      wurden zwei neue Formen von sprachunabhängigen Bäumen  
+      eingeführt (<b>GENERIC und GIMPLE</b>) <br/>
+      Parsing wird nun durchgeführt, indem ein temporärer sprachabhängiger
+      Baum nach <b>GENERIC</b> konvertiert wird. Der so genannte <b>Gimplifier</b>
+      überführt diese komplexe Form in die SSA-basierte GIMPLE-Form,
+      von der ausgehend eine Reihe neuer sprach- und architekturunabhängiger
+      Optimierungen durchgeführt werden können.
+      Übrigens - Optimierungen an diesen "Bäumen" passt normalerweise 
+      nicht in das Schema von <b>Frontend</b> und <b>Backend</b> - 
+      Die GCC-Entwickler haben diesem Teil des Compilers daher den 
+      Namen <b>Middleend</b> gegeben. 
+      Zu den gegenwärtig am SSA-Baum durchgeführten Optimierungen 
+      gehören Dead Code Elimination, Partial Redundancy Elimination, 
+      Global Value Numbering, Sparse Conditional Constant 
+      Propagation, und Scalar replacement of Aggregates.
+      Array-basierende Optimierungen wie zum Beispiel automatische 
+      Vektorisierung, wie sie der Intel-Compiler anbietet, werden 
+      gegenwärtig entwickelt. <br/>
+    Binaries die unter GCC kompiliert werden, sollten 
+    auch auf anderen Computern funktionieren - Rechner A 
+    kann daher auch für Rechner B, C und D die Binaries 
+    erstellen, die diese Rechner nutzen. Das mag in 
+    einem Netzwerk hilfreich sein.<br>
+    Folgendes Command zeigt einem welche Symbole 
+    gcc versteht:<br>
+    echo \'main(){printf("hello world\n"}\' | gcc -E -v -'
+    compile_header4 'GCC Braucht zum Funzen einige Dateien und Libraries, 
+    unter anderem auch die cc<b>1 Library</b>. Zb hier:<br/>
+    /usr/libexec/gcc/i386-unknown-linux/3.4.4/cc1
+    /usr/libexec/gcc/i386-unknown-linux/3.4.4/cc1obj
+    /usr/libexec/gcc/i386-unknown-linux/3.4.4/cc1plus'
+    # ======================================================================= #
+    # CREATE OBJECT FILE WITH GCC
+    # ======================================================================= #
+    h3 'Wie erstelle ich ein Objekt File mit gcc?',COMPILE_HEADER3
+    compile_header4 'gcc -g -O -c main.c','BO '
+    # ======================================================================= #
+    # WOZU OBJECT FILE
+    # ======================================================================= #
+    h3 'Wozu brauche ich ein Objekt File?',COMPILE_HEADER3
+    compile_header4 'Es speicht den Quellcode einer Datei. Hat man sehr 
+    viele Dateien, so','BO '
+    # ======================================================================= #
+    # CREATE OBJECT FILE WITH GCC WITHOUT DOING ALL STEPS
+    # ======================================================================= #
+    h3 'Wie erstelle ich ein Objekt File mit gcc ohne alle Schritte 
+    auszuführen?',COMPILE_HEADER3
+    compile_header4 '<i class="darkblue">gcc -c DEINE_C_DATEI</i> <br/> 
+    Hiermit wird nur eine Objektdatei erzeugt. Die 
+    Option -c dient zum Überspringen des Linker Teil.'
+    # ======================================================================= #
+    # GCC'S SEARCH DIRS AUSGEBEN  
+    # ======================================================================= #
+    h3 'Wie find ich heraus, für welchen Ort gcc configured war?',COMPILE_HEADER3
+    compile_header4 'gcc --print-search-dirs'
+    # ======================================================================= #
+    # GCC ABBRUCH NACH PRÄPROZESSOR
+    # ======================================================================= #
+    h3 'Wie veranlasse ich gcc dazu abzubrechen nach dem Präprozessor?',
+       COMPILE_HEADER3
+    compile_header4 'gcc -E'
+    # ======================================================================= #
+    # GCC FLAGS GCC OPTIONEN
+    # OPTIONEN -I und -D
+    #   rf comp gcc_optionen
+    # ======================================================================= #
+    h3 'Was bedeuten die gcc Optionen mit -I, -L und -D? (Include Flags)',
+        COMPILE_HEADER3+' mart2em','gcc_optionen'
+    compile_header4 '-I wird für INCLUDE Zeugs genutzt, -D dient als Hilfe 
+    für den C-Compiler.'
+    br
+    e 'Mittels -I werden library headers gefunden.'
+    e 'Die Option -L wird für den Linker genutzt, damit werden 
+    shared objects miteinander gelinkt. Mittels der 
+    Option --nodefaultinc kann man gcc veranlassen nichts 
+    zu inkludieren. Mittels -E kann man anschauen, 
+    was das Präprozessor macht.'
+    div('marl2em') {
+      e 'Hier eine Übersicht über einige wichtigere GCC Optionen:'
+      table2 'marl1em','','',
+        '-g','Die -g flag wird zum Erzeugen der
+          debug Symbols und line number Information genutzt: gcc test.c -g',
+          '-O0','schaltet alle Optimierungen aus'
+      }
+      frage 'Was bedeutet --disable-multilib?'
+      e 'multiple target libraries to support different target variants
+      will not be built. The default is to build predefined set of them.'
+      br
+      e 'Auf 64 Bit Systemen wird durch diese Option nur der 64 bits 
+      native compiler gebastelt, ohne 32 bits legacy.'
+      h4 'GCC Links und Ressourcen','s2em'
+      div('mars1em pad0_1em') {
+        abr 'http://gcc.gnu.org/',
+            content: 'GCC Homepage'
+      }
+      # ======================================================================= #
+      # configure.ac tag. autoconf tag
+      # ======================================================================= #
+      h4 'configure.ac','','configure_ac'
+      e 'Um bestimmte Packages abzufragen via pkgconfig, kann man dies 
+      hier nutzen in configure.ac:'
+      br
+      cmd 'PKG_CHECK_MODULES([GNOME], [gtk > 1.2.8 gnomeui >= 1.2.0])'
+      br
+      e 'Aus den configure.ac scripts wird das portable configure
+      script erstellt.'
+      br
+      h4 'Optimierungen mit GCC'
+    }
+    # ======================================================================= #
+    # aclocal.m4 tag.
+    # ======================================================================= #
+    div('default'){
+      h3 'Was gibt es zu aclocal.m4 zu sagen?',COMPILE_HEADER3,'aclocal.m4'
+      compile_header4 'M4 ist eine ziemlich komplexe Makro-Expansionssprache, 
+      deren Syntax kompliziert ist. 
+      Solche Makros werden üblicherweise in aclocal.m4 
+      untergebracht, wenn sie nur für das Paket verwendet 
+      werden, oder in acsite.m4, wenn sie auch in anderen 
+      Paketen benutzt werden können.'
+      h3 'Was gibts zu GNU autoconfigure zu sagen?',
+          COMPILE_HEADER3
+      compile_header4 'Zu finden auf <a href="http://www.gnu.org/software/autoconf/">Autoconf</a>.
+      Autoconfigure besteht aus m4 macros, die shell scripts erstellen.
+      Dabei muss man GNU m4 installiert haben.
+      (Auto)configure führt einige SystemTests durch, speichert
+      diese Information meistens in einer Datei namens <b>config.cache</b>
+      und produziert letzten Endes Konfigurations Skripte, die 
+      unabhängig von Autoconf laufen können - ein Enduser
+      muss daher nicht autoconf haben, um in den Genuss seiner
+      Vorteile zu kommen.
+      Zudem werden beim Kompilieren sogenannte Flags zu Rate gezogen, die zB
+      LDFLAGS genannt werden, und auf die korrekten Verzeichnisse hinzeigen.
+      Das configure script gibt Fehlermeldung aus, sofern eine configure option
+      nit gefunden wurde, zB Unknown Option n. Auch werden während 
+      der configure Phase niemals aktiv Änderungen vorgenommen, zb 
+      durch Erstellen von Verzeichnissen - dies wird durch <b>make</b> 
+      bzw <b>install</b> dann vorgenommen.'
+      h3 'Wie finde ich raus, welches --prefix= configure genutzt hat?',
+          COMPILE_HEADER3
+      compile_header4 'In der Datei <b>config.log</b>, greppen a la<br/>
+      grep "prefix=\'*\'" config.log |non } <br/>
+      Übrigens bestimmt ./configure automatisch das /usr/local 
+      das prefix ist.'
+    }
+  # ========================================================== #
+  # AM MACROS
+  # ========================================================== #
+  div('default s1em White'){
+    h3 'Wie nutze ich GNU autoconfigure für ein Programm, wenn es 
+        noch nicht GNU autoconfigure nutzt?',
+        COMPILE_HEADER3
+    compile_header4 'Zur Theorie dazu, siehen den Absatz weiter 
+    oben. Ansonsten startet man mit der Erstellung der Datei 
+    configure.in. Sie sollten diese Macros haben:'
+    e 'AM_ICONV','BO'
+    br
+    e 'The AM_ICONV macro tests for the presence of the 
+    POSIX/XSI iconv def family in either 
+    the C library or a separate libiconv library.'
+    e 'AC_INIT, AC_PREREQ(VERSION), AM_INIT_AUTOMAKE, AM_CONFIG_headER, 
+    AM_MAINTAINER_MODE, AC_EXEEXT, AC_PROG_CC, AC_PROG_CXX, 
+    AM_PROG_LIBTOOL, AC_DEFINe _GNU_SOURCE), AC_OUTPUT,'
+    anm 'Note: AC_INIT is always the first Macro in a 
+    configure.in script'
+  }
+  p {
+    e 'Nun schreibt man <b>Makefile.am</b>.'
+  }
+  # ========================================================================= # 
+  # glibc tag glib-config --cflags  glib tag. rf compile glibc
+  # ========================================================================= #
+  div('default pad1em') {
+    h2 'Glibc, Glib und ld.so'
+    div('FS1_1em ind1em','glibc') {
+      e '<b>glibc</b>, die <b>GNU C-Bibliothek</b>, ist eine freie 
+      Implementation der Standard C Library - die 
+      <b>Standard C Bibliothek unter Linux</b>.'
+      br
+      e 'GLib hingegen wiederum ist eine <b>Low-level core Bibliothek</b>, 
+      die die <b>Basis zu GTK+ und Gnome</b> bildet. Dies sollte man im 
+      Kopf behalten damit man diese zwei Bibliotheken nicht verwechselt.'
+      br
+      e 'Ein grosses Design Ziel der glibc Bibliothek ist die 
+      <b>Portabilität</b>, dies bedeutet aber auch, das Applikationen 
+      grösser werden, da portabler Code mitgeschleppt bzw kompiliert 
+      werden muss.'
+      e 'Dies ist zB der Fall bei statischen Programmverknüpfungen, 
+      wenn die Bibliothekfunktionen in die Exec kopiert werden - also 
+      bei allen lib Dateien, die <b>.a</b> Dateien sind, ansonsten
+      sind sie shared objects mit <b>.so</b> Endung.'
+      e 'Glibc steht unter <b>LGPL</b>, damit sie als Bibliothek 
+      auch unter nicht freier Software verwendet werden kann und darf.'
+      e 'Sie erfüllt zudem die C-Standards.'
+      br
+      e 'Warum brauchen wir die Glibc überhaupt auf Linux?'
+      e 'Glibc ist die <b>wichtigste</b> C Bibliothek.' 
+      e 'Sie definiert die system calls und andere 
+      Grundoperationen wie open, malloc, printf, exit','marl1em'
+      e 'Ohne sie kann man keine C Programme kompilieren 
+      - oder betreiben.'
+      # ======================================================================= #
+      # neueste glibc version
+      # ======================================================================= #
+      e 'Die neueste Version der glibc trägt 
+      Versionsnummer 2.7 (Stand: 24 NOV 2007)' 
+      br
+      e 'Es gibt übrigens schlankere Versionen von libc, zB 
+      <b>uClibc</b> und <b>dietlibc</b>. Zu dietlibc ein paar 
+      Beispiele im gleich folgenden Anhang.'
+      e '<b>glibc</b> wird von allen Programm verwendet. 
+      Wenn man also glibc upgraded, werden die aktuell 
+      laufenden Programme noch immer auf die alte (nun 
+      eventuell gelöschte glibc Bibliothek zugreifen.
+      Neue Programme, die nun gestartet werden, nutzen die 
+      neuere glibc Bibliothek - sofern vorhanden.'
+      br
+      e 'Eng verwandt mit glibc ist die Datei <b>ld.so</b>, die 
+      normalerweise unter <b>/lib/ld.so</b> zu finden ist.'
+      e 'ld.so ist der <b>dynamic library loader</b>.'
+      e 'Jedes Binary das shared library verwendet, hatte früher 3K 
+      start-up code. Der war notwendig um die shared libraries zu 
+      finden und laden.'
+      e sg(:ausrufungszeichen,'marr4px')+
+      'Aber was ist wenn Glibc gebrochen, also 
+      nicht verwendbar, ist?','s2em'
+      e 'Gute Frage - einige gebräuchliche Fehler 
+      sind folgende:'
+      e 'Um die Glib Version herauszufinden:'
+      e '  glib-config --version',GLIBC_REPLY
+      e 'bzw'
+      e '  pkg-config glib --cflags',GLIBC_REPLY
+      e 'und um die GTK Version herauszufinden'
+      e '  gtk-config --version',GLIBC_REPLY
+      br  
+      e 'Um glibc auch in zb /usr/local zu installieren
+      kann man diese Option nutzen:'
+      br
+      e ' --disable-sanity-checks ',GLIBC_REPLY
+      br
+      e 'Um nun sein System auf eine neue Libc zu portieren,
+      sollte man in etwa so vorgehen:'
+      br
+      e '1 Wichtige Dateien in /libc backupen:'
+      br
+      cmd 'cd /libcp libc.so* libm.* /libc_backup'
+      br 
+      abr 'http://www.gnu.org/software/libc/',
+          content: 'Offizielle Homepage der Libc'
+      abr 'http://www.linuxfromscratch.org/lfs/view/development/chapter05/glibc.html',
+          content: 'LFS Build Instructions der GLibc'
+      div('default') {
+        # ============================================================ #
+        # upgrade glibc tag. upgrade tag
+        #   rf compiling glibc_upgrade
+        # ============================================================ #
+        h2 sg('PC/OS/LINUX/UPGRADE.png','bblack1 marr4px')+
+        'Upgraden der Glibc','','glibc_upgrade'
+        p('','upgrade'){
+          e 'Da ich immer wieder Probleme mit dem Glibc Upgrade 
+          hatte, hier eine Liste an Dingen, die ich für einen 
+          <b>Glibc Upgrade</b> empfehle:'
+        }
+        p('marl3em ind0px') {
+          e '(1) Einige Programme sollten statisch kompiliert werden, 
+          zumindest aber <b>make</b> und nach Möglichkeit auch 
+          <b>tar</b> sowie <b>m4</b>'
+          br
+          e '(2) Für den Fall der Fälle braucht man wohl auch 
+          statische Versionen von <b>binutils</b>, <b>coreutils</b> 
+          und auch <b>busybox</b>'
+          br
+          e '(3) Auch <b>ncurses</b> sollte statisch kompiliert 
+          werden, sowie <b>bash</b>, <b>bzip</b>, <b>gawk</b>, 
+          <b>grub</b>, <b>nano</b> und - ganz 
+          wichtig - auch <b>sed</b>.'
+          br
+          anm ' Hier die <b>Liste</b>:'
+          br
+          e 'make, tar, m4, binutils, busybox, coreutils, bash, bzip2, 
+          gawk, grub, nano, sed, findutils','marl3em'
+          e '(4) Nun sollte man rebooten und 
+          <b>init=/bin/bash</b> durchführen.'
+          e 'Nachdem man Glibc upgegraded hat, sollte man 
+          <b>init -u</b> laufen lassen.'
+          e 'Nun ist es wichtig die GCC Specs anzupassen.'
+          br
+          e 'Also mal folgendes Command durchführen:'
+          br
+          cmd '  gcc -v'
+          br
+          e 'reading specs from /usr/lib/gcc-lib/i486-unknown-linux/2.7.2.2/specs'
+          e 'gcc version 2.7.2.2'
+          br
+          e 'Auch wird empfohlen, binutils, Gcc und coreutils 
+          erneut zu kompilieren ("rebuild" nachdem das Upgrade 
+          der Glibc geklappt hat. (Danach muss eventuell auch 
+          der Kernel neu gebastelt werden.)'
+        }
+        div {
+          h2 dot(102)+'Glibc Komponenten (Components of the GNU C Library:'
+          e '<table border="1" cellpadding="3" bordercolor="# 333333">
+          <tr>
+          <td>Component</td>
+          <td>Description</td>
+          </tr>
+          <tr>
+          <td><tt>ld.so</tt></td>
+          <td>Dynamic linker/loader</td>
+          </tr>
+          <tr>
+          <td><tt>libc</tt></td>
+          <td>Provides the majority of the C library routines 
+          (The file libc.so is a simple text file)</td>
+          </tr>
+          <tr>
+          <td><tt>libcrypt</tt></td>
+          <td>Implements cryptography routines</td>
+          </tr>
+          <tr>
+          <td><tt>libdl</tt></td>
+          <td>Enables dynamic loading of shared objects</td>
+          </tr>
+          <tr>
+          <td><tt>libm</tt></td>
+          <td>Provides the math routines for the C library</td>  
+          </tr>
+          <tr>
+          <td><tt>libnss_compat</tt></td>
+          <td>Implements Name Service Switch (<em>NSS</em> compatibility routines)</td>
+          </tr>
+          <tr>
+          <td><tt>libnss_dns</tt></td>
+          <td>Enables NSS routines for Domain Name Service (<em>DNS</em> lookups)</td>
+          </tr>
+          <tr>
+          <td><tt>libnss_files</tt></td>
+          <td>Provides file-based NSS services</td>
+          </tr>
+          <tr>
+          <td><tt>libnss_hesiod</tt></td>
+          <td>Implements NSS services for Hesiod name resolution</td>
+          </tr>
+          <tr>
+          <td><tt>libnss_nis</tt></td>
+          <td>Enables NIS database lookups for NSS</td>
+          </tr>
+          <tr>
+          <td><tt>libnss_nisplus</tt></td>
+          <td>Enables NIS+ database lookups for NSS</td>
+          </tr>
+          <tr>
+          <td><tt>libpthread</tt></td>
+          <td>Provides POSIX threads support routines for programming with pthreads</td>
+          </tr>
+          <tr>
+          <td><tt>libresolv</tt></td>
+          <td>Implements standard name resolution services</td>
+          </tr>
+          <tr>
+        <td><tt>libthread_db</tt></td>
+        <td>Provides debugging routines for pthreads-based programs</td>
+        </tr>
+        <tr>
+        <td><tt>libutil</tt>'
+      ctd
+      td 'Implements login and user accounting routines'
+      ctdctr
+      ctable
+      }
+      }
+    }
+  }
+  # ========================================================================= #
+  # OPTIMIEREN
+  # ========================================================================= #
+  h3 'Wie optimiere ich?',COMPILE_HEADER3
+  compile_header4 'zB mit --enable-CXXOPT= --enable-COPT='
+  # ========================================================================= #
+  # CLEANING
+  # ========================================================================= #
+  h3 'Wie räume ich mittels <b>make</b> auf?',COMPILE_HEADER3
+  compile_header4 '  make -C ld clean # dies würde alle erstellten
+  Dateien löschen.'
+  # ========================================================================= #
+  # LIB_PATH target
+  # ========================================================================= #
+  h3 'Wie spezifiziere ich ein anderes LIB_PATH target via make?',COMPILE_HEADER3
+  compile_header4 '  make -C ld LIB_PATH=/tools/lib'
+  # ========================================================================= #
+  # BOOTSTRAPPING
+  # ========================================================================= #
+  h3 'Was macht <b>make bootstrap</b>?',COMPILE_HEADER3
+  compile_header4 'Kompiliert das ganze mehrere Male. Alternativ dazu kann 
+  man auch <b>make bootstrap-lean</b> nutzen.'
+  # ========================================================================= #
+  # GUESS HOST SYSTEM VALUES
+  # ========================================================================= #
+  h3 'Gibt es einen Weg, die Werte des Host System zu überprüfen?',
+      COMPILE_HEADER3
+  compile_header4 './config.guess'
+  # ========================================================================= #
+  # ALLGEMEIN - KOMPILIEREN VON SOFTWARE AUF LINUX
+  # ========================================================================= #
+  h2 'Allgemeines Chit-Chat über Kompilieren von Software 
+  auf Linux','BO '+compile_header5
+  e 'Tools die mit Autoconf verwandt sind, bzw. eine ähnliche 
+  Funktionalität erfüllen sind <b>Metaconfig</b> und <b>imake</b>.
+  Mittels disable-static verbietet man das Erstellen von statischen 
+  Bibliotheken, es werden nur dynamische Bibliotheken verwendet.','s2em'
+  # ========================================================================= #
+  # BESTIMME PRÄPROZESSOR VARIABLEN BEIM KOMPILIEREN
+  # ========================================================================= #  
+  h3 'Wie kann ich Präprozessor Variablen bestimmen beim Kompilieren?',
+  COMPILE_HEADER3
+  compile_header4 'Mittels <b>-D</b>, wie in -DNDEBUG'
+  # ========================================================================= #
+  # GCC ENVIRONMENT VARIABLES
+  # ========================================================================= #
+  h3 'Welche Environment Variable nutzt GCC?',COMPILE_HEADER3
+  compile_header4 'GCC_EXEC_PREFIX'
+  # ========================================================================= #
+  # CROSS COMPILING - The Art of 
+  # ========================================================================= #
+  h3 'Cross Compiling - was gibts dazu zusagen?',
+      COMPILE_HEADER3,'crosscompiling'
+  compile_header4 'Cross compiling is the act of the building source code on 
+  one system, the <b>build host</b>, into executables or 
+  libraries to be run on a different host, the 
+  <b>native host</b>. 
+  The build host and the native host may differ in operating 
+  system and/or processor type.<br/>
+  Der Hauptgrund ist, das die Prozessorleistung des native host
+  meist ziemlich gering ist, zb weil es sich um einen alten 
+  Computer handelt.'
+  # ========================================================================= #
+  # COMPILE SPEED
+  # ========================================================================= #
+  h3 'Compile Speed - wie kann ich das compilen schneller 
+  durchführen?',COMPILE_HEADER3,'speedy_compile'
+  compile_header4 'Ich kann hier nur allgemeine Tipps geben. 
+  Nutze <b>tmpfs</b>.'
+  # ========================================================================= #
+  # MACROS und Fehlermeldungen
+  # ========================================================================= #
+  # UNDEFINED MACRO LIST
+  # ========================================================================= #
+  h3 'Was tun wenn ich die Fehlermeldung <b>Undefined Macro argument 
+     list</b> erhalte?',COMPILE_HEADER3
+  compile_header4 'Im Makefile bei <b>CFLAGS</b> die Option 
+  -no-cpp-precomp hinzufügen.'
+  e 'Übrigens: Mehr zu Macros sieht man hier:'
+  br
+  abr 'http://autoconf-archive.cryp.to/',
+      content: 'http://autoconf-archive.cryp.to/'
+  # ========================================================================= #
+  # FEHLER HANDLING bei configure.
+  # ========================================================================= #
+  h3 'Was tun wenn ich einen Fehler erhalte, das configure nicht 
+      den host type herausfinden kann?',
+      COMPILE_HEADER3
+  compile_header4 'config.sub und config.guess 
+  mit den Versionen von /usr/libexec austauschen. 
+  config.cache löschen.'
+  h3 'Was gehört in /usr/libexec? Was ist libexec?'
+  h4 sg(:pfeil_rechts, 'marr1em')+'Programme, die ausschliesslich von
+  <b>internen executables</b> verwendet werden (können). GCC libexec
+  wären somit alle jene Programme, die nur von GCC intern verwendet
+  werden.','marl2em'
+  e 'Wenn eine Bibliothek Programme aufruft die nur durch eine 
+  Bibliothek aufgerufen werden können, so sind sie libexec 
+  Dateien (und meistens in /usr/libexec zu finden).'
+  # ========================================================================= #
+  # LINKING tag ld tag
+  # ========================================================================= #
+  h2 'ld',
+     'martb3px '+COMPILE_HEADER2
+  div('default'){
+    h3 'Was gibts zu <b>ld</b> zu sagen?',COMPILE_HEADER3
+    p {
+      e 'ld ist <b>GNU Linker</b>. Die Grundeinstellung ist der Wert 
+      von echo $LIBPATH. Fehlt LIBPATH dann wird einfach
+      /usr/lib:/lib genommen.'
+      br
+      e 'ld verwendet die Variable SEARCH_DIR(path)+'
+      br
+      e 'The SEARCH_DIR command adds path to the 
+      list of paths where ld looks for archive libraries. 
+      Using SEARCH_DIR(path) is exactly like using -L path 
+      on the command line (see Command Line Options).'
+      br
+      e 'If both are used, then the linker will search both paths.'
+      br
+      e 'Alle Pfade, die mit -L spezifiziert werden, werden 
+      zuallererst durchsucht.'
+    }
+  }
+  # ========================================================================= #
+  # statisches kompilieren
+  # ========================================================================= #
+  div('default') {
+    h2 'Statisches Kompilieren mittels GCC'
+    e 'Vorweg - <b>statische Bibliotheken</b> sind Bibliotheken, 
+    in denen der eigentliche Code der Subroutinen mit 
+    der ausführbaren Datei gebunden wird.'
+    br
+    e 'Der Code für Routinen wie printf() kann allerdings ziemlich lang sein. 
+    Weil viele Programme häufig aufgerufene Routinen aus den Libraries 
+    benutzen, ist es besser diesen Teil nur einmal zu verwenden.'
+    br
+    e 'Hier kommen die <b>Shared Libraries</b> ins Spiel.'
+  }
+  # ========================================================================= #
+  # === crtbegin.o tag
+  # ========================================================================= #
+  div('default') {
+    h4 'crtbegin.o'
+    e 'gcc uses <b>crtbegin.o</b> to find the start of the constructors, 
+    so we make sure it is first.'
+    br
+    e 'A wildcard  means that it doesnt matter which 
+    directory crtbegin.o is in.'
+  }
+  # ========================================================================= #
+  # === PMK TAG
+  # ========================================================================= #
+  div('default bblack3') {
+    h2 'Premake Kit'
+    div {
+      h2 'PMK tutorial'
+      e 'Make nutzt ein makefile, pmk nutzt ein pmkfile. Ein pmkfile 
+      hat ein paar Commands die die Source Abhängigkeiten testen. 
+      Danach werden Template Dateien prozessiert.'
+      br
+      e 'Das erste Command in einem pmkfile ist <b>SETTINGS</b>, zum Beispiel'
+      br
+      cmd 'SETTINGS {'
+      cmd2 '  TARGET = ("Makefile.in")'
+      cmd '}'
+      br
+      e 'Das Ziel hier ist Makefile.in.'
+      br
+      e 'Um etwas zu definieren wird DEFINE genutzt:'
+      br
+      cmd 'DEFINE {'
+      cmd2 '  PACKAGE = "hello"'
+      cmd2 '  VERSION = "0.1"'
+      cmd '}'
+      br
+      e 'Folgende spezielle Namen/Tags werden ersetzt:'
+      br
+      cmd '@PACKAGE@, @VERSION@'
+      br
+      e 'Angenommen wir haben eine hello.c Datei, die 
+      einen string header braucht. Dann baut man das ein:'
+      br
+      cmd 'CHECK_headER(header_string) {'
+      cmd2 '  NAME = "string.h"'
+      cmd '}'
+      br
+      e 'NAME hat hier den header drinnen, der gechecked 
+      werden soll.'
+      br
+      e 'Ist der check erfolgreich, wird dieses Label 
+      als true angenommen, ansonsten false.'
+      br
+      e 'So erstellt man ein Test Makefile.in'
+      br
+      cmd 'echo "PACKAGE=@PACKAGE@" > Makefile.in'
+      cmd 'echo "VERSION=@VERSION@" >> Makefile.in'
+      br
+      e 'Nun kann man <b>pmk</b> aufrufen.'
+      br
+      e 'Eine Library kann man so abfragen'
+      br
+      cmd 'CHECK_LIB(lib_curses) {'
+      cmd2 '  NAME = "curses"'
+      cmd '}'
+    }
+    h2 'Links'
+    abr 'http://pmk.sourceforge.net/pkgconfig.php',
+        content: 'PreMakeKit - Alternative zu pkgconfig'
+  }
+  div {
+    abr :local_make,
+        content: 'Make'
+  }
+  # ========================================================================= #
+  # === LDCONFIG TAG
+  # ========================================================================= #
+  div('default','ldconfig'){
+    h2 'ldconfig'
+    br
+    e 'ldconfig aktualisiert alle (shared) Libraries auf einem System - 
+    gibt das ganze in einen Cache, so das Programme mit shared 
+    libraries nicht das Filesystem jedes mal durchsuchen müssen.'
+    br
+    e 'Es nimmt die Information von <b>/etc/ld.so.conf</b> auf.'
+    br
+    e 'Dabei unterscheidet man folgende verschiedene Library-Names:'
+    p('s3em') {
+      b 'Realname ','darkslateblue';
+      e 'Libary:'
+      br
+      cmd '  /usr/lib/libreadline.so.3.0'
+      br
+      b 'Sonamed ','darkslateblue'
+      br
+      e 'Library:'
+      br
+      cmd '  /usr/lib/libreadline.so.3'
+      br
+      b 'Linkername ','darkslateblue'
+      br
+      e 'Library:'
+      br
+      cmd '  /usr/lib/libreadline.so'
+    }
+    e 'Die Datei /etc/ld.so.cache ist insofern wichtig, da sie 
+    die Performance des <b>ld.so</b> abr beschleunigt.'
+  }
+  # ========================================================================= #
+  # === memory, ram, System
+  # ========================================================================= #
+  div('FSI pad5px BG_White','','memory'){
+    h3 'Segmentation Fault',
+       'mart4px BG_Black FW5 wid96 FS1em BOLD pad8px s1_5em slateblue'
+    e 'Passiert wenn ein Programm versucht Speicherwerte zu
+    nutzen, die nicht freigemacht wurden. Das Programm meldet
+    sich zurück mit einem <i>core dump</i>.'
+  }
+  # ========================================================================= #
+  # === LIBICONV TAG
+  # ========================================================================= #
+  h3 'Was macht libiconv?',
+      COMPILE_HEADER3,
+     'libiconv'
+  div('BG_White Black','libiconv') {
+    e 'Nachdem man GNU libiconv kompiliert hat, sollte man GNU gettext
+    erneut kompilieren, damit es libiconv verwenden kann.'
+    br
+    e 'Libiconv in der Glibc wird so gechecked:'
+    br
+    cmd '  checking for iconv_open() in -lc... yes'
+    br
+    e 'Offensichtlich ist sie vorhanden °_°'
+  }
+  # ========================================================================= #
+  # === GCC Troubleshooting.
+  # ========================================================================= #
+  p_default {
+    e 'Mögliche Probleme mit GCC:'
+    br
+    e 'Man muss immer auf korrekte headers achten. Ich hatte 
+    einmal Probleme, da gcc die falschen headers nutzte.'
+    br
+    e 'Nachdem ich die falschen headers löschte, kam das Problem 
+    nicht mehr auf.'
+    br
+    e 'Cannot guess build type'
+    br
+    e 'In diesem Falle kann man dem configure script 
+    <b>--build=i686</b> übergeben.' 
+  }
+  # ========================================================================= #
+  # === libsuffix
+  # ========================================================================= #
+  div('default') {
+    e '<b>--disable-libsuffix</b> hilft manchmal bei Problemen mit KDE 
+    und ähnlichem.'
+  }
+  # ========================================================================= #
+  # === C Standard Files. Was macht zB stdio.h?
+  # ========================================================================= #
+  div('default'){
+    h3 'Was macht stdio.h?',
+        COMPILE_HEADER3
+    compile_header4 'Die <b>stdio.h</b> Bibliothek kümmert sich um 
+    standard input und output Funktionen für C Programmierer.'
+  }
+  # ========================================================================= #
+  # === Bootstrapping TAG bootstrap tag
+  #
+  # rf compile bootstrapping
+  # ========================================================================= #
+  div('default'){
+    h1 dot(102)+'Bootstrapping','','bootstrapping'
+    h3 'Bootstrapping, Toolchains und Erstellen eines LFS mit Hilfe von uLibc'
+    p {
+      e 'Jeder <b>Prozess</b>, der ein kompliziertes System 
+      aktiviert, wird <b>Bootstrapping</b> genannt.'
+    }
+    p('ind0px'){
+      e 'Auf Englisch hört sich dies ein wenig anders an:'
+      br
+      e '<quote>
+      "The term to bootstrap refers to a person who tries to 
+      stand up by pulling on his boots."
+      </quote>'
+      br
+      e 'In operating systems the term refers to the process in 
+      which a part of the operating system is brought into 
+      the Main Memory, with the processor executing those 
+      instructions. At bootstrapping the internal data 
+      structures of the Linux Kernel are initialized, values 
+      are set to the constituent variable s, and processes 
+      are created that usually spawn other significant 
+      processes later.','padl1em'
+      br
+      e 'Computer bootstrapping is a long and complicated 
+      task because when the computer is switched on all the 
+      hardware devices are in an unpredictable state, while 
+      the RAM is inactive and in a random state. Thus, 
+      the thing to keep in mind is the process called 
+      bootstrapping is highly dependent on the computer 
+      architecture in question.'
+    }
+    h4 'Die <b>setup </b> Funktion','','setup'
+    p {
+      s2 'The setup  def can be found in the file '
+      e '/usr/src/ KERNEL_V /arch/i386/boot/setup.S','BO'
+      br
+      e 'The code of the setup  assembly language 
+      def is placed by the linker immediately after the 
+      integrated boot loader of the Kernel, that is, 
+      at offset 0x200 of the Kernel Image file. 
+      This allows the boot loader to locate the code easily and 
+      copy it onto the RAM starting from the physical address 
+      x00090200.'
+      br
+      e 'Now the question that comes up is:
+      What does this setup  def do? As its name 
+      suggests, it is supposed to set up something. 
+      As we all know for the Kernel to operate properly all 
+      the hardware devices in the computer must be detected 
+      and then initialized in an orderly fashion. 
+      The setup  def initializes all the hardware 
+      devices and thus creates an environment for the Kernel 
+      to operate in.'
+      br
+      e 'Normally the BIOS should do all this.
+      Although the BIOS already initialized most hardware, 
+      the Linux Kernel does NOT rely on it and initializes 
+      all of the hardware in its own fashion!'
+      br
+      e 'But, if someone asks, well, why does Linux 
+      operate in such a way? The answer to this question 
+      is both very easy yet extremely difficult to explain. 
+      The Linux Kernel had been so designed to enhance 
+      portability and robustness. This is one of the 
+      many features that makes the Linux Kernel very flexible -
+      and unique.'
+      br
+      e 'The setup code mainly performs the following tasks:'
+      br
+      e '1. First, total amount of physical RAM available to the 
+      system is detected. It invokes a BIOS procedure for detecting 
+      the RAM.'
+      br
+      e '2. Sets the Keyboard repeat delay and rate.'
+      br
+      e '3. The Video adapter card is detected.'
+      br
+      e '4. The Disk Controller is reinitialized and hard disk 
+      parameters are determined.'
+      br
+      e '5. Checks for an IBM Micro Channel bus (MCA+'
+      br
+      e '6. Checks for a PS/2 pointing device (bus mouse+'
+      br
+      e '7. Checks for Advanced Power Management (APM BIOS support.'
+      br
+      e '8. Checks the position of the Kernel Image loaded in RAM. 
+      If loaded "low" in RAM (when using zImage, at physical 
+      address 0x00010000 it is moved to "high" in RAM (at physical 
+      address 0x00001000. 
+      But, if the Kernel image is a "bzImage" loaded in "high" 
+      of RAM already, then it is not moved anywhere.'
+      br
+      e '9. Sets up the Interrupt Descriptor Table (IDT and 
+      a Global Descriptor Table (GDT+'
+      br
+      e '10. If a floating-point unit (FPU is present, it is now 
+      reset.'
+      br
+      e '11. The PIC (Programmable Interrupt Controller is 
+      reprogrammed at this step.'
+      br
+      e '12. The cpU is switched from "Real mode" to "Protected 
+      mode" by setting the PE bit in the cr0 status register.'
+      br
+      e '13. Jumps to the stratup_32(  assembly language function. '
+    }
+  }
+  # ====================================================================== #
+  # === Bibliotheken und Linux lib tab libraries tag
+  # ====================================================================== #
+  div('default'){
+    h2 'Bibliotheken und Linux'
+    p {
+      e 'Der Haupt Loader auf einem Linux System ist 
+      /lib/ld-linux.so.X, wobei X die VersionNummer 
+      kennzeichnet.'
+      br
+      e 'Beispiel hierzu:'
+      br
+      cmd '  ld-2.3.6.so'
+      cmd '  stat /lib/ld-2.5.so'
+      br
+      e 'Dieser Loader ist sehr wichtig - er findet nämlich alle 
+      anderen Shared Libraries.'
+      br
+      e 'Und woher weiss er, welche Verzeichnisse er durchsuchen muss?'
+      br
+      e 'Er zieht die Datei <b>/etc/ld.so.conf</b> hierfür heran.'
+    }
+    # ====================================================================== #
+    # shared libraries tag
+    # ====================================================================== #
+    p('','shared_libs') {
+      e 'Was gibts zu Shared Libraries zu sagen?','BO darkblue'
+      br
+      e '<b>Shared Libraries</b> werden von Programmen 
+      geladen, sobald sie starten. Alle Programm können 
+      die selbe shared library nutzen.'
+      e 'Shared Libraries haben bestimmte Namen: 
+      Sie starten mit <b>lib</b>, dann kommt der <b>eigentliche 
+      Name</b>, dann kommt noch <b>.so</b>, ein <b>Punkt</b>, 
+      und die <b>Versions Nummer</b>.'
+      e 'Der echte Name ist der Name des C Files, 
+      der die Bibliothek beschreibt.'
+      br
+      e 'Jede shared library hat einen besonderen Namen, den 
+      sogenannten <b>soname</b>.'
+      br
+      e 'Der soname hat das Prefix lib, den Namen der Library 
+      sowie die Endung <b>.so</b>, meist noch einen Punkt 
+      und eine Versionsnummer.'
+      br
+      e 'Die Versionsnummer wird erneuert sobald eben eine neue 
+      Version rausgebracht wird.'
+      br
+      e 'Ein genereller Vorteil der Shared Libraries ist es, 
+      das sie nicht nur weniger RAM verbrauchen, sondern auch 
+      weniger Disk Space.'
+      br
+      e 'Warum? Der Kernel muss nur eine einzige Kopie der 
+      shared Libary im Speicher halten.'
+      br
+      e 'Zudem kann man einfacher einen Fehler beheben, 
+      da man nicht viele weitere Programme kompilieren muss.'
+      br
+      e 'Es gibt aber auch einen Nachteil, es können 
+      sich Funktionen ändern. Dagegen helfen Versions Nummern - 
+      jede shared Library hat eine Version.'
+      br
+      e 'Wird nun ein Programm gegen eine shared library 
+      gelinkt, so speichert sie auch die Versions Nummer.'
+      br
+      e 'Was bedeuten nun die Nummern?'
+      br
+      e 'Die HauptNummer zeigt an, das es wohl einige grosse Änderungen 
+      gab zwischen der Vorgängerversion. Es kann also zu einigen 
+      Problemen kommen.'
+      br
+      e 'Die WenigerNummer - minor zeigt lediglich Fehlerbereinigungen an.'
+      br
+      e 'Beispiel:'
+      br    
+      cmd 'libFLAC.so ist ein Symlink auf libFLAC.so.7.0.0'
+      br
+      e 'Eine shared library wird grundsätzlich im <b>ELF binary 
+      format</b> gespeichert - Executable and Linkable Format.'
+      br
+      e 'Es gibt natürlich auch Architektur-spezifische Fakten
+      die man wissen muss. So muss man auf manchen Architekturen,
+      AMD64 als Beispiel zu nennen, shared libraries 
+      "PIC-enabled" kompilieren.'
+    }
+    # ======================================================================= #
+    # === ELF TAG
+    # ======================================================================= #
+    div('default') {
+      h2 'Das ELF binary format','','elf'
+      p('ind0px') {
+        e 'Der ELF Standard ist historisch bedingt gewachsen.'
+        br
+        e 'ELF ist besser und flexibler als a.out und COFF.'  
+      }
+    }
+  }
+  # ========================================================================= #
+  # === udp tag
+  # ========================================================================= #
+  div('default FSI pad5px','','udp') {
+    h3 'UDP','mart2px'
+    e 'Das U in UDP heisst User.'
+  }
+  # ========================================================================= #
+  # === AUTOCONF
+  # ========================================================================= #
+  div('default','autoconf') {
+    h2 'Was geschieht beim Erstellen von Autoconf input files, und wie 
+    mache ich das? Wo genau hilft mir Autoconf und wie ist sein Bezug 
+    zu Autoscan?',COMPILE_HEADER3
+    h1 sg(:red_dot,'marr0_3em')+'Autoconfigure'
+    e 'Autoscan erstellt <b>configure.scan</b>, und daraus
+    dann <b>configure.in</b>'
+    br
+    e 'Dazu checkt Autoscan Quelldateien im Verzeichnis, und sucht nach 
+    allgemein bekannten plattformspezifischen Problemen oder Regeln.'
+    br
+    e 'Wie ist nun das Verhältnis zu Autoconf?'
+    br
+    e 'Das Programm Autoconf liest eben die Datei configure.in ein, und 
+    erzeugt daraus ein Shell-Skript namens <b>configure</b>. Genau dieses 
+    Shell-Skript wird dann später vom Benutzer auf seinem Rechner aufgerufen, 
+    um das Paket für sein System zu konfigurieren. Außerdem müssen anstelle 
+    normaler Makefiles sogenannte Makefile.in geschrieben werden. Diese 
+    ähneln Makefiles, können aber in Klammeraffen eingeschlossene 
+    <b>Platzhalter</b> haben, die dann beim Aufruf von configure mit für 
+    das System passenden Werten ersetzt werden. (=Makros)'
+    br
+    e 'Typischerweise sehen die dann z.Bsp so aus:'
+    br
+    e 'hello:    hello.cc'
+    br
+    e '  @CXX@ -o hello hello.cc','marl2em'
+    br
+    l2em ANMERKUNG+'Man achte auf die @CXX@ Variable, die später 
+    ersetzt wird.'
+    br
+    s2 'Nehmen wir als konkretes Beispiel die Angabe einer header 
+    Datei '
+    e '<b>#include '+htmlentities('<fcntl.h>')+'</b>.'
+    br
+    e 'Mit dem existierenden Macro <b>AC_CHECK_HEADER</b> kann 
+    man nun autoconf überprüfen lassen, ob es besagte header 
+    Datei auch gibt. Beispiel eben: AC_CHECK_HEADER(fcntl.h)'
+    br
+    e 'Findet Autoconf diese Datei, so wird ein Präprozessorsymbol 
+    namens HAVE_FCNTL_H definiert - man sieht, alles wird hier per 
+    Konvention gross geschrieben.'
+    br
+    e 'Im Quelltext sähe dies in etwa so aus:'
+    br
+    cmd2 htmlentities('#ifdef HAVE_FCNTL_H')
+    cmd2 htmlentities('#include <fcntl.h>')
+    cmd2 htmlentities('#endif')+'  '
+    br
+    e 'Beim eigentlichen Kompilieren fügt nun autoconf dies hier dazu:'
+    br
+    e '<b>-DHAVE_FCNTL_H=1</b>, man sieht das dies absolut keine 
+    Hexerei ist. Allerdings können durch viele solcher -D Flags die 
+    maximal zulässige Anzahl an Zeichen auf der Kommandozeile schnell 
+    überschritten werden.'
+    br
+    e 'Dies kann man umgehen, indem man <b>AC_CONFIG_headER(config.h)</b> 
+    angibt. Hierdurch werden alle #defines in der Angegebene Datei 
+    config.h gespeichert.'
+    br
+    e 'Als einziges #define steht dann auf der 
+    Kommandozeile -DHAVE_CONFIG_H=1 dabei.'
+    br
+    e 'Im Quelltext sieht dies dann so aus:'
+    br
+    cmd htmlentities('#ifdef HAVE_CONFIG_H')
+    cmd htmlentities('#include <config.h>')
+    cmd htmlentities('#endif')
+    cmd htmlentities('#ifdef HAVE_FCNTL_H')
+    cmd htmlentities('#include <fcntl.h>')
+    cmd htmlentities('#endif')
+    br
+    e 'Bezüglich Macros ist noch zu sagen, das configure.in 
+    <b>AC_INIT(file)</b> zu Beginn, und <b>AC_OUTPUT(...)</b> 
+    am Ende braucht.'
+    br
+    e 'AC_OUTPUT akzeptiert auch ein Argument, wie zum Beispiel
+    bei <b>AC_OUTPUT(Makefile)</b>'
+    br
+    e '<blue>Autoconf</> nimmt <b>configure.in</b> und erstellt 
+    die Datei <b>configure</b>. 
+    Danach nimmt <b>configure</b> Makefile.in und config.h.in, 
+    und erstellt ein <b>Makefile</b> und die Datei 
+    <b>config.h</b> davon.'
+    br
+    e 'aclocal.m4 und acsite.m4 halten weitere Features bereit.
+    Autoheader kann verwendet werden um config.h.in von 
+    acconfig.h zu erstellen.'
+    br
+    e 'config.h.in wird durch den Autoheader erstellt.'
+  }
+  # ========================================================================= #
+  # GNU Configure Optionen.
+  # ========================================================================= #
+  div('default') {
+    h2 'GNU Configure optionen:'
+    br
+    e 'Achtung: Die Optionen sind nicht immer vorhanden.'
+    br
+    cmd '  --disable-werror'
+    br
+    e 'This prevents the build from stopping in the event that there 
+    are Warnungen von dem Host Compiler.'
+  }
+  # ========================================================================= #
+  # === Ccache
+  #
+  # ccache tag
+  #
+  #   rf compile ccache
+  #
+  # ========================================================================= #
+  div('default marb1em','ccache','border: 1px solid mediumpurple;') {
+    h2 'CCACHE','mart1px'
+    e 'Was ist <b>ccache</b>?'
+    br
+    e '<b>ccache</b> ist ein <b>compiler cache</b>. Er beschleunigt
+    das erneute Kompilieren indem vorhergehende Kompilationen
+    gespeichert werden.'
+    br
+    e 'Er unterstützt die Sprachen C, C++, Objective-C und 
+    Objective-C++.'
+    br
+    e 'Der Cache wird normalerweise in $HOME/.ccache gespeichert. 
+    Dies kann man jedoch über die CCACHE_DIR Environment Variable 
+    ändern. Den Cache können so auch mehrere Anwender
+    verwenden - hier muss man aber auf die Permissions des
+    Cache aufpassen (und man muss allen Anwendern vertrauen 
+    können).'
+    br
+    e 'Jeder der den Cache verwendet muss Schreibzugriff haben, 
+    also eine umask von 002.'
+    br
+    e 'Das <b>setgid bit</b> muss auch gesetzt werden damit alle
+    Unterverzeichnisse auch bei der richtigen Gruppe gesetzt sind.'
+    br
+    e 'Um die Statistiken auf den Ausgangszustand zurückzusetzen,
+    verwende:'
+    br
+    cmd '  ccache -z'
+    br
+    e 'To remove all cached files:'
+    br
+    cmd '  ccache -C'
+    br
+    e 'Run ccache together with distcc:'
+    br
+    cmd '  CCACHE_PREFIX=distcc'
+    br
+    e 'Man sollte den cache size anpassen, für beste Resultate.'
+    br
+    e 'Dies geschieht wie folgt:'
+    br
+    cmd '  ccache --max-size 32G'
+    br
+    abr 'http://ccache.samba.org/',
+         content: 'DEF',
+         css_class: 'marl2em'
+    abr 'http://ccache.samba.org/manual.html',
+         content: 'DEF',
+         css_class: 'marl2em'
+  }
+  # ========================================================================= #
+  # === CYGWIN TAG
+  # ========================================================================= #
+  div('mart1em pad1em BG_white Black','CYGWIN') {
+    e 'Was ist Cygwin?','','cygwin'
+    e 'Eine Linux-like Umgebung für Windows.',
+      'pad2px','',
+      'border-left: 2px ridge darkblue;
+       border-top:  2px ridge darkblue'
+    e 'Zum Deinstallieren nicht auf Software\Cygnus Solutions vergessen!'
+    abr :microsoft,
+        content: 'Hier mehr Information'
+  }
+  # ========================================================================= #
+  # === LD_PRELOAD tag
+  # ========================================================================= #
+  div('mart1em pad1em default',
+      'LD_PRELOAD',
+      'RANDOM_BORDER_3PX'){
+    h2 'LD_PRELOAD','ld_preload'
+    p('default','preload') {
+      e 'LD_PRELOAD zeigt zu deinen eigenen Shared Libraries.'
+      br
+      e 'Es wird der Loader angeweisen weitere Libraries in Programme zu laden.'
+      br
+      e 'zlib scheint die LD_PRELOAD library zu nutzen, und macht 
+      transparente Dekompressionen.'
+      br
+      e 'Function Interposing benutzt unter Linux die 
+      Umgebungsvariable $LD_PRELOAD.'
+      br
+      e 'SuperUser Access kann auf Linux Systemen manchmal durch 
+      eine modifizierte libc.so.5 via LD_PRELOAD erreicht werden.'
+      br
+      e 'Ein recht bekanntes Programm das die LD_PRELOAD 
+      Methode verwendet ist <b>CheckInstall</b>'
+      br
+      e 'Mittels einer LD_PRELOAD library kann man andere 
+      Commands wie dlopen() intercepten.'
+      br
+      e 'Modern day implementations of ld.so(8) examine the 
+      LD_PRELOAD environmental variable'
+      br
+      e 'Whitespace-separated list of additional shared libraries 
+      to load before all others'
+      br
+      anm 'Wenn eine Funktion sowohl in der LD_PRELOAD Bibliothek, 
+      als auch in glibc erscheint, so hat LD_PRELOAD eine höhere 
+      Präferenz. ("LD_PRELOAD wins")'
+      e 'Die ursprüngliche Funktion kann aber noch immer mittels
+      dlopen(3) bzw mit syscall(2) angesprochen werden.'
+      br
+      e 'By hijacking a function or system call, the behavior can 
+      be altered'      
+      br
+      e 'Hier ein Beispiel wie man sie setzt:'
+      br
+      cmd '  export LD_PRELOAD="/usr/X11R6/lib/libX11.so.6:/usr/X11R6/lib/libXt.so.6"'
+      br
+      e 'Zum Anzeigen der LD_PRELOAD Variable:'
+      br
+      cmd '  echo $LD_PRELOAD'
+    }
+    div {
+      h2 dot(108)+'Anhang zu LD_PRELOAD'
+      br
+      e htmlentities('include <stdio.h>;')
+      e htmlentities('include <dlfcn.h>;')
+      pre '
+    int main()
+    {
+      void* handle;
+      printf("calling close...\n");
+      close  12345 
+      printf("close called.\n");
+      printf("calling dlopen...\n");
+      handle = dlopen( "somefile", 0 );
+      printf("dlopen called.\n");
+      return 0;
+    }'
+    h2 dot(108,'marr8px')+'LD_PRELOAD Library','marb1em'
+    e htmlentities('include <stdio.h>;')
+    e htmlentities('include <dlfcn.h>;')
+    cmd '#if defined(RTLD_NEXT)'
+    cmd '#define REAL_LIBC RTLD_NEXT'
+    cmd '#else'
+    br
+    pre '
+   #define REAL_LIBC ((void *) -1L)
+   #endif
+  
+    void* dlopen(const char *file, int mode)
+    {
+      static void* (*o_dlopen) ( const char *file, int mode )=0;
+      printf( "dlopen was called\n" 
+      o_dlopen = (void*(*)(const char *file, int mode)) dlsym(REAL_LIBC,
+    "dlopen"
+      return (*o_dlopen)( file, mode 
+    }
+  
+    int close  int fd )
+    {
+      static int (*o_close) ( int fd )=0;
+      printf( "close was called\n" 
+      o_close = (int(*)( int fd )) dlsym(REAL_LIBC, "close"
+      return (*o_close)( fd 
+    }'
+      e 'Kompilieren des obigen Beispieles sollte so gehen:'
+      br
+      cmd 'gcc -Wall -fPIC -shared -o preload.so preload.c -ldl'
+      br
+      e 'Was man hier wissen muss ist, das ld die Definitionen 
+      genau in der Reihe prozessiert, wie sie auch in der 
+      command line übergeben wurden.'
+    }
+    e 'Interessante Links zu LD_PRELOAD'
+    p {
+      abr_self 'http://michael.toren.net/slides/lkm-alternatives/TABLE_OF_CONTENTS.html'
+    }
+  }
+  # ========================================================================= #
+  # Was bedeuten die Variablen?
+  # ========================================================================= #
+  h3 'Hier die Erklärung der Variablen und Compiler Flags',COMPILE_HEADER3,
+     'cflags'
+  table2 'BO','','CFLAGS',
+    'CC','Zu verwendender C-Compiler',
+    'CXX','Zu verwendender C++-Compiler',
+    'CFLAGS','Debug- und Optimierungsoptionen für den C-Compiler.
+    Mittels --cflags erhält man Info wo die include
+    Dateien sind, zb <i>gtk-config --cflags </i><br/>
+    CFLAGS sind C compiler flags, die zum Optimieren von Code
+    verwendet werden - Bekanntes Beispiel für nicht besonders aggressive 
+    Optimisierung: <br/>
+    export CFLAGS="-O2 -march=i686"<br/>
+    Die -0 Settings sind folgende<br/>
+    <b class="red">-O3</b> Höchstes Level. Maschinen spezifischer Code
+    wird generiert. Auto-magically adds the -finline-functions 
+    and -frename-registers flags. Nachteil ist aber das 
+    die Programme etwas grösser werden, und damit 
+    länger beim Laden brauchen.<br/>
+    <b class="red">-02</b>   Most Makefiles have this set up as Default, performs 
+    all supported optimizations that do not involve a space-speed
+    tradeoff. Adds the -fforce-mem flag auto-magically. <br/>
+    <b class="red">-01</b>   Minimal optimizations are performed. Default for the 
+    compiler, if nothing is given.<br/>
+    <b class="red">-00</b>   Do no optimize at all. <br/>
+    <b class="red">-0s</b>   Same as -O2 but does additional optimizations for size. ',
+    'cpPFLAGS','Include-Verzeichnisse und andere verschiedene C-Compileroptionen. ',
+    'CXXFLAGS','Debug- und Optimierungsoptionen für den C++-Compiler',
+    'DEFS','<b>-D</b> Optionen für den C-Compiler (zB -DLINUX ',
+    'LDFLAGS','Optionen für den Linker (zB -s für automatisches Stripping
+    e.g. -L<lib dir> if you have libraries in a
+    nonstandard directory <lib dir>, LDFLAGS=-L/System/Links/Libraries',
+    'LIBS','-l und -L Optionen für den Linker, wobei man 
+    den genauen Pfad für -L auch angeben kann zb 
+    via <b>-L/pfad/zu/lib</b>.
+    --libs returniert einen abr string, beispiel
+    <b>gtk-config --libs</b> '  
+  # ========================================================================= #
+  # Hier die configure und compiler flags, zb
+  # --with-gxx-include-dir=/usr/include/c++/3.3
+  # ========================================================================= #
+  div 'default'
+  h2 'Compiler und Configure Flags Explained'
+  h3 'Was ist --with-gxx-include-dir=/usr/include/c++/3.3?',COMPILE_HEADER3
+  h3 'Was ist -fomit-frame-pointer?',COMPILE_HEADER3
+  compile_header4 'Dieses flag - auch als "magic flag" bekannt - verbessert die 
+  execution time, während die Binärgrösse etwas grösser wird. Auf x86 
+  führt dieses CFLAG dazu, das <b>debugging</b> nit mehr funzt. 
+  Daher sollte man es nicht aktivieren, wenn man etwas 
+  debuggen möchte. Der Compiler verwendet einen Register 
+  (Frame Pointer, um "stack trace debugging" zu ermöglichen. 
+  Wird dieser Frame Pointer nun omitted (weggelassen,
+  dann wird der Register geleert - das führt dazu 
+  das Programme schneller rennen, da sie nicht so oft 
+  zum RAM zugreifen müssen. Einziger potentieller Nachteil 
+  ist eben das man den Debuggung output verliert.'
+  h3 'Was bedeutet -mcpu=pentium3?',COMPILE_HEADER3
+  compile_header4 'Dieses flag optimiert den Code für Pentium3,
+  jedoch läuft der code auch auf i386 Architekturen. 
+  Nutzt man hingegen -march=pentium3 so läuft der Code nur auf 
+  Pentium3 (siehe auch unten)'
+  h3 'Was bedeutet -march=pentium3?',COMPILE_HEADER3
+  compile_header4 'Der code läuft nur auf Pentium3.
+  386 Architekturen. Übrigens: Setzt man -march=arch so ist auch -mcpu=arch
+  genutzt. (<i>"honored"</i>'
+  h3 'Was bedeutet -funrollloop?',COMPILE_HEADER3
+  compile_header4 'Binaries sind grösser aber eventuell auch schneller.'
+  h3 'Wie schalte ich bestimmte Funktionen eines 
+  Paket ein oder aus?',COMPILE_HEADER3
+  compile_header4 'mit --enable und --disable'
+  h3 'Was gibts zu GNU make zu sagen?',COMPILE_HEADER3
+  compile_header4 'Makefile.am<br/>
+  Kompiliert man ein .c File mit gcc ohne die Option -o (für 
+  output zu nuzen, so heisst die enstehende Datei 
+  <b>a.out</b>. a.out ist somit die Default 
+  Datei'
+  h3 'Wie erreiche ich es, das das configure script weniger 
+  output generiert?',COMPILE_HEADER3
+  compile_header4 'mit der Option <b>-q</b>'
+  h3 'Was ist mit der Fehlermeldung error while loading shared 
+  libraries: libstdc++.so.5?',COMPILE_HEADER3
+  compile_header4 'compat-libstdc++-33'
+  div { 
+    h3 'Was ist mit der Fehlermeldung /lib/cpp fails 
+    sanity check?',COMPILE_HEADER3
+    compile_header4 'Da ist ein Fehler beim C++ Compiler. 
+    Wahrscheinlich weil ein C++ Compiler nicht installiert 
+    wurde. Oder es handelt sich um fehlende 
+    linux-libc-headers. Und wenn der C++ Compiler wirklich 
+    irgendwo installiert ist, dann hilft ein Symlink. 
+    ZB wenn cc1plus nicht gefunden wurde. Zb '
+    p {
+      e 'ln -s /usr/lib/gcc/i486-linux-gnu/4.0.3/cc1 cc1plus'
+      e 'Hmm, ob cc1plus nur ein symlink zu cc1 ist?'
+      br
+      e 'Das ist dann ein Symlink zum Beispiel so:'
+      br
+      cmd '  /lib/cpp . /usr/bin/cpp'
+    }
+  }
+  div('default') {
+    e '-fPIC tells to this gcc that it should generate PIC 
+    output, which saves a register for the location 
+    of the location of the library'
+  }
+  # ========================================================================= #
+  # uclibc TAG ucl tag.
+  #   rf comp uclibc
+  # ========================================================================= #
+  div {
+    h2 dot(102)+'Uclibc','','uclibc'
+    p { e 'UClibc ist eine kleine Libc Variante.' }
+    abr 'http://www.uclibc.org/',
+        content: 'UClibc Homepage'
+  }
+  # ========================================================================= #
+  # DIETLIBC TAG
+  #   rf comp dietlibc
+  # ========================================================================= #
+  div('default'){
+    h2 dot(102)+'Dietlibc','','dietlibc'
+    p_default {
+      e 'Viele Distributionen setzen in ihren Initial-RAM-Disks 
+      (Initrd und Installationsumgebungen schon länger auf 
+      Dietlibc, weil damit kompilierte Programme auch schneller 
+      starten als Programme mittels Glibc.'
+      abr 'http://www.fefe.de/dietlibc/',
+          content: 'Offizielle Homepage von dietlibc',
+          css_class: 'marl2em slateblue'
+    }
+    p_default {
+      e 'Wie kompiliere ich ein Autoconf Programm mit diet libc?'
+      e 'Setze CC wie zb so:'
+      br
+      cmd '  CC="diet gcc -nostdinc" ./configure --disable-nls'
+      br
+      e 'Wie kompiliere ich "normal"?'
+      br
+      cmd '  CC="diet gcc -nostdinc" ./configure --disable-nls 
+      --disable-shared --enable-static --host=i686'
+      br
+      e 'Eventuell muss man noch --disable-shared und 
+      --enable-static hinzufügen, für Programme die 
+      Libtool verwenden.'
+    }
+  }
+  div('default') {
+    h4 'Wie finde ich heraus, welche glibc Version ich habe?'
+    h5 '  ldd --version',GLIBC_REPLY
+    h4 'Wie finde ich heraus, welche Verzeichnisse glibc durchsucht?'
+    h5 '  glib-config --cflags',GLIBC_REPLY
+    h5 'Dies mag manchmal Probleme bereiten, vor allem bei 
+    Gobolinux ähnlichen Verzeichnisstrukturen. Man sollte auf 
+    alle Fälle ldconfig nach der Installation durchführen,
+    und die Verzeichnisse in /etc/ld.so.conf eintragen.
+    Man kann übrigens auch pkg-config
+    benutzen, zum command siehe den Eintrag zu 
+    pkg-config.',GLIBC_REPLY
+    h4 'Wie finde ich heraus, welche Library-Verzeichnisse 
+    von glib durchsucht werden?'
+    h5 '  glib-config --libs',GLIBC_REPLY
+  }
+  # ========================================================================= #
+  # === M4 TAG. rf compile m4
+  # ========================================================================= #
+  div('default','m4'){
+    h2 dot(102)+'M4','marb1em'
+    e 'Der Standard-Ort unter Linux, unter dem M4 Daten speichert, 
+    ist <b>/usr/share/aclocal</b>.'
+    p {
+      e 'm4_pattern_allow'
+      br
+      cmd '  m4_pattern_allow(AM_CONFIG_headERS'
+      br
+      e '(Das findet man dann zb in configure.ac)'
+      br
+      e 'Eine Variable kann man so deklarieren:'
+      br
+      cmd '  m4_define([crow_dep_dbus_glib], [0.70])'
+    }
+  }
+  # ========================================================================= #
+  # === KOBJECT TAG
+  # ========================================================================= #
+  div('default','kobject') {
+    h2 'Kobject'
+    e 'A kobject is an object of <b>type struct kobject</b>. Kobjects
+    have a name and a reference count.'
+    br
+    e 'A kobject also has a parent pointer (allowing kobjects to be 
+    arranged into hierarchies, a specific type, and, perhaps, a 
+    representation in the sysfs virtual filesystem.'
+    br
+    e 'Kobjects are generally not interesting on their own instead, 
+    they are usually embedded within some other structure which 
+    contains the stuff the code is really interested in.'
+  }
+  # ========================================================================= #
+  # CHROOT TAG
+  #   rf compile chroot
+  # ========================================================================= #
+  div('default') {
+    h2 'Chroot','','chroot'
+    p {
+      e 'Das Verwenden von Chroot mag beim Kompilieren manchmal 
+      Vorteile bringen, denn ...'
+      br
+      e sg(:pfeil5)+'Chroot erstellt eine <b>abgekapselte 
+      Umgebung</b>.'
+      br
+      e 'Eine Chroot Umgebung mag einem auch helfen,
+      "host errors" zu umgehen - zb wenn eine header Datei genutzt 
+      wird, die auf einem anderen Computer nicht existiert.'
+    }
+    p { 
+      e 'Für mehr Info über Chroot siehe bitte folgenden Abschnitt:'
+      br
+      abr 'cmd#chroot',
+          content: 'Chroot',
+          css_class: 'BO slateblue marl2em'
+    }
+  }
+  # ========================================================================= #
+  # === cmake tag
+  # ========================================================================= #
+  div('default') {
+    abr :local_cmake, content: 'cmake'
+  }
+  # ========================================================================= #
+  # Compile options zu GCC erklärt. 
+  # rf compile compile_options
+  # ========================================================================= #
+  div {
+    h1 'Compile Options zu GCC:','','compile_options'
+    table2 'marl1em','','',
+      '-fomit-fame-pointer','Diese Option macht Programme 
+      schneller während der Lafuzeit. Potentieller Nachteil ist das
+      das Debugging nicht mehr möglich ist.
+      (-O schaltet -fomit-frame-pointer recht oft automatisch ein.)',
+      '-funrollloop','will give you a bigger executable that may be 
+      a tad faster'
+    # ======================================================================= #
+    # Besondere options zu GCC 
+    # rf compile gcc_options
+    # ======================================================================= #
+    div {
+      h1 'Besondere Anweisungen und Optionen zu GCC:','','gcc_options'
+      table2 'marl1em','','',
+        '-D','Die -D Option teilt GCC mit, das er weitere #defines 
+         während der Compile Time verwenden sollte. Zum Beispiel ist 
+        -DSRC_DIR=\"/usr/local/src\" das selbe wie in der Datei
+         #define SRC_DIR \"/usr/local/src\" 
+         Haupteinsatzzweck dieser Option ist das Hard-coding von 
+         Configuration Data wie File Paths etc...'
+    }
+    div {
+      h2 'GCC spezifische Macros:'
+      table2 'mars1em','','',
+             'GLIBCXX','War früher GLIBCPP'
+    }
+  }
+  # ========================================================================= #
+  # === Header Files #header
+  # ========================================================================= #
+  div('','header') {
+    h2 'Anhang C (Header Files)'
+    h3 'Header Files eines Linux Systems'
+    cmd '  /usr/include/stdio.h'
+    cmd '  /usr/include/sys/types.h'
+    cmd '  /usr/include/sys/stat.h'
+    cmd '  /usr/include/sys/signal.h'
+    cmd '  /usr/include/sys/ctype.h'
+    br
+    e 'Mein Script rminimal_environment.rb kopiert die relevanten Dateien.'  
+  }
+  # ========================================================================= #
+  # Besondere Variablen
+  # ========================================================================= #
+  div('mart2em'){
+    h1 'Besondere Variablen zu GCC:'
+    p {
+      e 'CHOST','BO'
+      br
+      marl1em 'zb CHOST="i686-pc-linux-gnu"'
+      br
+      e 'CFLAGS','BO'
+      br
+      marl1em 'zb CFLAGS="-O2 -march=k6 -mcpu=k6"'
+      marl1em '  CFLAGS="-pipe"'
+      br
+      e 'The CFLAG -pipe will cause the compiler to pipe the data 
+      into the next function as opposed to storing temporary files 
+      to the Hard Drive and accessing it from there. This will help 
+      speed up compile times, especially with larger programs, 
+      however causes more RAM to be used during compilation.'
+      br
+      lem 'zb CFLAGS="-march=athlon-xp -O3 -pipe -fomit-frame-pointer"'
+      br
+      boldbr 'CXXFLAGS'
+      e 'zb CXXFLAGS="---CFLAGSend"','marl1em'
+    }
+  }
+  # ========================================================================= #
+  # === Libtool
+  #
+  # WAS MACHT LIBTOOL? Libtool tag. lib tag. #libtool
+  #
+  # libtool tag
+  #   rf compiling libtool
+  # ========================================================================= #
+  div('default','Libtool') {
+    h2 sg(:package)+' Was macht libtool?',COMPILE_HEADER3,'libtool'
+    e 'Libtool ist ein 7584 Zeilen langes Shell-Script, das eine 
+    allgemeine Schnittstelle für <b>shared Libraries</b> (Bibliotheken, 
+    also <b>.so Objekte</b>) bereit stellt.'
+    br
+    cmd '  cat /usr/bin/libtool'
+    br
+    e 'Libtool nimmt Informationen etwas ungewöhnlich auf:'
+    br
+    e sg(:pfeil10)+'Der Compiler darf <b>nicht</b> bestimmen, welche 
+    System Bibliotheken genutzt werden sollen.','marl2em'
+    br
+    e 'Wie löst Libtool dies dann auf?'
+    br
+    e 'Es parsed den Output von:'
+    br
+    cmd '  gcc ARGS -v'
+    br
+    e 'sowie von:'
+    br
+    cmd '  gcc -nostdlibs ARGS -v'
+    br
+    e 'Danach, wenn es Zeit wird eine Bibliothek zu 
+    verknüpfen, verwendet <b>libtool direkt ld</b>.'
+    br
+    e 'Es fügt selbständig <b>crt.0</b> hinzu.'
+    br
+    e 'Der Gedanke dahinter ist, das Libtool <b>selbständig</b> 
+    alle Information erhalten kann - nichts soll vor 
+    Libtool versteckt sein.'
+    br
+    e 'Auch die Spec Datei von GCC soll sich Libtool nicht 
+    entziehen. Ziemlich radikal und schlau oder?'
+    br
+    e 'Die Idee hinter Libtool war auch genial:'
+    br
+    e 'Es sollte nur ein Script geben, mit dem man C Dateien 
+    kompilieren und (miteinander) verknüpfen kann, und somit 
+    Executables, static libraries und dynamic libraries erstellen kann. 
+    Daher auch der Name LIB-Tool, kurz für Library Tool.','marl2em'
+    br
+    e 'Libtool kommt auch mit libltdl, eine Bibliothek die verwendet 
+    wird um während der Laufzeit Extensions zu laden.'
+    br
+    e 'Wichtige Informationen bezieht Libtool aus den <b>.la</b> 
+    Dateien - diese sind normalerweise nicht einfach verschiebbar.'
+    br
+    e 'Linktool arbeitet in <b>6 verschiedenen Modes:</b> 
+    ( Compile, Link, Execute, Install, Finish, Uninstall )'
+    br
+    e dot(102)+'Compile Mode','marl3em'
+    e dot(102)+'Link Mode','marl3em'
+    e dot(102)+'Execute Mode','marl3em'
+    e dot(102)+'Install Mode','marl3em'
+    e dot(102)+'Finish Mode','marl3em'
+    e dot(102)+'Uninstall Mode','marl3em'
+    br
+    e 'Der abr Mode ist hierbei sehr wichtig, denn gerade bei ihm 
+    kommt es des öfteren zu einem Fehler.'
+    br
+    e 'Soweit so gut...'
+    br
+    e 'Das Problem mit Libtool ist aber, das es 232KB gross ist.'
+    br
+    e 'Jedes mal wenn man etwas mit Autotooled Projekten erstellt, 
+    für JEDE C Datei in diesem Projekt, wird libtool aufgerufen.'
+    br
+    e 'Das führt nun dazu, das in manchen Situationen 
+    das Aufrufen und Verwenden von Libtool länger dauert 
+    als das eigentliche Kompilieren der C Dateien im Projekt.'
+    br
+    e 'Um LibTool kennenzulernen sollte man sich nun 
+    zuerst einmal in diesem Verzeichnis umsehen:'
+    br
+    cmd '  cd /usr/share/libtool'
+    br
+    e 'Will man ein reloadable Object erstellen, geht dies so:'
+    br
+    cmd '  ld -r -o output.o foobar.o'
+    br
+    e 'Hier ein Beispiel wie man relinked:'
+    br
+    cmd '  libtool --mode=link gcc -g -O -o libhello.la foo.o hello.o'
+    br
+    e 'Es kann aber auch mit Libtool zu Fehlermeldungen kommen wie zb:'
+    br
+    cmd 'libtool: relink: warning: 
+    `/usr/lib/gcc/i386-redhat-linux/3.4.6/../../..//libjpeg.la\'
+    seems to be moved'
+    br
+    e 'Hier werden die Informationen der .la Dateien genutzt.'
+    br
+    e '<b>Fehlermeldungen</b> werden in <b>ltdl.h</b> über LT_ERROR 
+    behandelt, leider gibt es zum Teil dämliche Fehlermeldung wie 
+    "can not install directory" nur aufgrund eines
+    nicht "konformen" Verzeichnispfad ...'
+    br
+    e 'Sehr wichtig ist die Variable 
+    <b>sys_lib_search_path_spec</b> im Libtool script, 
+    ich füge da gerne /System/Links/Libraries hinzu.'
+    br
+    e 'When you compile a program like The Gimp, it will probably abr 
+    with many libraries, some of which were linked against pango when 
+    it was still installed under /usr.'
+    br
+    pre '  
+    In this case, these libraries will have dead references in their 
+    own .la files.  Libtool has this very nifty feature that it will
+    automagically abr against dependent libraries of the libraries you
+    use (which is normally automatically done by modern linkers on modern
+    OSes, but since its not portable, we cant rely on this, and Libtool
+    does it for you).
+    So basically, when you abr against libfoo and there is a libfoo.la, 
+    libtool will read it to find out what are the dependencies of libfoo 
+    and add them recursively to the linking command.  In your case, you are 
+    probably using libraries whose .la files are still referencing pango 
+    from under /usr/lib, hence the problem (that just an educated guess, 
+   there can be other reasons, of course).
+   # grep -l pango /usr/lib{,64}/*.la
+   You will see that many of them have the location of pangos la file
+   stored in them.
+   For example:
+   # grep pango /usr/lib/libavahi-ui.la
+   dependency_libs= /usr/lib/libavahi-client.la /usr/lib/libdbus-1.la
+     /usr/lib/libavahi-glib.la /usr/lib/libavahi-common.la
+     /usr/lib/libgtk-x11-2.0.la /usr/lib/libgdk-x11-2.0.la
+     /usr/lib/libatk-1.0.la /usr/lib/libgdk_pixbuf-2.0.la
+     /usr/lib/libpangocairo-1.0.la /usr/lib/libcairo.la
+     /usr/lib/libpangoft2-1.0.la /usr/lib/libpango-1.0.la
+     /usr/lib/libpango-1.0.la /usr/lib/libgobject-2.0.la
+     /usr/lib/libgmodule-2.0.la /usr/lib/libcairo.la
+     /usr/lib/libfontconfig.la /usr/lib/libfreetype.la /usr/lib/libexpat.la
+     /usr/lib/libpng12.la -lz /usr/lib/libXrender.la /usr/lib/libX11.la
+     /usr/lib/libxcb-xlib.la /usr/lib/libxcb.la /usr/lib/libXau.la
+     /usr/lib/libXdmcp.la -lm /usr/lib/libgobject-2.0.la
+     /usr/lib/libgmodule-2.0.la /usr/lib/libglib-2.0.la -ldl
+     /usr/lib/libglib-2.0.la /usr/lib/libgdbm.la
+     /opt/gcc/current/lib/libssp.la
+   It saved all that from the last time that pango was installed
+   and that software which requires pango libraries was compiled and installed.
+   Now you have an understanding of what needs to be modified, right?
+   All those .la files that have references to pango libraries need to 
+   be modified.
+   The la files installed by pango are probably something like:
+     /usr/lib/libpango-1.0.la
+     /usr/lib/libpangocairo-1.0.la
+     /usr/lib/libpangoft2-1.0.la
+     /usr/lib/libpangox-1.0.la
+     /usr/lib/libpangoxft-1.0.la
+   Using sed -i you can edit all those files and replace
+   the old locations for where the libpango libtool archive files were stored
+   with the new location.
+   After that you should also check for an .la file that has in it a
+   direct reference
+   to a pango library file and not just a .la file.
+   And edit those also to reflect the new path to where pango is installed.
+     Yes, it is not so easy...
+     But in order to adjust the first one I might type something like
+     what I have below for merely the ia32 architecture and assuming
+     that /usr/lib64 is not used.
+     # grep -l "/usr/lib/libpango-1.0.la"  /usr/lib/*.la  |
+     xargs  -rL64  sed  -i
+     "s:/usr/lib/libpango-1.0.la:/opt/pango/lib/libpango-1.0.la:g"
+     Now it will assume pango is installed in /opt/pango
+     However, the same must be done for:
+     /usr/lib/libpangocairo-1.0.la
+     /usr/lib/libpangoft2-1.0.la
+     /usr/lib/libpangox-1.0.la
+     /usr/lib/libpangoxft-1.0.la
+     Yes editing .la files is a bit of a pain.
+     Basically that is how it works.'
+     br
+     e 'Using grep, xargs, sed you can fix all the .la files
+     with references to the old installed locations of pango.
+     Or you could edit them by hand if you have a couple 
+     free hours.'
+     br
+     e 'Die aktuelle Version von libtool findet man auf'
+     br
+     abr 'http://www.gnu.org/software/libtool/libtool.html',
+          content: 'http://www.gnu.org/software/libtool/libtool.html',
+          css_class: 'BO marl2em'
+  }
+    # ========================================================================= #
+  # === pkg-config tag, pkg tag
+  # ========================================================================= #
+  div('default FW4','pkg_config','') {
+    h2 dot(104)+'About PKG - Config','FI','',
+       'border-top:3px solid slateblue;
+        border-bottom:3px solid slateblue'
+    h3 'pkg-config is a helper tool for managing library compile/link 
+    flags that work with automake and autoconf. It helps to compile 
+    software. It also replaces the ubiquitous *-config scripts you 
+    may have seen with a single tool. /
+    Mit anderen Worten, mit Hilfe von pkg-config kann man Library
+    flags in Verbindung mit automake und autoconf managen. Es nutzt 
+    zudem die Environment Variable <br>
+    <b class="s2em">
+    echo PKG_CONFIG_PATH
+    </b><br>
+    Default Location wo die pc Dateien normalerweise sind ist 
+    <b>/usr/lib/pkgconfig</b><br>
+    Um weitere Dateien hinzuzufügen kann man die Pfade zu 
+    PKG_CONFIG_PATH angeben.','ind1em FW4'
+    h2 dot(102)+'pkg-config spezifische FAQ','FI darkblue s1em','pkg'
+    h4 'Herausfinden der include directories, wo der compiler nachschaut?'
+    h5 'pkg-config --cflags PROGRAMM',PKG_CSS_ANSWER_CLASS
+    h5 'pkg-config --cflags gtk+-2.0',PKG_CSS_ANSWER_CLASS
+    h5 'pkg-config --cflags xrender',PKG_CSS_ANSWER_CLASS
+    h5 'pkg-config --cflags pango',PKG_CSS_ANSWER_CLASS
+    h5 'pkg-config --cflags atk',PKG_CSS_ANSWER_CLASS
+    h5 'pkg-config --cflags glib-2.0',PKG_CSS_ANSWER_CLASS
+    h5 'pkg-config --libs --cflags glib-2.0',PKG_CSS_ANSWER_CLASS
+    br
+    e 'Alle Pakete kann man so angezeigt bekommen:'
+    br
+    e 'pkg-config --list-all', PKG_CSS_ANSWER_CLASS
+    h5 '(Beispiel Ergebnisse:
+    -DXTHREADS -D_REENTRANT -DXUSE_MTSAFE_API -I/usr/include/gtk-2.0 -I/usr/lib/gtk-2.0/include 
+    -I/usr/X11R6/include -I/usr/include/atk-1.0 -I/usr/include/pango-1.0 -I/usr/include/freetype2 
+    -I/usr/include/freetype2/config -I/usr/include/glib-2.0 -I/usr/lib/glib-2.0/include    
+    ','FI martb1px'
+    h5 'pkg-config glib --cflags','BOLD '+PKG_CSS_ANSWER_CLASS
+    h4 'Wie finde ich via pkg-config heraus, welche Version von libpng 
+    installiert ist? Oder von Wand oder von Vorbis?'
+    p('PKG_CSS_ANSWER_CLASS') {
+      e 'pkg-config --modversion gtksourceview-1.0'
+      e 'pkg-config --modversion libpng'
+      e 'pkg-config --modversion Wand'
+      e 'pkg-config --modversion vorbis'
+      e 'pkg-config --modversion pango'
+      e 'pkg-config --modversion atk'
+      e 'pkg-config --modversion glib-2.0'
+      e 'pkg-config --modversion glib'
+      e 'pkg-config --modversion gtk+-2.0'
+      e 'pkg-config --modversion cairo'
+      e 'pkg-config --modversion qt-mt'
+      e 'pkg-config --modversion sdl'
+      e 'pkg-config --modversion libglade'
+      e 'pkg-config --modversion gstreamer-0.10'
+    }
+    h4 'Wie kombiniere ich das ganze?'
+    h5 'pkg-config --libs --cflags glib-2.0',PKG_CSS_ANSWER_CLASS
+    h4 'Wie sieht ein typisches .pc File aus?'
+    pre '  <b>prefix</b>=/usr
+  <b>exec_prefix</b>=/usr
+  <b>libdir</b>=/usr/lib
+  <b>includedir</b>=/usr/include
+  <b>target</b>=x11
+  <b>gtk_binary_version</b>=2.4.0
+  gtk_host=i386-unknown-linux-gnu
+  <b>Name</b>: GTK+
+  <b>Description</b>: GIMP Tool Kit (targetend target
+  <b>Version</b>: 2.8.6
+  <b>Requires</b>: gdk-targetend-2.0 atk cairo
+  <b>Libs</b>: -Llibdirend -lgtk-targetend-2.0
+  <b>Cflags</b>: -Iincludedirend/gtk-2.0','FS1_5em'
+    br
+    e 'Man kann auch Compile Flags angeben, zum Beispiel:'
+    br
+    cmd 'Libs.private: -lpthread'
+    br
+    div { 
+      h3 'Links bezüglich pkg','marb8px'
+      p('marl1em mart1px ind0') {
+        abr 'http://pkgconfig.freedesktop.org/wiki/',
+             content: 'pkgconfig Wiki',
+             css_class: 'slateblue'
+        abr 'http://pmk.sourceforge.net/pkgconfig.php',
+             content: 'PreMakeKit - Alternative zu pkgconfig',
+             css_class: 'slateblue'
+      }
+    }
+  }
+  # =========================================================================== #
+  # === Appendix zu Compiling
+  # =========================================================================== #
+  div('default') {
+    h1 'Appendix zu Compiling','appendix_compiling'
+    table2 's1em','','',
+     '<b>Macro Prototype</b>','<b>Comments</b>',
+     'AC_INIT(sourcefile',
+     'Initializes autoconf, should be the <b>first macro</b> called 
+      in <b>configure.in</b>. sourcefile is the name (relative to 
+      current directory of a source file from your code.',
+     'AC_PROG_CC   ','Determines a C compiler to use, sets the CC 
+      variable. If this is GCC, set the GCC variable to yes, otherwise 
+      no. Initializes the CFLAGS variable if it has not been set 
+      already (to override CFLAGS, do it in configure.in 
+      BEFORE calling this macro',
+     'AC_PROG_CXX','Determines a C++ compiler to use, sets 
+      the CXX variable. If this is the GNU C++ compiler, set GXX 
+      to yes, otherwise no. Initializes the CXXFLAGS variable if 
+      it has not been set already (to override CXXFLAGS, do it 
+      in configure.in BEFORE calling this macro. Ist also auch 
+      recht wichtig, und prüft ob man einen C++ Compiler hat.',
+     'AC_LANG_C','Tests the C compiler',
+     'AC_LANG_cpLUSPLUS','Tests the C++ compiler',
+     'AC_PROG_INSTALL   ','Set variable INSTALL to the path of 
+      a BSD-compatible install program (see install (1. If not 
+      found, set it to dir/install-sh -c , looking in the 
+      directories specified to AC_CONFIG_AUX_DIR. Also sets 
+      INSTALL_SCRIPT and INSTALL_PROGRAM to (INSTALL, and 
+      INSTALL_DATA to (INSTALL -m 644. You must provide a 
+      install-sh file in the current directory (unless you use 
+      AC_CONFIG_AUX_DIR -- the common practice is to provide a 
+      install-sh file else autoconf will refuse to run.',
+     'AC_PATH_X',"ry to locate the X window system's includes 
+      and libraries, and sets the variables x_includes and 
+      x_libraries to their locations.",
+     'AC_PATH_XTRA','Like the previous, but adds the required 
+      include flags to X_CFLAGS and required linking flags 
+      to X_LIBS.',
+     '<b>AC_PATH_PROG</b>(a,b[,c[,d]],a=variable-name,
+      b=prog-to-check,c=value-if-not-found, d=path',
+      'Looks for prog-to-check in PATH, and sets variable-name to 
+      the full path if found, or to value-if-not-found if not.',
+     'AC_PROG_MAKE_SET ','If make predefines the variable MAKE, 
+      define output variable SET_MAKE to be empty. Otherwise, 
+      define SET_MAKE to contain MAKE=make',
+     'AC_OUTPUT(files [,a[,b]] ','Create output files. 
+      Perform substitutions on files, which contains a list of 
+      files separated by spaces. (is writes, say, Makefile, 
+      from a Makefile.in file, spec from spec.in, and so on. 
+      The name given here is without the .in suffix. The other 
+      2 parameters are seldom used, consult the autoconf docs 
+      if needed. If AC_CONFIG_headER, AC_LINK_FILES or 
+      AC_CONFIG_SUBDIRS were called, the files named as their 
+      arguments are created too.',
+     'AC_CONFIG_headER(files','Make AC_OUTPUT create the 
+      headers listed in the files list (space-separated. 
+      Replaces DEFS in generated files with -DHAVE_CONFIG_H. 
+      The usual name for the header is config.h (created from 
+      config.h.in. The autoheader generates config.h.in files 
+      automatically for you (it is documented in the next sections+',
+     'AC_CONFIG_SUBDIRs(dirs','run configure scripts in the 
+      subdirectories listed in dirs (space-separated. This is 
+      meant for when you nest child packages to your program 
+      (like including libraries as subdirs+',
+     'AC_CHECK_FUNC(a[,b[,c]] a=function, b=action if found, 
+      c=action if not found','   checks if the given C def 
+      is available in the standard library (i.e., the libraries 
+      that are linked by default to any C program+',
+     'AC_CHECK_FUNCs(a[,b[,c]] a=list of functions 
+      (space-separated b=action if found c=action if not found',
+     'similar to AC_CHECK_FUNC, but looks for many functions at
+      once, setting HAVE_def for each def found 
+      (in the given set+',
+     'AC_CHECK_LIB(a,b[,c[,d[,e]]] a=library name b=def name 
+      c=action if found d=action if not found e=see autoconf docs ','
+      Checks whether a def exists in the given library (library 
+      names without the leading lib, e.g., for libxml, use just 
+      xml here',
+     'AC_headER_STDC','Checks for stdlib.h, stdarg.h, string.h 
+      and float.h, defines STDC_headERS on success.',
+     'AC_CHECK_headER(header[,a[,b]] a=action if found b=action if
+      not found ','Checks whether a given header file exists.',
+     'AC_MSG_ERROR(message','Notifies the user an error has 
+      occurred and exits configure with a non-zero status. This is 
+      what you should do when a required library or header is 
+      missing. Example Code is followed in the section after this 
+      table.',
+     'AC_MSG_WARNING(message','Notifies the user with the given
+      message. This is what you should do when an optional library 
+      is missing (thus the final result will be not as good as 
+      it could',
+     'AC_ARG_ENABLe feature,help[,a[,b]] a=action if given b=action 
+      if not given ','  Checks whether the user gave --enable-feature 
+      in the configure command-line. The help string is shown 
+      in configure --help'
+    div {
+      h2 'Example Code for AC_*'
+      cmd 'AC_CHECK_FUNC(XextFindDisplay, :,'
+      cmd2 ' AC_MSG_ERROR([*** libXext not found. 
+      Check config.log for more details.]'
+    }
+  }
+  # ========================================================================= #
+  # Makefile Options explained.
+  # ========================================================================= #
+  div {
+    boldbr 'MakeFile Options Explained:'
+    table2 'marl2em BO','','',
+        'Variable','Description',
+      '$@','This will always expand to the current target.',
+      '$<','Name der ersten Prerequisite. This is the 
+            first item listed after the colon. (binarytree.o 
+            in the first rule above)',
+      '$?','The names of all the prerequisites that are newer than 
+            the target. In the above example this will evaluate to 
+            binarytree.o for the first rule.',
+      '$^','The names of all the prerequisites, with spaces 
+            between them. No duplicates',
+      '$+','Like $^, but with duplicates. Items are listed in 
+            the order they were specified in the rule.'
+  }
+  div('mar0px ind0') {
+    h3 'Gute Links zum Kompilieren und Installieren'
+    abr 'http://eli.thegreenplace.net/2011/08/25/load-time-relocation-of-shared-libraries/',
+         content: 'NAME_ONLY',
+         css_class: 'marl1em'
+    abr :local_c,
+         content: :self,
+         css_class: 'marl1em'
+    abr :local_kernel,
+         content: :self,
+         css_class: 'marl1em'
+  }
+  # ========================================================================= #
+  # === Distcc tag
+  # ========================================================================= #
+  div {
+    abr 'DistCC',
+        content: 'DISTCC/DISTCC.cgi'
+  }
+  # ========================================================================= #
+  # Anhang: March Type
+  # ========================================================================= #  
+  div {
+    h2 sg(:item)+'Anhang bezüglich <span class="BO ud">March Type</span> (-march=i686)','','anhang'
+    table2 'marl4em','march_type','',
+      '<b>-march=i386</b>','<a href="http://de.wikipedia.org/wiki/I386">Steinalter Chip</a>, war aber 
+       damals ein sehr grosser Erfolg',
+      '<b>-march=i486</b>','Alter Code ... Intel i486 CPU. Dieser Chip hat z.Bsp kein scheduling.',
+      '<b>-march=i586</b>','äquivalent zu <b>pentium</b>, also Intel Pentium CPU ohne MMX Unterstützung',
+      '<b>-march=i686</b>','äquivalent zu <b>pentiumpro</b> (Intel Pentium Pro CPU)',
+      '<b>-march=k6</b>','Der AMD K6 CPU Chip mit MMX instruction set support.',
+      '<b>-march=k6-2, k6-3</b>','Improved versions of AMD K6 CPU with MMX and 3dNOW! instruction set support.', 
+      '<b>-march=athlon</b> (und athlon-tbird)','Scheint für Athlons zu gelten, also AMD Athlon CPUs mit 
+        MMX 3dNOW! enhanced 3dNOW! und SSE prefetch instruction support',
+      '<b>-march=pentium</b>','Pentium 1 Reihe',
+      '<b>-march=pentium-mmx</b> # Pentium MMX','Intel Pentium3 CPU MMX Reihe 
+       mit SSE und SSE2 (MMX instruction set support). Wird bei Centrino Notebooks verwendet.',
+      '<b>-march=pentium2</b>','Intel Pentium 2 CPU basierend auf PentiumPro Kern mit MMX Instruction 
+        set support',
+      '<b>-march=pentium3</b>','Intel Pentium3 CPU, basierend auf PentiumPro Core mit MMX und SSE 
+        instruction set',
+      '<b>-march=celron</b>','Celron',
+      '<b>-march=pentium-m</b>','Pentium M (zb Laptop FSC Amilo Pro V2030)',
+        '<b>-march=pentium4</b>','Pentium 4 (produziert von 20.11.2000 - 08.08.2008),
+       Inkludiert auch pentium4m. Hat MMX, SSE und SSE2.',
+      '<b>-march=prescott</b>','Verbessserte Version von Intel Pentium4 CPU mit 
+        MMX SSE SSE2 und SSE3',
+      '<b>-march=athlon-mp</b>','Athlon-mp, inkludiert auch AMD Sempron 
+        (Palomino Reihe)',
+      '<b>-march=athlon-xp</b>','Athlon 64 (AMD), dies gilt für 
+        Improved AMD Athlon CPU mit MMX, 3dNOW!, enhanced 3dNOW! und vollem 
+        SSE instruction set support.', 
+      '<b>-march=athlon-4</b> (sowie athlon-xp, athlon-mp)','Verbesserter AMD 
+        Athlon CPU mit MMX 3dNOW! enhanced 3dNOW! und voller SSE Unterstützung',
+      '<b>-march=k6</b>','AMD K6 Reihe. K6-1 entspricht k6, K6-2 entspricht k6-2,
+        K6-3 entspricht k6-3',
+      '<b>-march=k8</b> (inkludiert auch opteron, athlon64, athlon-fx)','AMD K8 core based CPUs with x86-64 instruction 
+        set support. (This supersets MMX, SSE, SSE2, 3dNOW!, enhanced 3dNOW! and 64-bit instruction set extensions.)',
+      '<b>-march=athlon64</b>','AMD 64? Scheint so zu sein.',
+      '<b>-march=native</b>','Eine neue Variante seit GCC 4.2.0. Wird empfohlen, 
+        ausser man verwendet distcc.',
+      '<b>-march=nocona</b>','Verbesserte Version von Intel Pentium4 CPU 
+        mit 64bit Erweiterung, MMX SSE SSE2 SSE3'
+    br
+    abr_self 'http://gcc.gnu.org/onlinedocs/gcc/i386-and-x86_002d64-Options.html'
+  }
+  # ========================================================================= #
+  # === Nützliche Links bezüglich Installieren, Kompilieren etc
+  # ========================================================================= #
+  div('default') {
+    h2 sg(:note,'marr8px')+
+       'Nützliche Links bezüglich Installieren, Kompilieren etc',COMPILE_HEADER2
+    div('marl3em'){
+      abr 'http://lug-dd.schlittermann.de/vortraege/autoconf.html',
+           content: DOT106+'AutoConf Link'
+      abr 'http://docs.sun.com/app/docs/doc/817-1984/6mhm7pl25?a=view',
+           content: DOT106+'Glibc Audit - ein wichtiger Link'
+      abr 'http://xlife.zuavra.net/columns/20020316',
+           content: DOT106+'Info über C und CC'
+      abr 'http://www.freehackers.org/gentoo/gccflags/flag_gcc3.html',
+           content: DOT106+'GCC3 Flags'
+      abr 'http://www.gentoo.org/doc/en/draft/bootstrapping-guide.xml',
+           content: DOT106+'Der Bootstrapping Prozess'
+      abr 'http://0install.org/index.html',
+           content: DOT106+'ZeroInstall sehr interessant'
+      abr 'http://www.tsfr.org/~orc/Code/configure/',
+           content: DOT106+'Configure, ein Ersatz für GNU Configure'
+      abr 'http://gcc.gnu.org/onlinedocs/gcc/Environment-Variables.html',
+           content: DOT106+'GCC Environment Variables'
+    }
+  }
+  p('mart8px') {
+    roebe_sitemap
+  }
+}}