doc-isac/msteger/official_docu/Doku.tex
author Walther Neuper <neuper@ist.tugraz.at>
Tue, 17 Sep 2013 09:50:52 +0200
changeset 52107 f8845fc8f38d
parent 52056 src/Doc/isac/msteger/official_docu/Doku.tex@f5d9bceb4dc0
child 60586 007ef64dbb08
permissions -rw-r--r--
separated Isac documentation (~~/doc-isac) from Isabelle documentation (~~/src/Doc)
m@42069
     1
\chapter{Definition der Aufgabenstellung}
m@42054
     2
\section{Detaillierte Beschreibung der Aufgabenstellung}
m@42066
     3
Zu Beginn des Projekts wurden einige Vorgaben und Ziele des Projektes erarbeitet und im Laufe des Projekts etwas angepasst. Es wurde bewusst auf eine zu einschr\"ankende Aufgabenstellung verzichtet, da Entwicklungen und Erarbeitungen von verschiedenen Umsetzungsstrategien erw\"unscht war. 
m@42054
     4
m@42066
     5
Hauptaugenmerk war dabei auf die Erstellung eines jEdit-Plugins, dass die Verarbeitung von Back's Structured Derivations m\"oglich machen soll, gelegt worden. Mit anderen Worten, es sollte so viel Plugin-Code, wie im begrenzten Projektzeitraum m\"oglich, implementiert werden.
m@42054
     6
m@42066
     7
Weiters sollte eine Projektstruktur aufgebaut werden, die die Initialisierungsarbeiten von weiterf\"uhrende bzw. nachfolgende Projekten erleichtert und somit verk\"urzt. Dabei sollte darauf geachtet werden, dass die vom Isabelleteam bereits verwendete Projekthierarchie soweit wie m\"oglich \"ubernommen bzw. erweitert wird.
m@42054
     8
Die nachfolgende Auflistung soll die wichtigsten Tasks nochmals zusammenfassen:
m@42054
     9
\begin{enumerate}
m@42054
    10
\item Relevante Isabelle Komponenten identifizieren und studieren
m@42054
    11
\item Installation der Standard-Komponenten
m@42054
    12
\item Entwicklungsumgebung vom Isabelle-Team kopieren
m@42054
    13
\item Relevante Komponenten implementieren
m@42054
    14
  \begin{itemize}
m@42054
    15
  \item jEdit Plugin f\"ur SD
m@42054
    16
  \item zugeh\"origen Parser
m@42054
    17
  \item nicht vorgesehen: SD-Interpreter in Isar (SML)
m@42054
    18
  \end{itemize}
m@42054
    19
\end{enumerate}
m@42054
    20
m@42066
    21
\chapter{Beleuchtung der Projekt-relevanten Technologien}
m@42066
    22
Dieses Kapitel soll die vielen unterschiedlichen Technologien, die im Rahmen dieser Arbeit verwendet oder zumindest ber\"uhrt wurden, beleuchten und dem Leser helfen, nachfolgende Zusammenh\"ange zu verstehen. Nat\"urlich kann in keines der folgenden Themen sehr tief eingestiegen werden. Viel mehr sollen die nachfolgenden Ausf\"uhrungen einen groben \"Uberblick \"uber die einzelnen Technologien geben.
m@42054
    23
