README.markdown

   1 # Uebersetzerbau \(SS10\)
   2
   3 Dies ist eine gemeinschaftliche Sammlung von Testfaellen fuer die Uebungsbeispiele
   4 der LVA "Uebersetzerbau \(SS10\)" an der TU Wien.
   5
   6 Kurzes HOWTO (fuer die g0):
   7
   8         $ git clone git://github.com/lewurm/testub10.git ~/test
   9
  10 Danach koennen die Testfaelle durch diesen Befehl aktualisiert werden:
  11
  12         $ cd ~/test && git pull
  13
  14 Das Testskript selbst wird von der LVA-Leitung zur Verfuegung gestellt:
  15
  16         $ /usr/ftp/pub/ubvl/test/scanner/test
  17         $ /usr/ftp/pub/ubvl/test/parser/test
  18         $ /usr/ftp/pub/ubvl/test/ag/test
  19         $ /usr/ftp/pub/ubvl/test/codea/test
  20         $ /usr/ftp/pub/ubvl/test/codeb/test
  21         $ /usr/ftp/pub/ubvl/test/gesamt/test
  22
  23 Weiters wurde das bekannte Benchmarkskript von viper fuer codea, codeb und
  24 gesamt angepasst und eingebaut das sich in
  25
  26         $ ~/test/scripts/test.sh
  27
  28 befindet und mit {code{a,b},gesamt} als parameter aufgerufen wird.
  29
  30 # Namenskonventionen fuer das Skript (Zitat LVA Leitung):
  31
  32 Die Dateien mit der Eingabe heissen \*.0, \*.1, \*.2 oder \*.3, wobei die
  33 Ziffer hinten den Exit-Code angibt. Eine Datei, die einen
  34 Syntax-Fehler enthaelt, werden Sie also z.B. foo.2 nennen.  Beim
  35 Scanner-Beispiel gibt es fuer akzeptable Eingaben (also Dateien, die
  36 auf .0 enden) auch noch eine Ausgabe, die ueberprueft werden muss; die
  37 erwartete Ausgabe fuer die Datei bar.0 nennen Sie bar.out.
  38
  39 ## Weitere Namenskonventionen fuer uns:
  40
  41 *       Jeder Testfall hat als Praefix "<nick>_", sodass keine Namenskonflikte entstehen.
  42 *       Ab codea sollte auch fuer jeden erfolgreichen Testfall eine .instr Datei angelegt werden die einen Referenzwert der Instruktionen enthaelt.
  43
  44
  45 # Wie kannst du beitragen?
  46
  47 ## mit git:
  48
  49 *       forke das Repository auf github, committe deine Aenderungen und mach einen "Pull Request"
  50 *       clone das Repository, committe deine Aenderungen, erzeuge Patches mit
  51
  52                 git format-patch
  53
  54         und maile sie oder poste sie im Informatikforum
  55
  56 ## ohne git:
  57
  58 *       schicke deine Testfaelle als Anhang per Mail (mit passenden Dateinamen bitte!)
  59 *       poste deine Testfaelle im Informatikforum und haenge sie als Attachment an (mit passenden Dateinamen bitte!)
  60
  61 und natuerlich ist jeder herzlichst dazu eingeladen im Forum ueber Testfaelle zu diskutieren :)
  62
  63 Infforum-Thread: <http://tinyurl.com/testub10>
  64
  65 Mailadresse(n): lewurm_AT_gmail_DOT_com (weitere Freiwillige sind willkommen, einfach eintragen)
  66
  67
  68
  69 # Allgemeine Tipps:
  70
  71 praktische Ergaenzungen am Makefile fuer codea:
  72
  73         #bricht beim ersten fehlerhaften Testfall ab
  74         #usage: make atest
  75
  76         atest:
  77                 ~/test/scripts/modlvatest_codea.sh 2>&1
  78
  79
  80         #offizielles Testskript der LVA
  81         #usage: make lvatest
  82
  83         lvatest:
  84                 /usr/ftp/pub/ublu/test/codea/test 2>&1
  85
  86
  87         #Benchmarkskript. Testet nur *.0 Testfaelle
  88         #usage: make bench
  89
  90         bench:
  91                 ~/test/scripts/bench.sh codea
  92
  93 Ausserdem befindet sich ein Skript zum Testen *eines* Testfalles (auch nur fuer
  94 \*.0 Testfaelle gedacht) hier:
  95         $ ~/test/scripts/onetest ~/test/codea/namen.0