futhark fmt deserves its own manpage.

docs/conf.py

@@ -510,6 +510,13 @@ class FutharkLexer(RegexLexer):
         [],
         1,
     ),
+    (
+        "man/futhark-fmt",
+        "futhark-fmt",
+        "format Futhark programs",
+        [],
+        1,
+    ),
     ("man/futhark-pkg", "futhark-pkg", "manage Futhark packages", [], 1),
     (
         "man/futhark-literate",

docs/index.rst

@@ -51,6 +51,7 @@ the `development blog <https://futhark-lang.org/blog.html>`_.
    man/futhark-cuda.rst
    man/futhark-dataset.rst
    man/futhark-doc.rst
+   man/futhark-fmt.rst
    man/futhark-hip.rst
    man/futhark-ispc.rst
    man/futhark-literate.rst

docs/man/futhark-fmt.rst

@@ -0,0 +1,39 @@
+.. role:: ref(emphasis)
+
+.. _futhark-fmt(1):
+
+===========
+futhark-fmt
+===========
+
+SYNOPSIS
+========
+
+futhark fmt [FILES]
+
+DESCRIPTION
+===========
+
+Reformat the given Futhark programs. If no files are provided, read
+Futhark program on stdin and produce formatted output on stdout. If
+stdout is a terminal, the output will be syntax highlighted.
+
+In contrast to many other automatic formatters, the formatting is
+somewhat sensitive to the formatting of the input program. In
+particular, single-line expressions will usually be kept on a single
+line, even if they are very long. To force ``futhark fmt`` to break
+these, insert a linebreak at an arbitrary location.
+
+OPTIONS
+=======
+
+-h
+  Print help text to standard output and exit.
+
+-V
+  Print version information on standard output and exit.
+
+SEE ALSO
+========
+
+:ref:`futhark-doc(1)`

docs/man/futhark.rst

@@ -79,13 +79,6 @@ futhark eval [-f FILE] [-w] <exprs...>
 Evaluates expressions given as command-line arguments. Optionally
 allows a file import using ``-f``.
 
-futhark fmt [FILE]
-------------------
-
-Reformat the given Futhark program. If no file is provided, read
-Futhark program on stdin and produce formatted output on stdout. If
-stdout is a terminal, the output will be syntax highlighted.
-
 futhark hash PROGRAM
 --------------------