give better file:lineno in the log

[simonbyrne]

Log now prints:

└ @ Documenter ~/src/ClimaCore.jl/docs/src/api.md:210

instead of

└ @ Documenter ~/src/Documenter/src/utilities/utilities.jl:44

which makes it easier to jump to in my editor (can ctrl-click to go there)

[fredrikekre]

The location should also be printed in the message itself already. Is the problem that we print a line range there and not just a single number?

[mortenpi]

I guess the question here is whether we actually want the location info from the logging macro to not match the actual macro invocation? Arguably, this might be confusing, especially if we happen to mess up the line numbers somehow (due to a bug or something). On the other hand, the links to Documenter source are pretty useless 90% of the time, and this feels like a UX improvement.

[mortenpi]

The location should also be printed in the message itself already. Is the problem that we print a line range there and not just a single number?

Since we do already print the location information for all (?) of these blocks, then maybe we should just disable the location information from the macro, if that's possible? Does _file = nothing, _line = nothing work?

[simonbyrne]

The location should also be printed in the message itself already. Is the problem that we print a line range there and not just a single number?

It doesn't print the full path, which means the ctrl-click in VSCode doesn't work. I don't know about the range? Ideally it would print the actual line, not just the block, but that seems like it would be more difficult.

I guess the question here is whether we actually want the location info from the logging macro to not match the actual macro invocation?

The problem is it points to the @docerror macro, which is not exactly helpful. A small improvement would be to instead pass the line where @docerror was invoked (using __source__).