From: Snafu Date: Thu, 6 May 2010 11:48:00 +0000 (+0200) Subject: replaced README with README.markdown X-Git-Url: http://wien.tomnetworks.com/gitweb/?p=testub10.git;a=commitdiff_plain;h=3f967ce60e87d1cdf5a298c446e1802c396d1f43 replaced README with README.markdown --- diff --git a/README b/README deleted file mode 100644 index 6bfc2c7..0000000 --- a/README +++ /dev/null @@ -1,76 +0,0 @@ -Dies ist eine gemeinschaftliche Sammlung von Testfaellen fuer die Uebungsbeispiele -der LVA "Uebersetzerbau (SS10)" an der TU Wien. - -Kurzes HOWTO (fuer die g0): -$ git clone git://github.com/lewurm/testub10.git ~/test - -Danach koennen die Testfaelle durch diesen Befehl aktualisiert werden: -$ cd ~/test && git pull - -Das Testskript selbst wird von der LVA-Leitung zur Verfuegung gestellt: -$ /usr/ftp/pub/ubvl/test/scanner/test -$ /usr/ftp/pub/ubvl/test/parser/test -$ /usr/ftp/pub/ubvl/test/ag/test -$ /usr/ftp/pub/ubvl/test/codea/test -$ /usr/ftp/pub/ubvl/test/codeb/test -$ /usr/ftp/pub/ubvl/test/gesamt/test - -Weiters wurde das bekannte Benchmarkskript von viper fuer codea, codeb und -gesamt angepasst und eingebaut das sich in -$ ~/test/scripts/test.sh -befindet und mit {code{a,b},gesamt} als parameter aufgerufen wird. - -Namenskonventionen fuer das Skript (Zitat LVA Leitung): -Die Dateien mit der Eingabe heissen *.0, *.1, *.2 oder *.3, wobei die -Ziffer hinten den Exit-Code angibt. Eine Datei, die einen -Syntax-Fehler enthaelt, werden Sie also z.B. foo.2 nennen. Beim -Scanner-Beispiel gibt es fuer akzeptable Eingaben (also Dateien, die -auf .0 enden) auch noch eine Ausgabe, die ueberprueft werden muss; die -erwartete Ausgabe fuer die Datei bar.0 nennen Sie bar.out. - -Weitere Namenskonventionen fuer uns: -o Jeder Testfall hat als Praefix "_", sodass keine Namenskonflikte entstehen. -o Ab codea sollte auch fuer jeden erfolgreichen Testfall eine .instr Datei - angelegt werden die einen Referenzwert der Instruktionen enthaelt. - - -Wie kannst du beitragen? - -mit git: -* forke das Repository auf github, committe deine Aenderungen und mach einen "Pull Request" -* clone das Repository, committe deine Aenderungen, erzeuge Patches mit "git format-patch" und maile sie oder poste sie im Informatikforum - -ohne git: -* schicke deine Testfaelle als Anhang per Mail (mit passenden Dateinamen bitte!) -* poste deine Testfaelle im Informatikforum und haenge sie als Attachment an (mit passenden Dateinamen bitte!) - -und natuerlich ist jeder herzlichst dazu eingeladen im Forum ueber Testfaelle zu diskutieren :) - -Infforum-Thread: http://tinyurl.com/testub10 -Mailadresse(n): lewurm_AT_gmail_DOT_com (weitere Freiwillige sind willkommen, einfach eintragen) - - - -Allgemeine Tipps: - -praktische Ergaenzungen am Makefile fuer codea: - -> #bricht beim ersten fehlerhaften Testfall ab -> #usage: make atest -> atest: -> ~/test/scripts/modlvatest_codea.sh 2>&1 -> -> #offizielles Testskript der LVA -> #usage: make lvatest -> lvatest: -> /usr/ftp/pub/ublu/test/codea/test 2>&1 -> -> #Benchmarkskript. Testet nur *.0 Testfaelle -> #usage: make bench -> bench: -> ~/test/scripts/bench.sh codea - - -Ausserdem befindet sich ein Skript zum Testen *eines* Testfalles (auch nur fuer -*.0 Testfaelle gedacht) hier: -$ ~/test/scripts/onetest ~/test/codea/namen.0 diff --git a/README.markdown b/README.markdown new file mode 100644 index 0000000..9fd3be3 --- /dev/null +++ b/README.markdown @@ -0,0 +1,95 @@ +# Uebersetzerbau \(SS10\) + +Dies ist eine gemeinschaftliche Sammlung von Testfaellen fuer die Uebungsbeispiele +der LVA "Uebersetzerbau \(SS10\)" an der TU Wien. + +Kurzes HOWTO (fuer die g0): + + $ git clone git://github.com/lewurm/testub10.git ~/test + +Danach koennen die Testfaelle durch diesen Befehl aktualisiert werden: + + $ cd ~/test && git pull + +Das Testskript selbst wird von der LVA-Leitung zur Verfuegung gestellt: + + $ /usr/ftp/pub/ubvl/test/scanner/test + $ /usr/ftp/pub/ubvl/test/parser/test + $ /usr/ftp/pub/ubvl/test/ag/test + $ /usr/ftp/pub/ubvl/test/codea/test + $ /usr/ftp/pub/ubvl/test/codeb/test + $ /usr/ftp/pub/ubvl/test/gesamt/test + +Weiters wurde das bekannte Benchmarkskript von viper fuer codea, codeb und +gesamt angepasst und eingebaut das sich in + + $ ~/test/scripts/test.sh + +befindet und mit {code{a,b},gesamt} als parameter aufgerufen wird. + +# Namenskonventionen fuer das Skript (Zitat LVA Leitung): + +Die Dateien mit der Eingabe heissen \*.0, \*.1, \*.2 oder \*.3, wobei die +Ziffer hinten den Exit-Code angibt. Eine Datei, die einen +Syntax-Fehler enthaelt, werden Sie also z.B. foo.2 nennen. Beim +Scanner-Beispiel gibt es fuer akzeptable Eingaben (also Dateien, die +auf .0 enden) auch noch eine Ausgabe, die ueberprueft werden muss; die +erwartete Ausgabe fuer die Datei bar.0 nennen Sie bar.out. + +## Weitere Namenskonventionen fuer uns: + +* Jeder Testfall hat als Praefix "_", sodass keine Namenskonflikte entstehen. +* Ab codea sollte auch fuer jeden erfolgreichen Testfall eine .instr Datei angelegt werden die einen Referenzwert der Instruktionen enthaelt. + + +# Wie kannst du beitragen? + +## mit git: + +* forke das Repository auf github, committe deine Aenderungen und mach einen "Pull Request" +* clone das Repository, committe deine Aenderungen, erzeuge Patches mit + + git format-patch + + und maile sie oder poste sie im Informatikforum + +## ohne git: + +* schicke deine Testfaelle als Anhang per Mail (mit passenden Dateinamen bitte!) +* poste deine Testfaelle im Informatikforum und haenge sie als Attachment an (mit passenden Dateinamen bitte!) + +und natuerlich ist jeder herzlichst dazu eingeladen im Forum ueber Testfaelle zu diskutieren :) + +Infforum-Thread: + +Mailadresse(n): lewurm_AT_gmail_DOT_com (weitere Freiwillige sind willkommen, einfach eintragen) + + + +# Allgemeine Tipps: + +praktische Ergaenzungen am Makefile fuer codea: + + #bricht beim ersten fehlerhaften Testfall ab + #usage: make atest + + atest: + ~/test/scripts/modlvatest_codea.sh 2>&1 + + + #offizielles Testskript der LVA + #usage: make lvatest + + lvatest: + /usr/ftp/pub/ublu/test/codea/test 2>&1 + + + #Benchmarkskript. Testet nur *.0 Testfaelle + #usage: make bench + + bench: + ~/test/scripts/bench.sh codea + +Ausserdem befindet sich ein Skript zum Testen *eines* Testfalles (auch nur fuer +\*.0 Testfaelle gedacht) hier: + $ ~/test/scripts/onetest ~/test/codea/namen.0