Uploaded image for project: 'Maven Javadoc Plugin'
  1. Maven Javadoc Plugin
  2. MJAVADOC-659

javadoc:fix replaces existing @throws descriptions

    XMLWordPrintableJSON

Details

    • Bug
    • Status: Closed
    • Major
    • Resolution: Fixed
    • None
    • 3.3.0
    • fix
    • None

    Description

      original code:

          /**
           * <p>testException.</p>
           *
           * @throws java.lang.Exception when reader.read get wrong.
           */
          public void testException() throws Exception {
              throw new Exception();
          }
      

      after we calling fix, it becomes:

          /**
           * <p>testException.</p>
           *
           * @throws java.lang.Exception if any.
           */
          public void testException() throws Exception {
              throw new Exception();
          }
      

      So why must I use "if any", and must change my original words?
      I think this be a bug, but if it is by design, please tell me the reason.

      Attachments

        Issue Links

          Activity

            People

              elharo Elliotte Rusty Harold
              XenoAmess Jin Xu
              Votes:
              0 Vote for this issue
              Watchers:
              3 Start watching this issue

              Dates

                Created:
                Updated:
                Resolved: