[docs] Improve XML docs for ten types (#26415)

Improve XML documentation for:

- `PdfActionNamedName`
- `PdfWidgetControlType`
- `PdfLineStyle`
- `PdfMarkupType`
- `PdfTextAnnotationIconType`
- `PdfBorderStyle`
- `PdfDisplayBox`
- `PdfDisplayMode`
- `PdfAreaOfInterest`
- `MKMapType`

Each type is documented in a separate commit. The Cecil documentation baseline is updated for the newly documented `PdfMarkupType.Redact` and `PdfAreaOfInterest.AnyArea` APIs.

🤖 Pull request created by Copilot

Author: rolfbjarne

src/MapKit/MKEnums.cs

@@ -37,7 +37,6 @@ public enum MKDirectionsTransportType : ulong {
 
 	// NSUInteger -> MKTypes.h
 	/// <summary>The type of map.</summary>
-	/// <remarks>To be added.</remarks>
 	[MacCatalyst (13, 1)]
 	[Native]
 	public enum MKMapType : ulong {
@@ -51,7 +50,7 @@ public enum MKMapType : ulong {
 		SatelliteFlyover,
 		/// <summary>A flyover that combines satellite and cartographic imagery.</summary>
 		HybridFlyover,
-		/// <summary>A muted map that emphasized developer data.</summary>
+		/// <summary>A muted map that emphasizes developer data.</summary>
 		[MacCatalyst (13, 1)]
 		MutedStandard,
 	}

src/PdfKit/Enums.cs

@@ -33,8 +33,7 @@
 
 namespace PdfKit {
 
-	/// <summary>Enumerates named PDF action names.</summary>
-	/// <remarks>To be added.</remarks>
+	/// <summary>Enumerates named actions that can be performed in a PDF document.</summary>
 	[Native]
 	[TV (18, 2)]
 	public enum PdfActionNamedName : long {
@@ -65,7 +64,6 @@ public enum PdfActionNamedName : long {
 	}
 
 	/// <summary>Enumerates annotation widget controls.</summary>
-	/// <remarks>To be added.</remarks>
 	[Native]
 	[TV (18, 2)]
 	public enum PdfWidgetControlType : long {
@@ -79,8 +77,7 @@ public enum PdfWidgetControlType : long {
 		CheckBox = 2,
 	}
 
-	/// <summary>Enumerates line ending styles</summary>
-	/// <remarks>To be added.</remarks>
+	/// <summary>Enumerates line ending styles.</summary>
 	[Native]
 	[TV (18, 2)]
 	public enum PdfLineStyle : long {
@@ -98,8 +95,7 @@ public enum PdfLineStyle : long {
 		ClosedArrow = 5,
 	}
 
-	/// <summary>Indicates annotation markup types.</summary>
-	/// <remarks>To be added.</remarks>
+	/// <summary>Enumerates annotation markup types.</summary>
 	[Native]
 	[TV (18, 2)]
 	public enum PdfMarkupType : long {
@@ -109,11 +105,11 @@ public enum PdfMarkupType : long {
 		StrikeOut = 1,
 		/// <summary>Indicates an underline markup.</summary>
 		Underline = 2,
+		/// <summary>Indicates a redaction markup.</summary>
 		Redact = 3,
 	}
 
 	/// <summary>Enumerates annotation icon types.</summary>
-	/// <remarks>To be added.</remarks>
 	[Native]
 	[TV (18, 2)]
 	public enum PdfTextAnnotationIconType : long {
@@ -134,7 +130,6 @@ public enum PdfTextAnnotationIconType : long {
 	}
 
 	/// <summary>Enumerates annotation border styles.</summary>
-	/// <remarks>To be added.</remarks>
 	[Native]
 	[TV (18, 2)]
 	public enum PdfBorderStyle : long {
@@ -176,7 +171,6 @@ public enum PdfDocumentPermissions : long {
 	}
 
 	/// <summary>Enumerates Adobe-specified PDF display box boundaries.</summary>
-	/// <remarks>To be added.</remarks>
 	[Native]
 	[TV (18, 2)]
 	public enum PdfDisplayBox : long {
@@ -192,8 +186,7 @@ public enum PdfDisplayBox : long {
 		Art = 4,
 	}
 
-	/// <summary>Enumerated PDF display modes.</summary>
-	/// <remarks>To be added.</remarks>
+	/// <summary>Enumerates PDF display modes.</summary>
 	[Native]
 	[TV (18, 2)]
 	public enum PdfDisplayMode : long {
@@ -207,8 +200,7 @@ public enum PdfDisplayMode : long {
 		TwoUpContinuous = 3,
 	}
 
-	/// <summary>Orable flags that describe areas of interest for a touch position.</summary>
-	/// <remarks>To be added.</remarks>
+	/// <summary>Bitwise flags that describe areas of interest for a touch position.</summary>
 	[Flags]
 	[Native]
 	[TV (18, 2)]
@@ -233,6 +225,7 @@ public enum PdfAreaOfInterest : long {
 		PopupArea = 1 << 7,
 		/// <summary>Indicates that the touch position is over an image.</summary>
 		ImageArea = 1 << 8,
+		/// <summary>Indicates that all areas of interest are included.</summary>
 		[iOS (15, 0), MacCatalyst (15, 0)]
 		AnyArea = Int64.MaxValue,
 	}

tests/cecil-tests/Documentation.KnownFailures.txt

@@ -5811,8 +5811,6 @@ F:PdfKit.PdfAccessPermissions.DocumentChanges
 F:PdfKit.PdfAccessPermissions.FormFieldEntry
 F:PdfKit.PdfAccessPermissions.HighQualityPrinting
 F:PdfKit.PdfAccessPermissions.LowQualityPrinting
-F:PdfKit.PdfAreaOfInterest.AnyArea
-F:PdfKit.PdfMarkupType.Redact
 F:PdfKit.PdfSelectionGranularity.Character
 F:PdfKit.PdfSelectionGranularity.Line
 F:PdfKit.PdfSelectionGranularity.Word