Schnelleinstieg und erste Schritte:

Zu allererst: Fuer eine neue Lehrveranstaltung sollte ein neuer
Jahrgang erstellt, d.h. der jeweils vorhergehende Jahrgang kopiert
werden. Danach sollte ausschliesslich mit dem neuen Jahrgang
gearbeitet werden. Alte Jahrgaenge sollten zur Archivierung erhalten
bleiben und moeglichst nicht mehr veraendert werden.

Zusaetzlich kann mit der Backup-Funktion ("make backup") von dem
aktuellen Jahrgang ein Archiv erstellt werden, welches ebenfalls
zwecks Archivierung separat abgelegt werden kann.

Eine Uebersicht ueber die Funktionen des Makefiles erhaelt man, indem
man auf der Konsole einfach

$ make

oder

$ make help

... eingibt. Es wird daraufhin eine Hilfeseite ausgegeben, auf der
alle verfuegbaren Funktionen aufgefuehrt und kurz erlaeutert werden.

Der Ablauf zur Erstellung eines Uebungsblattes sieht entweder so aus:

$ make b01
$ make ueb01
$ make tut01

... oder alternativ etwas kuerzer:

$ make 01
$ make tut01

Die Schritte wurden so aufgeteilt, weil es sich als praktikabel
erwiesen hat: Das Uebungsblatt ("make b01") und die Uebungen ("make
ueb01") wurden oefters einzeln oder auch zusammen ("make 01")
erstellt. Das Tutorenarchiv ("make tut01") relativ selten, meist nur
einmalig direkt vor Ausgabe an die Tutoren.

Anmerkungen: Die .tar.gz-Archive fuer die Tutoren enhalten alles, was
diese fuer Testate benoetigen (Aufgabenblatt, Musterloesungen,
Fragenkatalog, Bewertungsschema sowie saemtliche Dateien
(z.B. Musterloesungen und Beispiele im Quellcode) aus den
Uebungsveranstaltungen). Diese Archive werden z.B. mit "make tut01"
erzeugt. Vorher muessen aber mit "make ueb01" auch die Uebungsinhalte
erzeugt werden (vgl. oben). Alternativ werden mit "make 01" sowohl die
Uebungsblaetter als auch die Uebungsinhalte erzeugt, d.h. "make 01"
beinhaltet "make b01" und "make ueb01".

In der Vergangenheit wurden die .tar.gz-Archive fuer die Tutoren, die
in den jeweiligen Ordnern "Aufgaben/blatt*" automatisch erstellt
werden, manuell in das Verzeichnis eine Ebene hoeher (d.h. nach
"Aufgaben") kopiert. So ist sichergestellt, dass die einmal
ausgegebenen Archive nicht versehentlich ueberschrieben werden.

Diese Archive wurden in der Vergangenheit zur Archivierung in die
Versionsverwaltung mit aufgenommen, damit man im Zweifel ohne "make",
"LaTeX", etc. und ohne grosse Umstaende nachvollziehen kann, was in
den vorhergehenden Jahrgaengen gelaufen ist. Die "blatt*"-Ordner
hingegen wurden _nicht_ in die Versionsverwaltung aufgenommen, weil
diese lediglich aus den Pool-Inhalten generiert werden (genauso wie
die Ordner und Dateien in "<JAHRGANG>/Uebung/...").

In dem jeweils aktuellen, d.h. kopierten, Jahrgang sollten nach dem
Kopieren des gesamten Jahrgangsverzeichnisses die enthaltenen (alten)
.tar.gz-Archive entfernt und dann nach und nach zu Archivzwecken im
Laufe der Veranstaltung die neu generierten und ausgegebenen
.tar.gz-Archive des aktuellen Jahrgangs wieder hinzugefuegt werden.

Stand: 19.02.2013 (woru)

