From 69333bddce26f1ed1a1f3de8c1e6d33938a5d8fc Mon Sep 17 00:00:00 2001
From: Moritz Bunkus <mo@bunkus.online>
Date: Wed, 16 Aug 2023 09:02:01 +0000
Subject: [PATCH] Update Adding files vs. Appending files vs. adding as
 additional parts

---
 ...nding-files-vs.-adding-as-additional-parts.md | 16 ++++++++++++++++
 1 file changed, 16 insertions(+)

diff --git a/Adding-files-vs.-Appending-files-vs.-adding-as-additional-parts.md b/Adding-files-vs.-Appending-files-vs.-adding-as-additional-parts.md
index e33500d..cb8ab03 100644
--- a/Adding-files-vs.-Appending-files-vs.-adding-as-additional-parts.md
+++ b/Adding-files-vs.-Appending-files-vs.-adding-as-additional-parts.md
@@ -15,6 +15,22 @@ What does "add" mean compared to "append"? And what is the difference between ap
 
 Coming back to the GUI, when you "add files" their content will be laid out in parallel to the files/tracks that are part of the multiplexer job already. For example, when you have two separate source files, one with both audio & viedo tracks and a second file containing subtitles, you would use the "add files" action for both source files as you would like to have the audio, video & subtitle content play simultaneously.
 
+### mkvmerge syntax
+
+The default for all file names given to `mkvmerge` is to lay them out in parallel. If you want to append a file to another file so that the two are laid out sequentially, you'll have to use the `+` operator before the second file name. For example:
+
+```
+mkvmerge -o parallel_layout.mkv input1.mkv input2.opus input3.srt
+```
+
+vs
+
+```
+mkvmerge -o sequential_layout.mkv input1.mp4 + input2.mp4 + input3.mp4
+```
+
+See the [documentation](https://mkvtoolnix.download/doc/mkvmerge.html) for details.
+
 ### "Appending files" vs "adding as additional parts"
 
 Even though the second option is named "adding…", both options actually cause the content to be laid out sequentially after all of the content of the file they're appended/added to. Which mode you should use depends on the type of source file, though, and unfortunately this decision cannot be fully automated.