Display number of line or any tip to find error more easily

[s-celles]

Hello,

When compiling doc I'm getting

julia --color=yes make.jl
Documenter: setting up build directory.
Documenter: expanding markdown templates.
Documenter: building cross-references.
 !! No doc found for reference '[`pipeline`](@ref)'. [src/index.md]
Documenter: running document checks.
 > checking for missing docstrings.
 > running doctests.
 > checking footnote links.
Documenter: populating indices.
Documenter: rendering document.
 !! Invalid local link: unresolved path
    '@ref' in index.md
Documenter: skipping docs deployment.
Documenter: You can set DOCUMENTER_DEBUG to "true" in Travis to see more information.

Documenter.jl/src/CrossReferences.jl

Line 161 in 8a56ec8

Utilities.warn(page.source, "No doc found for reference '[`$code`](@ref)'.")

Documenter.jl/src/Writers/HTMLWriter.jl

Line 1096 in 2a986d0

Utilities.warn("Invalid local link: unresolved path\n '$(link.url)' in $(navnode.page)")

It can be hard to find exactly where error is.
Maybe displaying number of line could help to find more easily where error is.

Kind regards

[mortenpi]

Dup of #248 and #78.

[Jollywatt]

I think this issue should be reopened. As of Documenter.jl v1.1.0, we still have to put up with these kinds of messages for failed @refs:

┌ Error: no doc found for reference '[`graded_prod`](@ref)' in src/reference.md.
└ @ Documenter ~/.julia/packages/Documenter/9kOxY/src/utilities/utilities.jl:44

It is hard to track down 1) where and 2) why this is failing. (In my case, graded_prod is a documented method — I still don't know what's wrong here!)