Improve non-standard messages in @deprecated (#15984)

Author: rhcarvalho

lib/elixir/lib/io/ansi.ex

@@ -151,7 +151,7 @@ defmodule IO.ANSI do
   defsequence.(:blink, 5, "m")
 
   @doc "Blink: slow. Less than 150 per minute."
-  @doc deprecated: "Use blink/0 instead."
+  @doc deprecated: "Use blink/0 instead"
   defsequence.(:blink_slow, 5, "m")
 
   @doc "Blink: rapid. MS-DOS ANSI.SYS; 150 per minute or more; not widely supported."
@@ -161,23 +161,23 @@ defmodule IO.ANSI do
   defsequence.(:inverse, 7, "m")
 
   @doc "Image: negative. Swap foreground and background."
-  @doc deprecated: "Use inverse/0 instead."
+  @doc deprecated: "Use inverse/0 instead"
   defsequence.(:reverse, 7, "m")
 
   @doc "Invisible. Not widely supported."
   @doc since: "1.21.0"
   defsequence.(:invisible, 8, "m")
 
   @doc "Conceal. Not widely supported."
-  @doc deprecated: "Use invisible/0 instead."
+  @doc deprecated: "Use invisible/0 instead"
   defsequence.(:conceal, 8, "m")
 
   @doc "Strikethrough. Not widely supported."
   @doc since: "1.21.0"
   defsequence.(:strikethrough, 9, "m")
 
   @doc "Crossed-out. Characters legible, but marked for deletion. Not widely supported."
-  @doc deprecated: "Use strikethrough/0 instead."
+  @doc deprecated: "Use strikethrough/0 instead"
   defsequence.(:crossed_out, 9, "m")
 
   @doc "Sets primary (default) font."
@@ -204,15 +204,15 @@ defmodule IO.ANSI do
   defsequence.(:italic_off, 23, "m")
 
   @doc "Not italic."
-  @doc deprecated: "Use italic_off/0 instead."
+  @doc deprecated: "Use italic_off/0 instead"
   defsequence.(:not_italic, 23, "m")
 
   @doc "Underline: off."
   @doc since: "1.21.0"
   defsequence.(:underline_off, 24, "m")
 
   @doc "Underline: none."
-  @doc deprecated: "Use underline_off/0 instead."
+  @doc deprecated: "Use underline_off/0 instead"
   defsequence.(:no_underline, 24, "m")
 
   @doc "Blink: off."
@@ -222,23 +222,23 @@ defmodule IO.ANSI do
   defsequence.(:inverse_off, 27, "m")
 
   @doc "Image: positive. Normal foreground and background."
-  @doc deprecated: "Use inverse_off/0 instead."
+  @doc deprecated: "Use inverse_off/0 instead"
   defsequence.(:reverse_off, 27, "m")
 
   @doc "Invisible: off."
   @doc since: "1.21.0"
   defsequence.(:invisible_off, 28, "m")
 
   @doc "Reveal: Not concealed."
-  @doc deprecated: "Use invisible_off/0 instead."
+  @doc deprecated: "Use invisible_off/0 instead"
   defsequence.(:reveal, 28, "m")
 
   @doc "Strikethrough: off."
   @doc since: "1.21.0"
   defsequence.(:strikethrough_off, 29, "m")
 
   @doc "Not crossed-out."
-  @doc deprecated: "Use strikethrough_off/0 instead."
+  @doc deprecated: "Use strikethrough_off/0 instead"
   defsequence.(:not_crossed_out, 29, "m")
 
   colors = [:black, :red, :green, :yellow, :blue, :magenta, :cyan, :white]
@@ -274,7 +274,7 @@ defmodule IO.ANSI do
   defsequence.(:overline, 53, "m")
 
   @doc "Overlined."
-  @doc deprecated: "Use overline/0 instead."
+  @doc deprecated: "Use overline/0 instead"
   defsequence.(:overlined, 53, "m")
 
   @doc "Not framed or encircled."
@@ -285,7 +285,7 @@ defmodule IO.ANSI do
   defsequence.(:overline_off, 55, "m")
 
   @doc "Not overlined."
-  @doc deprecated: "Use overline_off/0 instead."
+  @doc deprecated: "Use overline_off/0 instead"
   defsequence.(:not_overlined, 55, "m")
 
   @doc "Clears screen."
@@ -299,7 +299,7 @@ defmodule IO.ANSI do
   defsequence.(:cursor_home, "", "H")
 
   @doc "Sends cursor home."
-  @doc deprecated: "Use cursor_home/0 instead."
+  @doc deprecated: "Use cursor_home/0 instead"
   defsequence.(:home, "", "H")
 
   @doc """
@@ -326,7 +326,7 @@ defmodule IO.ANSI do
   defsequence.(:cursor_forward, "", "C")
 
   @doc "Sends cursor one column to the right."
-  @doc deprecated: "Use cursor_forward/0 instead."
+  @doc deprecated: "Use cursor_forward/0 instead"
   @spec cursor_right() :: String.t()
   def cursor_right(), do: "\e[1C"
 
@@ -339,7 +339,7 @@ defmodule IO.ANSI do
   defsequence.(:cursor_backward, "\b", nil)
 
   @doc "Sends cursor one column to the left."
-  @doc deprecated: "Use cursor_backward/0 instead."
+  @doc deprecated: "Use cursor_backward/0 instead"
   @spec cursor_left() :: String.t()
   def cursor_left(), do: "\e[1D"
 

lib/elixir/lib/kernel/parallel_compiler.ex

@@ -52,7 +52,7 @@ defmodule Kernel.ParallelCompiler do
   Starts a task for parallel compilation.
   """
   # TODO: Remove me on Elixir 2.0
-  @deprecated "Use `pmap/2` instead"
+  @deprecated "Use pmap/2 instead"
   def async(fun) when is_function(fun, 0) do
     {ref, task} = inner_async(fun)
     send(task.pid, ref)

lib/elixir/lib/uri.ex

@@ -40,7 +40,7 @@ defmodule URI do
 
   # We don't use opaque because URIs can be inlined,
   # either via module attributes or by the compiler.
-  @typedoc deprecated: "The authority field is deprecated"
+  @typedoc deprecated: "Use the userinfo, host, and port fields instead"
   @type authority :: nil | binary
 
   @type t :: %__MODULE__{