From 37c872786ee9a0ffae5fcbe483dd96402ecb0a15 Mon Sep 17 00:00:00 2001
From: Arthur Meyre <arthur.meyre@zama.ai>
Date: Wed, 3 Dec 2025 17:58:33 +0100
Subject: [PATCH] chore: add ref

---
 tfhe/src/core_crypto/commons/math/decomposition/iter.rs  | 1 +
 tfhe/src/core_crypto/fft_impl/fft128_u128/crypto/ggsw.rs | 3 +++
 2 files changed, 4 insertions(+)

diff --git a/tfhe/src/core_crypto/commons/math/decomposition/iter.rs b/tfhe/src/core_crypto/commons/math/decomposition/iter.rs
index 03a0a9976..503b0ca00 100644
--- a/tfhe/src/core_crypto/commons/math/decomposition/iter.rs
+++ b/tfhe/src/core_crypto/commons/math/decomposition/iter.rs
@@ -136,6 +136,7 @@ fn decomposition_bit_trick<Scalar: UnsignedInteger>(
     ((res.wrapping_sub(Scalar::ONE) | state) & res) >> (base_log - 1)
 }
 
+/// See [reference](https://eprint.iacr.org/2021/1161.pdf)
 #[inline]
 pub(crate) fn decompose_one_level<S: UnsignedInteger>(
     base_log: usize,
diff --git a/tfhe/src/core_crypto/fft_impl/fft128_u128/crypto/ggsw.rs b/tfhe/src/core_crypto/fft_impl/fft128_u128/crypto/ggsw.rs
index 0f56d0fe5..3aec972d5 100644
--- a/tfhe/src/core_crypto/fft_impl/fft128_u128/crypto/ggsw.rs
+++ b/tfhe/src/core_crypto/fft_impl/fft128_u128/crypto/ggsw.rs
@@ -235,6 +235,7 @@ pub fn add_external_product_assign_split<ContOutLo, ContOutHi, ContGgsw, ContGlw
     );
 }
 
+/// See [`collect_next_term_split_scalar`]
 #[cfg(any(target_arch = "x86", target_arch = "x86_64"))]
 #[cfg(feature = "avx512")]
 pub(crate) fn collect_next_term_split_avx512(
@@ -370,6 +371,7 @@ pub(crate) fn collect_next_term_split_avx512(
     });
 }
 
+/// See [`collect_next_term_split_scalar`]
 #[cfg(any(target_arch = "x86", target_arch = "x86_64"))]
 pub(crate) fn collect_next_term_split_avx2(
     simd: pulp::x86::V3,
@@ -511,6 +513,7 @@ pub(crate) fn collect_next_term_split_avx2(
     });
 }
 
+/// See [`crate::core_crypto::commons::math::decomposition::decompose_one_level`]
 pub(crate) fn collect_next_term_split_scalar(
     glwe_decomp_term_lo: &mut [u64],
     glwe_decomp_term_hi: &mut [u64],