   where each entry in the primary list represents a match and each
   entry in the secondary list represents the captured contents.
 
-  The captured contents defaults to `:all`, which includes the whole
-  regex match and each capture.
-
-  When the option `:capture` is set to `:groups`, it will capture all
-  the groups in the regex. The option `:return` can be set to `:index`
-  to get indexes back.
+  ## Options
+
+  * `:return` - Set to `:index` to return indexes. Defaults to `:binary`;
+  * `:capture` - What to capture in the result. Check the moduledoc for Regex
+                 to see the possible capture values;
 
   ## Examples
 

  * `newline` - not available, use `(*CR)` or `(*LF)` or `(*CRLF)` or `(*ANYCRLF)`
    or `(*ANY)` at the beginning of the regexp according to the re documentation

  """

  defrecordp :regex, Regex, [:re_pattern, :source, :options]

  Runs the regular expression against the given string until the first match.
  It returns a list with all captures or `nil` if no match occurred.

  ## Options

  * `:return` - Set to `:index` to return indexes. Defaults to `:binary`;
  * `:capture` - What to capture in the result. Check the moduledoc for Regex
                 to see the possible capture values;

  ## Examples

