Include man formatter in default formatters list

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: garazdawi

lib/ex_doc.ex

@@ -101,7 +101,7 @@ defmodule ExDoc do
       against the complete module name (which includes the "Elixir." prefix for
       Elixir modules). If a module has `@moduledoc false`, then it is always excluded.
 
-    * `:formatters` - Formatter to use; default: ["html", "markdown", "epub"], options: "html", "markdown", "epub".
+    * `:formatters` - Formatter to use; default: ["html", "markdown", "man", "epub"], options: "html", "markdown", "man", "epub".
 
     * `:man` - Controls which modules get man pages. `:all` (default) generates for all modules,
       `:tasks` generates only for mix tasks (section 1), `false` skips module man pages entirely.

lib/ex_doc/cli.ex

@@ -111,7 +111,7 @@ defmodule ExDoc.CLI do
   defp normalize_formatters(opts) do
     formatters =
       case Keyword.get_values(opts, :formatter) do
-        [] -> opts[:formatters] || ["html", "markdown", "epub"]
+        [] -> opts[:formatters] || ["html", "markdown", "man", "epub"]
         values -> values
       end
 

lib/mix/tasks/docs.ex

@@ -195,7 +195,7 @@ defmodule Mix.Tasks.Docs do
   defp normalize_formatters(options) do
     formatters =
       case Keyword.get_values(options, :formatter) do
-        [] -> options[:formatters] || ["html", "markdown", "epub"]
+        [] -> options[:formatters] || ["html", "markdown", "man", "epub"]
         values -> values
       end
 

test/ex_doc/cli_test.exs

@@ -24,28 +24,19 @@ defmodule ExDoc.CLITest do
   end
 
   test "minimum command-line options" do
-    {[html, epub, markdown], _io} = run(["ExDoc", "1.2.3", @ebin])
-
-    assert html ==
-             {"ExDoc", "1.2.3", [@ebin],
-              [
-                formatters: ["html", "markdown", "epub"],
-                apps: [:ex_doc]
-              ]}
-
-    assert epub ==
-             {"ExDoc", "1.2.3", [@ebin],
-              [
-                formatters: ["html", "markdown", "epub"],
-                apps: [:ex_doc]
-              ]}
-
-    assert markdown ==
-             {"ExDoc", "1.2.3", [@ebin],
-              [
-                formatters: ["html", "markdown", "epub"],
-                apps: [:ex_doc]
-              ]}
+    {[html, epub, man, markdown], _io} = run(["ExDoc", "1.2.3", @ebin])
+
+    expected_config =
+      {"ExDoc", "1.2.3", [@ebin],
+       [
+         formatters: ["html", "markdown", "man", "epub"],
+         apps: [:ex_doc]
+       ]}
+
+    assert html == expected_config
+    assert epub == expected_config
+    assert man == expected_config
+    assert markdown == expected_config
   end
 
   test "formatter option" do
@@ -79,13 +70,11 @@ defmodule ExDoc.CLITest do
   end
 
   test "multiple apps" do
-    {[{"ExDoc", "1.2.3", _, html}, {"ExDoc", "1.2.3", _, epub}, {"ExDoc", "1.2.3", _, markdown}],
-     _io} =
-      run(["ExDoc", "1.2.3", @ebin, @ebin2])
+    {results, _io} = run(["ExDoc", "1.2.3", @ebin, @ebin2])
 
-    assert [:ex_doc, :makeup] = Enum.sort(Keyword.get(html, :apps))
-    assert [:ex_doc, :makeup] = Enum.sort(Keyword.get(epub, :apps))
-    assert [:ex_doc, :makeup] = Enum.sort(Keyword.get(markdown, :apps))
+    for {"ExDoc", "1.2.3", _, opts} <- results do
+      assert [:ex_doc, :makeup] = Enum.sort(Keyword.get(opts, :apps))
+    end
   end
 
   test "arguments that are not aliased" do

test/mix/tasks/docs_test.exs

@@ -39,7 +39,7 @@ defmodule Mix.Tasks.DocsTest do
     assert [
              {"ex_doc", "0.1.0", _,
               [
-                formatters: ["html", "markdown", "epub"],
+                formatters: ["html", "markdown", "man", "epub"],
                 deps: _,
                 apps: _,
                 proglang: :elixir
@@ -250,7 +250,7 @@ defmodule Mix.Tasks.DocsTest do
     assert [
              {"ex_doc", "dev", _,
               [
-                formatters: ["html", "markdown", "epub"],
+                formatters: ["html", "markdown", "man", "epub"],
                 deps: _,
                 apps: [:ex_doc],
                 warnings_as_errors: false,