本文介紹了使用javadoc忽略小錯誤的處理方法，對大家解決問題具有一定的參考價值，需要的朋友們下面隨著小編來一起學習吧！
問題描述
我正在嘗試使用javadoc從一個或兩個下載的JAR文件生成文檔(當然，在解壓所有內容之后，還帶有源代碼)。
但是使用javadoc，即使是在Ant文件中，我也被阻止生成它，因為一些愚蠢的事情，特別是”Package XXX不存在”和”找不到符號”……我只想讓javadoc將這些東西(外部引用)的文本放在html文檔中，但要記錄它找到的所有.Java文件…
注意：任何感興趣的人請注意，這是我試圖從中生成API文檔的下載文件(包含源代碼)的下載頁面：http://logback.qos.ch/download.html
在Mark Rotteveel的幫助下，我的Ant構建文件現在如下所示：
<?xml version="1.0" ?>
<project name="document logback core" default="doc">
<target name="doc">
<mkdir dir="javadoc" />
<property name="excludedPackages"
value="org.codehaus.*,javax.mail.*"/>
<javadoc destdir="javadoc" sourcepath="src" packagenames="main.*"
excludepackagenames="${excludedPackages}"
additionalparam="-Xdoclint:none" />
</target>
</project>
.但它仍然給出錯誤：1)找不到包，包括”org.codehaus.[xxx…]”和”javax.mail.[xxx…]”以及2)找不到符號(不過，如果我能解決缺少包的錯誤，這個問題可能會消失)。
nb據說構建成功，但我收到的投訴是沒有找到源文件(其中確實有注釋的.java文件)，并且在javadoc下根本沒有生成html。
繼托尼·皮爾斯成功生成這些文檔后
安裝了Ant 1.9.6，相應地更改了路徑，并檢查以確保這是正在使用的版本…又試了一次。又失敗了。這是我的輸出的結尾：
[Javaoc]
D:DesktopDownloadslogback-1.1.7.tarlogback-1.1.7logback-coresrc estjavachqoslogbackcoreappenderConsoleAppenderTest.java:32：
錯誤：包org.junit不存在
[javadoc]導入靜態
Org.juit.Assert.assertEquals；
[javadoc]_
[javadoc]javadoc：錯誤-找不到公共或受保護的類
文件。
[javadoc]1錯誤
[javadoc]100個警告構建成功總時間：2秒
它確實創建了javadoc文件夾…但這是空的。
nb關于上面的”包不存在”錯誤(還有許多其他錯誤)：這個錯誤特別令人費解，因為我認為Ant在默認情況下不知何故包含了junit(nb我是Ant的新手，只是在操作中使用Ant)。
但是…使用Antjavac任務，您可以設置includeAntRuntime="true"…根據這本書，這使得Ant自己的junit.jar被包括在內。遺憾的是，javadoc任務不支持此屬性。
以后仍
老實說，我的想法有點混亂：我發現從第三方源代碼JAR編譯javadoc的最簡單方法就是提取，然后使用命令行，通常是：
Javadoc-d docs-Xmax警告10-XMaxerrs 10-Xdoclint：無-源路徑
。-子包ch.qos.logback.core
.至于javadoc對于自己的代碼，這在Gradle中似乎不是問題(我只是瞥了一眼Ant，意識到未來是Gradle…掌握基礎知識并不是特別困難)。
nb如果您安裝了適用于Eclipse的Gradle STS插件，然后使用Gradle STS向導創建一個新項目，則構建文件包含行
應用插件：‘eclipse’
.其效果之一是，默認情況下，所有第三方依賴項的源代碼和可執行文件將在構建過程中下載到GRADLE_HOME下。很好！
推薦答案
Java 8引入了doclint，它會將某些問題視為錯誤，而不會生成文檔?？梢酝ㄟ^指定命令行選項-Xdoclint:none來禁用此功能。
另見：Turning off doclint in JDK 8 Javadoc
例如，在Ant中，您需要向javadoc任務添加additionalparam="-Xdoclint:none"屬性。Jaybird中的一個(略有修改)示例：
<target name="javadocs" depends="init,set-driver-sources">
<mkdir dir="${build.docs}"/>
<javadoc destdir="${build.docs}"
author="true"
version="true"
windowtitle="${Name} API"
doctitle="${Name}"
extdirs="${module.thirdparty}"
additionalparam="-Xdoclint:none"
excludepackagenames="${excludedPackages}"
bottom="Copyright © 2001-2015 Jaybird (Firebird JDBC/JCA) team. All rights reserved.">
<arg line="${java.module.arg}"/>
<classpath refid="javac.driver.classpath"/>
<sourcepath>
<pathelement path="${source.java}"/>
<pathelement path="${source.jna-client}"/>
</sourcepath>
<sourcepath refid="source.java.openoffice"/>
<sourcepath refid="source.java.additional"/>
<link />
</javadoc>
</target>
這篇關于使用javadoc忽略小錯誤的文章就介紹到這了，希望我們推薦的答案對大家有所幫助，
