   def binary_to_list(binary, start, stop)
 
   @doc """
-  Returns an Erlang term which is the result of decoding the binary object `binary`,
-  which must be encoded according to the Erlang external term format.
+  Returns an Erlang term which is the result of decoding the binary
+  object `binary`, which must be encoded according to the Erlang external
+  term format.
+
+  ## Examples
+
+      binary_to_term(term_to_binary("foo")) #=> true
+
   """
   def binary_to_term(binary)
 
   @doc """
-  As `binary_to_term/1`, but takes `options` that affect decoding of the binary.
-
-  * `safe` - Use this option when receiving binaries from an untrusted source.
-
-  When enabled, it prevents decoding data that may be used to attack the Erlang system.
-  In the event of receiving unsafe data, decoding fails with a badarg error.
-
-  Currently, this prevents creation of new atoms directly, creation of new atoms
-  indirectly (as they are embedded in certain structures like pids, refs, funs, etc.),
-  and creation of new external function references. None of those resources are currently
-  garbage collected, so unchecked creation of them can exhaust available memory.
+  As `binary_to_term/1`, but accepts a safe option useful when receiving
+  binaries from an untrusted source.
+
+  When enabled, it prevents decoding data that may be used to attack the
+  Erlang system. In the event of receiving unsafe data, decoding fails
+  with a badarg error.
+
+  Currently, this prevents creation of new atoms directly, creation of
+  new atoms indirectly (as they are embedded in certain structures like pids,
+  refs, funs, etc), and creation of new external function references. None
+  of those resources are currently garbage collected, so unchecked creation
+  of them can exhaust available memory.
+
+  ## Examples
+
+      binary_to_term(term_to_binary("foo"), [:safe])
+
   """
   def binary_to_term(binary, options)
 


  ## Examples

      byte_size(<<433:16,3:3>>) #=> 3
      byte_size(<<1,2,3>>) #=> 3
  """
  def byte_size(bitstring)



  ## Examples

      binary_to_atom("elixir", :utf8) #=> :elixir

  """
  def binary_to_atom(binary, encoding)

