summaryrefslogtreecommitdiff
path: root/documentation/info.en
blob: 1bd5376fe3cc91d8e76147cd51c3d6121946c118 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN"
        "http://www.w3.org/TR/html4/strict.dtd">
<html>
<head>
<title>NetSurf | User Information</title>
<link rel="stylesheet" type="text/css" href="/netsurf.css">
<link rel="icon" type="image/png" href="/webimages/favicon.png">
</head>

<body>
<p class="banner"><a href="/"><img src="/netsurf.png" alt="NetSurf"></a></p>

<div class="navigation">
<div class="navsection">
<ul>
<li><a href="/about/">About NetSurf</a></li>
<li><a href="/downloads/">Downloads</a></li>
<li><a href="/documentation/">Documentation</a>
<ul>
<li><a href="/documentation/info">User info</a></li>
<li><a href="/documentation/guide">User guide</a></li>
<li><a href="/documentation/progress">Project progress</a></li>
<li><a href="/documentation/develop">Developer info</a></li>
</ul>
</li>
<li><a href="/developers/">Development area</a></li>
<li><a href="/webmasters/">Webmaster area</a></li>
<li><a href="/contact/">Contact</a></li>
</ul>
</div>

<div class="navsection">
<ul class="languages">
<!--<li><a href="index.de">Deutsch</a></li>-->
<li>English</li>
<!--<li><a href="index.fr">Fran�ais</a></li>-->
<!--<li><a href="index.nl">Nederlands</a></li>-->
</ul>
</div>

<div class="navsection">
<ul class="sitelinks">
<li><a href="http://wiki.netsurf-browser.org/">Development wiki</a></li>
<li><a href="http://source.netsurf-browser.org/">SVN repository viewer</a></li>
</ul>
</div>

</div>

<div class="content">

<p class="breadcrumbs"><a href="/">Home</a> � <a href="/documentation/">Documentation</a> � User information</p>

<h1>User Information</h1>

<p>This page is is relevant to all users of NetSurf. RISC OS users can also check the <a href="roinfo">RISC OS user information</a> further information on the RISC OS version of NetSurf.</p>

<ul>
<li><a href="#GettingNetSurf">Getting NetSurf</a></li>
<li><a href="#Bugs">Reporting bugs</a></li>
<li><a href="#FeatureRequests">Feature requests</a></li>
<li><a href="#JavaScript">JavaScript</a></li>
</ul>

<p class="updated">Last updated 2 January 2008</p>

<h2 id="GettingNetSurf">Getting NetSurf</h2>

<p>There are two versions of NetSurf available:</p>

<dl>
<dt><a href="/downloads/">Stable releases</a><dt>
<dd>These are recommended for most users, particularly if this is your first experience of NetSurf.<dd>
<dt><a href="/downloads/riscos/testbuilds">Development builds</a><dt>
<dd>These are built automatically from the latest bleeding-edge source code and may be unstable. Development builds are currently available only for RISC OS users. Users of other platforms can <a href="/developers/">obtain the latest source code</a> and follow the simple compilation instructions.<dd>
</dl>

<p>Note that some features may be fully implemented on the RISC OS version and not started on the GTK version. This is indicated on the <a href="/documentation/progress">progress</a> page.</p>

<h3>Which version to choose</h3>

<p>If you are new to NetSurf (or don't want to run potentially unstable versions), the stable release series is the best option. Stable releases are made infrequently and comprise bug and security fixes to the previous stable release. Major stable releases introduce new features and form the base of the next stable release series.</p>

<p>If you want to keep up with the latest developments in NetSurf, then the development builds are for you. However, as these represent the current state of development, they may be unstable or introduce new bugs. They also have significantly less testing than releases from the stable series.</p>

<h2 id="Bugs">Reporting bugs</h2>
<p>The NetSurf developers are very much open to bug reports. Please follow these simple guidelines.</p>

<p>Before submitting a bug report, please:</p>

<ol>
<li>check that the bug exhibits itself in the latest version <a href="http://www.netsurf-browser.org/downloads/riscos/testbuilds">available for download</a> at the time.</li>
<li>try to find a reproducible way of triggering the bug.</li>
<li>check the <a href="progress">progress</a> page be sure that something has actually been implemented.</li>
</ol>

<p>When reporting bugs, please:</p>

<ol>
<li>state the version of NetSurf you are using.</li>
<li>say what hardware and operating system you are using.</li>
<li>say whether you can reproduce the problem or whether is was a one-off occurrence that you can't reproduce.</li>
<li>explain clearly and concisely the precise nature of the problem. (eg. does the computer hang, does NetSurf crash or report an error or is there a layout problem on a particular site? If it is a layout problem, please explain what is wrong.)</li>
<li>if a specific site is failing, give the full URL.</li>
<li>list the exact steps required to reproduce the bug.</li>
<li>if you can narrow a bug down to a minimal test-case, then that's great. Please provide it as it's likely to speed up a fix. (Don't worry if you can't.)</li>
</ol>

<p>Bug reports should be made on the <a href="http://sourceforge.net/tracker/?func=add&amp;group_id=51719&amp;atid=464312">bug tracker</a>. Follow the &quot;Submit New&quot; link and fill in the form. If you have no SourceForge user account, please include your email address so that the developers can contact you. Note that when uploading files to the bug tracker (e.g. Log files), you may need to compress the file before uploading. The limit is 256kB.</p>

<p>Following the above guidelines will save the developers' time and speed up NetSurf's development.</p>

<h2 id="FeatureRequests">Feature requests</h2>

<p>The NetSurf team welcome feature requests and innovative ideas for improving the browsing experience. Before making suggestions, please look at the <a href="progress">progress</a> page to check that the feature isn't already planned. Suggestions can be made on the <a href="http://sourceforge.net/tracker/?func=add&amp;group_id=51719&amp;atid=464315">feature request tracker</a>.</p>

<h2 id="JavaScript">JavaScript</h2>

<p>At present, NetSurf has no support for JavaScript. Without a JavaScript implementation, NetSurf is able to provide access to most of sites on the World Wide Web. Some sites, however, will not display correctly or be unworkable due to heavy reliance on this standard.</p>

<p>JavaScript is support is planned but we are currently a long way off supporting it. Many things need to be done before JavaScript can be considered, such as a DOM implementation. JavaScript support will require a huge amount of work to complete. If you are keen to help out please visit the <a href="/developers/">developer and contributor area</a>.</p>


<div class="footer">
<p>Copyright 2003 - 2009 The NetSurf Developers</p>
</div>

</div>


<form method="get" action="http://www.google.co.uk/search">
<div class="searchbox">
<input type="hidden" name="q" value="site:netsurf-browser.org">
<input type="text" name="q" maxlength="255"><br>
<input type="submit" value="Search" name="btnG">
</div>
</form>

</body>
</html>