Fix comments

Co-authored-by: konsumlamm <[email protected]>

Author: Shimuuar

vector/src/Data/Vector.hs

@@ -2119,7 +2119,11 @@ fromList :: [a] -> Vector a
 {-# INLINE fromList #-}
 fromList = G.fromList
 
--- | /O(n)/ Convert the first @n@ elements of a list to a vector.
+-- | /O(n)/ Convert the first @n@ elements of a list to a vector. It's
+-- expected that the supplied list will be exactly @n@ elements long. As
+-- an optimization, this function allocates a buffer for @n@ elements, which
+-- could be used for DoS-attacks by exhausting the memory if an attacker controls
+-- that parameter.
 --
 -- @
 -- fromListN n xs = 'fromList' ('take' n xs)

vector/src/Data/Vector/Generic.hs

@@ -2298,10 +2298,10 @@ fromList :: Vector v a => [a] -> v a
 fromList = unstream . Bundle.fromList
 
 -- | /O(n)/ Convert the first @n@ elements of a list to a vector. It's
--- expected that supplied list will be exactly @n@ elements long. As
--- optimization this function allocates buffer for @n@ elements and
--- could be used to DoS by exhausting memory if attacker controls that
--- parameter.
+-- expected that the supplied list will be exactly @n@ elements long. As
+-- an optimization, this function allocates a buffer for @n@ elements, which
+-- could be used for DoS-attacks by exhausting the memory if an attacker controls
+-- that parameter.
 --
 -- @
 -- fromListN n xs = 'fromList' ('take' n xs)

vector/src/Data/Vector/Primitive.hs

@@ -1787,10 +1787,10 @@ fromList :: Prim a => [a] -> Vector a
 fromList = G.fromList
 
 -- | /O(n)/ Convert the first @n@ elements of a list to a vector. It's
--- expected that supplied list will be exactly @n@ elements long. As
--- optimization this function allocates buffer for @n@ elements and
--- could be used to DoS by exhausting memory if attacker controls that
--- parameter.
+-- expected that the supplied list will be exactly @n@ elements long. As
+-- an optimization, this function allocates a buffer for @n@ elements, which
+-- could be used for DoS-attacks by exhausting the memory if an attacker controls
+-- that parameter.
 --
 -- @
 -- fromListN n xs = 'fromList' ('take' n xs)

vector/src/Data/Vector/Storable.hs

@@ -1833,10 +1833,10 @@ fromList :: Storable a => [a] -> Vector a
 fromList = G.fromList
 
 -- | /O(n)/ Convert the first @n@ elements of a list to a vector. It's
--- expected that supplied list will be exactly @n@ elements long. As
--- optimization this function allocates buffer for @n@ elements and
--- could be used to DoS by exhausting memory if attacker controls that
--- parameter.
+-- expected that the supplied list will be exactly @n@ elements long. As
+-- an optimization, this function allocates a buffer for @n@ elements, which
+-- could be used for DoS-attacks by exhausting the memory if an attacker controls
+-- that parameter.
 --
 -- @
 -- fromListN n xs = 'fromList' ('take' n xs)

vector/src/Data/Vector/Unboxed.hs

@@ -1879,10 +1879,10 @@ fromList :: Unbox a => [a] -> Vector a
 fromList = G.fromList
 
 -- | /O(n)/ Convert the first @n@ elements of a list to a vector. It's
--- expected that supplied list will be exactly @n@ elements long. As
--- optimization this function allocates buffer for @n@ elements and
--- could be used to DoS by exhausting memory if attacker controls that
--- parameter.
+-- expected that the supplied list will be exactly @n@ elements long. As
+-- an optimization, this function allocates a buffer for @n@ elements, which
+-- could be used for DoS-attacks by exhausting the memory if an attacker controls
+-- that parameter.
 --
 -- @
 -- fromListN n xs = 'fromList' ('take' n xs)