--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/mupdf-source/docs/tools/mutool-poster.rst	Mon Sep 15 11:43:07 2025 +0200
@@ -0,0 +1,32 @@
+mutool poster
+==========================================
+
+The ``poster`` command reads the input PDF file and for each page chops it up into ``x`` by ``y`` pieces. Each piece becomes its own page in the output PDF file. This makes it possible for each page to be printed upscaled and can then be merged into a large poster.
+
+.. code-block:: bash
+
+	mutool poster [options] input.pdf [output.pdf]
+
+``[options]``
+	Options are as follows:
+
+	``-p`` password
+		Use the specified password if the file is encrypted.
+
+	``-m`` margin
+		Set the margin (overlap) between pages in points or percent.
+
+	``-x`` x decimation factor
+		Pieces to horizontally divide each page into.
+
+	``-y`` y decimation factor
+		Pieces to vertically divide each page into.
+
+	``-r``
+		Split horizontally from right to left (default splits from left to right).
+
+``input.pdf``
+	The input PDF document.
+
+``[output.pdf]``
+	The output filename. Defaults to "out.pdf" if not supplied.