diff --git a/src/math.jl b/src/math.jl
index 20db13a84ad145f5b19fe03a7c69db77fb4a447a..95883c1cba7d18aa05f5bd80245969b5f668f9ed 100644
--- a/src/math.jl
+++ b/src/math.jl
@@ -95,7 +95,10 @@ the Fibonacci lattice.
 fibonaccisphere(α::Float64) = fibonaccisphere(Int(ceil((195.39/α)^2)))
 
 """
-Create `S` directions inside a cone with an opening angle of `θ` [deg] which points towards `dir`.
+
+Create `S` directions inside a cone with an opening angle of `θ` [deg] (angle
+between cone axis and its surface) which points towards `dir`.
+
 """
 function fibonaccicone(dir::Direction{Float64}, S::Integer, θ::Float64)
     N = Int(ceil(S / sin(deg2rad(θ)/2)^2))
@@ -116,8 +119,9 @@ end
 
 """
 
-Creates directions with a median angular separation of `α` [deg] inside a cone with an
-opening angle of `θ` [deg] pointing towards `dir`.
+Creates directions with a median angular separation of `α` [deg] inside a cone
+with an opening angle of `θ` [deg] (angle between the cone axis and its surface)
+pointing towards `dir`.
 
 """
 function fibonaccicone(dir::Direction{Float64}, α::Float64, θ::Float64)