Changes between Version 7 and Version 8 of BoltRef

Timestamp:

Dec 12, 2007, 1:28:13 PM (16 years ago)

Author:

davea

Comment:

--

BoltRef

@@ +1 @@
+[[PageOutline]]
+
 = Bolt reference manual =
 
@@ -10 +12 @@
 
 A '''Lesson''' contains instructional material.
-It may be either an HTML or PHP file.
+It may be either an HTML file or PHP script.
 It may contain embedded audio, video, Flash, or any other content.
 Some restrictions:
@@ -23 +25 @@
 {{{
 $student.sex;    // 0=unknown, 1=male, 2=female
-$student.age;    // in years
+$student.birth_year;
 $student.country;
+$student.name;
+$student.bandwidth;  // 1: <100Kb; 2: <1Mb; 3: <10Mb etc.
+$student.has_audio_output;    // 1: no, 2: yes
+$student.has_audio_input;
 }}}
 
@@ -42 +48 @@
 == Exercises ==
 
-Exercises are PHP script that call Bolt API functions.
+Exercises are PHP scripts that call Bolt API functions.
 Here's an example consisting of a multiple-choice question:
 {{{
@@ -56 +62 @@
 ?>
 }}}
+The correct choice is the first element of the array.
 Each time the question is shown,
-the choices are shown in a random order.
-The correct choice is the first element of the array.
+the choices are presented in a random order.
 
 Here's an example that shows an image;
@@ -108 +114 @@
 }}}
 
+== Nesting and functions ==
+
+== Names and state ==
+
+== Control structures ==
 === Sequences ===
 
@@ -181 +192 @@
 
 
-== Exercise set ==
+=== Exercise set ===
 
 The 'exercise_set' structure specifies a set of exercises and a value 'num_to_show'.
 This number of exercises is chosen randomly and administered.
-
-Optionally, one or more '''review''' attributes can be given.
-Each specifies a grade threshold X and a list of review units.
-If the student's grade on the exercise set is less than some Y,
-
 
 {{{
@@ -209 +215 @@
 }}}
 
-=== Memory refresh ===
-
+== Review ==
+
+Optionally, one or more '''review''' attributes can be given.
+Each specifies a grade threshold X and a list of review units.
+If the student's grade on the exercise set is less than some Y,
+
+== Memory refresh ==
+