diff --git a/src/Graphics/CommandBuffer.cs b/src/Graphics/CommandBuffer.cs
index 9b7c9161..19f56b12 100644
--- a/src/Graphics/CommandBuffer.cs
+++ b/src/Graphics/CommandBuffer.cs
@@ -656,6 +656,9 @@ namespace MoonWorks.Graphics
 		/// <summary>
 		/// Acquires a swapchain texture.
 		/// This texture will be presented to the given window when the command buffer is submitted.
+		/// Can return null if the swapchain is unavailable. The user should ALWAYS handle the case where this occurs.
+		/// If null is returned, presentation will not occur.
+		/// It is an error to acquire two swapchain textures from the same window in one command buffer.
 		/// </summary>
 		public Texture? AcquireSwapchainTexture(
 			Window window