 
   @doc """
   Returns a new binary based on `subject` by replacing the parts
-  matching `pattern` for `replacement`. If `options` is specified
-  with `[global: true]`, then it will replace all matches, otherwise
-  it will replace just the first one.
-
-  For the replaced part must be used in `replacement`, then the
-  position or the positions where it is to be inserted must be specified by using
-  the option `insert_replaced`.
+  matching `pattern` for `replacement`. By default, it replaces
+  all entries, except if `global: false` is given as option.
+
+  If the replaced part must be used in `replacement`, then the
+  position or the positions where it is to be inserted must be
+  specified by using the option `insert_replaced`.
 
   ## Examples
 


  """
  @spec valid_codepoint?(codepoint) :: boolean
  def valid_codepoint?(cp), do: match?(<<_ :: utf8>>, cp)

  @doc """
  Returns unicode graphemes in the string

  end

  @doc """
  Returns all codepoints in the string.

  ## Examples

