6 files changed, 117 insertions, 57 deletions

diff --git a/doc/tutorials/intro/00.hello_world.pd b/doc/tutorials/intro/00.hello_world.pd
index 981429f3..1176ea02 100644
--- a/doc/tutorials/intro/00.hello_world.pd
+++ b/doc/tutorials/intro/00.hello_world.pd
@@ -1,4 +1,4 @@
-#N canvas 228 159 628 440 12;
+#N canvas 228 159 632 444 12;
 #X msg 235 167 Hello world!;
 #X text 238 216 <-- connection \, aka "cord";
 #X text 17 32 In Pd \, programming is done with boxes which are connected
@@ -10,5 +10,6 @@ together. The boxes have "inlets" and "outlets" \, where they are connected.
 #X obj 234 265 print;
 #X text 289 266 <-- object box;
 #X text 89 357 Now look in the Pd window to see the result.;
-#X text 374 166 <-- click here;
+#X text 359 168 <-- message box;
+#X text 101 111 Click on the box with "Hello world!" in it:;
 #X connect 0 0 6 0;
diff --git a/doc/tutorials/intro/TEMPLATE.pd b/doc/tutorials/intro/TEMPLATE.pd
index 6d07173b..96c1fe2d 100644
--- a/doc/tutorials/intro/TEMPLATE.pd
+++ b/doc/tutorials/intro/TEMPLATE.pd
@@ -1,3 +1,3 @@
-#N canvas 21 40 631 447 12;
-#X obj -54 8 cnv 15 400 40 empty empty TEMPLATE 20 12 0 24 -228992
+#N canvas 21 40 639 455 12;
+#X obj -39 10 cnv 15 400 40 empty empty TEMPLATE 20 12 0 24 -228992
 -66577 0;
diff --git a/doc/tutorials/intro/TODO b/doc/tutorials/intro/TODO
index 6b8de636..72bd2e8a 100644
--- a/doc/tutorials/intro/TODO
+++ b/doc/tutorials/intro/TODO
@@ -9,3 +9,52 @@
 
 - in pure_data_files.pd, make the patch reset itself once it finishes the
   clone. (remember that [pd clone] has to be the last object.)
+
+- make looping sequence
+
+File Order:
+
+- hello world
+- basic elements
+- getting help
+- edit mode
+- objects
+- connections
+- messages
+- make your first Pd patch
+- bang
+- hot and cold inlets
+- storage objects
+- atoms
+- atomic messages
+
+
+Unsorted topics
+
+- arguments
+
+- guis
+- gui objects
+
+- Example: its all just data
+- Example: parazit
+
+- right-to-left order
+- depth first
+
+- ordering messages
+
+
+- math objects
+- expr
+
+- subpatches
+- inlets and outlets
+- outlet order
+
+- loading libraries
+- namespaces
+- import
+
+- send messages to Pd
+- pure data files
diff --git a/doc/tutorials/intro/gui_objects.pd b/doc/tutorials/intro/gui_objects.pd
index 5d72a5b2..8a75061f 100644
--- a/doc/tutorials/intro/gui_objects.pd
+++ b/doc/tutorials/intro/gui_objects.pd
@@ -1,12 +1,12 @@
-#N canvas 293 91 746 588 10;
+#N canvas 312 62 750 592 10;
 #X obj 504 24 import cyclone unauthorized;
 #X obj 30 70 bng 15 250 50 0 \$1 \$1 empty 20 8 0 8 -262144 -1 -1;
 #X obj 30 102 tgl 15 1.04858e+06 empty \$2 empty 20 8 0 8 -262144 -1
 -1 0 1;
 #X obj 34 148 vsl 15 128 0 127 0 1.04858e+06 empty \$3 empty 20 8 0
-8 -262144 -1 -1 12700 1;
+8 -262144 -1 -1 0 1;
 #X obj 191 278 hsl 128 15 0 127 0 0 empty empty empty 20 8 0 8 -262144
--1 -1 2700 1;
+-1 -1 0 1;
 #X obj 201 249 hdl 15 1 2.6624e+06 8 \$5 \$5 empty 20 8 192 8 -262144
 -1 -1 0;
 #X obj 254 87 vu 15 120 \$6 empty 35 8 0 8 -66577 -1 1 0;
@@ -23,14 +23,14 @@
 #X obj 44 363 button OK;
 #X obj 142 367 popup 124 25 #ffffff popup option;
 #X obj 298 363 ticker ;
-#X obj 503 415 envgen 200 140 1 0  ;
+#X obj 495 419 envgen 200 140 1 0  ;
 #X obj 366 499 knob 32 32 0 127 0 0 empty empty empty 0 -8 32 8 -262144
 -1 -1 3100 1;
 #X text 360 473 [knob];
 #X text 281 340 [ticker];
-#X obj 492 96 grid grid1 200 0 199 200 0 199 1 1 1 10 10 19 11;
-#X text 500 73 [unauthorized/grid];
-#X text 483 391 [envgen];
+#X obj 500 71 grid grid1 200 0 199 200 0 199 1 1 1 10 10 570 188;
+#X text 474 51 [unauthorized/grid];
+#X text 475 395 [envgen];
 #X text 112 405 [cyclone/Scope~];
 #X text 23 339 [button];
 #X text 129 341 [popup];
