Fix several kernel/pdf/canvas javadoc warnings

DEVSIX-4158

Author: Kate Ivanova

kernel/src/main/java/com/itextpdf/kernel/pdf/canvas/parser/listener/FilteredEventListener.java

@@ -71,7 +71,7 @@ public FilteredEventListener() {
      * Constructs a {@link FilteredEventListener} instance with one delegate.
      * Use {@link #attachEventListener(IEventListener, IEventFilter...)} to add more {@link IEventListener} delegates
      * along with their filters.
-     * @param delegate a delegate that fill be called when all the corresponding filters for an event pass
+     * @param delegate a delegate that will be called when all the corresponding filters for an event pass
      * @param filterSet filters attached to the delegate that will be tested before passing an event on to the delegate
      */
     public FilteredEventListener(IEventListener delegate, IEventFilter... filterSet) {
@@ -87,7 +87,8 @@ public FilteredEventListener(IEventListener delegate, IEventFilter... filterSet)
      * be parsed just once, so it is better for performance than creating multiple {@link FilteredEventListener}
      * instances and parsing the content stream multiple times. This is useful, for instance, when you want
      * to extract content from multiple regions of a page.
-     * @param delegate a delegate that fill be called when all the corresponding filters for an event pass
+     * @param <T> the type of the delegate
+     * @param delegate a delegate that will be called when all the corresponding filters for an event pass
      * @param filterSet filters attached to the delegate that will be tested before passing an event on to the delegate
      * @return delegate that has been passed to the method, used for convenient call chaining
      */

kernel/src/main/java/com/itextpdf/kernel/pdf/canvas/wmf/InputMeta.java

@@ -71,7 +71,7 @@ public InputMeta(InputStream in) {
      * Read the next word from the InputStream.
      *
      * @return the next word or 0 if the end of the stream has been reached
-     * @throws IOException
+     * @throws IOException an {@link IOException}
      */
     public int readWord() throws IOException {
         length += 2;
@@ -85,7 +85,7 @@ public int readWord() throws IOException {
      * Read the next short from the InputStream.
      *
      * @return the next short value
-     * @throws IOException
+     * @throws IOException an {@link IOException}
      */
     public int readShort() throws IOException{
         int k = readWord();
@@ -98,7 +98,7 @@ public int readShort() throws IOException{
      * Read the next int from the InputStream.
      *
      * @return the next int
-     * @throws IOException
+     * @throws IOException an {@link IOException}
      */
     public int readInt() throws IOException{
         length += 4;
@@ -114,7 +114,7 @@ public int readInt() throws IOException{
      * Read the next byte from the InputStream.
      *
      * @return the next byte
-     * @throws IOException
+     * @throws IOException an {@link IOException}
      */
     public int readByte() throws IOException{
         ++length;
@@ -125,7 +125,7 @@ public int readByte() throws IOException{
      * Skips "len" amount of bytes from the InputStream. If len is < 0, nothing is skipped.
      *
      * @param len amount of bytes needed to skip
-     * @throws IOException
+     * @throws IOException an {@link IOException}
      */
     public void skip(int len) throws IOException{
         length += len;
@@ -145,7 +145,7 @@ public int getLength() {
      * Read the next {@link Color} from the InputStream. This reads 4 bytes.
      *
      * @return the next Color
-     * @throws IOException
+     * @throws IOException an {@link IOException}
      */
     public Color readColor() throws IOException{
         int red = readByte();

kernel/src/main/java/com/itextpdf/kernel/pdf/canvas/wmf/MetaBrush.java

@@ -81,7 +81,7 @@ public MetaBrush() {
      * Initializes this MetaBrush object.
      *
      * @param in the InputMeta
-     * @throws IOException
+     * @throws IOException an {@link IOException}
      */
     public void init(InputMeta in) throws IOException {
         style = in.readWord();

kernel/src/main/java/com/itextpdf/kernel/pdf/canvas/wmf/MetaDo.java

@@ -169,7 +169,7 @@ public MetaDo(InputStream in, PdfCanvas cb) {
     /**
      * Reads and processes all the data of the InputMeta.
      *
-     * @throws IOException
+     * @throws IOException an {@link IOException}
      */
     public void readAll() throws IOException {
         if (in.readInt() != 0x9AC6CDD7) {
@@ -611,7 +611,7 @@ public void readAll() throws IOException {
      * @param x2 x2-coordinate of the rectangle if clipped or opaque
      * @param y2 y1-coordinate of the rectangle if clipped or opaque
      * @param text text to output
-     * @throws IOException
+     * @throws IOException an {@link IOException}
      */
     public void outputText(int x, int y, int flag, int x1, int y1, int x2, int y2, String text) throws IOException {
 
@@ -739,7 +739,7 @@ static float getArc(float xCenter, float yCenter, float xDot, float yDot) {
      *
      * @param image the BMP image to be wrapped
      * @return the wrapped BMP
-     * @throws IOException
+     * @throws IOException an {@link IOException}
      */
     public static byte[] wrapBMP(ImageData image) throws IOException {
         if (image.getOriginalType() != ImageType.BMP) {
@@ -811,7 +811,7 @@ public static byte[] wrapBMP(ImageData image) throws IOException {
      *
      * @param os outputstream to write the word to
      * @param v value to be written
-     * @throws IOException
+     * @throws IOException an {@link IOException}
      */
     public static void writeWord(OutputStream os, int v) throws IOException {
         os.write(v & 0xff);
@@ -823,7 +823,7 @@ public static void writeWord(OutputStream os, int v) throws IOException {
      *
      * @param os outputstream to write the dword to
      * @param v value to be written
-     * @throws IOException
+     * @throws IOException an {@link IOException}
      */
     public static void writeDWord(OutputStream os, int v) throws IOException {
         writeWord(os, v & 0xffff);

kernel/src/main/java/com/itextpdf/kernel/pdf/canvas/wmf/MetaFont.java

@@ -106,7 +106,7 @@ public MetaFont() {
      * Initializes the MetaFont instance.
      *
      * @param in InputMeta containing the WMF data
-     * @throws IOException
+     * @throws IOException an {@link IOException}
      */
     public void init(InputMeta in) throws IOException {
         height = Math.abs(in.readShort());
@@ -141,7 +141,7 @@ public void init(InputMeta in) throws IOException {
      * Returns the Font.
      *
      * @return the font
-     * @throws IOException
+     * @throws IOException an {@link IOException}
      */
     public FontProgram getFont() throws IOException {
         if (font != null)

kernel/src/main/java/com/itextpdf/kernel/pdf/canvas/wmf/MetaPen.java

@@ -76,7 +76,7 @@ public MetaPen() {
      * Initializes a MetaPen object.
      *
      * @param in the InputMeta object that holds the inputstream of the WMF image
-     * @throws IOException
+     * @throws IOException an {@link IOException}
      */
     public void init(InputMeta in) throws IOException {
         style = in.readWord();

kernel/src/main/java/com/itextpdf/kernel/pdf/canvas/wmf/WmfImageData.java

@@ -65,7 +65,7 @@ public class WmfImageData extends ImageData {
      * Creates a WmfImage from a file.
      *
      * @param fileName pah to the file
-     * @throws MalformedURLException
+     * @throws MalformedURLException a {@link MalformedURLException}
      */
     public WmfImageData(String fileName) throws MalformedURLException {
         this(UrlUtil.toURL(fileName));