src/share/vm/oops/constMethod.hpp

@@ -370,10 +370,15 @@
   // exception table
   int exception_table_length() const;
   ExceptionTableElement* exception_table_start() const;
 
   // method parameters table
+
+  // This returns -1 if no parameters are present, a non-negative
+  // value otherwise.  Note: sometimes, there are 0-length parameters
+  // attributes that must be reported up to the reflection API all the
+  // same.
   int method_parameters_length() const;
   MethodParametersElement* method_parameters_start() const;
 
   // method annotations
   bool has_method_annotations() const