   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


  A keyword may have duplicated keys so it is not strictly
  a dictionary. However most of the functions in this module
  behaves exactly as a dictionary and mimic the API defined
  by the `Dict` behaviour.

  For example, `Keyword.get` will get the first entry matching
  the given key, regardless if duplicated entries exist.
  Similarly, `Keyword.put` and `Keyword.delete` ensure all
  duplicated entries for a given key are removed when invoked.
  A handful of functions exist to handle duplicated keys, in
  particular, `from_enum` allows creating a new keywords without
  removing duplicated keys, `get_values` returns all values for

      iex> Keyword.drop(d, [:b, :d])
      [a: 1, c: 3]

      iex> d = [a: 1, b: 2, b: 3, c: 3, d: 4, a: 5]
      iex> Keyword.drop(d, [:b, :d])
      [a: 1, c: 3, a: 5]

