Correct header guards and comments; Add param metadata rough out (sur…

…ge-synthesizer#32)

The header guards and comments put a lot of noise bu tthe param
metadata rough out is really the key feature here, ready for FX
refactoring

include/sst/basic-blocks/dsp/BlockInterpolators.h

@@ -1,23 +1,25 @@
 /*
- * sst-basic-blocks - a Surge Synth Team product
+ * sst-basic-blocks - an open source library of core audio utilities
+ * built by Surge Synth Team.
  *
- * Provides basic tools and blocks for use on the audio thread in
- * synthesis, including basic DSP and modulation functions
+ * Provides a collection of tools useful on the audio thread for blocks,
+ * modulation, etc... or useful for adapting code to multiple environments.
  *
- * Copyright 2019 - 2023, Various authors, as described in the github
- * transaction log.
+ * Copyright 2023, various authors, as described in the GitHub
+ * transaction log. Parts of this code are derived from similar
+ * functions original in Surge or ShortCircuit.
  *
- * sst-basic-blocks is released under the Gnu General Public Licence
- * V3 or later (GPL-3.0-or-later). The license is found in the file
- * "LICENSE" in the root of this repository or at
+ * sst-basic-blocks is released under the GNU General Public Licence v3
+ * or later (GPL-3.0-or-later). The license is found in the "LICENSE"
+ * file in the root of this repository, or at
  * https://www.gnu.org/licenses/gpl-3.0.en.html
  *
- * All source for sst-basic-blocks is available at
+ * All source in sst-basic-blocks available at
  * https://github.com/surge-synthesizer/sst-basic-blocks
  */
 
-#ifndef SST_BASIC_BLOCKS_DSP_BLOCK_INTERPOLATORS_H
-#define SST_BASIC_BLOCKS_DSP_BLOCK_INTERPOLATORS_H
+#ifndef INCLUDE_SST_BASIC_BLOCKS_DSP_BLOCKINTERPOLATORS_H
+#define INCLUDE_SST_BASIC_BLOCKS_DSP_BLOCKINTERPOLATORS_H
 
 #include <cassert>
 

include/sst/basic-blocks/dsp/Clippers.h

@@ -1,23 +1,25 @@
 /*
-* sst-basic-blocks - a Surge Synth Team product
-*
-* Provides basic tools and blocks for use on the audio thread in
-* synthesis, including basic DSP and modulation functions
-*
-* Copyright 2019 - 2023, Various authors, as described in the github
-* transaction log.
-*
-* sst-basic-blocks is released under the Gnu General Public Licence
-* V3 or later (GPL-3.0-or-later). The license is found in the file
-* "LICENSE" in the root of this repository or at
-* https://www.gnu.org/licenses/gpl-3.0.en.html
-*
-* All source for sst-basic-blocks is available at
-* https://github.com/surge-synthesizer/sst-basic-blocks
-*/
-
-#ifndef SST_BASICBLOCKS_DSP_CLIPPERS_H
-#define SST_BASICBLOCKS_DSP_CLIPPERS_H
+ * sst-basic-blocks - an open source library of core audio utilities
+ * built by Surge Synth Team.
+ *
+ * Provides a collection of tools useful on the audio thread for blocks,
+ * modulation, etc... or useful for adapting code to multiple environments.
+ *
+ * Copyright 2023, various authors, as described in the GitHub
+ * transaction log. Parts of this code are derived from similar
+ * functions original in Surge or ShortCircuit.
+ *
+ * sst-basic-blocks is released under the GNU General Public Licence v3
+ * or later (GPL-3.0-or-later). The license is found in the "LICENSE"
+ * file in the root of this repository, or at
+ * https://www.gnu.org/licenses/gpl-3.0.en.html
+ *
+ * All source in sst-basic-blocks available at
+ * https://github.com/surge-synthesizer/sst-basic-blocks
+ */
+
+#ifndef INCLUDE_SST_BASIC_BLOCKS_DSP_CLIPPERS_H
+#define INCLUDE_SST_BASIC_BLOCKS_DSP_CLIPPERS_H
 
 namespace sst::basic_blocks::dsp
 {

include/sst/basic-blocks/dsp/CorrelatedNoise.h

@@ -1,23 +1,25 @@
 /*
- * sst-basic-blocks - a Surge Synth Team product
+ * sst-basic-blocks - an open source library of core audio utilities
+ * built by Surge Synth Team.
  *
- * Provides basic tools and blocks for use on the audio thread in
- * synthesis, including basic DSP and modulation functions
+ * Provides a collection of tools useful on the audio thread for blocks,
+ * modulation, etc... or useful for adapting code to multiple environments.
  *
- * Copyright 2019 - 2023, Various authors, as described in the github
- * transaction log.
+ * Copyright 2023, various authors, as described in the GitHub
+ * transaction log. Parts of this code are derived from similar
+ * functions original in Surge or ShortCircuit.
  *
- * sst-basic-blocks is released under the Gnu General Public Licence
- * V3 or later (GPL-3.0-or-later). The license is found in the file
- * "LICENSE" in the root of this repository or at
+ * sst-basic-blocks is released under the GNU General Public Licence v3
+ * or later (GPL-3.0-or-later). The license is found in the "LICENSE"
+ * file in the root of this repository, or at
  * https://www.gnu.org/licenses/gpl-3.0.en.html
  *
- * All source for sst-basic-blocks is available at
+ * All source in sst-basic-blocks available at
  * https://github.com/surge-synthesizer/sst-basic-blocks
  */
 
-#ifndef SST_BASIC_BLOCKS_DSP_CORRELATEDNOISE_H
-#define SST_BASIC_BLOCKS_DSP_CORRELATEDNOISE_H
+#ifndef INCLUDE_SST_BASIC_BLOCKS_DSP_CORRELATEDNOISE_H
+#define INCLUDE_SST_BASIC_BLOCKS_DSP_CORRELATEDNOISE_H
 
 #include <functional>
 #include <cmath>

include/sst/basic-blocks/dsp/FastMath.h

@@ -1,23 +1,25 @@
 /*
- * sst-basic-blocks - a Surge Synth Team product
+ * sst-basic-blocks - an open source library of core audio utilities
+ * built by Surge Synth Team.
  *
- * Provides basic tools and blocks for use on the audio thread in
- * synthesis, including basic DSP and modulation functions
+ * Provides a collection of tools useful on the audio thread for blocks,
+ * modulation, etc... or useful for adapting code to multiple environments.
  *
- * Copyright 2019 - 2023, Various authors, as described in the github
- * transaction log.
+ * Copyright 2023, various authors, as described in the GitHub
+ * transaction log. Parts of this code are derived from similar
+ * functions original in Surge or ShortCircuit.
  *
- * sst-basic-blocks is released under the Gnu General Public Licence
- * V3 or later (GPL-3.0-or-later). The license is found in the file
- * "LICENSE" in the root of this repository or at
+ * sst-basic-blocks is released under the GNU General Public Licence v3
+ * or later (GPL-3.0-or-later). The license is found in the "LICENSE"
+ * file in the root of this repository, or at
  * https://www.gnu.org/licenses/gpl-3.0.en.html
  *
- * All source for sst-basic-blocks is available at
+ * All source in sst-basic-blocks available at
  * https://github.com/surge-synthesizer/sst-basic-blocks
  */
 
-#ifndef SST_BASIC_BLOCKS_DSP_FAST_MATH_H
-#define SST_BASIC_BLOCKS_DSP_FAST_MATH_H
+#ifndef INCLUDE_SST_BASIC_BLOCKS_DSP_FASTMATH_H
+#define INCLUDE_SST_BASIC_BLOCKS_DSP_FASTMATH_H
 
 #include <cmath>
 

include/sst/basic-blocks/dsp/Interpolators.h

@@ -1,23 +1,25 @@
 /*
- * sst-basic-blocks - a Surge Synth Team product
+ * sst-basic-blocks - an open source library of core audio utilities
+ * built by Surge Synth Team.
  *
- * Provides basic tools and blocks for use on the audio thread in
- * synthesis, including basic DSP and modulation functions
+ * Provides a collection of tools useful on the audio thread for blocks,
+ * modulation, etc... or useful for adapting code to multiple environments.
  *
- * Copyright 2019 - 2023, Various authors, as described in the github
- * transaction log.
+ * Copyright 2023, various authors, as described in the GitHub
+ * transaction log. Parts of this code are derived from similar
+ * functions original in Surge or ShortCircuit.
  *
- * sst-basic-blocks is released under the Gnu General Public Licence
- * V3 or later (GPL-3.0-or-later). The license is found in the file
- * "LICENSE" in the root of this repository or at
+ * sst-basic-blocks is released under the GNU General Public Licence v3
+ * or later (GPL-3.0-or-later). The license is found in the "LICENSE"
+ * file in the root of this repository, or at
  * https://www.gnu.org/licenses/gpl-3.0.en.html
  *
- * All source for sst-basic-blocks is available at
+ * All source in sst-basic-blocks available at
  * https://github.com/surge-synthesizer/sst-basic-blocks
  */
 
-#ifndef SST_BASIC_BLOCKS_DSP_INTERPOLATORS_H
-#define SST_BASIC_BLOCKS_DSP_INTERPOLATORS_H
+#ifndef INCLUDE_SST_BASIC_BLOCKS_DSP_INTERPOLATORS_H
+#define INCLUDE_SST_BASIC_BLOCKS_DSP_INTERPOLATORS_H
 
 namespace sst::basic_blocks::dsp
 {

include/sst/basic-blocks/dsp/Lag.h

@@ -1,23 +1,25 @@
 /*
-* sst-basic-blocks - a Surge Synth Team product
-*
-* Provides basic tools and blocks for use on the audio thread in
-* synthesis, including basic DSP and modulation functions
-*
-* Copyright 2019 - 2023, Various authors, as described in the github
-* transaction log.
-*
-* sst-basic-blocks is released under the Gnu General Public Licence
-* V3 or later (GPL-3.0-or-later). The license is found in the file
-* "LICENSE" in the root of this repository or at
-* https://www.gnu.org/licenses/gpl-3.0.en.html
-*
-* All source for sst-basic-blocks is available at
-* https://github.com/surge-synthesizer/sst-basic-blocks
-*/
+ * sst-basic-blocks - an open source library of core audio utilities
+ * built by Surge Synth Team.
+ *
+ * Provides a collection of tools useful on the audio thread for blocks,
+ * modulation, etc... or useful for adapting code to multiple environments.
+ *
+ * Copyright 2023, various authors, as described in the GitHub
+ * transaction log. Parts of this code are derived from similar
+ * functions original in Surge or ShortCircuit.
+ *
+ * sst-basic-blocks is released under the GNU General Public Licence v3
+ * or later (GPL-3.0-or-later). The license is found in the "LICENSE"
+ * file in the root of this repository, or at
+ * https://www.gnu.org/licenses/gpl-3.0.en.html
+ *
+ * All source in sst-basic-blocks available at
+ * https://github.com/surge-synthesizer/sst-basic-blocks
+ */
 
-#ifndef SST_BASIC_BLOCKS_DSP_LAG_H
-#define SST_BASIC_BLOCKS_DSP_LAG_H
+#ifndef INCLUDE_SST_BASIC_BLOCKS_DSP_LAG_H
+#define INCLUDE_SST_BASIC_BLOCKS_DSP_LAG_H
 
 namespace sst::basic_blocks::dsp
 {

include/sst/basic-blocks/dsp/LanczosResampler.h

@@ -1,23 +1,25 @@
 /*
-* sst-basic-blocks - a Surge Synth Team product
-*
-* Provides basic tools and blocks for use on the audio thread in
-* synthesis, including basic DSP and modulation functions
-*
-* Copyright 2019 - 2023, Various authors, as described in the github
-* transaction log.
-*
-* sst-basic-blocks is released under the Gnu General Public Licence
-* V3 or later (GPL-3.0-or-later). The license is found in the file
-* "LICENSE" in the root of this repository or at
-* https://www.gnu.org/licenses/gpl-3.0.en.html
-*
-* All source for sst-basic-blocks is available at
-* https://github.com/surge-synthesizer/sst-basic-blocks
-*/
-
-#ifndef SST_BASIC_BLOCKS_DSP_LANCZOSRESAMPLER_H
-#define SST_BASIC_BLOCKS_DSP_LANCZOSRESAMPLER_H
+ * sst-basic-blocks - an open source library of core audio utilities
+ * built by Surge Synth Team.
+ *
+ * Provides a collection of tools useful on the audio thread for blocks,
+ * modulation, etc... or useful for adapting code to multiple environments.
+ *
+ * Copyright 2023, various authors, as described in the GitHub
+ * transaction log. Parts of this code are derived from similar
+ * functions original in Surge or ShortCircuit.
+ *
+ * sst-basic-blocks is released under the GNU General Public Licence v3
+ * or later (GPL-3.0-or-later). The license is found in the "LICENSE"
+ * file in the root of this repository, or at
+ * https://www.gnu.org/licenses/gpl-3.0.en.html
+ *
+ * All source in sst-basic-blocks available at
+ * https://github.com/surge-synthesizer/sst-basic-blocks
+ */
+
+#ifndef INCLUDE_SST_BASIC_BLOCKS_DSP_LANCZOSRESAMPLER_H
+#define INCLUDE_SST_BASIC_BLOCKS_DSP_LANCZOSRESAMPLER_H
 
 
 #include <algorithm>

include/sst/basic-blocks/dsp/MidSide.h

@@ -1,23 +1,25 @@
 /*
-* sst-basic-blocks - a Surge Synth Team product
-*
-* Provides basic tools and blocks for use on the audio thread in
-* synthesis, including basic DSP and modulation functions
-*
-* Copyright 2019 - 2023, Various authors, as described in the github
-* transaction log.
-*
-* sst-basic-blocks is released under the Gnu General Public Licence
-* V3 or later (GPL-3.0-or-later). The license is found in the file
-* "LICENSE" in the root of this repository or at
-* https://www.gnu.org/licenses/gpl-3.0.en.html
-*
-* All source for sst-basic-blocks is available at
-* https://github.com/surge-synthesizer/sst-basic-blocks
+ * sst-basic-blocks - an open source library of core audio utilities
+ * built by Surge Synth Team.
+ *
+ * Provides a collection of tools useful on the audio thread for blocks,
+ * modulation, etc... or useful for adapting code to multiple environments.
+ *
+ * Copyright 2023, various authors, as described in the GitHub
+ * transaction log. Parts of this code are derived from similar
+ * functions original in Surge or ShortCircuit.
+ *
+ * sst-basic-blocks is released under the GNU General Public Licence v3
+ * or later (GPL-3.0-or-later). The license is found in the "LICENSE"
+ * file in the root of this repository, or at
+ * https://www.gnu.org/licenses/gpl-3.0.en.html
+ *
+ * All source in sst-basic-blocks available at
+ * https://github.com/surge-synthesizer/sst-basic-blocks
  */
 
-#ifndef SST_BASICBLOCKS_DSP_MIDSIDE_H
-#define SST_BASICBLOCKS_DSP_MIDSIDE_H
+#ifndef INCLUDE_SST_BASIC_BLOCKS_DSP_MIDSIDE_H
+#define INCLUDE_SST_BASIC_BLOCKS_DSP_MIDSIDE_H
 
 namespace sst::basic_blocks::dsp
 {

include/sst/basic-blocks/dsp/PanLaws.h

@@ -1,23 +1,25 @@
 /*
- * sst-basic-blocks - a Surge Synth Team product
+ * sst-basic-blocks - an open source library of core audio utilities
+ * built by Surge Synth Team.
  *
- * Provides basic tools and blocks for use on the audio thread in
- * synthesis, including basic DSP and modulation functions
+ * Provides a collection of tools useful on the audio thread for blocks,
+ * modulation, etc... or useful for adapting code to multiple environments.
  *
- * Copyright 2019 - 2023, Various authors, as described in the github
- * transaction log.
+ * Copyright 2023, various authors, as described in the GitHub
+ * transaction log. Parts of this code are derived from similar
+ * functions original in Surge or ShortCircuit.
  *
- * sst-basic-blocks is released under the Gnu General Public Licence
- * V3 or later (GPL-3.0-or-later). The license is found in the file
- * "LICENSE" in the root of this repository or at
+ * sst-basic-blocks is released under the GNU General Public Licence v3
+ * or later (GPL-3.0-or-later). The license is found in the "LICENSE"
+ * file in the root of this repository, or at
  * https://www.gnu.org/licenses/gpl-3.0.en.html
  *
- * All source for sst-basic-blocks is available at
+ * All source in sst-basic-blocks available at
  * https://github.com/surge-synthesizer/sst-basic-blocks
  */
 
-#ifndef SST_BASIC_BLOCKS_DSP_PANLAWS_H
-#define SST_BASIC_BLOCKS_DSP_PANLAWS_H
+#ifndef INCLUDE_SST_BASIC_BLOCKS_DSP_PANLAWS_H
+#define INCLUDE_SST_BASIC_BLOCKS_DSP_PANLAWS_H
 
 #include <cmath>
 

include/sst/basic-blocks/dsp/QuadratureOscillators.h

@@ -1,23 +1,25 @@
 /*
- * sst-basic-blocks - a Surge Synth Team product
+ * sst-basic-blocks - an open source library of core audio utilities
+ * built by Surge Synth Team.
  *
- * Provides basic tools and blocks for use on the audio thread in
- * synthesis, including basic DSP and modulation functions
+ * Provides a collection of tools useful on the audio thread for blocks,
+ * modulation, etc... or useful for adapting code to multiple environments.
  *
- * Copyright 2019 - 2023, Various authors, as described in the github
- * transaction log.
+ * Copyright 2023, various authors, as described in the GitHub
+ * transaction log. Parts of this code are derived from similar
+ * functions original in Surge or ShortCircuit.
  *
- * sst-basic-blocks is released under the Gnu General Public Licence
- * V3 or later (GPL-3.0-or-later). The license is found in the file
- * "LICENSE" in the root of this repository or at
+ * sst-basic-blocks is released under the GNU General Public Licence v3
+ * or later (GPL-3.0-or-later). The license is found in the "LICENSE"
+ * file in the root of this repository, or at
  * https://www.gnu.org/licenses/gpl-3.0.en.html
  *
- * All source for sst-basic-blocks is available at
+ * All source in sst-basic-blocks available at
  * https://github.com/surge-synthesizer/sst-basic-blocks
  */
 
-#ifndef SST_BASICBLOCKS_DSP_QUADRATUREOSCILLATORS_H
-#define SST_BASICBLOCKS_DSP_QUADRATUREOSCILLATORS_H
+#ifndef INCLUDE_SST_BASIC_BLOCKS_DSP_QUADRATUREOSCILLATORS_H
+#define INCLUDE_SST_BASIC_BLOCKS_DSP_QUADRATUREOSCILLATORS_H
 
 #include <cmath>