1.1 --- a/src/Doc/isac/msteger/bakk-arbeit/content.tex Mon Sep 16 12:27:20 2013 +0200
1.2 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000
1.3 @@ -1,607 +0,0 @@
1.4 -\chapter{Definition der Aufgabenstellung}
1.5 -\section{Detaillierte Beschreibung der Aufgabenstellung}
1.6 -Zu Beginn des Projekts wurden einige Vorgaben und Ziele des Projektes erarbeitet und im Laufe des Projekts angepasst wo notwendig. Es wurde bewusst auf eine zu einschr\"ankende Aufgabenstellung verzichtet, da Entwicklungen und Erarbeitungen von verschiedenen Umsetzungsstrategien erw\"unscht war.
1.7 -
1.8 -Hauptaugenmerk war dabei auf die Erstellung eines jEdit-Plugins gelegt worden, das als Vorarbeit zu Back's Structured Derivations dienen soll. Mit anderen Worten, es sollte so viel Plugin-Code, wie im begrenzten Projektzeitraum m\"oglich, implementiert werden.
1.9 -
1.10 -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.
1.11 -Die nachfolgende Auflistung soll die wichtigsten Tasks nochmals zusammenfassen:
1.12 -\begin{enumerate}
1.13 -\item Relevante Isabelle Komponenten identifizieren und studieren
1.14 -\item Installation der Standard-Komponenten
1.15 -\item Entwicklungsumgebung vom Isabelle-Team kopieren
1.16 -\item Relevante Komponenten implementieren
1.17 -\begin{itemize}
1.18 -\item jEdit Plugin f\"ur SD
1.19 -\item zugeh\"origen Parser
1.20 -\item nicht vorgesehen: SD-Interpreter in Isar (SML)
1.21 -\end{itemize}
1.22 -\end{enumerate}
1.23 -In Abs.\ref{zusammenfassung} wird r\"uckblickend zusammengefasst, welche dieser Punkte in welchem Ausma\ss{} in dieser Bachelor-Arbeit erledigt wurden.
1.24 -
1.25 -\chapter{Beleuchtung der Projekt-relevanten Technologien}
1.26 -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.
1.27 -\section{Back's Structured Derivations}
1.28 -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.
1.29 -
1.30 -Das nachfolgende Beispiel zeigt ein einfaches Beispiel, wie eine Formel mittels SD dargestellt bzw. umgeformt werden kann:
1.31 -
1.32 -%{\footnotesize
1.33 -\begin{tabbing}
1.34 -123,\=1234\=1234\=1234\=1234\=1234\=1234\=123\=\kill
1.35 -\>$\bullet$\>Simplify $(1 - x) * (x ^ 2 + 1) + x ^ 3 - x ^ 2$\\
1.36 -\> \>$(1 - x) * (x ^ 2 + 1) + x ^ 3 - x ^ 2$\\
1.37 -\>$\equiv$\>$\{ {\it RewriteSet}\;{\it purify}\}$\\
1.38 -\> \>$(1 + -1 * x) * (x ^ 2 + 1) + x ^ 3 + -1 * x ^ 2$\\
1.39 -\>$\equiv$\>$\{{\it RewriteSet}\;{\it simplify\_pure}\}$\\
1.40 -\> \>$\bullet$\>$(1 + -1 * x) * (x ^ 2 + 1) + x ^ 3 + -1 * x ^ 2$\\
1.41 -\> \>$\equiv$\>$\{{\it RewriteSet}\;{\it expand\_poly\_}\}$ \\
1.42 -\> \> \>$1 * x ^ 2 + 1 * 1 + (-1 * x * x ^ 2 + -1 * x * 1) + x ^ 3 +-1 * x ^ 2$\\
1.43 -\> \>$\equiv$\>\vdots\\
1.44 -\> \> \>$1 + -1 * x + 0 * x ^ 2 + 0 * x ^ 3$\\
1.45 -\> \>$\equiv$\>$\{{\it RewriteSet}\;{\it reduce\_012\_}\}$ \\
1.46 -\> \> \>$1 + -1 * x$\\
1.47 -\>\dots\>$1 + -1 * x$\\
1.48 -\>$\equiv$\>$\{{\it RewriteSet}\;{\it beautify}\}$\\
1.49 -\> \>$1-x$
1.50 -\end{tabbing}
1.51 -%}
1.52 -
1.53 -Dieses Beispiel kann wie folgt interpretiert werden:
1.54 -\begin{enumerate}
1.55 -\item Die erste Zeile ist als Angabe bzw. Ausgangspunkt der Berechnung zu verstehen.
1.56 -\item Nun folgt der eigentliche Ablauf einer Umformung mittels SD: Mit der Formel in der zweiten Zeile beginnt die Berechnung.
1.57 -\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.
1.58 -\item Aus dieser Rechenvorschrift ergibt sich die Formel in der n\"achsten Zeile.
1.59 -\item Dieser Ablauf wiederholt sich und zieht sich \"uber die weiteren Berechnungen.
1.60 -\end{enumerate}
1.61 -
1.62 -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.
1.63 -
1.64 -\section{Der Texteditor jEdit}\label{jEdit}
1.65 -% http://www.jedit.org/
1.66 -% http://de.wikipedia.org/wiki/JEdit
1.67 -% http://www.chip.de/downloads/jEdit_19235021.html
1.68 -%
1.69 -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.
1.70 -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.
1.71 -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.
1.72 -
1.73 -\subsection{Das Plugin-System}
1.74 -% http://jedit.org/users-guide/writing-plugins-part.html
1.75 -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.
1.76 -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.
1.77 -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.
1.78 -
1.79 -
1.80 -\subsection{Pluginstruktur}
1.81 -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.
1.82 -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.
1.83 -
1.84 -\section{Isabelle}
1.85 -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.
1.86 -
1.87 -\subsection{Isabelle-Pure}
1.88 -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.
1.89 -Eine Auflistung der f\"ur das Isabelle-Pure-Packet ben\"otigten Scala-Source-Filles kann Anhang B.2 entnommen werden.
1.90 -
1.91 -\subsection{Isabelle-jEdit}
1.92 -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.
1.93 -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.
1.94 -
1.95 -\subsection{Paketstruktur von Isabelle}
1.96 -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.
1.97 -Die nachfolgende Auflistung zeigt alle Pakete, die f\"{u}r SD bzw. {\sisac} von Bedeutung sind und und wo diese zu finden sind.
1.98 -
1.99 -
1.100 -\begin{itemize}
1.101 -\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.
1.102 -\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.
1.103 -\item \textit{src/Tools/jEdit/dist/jars:} \textbf{Isabelle-jEdit.jar, Pure.jar, SideKick.jar, jedit.jar, ...}
1.104 -\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.
1.105 -\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.
1.106 -\end{itemize}
1.107 -
1.108 -Siehe dazu auch Anhang B. Dort sind alle relevanten jar-Pakete noch einmal aufgelistet und entsprechend gruppiert.
1.109 -
1.110 -\section{Die Programmiersprache Scala}
1.111 -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.
1.112 -
1.113 -\subsection{Grundlage der Sprache}
1.114 -Scala \cite{odersky:scala06} 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 \cite{pl:milner97} ab. Dies, und vorallem auch das von Erlang \cite{armstrong:erlang96} \"ubernommene und sehr gut umgesetzte Actorprinzip \cite{Haller:2009:SAU:1496391.1496422,scala:jmlc06}, 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.
1.115 -
1.116 -Dieser direkte Zusammenhang zwischen Java und Scala soll anhand der Grafik-Bibliotheken Swing gezeigt bzw. die Vorteile, die daraus resultieren, beleuchtet werden.
1.117 -
1.118 -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.
1.119 -
1.120 -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.
1.121 -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.
1.122 -
1.123 -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.
1.124 -
1.125 -\subsection{Scala, Java und jEdit}
1.126 -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!
1.127 -
1.128 -\subsection{Der Isabelle-Scala-Layer}
1.129 -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.
1.130 -
1.131 -In diesem Absatz sollen nun die Eigenschaften des Scala-Layers und die damit verbundenen Chancen f\"ur das Isac- bzw. SD-Projektes
1.132 -erarbeitet werden.
1.133 -
1.134 -\begin{figure}
1.135 -\begin{center}
1.136 -\includegraphics[width=100mm]{../fig-reuse-ml-scala-SD.png}
1.137 -\end{center}
1.138 -\label{fig-reuse-ml-scala}
1.139 -\caption{Der Scala-Layer zwischen Java und SML}
1.140 -\end{figure}
1.141 -
1.142 -Wie %Fig.\ref{fig-reuse-ml-scala} WARUM GEHT DAS NICHT ???
1.143 -Fig.3.1
1.144 -zeigt, verbindet der Scala-Layer 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.
1.145 -
1.146 -\chapter{Konfiguration und Implementation der Komponenten}
1.147 -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 \ref{files-SD-plugin} entnommen werden.
1.148 -
1.149 -\section{Konfiguration des Netbeans- (NB-) Projektes}
1.150 -Um in k\"unftigen Entwicklungsvorhaben effizient kooperieren zu k\"onnen, wurde das NB-Projekt genau nach den Vorgaben des Isabelle-Teams konfiguriert. Voraussetzung f\"ur die Konfiguration sind die Files aus dem Repository laut Anhang \ref{files-SD-plugin}. Die Konfiguration des NB-Projektes ``testSD-jedit'' erfolgt in folgenden Schritten:
1.151 -
1.152 -\begin{enumerate}
1.153 -\item Softwarekomponenten aus dem Isabelle\_bundle checken; diese sind alle im Verzeichnis {\tt contrib}:
1.154 - \begin{enumerate}
1.155 - \item {\tt contrib/scala-\dots} Scala-Compiler und Runtime-System
1.156 - \item {\tt contrib/scala-\dots} jEdit
1.157 - \item {\tt src/Tools/jEditC} der Code f\"ur das Test-Plugin
1.158 - \end{enumerate}
1.159 -\item Konfigurations-Files von Netbeans im ``Files''-View checken; Achtung: die Files beeinflussen sich gegenseitig, direkte Eingriffe sind problematisch:
1.160 -\begin{enumerate}
1.161 -\item {\tt build.xml} wurde direkt aus dem Template in {\tt src/Tools/jEdit/} erzeugt; von hier nimmt NB die Daten um Daten in (Teilen von den) anderen Konfigurations-Files zu \"andern; NB nimmt hier keine automatischen Ver\"anderungen vor.
1.162 -\item {\tt nbproject/build-impl.xml} z.T. automatisch erzeugt aus {\tt build.xml} und z.T. untenstehenden Files
1.163 -\item {\tt nbproject/genfiles.properties}
1.164 -\item {\tt nbproject/project.properties}, z.B. Projekt-Name
1.165 -\item {\tt nbproject/project.xml}
1.166 -\end{enumerate}
1.167 -\item Sacla-plugin installieren laut {\tt http://wiki.netbeans.org/Scala69},
1.168 -\begin{enumerate}
1.169 -\item insbesonders siehe ``Install with NetBeans 6.9''
1.170 -\item nach {\tt /usr/local/netbeans.../plugins/scala/} kopieren
1.171 -\end{enumerate}
1.172 -\item Scala-plugin in NB installieren
1.173 -\begin{enumerate}
1.174 -\item Men\"u $>$ Tools $>$ Plugins $>$ Downloaded $>$ Add Plugins
1.175 -\item alle Files von {\tt /usr/local/netbeans\dots/plugins/scala/} ausw\"ahlen
1.176 -\item Fenster in ``Add Plugins'' zeigt alle ausgew\"alten Files
1.177 -\item $<$Install$>$ ruft den Wizzard auf, $<$Next$>$ erzeugt i.A. ein ``Warning'' das zu \"ubergehen ist
1.178 -\item Funktionstest: Men\"ue $>$ Files $>$ New Project: zeigt Scala als ``Categories''
1.179 -\end{enumerate}
1.180 -\item Neues Projekt ``testSD-jedit'' konfigurieren
1.181 -\begin{enumerate}
1.182 -\item Men\"u $>$ Open Project (weil schon aus dem Repository die notwendigen Files vorhanden sind)
1.183 -\item /src/Tools/jeditC: Reference Problems, weil jEdit die Plugins von \ref{plugins} braucht
1.184 -\item Funktionskontrolle: ``Projects''-View zeigt das neue Projekt.\\
1.185 - Die Konfigurations-Files sind v\"ollig getrennt von denen anderer Projekte~!
1.186 -\item\label{reference-pbl} Referenz-Probleme beheben; das zeigt auch eventuell fehlende Files:
1.187 -\begin{enumerate}
1.188 -\item ``Projects''-View $>$ rightMouse $>$ Resolve Reference Problems: Fenster zeigt dieListe der fehlenden Dateien; $<$Next$>$
1.189 -\item Files holen aus ``Tools'' $>$ Libraries: \"uber Filebrowser aus dem Isabelle\_bundle holen {\tt contrib/jedit-4.3.2\_Isabelle-6d736d983d5c/jars}
1.190 -\item\label{plugins} ``New Library''
1.191 -\begin{enumerate}
1.192 -\item Cobra-renderer: cobra.jar
1.193 -\item Console: Console.jar
1.194 -\item ErrorList: ErrorList.jar
1.195 -\item Hyperlinks: Hyperlinks.jar
1.196 -\item Isabelle-Pure: Pure.jar
1.197 -\item Rhino-JavaScript: js.jar
1.198 -\item Scala-compiler: scala-compiler.jar
1.199 -\item SideKick: SideKick.jar
1.200 -\end{enumerate}
1.201 -\item Funktions-Kontrollen
1.202 -\begin{enumerate}
1.203 -\item das kleine gelbe Warndreieck im ``Projects''-View ist verschwunden
1.204 -\item im ``Projects''-View sind nun 2 Ordner: {\tt src} und {\tt Libraries}
1.205 -\end{enumerate}
1.206 -\end{enumerate}
1.207 -\item jEdit-Paket zum ``testSD-jedit''-Projekt hinzuf\"ugen
1.208 -\begin{enumerate}
1.209 -\item ``Project''-View $>$ rightMouse $>$ Add Jar/Folder: Filebrowser
1.210 -\item /contrib/jedit.../jedit.jar
1.211 -\item Funktions-Kontrolle: ist in ``Projects''/Libraries/jedit.jar
1.212 -\end{enumerate}
1.213 -\item Das neue Projekt ``testSD-jedit'' zum Hauptprojekt machen: ``Project''-View $>$ rightMouse $>$ Set as Main Project; Funktions-Kontrolle: der Projektname ist boldface.
1.214 -\end{enumerate}
1.215 -\item den neuen Isabelle/Scala-Layer ({\tt Pure.jar}) erzeugen mit {\tt bin/testSD}; siehe Pkt.\ref{build-isa-scala} unten.
1.216 -\end{enumerate}
1.217 -
1.218 -\noindent Ab nun wird die Konfiguration \"uber ``trial and error'' zu Ende gef\"uhrt; die unten angef\"uhrten Fehler entstanden durch Umbenennung des Projektes von ``isac-jedit'' auf ``testSD-jedit'' w\"ahrend der oben beschriebenen Installation.
1.219 -\begin{enumerate}
1.220 -\item Build des Plugins schl\"agt fehl: Men\"u $>$ Build Main
1.221 - \begin{enumerate}
1.222 - \item Fehler: {\it Target ``Isac-impl.jar'' does not exist in the project ``testSD-jedit''. It is used from target ``debug''}
1.223 - \begin{enumerate}
1.224 - \item\label{restart-NB} Versuch
1.225 - \begin{itemize}
1.226 - \item {\tt build-impl.xml} l\"oschen
1.227 - \item NetBeans neu starten, stellt build-impl.xml automatisch aus build.xml wieder her
1.228 - \item \dots hat in diesem Fall nicht geholfen
1.229 - \end{itemize}
1.230 - \item Versuch zur Vermutung: Projekt wurde umbenannt von ``Isac'' in ``testSD-jedit'', entsprechende Eintr\"age in den Konfigurations-Dateien wurden automatisch richtig ersetzt, aber nicht in {\tt build.xml}
1.231 - \begin{itemize}
1.232 - \item in {\tt build.xml} query-replace ``isac-jedit'' in ``testSD-jedit''
1.233 - \end{itemize}
1.234 - \end{enumerate}
1.235 - \item Fehler: {\it Problem: failed to create task or type scalac}
1.236 - \begin{enumerate}
1.237 - \item Versuch: Pfad zum Scala bekanntgeben
1.238 - \begin{itemize}
1.239 - \item {\tt /usr/local/netbeans-6.9.1/etc/netbeans.conf}: netbeans\_default\_options= \dots richtigen Scala-Pfad setzen
1.240 - \item build-impl.xml l\"oschen
1.241 - \item NetBeans neu starten (siehe \ref{restart-NB}).
1.242 - \end{itemize}
1.243 - \end{enumerate}
1.244 - \item Wenn Fehler: {\it /usr/local/isabisac/src/Tools/jEditC/\${project.jEdit}/modes does not exist}
1.245 - \begin{enumerate}
1.246 - \item grep -r "project.jEdit" *
1.247 - \item {\tt nbproject/project.properties}: project.jEdit=contrib/jEdit
1.248 - \end{enumerate}
1.249 - \end{enumerate}%??indent
1.250 -\item Fehlersuche in den Project Files, nicht in {\tt build.xml}:\\
1.251 -{\it src/Tools/jEditC/src/testSD.scala:225: error: value Isac is not a member of package isabelle}
1.252 - \begin{enumerate}
1.253 - \item den Link zu {\tt testSD.scala:22} folgen
1.254 - \item\label{build-intermed} als Zwischenschritt eine noch nicht erzeugte Class ``Isac'' auskommentieren; siehe Pkt.\ref{build-intermed-end} unten\\
1.255 -val str1: String = isabelle.Isac.parse(``Testdaten aus dem Parser!'')\\
1.256 - val str1: String = ``TEST'' //isabelle.Isac.parse(``Testdaten aus dem Parser!'')
1.257 - \item nochmals Men\"u $>$ Build (Hammer) \dots successful (wegen auskommentierter Zeile)
1.258 - \item in der Konsole beobachten, welche Files kopiert werden und vergleichen mit {\tt build.xml}, z.B.
1.259 - $<$target name=''-pre-jar''$>$
1.260 - $<$target name=''-post-jar''$>$
1.261 - \item {\tt bin/testSD} ausf\"uhren \dots
1.262 - \item =dots stellt den entscheidender Schritt dar: ein neues {\tt Pure.jar} wurde erzeugt; dieses ist nun erweitert mit einer class {\tt Isac}; diese Klasse wurde erzeugt durch Code in \\{\tt scr/Pure/Isac/isac.scala}
1.263 - \item\label{build-intermed-end} den Zwischenschritt Pkt.\ref{build-intermed} oben r\"uckg\"angig machen:\\
1.264 - ``val str1: String = isabelle.Isac.parse(``Testdaten aus dem Parser!'')".\\
1.265 - Dieser Befehl braucht das {\em neue} {\tt Pure.jar} am richtigen Platz \dots
1.266 - \item \dots das Shellscript {\tt bin/testSD\_jedit} erzeugt dieses {\tt Pure.jar}
1.267 - \end{enumerate}
1.268 -\item\label{build-isa-scala} Fehler beim Exekutieren von {\tt bin/testSD}
1.269 - \begin{enumerate}
1.270 - \item einfach auf die ``error messages'' schauen, eg. {\it src/Pure/: no such file or directory} \dots
1.271 - \item \dots hei\ss t, dass das Skript nicht vom richtigen Pfad {\tt \~{\,}\~{\,}} gestartet wurde --- dieses Skript sollte also verbessert werden.
1.272 - \item Funktionstest: \\
1.273 - \#\#\#\\
1.274 - \#\#\# Building Isabelle/Scala layer\\
1.275 - \#\#\#
1.276 - \end{enumerate}
1.277 -\item Fehlermeldung beim Starten des Plugins aus NB, die \"ubergehen sind:
1.278 -\begin{verbatim}
1.279 -/home/neuper/.jedit/jars/Console.jar:
1.280 -Two copies installed. Please remove one of the two copies.
1.281 -/home/neuper/.jedit/jars/Hyperlinks.jar:
1.282 -Two copies installed. Please remove one of the two copies.
1.283 -/home/neuper/.jedit/jars/SideKick.jar:
1.284 -Two copies installed. Please remove one of the two copies.
1.285 -/home/neuper/.jedit/jars/ErrorList.jar:
1.286 -Two copies installed. Please remove one of the two copies.
1.287 -\end{verbatim}
1.288 -Fehler zu beseitigen mit {\tt rm -r \~/jedit/jars}
1.289 -\item \textit{Referenzproblem} auf {\tt Pure.jar}: siehe Pkt.\ref{reference-pbl} auf S.\pageref{reference-pbl}.
1.290 -
1.291 -%$<$ $>$
1.292 -%Men\"u $>$ $>$ $>$ $>$ $>$ $>$
1.293 -%``Project''-View $>$ rightMouse $>$ $>$ $>$ $>$ $>$
1.294 -%\item
1.295 -% \begin{enumerate}
1.296 -% \item
1.297 -% \begin{enumerate}
1.298 -% \item
1.299 -% \begin{itemize}
1.300 -% \item
1.301 -% \begin{itemize}
1.302 -% \item
1.303 -% \item
1.304 -% \item
1.305 -% \end{itemize}
1.306 -% \item
1.307 -% \item
1.308 -% \end{itemize}
1.309 -% \item
1.310 -% \item
1.311 -% \end{enumerate}
1.312 -%\item
1.313 -%\item
1.314 -%\end{enumerate}
1.315 -%\item
1.316 -%\begin{enumerate}
1.317 -%\item
1.318 -%\begin{enumerate}
1.319 -%\item
1.320 -%\begin{itemize}
1.321 -%\item
1.322 -%\begin{itemize}
1.323 -%\item
1.324 -%\item
1.325 -%\item
1.326 -%\end{itemize}
1.327 -%\item
1.328 -%\item
1.329 -%\end{itemize}
1.330 -%\item
1.331 -%\item
1.332 -%\end{enumerate}
1.333 -%\item
1.334 -%\item
1.335 -%\end{enumerate}
1.336 -\end{enumerate}
1.337 -
1.338 -
1.339 -\section{Implementation der jEdit Komponenten}
1.340 -
1.341 -\subsection{Erstellen des Plugin-Ger\"{u}sts}
1.342 -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.
1.343 -
1.344 -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.
1.345 -
1.346 -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.
1.347 -
1.348 -\subsection{Erzeugung des Plugins}
1.349 -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):
1.350 -\begin{enumerate}
1.351 -\item Das Plugin kann mittels Kommandline folgenderma{\ss}en erstellt werden: \\ \textit{cd ISABELLE\_HOME/src/Tools/isac/jEdit} $\rightarrow$ \textit{ant jar}
1.352 -\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/}
1.353 -\item jEdit ausf\"{u}hren und testen
1.354 -\end{enumerate}
1.355 -
1.356 -\subsection{Verbindung zum Isabelle-Pure Plugin herstellen}
1.357 -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, {\tt Pure.jar}, weitergegeben werden. Dort k\"{o}nnen die Daten verwertet und aufbereitet zur\"{u}ck an das Frontend gereicht werden.
1.358 -
1.359 -\begin{figure}
1.360 -\begin{center}
1.361 -\includegraphics[width=100mm]{../fig-jedit-plugins-SD.png}
1.362 -\end{center}
1.363 -\label{fig-jedit-plugins-SD}
1.364 -\caption{jEdit Plugins und die Verbindung zu Isabelle}
1.365 -\end{figure}
1.366 -
1.367 -%Fig.\ref{fig-jedit-plugins-SD} WARUM GEHT DAS NICHT ???
1.368 -Fig.4.1 zeigt die involvierten Komponenten und ihren Zusammenhang.
1.369 -
1.370 -Der Zusammenhang zwischen dem Kern von Isabelle, Isabelle-Pure und dem Plugin wird folgenderma\ss en hergestellt: Zun\"{a}chst wird {\tt Pure.jar} leicht modifiziert, danach neu erstellt und zuletzt zu den restlichen jEdit-Plugins hinzugef\"{u}gt. 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.
1.371 -
1.372 -
1.373 -\begin{enumerate}
1.374 -\item Um den \sisac-Teil im Isabelle-Pure genau abzugrenzen, wurde ein Ordner \textit{Isac} angelegt und ein Testfile \textit{isac.scala} erstellt.
1.375 -\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.
1.376 -\item Nun kann Pure.jar mittels Kommandline erstellt werden: \textit{cd /src/Pure} $\rightarrow$ \textit{../../bin/isabelle env ./build-jars}
1.377 -\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/}
1.378 -\item jEdit ausf\"{u}hren und testen
1.379 -\end{enumerate}
1.380 -Alle die oben angef\"{u}hrten Punkte, sowie das Erzeugen und Kopieren des Plugins selbst, werden vom Script isac\_jedit erledigt.
1.381 -Das Skript kann dem Anhang C entnommen werden.
1.382 -
1.383 -\section{``Run Configurations''}
1.384 -Zwischen Isabelle2009-2 und Isabelle2011 hat sich viel ge\"andert. Jetzt mit Isabelle2011 sieht es folgenderma\ss en aus:
1.385 -
1.386 -Am Anfang der Plugin-Entwicklung wird man versuchen, ohne eine Verbindung zu Isabelle auszukommen; in sp\"ateren Phase wird man genau diese Verbindung brauchen. Starten eines Plugins in NB mit gleichzeitigem Hochfahren von Isabelle ist schwierig.
1.387 -
1.388 -Folgende M\"oglichkeiten gibt es beim Debuggen:
1.389 -
1.390 -\begin{enumerate}
1.391 -\item Man macht alles in Netbeans. Mit dem -Disabelle.home=... sollte man
1.392 - die Applikation direkt aus der IDE starten und profilen/debuggen
1.393 - k\"onnen. Das war der urspr\"ungliche Plan des ganzen Setups, d.h. der
1.394 - Grund warum er so kompliziert ist.
1.395 -
1.396 -\item Man startet aus der Shell \"uber "isabelle jedit -d" und verbindet
1.397 - dann den Netbeans debugger (oder jeden anderen JVM debugger) \"uber
1.398 - den hier ausgegebenen Port.
1.399 -
1.400 -\item Man startet "isabelle jedit", geht dann in das "Console" Plugin und
1.401 - w\"ahlt dort das "Scala" Sub-Plugin aus. Nach ca. 5s Bedenkzeit steht
1.402 - der interaktive Scala toplevel innerhalb von Isabelle/jEdit zur
1.403 - Verf\"ugung. Nun kann man direkt Dinge auswerten etc. und schauen was
1.404 - passiert.
1.405 -
1.406 - Auf dem Cambridge Workshop 2010, {\tt T06\_System.thy} sind Beispiele zu finden.
1.407 - Siehe subsection Isabelle/Scala. Man aktuviert dazu Isabelle/jEdit
1.408 - mit obigem thy File und kopiert die Scala snippets aus dem Text
1.409 - zeilenweise in das Console/Scala Fenster.
1.410 -
1.411 -\item Man streut einfach {\tt System.err.println} in seinen Code ein.
1.412 -\end{enumerate}
1.413 -Die M\"oglichkeiten (3) oder (4) sind zu bevorzugen.
1.414 -
1.415 -Ferner gibt es einige externe JVM Diagnose-Tools. Zu nennen sind {\tt jvisualvm} oder {\tt jconsole} um threads, heaps, profiles etc. anzuschauen, da sich das alles gerne verheddert.
1.416 -
1.417 -Richtig koordiniertes Hochfahren aller Komponenten braucht ein Shellscript wie {\tt isabelle jedit}.
1.418 -
1.419 -\section{Umsetzung des SD-Parsers}
1.420 -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.
1.421 -
1.422 -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.
1.423 -
1.424 -
1.425 -\chapter{Ausblick: Von SD- zum \isac-Plugin}
1.426 -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.
1.427 -
1.428 -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.
1.429 -
1.430 -\chapter{Zusammenfassung und R\"{u}ckblick}
1.431 -Zusammenfassend wird nun ein \"Uberblick gegeben, welche Milestones erledigt wurden und welche nicht; Details dazu finden sich in Anhang A. %TODO
1.432 -Abschlie{\ss}end gebe ich einen R\"uckblick auf meine pers\"onlichen Erfahrungen aus dieser Bakkalaureats-Arbeit.
1.433 -
1.434 -\section{Zusammenfassung}\label{zusammenfassung}
1.435 -Folgende Milestones wurden erfolgreich abgeschlossen:
1.436 -\begin{enumerate}
1.437 -\item Relevante Isabelle Komponenten dokumentiert
1.438 -
1.439 -\item Installation der Standard-Komponenten:
1.440 -\begin{itemize}
1.441 -\item Mercurial Versioncontrol
1.442 -\item NetBeans IDE
1.443 -\item Standard Isabelle Bundle
1.444 -\end{itemize}
1.445 -
1.446 -\item Entwicklungsumgebung vom Isabelle-Team kopieren
1.447 -\begin{itemize}
1.448 -\item Isabelle-Sources vom Repository M\"unchen (Java, Scala, ML)
1.449 -\item jEdit als NetBeans Projekt definiert
1.450 -\end{itemize}
1.451 -
1.452 -\item Relevante Komponenten implementieren
1.453 -\begin{itemize}
1.454 -\item jEdit Plugin f\"ur SD
1.455 -\item Verbindung des Plugins zu Isabelle
1.456 -\item zugeh\"origen Parser: nur ein Test in SML
1.457 -\end{itemize}
1.458 -\end{enumerate}
1.459 -
1.460 -\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.
1.461 -
1.462 -\paragraph{Voraussetzungen f\"ur k\"unftige Entwicklung} geschaffen:
1.463 -\begin{enumerate}
1.464 -\item f\"ur die Implementation von ``structured derivations'' in Isabelle \dots
1.465 -\item \dots als Vorarbeit f\"ur jEdit als k\"unftiges \isac-Frontend
1.466 -\item f\"ur Mitarbeit an k\"unftiger Integration von Isabelle in Entwicklungswerkzeuge (Testcase-Generation etc).
1.467 -\end{enumerate}
1.468 -
1.469 -\section{R\"uckblick}
1.470 -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.
1.471 -
1.472 -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.
1.473 -
1.474 -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.
1.475 -
1.476 -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.
1.477 -
1.478 -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.
1.479 -
1.480 -%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!
1.481 -
1.482 -%\chapter{Milestones und Arbeitsprotokolle}
1.483 -%\section{Inhaltliche Voraussetzungen erarbeitet: beendet am 27.09.2010}
1.484 -%\begin{itemize}
1.485 -%\item Kenntnis der Grundlagen und Anwendung von CTP: beendet am 03.08.2010
1.486 -%\item Charakteristika der Programmsprache Scala: beendet am 27.09.2010
1.487 -%\item Scala Actors: beendet am 12.08.2010
1.488 -%\end{itemize}
1.489 -%\begin{tabular}{|p{2cm}|p{8cm}|p{2cm}|}
1.490 -%\hline
1.491 -%Datum & T\"atigkeit & Einheiten \\ \hline
1.492 -%12.07.2010 & Meeting: erste Besprechung und Erkl\"{a}rungen zu Isabelle, Isac und CTPs & 2 \\ \hline
1.493 -%15.07.2010 & Recherche \"{u}ber Isabelle und CTPs & 3 \\ \hline
1.494 -%20.07.2010 & Meeting: Besprechen der grunds\"{a}tzlichen Vorgangsweise und Ziele & 1 \\ \hline
1.495 -%23.07.2010 & Isabelle: Ziele, Techniken (ML) und Zusammenh\"{a}nge mit Isac abkl\"{a}ren & 1 \\ \hline
1.496 -%30.07.2010 & Ende der Einarbeitungstage: weitere Vorgensweise \"{u}ber Backs 'structured derivations'; Begriffserkl\"{a}rung & 3 \\ \hline
1.497 -%01.08.2010 & Recherche: Buch f\"{u}r Scala & 2 \\ \hline
1.498 -%03.08.2010 & Isabelle bestehende Technologie studieren & 4 \\ \hline
1.499 -%05.08.2010 & Einarbeiten in Scala: Unterschiede zu Java indentifizieren & 1 \\ \hline
1.500 -%06.08.2010 & Einarbeiten in Scala: Unterschiede zu Java indentifizieren, erste Beispielfiles & 4 \\ \hline
1.501 -%08.08.2010 & Einarbeiten in Scala: funktionale Seite von Scala & 2 \\ \hline
1.502 -%09.08.2010 & Einarbeiten in Scala: Testfiles mit Scala-Swing & 5 \\ \hline
1.503 -%12.08.2010 & Studieren von Papers zu Scala Actors & 3 \\ \hline
1.504 -%24.09.2010 & Scala: Arbeiten mit Klassen und Schnittstellen & 3 \\ \hline
1.505 -%25.09.2010 & Scala: Experimente mit Java in Scala-Source & 6 \\ \hline
1.506 -%27.09.2010 & Scala: Testfiles zu "Funktional vs Imperativ" & 4 \\ \hline \hline
1.507 -% & Anzahl der Einheiten & 44 \\
1.508 -%\hline
1.509 -%\end{tabular}
1.510 -%
1.511 -%
1.512 -%\section{Technische Voraussetzungen hergestellt: beendet am 02.08.2010}
1.513 -%\begin{itemize}
1.514 -%\item Isabelle installiert, Filestruktur bekannt: beendet am 02.08.2010
1.515 -%\item Scala in NetBeans eingebunden: beendet am 22.07.2010
1.516 -%\item Mercurial installiert und einrichten des Repositories: beendet am 19.07.2010
1.517 -%\end{itemize}
1.518 -%\begin{tabular}{|p{2cm}|p{8cm}|p{2cm}|}
1.519 -%\hline
1.520 -%Datum & T\"atigkeit & Einheiten \\ \hline
1.521 -%19.07.2010 & Beginn der Installationsarbeiten: Repo klonen und testen & 6 \\ \hline
1.522 -%20.07.2010 & Installationsarbeiten, Einarbeiten in Filestruktur & 7 \\ \hline
1.523 -%21.07.2010 & Einarbeiten in Filestruktur & 6 \\ \hline
1.524 -%22.07.2010 & Vorbereitungen: NetBeans, JDK und Scala installieren. Scala in NetBeans integrieren & 8 \\ \hline
1.525 -%23.07.2010 & Isabelle-jEdit-Plugin mittels NetBeans ausf\"{u}hren: testen & 5 \\ \hline
1.526 -%27.07.2010 & Isabelle-jEdit-Plugin: \"{a}nderungen an der Projektstruktur & 7 \\ \hline
1.527 -%28.07.2010 & Experimente mit Isabelle-jEdit-Plugin & 6 \\ \hline
1.528 -%29.07.2010 & Identifikations der Parse-Einstiegsstelle & 5 \\ \hline
1.529 -%30.07.2010 & Experimente mit Isabelle-jEdit-Plugin, Besprechung \"{u}ber Erfahrungen mit Filestruktur & 4 \\ \hline
1.530 -%02.08.2010 & Installationen und einrichten des Repos auf meinen Laptop & 6 \\ \hline \hline
1.531 -% & Anzahl der Einheiten & 60 \\
1.532 -%\hline
1.533 -%\end{tabular}
1.534 -%
1.535 -%\section{NetBeans-Projekt aufgesetzt: beendet am 02.08.2010}
1.536 -%\begin{itemize}
1.537 -%\item Grundlegende Projektstruktur f\"ur ISAC hergestellt: beendet am 02.08.2010
1.538 -%\item jEdit-Plugin: XML-Files f\"{u}r ISAC vorbereitet: beendet am 22.07.2010
1.539 -%\item jEdit-Plugin: Source files geschrieben: beendet am 19.07.2010
1.540 -%\end{itemize}
1.541 -%\begin{tabular}{|p{2cm}|p{8cm}|p{2cm}|}
1.542 -%\hline
1.543 -%Datum & T\"atigkeit & Einheiten \\ \hline
1.544 -%10.08.2010 & Projektstruktur anlegen, build.xml anpassen & 7 \\ \hline
1.545 -%11.08.2010 & jEdit-Plugin-Struktur studieren: Howto durcharbeiten & 5 \\ \hline
1.546 -%21.08.2010 & bestehende jEdit-Plugins (Java) durcharbeiten & 3 \\ \hline
1.547 -%22.08.2010 & Kopieren des Isabelle-jEdit-Plugins, Umarbeiten f\"{u}r ISAC & 3 \\ \hline
1.548 -%24.08.2010 & Umarbeiten des Isabelle-Plugins f\"{u}r ISAC & 6 \\ \hline
1.549 -%26.08.2010 & Problem mit Isabelle-Umgebungsvariable: Suche nach L\"{o}sungen & 3 \\ \hline
1.550 -%28.08.2010 & Recherchen zum Umgebungsvariable-Problem, Arbeiten mit den Isabelle-Shell-Skripts & 2 \\ \hline
1.551 -%29.08.2010 & Experimente mit den Path-Varialbe der jvm & 3 \\ \hline
1.552 -%30.08.2010 & Isabelle-jEdit-Plugin endlich vollst\"{a}ndig lauff\"{a}hig gebracht & 4 \\ \hline
1.553 -%01.09.2010 & Arbeiten an der jEdit-ISAC-Projektstruktur & 3 \\ \hline
1.554 -%04.09.2010 & Umarbeiten des Isabelle-Plugins f\"{u}r ISAC & 5 \\ \hline
1.555 -%20.09.2010 & Einrichten des Laptops f\"{u}r Isabelle-Isac & 4 \\ \hline
1.556 -%22.09.2010 & Meeting: Fortschrittsbericht, kurze Einf\"{u}hrung f\"{u}r Mitstreiter & 3 \\ \hline
1.557 -%
1.558 -%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
1.559 -%30.09.2010 & QN: Start mit \"{u}bersetzten der Sourcefiles & 5 \\ \hline
1.560 -%02.10.2010 & QN: \"{U}bersetzten der Sourcefiles & 6 \\ \hline
1.561 -%04.10.2010 & QN: \"{U}bersetzten der Sourcefiles: Problem bei Interface & 3 \\ \hline
1.562 -%05.10.2010 & QN: QN vollst\"andig in Scala \"{u}bersetzt, testen & 2 \\ \hline \hline
1.563 -% & Anzahl der Einheiten & 71 \\
1.564 -%\hline
1.565 -%\end{tabular}
1.566 -%
1.567 -%\section{Experimentelle Parser implementiert: beendet am 04.03.2011}
1.568 -%\begin{itemize}
1.569 -%\item Experimente mit dem SideKick-Parser abgeschlossen: beendet am 03.02.2011
1.570 -%\item Verbindung zu Isabelle-Pure hergestellt: beendet am 04.03.2011
1.571 -%\item Implementierung des Scala-Parsers: aufgeschoben
1.572 -%\end{itemize}
1.573 -%\begin{tabular}{|p{2cm}|p{8cm}|p{2cm}|}
1.574 -%\hline
1.575 -%Datum & T\"atigkeit & Einheiten \\ \hline
1.576 -%28.01.2011 & Testen des SideKick-Parsers im Isabelle-Plugin & 2 \\ \hline
1.577 -%29.01.2011 & Leichte Modifikationen des SideKick-Parsers im Isabelle-Plugin & 1 \\ \hline
1.578 -%08.02.2011 & Besprechung zum Abschluss der praktischen Arbeiten & 1 \\ \hline
1.579 -%16.02.2011 & Erstellen des Isabelle-Pur jar-Files & 1 \\ \hline
1.580 -%19.02.2011 & Behebung des Problems mit den Umgebungsvariablen & 1 \\ \hline
1.581 -%03.03.2011 & Erzeugung des Pure.jar Package m\"{o}glich & 2 \\ \hline
1.582 -%04.04.2011 & Verbindung zwischen Plugin und Isabelle-Pure hergestellt und getestet & 3 \\ \hline
1.583 -%08.04.2011 & Besprechung: Implementierung des experimentellen Parsers wird nicht mehr durchgef\"{u}hrt & 1 \\ \hline \hline
1.584 -% & Anzahl der Einheiten & 12 \\
1.585 -%\hline
1.586 -%\end{tabular}
1.587 -%
1.588 -%\section{Verfassen der Dokumentation und abschliesende Arbeiten: beendet am TO.DO.2011}
1.589 -%\begin{itemize}
1.590 -%\item Bacc.-Protokoll fertiggestellt: beendet am 01.03.2011
1.591 -%\item Dokumentation: erste Version fertiggestellt: beendet am 28.04.2011
1.592 -%\item Dokumentation abgeschlossen: beendet am TO.DO.2011
1.593 -%\end{itemize}
1.594 -%\begin{tabular}{|p{2cm}|p{8cm}|p{2cm}|}
1.595 -%\hline
1.596 -%Datum & T\"atigkeit & Einheiten \\ \hline
1.597 -%01.03.2011 & Besprechung zum Ablauf der Dokumentationsarbeiten: Protokoll und Dokumentation & 1 \\ \hline
1.598 -%01.03.2011 & Erstellen des Protokolls & 2 \\ \hline
1.599 -%08.03.2011 & Besprechung zur Doku und zur Schnittstelle zu Isabelle-Pure & 1 \\ \hline
1.600 -%17.03.2011 & Dokumentation schreiben & 2 \\ \hline
1.601 -%19.03.2011 & Dokumentation schreiben & 3 \\ \hline
1.602 -%24.04.2011 & Dokumentation schreiben & 2 \\ \hline
1.603 -%25.04.2011 & Dokumentation schreiben & 4 \\ \hline
1.604 -%27.04.2011 & Dokumentation schreiben & 2 \\ \hline
1.605 -%28.04.2011 & Dokumentation: Fertigstellen der ersten Version & 3 \\ \hline \hline
1.606 -% & Anzahl der Einheiten & 20 \\
1.607 -%\hline
1.608 -%\end{tabular}
1.609 -%
1.610 -%\section{Pr\"asentation der Arbeit im IST-Seminar }% am ..(*)...}