deprecate clip~

cyclone_objects/binaries/audio/clip.c

@@ -95,6 +95,8 @@ CYCLONE_OBJ_API void clip_tilde_setup(void)
     class_addmethod(clip_class, nullfn, gensym("signal"), 0);
     class_addmethod(clip_class, (t_method) clip_dsp, gensym("dsp"), A_CANT, 0);
     class_sethelpsymbol(clip_class, gensym("clip~"));
+    pd_error(clip_class, "[cyclone/clip~] is deprecated, consider using vanilla's [clip~] instead");
+
 }
 
 CYCLONE_OBJ_API void Clip_tilde_setup(void)
@@ -105,4 +107,5 @@ CYCLONE_OBJ_API void Clip_tilde_setup(void)
     class_addmethod(clip_class, (t_method) clip_dsp, gensym("dsp"), A_CANT, 0);
     class_sethelpsymbol(clip_class, gensym("clip~"));
     pd_error(clip_class, "Cyclone: please use [cyclone/clip~] instead of [Clip~] to suppress this error");
+    pd_error(clip_class, "[cyclone/clip~] is deprecated, consider using vanilla's [clip~] instead");
 }

documentation/extra_files/CHANGELOG.txt

@@ -20,7 +20,7 @@ cyclone 0.8-0 (needs at least Pd Vanilla 0.54-0):
 
 - made [minimum~] and [maximum~] deprecated, as they're basically the same as Vanilla's [min~] and [max~], with the advantage that vanilla's [min~]/[max~] can take multichannel signals as of Pd 0.54-0.
 
-- also made [pow~] deprecated, as they're quite similar to Vanilla's [pow~], also there's the advantage that vanilla's [pow~] can take multichannel signals.
+- also made [pow~] and [clip~] deprecated, as they're quite similar to Vanilla's [pow~] and [clip~], also there's the advantage that vanilla's [pow~]/[clip~] can take multichannel signals.
 
 
 --------------------------------------------------

documentation/help_files/clip~-help.pd

