diff mupdf-source/docs/tools/mutool-merge.rst @ 2:b50eed0cc0ef upstream

ADD: MuPDF v1.26.7: the MuPDF source as downloaded by a default build of PyMuPDF 1.26.4. The directory name has changed: no version number in the expanded directory now.
author Franz Glasner <fzglas.hg@dom66.de>
date Mon, 15 Sep 2025 11:43:07 +0200
parents
children
line wrap: on
line diff
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/mupdf-source/docs/tools/mutool-merge.rst	Mon Sep 15 11:43:07 2025 +0200
@@ -0,0 +1,29 @@
+mutool merge
+============
+
+The ``merge`` command is used to pick out pages from two or more files and merge them into a new output file.
+
+.. code-block:: bash
+
+	mutool merge [-o output.pdf] [-O options] input1.pdf [pages1] [input2.pdf] [pages2] ...
+
+``[-o output.pdf]``
+	The output filename. Defaults to "out.pdf" if not supplied.
+
+``[-O options]``
+	See :doc:`/reference/common/pdf-write-options`.
+
+``input1.pdf``
+	The first document.
+
+``[pages1]``
+	Comma separated list of page ranges for the first document (``input.pdf``). The first page is "1", and the last page is "N". The default is "1-N".
+
+``[input2.pdf]``
+	The second document.
+
+``[pages2]``
+	Comma separated list of page ranges for the second document (``input2.pdf``). The first page is "1", and the last page is "N". The default is "1-N".
+
+``...``
+	Indicates that we add as many additional ``[input]`` & ``[pages]`` pairs as required to merge multiple documents.