GNOME Bugzilla – Bug 646982
Fails to parse @link tag split over two lines
Last modified: 2018-01-09 13:09:38 UTC
When a comment is word-wrapped by the editor, the {@link test} construction may be broken across two lines. Valadoc fails to parse it in this case, giving an error. For example: /w2/v/cwrk/vala/uazu/con/Area.vala:52.56-52.57: error: expected <space>: <end-of-line> * When it changes from false to true, the {@link ^
Created attachment 366526 [details] [review] Allow @link tags to be split over multiple lines Patch adds support for multi-line links. It also had to touch the generic link tag rule, since that also imposed a SP-only requirement to separate the tag name and its body, and that's where the NL if any will be found. I guess this is more or less safe to commit, since currently it's pretty strict and hence most (all?) existing uses of tags would be generating errors if they were split along new lines anyway? This fixes all instances of the issue in Geary's codebase, which (along with Bug 736483) makes Geary's engine API docs build again. Yay! :)
commit a52b4ac85ba48bb334d68976b94448cc66ce6f83 Author: Michael James Gratton <mike@vee.net> Date: Tue Jan 9 12:36:43 2018 +1100 libvaladoc: Allow @link tags to be split over multiple lines