RISC OS User Information
This page is for issues specific to the RISC OS version of NetSurf. See the general user information page for more information about NetSurf.
Last updated 05 November 2014
Getting started
Installation
NetSurf requires RISC OS 4.02 or later and builds are available from the project's web site.
Installation of "NetSurf" is a three step process:
- Use the Boot Merge facility provided by Configure to merge the supplied !Boot directory with the one on your system.
If there is no !Boot merge facility on your system, simply drag the supplied !Boot over your existing boot structure. - Use the System Merge facility provided by Configure to merge the supplied !System directory with the one on your system.
- Drag the !NetSurf application directory out of the archive, to your desired location.
Double click on !NetSurf in your chosen location to launch NetSurf.
Note: if you are unsure how to follow steps 1 and 2 above, then please see our pictorial guide to resource installation.
Requirements
When NetSurf is run it will look for all the resources it needs to function correctly. If anything is not found, it displays an error message indicating the resource it could not locate on your system. If such a message appears, NetSurf is likely to be requesting one of the following resources.
Items contained in the !Boot and !System directories supplied with NetSurf:
- Acorn URI
- The Acorn URI module is used to pass URIs (of which URLs are an example) back and forth between different applications.
- Iconv
- This module provides improved character encoding support.
- SharedUnixLibrary
- This is a support module for programs compiled using UnixLib.
- Tinct
- Tinct is used for image plotting. It provides support for plotting sprites with alpha channels.
If NetSurf starts without a problem, there is no need to upgrade any resources on your system.
Additional Resources
The following resources are not required to run NetSurf, although they do add additional functionality.
- MimeMap Datafile
- A resource containing many different MIME types and their equivalent RISC OS file types.
Upgrading NetSurf
If you are upgrading from a previous version of NetSurf, quit NetSurf and delete your old version. Drag the !NetSurf application to your required destination. NetSurf stores your choices, cookies, hotlist and themes in Choices:WWW.NetSurf, so the !NetSurf application directory can be deleted without any loss of your NetSurf configuration.
It is possible to copy the new version of NetSurf over your old version to perform the upgrade. Please be aware that this could result in files that are no longer required being left in your copy of NetSurf although this should not cause any problems in usage.
Fonts in NetSurf
NetSurf has support for displaying pages containing Unicode characters that aren't normally available on RISC OS, for example accented Latin letters, Greek, Cyrillic, Japanese, and various symbols.
The font choices let you pick a font for each of the five standard families available to web authors (in CSS). The choices specify the preferred font to use. If a character is not available in the chosen font, but it's present in some other font that you have installed, then NetSurf will automatically use it. There's no need to change the font choices to view pages with characters that are not available in the chosen font.
Note that you can only choose a font family. NetSurf will automatically use weights from the family for bold and slanted text, if available.
Installing More Fonts
The fonts that come with RISC OS cover Latin (Homerton, Trinity, Corpus), Greek (Sidney), and various symbols (Selwyn, Sidney). (On RISC OS 3-4, only the "Latin 1" characters from the standard fonts, which cover Western European languages, can be used by NetSurf).
If you want to display pages with other characters correctly, you'll need to install fonts containing them. When a character is not present in any available font, the Unicode character code will be displayed.
If you see the codes 0091, 0092, 0096, or others starting 009, that indicates that the page is not specifying the character set that it is using correctly. Installing fonts won't help. We haven't yet decided what the best way to work around this problem is.
Any font supplied with a correctly designed "Encoding" file should work. In practice, native fonts covering anything other than Latin 1 are rare. The solution is to convert TrueType fonts using TTF2f (this currently produces fonts suitable for RISC OS 5 only).
After installing new fonts, NetSurf will need restarting so that it detects them.
Problems and Unimplemented Features
- Substituted characters are taken from the first font that contains them, even if a character which matches the weight or slant better is available.
- Unicode line breaking is not implemented.
- Right-to-left text (Hebrew, Arabic) is not implemented.
Disc Cache
NetSurf has the option of using a disc cache. This stores content from the web locally on your system, allowing faster access to that content next time you require it. On many RISC OS systems disc access is very slow. In such cases it may not make sense to use the disc cache. To disable it, open NetSurf's Choices from the iconbar menu, and in the Cache section, set the disc cache "size" to "0".
Printing
When NetSurf is run without the Unicode Font Manager, printing will work correctly. When printing with the Unicode Font Manager, as on RISC OS 5 or with a softloaded Unicode Font Manager, there are a few things you may need to install.
- Using the standard RISC OS 5 release of the printer drivers doesn't work due to lack of Unicode support in the RISC OS 5 printer drivers. However, a version of "Printers" that supports printing to non-PostScript printers is available from RISC OS Open Ltd.
- Printing to PostScript printers with Unicode support is not possible with the standard PostScript drivers. In order to print correctly, the more advanced PostScript 3 printer driver by John Tytgat and Martin Würthner is required.
- If you use Geminus, you'll need to run at least version 1.34.