diff --git a/compar.c b/compar.c
index 3d06592692..027328d6d3 100644
--- a/compar.c
+++ b/compar.c
@@ -154,9 +154,9 @@ cmp_le(VALUE x, VALUE y)
* call-seq:
* obj.between?(min, max) -> true or false
*
- * Returns false
if obj <=>
- * min is less than zero or if anObject <=>
- * max is greater than zero, true
otherwise.
+ * Returns false
if _obj_ <=>
_min_ is less
+ * than zero or if _obj_ <=>
_max_ is greater than zero,
+ * true
otherwise.
*
* 3.between?(1, 5) #=> true
* 6.between?(1, 5) #=> false
@@ -177,9 +177,9 @@ cmp_between(VALUE x, VALUE min, VALUE max)
* call-seq:
* obj.clamp(min, max) -> obj
*
- * Returns min if obj <=>
min is less
- * than zero, max if obj <=>
max is
- * greater than zero and obj otherwise.
+ * Returns _min_ if _obj_ <=>
_min_ is less than zero,
+ * _max_ if _obj_ <=>
_max_ is greater than zero and
+ * _obj_ otherwise.
*
* 12.clamp(0, 100) #=> 12
* 523.clamp(0, 100) #=> 100