[options] Rename `--add-metadata` to `--embed-metadata`

and clarify that it embeds chapter markers

diff --git a/yt_dlp/options.py b/yt_dlp/options.py
index b26d43d2acce9f54b734b31cc26c48ede5e944d0..20211a764f9d88b9c81e2980e5a4029f20e80216 100644 (file)
--- a/yt_dlp/options.py
+++ b/yt_dlp/options.py
@@ -1206,13 +1206,13 @@ def _dict_from_options_callback(
         action='store_false', dest='embedthumbnail',
         help='Do not embed thumbnail (default)')
     postproc.add_option(
-        '--add-metadata',
+        '--embed-metadata', '--add-metadata',
         action='store_true', dest='addmetadata', default=False,
-        help='Write metadata to the video file')
+        help='Embed metadata including chapter markers (if supported by the format) to the video file (Alias: --add-metadata)')
     postproc.add_option(
-        '--no-add-metadata',
+        '--no-embed-metadata', '--no-add-metadata',
         action='store_false', dest='addmetadata',
-        help='Do not write metadata (default)')
+        help='Do not write metadata (default)  (Alias: --no-add-metadata)')
     postproc.add_option(
         '--metadata-from-title',
         metavar='FORMAT', dest='metafromtitle',