diff --git a/gas/ChangeLog b/gas/ChangeLog
index 4711dbda3b1..bd678305d53 100644
--- a/gas/ChangeLog
+++ b/gas/ChangeLog
@@ -1,5 +1,7 @@
 Wed Oct 27 16:50:44 1999  Don Lindsay  <dlindsay@cygnus.com>
 
+	* config/tc-arm.c (reg_required_here): Improve comments.
+
         * config/tc-arm.c (thumb_opcode): Add "variants" field.
         (tinsns): Initialize variants field.
 
diff --git a/gas/config/tc-arm.c b/gas/config/tc-arm.c
index e1583b33f3c..d842941aa4a 100644
--- a/gas/config/tc-arm.c
+++ b/gas/config/tc-arm.c
@@ -1503,8 +1503,10 @@ skip_past_comma (str)
   return comma ? SUCCESS : FAIL;
 }
 
-/* A standard register must be given at this point.  Shift is the place to
-   put it in the instruction. */
+/* A standard register must be given at this point.
+   Shift is the place to put it in inst.instruction.
+   Restores input start point on err.
+   Returns the reg#, or FAIL. */
 
 static int
 reg_required_here (str, shift)