From 679f179a60fbe061dfd4833863a8473e764f1f88 Mon Sep 17 00:00:00 2001
From: David Wendt <dcrkid@yahoo.com>
Date: Sat, 1 Jul 2023 13:21:20 -0400
Subject: [PATCH] docs: Document the aliasing situation with `VideoSource::Swf`

---
 core/src/display_object/video.rs | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/core/src/display_object/video.rs b/core/src/display_object/video.rs
index 61a634782..e2a89a479 100644
--- a/core/src/display_object/video.rs
+++ b/core/src/display_object/video.rs
@@ -96,6 +96,13 @@ pub enum VideoStream {
 #[collect(no_drop)]
 pub enum VideoSource<'gc> {
     /// A video bitstream embedded inside of a SWF movie.
+    /// 
+    /// NOTE: Fields within this enum will be shared across all instances of a
+    /// particular character. If you need to mutate the video source, consider
+    /// reallocating a new source for your specific video instead.
+    /// 
+    /// This warning does not apply to `NetStream` or `Unconnected` videos,
+    /// which are never aliased.
     Swf {
         /// The video stream definition.
         #[collect(require_static)]