[AppKit] Document ten enum types

src/AppKit/Enums.cs

@@ -1976,12 +1976,13 @@ public enum NSGestureRecognizerState : long {
 	#endregion
 
 	#region NSStackLayout
+	/// <summary>Specifies the axis along which user interface elements are laid out.</summary>
 	[NoMacCatalyst]
 	[Native]
 	public enum NSUserInterfaceLayoutOrientation : long {
-		/// <summary>To be added.</summary>
+		/// <summary>Elements are laid out along the horizontal axis.</summary>
 		Horizontal = 0,
-		/// <summary>To be added.</summary>
+		/// <summary>Elements are laid out along the vertical axis.</summary>
 		Vertical = 1,
 	}
 
@@ -2848,12 +2849,13 @@ public enum NSTickMarkPosition : ulong {
 		Trailing = Right,
 	}
 
+	/// <summary>Specifies the shape of a slider.</summary>
 	[NoMacCatalyst]
 	[Native]
 	public enum NSSliderType : ulong {
-		/// <summary>To be added.</summary>
+		/// <summary>A horizontal or vertical linear slider.</summary>
 		Linear = 0,
-		/// <summary>To be added.</summary>
+		/// <summary>A circular slider.</summary>
 		Circular = 1,
 	}
 
@@ -2987,6 +2989,7 @@ public enum NSFontCollectionOptions : long {
 		ApplicationOnlyMask = 1,
 	}
 
+	/// <summary>Specifies whether a drop occurs on an item or before it.</summary>
 #if XAMCORE_5_0
 	[NoMacCatalyst]
 #else
@@ -2998,9 +3001,9 @@ public enum NSFontCollectionOptions : long {
 #endif
 	[Native]
 	public enum NSCollectionViewDropOperation : long {
-		/// <summary>To be added.</summary>
+		/// <summary>The drop occurs on the item at the specified index path.</summary>
 		On = 0,
-		/// <summary>To be added.</summary>
+		/// <summary>The drop occurs before the item at the specified index path.</summary>
 		Before = 1,
 	}
 
@@ -3825,12 +3828,13 @@ public enum NSLayoutPriority : int /*float*/ {
 		FittingSizeCompression = 50,
 	}
 
+	/// <summary>Specifies the visual appearance of a popover.</summary>
 	[NoMacCatalyst]
 	[Native]
 	public enum NSPopoverAppearance : long {
-		/// <summary>To be added.</summary>
+		/// <summary>A minimal popover appearance.</summary>
 		Minimal,
-		/// <summary>To be added.</summary>
+		/// <summary>A heads-up display appearance.</summary>
 		HUD,
 	}
 
@@ -3870,12 +3874,13 @@ public enum NSTableRowActionEdge : long {
 		Trailing,
 	}
 
+	/// <summary>Specifies whether a table row action is regular or destructive.</summary>
 	[NoMacCatalyst]
 	[Native]
 	public enum NSTableViewRowActionStyle : long {
-		/// <summary>To be added.</summary>
+		/// <summary>A regular, nondestructive action.</summary>
 		Regular,
-		/// <summary>To be added.</summary>
+		/// <summary>An action that performs a destructive operation.</summary>
 		Destructive,
 	}
 
@@ -4060,12 +4065,13 @@ public enum NSPageControllerTransitionStyle : long {
 		HorizontalStrip,
 	}
 
+	/// <summary>Specifies whether a window's title is displayed.</summary>
 	[NoMacCatalyst]
 	[Native]
 	public enum NSWindowTitleVisibility : long {
-		/// <summary>To be added.</summary>
+		/// <summary>The window title is displayed.</summary>
 		Visible = 0,
-		/// <summary>To be added.</summary>
+		/// <summary>The window title is hidden.</summary>
 		Hidden = 1,
 	}
 
@@ -4162,12 +4168,13 @@ public enum NSVisualEffectMaterial : long {
 		UnderPageBackground = 22,
 	}
 
+	/// <summary>Specifies which content a visual effect view blends with.</summary>
 	[NoMacCatalyst]
 	[Native]
 	public enum NSVisualEffectBlendingMode : long {
-		/// <summary>To be added.</summary>
+		/// <summary>Blends with content behind the window.</summary>
 		BehindWindow,
-		/// <summary>To be added.</summary>
+		/// <summary>Blends with content behind the view in the current window.</summary>
 		WithinWindow,
 	}
 
@@ -4258,12 +4265,13 @@ public enum NSWindowListOptions : long {
 		OrderedFrontToBack = (1 << 0),
 	}
 
+	/// <summary>Specifies optional behaviors for a status item.</summary>
 	[NoMacCatalyst]
 	[Native]
 	public enum NSStatusItemBehavior : ulong {
-		/// <summary>To be added.</summary>
+		/// <summary>Allows the user to remove the status item from the menu bar.</summary>
 		RemovalAllowed = (1 << 1),
-		/// <summary>To be added.</summary>
+		/// <summary>Allows the user to remove the status item and terminates the application when they do so. This option implies <see cref="RemovalAllowed" />.</summary>
 		TerminationOnRemoval = (1 << 2),
 	}
 
@@ -4394,22 +4402,24 @@ public enum NSPasteboardContentsOptions : ulong {
 		CurrentHostOnly = 1,
 	}
 
+	/// <summary>Specifies whether contact occurs directly on a display or through an indirect input device.</summary>
 	[NoMacCatalyst]
 	[Native]
 	public enum NSTouchType : long {
-		/// <summary>To be added.</summary>
+		/// <summary>Contact occurs directly on a display.</summary>
 		Direct,
-		/// <summary>To be added.</summary>
+		/// <summary>Contact occurs on an indirect input device, such as a trackpad.</summary>
 		Indirect,
 	}
 
+	/// <summary>Specifies the types of touch input to include.</summary>
 	[NoMacCatalyst]
 	[Native]
 	[Flags]
 	public enum NSTouchTypeMask : ulong {
-		/// <summary>To be added.</summary>
+		/// <summary>Includes direct touch input.</summary>
 		Direct = (1 << (int) NSTouchType.Direct),
-		/// <summary>To be added.</summary>
+		/// <summary>Includes indirect touch input.</summary>
 		Indirect = (1 << (int) NSTouchType.Indirect),
 	}
 

tests/cecil-tests/Documentation.KnownFailures.txt

@@ -22410,7 +22410,6 @@ T:AppKit.NSCollectionLayoutSectionVisibleItemsInvalidationHandler
 T:AppKit.NSCollectionViewCompositionalLayoutSectionProvider
 T:AppKit.NSCollectionViewDiffableDataSourceItemProvider
 T:AppKit.NSCollectionViewDiffableDataSourceSupplementaryViewProvider
-T:AppKit.NSCollectionViewDropOperation
 T:AppKit.NSCollectionViewItemHighlightState
 T:AppKit.NSCollectionViewScrollPosition
 T:AppKit.NSColorPanelFlags
@@ -22557,7 +22556,6 @@ T:AppKit.NSPathStyle
 T:AppKit.NSPickerTouchBarItemControlRepresentation
 T:AppKit.NSPickerTouchBarItemSelectionMode
 T:AppKit.NSPointingDeviceType
-T:AppKit.NSPopoverAppearance
 T:AppKit.NSPopoverBehavior
 T:AppKit.NSPopUpArrowPosition
 T:AppKit.NSPressureBehavior
@@ -22602,7 +22600,6 @@ T:AppKit.NSSharingServicePickerSharingServicesForItems
 T:AppKit.NSSharingServiceSourceFrameOnScreenForShareItem
 T:AppKit.NSSharingServiceSourceWindowForShareItems
 T:AppKit.NSSharingServiceTransitionImageForShareItem
-T:AppKit.NSSliderType
 T:AppKit.NSSpellCheckerShowCorrectionIndicatorOfTypeHandler
 T:AppKit.NSSpellingState
 T:AppKit.NSSplitViewItemBehavior
@@ -22612,7 +22609,6 @@ T:AppKit.NSStackViewDistribution
 T:AppKit.NSStackViewGravity
 T:AppKit.NSStackViewVisibilityPriority
 T:AppKit.NSStandardKeyBindingMethods
-T:AppKit.NSStatusItemBehavior
 T:AppKit.NSStoryboardControllerCreator
 T:AppKit.NSStringAttributeKey
 T:AppKit.NSStringDrawing_NSAttributedString
@@ -22636,7 +22632,6 @@ T:AppKit.NSTableViewEventString
 T:AppKit.NSTableViewIndexFilter
 T:AppKit.NSTableViewPredicate
 T:AppKit.NSTableViewRowActionsGetter
-T:AppKit.NSTableViewRowActionStyle
 T:AppKit.NSTableViewRowGetter
 T:AppKit.NSTableViewRowHandler
 T:AppKit.NSTableViewRowHeight
@@ -22734,14 +22729,11 @@ T:AppKit.NSTouchBarItemIdentifier
 T:AppKit.NSTouchBarMakeItem
 T:AppKit.NSTouchEvent
 T:AppKit.NSTouchPhase
-T:AppKit.NSTouchType
-T:AppKit.NSTouchTypeMask
 T:AppKit.NSTrackingAreaOptions
 T:AppKit.NSTypesetterBehavior
 T:AppKit.NSTypesetterControlCharacterAction
 T:AppKit.NSUnderlinePattern
 T:AppKit.NSUsableScrollerParts
-T:AppKit.NSUserInterfaceLayoutOrientation
 T:AppKit.NSVerticalDirections
 T:AppKit.NSView_NSCandidateListTouchBarItem
 T:AppKit.NSView_NSTouchBar
@@ -22750,7 +22742,6 @@ T:AppKit.NSViewLayerContentsPlacement
 T:AppKit.NSViewLayerContentsRedrawPolicy
 T:AppKit.NSViewLayoutRegionAdaptivityAxis
 T:AppKit.NSViewResizingMask
-T:AppKit.NSVisualEffectBlendingMode
 T:AppKit.NSVisualEffectMaterial
 T:AppKit.NSVisualEffectState
 T:AppKit.NSWindowAnimationBehavior
@@ -22774,7 +22765,6 @@ T:AppKit.NSWindowSize
 T:AppKit.NSWindowSizeSize
 T:AppKit.NSWindowStyle
 T:AppKit.NSWindowTabbingMode
-T:AppKit.NSWindowTitleVisibility
 T:AppKit.NSWindowToolbarStyle
 T:AppKit.NSWindowTrackEventsMatchingCompletionHandler
 T:AppKit.NSWindowUndoManager