diff --git a/lib/pure/collections/hashcommon.nim b/lib/pure/collections/hashcommon.nim
index 0304461766..a169418ce8 100644
--- a/lib/pure/collections/hashcommon.nim
+++ b/lib/pure/collections/hashcommon.nim
@@ -34,10 +34,10 @@ proc slotsNeeded(count: Natural): int {.inline.} =
   result = nextPowerOfTwo(count * 3 div 2 + 4)
 
 proc rightSize*(count: Natural): int {.inline, deprecated: "Deprecated since 1.4.0".} =
-  ## **Deprecated since Nim v1.4.0**, it is not needed anymore
-  ## because picking the correct size is done internally.
+  ## It is not needed anymore because
+  ## picking the correct size is done internally.
   ##
-  ## Return the value of `initialSize` to support `count` items.
+  ## Returns the value of `initialSize` to support `count` items.
   ##
   ## If more items are expected to be added, simply add that
   ## expected extra amount to the parameter before calling this.