Javadoc woes
I'm having some trouble with Javadoc and BreakIterator.
I've recently started using 1.4 and I now get lots of warning messages about -breakiterator and the end of the first sentence.
Sometimes this is sensible, sometimes not.
For example:
It's saying that the sentence ends after the first question mark, but in fact it doesn't.
I've tried various ways of fooling it into ignoring the question mark, but without success.
What I really want is to be able to suppress the warnings because there doesn't seem to be anything I can do about them.
I've recently started using 1.4 and I now get lots of warning messages about -breakiterator and the end of the first sentence.
Sometimes this is sensible, sometimes not.
For example:
Xyz.java:65: warning - The first sentence is interpreted to be: "Indicates that the query string contains "?" parameters to be replaced with data." This sentence is different from what will be interpreted as the first sentence in the next major release (when that interpretation will be internationalized), which is: "Indicates that the query string contains "?" " To avoid this note, change the doc comment to make this a proper first sentence, then use -breakiterator from that point forward, which will output this new sentence.
It's saying that the sentence ends after the first question mark, but in fact it doesn't.
I've tried various ways of fooling it into ignoring the question mark, but without success.
What I really want is to be able to suppress the warnings because there doesn't seem to be anything I can do about them.
One solution would be to move to 1.5 where this problem has gone away.
Sadly, that's not an option on this project - we've only just moved to 1.4.
Any other suggestions?
