Javadoc: Coi các cảnh báo là lỗi?

Question

Có thể coi cảnh báo là lỗi khi sử dụng Javadoc không? Đặc biệt, tôi đang gọi Javadoc từ Ant và có failonerror="true" đặt trên nhiệm vụ <javadoc> của tôi, nhưng tôi dường như không thể kích hoạt điều này. Mặc dù javadoc đang tạo cảnh báo, tôi vẫn nhận được BUILD SUCCESSFUL với mã thoát là 0 khi Ant hoàn tất.

Tôi hy vọng sẽ có thể thêm thứ gì đó vào thuộc tính additionalparam của tác vụ <javadoc> để buộc không thực hiện được cảnh báo Javadoc.

Answer 1

Tôi không biết về tham số JavaDoc, tôi khuyên bạn nên sử dụng công cụ như checkstyle trong bản dựng kiến ​​của bạn cho những thứ như thế này. Bạn có thể thiết lập để thất bại trên các cảnh báo Javadoc.

Answer 2

Tôi biết điều này là cũ nhưng nó vẫn có thể hữu ích cho ai đó đang tìm kiếm câu trả lời như tôi. Nếu nó không hoạt động, hãy thay đổi

<contains text="warnings"/> 

vào văn bản bạn thấy với đầu ra của mình.

<target name="javadoc"> 
<delete dir="${jDocDirectory}"/> 
<mkdir dir="${jDocDirectory}"/> 
<record name="javadocLog" action="start"/> 
<javadoc (settings, blah blah) /> 
<record name="javadocLog" action="stop"/> 
     <condition property="javadoc.warnings"> 
      <isfileselected file="javadocLog"> 
       <contains text="warnings"/> 
      </isfileselected> 
     </condition> 
     <fail if="javadoc.warnings">Javadoc warnings!</fail> 
</target> 

chỉnh sửa: Nếu bạn có một cảnh báo này sẽ không làm việc, để sửa chữa cho tất cả các cảnh báo bạn phải thay đổi này:

<contains text="warnings"/> 

Answer 3

1.9.4 Ant hiện có failonwarning = "true"

http://ant.apache.org/manual/Tasks/javadoc.html