Include context in link parsing error messages
It’s quite hard to find which link you’ve typed as iface@
when actually it’s class@
and you’ve bulk-edited multiple files’ worth of doc comments. It would be useful if the link parsing error messages could include some more context about which link was invalid, and where that link is in which document.
For example, change the link parsing error messages from:
WARNING: Invalid fragment for 'GIRepository.ConstantInfo': it should be class
[alias@GIRepository.ConstantInfo]) or for a union discriminator (see
^~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
to something like:
WARNING: In documentation for GIRepository.TypeInfo:
Invalid fragment for 'GIRepository.ConstantInfo': it should be class
[alias@GIRepository.ConstantInfo]) or for a union discriminator (see
^~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
(This was MR !202 (closed), but I couldn’t find the right approach to implement it well, so I’m filing an issue to track it instead. Sorry.)