[PATCH] Repair broken links on user manual

Willem Ferguson willemferguson at zoology.up.ac.za
Fri Jan 30 12:02:11 PST 2015


On 30/01/2015 20:30, Miika Turkia wrote:
> On Fri, Jan 30, 2015 at 8:26 PM, Willem Ferguson 
> <willemferguson at zoology.up.ac.za 
> <mailto:willemferguson at zoology.up.ac.za>> wrote:
>
>     On 30/01/2015 19:02, Miika Turkia wrote:
>>     There are a couple of broken links / references on our user
>>     manual. I looked at the first one but couldn't figure out where
>>     it should be pointing to..so I am now trying to delegate the
>>     fixing of them to Willem :D
>>
>>     Following x-refs are used but the destination is missing:
>>
>>     S_ExtraTab
>>     S_InfoBox
>>     S_ImportingManualCSV
>>
>>     miika
>>
>>
>>     _______________________________________________
>>     subsurface mailing list
>>     subsurface at subsurface-divelog.org  <mailto:subsurface at subsurface-divelog.org>
>>     http://lists.subsurface-divelog.org/cgi-bin/mailman/listinfo/subsurface
>
>     Easy because I understand the layout. Will respond, just waiting
>     for the latest release that applies current patches (ios
>     companion, dive planner) to the manual.
>
> One more broken link appeared after I pulled the latest sources (of 
> course this was still without the very latest patches)
>
> _appendix_b_dive_computer_specific_information_for_importing_dive_information
>
> BTW, if you run make on Documentation directory, and then the xmllint 
> command given in the error message, you get to see the broken links 
> yourself.
>
> miika

Miika, thank you so much for some more Miika magic! Hope this merges ok 
since I used the SHA of a patch that has not been pushed yet.

xmllint does not work on my machine: it is a known bug with asciidoc 
(actually a2x). When I run a2x I need a flag that switches xmllint off!!
Anyway, here is a patch that resolves these cases. I checked all of the 
changes that they link correctly in the HTML version. I have also 
checked all the xref: occurrences in the manual and they all appear to 
be ok. Thank you again.
Kind regards,
willem



-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.subsurface-divelog.org/pipermail/subsurface/attachments/20150130/c3f2ca07/attachment.html>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: 0001-User-manual-Unresolved-references.patch
Type: text/x-diff
Size: 4371 bytes
Desc: not available
URL: <http://lists.subsurface-divelog.org/pipermail/subsurface/attachments/20150130/c3f2ca07/attachment.patch>


More information about the subsurface mailing list