Details

    • Type: Improvement Improvement
    • Status: Closed Closed
    • Priority: Major Major
    • Resolution: Fixed
    • Affects Version/s: 1.0-beta-1
    • Fix Version/s: 1.0-beta-2
    • Labels:
      None
    • Environment:
      Maven 2.0.4
    • Number of attachments :
      0

      Description

      P1. "[ERROR] Missing examples."
      Q1. What is actually missing? The directory? Files in that directory?
      Proposed solution: Provide a more detailed error message and document it. Also, the SVN repo of DOCCK Plugin itself should act as a standard for plugins so that plugin developers has an example to look at.

      P2. "[WARN] license MIT license appears to have an invalid URL: 'LICENSE.txt'. Error: no protocol: LICENSE.txt Trying to access it as a file instead."
      Q2. LICENSE.txt shows correctly in the generated site. The file is in the same directory as the pom.xml. If I use file:// then I also get a warning ("[WARN] Non-HTTP license MIT license URL not verified."). Where shall the file be placed and how should I specify the url?

      P3. "[ERROR] Cannot reach project site with URL: 'http://mojo.codehaus.org/freemarker-maven-plugin'.
      [ERROR] Cannot reach scm with URL: 'https://svn.codehaus.org/mojo/trunk/mojo/mojo-sandbox/freemarker-maven-plugin'.Error: sun.security.validator.ValidatorException: PKIX path building failed:
      sun.security.provider.certpath.SunCertPathBuilderException: unable to find valid certification path to requested target"

      Q3. The url "https://svn.codehaus.org/mojo/trunk/mojo/mojo-sandbox/freemarker-maven-plugin" works without any problems when I point to it in Firefox. What is the actual problem?

      P4. "[ERROR] Missing base FAQ.(fml|html|xml|apt)."
      Q4. I have the file site/fml/FAQ.fml. It's added to site.xml and generates correctly to html when generating the site. What is the actual problem?

        Activity

        Hide
        Dennis Lundberg added a comment -

        Points 1 and 4 have been fixed in SVN as part of the solution for MDOCCK-2.

        A1. It is the files that are missing.

        A4. The filename should be in lower case: faq.fml.

        Show
        Dennis Lundberg added a comment - Points 1 and 4 have been fixed in SVN as part of the solution for MDOCCK-2 . A1. It is the files that are missing. A4. The filename should be in lower case: faq.fml.
        Hide
        Dennis Lundberg added a comment -

        A3. I checked out the freemarker plugin and ran mvn docck:check on it. It gives me this error:
        [ERROR] Cannot reach project site with URL: 'http://mojo.codehaus.org/freemarker-maven-plugin'.

        If I try to reach "http://mojo.codehaus.org/freemarker-maven-plugin" using my browser I get a 404 error. So the docck plugin is correct.

        I didn't get the error you get regarding the svn URL.

        Show
        Dennis Lundberg added a comment - A3. I checked out the freemarker plugin and ran mvn docck:check on it. It gives me this error: [ERROR] Cannot reach project site with URL: 'http://mojo.codehaus.org/freemarker-maven-plugin'. If I try to reach "http://mojo.codehaus.org/freemarker-maven-plugin" using my browser I get a 404 error. So the docck plugin is correct. I didn't get the error you get regarding the svn URL.
        Hide
        Dennis Lundberg added a comment -

        A2. We are talking about a URL here, so in my book the project-info-reports is being "nice" by allowing you to specify a non-URL value like "LICENSE.txt" in the project/licenses/license/url tag. If you want to use a real URL you could use "file:///$

        {basedir}

        /LICENSE.txt" which works for me both for project-info-reports and docck.

        Regarding the second warning, this plugin only has support for validating http-URLs at the moment. So it's just to let you know that the URL has not been validated.

        Show
        Dennis Lundberg added a comment - A2. We are talking about a URL here, so in my book the project-info-reports is being "nice" by allowing you to specify a non-URL value like "LICENSE.txt" in the project/licenses/license/url tag. If you want to use a real URL you could use "file:///$ {basedir} /LICENSE.txt" which works for me both for project-info-reports and docck. Regarding the second warning, this plugin only has support for validating http-URLs at the moment. So it's just to let you know that the URL has not been validated.
        Hide
        Dennis Lundberg added a comment -

        I was wrong about 3 in my previous comment.

        It was the scm URL https://svn.codehaus.org/mojo/trunk/mojo/mojo-sandbox/freemarker-maven-plugin that wasn't working. I have tried it now and I don't get the error that you got. I think it might have had something to do with a problem in the certificate chain for https.

        Show
        Dennis Lundberg added a comment - I was wrong about 3 in my previous comment. It was the scm URL https://svn.codehaus.org/mojo/trunk/mojo/mojo-sandbox/freemarker-maven-plugin that wasn't working. I have tried it now and I don't get the error that you got. I think it might have had something to do with a problem in the certificate chain for https.
        Hide
        Dennis Lundberg added a comment -

        All the issues have now been resolved.

        Show
        Dennis Lundberg added a comment - All the issues have now been resolved.

          People

          • Assignee:
            Dennis Lundberg
            Reporter:
            Jimisola Laursen
          • Votes:
            0 Vote for this issue
            Watchers:
            1 Start watching this issue

            Dates

            • Created:
              Updated:
              Resolved: