On 6 Jan 2014, at 21:49, Jonathan Gibbons <jonathan.gibb...@oracle.com> wrote:
> Hold up there. You can't give the access modifiers in the javadoc -Xdoclint
> option. javadoc infers the modifiers from the other javadoc options, such as
> -private, -protected etc.
Sorry, my fault. So the changes would be as follows, or simply drop the ':all’.
diff --git a/make/Javadoc.gmk b/make/Javadoc.gmk
--- a/make/Javadoc.gmk
+++ b/make/Javadoc.gmk
@@ -1142,7 +1142,7 @@
$(SCTPAPI_OPTIONS_FILE):
$(prep-target)
@($(call OptionOnly,$(COMMON_JAVADOCFLAGS)) ; \
- $(call OptionOnly,-Xdoclint:none) ; \
+ $(call OptionOnly,-Xdoclint:all) ; \
$(call OptionPair,-sourcepath,$(RELEASEDOCS_SOURCEPATH)) ; \
$(call OptionPair,-encoding,ascii) ; \
$(call OptionOnly,-nodeprecatedlist) ; \
What is not clear to me now, and I don’t know if it is possible with the
javadoc tool, is how to make the warnings fatal.
-Chris.
> -- Jon
>
>
> On 01/06/2014 12:55 PM, Chris Hegarty wrote:
>> Sounds good to me ( I must remember to do doc builds before pushing;-) ).
>> In which case I’d like to go ahead and enable "-Xdoclint:all/protected” for
>> the SCTP API docs. They are clean.
>
