From dbe8cded6ad3fa0e3635caaa478f48cfa3bf4d02 Mon Sep 17 00:00:00 2001
From: Moritz Bunkus <mo@bunkus.online>
Date: Mon, 11 Mar 2024 19:55:13 +0100
Subject: [PATCH] docs: add mkvmerge's new option '--regenerate-track-uids'

---
 doc/man/mkvmerge.xml | 16 ++++++++++++++++
 1 file changed, 16 insertions(+)

diff --git a/doc/man/mkvmerge.xml b/doc/man/mkvmerge.xml
index adbfa0b00..ff7cdd106 100644
--- a/doc/man/mkvmerge.xml
+++ b/doc/man/mkvmerge.xml
@@ -1398,6 +1398,22 @@ $ mkvmerge -o out.mkv '(' file.mkv ')'</screen>
      </listitem>
     </varlistentry>
 
+    <varlistentry id="mkvmerge.description.regenerate_track_uids">
+     <term><option>--regenerate-track-uids</option></term>
+     <listitem>
+      <para>
+       When this option is used for a Matroska source file, &mkvmerge; will create new random unique track IDs instead of keeping the
+       existing ones in the file. Existing track UIDs in chapters &amp; tags read from the same file will be remapped to the newly generated
+       values.
+      </para>
+
+      <para>
+       This behavior is enabled automatically for Matroska files created by the MakeMKV software. The reason is that MakeMKV uses
+       consecutive numbers (1, 2, 3…) as UIDs instead of generating random ones.
+      </para>
+     </listitem>
+    </varlistentry>
+
     <varlistentry id="mkvmerge.description.sync">
      <term><option>-y</option>, <option>--sync</option> <parameter>TID:d<optional>,o<optional>/p</optional></optional></parameter></term>
      <listitem>