diff --git a/doc/langref.html.in b/doc/langref.html.in
index 78dcd537b8c48548aa92e4e1cc0832e9d1535401..f64170817f3e46d7ba8d24ec6b1d0b0cd9f41301 100644
--- a/doc/langref.html.in
+++ b/doc/langref.html.in
@@ -3886,6 +3886,22 @@ test "if error union with optional" {
     } else |err| {
         assert(err == error.BadValue);
     }
+
+    // Access the value by reference by using a pointer capture each time.
+    var d: anyerror!?u32 = 3;
+    if (d) |*optional_value| {
+        if (optional_value.*) |*value| {
+            value.* = 9;
+        }
+    } else |err| {
+        unreachable;
+    }
+
+    if (d) |optional_value| {
+        assert(optional_value.? == 9);
+    } else |err| {
+        unreachable;
+    }
 }
       {#code_end#}
       {#see_also|Optionals|Errors#}