   end
 
   @doc """
-  Takes the given keys from the dict.
+  Takes all entries corresponding to the given keys and returns them in a new
+  keyword list.
+
   Duplicated keys are preserved in the new keyword list.
 
   ## Examples


  @doc """
  Drops the given keys from the dict.
  Duplicated keys are preserved in the new keyword list.

  ## Examples

  end

  @doc """
  Takes all entries corresponding to the given keys and extracts them into a
  separate keyword list. Returns a tuple with the new list and the old list
  with removed keys.

  Keys for which there are no entires in the keyword list are ignored.

  Entries with duplicated keys end up in the same keyword list.

  ## Examples

