Document FORTRAN::makeParameterName
diff --git a/Source/Modules/fortran.cxx b/Source/Modules/fortran.cxx
index 7213296..2ef4ec1 100644
--- a/Source/Modules/fortran.cxx
+++ b/Source/Modules/fortran.cxx
@@ -2113,7 +2113,13 @@
/* -----------------------------------------------------------------------------
* FORTRAN::makeParameterName()
*
- * Create a friendly parameter name
+ * Create a Fortran-compatible parameter name that doesn't shadow other Fortran symbol names in the current module. The regular makeParameterName
+ * function cannot be used because:
+ * 1. it might result in duplicate parameter names due to mixed case,
+ * 2. valid C/C++ parameter names might be invalid (e.g. those starting with _) for Fortran
+ * 3. parameter names may shadow types, functions, etc. in the current module, and Fortran doesn't provide a way to disambiguate those
+ *
+ * The mangled Fortran name gets cached in the "fname" attribute.
* ----------------------------------------------------------------------------- */
String *FORTRAN::makeParameterName(Node *n, Parm *p, int arg_num, bool) const {