\section{Back's Structured Derivations}
m@42054
    24
Wie in der Aufgabenstellung bereits beschrieben, war die Erstellung eines Structured Derivation Plugins das Hauptziel dieser Arbeit. Aus diesem Grund wird in diesem Absatz kurz auf die von Prof. Ralph-Johan Back einf\"uhrten Structured Derivations eingegangen und dessen Eigenschaften bzw. Zusammenh\"ange beschrieben.
m@42054
    25
m@42054
    26
Das nachfolgende Beispiel zeigt ein einfaches Beispiel, wie eine Formel mittels SD dargestellt bzw. umgeformt werden kann:
m@42054
    27
m@42054
    28
%{\footnotesize
m@42054
    29
\begin{tabbing}
m@42054
    30
123,\=1234\=1234\=1234\=1234\=1234\=1234\=123\=\kill
m@42054
    31
\>$\bullet$\>Simplify $(1 - x) * (x ^ 2 + 1) + x ^ 3 - x ^ 2$\\
m@42054
    32
\>  \>$(1 - x) * (x ^ 2 + 1) + x ^ 3 - x ^ 2$\\
m@42054
    33
\>$\equiv$\>$\{ {\it RewriteSet}\;{\it purify}\}$\\
m@42054
    34
\>  \>$(1 + -1 * x) * (x ^ 2 + 1) + x ^ 3 + -1 * x ^ 2$\\
m@42054
    35
\>$\equiv$\>$\{{\it RewriteSet}\;{\it simplify\_pure}\}$\\
m@42054
    36
\>  \>$\bullet$\>$(1 + -1 * x) * (x ^ 2 + 1) + x ^ 3 + -1 * x ^ 2$\\
m@42054
    37
\>  \>$\equiv$\>$\{{\it RewriteSet}\;{\it expand\_poly\_}\}$ \\
m@42054
    38
\>  \>   \>$1 * x ^ 2 + 1 * 1 + (-1 * x * x ^ 2 + -1 * x * 1) + x ^ 3 +-1 * x ^ 2$\\
m@42054
    39
\>  \>$\equiv$\>\vdots\\
m@42054
    40
\>  \>  \>$1 + -1 * x + 0 * x ^ 2 + 0 * x ^ 3$\\
m@42054
    41
\>  \>$\equiv$\>$\{{\it RewriteSet}\;{\it reduce\_012\_}\}$  \\
m@42054
    42
\>  \>     \>$1 + -1 * x$\\
m@42054
    43
\>\dots\>$1 + -1 * x$\\
m@42054
    44
\>$\equiv$\>$\{{\it RewriteSet}\;{\it beautify}\}$\\
m@42054
    45
\>  \>$1-x$
m@42054
    46
\end{tabbing}
m@42054
    47
%}
m@42054
    48
m@42054
    49
Dieses Beispiel kann wie folgt interpretiert werden:
m@42054
    50
\begin{enumerate}
m@42054
    51
\item Die erste Zeile ist als Angabe bzw. Ausgangspunkt der Berechnung zu verstehen.
m@42054
    52
\item Nun folgt der eigentliche Ablauf einer Umformung mittels SD: Mit der Formel in der zweiten Zeile beginnt die Berechnung.
m@42066
    53
\item Die n\"achste Zeile gibt nun an, wie die Formel aus der direkt dar\"uberliegenden Zeile umgeformt bzw. aufbereitet wird. Es ist also eine Beschreibung bzw. die passende Rechenregel, um von der Ausgangsformel auf die nachfolgende Formel schlie{\ss}en zu k\"onnen.
m@42066
    54
\item Aus dieser Rechenvorschrift ergibt sich die Formel in der n\"achsten Zeile.
m@42054
    55
\item Dieser Ablauf wiederholt sich und zieht sich \"uber die weiteren Berechnungen.
m@42054
    56
\end{enumerate}
m@42054
    57
m@42066
    58
Back liefert mit SD eine sehr gute Darstellungs- und Verbarbeitungs-Richtlinie, die einerseits dem Leser/Anwender hilft, da durch die Regel- bzw. Beschreibungs-Zeile klar gestellt wird, wie der letzte Berechnungsschritt durchgef\"uhrt wurde. Andererseits bringt SD auch f\"ur den Programmierer einen klaren Vorteil, da \"uber die vorgestellten Sonderzeichen das Parsen von \textit{SD-Code} vereinfacht bzw. direkt (ohne extra Schl\"usselw\"orter einf\"uhren zu m\"ussen) m\"oglich ist.
m@42054
    59
m@42054
    60
\section{Der Texteditor jEdit}\label{jEdit}
m@42054
    61
%     http://www.jedit.org/
m@42054
    62
%     http://de.wikipedia.org/wiki/JEdit
m@42054
    63
%     http://www.chip.de/downloads/jEdit_19235021.html
m@42054
    64
%
m@42066
    65
jEdit ist ein in Java geschriebener und als Open-Source-Projekt erh\"altlicher Texteditor, der vor allem durch sein sehr gut entwickeltes und ebenso einfaches Plugin-Management-System sehr effektiv eingesetzt werden kann. Solche Plugins k\"{o}nnen direkt in jEdit installiert oder durch manuelles Hinzuf\"{u}gen eines Plugin-Paketes genutzt werden. Dadurch ist dieser Editor sehr flexibel in der Anwendung und kann den eigenen Bed\"{u}rfnissen perfekt angepasst werden.
m@42054
    66
Diese Umst\"ande sind wohl auch der Grund, warum sich die Entwickler von Isabelle f\"ur diesen Editor entschieden haben. Hierbei ist zu erw\"{a}hnen, dass hier eine etwas modifizierte bzw. an Isabelle angepasste Version verwendet wird. Es empfiehlt sich daher, immer die aktuelle Version des Isabelle-jEdit-Editors (zB. aus dem Bundle erh\"{a}ltlich auf der Isabelle-Homepage) zu verwenden, da hier diverse Voreinstellungen vorgenommen wurden. In weiterer Folge wird mit jEdit immer diese modifizierte Version des Editors in Verbindung gebracht, da die Verwendung der Grundversion aus oben genannten Gr\"{u}nden nicht zu empfehlen bzw. sinnvoll ist.
m@42054
    67
Weiters sollte noch erw\"ahnt werden, dass es rund um jEdit einen sehr guten Support via Mailinglist gibt und man wirklich rasch Hilfestellung bekommen kann.
m@42054
    68
m@42054
    69
\subsection{Das Plugin-System}
m@42054
    70
% http://jedit.org/users-guide/writing-plugins-part.html
m@42066
    71
Wie im vorigen Abschnitt bereits erw\"ahnt, ist es sehr einfach und bequem m\"oglich, geeignete Plugins zu installieren bzw. zu verwenden. Es stehen bereits sehr viele verschiedenste Plugins auf der jEdit-Homepage zur Verf\"{u}gung. Diese werden ebenfalls als Open-Source-Projekte angeboten und es bietet sich daher an, bereits verf\"ugbare und funktionierende Plugins als Teil eines neuen Plugins zu verwenden und gegebenenfalls kleine Modifikationen oder Erweiterungen an den Plugins durchzuf\"{u}hren. Im Beispiel von Isabelle wurden unter anderem die Plugins \textit{Sidekick} und \textit{Konsole} verwendet. Dabei ist es m\"oglich, dass Java-Plugins mit Scala-Plugins kombiniert werden, da diese auch problemlos miteinander kommunizieren k\"{o}nnen.
m@42054
    72
jEdit bietet einen Plugin-Manager an, mit dem sich sehr einfach bereits installierte Plugins verwalten und updaten lassen und es ist auch m\"{o}glich, neue Plugins direkt zu installieren.
m@42066
    73
Weiters bietet sich die M\"oglichkeit, selbst implementierte Plugins direkt zu den bereits vorhandenen jEdit-Plugins hizuzuf\"{u}gen. Dazu muss das erzeugte "Plugin".jar Paket ledigich in den jars-Ordner verschoben werden. Beim Start von jEdit wird das neue Plugin automatisch erkannt und hinzugef\"{u}gt. Man muss aber darauf achten, dass \"{A}nderungen nur nach einem Neustart von jEdit \"{u}bernommen werden.
m@42054
    74
m@42054
    75
m@42054
    76
\subsection{Pluginstruktur}
m@42054
    77
Ein solches jEdit-Plugin muss nat\"{u}rlich ein gewisses Design umsetzen, um von jEdit korrekt ausgef\"{u}hrt werden zu k\"{o}nnen. Grunds\"{a}tzlich besteht ein solches Plugin aus den eigentlichen Sourcefiles und einigen XML- und Property-Datein. 
m@42054
    78
Ein m\"{o}glicher Aufbau kann dem Beispiel-Plugin "QuickNotepad"\footnote{http://jedit.org/users-guide/writing-plugins-part.html}, das auf der jEdit-Homepage zu finden ist, entnommen bzw. als Ausgangspunkt f\"{u}r die Entwicklung eines eigenen Plugins herangezogen werden. Weitere Informationen k\"{o}nnen auch dem Paper "Userinterfaces for Computer Theorem Provers" entnommen werden. 
m@42054
    79
m@42054
    80
\section{Isabelle}
m@42066
    81
Isabelle ist einer der f\"{u}hrenden CTPs und an dessen Weiterentwicklung wird st\"{a}ndig gearbeitet. Der letzte gro{\ss}e Schritt betraf den Umstieg von reinem ML auf die "Mischsprache" Scala(mit funktionalen sowie imperativen Sprachanteilen). Weiters wurde der in die Jahre gekommene Proof General und der damit in Verbindung stehende Editor Emacs durch den vielseitigen Editor jEdit ersetzt. Dadurch ergeben sich auch f\"{u}r das laufende \sisac-Projekt an der TU Graz neue M\"{o}glichkeiten. Wichtig im Zusammenhang mit dieser Beschreibung ist zu erw\"{a}hnen, dass hier in weiterer Folge nur noch f\"{u}r jEdit bzw. Scala relevante Teile von Isabelle behandelt und beschrieben werden. Weiters ist wichtig zu wissen, dass f\"{u}r die bereits bestehende Struktur rund um Isablle-jEdit zwei Isabelle-Pakete zum Einsatz kommen. Auf diese Pakete soll in den n\"{a}chsten Passagen eingegangen werden.
m@42054
    82
m@42054
    83
\subsection{Isabelle-Pure}
m@42054
    84
In diesem Plugin ist der eigentliche CTP-Teil von Isabelle verpackt. Das bedeutet im weiteren Sinn, dass es hier keine grafische Verarbeitung der Daten gibt, sondern der Zugriff von aussen erforderich ist, um den CTP mit Daten zu versorgen und diese nach deren Verabreitung in Isabelle-Pure auszuwerten. Also ist nur hier eine Schnittstelle zum eigentlichen Proofer m\"{o}glich und deshalb ist dieses Plugin f\"{u}r das \sisac-Projekt von zentraler Bedeutung. Standardm\"{a}{\ss}ig ist bereits ein Pure.jar-Paket f\"{u}r jEdit vorhanden. Um SD umsetzten zu k\"{o}nnen, muss hier eine Schnittstelle zu Isabelle-Pure implementiert werden. Nach diesem Schritt kann das Plugin Pure.jar neu gebaut werden. 
m@42058
    85
Eine Auflistung der f\"ur das Isabelle-Pure-Packet ben\"otigten Scala-Source-Filles kann Anhang B.2 entnommen werden.
m@42054
    86
m@42054
    87
\subsection{Isabelle-jEdit}
m@42054
    88
Dieser Teil von Isabelle repr\"{a}sentiert das Frontend in jEdit. Hier wird also die grafische Aufbereitung der von Isabelle-Pure berechneten Daten \"{u}bernommen. Dieses Plugin zeigt sehr sch\"{o}n, wie bereits bestehende Plugins weiter genutzt und erweitert werden k\"{o}nnen.
m@42054
    89
An diesem Plugin wird von Seiten der Isabelle-Entwickler sehr stark weitergearbeitet. Darum sollten hier wohl nicht zu viele, am besten nat\"{u}rlich keine \"{A}nderungen, vorgenommen werden. Der Umstand, dass sich einzelne Plugins ganz einfach in einem anderen mitverwenden lassen, macht es m\"{o}glich, dass das \sisac-Plugin sehr einfach, im Idealfall von Seiten der Isabelle-Entwickler, in das Isabelle-jEdit-Plugin integriert werden kann.
m@42054
    90
m@42054
    91
\subsection{Paketstruktur von Isabelle}
m@42066
    92
Durch die Komplexit\"{a}t des Isabelle-Entwicklungs-Aufbaus soll hier eine Auflistung aller relevanten jar-Pakete erfolgen. Alle Pakete befinden sich innerhalb der Ordnerstruktur von ISABELLE\_HOME. Darum wird ab hier immer von diesem Verzeichnis ausgegangen.
m@42066
    93
Die nachfolgende Auflistung zeigt alle Pakete, die f\"{u}r SD bzw. {\sisac} von Bedeutung sind und und wo diese zu finden sind.
m@42054
    94
 
m@42054
    95
m@42054
    96
\begin{itemize}
m@42066
    97
\item \textit{contrib/jedit-4.3.2\_Isabelle-6d736d983d5c/jars:} \textbf{Isabelle-jEdit.jar, Pure.jar, SideKick.jar, ...} Der Ordner contrib ist in der Repository-Version nicht vorhanden! Dieser kann dem Isabelle-Bundle  entnommen werden. Hier befinden sich alle ben\"{o}tigten Zusatztools f\"{u}r Isabelle und darunter eben auch jEdit. In dem oben angef\"{u}hrten Ordner liegen alle Plugins bzw. dorthin werden alle Plugins kopiert, die zusammen mit jEdit gestartet werden sollen. 
m@42054
    98
\item \textit{lib/classes:} \textbf{isabelle-scala.jar, pure.jar;} Standardm\"{a}{\ss}ig ist dieser Ordner nicht vorhanden. Erst durch Erzeugen der angef\"{u}hrten jar's werden dieser Ordner und die Pakete erstellt.
m@42054
    99
\item \textit{src/Tools/jEdit/dist/jars:} \textbf{Isabelle-jEdit.jar, Pure.jar, SideKick.jar, jedit.jar, ...} 
m@42066
   100
\item \textit{src/Tools/jEditC/dist/jars:} \textbf{Isabelle-jEdit.jar, Pure.jar, SideKick.jar, jedit.jar, ...} Diese beiden obigen Verzeichnisse sind, wie man an der sehr \"{a}hnlichen Pfadstruktur erkennen kann, \"{a}quivalent, wobei der zweite Pfad zum \sisac-Entwicklungsverzeichnis geh\"{o}rt. Hier sind die f\"{u}r das Isabelle-jEdit- bzw. \sisac-Plugin ben\"{o}tigten Plugins und Pakete plus das erzeugte Plugin zu finden.
m@42066
   101
\item \textit{src/Tools/jEditC/contrib/jEdit/build/jars:} \textbf{Isabelle-jEdit.jar, Pure.jar, SideKick.jar, jedit.jar, ...} Diesen Aufbau ben\"{o}tigt man nur, wenn man das jEdit-Isac-Projekt direkt in NetBeans debuggen m\"{o}chte. Man erkennt, dass in diesem Verzeichnis der vollst\"{a}ndige Quellcode von jEdit plus allen Plugins, die zusammen mit jEdit gestartet werden sollen, hier zu finden sind. Wie aber bereits erw\"{a}hnt, ist vom direkten Debuggen generell abzuraten bzw. sollte dies nur f\"ur schwer nachvollziebare Abl\"aufe ohne Isabelle-Beteiligung angewendet werden. 
m@42054
   102
\end{itemize} 
m@42054
   103
m@42066
   104
Siehe dazu auch Anhang B. Dort sind alle relevanten jar-Pakete noch einmal aufgearbeitet und entsprechend gruppiert.
m@42054
   105
m@42054
   106
\section{Die Programmiersprache Scala}
m@42054
   107
Urspr\"{u}nglich wurde Isabelle rein in ML entwickelt. Erst vor ein paar Jahren wurde mit der \"{U}bersetzung von einigen Teilen in Scala begonnen. Grund genug, sich hier kurz diese neue und sehr vielseitige Sprache etwas genauer anzusehen.
m@42054
   108
m@42054
   109
\subsection{Grundlage der Sprache}
m@42066
   110
Scala ist eine objektorientierte Sprache, die sehr \"{a}hnlich zu Java aufgebaut wurde. Dadurch wird die Einarbeitung in diese Programmiersprache f\"{u}r Java-Programmierer sehr vereinfacht. Neben den Vorteilen einer objektorientierten Sprache deckt Scala aber auch die Bed\"{u}rfnisse der funktionalen Programmierung ab. Dies, und vorallem auch das von Erlang \"ubernommene und sehr gut umgesetzte Actorprinzip, sind wohl die Hauptgr\"unde, warum sich das Isabelle-Entwicklungsteam f\"{u}r diese Sprache entschieden hat. Wie bereits erw\"{a}hnt, ist Scala sehr \"{a}hnlich aufgebaut wie Java und hat nebenbei noch den gro{\ss}en Vorteil, dass Scala-Executables in der JVM (Java virtual Machine) ausf\"{u}hrbar sind. Dadurch ist die Plattformunabh\"{a}ngigkeit garantiert und es besteht ein direkter Zusammenhang zwischen Scala und Java der auch bei der jEdit-Plugin-Entwicklung ausgenutzt bzw. verwendet wird.
m@42054
   111
m@42054
   112
Dieser direkte Zusammenhang zwischen Java und Scala soll anhand der Grafik-Bibliotheken Swing gezeigt bzw. die Vorteile, die daraus resultieren, beleuchtet werden.
m@42054
   113
m@42054
   114
Beide Sprachen stellen diese Grafik-Bibliotheken zur Verf\"{u}gung (und darin auch eigene Shapes und Funktionalit\"{a}t). Es ist jedoch m\"{o}glich, Java-Bibliotheken, wie eben Java-Swing in Scala zu verwenden. Ein JButton(Java) kann zum Beispiel mittels \textit{import javax.swing.JButton} in Scala eingebunden und damit sofort verwendet werden. Auch Scala stellt in seiner Swing-Bibliothek einen Button zur Verf\"{u}gung: \textit{scala.swing.Button}. Es wird nahezu dieselbe Funktionalit\"{a}t angeboten und teilweise die Erzeugung bzw. Verwendung vereinfacht. Man kann sich nun fragen, warum sich die Scala-Entwickler einerseits die M\"{u}he gemacht haben, die Verwendung Java-Swing, wie in Java selbst, m\"{o}glich zu machen und andererseits mit Scala-Swing eine nahezu idente Alternative geschaffen haben. 
m@42054
   115
m@42054
   116
Die Antwort darauf zeigt, wie die Objektorientiertheit von Scala in vielen Bereichen ausgenutzt wurde, um die Sprache mit Funktionalit\"{a}t auszur\"{u}sten, denn es wurde kein neues Konzept f\"{u}r diese Grafikklassen entworfen, sondern Wrapper-Objekte/ Methoden/Klassen erstellt, die das Arbeiten mit diesen Grafikkomponenten erleichtern soll. 
m@42054
   117
Ein Letztes Problem bleibt noch: Es ist zwar sehr einfach ein Java-Swing-Objekt an einen Scala-Swing-Container (zb. Frame) anzubinden, da eine Konvertierung einer Java-Komponente in ein Scala-\"{a}quivalent problemlos m\"{o}glich ist. Jedoch ist oft auch die Konvertierung einer Scala- in eine Java-Komponente n\"{o}tig. Dies kann ganz einfach mittels \textit(peer)-Befehl der Komponente erreicht werden.
m@42054
   118
m@42054
   119
Das angef\"{u}hrte Beispiel soll zeigen, wie vielseitig Scala sein kann und welch enormes Potenzial in dieser noch sehr jungen Sprache steckt. Nat\"{u}rlich gibt es dazu eine sehr gut aufgebaute Entwickler-Homepage\footnote{http://www.scala-lang.org/}, die Tutorials, Plugin f\"{u}r diverse IDEs und weitere n\"{u}tzliche Hilfestellungen f\"{u}r Scala-Neulinge bereitstellt.
m@42054
   120
m@42054
   121
\subsection{Scala, Java und jEdit}
m@42066
   122
Wie im letzten Abschnitt bereits beschrieben, kommen bei jEdit Java- sowie auch Scala-Komponenten zum Einsatz bzw. werden sogar zu logischen Einheiten kombiniert. So ist zum Beispiel jEdit selbst rein in Java geschrieben und das Plugin Isabelle-jEdit rein in Scala. Trotzdem gibt es \"{u}berhaupt kein Problem, diese beiden jar-File miteinander bzw. ineinander in der JVM zu nutzen. Es geht sogar so weit, dass es m\"{o}glich ist, dass das Plugin Isabelle-jEdit bereits vorhandene und rein in Java geschriebene Plugins erweitert und nutzt. Dieses Zusammenspiel zwischen Objekten aus zwei verschiedenen Sprachen ist doch recht au\ss ergew\"{o}hnlich und kann bzw. sollte nat\"{u}rlich auch f\"{u}r SD bzw. {\sisac} ausgenutzt werden!
m@42054
   123
m@42054
   124
\subsection{Der Isabelle-Scala-Layer}
m@42054
   125
Es sollten nun die Grundlegenden Eigenschaften von Scala bekannt sein. Die Einf\"uhrung des Scala-Layers ab Isabelle-Version 2009 war ein grosser Schritt f\"ur das Isabelle Projekt. Das Scala-Actor-Konzept erm\"oglicht die asynchrone Verarbeitung von einzelnen Beweisteilen und ist einer der massgeblichen Gr\"unde f\"ur die Einf\"uhrung des Scala-Layer. 
m@42054
   126
m@42054
   127
Dieser Absatz sollen nun die Eigenschaften des Scala-Layers und die damit verbundenen Chancen f\"ur das Isac- bzw. SD-Projektes 
m@42054
   128
erarbeitet werden. 
m@42054
   129
m@42054
   130
\begin{figure}
m@42054
   131
\begin{center}
m@42066
   132
\includegraphics[width=100mm]{../fig-reuse-ml-scala-SD}
m@42054
   133
\end{center}
m@42054
   134
\label{fig-reuse-ml-scala}
m@42054
   135
\end{figure}
m@42054
   136
m@42066
   137
Der Scala-Layer verbindet die Java Virtual Maschine (JVM) und den in Standart-ML (SML) geschriebenen Isabelle-Kern. Dabei wird ein internes Protokoll verwendet, dass den Datenaustausch zwischen jEdit und Isabelle/Isar erm\"oglicht. Dieses Protokoll ist im Moment noch (bewusst) ohne API ausgef\"uhrt. Aus diesem Grund musste eine Schnittstelle definiert werden, um den Datenaustausch des SD-Plugins (JVM) mit dem SD-Interpreter m\"oglich zu machen. Siehe dazu den Absatz "Verbindung zum Isabelle-Pure Plugin herstellen". Man kann aus diesem Umstand ableiten, dass die Isabelle-Entwickler mit diesem eingezogenen Scala-Layer und dem damit verbundenen internen Protokoll, auf eine konsistente Verwaltung der Theorie-Bibliotheken abzielen. Mit anderen Worten wird dem Anwendungsprogrammierer der direkte Zugriff auf die Isabelle/Isar-Komponente verwehrt. Der Anwender sollte hier also nicht angreifen sonder die Isabelle-Theorien entsprechend erweitern.
m@42054
   138
neuper@42057
   139
\chapter{Konfiguration und Implementation der Komponenten}
neuper@42057
   140
Dieses Kapitel soll nun anhand der bereits gewonnen Erkenntnise illustrieren, wie die Entwicklungsumgebung vom Isabelle-Team kopiert wurde und wie wichtigsten Schritte zum SD-Plugin f\"{u}r jEdit wahrscheinlich aussehen werden. Wobei einige Schritte parallel und dadurch nat\"{u}rlich sehr gut im Team umgesetzt werden k\"{o}nnen. Eine genaue Aufstellung aller beteiligten Files k\"onnen dem Anhang D entnommen werden.
m@42054
   141
neuper@42057
   142
\section{Konfiguration des Netbeans Projektes}
neuper@42057
   143
Um in k\"unftigen Entwicklungsvorhaben effizient kooperieren zu k\"onnen, wurde das Netbeans-Projekt genau nach den Vorgaben des Isabelle-Teams konfiguriert. 
neuper@42057
   144
m@42058
   145
\begin{enumerate}
m@42058
   146
\item Konfigurations-Files von Netbeans in ``Files''-View; beeinflussen sich gegenseitig
m@42058
   147
  \begin{enumerate}
m@42058
   148
  \item build.xml (aus template erzeugt, keine automatischen Ver\"anderunen)
m@42058
   149
  \item nbproject/build-impl.xml (z.T. automatische Ver\"anderunen)
m@42058
   150
  \item nbproject/project.xml (z.T. automatische Ver\"anderunen)
m@42058
   151
  \item TODO
m@42058
   152
  \end{enumerate}
m@42058
   153
\item Sacla-plugin installieren laut http://wiki.netbeans.org/Scala69, 
m@42058
   154
  \begin{enumerate}
m@42058
   155
  \item von ``Install with NetBeasn 6.9''
m@42058
   156
  \item nach /usr/local/netbeans.../plugins/scala
m@42058
   157
  \end{enumerate}
m@42058
   158
\item Scala-plugin installiert in NetBeans
m@42058
   159
  \begin{enumerate}
m@42058
   160
  \item Men\"u $>$ Tools $>$ Plugins $>$ Downloaded $>$ Add Plugins 
m@42058
   161
  \item alle Files von /usr/local/netbeans.../plugins/scala/
m@42058
   162
  \item Fenster zeigt alle ausgew\"alten Files
m@42058
   163
  \item $<$Install$>$ calls Wizzard $<$Next$>$ probably accept Warning
m@42058
   164
  \item Funktionstest: Men\"ue $>$ Files $>$ New Project: zeigt Scala als ``Categories''
m@42058
   165
  \end{enumerate}
m@42058
   166
\item Neues Projekt ``isac-jedit'' konfigurieren
m@42058
   167
  \begin{enumerate}
m@42058
   168
  \item Men\"u $>$ Open Project (weil schon aus dem Repository die notwendigen Files vorhanden sind)
m@42058
   169
  \item /src/Tools/jeditC: Reference Problems, weil jEdit folgende Plugins braucht
m@42058
   170
  \item Funktionskontrolle: ``Projects''-View zeigt das neue Projekt
m@42058
   171
  \item Die Konfigurations-Files sind v\"ollig getrennt von anderen Projekten
m@42058
   172
  \item Referenz-Probleme beheben; das zeigt auch eventuell fehlende Files
m@42058
   173
    \begin{enumerate}
m@42058
   174
    \item ``Projects''-View $>$ rightMouse $>$ Resolve Reference Problems: Fenster zeigt dieListe der fehlenden Dateien; $<$Next$>$
m@42058
   175
    \item Files holen aus ``Tools'' $>$ Libraries: \"uber Filebrowser aus dem Isabelle\_bundle holen contrib/jEdit---/jars
m@42058
   176
    \item ``New Library'' 
m@42058
   177
      \begin{enumerate}
m@42058
   178
      \item Cobra-renderer: cobra.jar
m@42058
   179
      \item Console:  Console.jar
m@42058
   180
      \item ErrorList: ErrorList.jar
m@42058
   181
      \item Hyperlinks: Hyperlinks.jar
m@42058
   182
      \item Isabelle-Pure: Pure.jar
m@42058
   183
      \item Rhino-JavaScript: js.jar
m@42058
   184
      \item Scala-compiler: scala-compiler.jar
m@42058
   185
      \item SideKick: SideKick.jar
m@42058
   186
      \end{enumerate}
m@42058
   187
    \item Funktions-Kontrollen 
m@42058
   188
      \begin{enumerate}
m@42058
   189
      \item das kleine gelbe Warndreieck im ``Projects''-View ist verschwunden
m@42058
   190
      \item im ``Projects''-View 2 Ordner: ``src'' und ``Libraries''
m@42058
   191
      \end{enumerate}
m@42058
   192
    \end{enumerate}
m@42058
   193
  \item jEdit-Paket zum ``isac-jedit''-Projekt hinzuf\"ugen
m@42058
   194
    \begin{enumerate}
m@42058
   195
    \item ``Project''-View $>$ rightMouse $>$ Add Jar/Folder: Filebrowser
m@42058
   196
    \item /contrib/jedit.../jedit.jar
m@42058
   197
    \item Funktions-Kontrolle: ist in ``Projects''/Libraries/jedit.jar
m@42058
   198
    \end{enumerate}
m@42058
   199
  \item Das neue Projekt ``isac-jedit'' zum Hauptprojekt machen: ``Project''-View $>$ rightMouse $>$ Set as Main Project; Funktions-Kontrolle: der Projektname ist boldface.
m@42058
   200
  \end{enumerate}
m@42058
   201
\item Ab nun wird die Konfiguration \"uber ``trial and error'' zu Ende gef\"uhrt
m@42058
   202
  \begin{enumerate}
m@42058
   203
  \item Men\"u $>$ Build Main 
m@42058
   204
    \begin{enumerate}
m@42058
   205
    \item Wenn: Target ``Isac-impl.jar'' does not exist in the project ``isac-jedit''. It is used from target ``debug''
m@42058
   206
      \begin{enumerate}
m@42058
   207
      \item Versuch
m@42058
   208
        \begin{itemize}
m@42058
   209
        \item build-impl.xml l\"oschen
m@42058
   210
        \item NetBeans neu starten, stellt build-impl.xml automatisch aus build.xml wieder her
m@42058
   211
        \item \dots hat in diesem Fall nicht geholfen
m@42058
   212
       \end{itemize}
m@42058
   213
      \item Versuch zur Vermutung: Projekt wurde umbenannt von ``Isac'' in ``isac-jedit'', und das machte build.xml inkonsistent
m@42058
   214
        \begin{itemize}
m@42058
   215
        \item in build.xml query-replace ``Isac'' in ``isac-jedit''
m@42058
   216
        \item TODO?
m@42058
   217
        \item 
m@42058
   218
        \end{itemize}
m@42058
   219
      \end{enumerate}
m@42058
   220
    \item Wenn: Problem: failed to create tsk or type scalac
m@42058
   221
      \begin{enumerate}
m@42058
   222
      \item Versuch: Pfad zum Scala bekanntgeben
m@42058
   223
        \begin{itemize}
m@42058
   224
        \item /usr/local/netbeans-6.9.1/etc/netbeans.conf: netbeans\_default\_options= richtigen Scala-Pfad setzen
m@42058
   225
        \item build-impl.xml l\"oschen
m@42058
   226
        \item NetBeans neu starten.
m@42058
   227
        \end{itemize}
m@42058
   228
      \end{enumerate}
m@42058
   229
    \item Wenn Fehler: ``/usr/local/isabisac/src/Tools/jEditC/\${project.jEdit}/modes does not exist''
m@42058
   230
      \begin{enumerate}
m@42058
   231
      \item grep -r "project.jEdit" *
m@42058
   232
      \item nbproject/project.properties:project.jEdit=contrib/jEdit
m@42069
   233
      \item TODO?
m@42058
   234
      \end{enumerate}
m@42058
   235
    \end{enumerate}
m@42058
   236
  \end{enumerate}
m@42069
   237
\item error in project files, not in build.xml etc (1)
m@42069
   238
  \begin{enumerate}
m@42069
   239
  \item follow link to testSD.scala:22
m@42069
   240
  \item val str1: String = isabelle.Isac.parse(``Testdaten aus dem Parser!'')\\
m@42069
   241
        val str1: String = ``TEST'' //isabelle.Isac.parse(``Testdaten aus dem Parser!'')\\
m@42069
   242
  \item build once again ... successful\\
m@42069
   243
  \item watch in console what is being copied and compare build.xml, 
m@42069
   244
          $<$target name=''-pre-jar''$>$
m@42069
   245
          $<$target name=''-post-jar''$>$
m@42069
   246
  \item essential: a new Pure.jar has been generated, which has been extended with a new class ``Isac''; this class has been defined in scr/Pure/Isac/isac.scala
m@42069
   247
  \item restore ``val str1: String = isabelle.Isac.parse(``Testdaten aus dem Parser!'')" requires new Pure.jar at the right place \dots
m@42069
   248
  \item \dots the shellscript bin/testSD\_jedit creates this new Pure.jar
m@42069
   249
  \end{enumerate}
m@42069
   250
\item error in bin/testSD
m@42069
   251
  \begin{enumerate}
m@42069
   252
  \item look at error messages, eg. src/Pure/: no such file or directory \dots
m@42069
   253
  \item \dots means that the script has not been started from $\approx\approx$ --- this behaviour shall be improved a.s.a.p.
m@42069
   254
  \item function test: \\
m@42069
   255
        \#\#\#\\
m@42069
   256
        \#\#\# Building Isabelle/Scala layer\\
m@42069
   257
        \#\#\#\\
m@42069
   258
  \item 
m@42069
   259
  \item 
m@42069
   260
  \end{enumerate}
m@42058
   261
$<$ $>$
m@42058
   262
Men\"u $>$  $>$ $>$  $>$ $>$  $>$
m@42058
   263
``Project''-View $>$ rightMouse $>$ $>$  $>$ $>$  $>$
m@42058
   264
\item 
m@42058
   265
  \begin{enumerate}
m@42058
   266
  \item 
m@42058
   267
    \begin{enumerate}
m@42058
   268
    \item 
m@42058
   269
      \begin{itemize}
m@42058
   270
      \item 
m@42058
   271
        \begin{itemize}
m@42058
   272
        \item 
m@42058
   273
        \item 
m@42058
   274
        \item 
m@42058
   275
        \end{itemize}
m@42058
   276
      \item 
m@42058
   277
      \item 
m@42058
   278
      \end{itemize}
m@42058
   279
    \item 
m@42058
   280
    \item 
m@42058
   281
    \end{enumerate}
m@42058
   282
  \item 
m@42058
   283
  \item 
m@42058
   284
  \end{enumerate}
m@42058
   285
\item 
m@42058
   286
  \begin{enumerate}
m@42058
   287
  \item 
m@42058
   288
    \begin{enumerate}
m@42058
   289
    \item 
m@42058
   290
      \begin{itemize}
m@42058
   291
      \item 
m@42058
   292
        \begin{itemize}
m@42058
   293
        \item 
m@42058
   294
        \item 
m@42058
   295
        \item 
m@42058
   296
        \end{itemize}
m@42058
   297
      \item 
m@42058
   298
      \item 
m@42058
   299
      \end{itemize}
m@42058
   300
    \item 
m@42058
   301
    \item 
m@42058
   302
    \end{enumerate}
m@42058
   303
  \item 
m@42058
   304
  \item 
m@42058
   305
  \end{enumerate}
m@42058
   306
\end{enumerate}
neuper@42057
   307
neuper@42057
   308
neuper@42057
   309
\section{Implementation der jEdit Komponenten}
neuper@42057
   310
neuper@42057
   311
\subsection{Erstellen des Plugin-Ger\"{u}sts}
m@42066
   312
Hier gilt es, erstmal den Umfang der gew\"{u}nschten Anforderungen an das Plugin so genau wie m\"{o}glich zu identifizieren. Hat man eine sehr genaue Vorstellung, wie das GUI des Plugins aussehen wird und welche Zusatz-Features angeboten werden sollen, so kann man gezielt unter den bereits bestehenden Plugins f\"{u}r jEdit nach n\"{u}tzlichen Plugins suchen, die in das SD-Plugin (m\"{o}glicherweise durch kleine Modifikationen) integriert werden k\"{o}nnen. Dies spart einerseits sehr viel Zeit und ist nebenbei genau die Art von Programmierung, die durch die offnene Plugin-Struktur von jEdit gef\"{o}rdert wird. 
m@42054
   313
m@42066
   314
Hat man nun die Planung abgeschlossen und m\"{o}glicherweise n\"{u}tzliche Plugins gefunden, kann mit der Programmierung des GUIs begonnen werden. Man sollte hier beachten, dass man von Beginn an festlegt, ob mit Scala- oder Java-Swing Komponenten gearbeitet werden soll. Es ist zwar m\"{o}glich, beide Formen zu mischen, doch aus Klarheitsgr\"{u}nden sollte man sich f\"{u}r eine Art entscheiden. Wobei hier die Empfehlung im Moment eher noch Richtung Java-Swing geht, da man hier eigentlich f\"{u}r jede Art von Problem bzw. Aufgabe bereits HowTo's im Web finden kann. Da bei Scala-Swing nur Wrapper auf die Java-Swing-Libraries gesetzt wurden, entsteht dadurch auch keinerlei Performance-Verlust.
m@42054
   315
m@42054
   316
Es existiert bereits ein beispielhaftes Plugin am \sisac-Repository. Da der grunds\"{a}tzliche Aufbau eines jEdit-Plugins soweit umgesetzt wurde und bereits lauff\"{a}hig ist, sollte man dieses wohl als Ausgangspunkt verwenden. Die direkte Verwendung eines Isabelle-Klons ist wohl zu Beginn nicht zu empfehlen bzw. sollte meiner Meinung nach die Integration von Isac in Isabelle bzw. die Verwachsung der beiden Plugins das Fernziel sein und dadurch w\"{u}rde der Klon-Vorgang wohl eher Probleme schaffen als sie zu l\"{o}sen.
m@42054
   317
neuper@42057
   318
\subsection{Erzeugung des Plugins}
m@42066
   319
Hat man die Planung des Plugin-Ger\"{u}sts abgeschlossen und die eigentliche Implementationsphase begonnen, kann dieses Plugin getestet bzw. erzeugt und via jEdit ausgef\"{u}hrt werden. Dazu muss zuerst das jar-File erzeugt und danach in den jEdit-Pluginsordner verschoben werden. Die Erzeugung kann nat\"{u}rlich direkt mittels NetBeans durchgef\"{u}hrt werden. Doch es ist auch m\"{o}glich dies via Kommandline durchzuf\"{u}hren. Folgende Schritte illustrieren wie die Erzeugung und der Kopiervorgang des Plugins durchgef\"{u}hrt werden k\"{o}nnen(Ausschnitt aus dem Skript isac\_jedit, Anhang C):
m@42054
   320
\begin{enumerate}
m@42054
   321
\item Das Plugin kann mittels Kommandline folgenderma{\ss}en erstellt werden: \\ \textit{cd ISABELLE\_HOME/src/Tools/isac/jEdit} $\rightarrow$ \textit{ant jar}
m@42054
   322
\item Nun kann das das neue Plugin ganz einfach kopiert werden \textit{cp contrib/jEdit/build/ // jars/Isac.jar ../../../../contrib/jedit-4.3.2\_Isabelle-6d736d983d5c/jars/}
m@42054
   323
\item jEdit ausf\"{u}hren und testen
m@42054
   324
\end{enumerate}
m@42054
   325
neuper@42057
   326
\subsection{Verbindung zum Isabelle-Pure Plugin herstellen}
m@42054
   327
Der n\"{a}chste Schritt sieht nun die Versorgung des GUIs mit Daten vor. Da das jEdit-Plugin selbst nicht rechnen/interpretieren kann, m\"{u}ssen Daten an den Isabelle-Kern, also das Isabelle-Pure-Plugin weitergegeben werden. Dort k\"{o}nnen die Daten verwertet und aufbereitet zur\"{u}ck an das Frontend gereicht werden. 
m@42054
   328
m@42054
   329
\begin{figure}
m@42054
   330
\begin{center}
m@42066
   331
\includegraphics[width=100mm]{../fig-jedit-plugins-SD}
m@42054
   332
\end{center}
m@42054
   333
\label{fig-jedit-plugins-SD}
m@42054
   334
\end{figure}
m@42054
   335
m@42054
   336
Um diesen Schritt setzen zu k\"{o}nnen, muss eine Schnittstelle zwischen dem Kern von Isabelle, Isabelle-Pure und dem Plugin hergestellt werden. Dazu muss zun\"{a}chst Pure.jar leicht modifiziert, danach neu erstellt und zuletzt zu den restlichen jEdit-Plugins hinzugef\"{u}gt werden. Dies wurde auf der aktuellen Version am Repository bereits erledigt. Folgende Schritte wurden dazu gesetzt und sind wieder n\"{o}tig, da sicher weitere Modifikationen an der Datei Pure.jar n\"{o}tig sein werden.
m@42054
   337
m@42054
   338
m@42054
   339
\begin{enumerate}
m@42054
   340
\item Um den \sisac-Teil im Isabelle-Pure genau abzugrenzen, wurde ein Ordner \textit{Isac} angelegt und ein Testfile \textit{isac.scala} erstellt.
m@42054
   341
\item Nun muss diese File nat\"{u}rlich dem Make-Skript \textit{ISABELLE\_HOME/src/Pure/build-jars} hizugef\"{u}gt werden, um beim Erzeugen des jar-Files mitverpackt zu werden.
m@42054
   342
\item Nun kann Pure.jar mittels Kommandline erstellt werden: \textit{cd /src/Pure} $\rightarrow$ \textit{../../bin/isabelle env ./build-jars}
m@42054
   343
\item Nun kann das das neue Plugin ganz einfach kopiert werden \textit{cp ../../lib/classes/Pure.jar ../../contrib/jedit-4.3.2\_Isabelle-6d736d983d5c/jars/}
m@42054
   344
\item jEdit ausf\"{u}hren und testen
m@42054
   345
\end{enumerate}
m@42054
   346
Alle die oben angef\"{u}hrten Punkte, sowie das Erzeugen und Kopieren des Plugins selbst, werden vom Script isac\_jedit erledigt.
m@42054
   347
Das Skript kann dem Anhang C entnommen werden.
m@42054
   348
m@42054
   349
\section{Umsetzung des SD-Parsers}
m@42054
   350
Aus diversen Gr\"{u}nden wurde dieser Punkt im Zuge dieser Projektarbeit nicht mehr umgesetzt sonder nach hinten verschoben. Jedoch gibt es bereits eine Version des Parsers in ML und diese kann in einigen Arbeitsstunden in Zusammenarbeit mit Herrn Neuper in Scala \"{u}bersetzt und eingesetzt werden.
m@42054
   351
m@42054
   352
Es ist bereits ein Parser in ML im Isabelle-Verzeichnis vorhanden, \textit{src/Pure/isar/ parse.ML}. Hier werden sogannte "parse combinators" verwendet. Dasselbe wird in n\"{a}chster Zeit von Seiten des Isabelle-Team auch f\"{u}r den Scala-Parse implementiert. Dadurch lassen sich hieraus auch wichtige Erkenntnisse gewinnen und dies spricht ebenfalls f\"{u}r die Verschiebung dieses Milestones nach hinten. 
m@42054
   353
m@42054
   354
m@42054
   355
\chapter{Ausblick: Von SD- zum \isac-Plugin}
m@42054
   356
Die obigen Schritte sind n\"{o}tig, um das vorl\"{a}ufige Plugin SD umzusetzen. Nat\"{u}rlich beginnt danach die spannende Arbeit erst so richtig. Ist erst mal ein funktionierender SD-Parser vorhanden, kann dieser immer weiter verbessert und verfeinert werden, bis man auch damit beginnen kann, ihn f\"{u}r das \sisac-Projekt zu nutzen. 
m@42054
   357
m@42054
   358
Daneben kann an der Weiterentwicklung des GUIs gearbeitet werden und die ersten Schritte zur Ann\"{a}herung an das Isabelle-Plugin k\"{o}nnen hier erfolgen. 
m@42054
   359
m@42054
   360
\chapter{Zusammenfassung und R\"{u}ckblick}
neuper@42057
   361
Zusammenfassend wird nun ein \"Uberblick gegeben, welche Milestones erledigt wurden und welche nicht; Details dazu finden sich in Anhang A. %TODO
neuper@42057
   362
Abschlie{\ss}end gebe ich einen R\"uckblick auf meine pers\"onlichen Erfahrungen aus dieser Bakkalaureats-Arbeit.
neuper@42057
   363
neuper@42057
   364
\section{Zusammenfassung}
neuper@42057
   365
Folgende Milestones wurden erfolgreich abgeschlossen:
neuper@42057
   366
\begin{enumerate}
neuper@42057
   367
\item Relevante Isabelle Komponenten dokumentiert
neuper@42057
   368
neuper@42057
   369
\item Installation der Standard-Komponenten:
neuper@42057
   370
  \begin{itemize}
neuper@42057
   371
  \item Mercurial Versioncontrol
neuper@42057
   372
  \item NetBeans IDE
neuper@42057
   373
  \item Standard Isabelle Bundle
neuper@42057
   374
  \end{itemize}
neuper@42057
   375
  
neuper@42057
   376
\item Entwicklungsumgebung vom Isabelle-Team kopieren
neuper@42057
   377
  \begin{itemize}
neuper@42057
   378
  \item Isabelle-Sources vom Repository M\"unchen (Java, Scala, ML)
neuper@42057
   379
  \item jEdit als NetBeans Projekt definiert
neuper@42057
   380
  \end{itemize}
neuper@42057
   381
  
neuper@42057
   382
\item Relevante Komponenten implementieren
neuper@42057
   383
  \begin{itemize}
neuper@42057
   384
  \item jEdit Plugin f\"ur SD
neuper@42057
   385
  \item Verbindung des Plugins zu Isabelle
neuper@42057
   386
  \item zugeh\"origen Parser: nur ein Test in SML
neuper@42057
   387
  \end{itemize}
neuper@42057
   388
\end{enumerate}
neuper@42057
   389
neuper@42057
   390
\noindent Aus Zeitgr\"unden war {\em nicht} m\"oglich, ein komplettes SD-Plugin zu implementieren; dazu w\"are auch ein Interpreter f\"ur SD auf der ML-Seite n\"otig gewesen.
neuper@42057
   391
neuper@42057
   392
\paragraph{Voraussetzungen f\"ur k\"unftige Entwicklung} geschaffen:
neuper@42057
   393
\begin{enumerate}
neuper@42057
   394
\item f\"ur die Implementation von ``structured derivations'' in Isabelle \dots
neuper@42057
   395
\item \dots als Vorarbeit f\"ur jEdit als k\"unftiges \isac-Frontend
neuper@42057
   396
\item f\"ur Mitarbeit an k\"unftiger Integration von Isabelle in Entwicklungswerkzeuge (Testcase-Generation etc).
neuper@42057
   397
\end{enumerate}
neuper@42057
   398
neuper@42057
   399
\section{R\"uckblick}
m@42054
   400
Isabelle ist ein sehr gro\ss es Softwarepacket mit mehreren Millionen LOC. Daher gestaltete sich die Einarbeitungsphase sehr schwierig und kostet sehr viel Zeit. Erschwerend kam hinzu, dass ich von Beginn an mit mehreren, f\"{u}r mich noch ganz neue, Technologien arbeiten musste. Diese Herausforderungen schon zu Beginn machten die Arbeit an \sisac{ }von Beginn an spannend. Hier ist mir vorallem die gemeinsam mit meinem Betreuer Herrn Walther Neuper durchgef\"{u}hrte Installationsarbeit von Isabelle in Erinnerung geblieben. Nie zuvor hatte ich f\"{u}r eine Installation von Software so lange gebraucht - eine ganz neue, wichtige Erfahrung.
m@42054
   401
m@42066
   402
Einer der bedeutensten Milesteine war r\"{u}ckblickend wohl, die Verzeichnisstruktur von Isabelle grunds\"atzlich verstanden zu haben. Bei einem Softwarepacket von dieser Gr\"{o}{\ss}e war es wichtig zu wissen, wo man Files suchen/modifizieren/einf\"{u}gen muss, um den gew\"{u}nschten Effekt erreichen zu k\"onnen.
m@42054
   403
m@42054
   404
Der n\"achste wichtige Schritt war das bereits teilweise bestehende NetBeansprojekt lauff\"ahig zu machen und mir damit zum ersten mal selbst das jEdit-Isabelle-Plugin erzeugen zu k\"onnen. Dies war ein sehr bedeutsamer Schritt, da ich hier zum einen NetBeans und dessen Konfiguration besser kennenlernen konnte und zum anderen sehr viel \"{u}ber die Pluginstruktur eines jEdit-Plugins lernen konnte. Zu Beginn machte mir hier der Mix aus Scala-, Java-, XML- und diversen Config-Files Probleme.
m@42054
   405
m@42054
   406
Bis jetzt hatte ich eigentlich noch nicht wirklich mit der Programmierung des Plugins begonnen doch es waren schon zig Arbeitsstunden rein f\"{u}r Einarbeitungs- und Vorbereitungsaufgaben verstrichen - wieder eine neue Erfahrung f\"{u}r mich. Nach einigen Test- bzw. Beispielprogrammen um die Sprache Scala etwas kennenzulernen, begann die wohl spannenste Phase im Projektverlauf. Das in Java geschriebene Beispielplugin "Quick-Notepad" wurde in Scala \"{u}bersetzt und etwas abge\"andert. 
m@42054
   407
neuper@42057
   408
Der letzte wirklich bedeutende Schritt war Herstellung der Verbindung zwischen Isabelle-Pure und \sisac. Dieser Punkt ist sehr wichtig, da ohne diese Schnittstelle die Planung des SD-Parser nicht m\"oglich gewesen w\"are. Der letzte Schritt, also die Implementation des SD-Parsers wurde aufgeschoben, da es derzeit seitens des Isabelle-Teams ebenfalls Bestrebungen gibt, einen neuen Scala-Parser zu designen und wir von diesen Erkenntnissen mit Sicherheit in der Zunkft profitieren k\"onnen.
m@42054
   409
neuper@42057
   410
%Abschlie{\ss}end m\"ochte ich mich bei meinem Betreuer Herrn Walther Neuper sehr herzlich f\"{u}r die gute Betreuung und die spannenden Entwicklungsstuden bedanken. Es war eine sehr lehrreiche und interessante Projektarbeit!
m@42054
   411
m@42054
   412
%\chapter{Milestones und Arbeitsprotokolle}
m@42054
   413
%\section{Inhaltliche Voraussetzungen erarbeitet: beendet am 27.09.2010} 
m@42054
   414
%\begin{itemize}
m@42054
   415
%\item Kenntnis der Grundlagen und Anwendung von CTP: beendet am 03.08.2010 
m@42054
   416
%\item Charakteristika der Programmsprache Scala: beendet am 27.09.2010
m@42054
   417
%\item Scala Actors: beendet am 12.08.2010
m@42054
   418
%\end{itemize}
m@42054
   419
%\begin{tabular}{|p{2cm}|p{8cm}|p{2cm}|}
m@42054
   420
%\hline
m@42054
   421
%Datum & T\"atigkeit & Einheiten \\ \hline
m@42054
   422
%12.07.2010 & Meeting: erste Besprechung und Erkl\"{a}rungen zu Isabelle, Isac und CTPs & 2 \\ \hline
m@42054
   423
%15.07.2010 & Recherche \"{u}ber Isabelle und CTPs & 3 \\ \hline
m@42054
   424
%20.07.2010 & Meeting: Besprechen der grunds\"{a}tzlichen Vorgangsweise und Ziele & 1 \\ \hline
m@42054
   425
%23.07.2010 & Isabelle: Ziele, Techniken (ML) und Zusammenh\"{a}nge mit Isac abkl\"{a}ren & 1 \\ \hline 
m@42054
   426
%30.07.2010 & Ende der Einarbeitungstage: weitere Vorgensweise \"{u}ber Backs 'structured derivations'; Begriffserkl\"{a}rung & 3 \\ \hline
m@42054
   427
%01.08.2010 & Recherche: Buch f\"{u}r Scala & 2 \\ \hline
m@42054
   428
%03.08.2010 & Isabelle bestehende Technologie studieren & 4 \\ \hline
m@42054
   429
%05.08.2010 & Einarbeiten in Scala: Unterschiede zu Java indentifizieren & 1  \\ \hline
m@42054
   430
%06.08.2010 & Einarbeiten in Scala: Unterschiede zu Java indentifizieren, erste Beispielfiles & 4 \\ \hline
m@42054
   431
%08.08.2010 & Einarbeiten in Scala: funktionale Seite von Scala & 2 \\ \hline
m@42054
   432
%09.08.2010 & Einarbeiten in Scala: Testfiles mit Scala-Swing & 5 \\ \hline
m@42054
   433
%12.08.2010 & Studieren von Papers zu Scala Actors & 3 \\ \hline
m@42054
   434
%24.09.2010 & Scala: Arbeiten mit Klassen und Schnittstellen & 3 \\ \hline
m@42054
   435
%25.09.2010 & Scala: Experimente mit Java in Scala-Source & 6 \\ \hline
m@42054
   436
%27.09.2010 & Scala: Testfiles zu "Funktional vs Imperativ" & 4 \\ \hline \hline
m@42054
   437
% & Anzahl der Einheiten & 44 \\
m@42054
   438
%\hline
m@42054
   439
%\end{tabular}
m@42054
   440
%
m@42054
   441
%
m@42054
   442
%\section{Technische Voraussetzungen hergestellt: beendet am 02.08.2010}
m@42054
   443
%\begin{itemize}
m@42054
   444
%\item Isabelle installiert, Filestruktur bekannt: beendet am 02.08.2010
m@42054
   445
%\item Scala in NetBeans eingebunden: beendet am 22.07.2010
m@42054
   446
%\item Mercurial installiert und einrichten des Repositories: beendet am 19.07.2010 
m@42054
   447
%\end{itemize}
m@42054
   448
%\begin{tabular}{|p{2cm}|p{8cm}|p{2cm}|}
m@42054
   449
%\hline
m@42054
   450
%Datum & T\"atigkeit & Einheiten \\ \hline
m@42054
   451
%19.07.2010 & Beginn der Installationsarbeiten: Repo klonen und testen & 6 \\ \hline
m@42054
   452
%20.07.2010 & Installationsarbeiten, Einarbeiten in Filestruktur & 7 \\ \hline
m@42054
   453
%21.07.2010 & Einarbeiten in Filestruktur & 6 \\ \hline
m@42054
   454
%22.07.2010 & Vorbereitungen: NetBeans, JDK und Scala installieren. Scala in NetBeans integrieren & 8 \\ \hline
m@42054
   455
%23.07.2010 & Isabelle-jEdit-Plugin mittels NetBeans ausf\"{u}hren: testen & 5 \\ \hline 
m@42054
   456
%27.07.2010 & Isabelle-jEdit-Plugin: \"{a}nderungen an der Projektstruktur & 7 \\ \hline
m@42054
   457
%28.07.2010 & Experimente mit Isabelle-jEdit-Plugin & 6 \\ \hline
m@42054
   458
%29.07.2010 & Identifikations der Parse-Einstiegsstelle & 5 \\ \hline
m@42054
   459
%30.07.2010 & Experimente mit Isabelle-jEdit-Plugin, Besprechung \"{u}ber Erfahrungen mit Filestruktur & 4 \\ \hline
m@42054
   460
%02.08.2010 & Installationen und einrichten des Repos auf meinen Laptop & 6 \\ \hline \hline
m@42054
   461
% & Anzahl der Einheiten & 60 \\
m@42054
   462
%\hline
m@42054
   463
%\end{tabular}
m@42054
   464
%
m@42054
   465
%\section{NetBeans-Projekt aufgesetzt: beendet am 02.08.2010} 
m@42054
   466
%\begin{itemize}
m@42054
   467
%\item Grundlegende Projektstruktur f\"ur ISAC hergestellt: beendet am 02.08.2010
m@42054
   468
%\item jEdit-Plugin: XML-Files f\"{u}r ISAC vorbereitet: beendet am 22.07.2010
m@42054
   469
%\item jEdit-Plugin: Source files geschrieben: beendet am 19.07.2010 
m@42054
   470
%\end{itemize}
m@42054
   471
%\begin{tabular}{|p{2cm}|p{8cm}|p{2cm}|}
m@42054
   472
%\hline
m@42054
   473
%Datum & T\"atigkeit & Einheiten \\ \hline
m@42054
   474
%10.08.2010 & Projektstruktur anlegen, build.xml anpassen & 7 \\ \hline
m@42054
   475
%11.08.2010 & jEdit-Plugin-Struktur studieren: Howto durcharbeiten & 5 \\ \hline
m@42054
   476
%21.08.2010 & bestehende jEdit-Plugins (Java) durcharbeiten & 3 \\ \hline
m@42054
   477
%22.08.2010 & Kopieren des Isabelle-jEdit-Plugins, Umarbeiten f\"{u}r ISAC & 3 \\ \hline
m@42054
   478
%24.08.2010 & Umarbeiten des Isabelle-Plugins f\"{u}r ISAC & 6 \\ \hline 
m@42054
   479
%26.08.2010 & Problem mit Isabelle-Umgebungsvariable: Suche nach L\"{o}sungen & 3 \\ \hline
m@42054
   480
%28.08.2010 & Recherchen zum Umgebungsvariable-Problem, Arbeiten mit den Isabelle-Shell-Skripts & 2 \\ \hline
m@42054
   481
%29.08.2010 & Experimente mit den Path-Varialbe der jvm & 3 \\ \hline
m@42054
   482
%30.08.2010 & Isabelle-jEdit-Plugin endlich vollst\"{a}ndig lauff\"{a}hig gebracht & 4 \\ \hline
m@42054
   483
%01.09.2010 & Arbeiten an der jEdit-ISAC-Projektstruktur & 3 \\ \hline
m@42054
   484
%04.09.2010 & Umarbeiten des Isabelle-Plugins f\"{u}r ISAC & 5 \\ \hline 
m@42054
   485
%20.09.2010 & Einrichten des Laptops f\"{u}r Isabelle-Isac & 4 \\ \hline 
m@42054
   486
%22.09.2010 & Meeting: Fortschrittsbericht, kurze Einf\"{u}hrung f\"{u}r Mitstreiter & 3 \\ \hline
m@42054
   487
%
m@42054
   488
%29.09.2010 & Neue Vorgehensweise: QuickNotepad-Plugin(QN) wird in Scala \"{u}bersetzt und f\"{u}r ISAC entsprechend angepasst: Arbeit an den XML-Files & 4 \\ \hline 
m@42054
   489
%30.09.2010 & QN: Start mit \"{u}bersetzten der Sourcefiles & 5 \\ \hline
m@42054
   490
%02.10.2010 & QN: \"{U}bersetzten der Sourcefiles & 6 \\ \hline
m@42054
   491
%04.10.2010 & QN: \"{U}bersetzten der Sourcefiles: Problem bei Interface & 3 \\ \hline
m@42054
   492
%05.10.2010 & QN: QN vollst\"andig in Scala \"{u}bersetzt, testen & 2 \\ \hline \hline
m@42054
   493
% & Anzahl der Einheiten & 71 \\
m@42054
   494
%\hline
m@42054
   495
%\end{tabular}
m@42054
   496
%
m@42054
   497
%\section{Experimentelle Parser implementiert: beendet am 04.03.2011} 
m@42054
   498
%\begin{itemize}
m@42054
   499
%\item Experimente mit dem SideKick-Parser abgeschlossen: beendet am 03.02.2011
m@42054
   500
%\item Verbindung zu Isabelle-Pure hergestellt: beendet am 04.03.2011
m@42054
   501
%\item Implementierung des Scala-Parsers: aufgeschoben
m@42054
   502
%\end{itemize}
m@42054
   503
%\begin{tabular}{|p{2cm}|p{8cm}|p{2cm}|}
m@42054
   504
%\hline
m@42054
   505
%Datum & T\"atigkeit & Einheiten \\ \hline
m@42054
   506
%28.01.2011 & Testen des SideKick-Parsers im Isabelle-Plugin & 2 \\ \hline
m@42054
   507
%29.01.2011 & Leichte Modifikationen des SideKick-Parsers im Isabelle-Plugin & 1 \\ \hline
m@42054
   508
%08.02.2011 & Besprechung zum Abschluss der praktischen Arbeiten & 1 \\ \hline
m@42054
   509
%16.02.2011 & Erstellen des Isabelle-Pur jar-Files & 1 \\ \hline
m@42054
   510
%19.02.2011 & Behebung des Problems mit den Umgebungsvariablen & 1 \\ \hline
m@42054
   511
%03.03.2011 & Erzeugung des Pure.jar Package m\"{o}glich & 2 \\ \hline
m@42054
   512
%04.04.2011 & Verbindung zwischen Plugin und Isabelle-Pure hergestellt und getestet  & 3 \\ \hline
m@42054
   513
%08.04.2011 & Besprechung: Implementierung des experimentellen Parsers wird nicht mehr durchgef\"{u}hrt & 1 \\ \hline \hline
m@42054
   514
% & Anzahl der Einheiten & 12 \\
m@42054
   515
%\hline
m@42054
   516
%\end{tabular}
m@42054
   517
%
m@42054
   518
%\section{Verfassen der Dokumentation und abschliesende Arbeiten: beendet am TO.DO.2011}
m@42054
   519
%\begin{itemize}
m@42054
   520
%\item Bacc.-Protokoll fertiggestellt: beendet am 01.03.2011
m@42054
   521
%\item Dokumentation: erste Version fertiggestellt: beendet am 28.04.2011
m@42054
   522
%\item Dokumentation abgeschlossen: beendet am TO.DO.2011 
m@42054
   523
%\end{itemize}
m@42054
   524
%\begin{tabular}{|p{2cm}|p{8cm}|p{2cm}|}
m@42054
   525
%\hline
m@42054
   526
%Datum & T\"atigkeit & Einheiten \\ \hline
m@42054
   527
%01.03.2011 & Besprechung zum Ablauf der Dokumentationsarbeiten: Protokoll und Dokumentation & 1 \\ \hline
m@42054
   528
%01.03.2011 & Erstellen des Protokolls & 2 \\ \hline
m@42054
   529
%08.03.2011 & Besprechung zur Doku und zur Schnittstelle zu Isabelle-Pure & 1 \\ \hline
m@42054
   530
%17.03.2011 & Dokumentation schreiben & 2 \\ \hline
m@42054
   531
%19.03.2011 & Dokumentation schreiben & 3 \\ \hline
m@42054
   532
%24.04.2011 & Dokumentation schreiben & 2 \\ \hline
m@42054
   533
%25.04.2011 & Dokumentation schreiben & 4 \\ \hline
m@42054
   534
%27.04.2011 & Dokumentation schreiben & 2 \\ \hline
m@42054
   535
%28.04.2011 & Dokumentation: Fertigstellen der ersten Version & 3 \\ \hline \hline
m@42054
   536
% & Anzahl der Einheiten & 20 \\
m@42054
   537
%\hline
m@42054
   538
%\end{tabular}
m@42054
   539
%
m@42054
   540
%\section{Pr\"asentation der Arbeit im IST-Seminar }% am ..(*)...}