From 618fb37113fd05cc11b5c04e761d58025a39f857 Mon Sep 17 00:00:00 2001
From: Stefano D'Angelo <s@dangelo.audio>
Date: Sat, 7 Jun 2025 09:45:41 +0200
Subject: [PATCH] add citation related to blep residuals in
 bw_osc_{pulse,saw,tri}

---
 include/bw_osc_pulse.h | 20 +++++++++++++++++---
 include/bw_osc_saw.h   | 20 +++++++++++++++++---
 include/bw_osc_tri.h   | 18 ++++++++++++++++--
 3 files changed, 50 insertions(+), 8 deletions(-)

diff --git a/include/bw_osc_pulse.h b/include/bw_osc_pulse.h
index 9704221..694a52c 100644
--- a/include/bw_osc_pulse.h
+++ b/include/bw_osc_pulse.h
@@ -1,7 +1,7 @@
 /*
  * Brickworks
  *
- * Copyright (C) 2022-2024 Orastron Srl unipersonale
+ * Copyright (C) 2022-2025 Orastron Srl unipersonale
  *
  * Brickworks is free software: you can redistribute it and/or modify
  * it under the terms of the GNU General Public License as published by
@@ -20,7 +20,7 @@
 
 /*!
  *  module_type {{{ dsp }}}
- *  version {{{ 1.2.0 }}}
+ *  version {{{ 1.2.1 }}}
  *  requires {{{ bw_common bw_math bw_one_pole }}}
  *  description {{{
  *    Pulse oscillator waveshaper with variable pulse width (actually, duty
@@ -33,10 +33,24 @@
  *
  *    V. Valimaki and A. Huovilainen, "Antialiasing Oscillators in Subtractive
  *    Synthesis", IEEE Signal Processing Magazine, vol. 24, no. 2, pp. 116-125,
- *    March 2007.
+ *    March 2007,
+ *
+ *    with residual polynomials essentially corresponding to those in Table VII
+ *    in
+ *
+ *    V. Valimaki and J. Pekonen, "Perceptually Informed Synthesis of
+ *    Bandlimited Classical Waveforms Using Integrated Polynomial
+ *    Interpolation", Journal of the Acoustical Society of America, vol. 131,
+ *    no. 1, pp. 974-986, January 2012.
  *  }}}
  *  changelog {{{
  *    <ul>
+ *      <li>Version <strong>1.2.1</strong>:
+ *        <ul>
+ *          <li>Added citation regarding BLEP residual polynomial in the module
+ *              description.</li>
+ *        </ul>
+ *      </li>
  *      <li>Version <strong>1.2.0</strong>:
  *        <ul>
  *          <li>Added support for <code>BW_INCLUDE_WITH_QUOTES</code>,
diff --git a/include/bw_osc_saw.h b/include/bw_osc_saw.h
index ea56dc8..3dd7aae 100644
--- a/include/bw_osc_saw.h
+++ b/include/bw_osc_saw.h
@@ -1,7 +1,7 @@
 /*
  * Brickworks
  *
- * Copyright (C) 2022-2024 Orastron Srl unipersonale
+ * Copyright (C) 2022-2025 Orastron Srl unipersonale
  *
  * Brickworks is free software: you can redistribute it and/or modify
  * it under the terms of the GNU General Public License as published by
@@ -20,7 +20,7 @@
 
 /*!
  *  module_type {{{ dsp }}}
- *  version {{{ 1.2.0 }}}
+ *  version {{{ 1.2.1 }}}
  *  requires {{{ bw_common bw_math }}}
  *  description {{{
  *    Sawtooth oscillator waveshaper with PolyBLEP antialiasing.
@@ -32,10 +32,24 @@
  *
  *    V. Valimaki and A. Huovilainen, "Antialiasing Oscillators in Subtractive
  *    Synthesis", IEEE Signal Processing Magazine, vol. 24, no. 2, pp. 116-125,
- *    March 2007.
+ *    March 2007,
+ *
+ *    with residual polynomials essentially corresponding to those in Table VII
+ *    in
+ *
+ *    V. Valimaki and J. Pekonen, "Perceptually Informed Synthesis of
+ *    Bandlimited Classical Waveforms Using Integrated Polynomial
+ *    Interpolation", Journal of the Acoustical Society of America, vol. 131,
+ *    no. 1, pp. 974-986, January 2012.
  *  }}}
  *  changelog {{{
  *    <ul>
+ *      <li>Version <strong>1.2.1</strong>:
+ *        <ul>
+ *          <li>Added citation regarding BLEP residual polynomial in the module
+ *              description.</li>
+ *        </ul>
+ *      </li>
  *      <li>Version <strong>1.2.0</strong>:
  *        <ul>
  *          <li>Added support for <code>BW_INCLUDE_WITH_QUOTES</code>,
diff --git a/include/bw_osc_tri.h b/include/bw_osc_tri.h
index f76ea5e..f4283e5 100644
--- a/include/bw_osc_tri.h
+++ b/include/bw_osc_tri.h
@@ -20,7 +20,7 @@
 
 /*!
  *  module_type {{{ dsp }}}
- *  version {{{ 1.2.1 }}}
+ *  version {{{ 1.2.2 }}}
  *  requires {{{ bw_common bw_math bw_one_pole }}}
  *  description {{{
  *    Triangle oscillator waveshaper with variable slope (increasing time over
@@ -33,10 +33,24 @@
  *
  *    V. Valimaki and A. Huovilainen, "Antialiasing Oscillators in Subtractive
  *    Synthesis", IEEE Signal Processing Magazine, vol. 24, no. 2, pp. 116-125,
- *    March 2007.
+ *    March 2007,
+ *
+ *    with residual polynomials essentially corresponding to those in Table VII
+ *    in
+ *
+ *    V. Valimaki and J. Pekonen, "Perceptually Informed Synthesis of
+ *    Bandlimited Classical Waveforms Using Integrated Polynomial
+ *    Interpolation", Journal of the Acoustical Society of America, vol. 131,
+ *    no. 1, pp. 974-986, January 2012.
  *  }}}
  *  changelog {{{
  *    <ul>
+ *      <li>Version <strong>1.2.2</strong>:
+ *        <ul>
+ *          <li>Added citation regarding BLEP residual polynomial in the module
+ *              description.</li>
+ *        </ul>
+ *      </li>
  *      <li>Version <strong>1.2.1</strong>:
  *        <ul>
  *          <li>Fixed typo in Changelog.</li>