Mercurial > jdk8-mips64-public > langtools / changeset

     1.1 --- a/src/share/classes/com/sun/tools/javadoc/ClassDocImpl.java	Thu Aug 29 11:57:52 2013 -0700
     1.2 +++ b/src/share/classes/com/sun/tools/javadoc/ClassDocImpl.java	Thu Aug 29 12:03:28 2013 -0700
     1.3 @@ -128,7 +128,14 @@
     1.4              try {
     1.5                  return clazz.flags();
     1.6              } catch (CompletionFailure ex) {
     1.7 -                // quietly ignore completion failures
     1.8 +                /* Quietly ignore completion failures.
     1.9 +                 * Note that a CompletionFailure can only
    1.10 +                 * occur as a result of calling complete(),
    1.11 +                 * which will always remove the current
    1.12 +                 * completer, leaving it to be null or
    1.13 +                 * follow-up completer. Thus the loop
    1.14 +                 * is guaranteed to eventually terminate.
    1.15 +                 */
    1.16              }
    1.17          }
    1.18      }