InteractiveUtils: Support callable objects as functions in introspection macros (JuliaLang#58905)

Follow-up to the follow-up
JuliaLang#57911, building on the changes
to introspection functions to support signature tuples being provided as
a single argument.

This enables support for calls of the form
```julia
@code_typed (::Returns{Int})(1)
@code_llvm (::Base.Fix2{typeof(+), Float64})(::Int)
```
by providing an extra `use_signature_tuple::Bool = false` parameter in
`gen_call_with_extracted_types`. Setting this parameter to true changes
the code generation from `$fcn(f, Tuple{argtypes...})` to `$fcn(Tuple{f,
argtypes...})` (where `$fcn` can be e.g. `code_typed`, `code_llvm` etc).

Author: serenity4

doc/src/base/reflection.md

@@ -85,9 +85,9 @@ the unquoted and interpolated expression ([`Expr`](@ref)) form for a given macro
 `quote` the expression block itself (otherwise, the macro will be evaluated and the result will
 be passed instead!). For example:
 
-```jldoctest; setup = :(using InteractiveUtils)
-julia> InteractiveUtils.macroexpand(@__MODULE__, :(@edit println("")) )
-:(InteractiveUtils.edit(println, InteractiveUtils.Tuple{(InteractiveUtils.Core).Typeof("")}))
+```jldoctest
+julia> macroexpand(@__MODULE__, :(@invoke identity(1::Int)))
+:(Core.invoke(identity, Base.Tuple{Int}, 1))
 ```
 
 The functions `Base.Meta.show_sexpr` and [`dump`](@ref) are used to display S-expr style views