added in building architecture for turoial exercises

1 files changed, 92 insertions, 0 deletions

diff --git a/docs/teaching/exercises/README.txt b/docs/teaching/exercises/README.txt
new file mode 100755
index 000000000..d06249316
--- /dev/null
+++ b/docs/teaching/exercises/README.txt
@@ -0,0 +1,92 @@
+AspectJ Figures Exercises
+------------------------------
+
+THIS FILE IS OUT-OF-DATE !!! (2003-3-17)
+
+These exercises are designed to be used with AspectJ 1.0.6.  
+
+THEY MUST NOT BE DISTRIBUTED ELECTRONICALLY WITHOUT THINKING FIRST!!!
+There may be licence issues with just sticking the junit jar in there
+that I don't understand.
+
+To build distribution zips, use ant -f build.xml.  This will create
+
+   EV-exercises.zip     -- the contents of these exercises, minus AspectJ
+   EV-answers.zip       -- some answers to these exercises.
+   EV-setup.zip         -- the exercises bundled with AspectJ
+   EV-allcontent.zip    -- the exercises bundled with the answers
+
+
+If you don't want to be bothered with specifying where AspectJ is, 
+feel free to just do ant -f build.xml answers.zip.  By default it will
+build both exercises and answers.
+
+------------------------------
+Required environment
+
+In order to actually do the exercises, the three very important files
+to have are:
+
+  EV-exercises.zip
+  aspectj-tools-1.0.6.jar
+  <some installer of java>
+
+It is almost certainly a good idea to hope that Java is already
+installed on the students' systems, but to provide two installers
+(windows and linux) anyway.
+
+   http://java.sun.com
+
+You may want to also include the rest of the AspectJ installers as
+well, but that might be a bit of a distraction
+
+   http://aspectj.org/dl
+
+These require junit.jar.  I've included a copy in with the two zip
+files, but they might want to be refreshed every now and again.
+
+   http://junit.org
+
+
+------------------------------
+Printing
+
+It would be really nice to have an automated solution to generate the
+documents, but no such luck. 
+
+* index.html should print out with useful page breaks.  It should be
+  separated into four chunks if possible. 
+
+* answers in four chunks. 
+
+* quick reference sheets.
+
+Remember to have a one-sided copy of everything as a separate
+clean-copy.
+
+
+------------------------------
+Distribution
+
+   /j2sdk-1_4_1_01-linux-i586.bin
+   /j2sdk-1_4_1_01-windows-i586.exe
+   /exercises.zip containing:
+       aj-EV/src/figures.zip
+       aj-EV/src/aspectj-tools-1.0.6.jar
+       aj-EV/src/aspectj-docs-1.0.6.jar
+       aj-EV/<exploded version of figures.zip>
+       aj-EV/aspectj/<exploded version of aspectj-tools>
+       aj-EV/aspectj/<exploded version of aspectj-docs>
+       aj-EV/setpaths
+       aj-EV/setpaths.bat
+
+/bin/ajc, are edited to make sure that JAVA_HOME is used, as the
+defaults will almost certainly be wrong.  setpaths scripts do what
+they look like they do.  All six of these scripts are stored in
+scripts under CVS.
+
+---- Instructors
+
+Since the only difference is the answers, just overwrite the
+extraction directory with answers.zip.  
+