From 873009e3e666a66a26025b6d869d39927eed453e Mon Sep 17 00:00:00 2001
From: Nadia Aina <113453463+Nadia-Adaptive@users.noreply.github.com>
Date: Wed, 19 Aug 2026 11:21:20 +0100
Subject: [PATCH] Port API and docs changes

---
 src/Adaptive.Aeron/Image.cs           | 3 +++
 src/Adaptive.Archiver/AeronArchive.cs | 2 ++
 src/Adaptive.Archiver/ArchiveProxy.cs | 2 ++
 3 files changed, 7 insertions(+)

diff --git a/src/Adaptive.Aeron/Image.cs b/src/Adaptive.Aeron/Image.cs
index 2d9c97db..1ef5d110 100644
--- a/src/Adaptive.Aeron/Image.cs
+++ b/src/Adaptive.Aeron/Image.cs
@@ -176,6 +176,7 @@ long correlationId
         /// <summary>
         /// The position this <seealso cref="Image"/> has been consumed to by the subscriber.
         /// </summary>
+        /// <remarks> The Position setter is deprecated and will be removed in 1.53.0. </remarks>
         /// <returns> the position this <seealso cref="Image"/> has been consumed to by the subscriber. </returns>
         public long Position
         {
@@ -730,6 +731,7 @@ public int BoundedControlledPoll(ControlledFragmentHandler handler, long limitPo
         /// <returns> the resulting position after the scan terminates which is a complete message. </returns>
         /// <seealso cref="ControlledFragmentAssembler"/>
         /// <seealso cref="ImageControlledFragmentAssembler"/>
+        [Obsolete("Will be removed in 1.53.0.")]
         public long ControlledPeek(long initialPosition, IControlledFragmentHandler handler, long limitPosition)
         {
             if (_isClosed)
@@ -809,6 +811,7 @@ public long ControlledPeek(long initialPosition, IControlledFragmentHandler hand
             return resultingPosition;
         }
 
+        [Obsolete("Will be removed in 1.53.0.")]
         public long ControlledPeek(long initialPosition, ControlledFragmentHandler handler, long limitPosition)
         {
             var fragmentHandler = HandlerHelper.ToControlledFragmentHandler(handler);
diff --git a/src/Adaptive.Archiver/AeronArchive.cs b/src/Adaptive.Archiver/AeronArchive.cs
index e1d5ad7f..7fd95b47 100644
--- a/src/Adaptive.Archiver/AeronArchive.cs
+++ b/src/Adaptive.Archiver/AeronArchive.cs
@@ -1705,6 +1705,8 @@ public long FindLastMatchingRecording(long minRecordingId, string channelFragmen
         /// position must be on a fragment boundary. Truncating a recording to the start position effectively deletes
         /// the recording.
         ///
+        /// Truncating a recording will stop any concurrent replays of that recording.
+        ///
         /// </summary>
         /// <param name="recordingId"> of the stopped recording to be truncated. </param>
         /// <param name="position">    to which the recording will be truncated. </param>
diff --git a/src/Adaptive.Archiver/ArchiveProxy.cs b/src/Adaptive.Archiver/ArchiveProxy.cs
index 6551fefd..bead7725 100644
--- a/src/Adaptive.Archiver/ArchiveProxy.cs
+++ b/src/Adaptive.Archiver/ArchiveProxy.cs
@@ -742,6 +742,8 @@ public bool GetRecordingPosition(long recordingId, long correlationId, long cont
         /// position must be on a fragment boundary. Truncating a recording to the start position effectively deletes
         /// the recording.
         ///
+        /// Truncating a recording will stop any concurrent replays of that recording.
+        ///
         /// </summary>
         /// <param name="recordingId">      of the stopped recording to be truncated. </param>
         /// <param name="position">         to which the recording will be truncated. </param>