From 4f547d922de6535032207dc91dadd32c77b15e22 Mon Sep 17 00:00:00 2001
From: nanahi <130121847+na-na-hi@users.noreply.github.com>
Date: Sat, 14 Mar 2026 09:40:03 -0400
Subject: [PATCH 1/2] DOCS/man/mpv: document archive protocol

This protocol is useful for opening a specified file in an archive
instead of opening the archive as a playlist.
---
 DOCS/man/mpv.rst | 14 ++++++++++++++
 1 file changed, 14 insertions(+)

diff --git a/DOCS/man/mpv.rst b/DOCS/man/mpv.rst
index 420297483e7e4..ce2c24f9247b2 100644
--- a/DOCS/man/mpv.rst
+++ b/DOCS/man/mpv.rst
@@ -1474,6 +1474,20 @@ PROTOCOLS
 
     Like ``memory://``, but the string is interpreted as hexdump.
 
+``archive://[ARCHIVE PATH]|[FILE PATH IN ARCHIVE]``
+
+    Open a file at the specified path inside an archive. Requires libarchive
+    feature enabled. The archive path must have all ``%`` and ``|`` characters
+    URL escaped. The file path should not be URL escaped.
+
+    .. admonition:: Example
+
+        ::
+
+            mpv "archive://file.zip|video.mkv"
+
+        This will play ``video.mkv`` in the archive file ``file.zip``.
+
 PSEUDO GUI MODE
 ===============
 

From ec929cde400436db5471f02242b87dd37e8cf856 Mon Sep 17 00:00:00 2001
From: nanahi <130121847+na-na-hi@users.noreply.github.com>
Date: Sat, 14 Mar 2026 09:50:07 -0400
Subject: [PATCH 2/2] DOCS/man/mpv: use admonition for slice protocol examples

---
 DOCS/man/mpv.rst | 26 ++++++++++++++++----------
 1 file changed, 16 insertions(+), 10 deletions(-)

diff --git a/DOCS/man/mpv.rst b/DOCS/man/mpv.rst
index ce2c24f9247b2..ba591e03e020a 100644
--- a/DOCS/man/mpv.rst
+++ b/DOCS/man/mpv.rst
@@ -1443,22 +1443,28 @@ PROTOCOLS
 
     Only works with seekable streams.
 
-    Examples::
+    .. admonition:: Example
+
+        ::
 
-      mpv slice://1g-2g@cap.ts
+            mpv slice://1g-2g@cap.ts
 
-      This starts reading from cap.ts after seeking 1 GiB, then
-      reads until reaching 2 GiB or end of file.
+        This starts reading from cap.ts after seeking 1 GiB, then
+        reads until reaching 2 GiB or end of file.
 
-      mpv slice://1g-+2g@cap.ts
+        ::
 
-      This starts reading from cap.ts after seeking 1 GiB, then
-      reads until reaching 3 GiB or end of file.
+            mpv slice://1g-+2g@cap.ts
+
+        This starts reading from cap.ts after seeking 1 GiB, then
+        reads until reaching 3 GiB or end of file.
+
+        ::
 
-      mpv slice://100m@appending://cap.ts
+            mpv slice://100m@appending://cap.ts
 
-      This starts reading from cap.ts after seeking 100MiB, then
-      reads until end of file.
+        This starts reading from cap.ts after seeking 100MiB, then
+        reads until end of file.
 
 ``null://``