Vanilla 0.47 backport 16: add help files for clone, text, and array objects

pd/doc/5.reference/array-object-help.pd

+#N struct array-help-struct float x float y array z float;
+#N struct float float y;
+#N struct array-help-struct2 float x float y array z element-struct2
+;
+#N struct element-struct2 float x float y float w;
+#N canvas 309 129 694 542 12;
+#X obj 208 496 list;
+#X text 34 496 see also:;
+#X text 485 171 (click for details:), f 11;
+#N canvas 844 217 900 716 define 0;
+#X text 295 562 creation arguments:;
+#X text 325 597 optional name;
+#X text 322 164 read from a file;
+#X text 324 195 write to a file;
+#X text 32 20 "array define" maintains an array and can name it so
+that other objects can find it (and later should have some alternative
+\, anonymous way to be found).;
+#X text 324 614 optional size (100 by default);
+#X msg 35 138 const 0;
+#X text 325 138 set to a constant (0 \, for instance);
+#X msg 45 167 read array-object-help.txt;
+#X msg 45 194 write array-object-help.txt;
+#X obj 36 596 array define array-help-1;
+#X msg 45 224 resize 100;
+#X text 71 255 ... other messages are also forwarded to the array like
+those above - xticks \, etc \, and also lists to set values.;
+#X obj 154 412 r array-help-send;
+#X text 221 313 send a pointer to a named receive object;
+#X floatatom 154 460 5 0 0 0 - - -, f 5;
+#X obj 364 407 r array-help-send;
+#X floatatom 364 481 5 0 0 0 - - -, f 5;
+#X text 46 570 click to open or edit array:;
+#X obj 364 431 t b p;
+#X obj 154 436 getsize float-array z;
+#X obj 364 456 array size -s float-array z;
+#X text 109 349 The pointer will be to a structure float-array and
+the array itself will be the field named 'z' \, so that you can access
+it as shown in these examples:;
+#X obj 38 659 array define -k array-help-2 10;
+#A 0 -0.320006 0 0 0 0.973333 0 0 0 0 0;
+#X msg 49 313 send array-help-send;
+#X text 323 580 optional -k flag to keep contents;
+#X connect 6 0 10 0;
+#X connect 8 0 10 0;
+#X connect 9 0 10 0;
+#X connect 11 0 10 0;
+#X connect 13 0 20 0;
+#X connect 16 0 19 0;
+#X connect 19 0 21 0;
+#X connect 19 1 21 1;
+#X connect 20 0 15 0;
+#X connect 21 0 17 0;
+#X connect 24 0 10 0;
+#X restore 486 212 pd define;
+#X obj 112 496 text;
+#X obj 90 236 array size;
+#N canvas 0 50 600 400 (subpatch) 0;
+#N canvas 0 50 450 250 (subpatch) 0;
+#X coords 0 1 99 -1 500 300 1;
+#X restore 50 50 graph;
+#X restore 18 6 array;
+#X text 193 210 - create \, store \, and/or edit one;
+#X text 193 237 - get or change size;
+#X text 194 261 - sum all or a range of elements;
+#N canvas 624 95 689 679 array-and-data-structures 0;
+#X obj 98 247 pointer;
+#N canvas 804 396 504 278 array-help-struct 0;
+#X scalar array-help-struct 20 20 \; 0 \; 0 \; -1 \; -6 \; -9 \; -10
+\; -5 \; -2 \; 8 \; 12 \; 12 \; 12 \; 10 \; 8 \; 6 \; 1 \; \;;
+#X obj 88 204 pointer;
+#X msg 32 156 20 20;
+#X obj 31 231 append array-help-struct x y;
+#X msg 88 147 traverse pd-array-help-struct \, bang, f 21;
+#X obj 13 83 filledpolygon 0 0 0 0 0 0 10 20 10 20 0 0 0;
+#X obj 13 56 struct array-help-struct float x float y array z float
+;
+#X obj 17 114 plot z 500 2 25 5 5;
+#X connect 1 0 3 2;
+#X connect 2 0 3 0;
+#X connect 4 0 1 0;
+#X restore 289 159 pd array-help-struct;
+#N canvas 1207 234 450 300 array-help-data 0;
+#X scalar array-help-struct 84 93 \; 0 \; 0 \; -1 \; -6 \; -9 \; -10
+\; -5 \; -2 \; 5 \; -7 \; -41 \; -47 \; -45 \; -34 \; -17 \; 8 \; 5
+\; 2 \; -2 \; -11 \; -16 \; -26 \; -43 \; 16 \; 24 \; 26 \; 21 \; 20
+\; 19 \; 17 \; 16 \; 16 \; 16 \; 16 \; 12 \; \;;
+#X text 26 215 We have one datum... right-click to see contents.;
+#X restore 290 189 pd array-help-data;
+#X msg 98 190 traverse pd-array-help-data \, next, f 19;
+#X obj 61 139 bng 15 250 50 0 empty empty empty 17 7 0 10 -262144 -1
+-1;
+#X obj 61 161 t b b;
+#X obj 61 286 array sum -s array-help-struct z, f 19;
+#X floatatom 61 327 5 0 0 0 - - -, f 5;
+#X text 449 190 <- the array;
+#X text 460 161 <- the structure;
+#X text 56 21 The array objects can also reference arrays within structures
+via pointers. The "-s" flag takes two arguments \, specifying the data
+structure and the field within it that will contain the array. By default
+the array should be a simple floating point array (use hte template
+"float" for the array elements) but you can override that using "-f"
+as shown further down.;
+#X obj 115 549 pointer;
+#X obj 78 441 bng 15 250 50 0 empty empty empty 17 7 0 10 -262144 -1
+-1;
+#X obj 78 463 t b b;
+#X floatatom 78 629 5 0 0 0 - - -, f 5;
+#X text 466 518 <- the array;
+#N canvas 1063 375 447 373 array-help-struct2 0;
+#X obj 95 252 pointer;
+#X msg 39 204 20 20;
+#X obj 13 94 filledpolygon 0 0 0 0 0 0 10 20 10 20 0 0 0;
+#X obj 13 56 struct array-help-struct2 float x float y array z element-struct2
+;
+#X msg 95 195 traverse pd-array-help-struct2 \, bang, f 22;
+#X obj 38 279 append array-help-struct2 x y;
+#X obj 16 120 plot z 500 2 25 5;
+#X connect 0 0 5 2;
+#X connect 1 0 5 0;
+#X connect 4 0 0 0;
+#X restore 306 461 pd array-help-struct2;
+#N canvas 1028 171 477 318 array-help-data2 0;
+#X scalar array-help-struct2 80 30 \; -54 200 10 \; 138 -10 3 \; -32
+26 0 \; 109 141 8 \; 272 19 0 \; \;;
+#X text 31 267 A structure whose array has (x \, y \, w) triples -
+right-click to see contents., f 40;
+#X restore 307 517 pd array-help-data2;
+#X msg 115 492 traverse pd-array-help-data2 \, next, f 20;
+#X text 484 461 <- main structure, f 30;
+#X text 484 486 <- element structure, f 30;
+#N canvas 1103 205 413 178 element-struct2 0;
+#X obj 13 56 struct element-struct2 float x float y float w;
+#X restore 306 486 pd element-struct2;
+#X obj 78 588 array sum -s array-help-struct2 z -f element-struct2
+w, f 33;
+#X text 58 366 Using an additional '-f' flag we can specify which field
+in the array we're referring to. In this example the array has (x \,
+y \, w) triples (struct element-struct2) and we're asking for the "w"
+field using the "-f" flag and its two arguments.;
+#X text 128 629 sum of all the 'w' values in the array;
+#X text 225 267 when "-s" is given this inlet takes a pointer in place
+of a name., f 35;
+#X connect 0 0 6 2;
+#X connect 3 0 0 0;
+#X connect 4 0 5 0;
+#X connect 5 0 6 0;
+#X connect 5 1 3 0;
+#X connect 6 0 7 0;
+#X connect 11 0 22 2;
+#X connect 12 0 13 0;
+#X connect 13 0 22 0;
+#X connect 13 1 18 0;
+#X connect 18 0 11 0;
+#X connect 22 0 14 0;
+#X restore 87 456 pd array-and-data-structures;
+#N canvas 771 174 751 261 size 0;
+#X floatatom 26 95 5 1 100 0 - - -, f 5;
+#X obj 25 200 print;
+#X text 45 19 "array size" outputs the size (if sent a bang) or sets
+the size (if sent a number).;
+#X obj 25 171 array size array-help-2;
+#X obj 35 122 bng 15 250 50 0 empty empty empty 17 7 0 10 -262144 -1
+-1;
+#X text 226 169 creations arguments: either array name or "-s" and
+optional "-f" flags to refer to an array in a data structure;
+#X msg 249 137 symbol array-help-2;
+#X text 414 110 inlet to set name or pointer;
+#X text 74 94 number to set size;
+#X text 59 121 bang outputs size;
+#X msg 248 113 symbol array-help-1;
+#X connect 0 0 3 0;
+#X connect 3 0 1 0;
+#X connect 4 0 3 0;
+#X connect 6 0 3 1;
+#X connect 10 0 3 1;
+#X restore 486 236 pd size;
+#X obj 90 212 array define;
+#X text 84 432 accessing arrays inside data structures:;
+#X text 65 6 - accessing arrays;
+#X text 50 43 In Pd an array may be part of a "garray" (a graphical
+array of numbers) or appear as a slot in a data structure (in which
+case the elements may be arbitrary data \, not necessarily just numbers).
+The "array" object can define an array (so far just of numbers but
+maybe later arbitrary data structures) or access an array defined elsewhere
+to get or change its size \, set or read its elements \, and so on.
+;
+#X text 93 183 The first argument sets its function:;
+#X obj 153 496 scalar;
+#X obj 90 260 array sum;
+#X obj 90 332 array quantile;
+#N canvas 791 201 776 362 sum 0;
+#X floatatom 74 135 5 0 10 0 - - -, f 5;
+#X obj 65 114 bng 15 250 50 0 empty empty empty 17 7 0 10 -262144 -1
+-1;
+#X floatatom 65 268 5 0 0 0 - - -, f 5;
+#X floatatom 111 162 5 -1 10 0 - - -, f 5;
+#X text 45 19 "array sum" outputs the sum of all or a selected range
+of elements of the array.;
+#X obj 65 223 array sum array-help-2, f 12;
+#X text 183 262 - optional number to initialize onset - default 0;
+#X text 183 281 - optional number to initialize number of points -
+default -1, f 61;
+#X text 91 112 bang to output sum;
+#X text 184 226 creation arguments: either array name or "-s" and optional
+"-f" flags to refer to an array in a data structure;
+#X text 124 131 onset (first index to sum from) \, zero for start of
+array;
+#X text 159 157 number of points or -1 for end of array;
+#X text 65 328 (array-help-2 is defined in the "define" subwindow).
+;
+#X msg 158 189 symbol array-help-2;
+#X text 322 188 set name or pointer;
+#X connect 0 0 5 0;
+#X connect 1 0 5 0;
+#X connect 3 0 5 1;
+#X connect 5 0 2 0;
+#X connect 13 0 5 2;
+#X restore 486 260 pd sum;
+#X obj 90 284 array get;
+#N canvas 342 597 805 335 get 0;
+#X floatatom 135 103 5 0 10 0 - - -, f 5;
+#X obj 118 78 bng 15 250 50 0 empty empty empty 17 7 0 10 -262144 -1
+-1;
+#X floatatom 165 126 5 -1 10 0 - - -, f 5;
+#X obj 119 185 array get array-help-2, f 12;
+#X obj 119 226 print;
+#X text 45 19 "array get" outputs all or a selected range of elements
+of the array as a list.;
+#X text 276 238 - optional number to initialize onset - default 0;
+#X text 275 257 - optional number to initialize number of points -
+default -1, f 61;
+#X text 280 201 creation arguments: either array name or "-s" and optional
+"-f" flags to refer to an array in a data structure;
+#X text 212 128 number of points or -1 for end of array;
+#X text 140 78 bang for output;
+#X text 65 298 (array-help-2 is defined in the "define" subwindow).
+;
+#X msg 212 155 symbol array-help-2;
+#X text 376 154 set name or pointer;
+#X text 181 102 onset (first index to output) \, zero for start of
+array;
+#X connect 0 0 3 0;
+#X connect 1 0 3 0;
+#X connect 2 0 3 1;
+#X connect 3 0 4 0;
+#X connect 12 0 3 2;
+#X restore 486 284 pd get;
+#X obj 90 308 array set;
+#N canvas 525 369 752 328 set 0;
+#X obj 119 203 array set array-help-2, f 12;
+#X msg 119 117 0.1 0.2 0.3 0.4 0.3 0.2 0.1;
+#X text 45 19 "array set" sets values of an array from an incoming
+list \, starting from a specified onset (0 by default). The size of
+the array is not changed -- values that would be written past the end
+of the array are dropped.;
+#X floatatom 165 143 5 0 0 0 - - -, f 5;
+#X text 215 141 onset (first index to write to);
+#X text 252 244 - optional number to initialize onset - default 0;
+#X text 256 207 creation arguments: either array name or "-s" and optional
+"-f" flags to refer to an array in a data structure;
+#X text 349 118 list of values to write to array;
+#X text 56 265 (array-help-2 is defined in the "define" subwindow).
+;
+#X msg 212 170 symbol array-help-2;
+#X text 376 169 set name or pointer;
+#X connect 1 0 0 0;
+#X connect 3 0 0 1;
+#X connect 9 0 0 2;
+#X restore 486 308 pd set;
+#X text 194 285 - get contents as a list;
+#X text 194 309 - set contents from a list;
+#X text 212 333 - get a quantile;
+#X obj 90 356 array random;
+#N canvas 102 243 816 629 quantile+random 0;
+#X floatatom 75 177 5 0 100 0 - - -, f 5;
+#X obj 39 251 array quantile array-help-3, f 14;
+#N canvas 0 50 450 250 (subpatch) 0;
+#X array array-help-3 100 float 3;
+#A 0 0 0 0 0 0 0 0 0 0 0 0 0.00715053 0.00715053 0.0285789 0.0500072
+0.0714356 0.100007 0.128578 0.164292 0.207148 0.478574 0.628573 0.678572
+0.721429 0.717857 0.714286 0.707143 0.7 0.692857 0.685715 0.678572
+0.18572 0.164292 0.157149 0.0142931 -0.00713521 0 0 0 0 0 0 0 0 0 0
+0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0.014293 0.0214357 0.0357213 0.078578
+0.142863 0.207148 0.335718 0.407146 0.435717 0.478574 0.514288 0.557144
+0.592858 0.642858 0.7 0.692857 0.692857 0.692857 0.692857 0.7 0.696429
+0.349997 0.335712 0.321426 0.278569 0.192856 0.149999 0.135714 0.114285
+0.0999998 0.0714298 0.0642871 0.0571443 0.0285732 0 0 0 0 0;
+#X coords 0 1 99 0 200 140 1 0 0;
+#X restore 37 375 graph;
+#X floatatom 111 198 5 -1 100 0 - - -, f 5;
+#X msg 43 524 \; array-help-3 const 0;
+#X floatatom 39 131 5 -1 100 0 - - -, f 5;
+#X obj 39 152 / 100;
+#X floatatom 39 295 5 0 100 0 - - -, f 5;
+#X floatatom 368 599 5 0 100 0 - - -, f 5;
+#X obj 370 555 array random array-help-3, f 13;
+#X obj 370 435 bng 15 250 50 0 empty empty empty 17 7 0 10 -262144
+-1 -1;
+#X floatatom 383 484 5 0 0 0 - - -, f 5;
+#X floatatom 420 507 5 0 0 0 - - -, f 5;
+#X text 303 358 "array random" makes a pseudo-random numbver from 0
+to 1 and outputs its quantile (which will therefore have probabilities
+proportional to the table's values.);
+#X text 394 430 bang to generate a random value;
+#X msg 377 456 seed 56;
+#X text 445 456 set random seed;
+#X text 170 286 - optional number to initialize onset - default 0;
+#X text 169 305 - optional number to initialize number of points -
+default -1, f 61;
+#X text 494 569 same creation arguments;
+#X text 174 249 creation arguments: either array name or "-s" and optional
+"-f" flags to refer to an array in a data structure;
+#X text 120 174 onset (first index to sum from) \, zero for start of
+array;
+#X text 160 196 number of points or -1 for end of array;
+#X text 130 5 "array quantile" outputs the specified quantile of the
+array - so for instance \, the 0.5 quantile is the median of the array.
+This generalizes the "array random" function allowing you to use the
+same source of randomness on several arrays \, for example. Negative
+numbers in the array are silently replaced by zero. Quantiles outside
+the range 0-1 output the x values at the two extremes of the array
+(0 and 99 here).;
+#X text 428 481 onset;
+#X text 466 505 number of points;
+#X text 88 130 quantile (between 0 and 1);
+#X msg 149 218 symbol array-help-2;
+#X text 313 217 set name or pointer;
+#X msg 471 529 symbol array-help-2;
+#X text 635 528 set name or pointer;
+#X connect 0 0 1 1;
+#X connect 1 0 7 0;
+#X connect 3 0 1 2;
+#X connect 5 0 6 0;
+#X connect 6 0 1 0;
+#X connect 9 0 8 0;
+#X connect 10 0 9 0;
+#X connect 11 0 9 0;
+#X connect 12 0 9 1;
+#X connect 15 0 9 0;
+#X connect 27 0 1 3;
+#X connect 29 0 9 2;
+#X restore 485 346 pd quantile+random;
+#X text 195 356 - random - array as probabilities;
+#X text 444 471 updated for Pd version 0.45;
+#X obj 90 379 array max;
+#N canvas 727 168 744 595 min+max 0;
+#N canvas 0 50 450 250 (subpatch) 0;
+#X array array-help-4 100 float 3;
+#A 0 0.335714 0.37857 0.421427 0.442855 0.478569 0.521426 0.535711
+0.55714 0.585711 0.599997 0.614282 0.63571 0.649996 0.664282 0.671424
+0.699995 0.699995 0.714281 0.721424 0.707138 0.699995 0.692853 0.68571
+0.671424 0.649996 0.628568 0.599997 0.571425 0.514283 0.471426 0.414284
+0.385713 0.357142 0.328571 0.3 0.285714 0.271429 0.25 0.228572 0.214286
+0.207143 0.200001 0.185715 0.17143 0.164287 0.157144 0.150001 0.135716
+0.128573 0.12143 0.12143 0.114287 0.114287 0.114287 0.114287 0.114287
+0.12143 0.125001 0.128573 0.128573 0.135716 0.139287 0.142858 0.150001
+0.157144 0.157144 0.164287 0.17143 0.200001 0.214286 0.228572 0.235715
+0.242857 0.257143 0.271429 0.285714 0.307142 0.321428 0.335714 0.357142
+0.371427 0.385713 0.399999 0.407141 0.414284 0.421427 0.42857 0.435713
+0.442855 0.457141 0.460712 0.464284 0.471426 0.478569 0.485712 0.499998
+0.50714 0.514283 0.521426 0.528569;
+#X coords 0 1 99 0 200 140 1 0 0;
+#X restore 382 386 graph;
+#X floatatom 55 275 7 0 100 0 - - -, f 7;
+#X obj 57 136 bng 15 250 50 0 empty empty empty 17 7 0 10 -262144 -1
+-1;
+#X floatatom 70 159 5 0 0 0 - - -, f 5;
+#X floatatom 107 182 5 0 0 0 - - -, f 5;
+#X text 179 264 - optional number to initialize onset - default 0;
+#X text 178 283 - optional number to initialize number of points -
+default -1, f 61;
+#X text 173 229 creation arguments: either array name or "-s" and optional
+"-f" flags to refer to an array in a data structure;
+#X text 115 156 onset;
+#X text 153 180 number of points;
+#X msg 158 204 symbol array-help-2;
+#X text 322 205 set name or pointer;
+#X obj 57 230 array max array-help-4, f 13;
+#X floatatom 123 275 5 0 100 0 - - -, f 5;
+#X text 79 133 bang to find maximum;
+#X text 130 5 "array max" and "array min" find the maximum and minimum
+values in the array \, respectively. The first outlet is the value
+and the second is the index (the x location where the value was found).
+The search may be restricted to a sub-domain of the array by specifying
+the "onset" and "number of points".;
+#X floatatom 52 497 7 0 100 0 - - -, f 7;
+#X obj 54 358 bng 15 250 50 0 empty empty empty 17 7 0 10 -262144 -1
+-1;
+#X floatatom 67 381 5 0 0 0 - - -, f 5;
+#X floatatom 104 404 5 0 0 0 - - -, f 5;
+#X text 112 378 onset;
+#X floatatom 120 497 5 0 100 0 - - -, f 5;
+#X text 76 355 bang to find minimum;
+#X text 153 402 number of points;
+#X obj 54 452 array min array-help-4, f 13;
+#X text 54 298 value;
+#X text 118 299 index;
+#X connect 2 0 12 0;
+#X connect 3 0 12 0;
+#X connect 4 0 12 1;
+#X connect 10 0 12 2;
+#X connect 12 0 1 0;
+#X connect 12 1 13 0;
+#X connect 17 0 24 0;
+#X connect 18 0 24 0;
+#X connect 19 0 24 1;
+#X connect 24 0 16 0;
+#X connect 24 1 21 0;
+#X restore 480 392 pd min+max;
+#X obj 90 402 array min;
+#X text 194 403 - min - find lowest value;
+#X text 193 384 - max - find highest value;

pd/doc/5.reference/array-object-help.txt

+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0.00666678
+0.060001
+0.173336
+0.540009
+-0.0266671
+-0.20667
+-0.406674
+-0.713345
+-0.833347
+-0.933349
+-1.04668
+-0.980017
+-0.800014
+-0.686678
+-0.526676
+-0.443341
+-0.360006
+-0.20667
+-0.140002
+-0.0733346
+-0.00666678
+0.060001
+0.173336
+0.313339
+0.400007
+0.433341
+0.39334
+0.293338
+0.18667
+0.0800014
+0.0400007
+0.060001
+0.0733346
+0.0933349
+0.113335
+0.126669
+0.100002
+0.0666678
+0.0400007
+0.0200003
+0.0200003
+-0.0400007
+-0.0266671
+-0.00666678
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0
+0

pd/doc/5.reference/clone-help.pd

+#N canvas 155 58 847 810 12;
+#X floatatom 218 329 5 36 144 0 - - -, f 5;
+#X obj 218 350 t b f;
+#X obj 218 374 f;
+#X obj 218 398 + 1;
+#X obj 218 422 mod 16;
+#X obj 218 446 pack;
+#X msg 327 422 next \$1;
+#X floatatom 327 402 5 36 144 0 - - -, f 5;
+#X floatatom 327 452 5 36 144 0 - - -, f 5;
+#X msg 327 471 this \$1;
+#X floatatom 326 499 5 36 144 0 - - -, f 5;
+#X msg 326 518 set \$1;
+#X msg 80 397 vis 5 1;
+#X msg 79 425 vis 5 0;
+#X floatatom 325 545 5 36 144 0 - - -, f 5;
+#X msg 325 566 all \$1;
+#X obj 178 662 ../3.audio.examples/output~;
+#X text 597 749 updated for Pd version 0.47;
+#X text 496 579 creation arguments:;
+#X text 26 610 click to open ->;
+#X text 14 632 (first copy only);
+#X text 67 351 open or close copy number 5:, f 14;
+#X text 276 326 A list beginning with a number dispatches the rest
+of the list as a message, f 23;
+#X text 403 392 "next" forwards a message to the next instance (incrementing
+and repeating circularly)., f 33;
+#X text 407 445 "this" forwards a message to the previous instance
+sent to by "this" or "next", f 30;
+#X text 391 500 "set" sets the "next"/"this" counter;
+#X text 386 546 "all" broadcasts a message to all instances;
+#X text 24 8 clone - make multiple copies of a patch;
+#X text 20 170 clone's inlets and outlets correspond to those of the
+contained patch \, and may be signal and/or control inlets and outlets.
+(In this example there's one control inlet and one signal outlet).
+You can click on the clone~ object to see the first of the created
+instances., f 72;
+#X obj 179 609 clone clone-subpatch 16;
+#X text 30 734 note: for backward compatibility \, you can also invoke
+this as "clone clone-subpatch 16" (for instance) \, swapping the abstraction
+name and the mumber of voices.;
+#X text 19 247 Signal inlets are copied to all the instances. Control
+inlets forward messages as shown below. Signal outlets output the sum
+of all instances' outputs \, and control outlets forward messages with
+the number of the instance prepended to them., f 67;
+#X text 418 605 optional "-s #" to set starting voice number \; optional
+-x to avoid setting \$1 to voice number \; filename \; number of copies
+\; optional arguments to copies;
+#X text 21 36 clone creates any number of copies of a desired abstraction
+(a patch loaded as an object in another patch). Within each copy \,
+"\$1" is set to the instance number. (These count from 0 unless overridden
+by the "-s" option in the creation arguments. You can avoid this behavior
+using the "-x" option.), f 71;
+#X text 23 129 You can pass additional arguments to the copies that
+appear as \$2 and onward (or \$1 and onward with "-x" option)., f
+71;
+#X connect 0 0 1 0;
+#X connect 1 0 2 0;
+#X connect 1 1 5 1;
+#X connect 2 0 3 0;
+#X connect 3 0 4 0;
+#X connect 4 0 2 1;
+#X connect 4 0 5 0;
+#X connect 5 0 29 0;
+#X connect 6 0 29 0;
+#X connect 7 0 6 0;
+#X connect 8 0 9 0;
+#X connect 9 0 29 0;
+#X connect 10 0 11 0;
+#X connect 11 0 29 0;
+#X connect 12 0 29 0;
+#X connect 13 0 29 0;
+#X connect 14 0 15 0;
+#X connect 15 0 29 0;
+#X connect 29 0 16 0;
+#X connect 29 0 16 1;

pd/doc/5.reference/clone-subpatch.pd

+#N canvas 647 320 470 387 10;
+#X obj 112 74 inlet;
+#X obj 112 171 osc~;
+#X obj 112 224 outlet~;
+#X obj 112 193 *~;
+#X obj 257 195 *~;
+#X obj 257 223 *~;
+#X obj 257 167 line~;
+#X obj 256 122 del 10;
+#X obj 112 96 t f b;
+#X obj 112 118 mtof;
+#X obj 256 144 pack 0 4000;
+#X obj 175 124 pack 1 10;
+#X text 32 26 This is the subpatch for the clone help patch. It plays
+tones at pitches sent to its inlet.;
+#X obj 333 303 float \$1;
+#X obj 333 281 bng 15 250 50 0 empty empty empty 17 7 0 10 -262144
+-1 -1;
+#X obj 333 325 print;
+#X text 129 306 You can access the instance number within the patch:
+, f 27;
+#X connect 0 0 8 0;
+#X connect 1 0 3 0;
+#X connect 3 0 2 0;
+#X connect 4 0 5 0;
+#X connect 4 0 5 1;
+#X connect 5 0 3 1;
+#X connect 6 0 4 0;
+#X connect 6 0 4 1;
+#X connect 7 0 10 0;
+#X connect 8 0 9 0;
+#X connect 8 1 7 0;
+#X connect 8 1 11 0;
+#X connect 9 0 1 0;
+#X connect 10 0 6 0;
+#X connect 11 0 6 0;
+#X connect 13 0 15 0;
+#X connect 14 0 13 0;

pd/doc/5.reference/text-object-help.txt

+this is a message;
+this is another 1 ...;