Should using @impl true cause docs to show the callback spec?

al2o3cr · April 4, 2022, 7:06pm

FWIW, searching the core Elixir repo for @impl true shows a lot of implementations that are @moduledoc false or at least have no @doc annotation.

Calendar.ISO does the repeating-spec thing:

github.com/elixir-lang/elixir

lib/elixir/lib/calendar/iso.ex

79cd891eb


      
          @doc since: "1.10.0"
          @impl true
          @spec parse_time(String.t()) ::
                  {:ok, {hour, minute, second, microsecond}}
                  | {:error, atom}
          def parse_time(string) when is_binary(string),
            do: parse_time(string, :extended)