comments added

src/ISM.jl

@@ -132,7 +132,7 @@ function ISM_RectangularRoom_core!(
     fs::T,                              # sampling frequeyncy
     order::Tuple{I,I},                  # order of reflections; min max
     Wd::T,                              # Window width
-    ISD::T,                             # Random displacement of image source
+    ISD::T,                             # Random displacement of image source position
     lrng::AbstractRNG;                  # random number generator
 ) where {T<:AbstractFloat, I<:Integer}
 

src/types.jl

@@ -7,9 +7,9 @@ export Node, Event
 abstract type AbstractRoom end
 
 struct RectangularRoom{T<:Real} <: AbstractRoom
-    c::T
-    L::Tuple{T,T,T}
-    β::Tuple{T,T,T,T,T,T}
+    c::T                    # Sound wave velocity
+    L::Tuple{T,T,T}         # size of room (x, y, z)
+    β::Tuple{T,T,T,T,T,T}   # absorption coeffictions for walls
 end