Improve javadoc of xfdf object classes.

DEVSIX-3385

Autoported commit.
Original commit hash: [08c732522]
Manual files:
forms/src/main/java/com/itextpdf/forms/xfdf/XfdfFileUtils.java

Author: BlackEgoist

itext/itext.forms/itext/forms/xfdf/ActionObject.cs

@@ -53,21 +53,32 @@ namespace iText.Forms.Xfdf {
     /// </remarks>
     public class ActionObject {
         /// <summary>Type of inner action element.</summary>
-        /// <remarks>Type of inner action element. Possible values: URI, Launch, GoTo, GoToR, Named.</remarks>
+        /// <remarks>
+        /// Type of inner action element. Possible values:
+        /// <see cref="iText.Kernel.Pdf.PdfName.URI"/>
+        /// ,
+        /// <see cref="iText.Kernel.Pdf.PdfName.Launch"/>
+        /// ,
+        /// <see cref="iText.Kernel.Pdf.PdfName.GoTo"/>
+        /// ,
+        /// <see cref="iText.Kernel.Pdf.PdfName.GoToR"/>
+        /// ,
+        /// <see cref="iText.Kernel.Pdf.PdfName.Named"/>.
+        /// </remarks>
         private PdfName type;
 
-        /// <summary>Represents Name required attribute of URI element.</summary>
-        /// <remarks>Represents Name required attribute of URI element. For more details see paragraph 6.5.30 in Xfdf specification.
+        /// <summary>Represents Name, required attribute of URI element.</summary>
+        /// <remarks>Represents Name, required attribute of URI element. For more details see paragraph 6.5.30 in Xfdf specification.
         ///     </remarks>
         private PdfString uri;
 
-        /// <summary>Represents IsMap optional attribute of URI element.</summary>
-        /// <remarks>Represents IsMap optional attribute of URI element. For more details see paragraph 6.5.30 in Xfdf specification.
+        /// <summary>Represents IsMap, optional attribute of URI element.</summary>
+        /// <remarks>Represents IsMap, optional attribute of URI element. For more details see paragraph 6.5.30 in Xfdf specification.
         ///     </remarks>
         private bool isMap;
 
-        /// <summary>Represents Name required attribute of Named element.</summary>
-        /// <remarks>Represents Name required attribute of Named element. For more details see paragraph 6.5.24 in Xfdf specification.
+        /// <summary>Represents Name, required attribute of Named element.</summary>
+        /// <remarks>Represents Name, required attribute of Named element. For more details see paragraph 6.5.24 in Xfdf specification.
         ///     </remarks>
         private PdfName nameAction;
 
@@ -79,14 +90,14 @@ public class ActionObject {
         /// </remarks>
         private String fileOriginalName;
 
-        /// <summary>Represents NewWindows optional attribute of Launch element.</summary>
-        /// <remarks>Represents NewWindows optional attribute of Launch element. For more details see paragraph 6.5.23 in Xfdf specification.
+        /// <summary>Represents NewWindow, optional attribute of Launch element.</summary>
+        /// <remarks>Represents NewWindow, optional attribute of Launch element. For more details see paragraph 6.5.23 in Xfdf specification.
         ///     </remarks>
         private bool isNewWindow;
 
-        /// <summary>Represents Dest inner element of link, GoTo, and GoToR elements.</summary>
+        /// <summary>Represents Dest, inner element of link, GoTo, and GoToR elements.</summary>
         /// <remarks>
-        /// Represents Dest inner element of link, GoTo, and GoToR elements.
+        /// Represents Dest, inner element of link, GoTo, and GoToR elements.
         /// Corresponds to Dest key in link annotation dictionary.
         /// For more details see paragraph 6.5.10 in Xfdf specification.
         /// </remarks>
@@ -96,64 +107,144 @@ public ActionObject(PdfName type) {
             this.type = type;
         }
 
+        /// <summary>Returns the type of inner action element.</summary>
+        /// <remarks>
+        /// Returns the type of inner action element. Possible values:
+        /// <see cref="iText.Kernel.Pdf.PdfName.URI"/>
+        /// ,
+        /// <see cref="iText.Kernel.Pdf.PdfName.Launch"/>
+        /// ,
+        /// <see cref="iText.Kernel.Pdf.PdfName.GoTo"/>
+        /// ,
+        /// <see cref="iText.Kernel.Pdf.PdfName.GoToR"/>
+        /// ,
+        /// <see cref="iText.Kernel.Pdf.PdfName.Named"/>.
+        /// </remarks>
         public virtual PdfName GetType() {
             return type;
         }
 
+        /// <summary>Sets the type of inner action element.</summary>
+        /// <remarks>
+        /// Sets the type of inner action element. Possible values:
+        /// <see cref="iText.Kernel.Pdf.PdfName.URI"/>
+        /// ,
+        /// <see cref="iText.Kernel.Pdf.PdfName.Launch"/>
+        /// ,
+        /// <see cref="iText.Kernel.Pdf.PdfName.GoTo"/>
+        /// ,
+        /// <see cref="iText.Kernel.Pdf.PdfName.GoToR"/>
+        /// ,
+        /// <see cref="iText.Kernel.Pdf.PdfName.Named"/>.
+        /// </remarks>
         public virtual iText.Forms.Xfdf.ActionObject SetType(PdfName type) {
             this.type = type;
             return this;
         }
 
+        /// <summary>Gets the string value of URI elements.</summary>
+        /// <remarks>
+        /// Gets the string value of URI elements. Corresponds to Name, required attribute of URI element.
+        /// For more details see paragraph 6.5.30 in Xfdf specification.
+        /// </remarks>
         public virtual PdfString GetUri() {
             return uri;
         }
 
+        /// <summary>Sets the string value of URI elements.</summary>
+        /// <remarks>
+        /// Sets the string value of URI elements. Corresponds to Name, required attribute of URI element.
+        /// For more details see paragraph 6.5.30 in Xfdf specification.
+        /// </remarks>
         public virtual iText.Forms.Xfdf.ActionObject SetUri(PdfString uri) {
             this.uri = uri;
             return this;
         }
 
+        /// <summary>Gets IsMap, optional attribute of URI element.</summary>
+        /// <remarks>Gets IsMap, optional attribute of URI element. For more details see paragraph 6.5.30 in Xfdf specification.
+        ///     </remarks>
         public virtual bool IsMap() {
             return isMap;
         }
 
+        /// <summary>Sets IsMap, optional attribute of URI element.</summary>
+        /// <remarks>Sets IsMap, optional attribute of URI element. For more details see paragraph 6.5.30 in Xfdf specification.
+        ///     </remarks>
         public virtual iText.Forms.Xfdf.ActionObject SetMap(bool map) {
             isMap = map;
             return this;
         }
 
+        /// <summary>Gets the value of Name, required attribute of Named element.</summary>
+        /// <remarks>Gets the value of Name, required attribute of Named element. For more details see paragraph 6.5.24 in Xfdf specification.
+        ///     </remarks>
         public virtual PdfName GetNameAction() {
             return nameAction;
         }
 
+        /// <summary>Sets the value of Name, required attribute of Named element.</summary>
+        /// <remarks>Sets the value of Name, required attribute of Named element. For more details see paragraph 6.5.24 in Xfdf specification.
+        ///     </remarks>
         public virtual iText.Forms.Xfdf.ActionObject SetNameAction(PdfName nameAction) {
             this.nameAction = nameAction;
             return this;
         }
 
+        /// <summary>Gets the string value of OriginalName, required attribute of File inner element of GoToR or Launch element.
+        ///     </summary>
+        /// <remarks>
+        /// Gets the string value of OriginalName, required attribute of File inner element of GoToR or Launch element.
+        /// Corresponds to F key in go-to action or launch dictionaries.
+        /// For more details see paragraphs 6.5.11, 6.5.23 in Xfdf specification.
+        /// </remarks>
         public virtual String GetFileOriginalName() {
             return fileOriginalName;
         }
 
+        /// <summary>Sets the string value of OriginalName, required attribute of File inner element of GoToR or Launch element.
+        ///     </summary>
+        /// <remarks>
+        /// Sets the string value of OriginalName, required attribute of File inner element of GoToR or Launch element.
+        /// Corresponds to F key in go-to action or launch dictionaries.
+        /// For more details see paragraphs 6.5.11, 6.5.23 in Xfdf specification.
+        /// </remarks>
         public virtual iText.Forms.Xfdf.ActionObject SetFileOriginalName(String fileOriginalName) {
             this.fileOriginalName = fileOriginalName;
             return this;
         }
 
+        /// <summary>Sets the boolean value of NewWindow, optional attribute of Launch element.</summary>
+        /// <remarks>Sets the boolean value of NewWindow, optional attribute of Launch element. For more details see paragraph 6.5.23 in Xfdf specification.
+        ///     </remarks>
         public virtual bool IsNewWindow() {
             return isNewWindow;
         }
 
+        /// <summary>Gets the boolean value of NewWindow, optional attribute of Launch element.</summary>
+        /// <remarks>Gets the boolean value of NewWindow, optional attribute of Launch element. For more details see paragraph 6.5.23 in Xfdf specification.
+        ///     </remarks>
         public virtual iText.Forms.Xfdf.ActionObject SetNewWindow(bool newWindow) {
             isNewWindow = newWindow;
             return this;
         }
 
+        /// <summary>Gets Dest, inner element of link, GoTo, and GoToR elements.</summary>
+        /// <remarks>
+        /// Gets Dest, inner element of link, GoTo, and GoToR elements.
+        /// Corresponds to Dest key in link annotation dictionary.
+        /// For more details see paragraph 6.5.10 in Xfdf specification.
+        /// </remarks>
         public virtual DestObject GetDestination() {
             return destination;
         }
 
+        /// <summary>Sets Dest, inner element of link, GoTo, and GoToR elements.</summary>
+        /// <remarks>
+        /// Sets Dest, inner element of link, GoTo, and GoToR elements.
+        /// Corresponds to Dest key in link annotation dictionary.
+        /// For more details see paragraph 6.5.10 in Xfdf specification.
+        /// </remarks>
         public virtual iText.Forms.Xfdf.ActionObject SetDestination(DestObject destination) {
             this.destination = destination;
             return this;