Update TODOs and deprecations

Author: josevalim

lib/elixir/lib/code.ex

@@ -1783,17 +1783,8 @@ defmodule Code do
       {:error, {:invalid_chunk, bin}}
   end
 
-  @doc ~S"""
-  Deprecated function to retrieve old documentation format.
-
-  Elixir v1.7 adopts [EEP 48](https://www.erlang.org/eeps/eep-0048.html)
-  which is a new documentation format meant to be shared across all
-  BEAM languages. The old format, used by `Code.get_docs/2`, is no
-  longer available, and therefore this function always returns `nil`.
-  Use `Code.fetch_docs/1` instead.
-  """
+  @doc false
   @deprecated "Code.get_docs/2 always returns nil as its outdated documentation is no longer stored on BEAM files. Use Code.fetch_docs/1 instead"
-  @spec get_docs(module, :moduledoc | :docs | :callback_docs | :type_docs | :all) :: nil
   def get_docs(_module, _kind) do
     nil
   end

lib/elixir/lib/config.ex

@@ -321,8 +321,6 @@ defmodule Config do
         :ok
     end
 
-    # TODO: Emit a warning if Mix.env() is found in said files in Elixir v1.15.
-    # Note this won't be a deprecation warning as it will always be emitted.
     Code.eval_string(contents, [], file: file)
   end
 

lib/elixir/lib/enum.ex

@@ -2912,11 +2912,7 @@ defmodule Enum do
   @spec slice(t, Range.t()) :: list
   def slice(enumerable, first..last//step = index_range) do
     # TODO: Deprecate negative steps on Elixir v1.16
-    # TODO: There are two features we can add to slicing ranges:
-    # 1. We can allow the step to be any positive number
-    # 2. We can allow slice and reverse at the same time. However, we can't
-    #    implement so right now. First we will have to raise if a decreasing
-    #    range is given on Elixir v2.0.
+    # TODO: Support negative steps as a reverse on Elixir v2.0.
     cond do
       step > 0 ->
         slice_range(enumerable, first, last, step)

lib/elixir/lib/module.ex

@@ -1282,7 +1282,6 @@ defmodule Module do
       only an interest in fetching the kind and the metadata
 
   """
-  # TODO: Deprecate :nillify_clauses in options on Elixir v1.16
   @spec get_definition(module, definition, keyword) ::
           {:v1, def_kind, meta :: keyword,
            [{meta :: keyword, arguments :: [Macro.t()], guards :: [Macro.t()], Macro.t()}]}

lib/elixir/src/elixir.erl

@@ -188,7 +188,7 @@ env_for_eval(#{lexical_tracker := Pid} = Env) ->
     false ->
       NewEnv#{tracers := []}
   end;
-%% TODO: Deprecate all options except line and file on v1.15.
+%% TODO: Deprecate all options except line, file, module, and function on v1.15.
 env_for_eval(Opts) when is_list(Opts) ->
   Env = elixir_env:new(),
 

lib/elixir/test/elixir/inspect_test.exs

@@ -1,12 +1,11 @@
 Code.require_file("test_helper.exs", __DIR__)
 
 # This is to temporarily test some inconsistencies in
-# the error ArgumentError messages
-# https://github.com/erlang/otp/issues/5440
-# TODO: once fixed in OTP and that minimum version is required,
-# please remove MyArgumentError and replace the calls to:
+# the error ArgumentError messages.
+# Remove MyArgumentError and replace the calls to:
 # - MyArgumentError with ArgumentError
 # - MyArgumentError.culprit() with Atom.to_string("Foo")
+# in Erlang/OTP 25
 defmodule MyArgumentError do
   defexception message: "argument error"