--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/mupdf-source/docs/tools/mutool-trace.rst	Mon Sep 15 11:43:07 2025 +0200
@@ -0,0 +1,62 @@
+mutool trace
+============
+
+The ``trace`` command prints a trace of all the device calls used to render a page.
+
+.. code-block:: bash
+
+	mutool trace [options] file [pages]
+
+``[options]``
+	Options are as follows:
+
+	``-p`` password
+		Use the specified password if the file is encrypted.
+	``-W`` width
+		Page width in points for EPUB layout.
+	``-H`` height
+		Page height in points for EPUB layout.
+	``-S`` size
+		Font size in points for EPUB layout.
+	``-U`` filename
+		User CSS stylesheet for EPUB layout.
+	``-X``
+		Disable document styles for EPUB layout.
+	``-d``
+		Use display list.
+
+``file``
+	Input file name. The file can be any of the supported input formats.
+
+``[pages]``
+	Comma separated list of page ranges. The first page is "1", and the
+	last page is "N". The default is "1-N".
+
+The trace takes the form of an XML document, with the root element being the
+document, its children each page, and one page child element for each device
+call on that page.
+
+An example trace
+----------------
+
+.. code-block:: xml
+
+	<document filename="hello.pdf">
+	<page number="1" mediabox="0 0 595 842">
+	<fill_path winding="nonzero" colorspace="DeviceRGB" color="1 0 0" transform="1 0 0 -1 0 842">
+	<moveto x="50" y="50"/>
+	<lineto x="100" y="200"/>
+	<lineto x="200" y="50"/>
+	</fill_path>
+	<fill_text colorspace="DeviceRGB" color="0" transform="1 0 0 -1 0 842">
+	<span font="Times-Roman" wmode="0" trm="100 0 0 100">
+	<g unicode="H" glyph="H" x="50" y="500" />
+	<g unicode="e" glyph="e" x="122.2" y="500" />
+	<g unicode="l" glyph="l" x="166.6" y="500" />
+	<g unicode="l" glyph="l" x="194.4" y="500" />
+	<g unicode="o" glyph="o" x="222.2" y="500" />
+	<g unicode="!" glyph="exclam" x="272.2" y="500" />
+	</span>
+	</fill_text>
+	</page>
+	</document>