   end
 
   @doc ~S"""
-  Inspects the given atom.
-
-  The atom can be inspected as a literal (`:literal`),
-  as a key (`:key`), or as the function name in a remote call
+  Inspects `atom` according to different source formats.
+
+  The atom can be inspected according to the three different
+  formats it appears in source code: as a literal (`:literal`),
+  as a key (`:key`), or as the function name of a remote call
   (`:remote_call`).
 
   ## Examples
 
   ### As a literal
+
+  Literals include regular atoms, quoted atoms, operators,
+  aliases, and the special `nil`, `true`, and `false` atoms.
 
       iex> Macro.inspect_atom(:literal, nil)
       "nil"

      ":<>"
      iex> Macro.inspect_atom(:literal, :Foo)
      ":Foo"
      iex> Macro.inspect_atom(:literal, :"with spaces")
      ":\"with spaces\""

  ### As a key

      iex> Macro.inspect_atom(:key, :foo)
      "foo:"


  ### As a remote call

  Inspect an atom the function name of a remote call.

      iex> Macro.inspect_atom(:remote_call, :foo)
      "foo"
      iex> Macro.inspect_atom(:remote_call, :<>)
