   end
 
   @doc """
-  Handles the sigil ~r. It returns a Regex pattern.
+  Handles the sigil `~r`.
+
+  It returns a regular expression pattern, unescaping characters and replacing
+  interpolations.
+
+  More information on regexes can be found in the `Regex` module.
 
   ## Examples
 
       iex> Regex.match?(~r(foo), "foo")
+      true
+
+      iex> Regex.match?(~r/a#{:b}c/, "abc")
       true
 
   """

  end

  @doc ~S"""
  Handles the sigil ~R. It returns a Regex pattern without escaping
  nor interpreting interpolations.

  ## Examples


  ## Sigils

  @doc ~S"""
  Handles the sigil `~S`.

  It simply returns a string without escaping characters and without
  interpolations.

  ## Examples

