diff --git a/Terminal.Gui/View/Layout/PosDim.cs b/Terminal.Gui/View/Layout/PosDim.cs
index 1471d2c44..9941546f7 100644
--- a/Terminal.Gui/View/Layout/PosDim.cs
+++ b/Terminal.Gui/View/Layout/PosDim.cs
@@ -342,8 +342,8 @@ public class Pos
/// height for y-coordinate calculation.
///
/// The dimension of the View. It could be the current width or height.
- /// Obsolete; to be deprecated.
- /// Obsolete; to be deprecated.
+ /// The View that holds this Pos object.
+ /// Width or Height
///
/// The calculated position of the View. The way this position is calculated depends on the specific subclass of Pos
/// that
@@ -671,11 +671,11 @@ public class Dim
///
/// var button = new Button () { Text = "Click Me!", X = 1, Y = 1, Width = 10, Height = 1 };
/// var textField = new TextField { Text = "Type here", X = 1, Y = 2, Width = 20, Height = 1 };
- /// var view = new Window () { Title = "MyWindow", X = 0, Y = 0, Width = Dim.AutoSize (), Height = Dim.AutoSize () };
+ /// var view = new Window () { Title = "MyWindow", X = 0, Y = 0, Width = Dim.Auto (), Height = Dim.Auto () };
/// view.Add (button, textField);
///
///
- /// The AutoSize object.
+ /// The object.
///
/// Specifies how will compute the dimension. The default is .
///
@@ -828,6 +828,8 @@ public class Dim
/// top edge for height calculation.
///
/// The size of the SuperView's content. It could be width or height.
+ /// The View that holds this Pos object.
+ /// Width or Height
///
/// The calculated size of the View. The way this size is calculated depends on the specific subclass of Dim that
/// is used.