Changes between Version 10 and Version 11 of BoltRef

Timestamp:

Dec 12, 2007, 10:23:23 PM (16 years ago)

Author:

davea

Comment:

--

BoltRef

@@ -166 +166 @@
 == Nesting and functions ==
 
-
+Control structures may be nested.
+For example:
+{{{
+sequence(
+    name("x");
+    lesson(...),
+    sequence(
+        name("y"),
+        lesson(...),
+        exercise(...)
+    )
+);
+}}}
+
+You can also use PHP functions as a way of organizing course structure:
+
+{{{
+function my_unit() {
+    return sequence(
+        name("y"),
+        lesson(...),
+        exercise(...)
+    )
+}
+
+sequence(
+    name("x"),
+    lesson(...),
+    my_unit()
+);
+}}} 
 
 == Names and state ==
 
+In general, units must have unique logical names.
+However, two units may have the same logical name if they are identical.
+For example:
+{{{
+function my_unit() {
+    return random(
+        name("y"),
+        lesson(...),
+        lesson(...)
+    )
+}
+
+return sequence(
+    name("x"),
+    my_unit(),
+    exercise_set(
+        name("z"),
+        exercise(...),
+        review(.5, my_unit())
+    )
+);
+}}}
+
+This specifies a course in which my_unit() is displayed,
+then an exercise is given.
+If the student scores below .5 on the exercise,
+he is shown my_unit() again and the exercise is repeated.
+
+So there are two units with logical name 'y' in this course,
+but they are identical, so this is allowed.
+
+When there are multiple units with the same logical name,
+they share a single state.
 
 == Control structures ==
 === Sequences ===
 
-
+Sequences were described above.
 
 === Random ===