@@ -1,48 +1,51 @@
-#N canvas 569 56 564 613 10;
-#X obj 6 587 cnv 15 552 21 empty empty empty 20 12 0 14 #e0e0e0 #202020 0;
-#X obj 6 412 cnv 3 550 3 empty empty inlets 8 12 0 13 #dcdcdc #000000 0;
-#X obj 6 499 cnv 3 550 3 empty empty outlets 8 12 0 13 #dcdcdc #000000 0;
-#X obj 6 536 cnv 3 550 3 empty empty arguments 8 12 0 13 #dcdcdc #000000 0;
-#X obj 94 509 cnv 17 3 17 empty empty 0 5 9 0 16 #dcdcdc #9c9c9c 0;
-#X text 161 425 signal;
-#X text 160 508 signal;
-#X obj 95 425 cnv 17 3 17 empty empty 0 5 9 0 16 #dcdcdc #9c9c9c 0;
-#X obj 94 447 cnv 17 3 17 empty empty 1 5 9 0 16 #dcdcdc #9c9c9c 0;
-#X obj 93 469 cnv 17 3 17 empty empty 2 5 9 0 16 #dcdcdc #9c9c9c 0;
-#X obj 231 167 hsl 128 15 -1 1 0 0 empty empty empty -2 -8 0 10 #dcdcdc #000000 #000000 0 1;
-#X floatatom 228 191 5 0 0 0 - - - 0;
-#X obj 284 198 hsl 128 15 -1 1 0 0 empty empty empty -2 -8 0 10 #dcdcdc #000000 #000000 0 1;
-#X floatatom 281 220 5 0 0 0 - - - 0;
-#X text 124 470 float/signal;
-#X text 150 544 1) float;
-#X text 150 565 2) float;
-#X text 125 448 float/signal;
-#X obj 176 245 cyclone/clip~ -1 1;
-#X text 326 198 maximum;
-#X text 270 166 minimum;
-#X obj 176 286 scope~ 194 111 10 3 128 -1 1 0 0 0 0 205 229 232 74 79 77 96 98 102 0 empty;
-#X text 379 280 1;
-#X text 378 334 0;
-#X text 373 387 -1;
-#X obj 151 180 osc~ 240;
-#X text 216 508 - clipped signal;
-#X text 216 565 - sets maximum value (default 0);
-#X text 216 543 - sets minimum value (default 0);
-#X text 216 425 - signal to be clipped/constrained;
-#X text 214 448 - minimum constrain value;
-#X text 214 470 - maximum constrain value;
-#X text 68 92 Use the [cyclone/clip~]* object to constrain input signals between two specified values (minimum and maximum). If the maximum value is less than the minimum \, it becomes the minimum value and vice-versa.;
+#N canvas 449 23 565 667 10;
+#X obj 6 637 cnv 15 552 21 empty empty empty 20 12 0 14 #e0e0e0 #202020 0;
+#X obj 6 462 cnv 3 550 3 empty empty inlets 8 12 0 13 #dcdcdc #000000 0;
+#X obj 6 549 cnv 3 550 3 empty empty outlets 8 12 0 13 #dcdcdc #000000 0;
+#X obj 6 586 cnv 3 550 3 empty empty arguments 8 12 0 13 #dcdcdc #000000 0;
+#X obj 94 559 cnv 17 3 17 empty empty 0 5 9 0 16 #dcdcdc #9c9c9c 0;
+#X text 161 475 signal;
+#X text 160 558 signal;
+#X obj 95 475 cnv 17 3 17 empty empty 0 5 9 0 16 #dcdcdc #9c9c9c 0;
+#X obj 94 497 cnv 17 3 17 empty empty 1 5 9 0 16 #dcdcdc #9c9c9c 0;
+#X obj 93 519 cnv 17 3 17 empty empty 2 5 9 0 16 #dcdcdc #9c9c9c 0;
+#X obj 231 217 hsl 128 15 -1 1 0 0 empty empty empty -2 -8 0 10 #dcdcdc #000000 #000000 0 1;
+#X floatatom 228 241 5 0 0 0 - - - 0;
+#X obj 284 248 hsl 128 15 -1 1 0 0 empty empty empty -2 -8 0 10 #dcdcdc #000000 #000000 0 1;
+#X floatatom 281 270 5 0 0 0 - - - 0;
+#X text 124 520 float/signal;
+#X text 150 594 1) float;
+#X text 150 615 2) float;
+#X text 125 498 float/signal;
+#X obj 176 295 cyclone/clip~ -1 1;
+#X text 326 248 maximum;
+#X text 270 216 minimum;
+#X obj 176 336 scope~ 194 111 10 3 128 -1 1 0 0 0 0 205 229 232 74 79 77 96 98 102 0 empty;
+#X text 379 330 1;
+#X text 378 384 0;
+#X text 373 437 -1;
+#X obj 151 230 osc~ 240;
+#X text 216 558 - clipped signal;
+#X text 216 615 - sets maximum value (default 0);
+#X text 216 593 - sets minimum value (default 0);
+#X text 216 475 - signal to be clipped/constrained;
+#X text 214 498 - minimum constrain value;
+#X text 214 520 - maximum constrain value;
+#X text 68 146 Use the [cyclone/clip~]* object to constrain input signals between two specified values (minimum and maximum). If the maximum value is less than the minimum \, it becomes the minimum value and vice-versa.;
 #X obj 501 69 cyclone/dsponoff~;
 #N canvas 836 207 415 225 name 0;
 #X text 198 172 <= from Pd Vanilla;
 #X text 30 135 And still create the vanilla object from vanilla without namespaces as:;
 #X text 31 16 Pd also has a vanilla object named [clip~]. Cyclone avoids name clashing and overwriting an internal in Pd Vanilla \, but for that you need to use the cyclone namespace ("cyclone/" before the object name) \, as it's the common practice for cyclone's documentation. So you create it as:;
 #X obj 148 97 cyclone/clip~;
 #X obj 161 172 clip~;
-#X restore 458 379 pd name clash;
-#X obj 54 322 output~;
+#X restore 458 429 pd name clash;
+#X obj 54 372 output~;
 #X obj 3 3 ./header clip~;
 #X text 25 59 Constrain a signal to a given range;
+#X obj 73 89 cnv 15 350 45 empty empty empty 20 12 0 14 #f0b8c4 #404040 0;
+#X text 128 92 Redundanct and deprecated object;
+#X text 123 112 Quite similar to Pd Vanilla's [clip~];
 #X connect 10 0 11 0;
 #X connect 11 0 18 1;
 #X connect 12 0 13 0;