@@ -44,3 +44,5 @@
 #X obj 105 432 Scope~ 130 130 256 3 128 -1 1 0 0 0 0 102 255 51 135
 135 135 0;
 #X text 337 118 [nbx];
+#X obj 555 305 gcanvas 80 80;
+#X text 483 294 [gcanvas];
diff --git a/doc/tutorials/intro/ordering_messages.pd b/doc/tutorials/intro/ordering_messages.pd
index 122e8cdc..b7d454db 100644
--- a/doc/tutorials/intro/ordering_messages.pd
+++ b/doc/tutorials/intro/ordering_messages.pd
@@ -1,42 +1,42 @@
-#N canvas 570 267 619 435 12;
+#N canvas 542 117 623 439 12;
 #X obj -60 8 cnv 15 400 40 empty empty ordering_messages 20 12 0 24
 -228992 -66577 0;
-#X obj 214 364 t f b s l p a;
-#X text 64 362 abbreviations:;
-#X obj -26 396 trigger float bang symbol list pointer anything;
-#X obj 239 89 trigger;
-#X msg 471 223 now;
-#X msg 392 223 this;
-#X msg 313 223 makes;
-#X msg 234 223 sense;
-#X msg 156 223 !;
-#X msg 232 326;
-#X obj 233 265 symbol;
-#X msg 233 289 add2 \$1;
-#X msg 196 133 bang;
-#X text -56 54 The [trigger] object allows you to specify the order
-of execution. If you need to make sure that one thing executes before
-another \, use:;
-#X msg 3 155 set;
-#X text -62 155 reset:;
-#X obj 196 160 trigger bang bang bang bang bang;
-#X msg 88 154 bang;
-#X connect 5 0 11 0;
-#X connect 6 0 11 0;
-#X connect 7 0 11 0;
-#X connect 8 0 11 0;
+#X msg 395 249 now;
+#X msg 316 250 this;
+#X msg 237 250 makes;
+#X msg 158 250 sense;
+#X msg 80 250 !;
+#X msg 276 391 sense now this;
+#X obj 157 292 symbol;
+#X msg 159 151 bang;
+#X msg -27 177 bang;
+#X msg 157 316 add2 \$1;
+#X msg 478 248 set;
+#X obj 160 178 trigger bang bang bang bang bang bang;
+#X text -18 393 look here for the result -->;
+#X text -50 62 Officially \, the execution order in Pd is undefined.
+;
+#X text -50 88 The [trigger] object allows you to specify the order
+of messages are sent. If you need to make sure that one thing runs
+before another \, use [trigger]:;
+#X connect 1 0 7 0;
+#X connect 2 0 7 0;
+#X connect 3 0 7 0;
+#X connect 4 0 7 0;
+#X connect 5 0 7 0;
+#X connect 7 0 10 0;
+#X connect 8 0 12 0;
+#X connect 9 0 3 0;
+#X connect 9 0 5 0;
 #X connect 9 0 11 0;
-#X connect 11 0 12 0;
-#X connect 12 0 10 0;
-#X connect 13 0 17 0;
-#X connect 15 0 10 0;
-#X connect 17 0 9 0;
-#X connect 17 1 8 0;
-#X connect 17 2 7 0;
-#X connect 17 3 6 0;
-#X connect 17 4 5 0;
-#X connect 18 0 8 0;
-#X connect 18 0 9 0;
-#X connect 18 0 6 0;
-#X connect 18 0 7 0;
-#X connect 18 0 5 0;
+#X connect 9 0 4 0;
+#X connect 9 0 1 0;
+#X connect 9 0 2 0;
+#X connect 10 0 6 0;
+#X connect 11 0 6 0;
+#X connect 12 0 5 0;
+#X connect 12 1 4 0;
+#X connect 12 2 3 0;
+#X connect 12 3 2 0;
+#X connect 12 4 1 0;
+#X connect 12 5 11 0;
diff --git a/doc/tutorials/intro/outlet_order.pd b/doc/tutorials/intro/outlet_order.pd
index d66ac559..d13b1d40 100644
--- a/doc/tutorials/intro/outlet_order.pd
+++ b/doc/tutorials/intro/outlet_order.pd
@@ -1,12 +1,20 @@
-#N canvas 0 22 458 308 12;
-#X text 121 112 <-- click here \,;
-#X obj 51 151 unpack float float float;
+#N canvas 298 70 628 444 12;
+#X text 198 212 <-- click here \,;
+#X obj 128 251 unpack float float float;
 #X obj 8 10 cnv 15 400 40 empty empty outlet_order 20 12 0 24 -228992
 -66577 0;
-#X msg 51 112 3 2 1;
-#X obj 28 193 print último;
-#X obj 315 193 print first;
-#X obj 167 193 print nächste;
+#X msg 128 212 3 2 1;
+#X obj 105 293 print último;
+#X obj 392 293 print first;
+#X obj 244 293 print nächste;
+#X text 18 363 There are occasional exceptions where it makes sense
+to break this convention. But you shouldn't do it unless it really
+is necessary. This will save you in the long run.;
+#X text 15 68 While there is nothing forcing you to output data to
+the outlets in any order \, Pd has a very strong convention for how
+data should be output from an object.;
+#X text 14 130 Just like the flow of programming in Pd \, the data
+should be output from right to left:;
 #X connect 1 0 4 0;
 #X connect 1 1 6 0;
 #X connect 1 2 5 0;