Manual - technical issues

Dirk Hohndel dirk at
Fri Dec 6 10:34:42 UTC 2013

On Fri, 2013-12-06 at 20:01 +0200, Willem Ferguson wrote:
> When the user manual is activated the manual opens in a browser. But 
> this is a bare-frame browser with no controls. If one opens a URL inside 
> the manual, the new page does not open in a separate window, but within 
> the same browser window. After looking at the link referred to by the 
> URL, there is no way to get back to the manual because there are no 
> controls to navigate back. 

I believe this is fixed in master. Have you tried against the latest

commit 09a8a85bab620dd119a601e9cadbd0333385acbc
Author: Sergey Starosek <sergey.starosek at>
Date:   Thu Dec 5 14:02:25 2013 +0200

    Open external links in default browser

Should make us do the right thing.

Umm - latest doesn't find the manual. Carp.

> This is primarily a deficiency of asciidoc. 
> There are workarounds. The obvious one is to add "target="_blank" by 
> hand to the URLs in the HTML output from asciidoc and then everything is 
> ok. But this prevents automated build of the manual. In order to 
> maintain automated build, it may be necessary to write a short program 
> to insert the correct attribute.
> My question is: Are there any settings of the browser that can be 
> changed that can force the opening of a new browser window for URLs 
> within the manual?

Look at the commit above, please


More information about the subsurface mailing list