summaryrefslogtreecommitdiff
path: root/documentation/guide.html
blob: 84d3d95f77c79910740aac8197c327f11e7d2cc8 (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
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838
839
840
841
842
843
844
845
846
847
848
849
850
851
852
853
854
855
856
857
858
859
860
861
862
863
864
865
866
867
868
869
870
871
872
873
874
875
876
877
878
879
880
881
882
883
884
885
886
887
888
889
890
891
892
893
894
895
896
897
898
899
900
901
902
903
904
905
906
907
908
909
910
911
912
913
914
915
916
917
918
919
920
921
922
923
924
925
926
927
928
929
930
931
932
933
934
935
936
937
938
939
940
941
942
943
944
945
946
947
948
949
950
951
952
953
954
955
956
957
958
959
960
961
962
963
964
965
966
967
968
969
970
971
972
973
974
975
976
977
978
979
980
981
982
983
984
985
986
987
988
989
990
991
992
993
994
995
996
997
998
999
1000
1001
1002
1003
1004
1005
1006
1007
1008
1009
1010
1011
1012
1013
1014
1015
1016
1017
1018
1019
1020
1021
1022
1023
1024
1025
1026
1027
1028
1029
1030
1031
1032
1033
1034
1035
1036
1037
1038
1039
1040
1041
1042
1043
1044
1045
1046
1047
1048
1049
1050
1051
1052
1053
1054
1055
1056
1057
1058
1059
1060
1061
1062
1063
1064
1065
1066
1067
1068
1069
1070
1071
1072
1073
1074
1075
1076
1077
1078
1079
1080
1081
1082
1083
1084
1085
1086
1087
1088
1089
1090
1091
1092
1093
1094
1095
1096
1097
1098
1099
1100
1101
1102
1103
1104
1105
1106
1107
1108
1109
1110
1111
1112
1113
1114
1115
1116
1117
1118
1119
1120
1121
1122
1123
1124
1125
1126
1127
1128
1129
1130
1131
1132
1133
1134
1135
1136
1137
1138
1139
1140
1141
1142
1143
1144
1145
1146
1147
1148
1149
1150
1151
1152
1153
1154
1155
1156
1157
1158
1159
1160
1161
1162
1163
1164
1165
1166
1167
1168
1169
1170
1171
1172
1173
1174
1175
1176
1177
1178
1179
1180
1181
1182
1183
1184
1185
1186
1187
1188
1189
1190
1191
1192
1193
1194
1195
1196
1197
1198
1199
1200
1201
1202
1203
1204
1205
1206
1207
1208
1209
1210
1211
1212
1213
1214
1215
1216
1217
1218
1219
1220
1221
1222
1223
1224
1225
1226
1227
1228
1229
1230
1231
1232
1233
1234
1235
1236
1237
1238
1239
1240
1241
1242
1243
1244
1245
1246
1247
1248
1249
1250
1251
1252
1253
1254
1255
1256
1257
1258
1259
1260
1261
1262
1263
1264
1265
1266
1267
1268
1269
1270
1271
1272
1273
1274
1275
1276
1277
1278
1279
1280
1281
1282
1283
1284
1285
1286
1287
1288
1289
1290
1291
1292
1293
1294
1295
1296
1297
1298
1299
1300
1301
1302
1303
1304
1305
1306
1307
1308
1309
1310
1311
1312
1313
1314
1315
1316
1317
1318
1319
1320
1321
1322
1323
1324
1325
1326
1327
1328
1329
1330
1331
1332
1333
1334
1335
1336
1337
1338
1339
1340
1341
1342
1343
1344
1345
1346
1347
1348
1349
1350
1351
1352
1353
1354
1355
1356
1357
1358
1359
1360
1361
1362
1363
1364
1365
1366
1367
1368
1369
1370
1371
1372
1373
1374
1375
1376
1377
1378
1379
1380
1381
1382
1383
1384
1385
1386
1387
1388
1389
1390
1391
1392
1393
1394
1395
1396
1397
1398
1399
1400
1401
1402
1403
1404
1405
1406
1407
1408
1409
1410
1411
1412
1413
1414
1415
1416
1417
1418
1419
1420
1421
1422
1423
1424
1425
1426
1427
1428
1429
1430
1431
1432
1433
1434
1435
1436
1437
1438
1439
1440
1441
1442
1443
1444
1445
1446
1447
1448
1449
1450
1451
1452
1453
1454
1455
1456
1457
1458
1459
1460
1461
1462
1463
1464
1465
1466
1467
1468
1469
1470
1471
1472
1473
1474
1475
1476
1477
1478
1479
1480
1481
1482
1483
1484
1485
1486
1487
1488
1489
1490
1491
1492
1493
1494
1495
1496
1497
1498
1499
1500
1501
1502
1503
1504
1505
1506
1507
1508
1509
1510
1511
1512
1513
1514
1515
1516
1517
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN"
        "http://www.w3.org/TR/html4/strict.dtd">
<html>
<head>
<title>NetSurf | User Guide</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="//wiki.netsurf-browser.org/">Development wiki</a></li>
<li><a href="//source.netsurf-browser.org/">Git repository viewer</a></li>
<li><a href="https://ci.netsurf-browser.org/">Continuous Integration</a></li>
<li><a href="https://bugs.netsurf-browser.org/">Bug report system</a></li>
<li><a href="https://ci.netsurf-browser.org/jenkins/view/Categorized/job/docs-netsurf/doxygen/">Code documentation</a></li>
</ul>
</div>

</div>

<div class="content">

<p class="breadcrumbs"><a href="/">Home</a><a href="/documentation/">Documentation</a> ╗ User Guide</p>

<p class="headnote">Note that this document was written for the RISC OS version of NetSurf.</p>

<h1>User Guide</h1>

<ul>
<li><a href="#UsingNetSurf">Using NetSurf</a></li>
<li><a href="#Help">Interactive help</a></li>
<li><a href="#BrowserWindow">Browser window</a>
<ul>
<li><a href="#BrowserWindowToolbar">Toolbar</a></li>
<li><a href="#BrowserWindowURLBar">URL bar</a></li>
<li><a href="#BrowserWindowStatusBar">Status bar</a></li>
<li><a href="#BrowserWindowContent">Content area</a></li>
<li><a href="#BrowserWindowMenus">Menus</a></li>
</ul></li>
<li><a href="#FileTypes">File types</a></li>
<li><a href="#DownloadWindow">Download window</a></li>
<li><a href="#History">History</a>
<ul>
<li><a href="#HistoryLocal">Local history window</a></li>
<li><a href="#HistoryGlobal">Global history window</a>
<ul>
<li><a href="#HistoryGlobalToolbar">Toolbar</a></li>
<li><a href="#HistoryGlobalMenus">Menus</a></li>
</ul></li>
</ul></li>
<li><a href="#Hotlist">Hotlist management window</a>
<ul>
<li><a href="#HotlistToolbar">Toolbar</a></li>
<li><a href="#HotlistMenus">Menus</a></li>
</ul></li>
<li><a href="#Configuration">Configuration</a>
<ul>
<li><a href="#ConfigurationGlobal">Global configuration</a></li>
<li><a href="#ConfigurationToolbar">Toolbar customisation</a></li>
</ul></li>
<li><a href="#Keys">Keyboard shortcuts</a></li>
</ul>

<p class="updated">Last updated 10 November 2007</p>

<h2 id="UsingNetSurf">Using NetSurf</h2>

<p>To run <em>NetSurf</em>, simply double click on the NetSurf application. This will cause the NetSurf icon to appear on the iconbar. Select clicking on this icon will open a <a href="#BrowserWindow">browser window</a>. Adjust clicking on NetSurf's iconbar icon opens the <a href="#Hotlist">hotlist management window</a>.</p>

<h3 id="IconbarMenu">Iconbar Menu</h3>

<p>The iconbar menu contains options which concern the application as a whole.</p>

<table class="menu">
<tr><th class="menutitle" colspan="2">NetSurf</th></tr>
<tr><td><a href="#IconbarMenuInfo">Info</a></td><td class="menuarrow">&gt;</td></tr>
<tr><td><a href="#IconbarMenuHelp">Help</a></td><td></td></tr>
<tr><td><a href="#IconbarMenuOpen">Open</a></td><td class="menuarrow">&gt;</td></tr>
<tr><td><a href="#IconbarMenuChoices">Choices</a></td><td></td></tr>
<tr><td><a href="#IconbarMenuQuit">Quit</a></td><td></td></tr>
</table>

<p class="menupath" id="IconbarMenuInfo">NetSurf &gt; Info</p>
<p class="menuitem">This option provides a little information about NetSurf. More information about the application can be found on the <a href="#BrowserWindowMenuHelpAbout">about page</a>.</p>

<p class="menupath" id="IconbarMenuHelp">NetSurf &gt; Help</p>
<p class="menuitem">This option opens the <a href="/documentation/">documentation contents page</a> in a new window.</p>

<p class="menupath" id="IconbarMenuOpen">NetSurf &gt; Open</p>
<p class="menuitem">This option allows various windows to be opened. The options available are:</p>

<table class="menu">
<tr><th class="menutitle" colspan="2">Open</th></tr>
<tr><td><a href="#IconbarMenuOpenURL">Open URL</a></td><td class="menuarrow">&gt;</td></tr>
<tr><td><a href="#IconbarMenuOpenHotlist">Show hotlist</a></td><td></td></tr>
<tr><td><a href="#IconbarMenuOpenHistory">Show global history</a></td><td></td></tr>
</table>

<p class="menupath" id="IconbarMenuOpenURL">NetSurf &gt; Open &gt; Open URL</p>
<p class="menuitem">This option opens a dialogue box, allowing an address (URL) to be entered and visited.</p>

<p class="menupath" id="IconbarMenuOpenHotlist">NetSurf &gt; Open &gt; Show hotlist</p>
<p class="menuitem">This option opens the <a href="#Hotlist">hotlist management window</a>.</p>

<p class="menupath" id="IconbarMenuOpenHistory">NetSurf &gt; Open &gt; Show global history</p>
<p class="menuitem">This option opens the <a href="#HistoryGlobal">global history window</a>.</p>

<p class="menupath" id="IconbarMenuChoices">NetSurf &gt; Choices</p>
<p class="menuitem">This option opens NetSurf's <a href="#Configuration">configuration</a> window.</p>

<p class="menupath" id="IconbarMenuQuit">NetSurf &gt; Quit</p>
<p class="menuitem">This option will exit the program and close all browser windows. NetSurf will prompt for confirmation if there are any active or unsaved downloads. NetSurf provides no facility for continuing unfinished or aborted downloads. When NetSurf is quitted the <a href="#HistoryGlobal">global history</a> and <a href="#BrowserWindowURLCompletion">URL complete</a> records are saved.</p>

<h2 id="Help">Interactive Help</h2>

<p>Instant on-line help is available throughout the software, in the form of interactive help. This offers quick help information, in bullet point format, about the item under the pointer.</p>

<p>To use interactive help, suitable software must be running. The program 'Help' is shipped with all RISC OS computers and it can be run from NetSurf's <a href="#BrowserWindowMenuHelpInteractive">Help &gt; Interactive help</a> menu item.</p>

<h2 id="BrowserWindow">Browser Window</h2>

<p>The browser window is used to fetch and display web pages and other content available on the World Wide Web. It can also display files that are stored locally on your computer. The <a href="#FileTypes">file types</a> that NetSurf can handle include HTML, CSS and various image formats.</p>

<p class="guidescreenshot"><img src="images/bwin.png" title="Browser Window" alt=""></p>

<p>The area at the top of the browser window is called the <a href="#BrowserWindowToolbar">toolbar</a>. At the bottom, it can be seen that the horizontal scroll bar does not cover the full width of the window. Next to the horizontal scroll bar, is the <a href="#BrowserWindowStatusBar">status bar</a>. The main section in the middle of the window is the most important part, the content area.</p>

<p>The <a href="#BrowserWindowContent">content area</a> displays web pages and other material, such as images. Web pages contain hyperlinks (often just called 'links') which can point to another part of the page, to a different page or to any other type of file. Links pointing to types of files that NetSurf doesn't recognise will open a <a href="#DownloadWindow">download window</a>. Placing the pointer over a link changes the pointer to a 'clicking hand', to indicate that the item can be clicked on.</p>

<h3 id="BrowserWindowToolbar">Toolbar</h3>

<p>The section at the top of the window is called the toolbar. It allows quick access to various commonly used features. Many more functions are available through the <a href="#BrowserWindowMenus">menus</a>. The toolbar can be customised to contain only the icons you want, in the order you want, in toolbar edit mode. This is covered in the <a href="#ConfigurationToolbar">toolbar customisation</a> section. Available icons are listed below.</p>

<p></p>

<h3>Toolbar Icons</h3>

<p class="guideiconinfo"><strong><img src="images/back.png" alt="Back" title="Back Button" class="guideicon"></strong> Clicking on this button makes NetSurf go back to the previous page in the local history list. Select click to view the previous page in the current window. Adjust click to view it in a new window. Form information is not resubmitted.</p>

<p class="guideiconinfo"><strong><img src="images/forward.png" class="guideicon" alt="Forward" title="Forward Button"></strong> Clicking on this button allows you to advance through the local history list. Select click to view the next page in the current window. Adjust click to view it in a new window. Form information is not resubmitted.</p>

<p class="guideiconinfo"><strong><img src="images/history.png" class="guideicon" alt="History" title="History Button"></strong> Select clicking on this button opens a window containing the local history tree. Adjust clicking opens the global history window. More detailed information can be found in the <a href="#History">History</a> section.</p>

<p class="guideiconinfo"><strong><img src="images/home.png" class="guideicon" alt="Home" title="Home Button"></strong> Clicking on this button returns to the configured home page.</p>

<p class="guideiconinfo"><strong><img src="images/hotlist.png" class="guideicon" alt="Hotlist" title="Hotlist Button"></strong> Select clicking on this button opens the hotlist management window. Adjust clicking adds the current location to the hotlist.</p>

<p class="guideiconinfo"><strong><img src="images/print.png" class="guideicon" alt="Print" title="Print Button"></strong> Clicking on this button will open the print dialogue box.</p>

<p class="guideiconinfo"><strong><img src="images/reload.png" class="guideicon" alt="reload" title="Reload Button"></strong> Select clicking on this button will make NetSurf fetch and redraw the current page again. Adjust clicking forces NetSurf to fetch the current page as well as any objects it contains, such as images and style sheets.</p>

<p class="guideiconinfo"><strong><img src="images/save.png" class="guideicon" alt="Save" title="Save Button"></strong> Clicking on this button will open a save dialogue box, to allow you to save the page for future reference.</p>

<p class="guideiconinfo"><strong><img src="images/scale.png" class="guideicon" alt="Scale" title="Scale Button"></strong> Clicking on this button will open the scale view window. It allows you to scale documents, affecting both text and pictures.</p>

<p class="guideiconinfo"><strong><img src="images/search.png" class="guideicon" alt="Search" title="Search Button"></strong> Clicking on this button opens the find text window. It allows you to search for a string of text within a document.</p>

<p class="guideiconinfo"><strong><img src="images/stop.png" class="guideicon" alt="Stop" title="Stop Button"></strong> Clicking on this button stops whatever process the window is doing.</p>

<p class="guideiconinfo"><strong><img src="images/up.png" class="guideicon" alt="Up" title="Up Button"></strong> Clicking on this button moves up the directory tree. For example, if you are looking at <em>http://www.domain.com/directory/page.html</em>, clicking on the up icon takes you to <em>http://www.domain.com/directory/</em> and a further click would result in a location of <em>http://www.domain.com/</em>.</p>

<p>Icons that are greyed out indicate that their function is unavailable. This happens when a new browser window is first opened. Since the window will be displaying its first page, there would be no previous page and the back button is greyed out. Also, as this is the first page, the forward button is also greyed out.</p>

<p><strong>Throbber:</strong> This NetSurf logo animates while a page is downloading or rendering. It indicates that NetSurf is doing something.</p>

<h3 id="BrowserWindowURLBar">URL Bar</h3>

<p>The white writable icon on the toolbar is called the URL Bar and it shows the location of the current page. Here, you can enter the address of the page you want to view next. Text files dropped onto the URL bar are treated as URLs.</p>

<p>Next to the URL bar is a pop-up menu button which opens a list of URLs previously typed into the URL bar. Clicking on one of the URLs opens the page.</p>

<p>The current URL can be dragged from the URL bar to be saved or dropped onto other applications. A <span class="action">Ctrl drag</span> saves the URL in Text format and a <span class="action">Shift drag</span> saves it in ANT URL format. Systems that don't support text selection in writable icons (i.e. non RISC OS Select systems) allow the URL to be dragged out in Text format without the use of either <span class="action">Ctrl</span> or <span class="action">Shift</span>.</p>

<h4 id="BrowserWindowURLCompletion">URL Completion</h4>

<p>When typing into the URL bar, NetSurf opens a window below displaying suggestions for the full address. If the address you want is not shown, the box can be ignored. If the intended address is shown, select clicking on it will complete the address and open the page automatically. An adjust click on a URL copies it into the URL but does not load the page. The Up and Down cursor keys can be used to select an address from the list and the Return key opens the page. Escape closes the URL completion window. The function of other keys in the URL bar, such as the Left and Right cursor keys, is unaffected by this feature.</p>

<h3 id="BrowserWindowStatusBar">Status Bar</h3>

<p>The status bar, at the bottom of the window, displays information to the user. When you move the pointer over a link, the status bar will display the URL that the link points to. The status bar also displays information about NetSurf's progress while retrieving a page.</p>

<p>Between the status bar and the horizontal scroll bar is the status bar resizer. Over this widget, the pointer changes to a double headed arrow and you can drag the status bar resizer to set the width of the status bar.</p>

<h3 id="BrowserWindowContent">Content Area</h3>

<p>The content area is the main part of the browser window; it displays documents and images. Various types of action can be performed in the content area, including:</p>

<ul>
<li><a href="#BrowserWindowContentTextSelection">Text selection</a></li>
<li><a href="#BrowserWindowContentDragScrolling">Drag scrolling</a></li>
<li><a href="#BrowserWindowContentLinkHandling">Link handling</a></li>
<li><a href="#BrowserWindowContentDragSaving">Drag saving</a></li>
<li><a href="#BrowserWindowContentFormCompletion">Form completion</a></li>
</ul>

<p>Some operations, such as a dragging and clicking will behave differently depending on the content over which the action is carried out. For example, dragging over text initiates text selection whereas dragging over non-textual content will drag-scroll the page.</p>

<p>Further options are available through the <a href="#BrowserWindowMenus">menu</a>, some of which are only available when menu is clicked over certain types of content. For example the <a href="#BrowserWindowMenuObject">Object</a> submenu is available only when menu is clicked over an object, such as an image.</p>

<h4 id="BrowserWindowContentTextSelection">Text Selection</h4>

<p>Textual content on pages can be selected and copied. Text in <a href="#BrowserWindowContentFormCompletionTextArea">text areas</a> can be selected and then cut or copied to the global clipboard. The global clipboard contents can also be pasted into text areas.</p>

<ul>
<li><span class="action">Select click</span> clears previous selections.</li>
<li><span class="action">Select drag</span> over text clears previous selection and creates new selection.</li>
<li><span class="action">Adjust click</span> adds to selection. If Adjust was clicked outside the selection the nearest end of the selection is moved to where adjust was clicked. If Adjust was clicked inside the current selection, the second (last) end of the selection is moved to where Adjust was clicked. If Adjust is clicked on a link, the selection is not modified and <a href="#BrowserWindowContentLinkHandling">link handling</a> behaviour is followed.</li>
<li><span class="action">Adjust drag</span> over text dynamically does the same as repeatedly doing an <span class="action">Adjust click</span> as you move the mouse, except, <span class="action">Adjust drag</span> over links modifies the selection and does not follow the link.</li>
</ul>

<p><span class="action">Ctrl+C</span> copies selected text to the global clipboard. <span class="action">Ctrl+A</span> selects all text, while <span class="action">Ctrl+Z</span> clears the selection.</p>

<h4 id="BrowserWindowContentDragScrolling">Drag Scrolling</h4>

<p>The page can be scrolled by dragging non-textual areas up and down. During a drag scroll action, the pointer changes to a hand.</p>

<ul>
<li><span class="action">Select drag</span> on any non textual area of the page (except plugin areas and <code>overflow: scroll</code> scrollbars) drags the page.</li>
<li><span class="action">Adjust drag</span> on any part of the page, including text, provided there is no selection drags the page. Page drag scrolling is not possible over plugin areas or scrollbars, such as those for <a href="#BrowserWindowContentFormCompletionTextArea">text areas</a> or <code>overflow: scroll</code>.</li>
</ul>

<h4 id="BrowserWindowContentLinkHandling">Link Handling</h4>

<!-- <p>Links are not followed until <span class="action">click release</span>, so link actions can be avoided if a drag operation is started. This allows initiation of <a href="#BrowserWindowContentTextSelection">text selection</a> in link text and <a href="#BrowserWindowContentDragScrolling">page drag scrolling</a> from link images.</p> -->

<ul>
<li><span class="action">Select click</span> on a link follows the link in current window.</li>
<li><span class="action">Adjust click</span> on a link opens the link in new window.</li>
<li><span class="action">Shift+Select click</span> on a link opens a <a href="#DownloadWindow">download dialogue box</a> for the link target.</li>
<li><span class="action">Shift+Adjust click</span> on a link opens a save box for saving link the target address as a URL file.</li>
<!--<li><span class="action">Shift+Select drag</span> from a link to a filer window or another application opens a <a href="#DownloadWindow">download dialogue box</a> with the local destination automatically set.</li>
<li><span class="action">Shift+Adjust drag</span> from a link to a filer window or another app saves the link target address as a URL file.</li> -->
</ul>

<h4 id="BrowserWindowContentDragSaving">Drag Saving</h4>

<p>Content can be dragged directly from the page to a filer window with the <span class="action">Ctrl</span> key.</p>

<ul>
<li><span class="action">Ctrl+Select drag</span> saves the item under the pointer to a filer window or another application. The item is saved in its original format.</li>
<li><span class="action">Ctrl+Adjust drag</span> saves the item under the pointer to a filer window or another application. Generally it saves it in the most applicable RISC OS format.</li>
</ul>

<p>Different items are treated as follows.</p>

<ul>
<li>If the content drag save is initiated on a <em>bitmap image</em>, it is saved in its original format with <span class="action">Select</span>. With <span class="action">Adjust</span> it is saved as a sprite.</li>
<!-- <li>If the content drag save is initiated on a <em>vector image</em>, it is saved in its original format with <span class="action">Select</span>. With <span class="action">Adjust</span> it is saved as a drawfile if possible, otherwise in the original format.</li> -->
<li>If the content drag save is initiated on a <a href="#BrowserWindowContentTextSelection">text selection</a>, it is saved as text, whether it comes from an HTML page, CSS file or whatever. <span class="action">Select</span> / <span class="action">Adjust</span> usage makes no difference.</li>
<li>If the content drag save is initiated on a part of a <em>web page</em> that is neither image or selection, the page is saved as a &quot;full save&quot; with <span class="action">Select</span>. With <span class="action">Adjust</span>, the HTML is saved only.</li>
<!-- <li>If the content drag save is initiated on a displayed <em><code>text/css</code></em> document, it is saved as CSS with <span class="action">Select</span>. With <span class="action">Adjust</span> it is saved as text.</li> -->
<li><em><code>text/plain</code></em> is always saved as text.</li>
</ul>

<!-- <p>Content drag saving for links is covered in the <a href="#BrowserWindowContentLinkHandling">link handling</a> section.</p> -->

<h4 id="BrowserWindowContentFormCompletion">Form Completion</h4>

<p>Forms allow information to be entered and submitted to an agent such as a web server or mail server. Some form controls can be styled by web pages, so they may look quite different from one page to the next. Some common form controls are described below.</p>

<dl>
<dt id="BrowserWindowContentFormCompletionButtons">Buttons</dt>
<dd>Buttons trigger some action when selected. Common button actions are to <em>submit</em> or <em>reset</em> the form.</dd>

<dt id="BrowserWindowContentFormCompletionCheckboxes">Checkboxes</dt>
<dd>Checkboxes are on/off switches that can be toggled. Checkboxes containing a red square are &quot;on&quot;.</dd>

<dt id="BrowserWindowContentFormCompletionRadioButtons">Radio Buttons</dt>
<dd>Radio buttons are like checkboxes except that groups of radio buttons are mutually exclusive: when one is switched &quot;on&quot;, all others with the same name are switched &quot;off&quot;. Radio buttons containing a red circle are &quot;on&quot;.</dd>

<dt id="BrowserWindowContentFormCompletionSelectionMenus">Selection Menus</dt>
<dd>Selection menus open a menu, from which an item, or in some cases several items, can be selected. Selected items are displayed with a tick (&#10003;) next to them. The pointer changes to indicate a pop-up menu is available over selection menu controls.</dd>

<dt id="BrowserWindowContentFormCompletionTextInput">TextInput</dt>
<dd>A text input allows a single line of text to be entered and edited. Pressing <span class="action">Return</span> in a text input will submit the form.</dd>

<dt id="BrowserWindowContentFormCompletionFileInput">File Input</dt>
<dd>File inputs say &quot;Drop file here&quot; and allow local files to be submitted. Dragging a file to them sets the path to the file.</dd>

<dt id="BrowserWindowContentFormCompletionTextArea">Text Area</dt>
<dd>Text areas are similar to text inputs but they allow multiple lines to be edited. Pressing <span class="action">Return</span> in a text area moves the caret to the next line.</dd>
</dl>

<p><span class="action">Tab</span> can be used to move the caret to the next text input or text area control. <span class="action">Shift+Tab</span> moves input focus back to the previous text box.</p>

<h3 id="BrowserWindowMenus">Menus</h3>

<p>The browser window menu contains options relating to the content of the current window. Some of these options are unavailable at present as this area of NetSurf is not complete. The following options are available:</p>

<table class="menu">
<tr><th class="menutitle" colspan="2">NetSurf</th></tr>
<tr><td><a href="#BrowserWindowMenuPage">Page</a></td><td class="menuarrow">&gt;</td></tr>
<tr><td><a href="#BrowserWindowMenuObject">Object</a></td><td class="menuarrow">&gt;</td></tr>
<tr><td><a href="#BrowserWindowMenuSelection">Selection</a></td><td class="menuarrow">&gt;</td></tr>
<tr><td><a href="#BrowserWindowMenuNavigate">Navigate</a></td><td class="menuarrow">&gt;</td></tr>
<tr><td><a href="#BrowserWindowMenuDisplay">Display</a></td><td class="menuarrow">&gt;</td></tr>
<tr><td><a href="#BrowserWindowMenuUtilities">Utilities</a></td><td class="menuarrow">&gt;</td></tr>
<tr><td><a href="#BrowserWindowMenuHelp">Help</a></td><td class="menuarrow">&gt;</td></tr>
</table>

<h4 id="BrowserWindowMenuPage" class="submenu">Page Submenu</h4>

<p>The Page submenu contains the following options relevant to the current page.</p>

<table class="menu">
<tr><th class="menutitle" colspan="2">Page</th></tr>
<tr><td><a href="#BrowserWindowMenuPageInfo">Info</a></td><td class="menuarrow">&gt;</td></tr>
<tr><td><a href="#BrowserWindowMenuPageSave">Save</a></td><td class="menuarrow">&gt;</td></tr>
<tr><td><a href="#BrowserWindowMenuPageFullSave">Full save</a></td><td class="menuarrow">&gt;</td></tr>
<tr><td><a href="#BrowserWindowMenuPageExport">Export</a></td><td class="menuarrow">&gt;</td></tr>
<tr><td><a href="#BrowserWindowMenuPageSaveLocation">Save location</a></td><td class="menuarrow">&gt;</td></tr>
<tr><td><a href="#BrowserWindowMenuPagePrint">Print</a></td><td class="menuarrow">&gt;</td></tr>
<tr><td class="menusplit"><a href="#BrowserWindowMenuPageNewwindow">New window</a></td><td class="menusplit"></td></tr>
<tr><td><a href="#BrowserWindowMenuPageFindText">Find text</a></td><td class="menuarrow">&gt;</td></tr>
<tr><td><a href="#BrowserWindowMenuPageViewSource">View source</a></td><td class="menuarrow"></td></tr>
</table>

<p class="menupath" id="BrowserWindowMenuPageInfo">Page &gt; Info</p>
<p class="menuitem">This option displays information about the current page.</p>

<p class="menupath" id="BrowserWindowMenuPageSave">Page &gt; Save</p>
<p class="menuitem">This option opens a save dialogue box, allowing the source code of the current page to be saved to disc.</p>

<p class="menupath" id="BrowserWindowMenuPageFullSave">Page &gt; Full save</p>
<p class="menuitem">This option opens a save dialogue box, allowing current page to be saved to disc, including any CSS files or images etc that the page contains.</p>

<p class="menupath" id="BrowserWindowMenuPageExport">Page &gt; Export</p>
<p class="menuitem">This option offers various export options for the current page. The options available are:</p>

<table class="menu">
<tr><th class="menutitle" colspan="2">Export as</th></tr>
<tr><td><a href="#BrowserWindowMenuPageExportDraw">Draw</a></td><td class="menuarrow">&gt;</td></tr>
<tr><td><a href="#BrowserWindowMenuPageExportPDF">PDF</a></td><td class="menuarrow">&gt;</td></tr>
<tr><td><a href="#BrowserWindowMenuPageExportText">Text</a></td><td class="menuarrow">&gt;</td></tr>
</table>

<p class="menupath" id="BrowserWindowMenuPageExportDraw">Page &gt; Export &gt; Draw</p>
<p class="menuitem">This option opens a save dialogue box, allowing the current page to be saved as a drawfile.</p>

<p class="menupath" id="BrowserWindowMenuPageExportPDF">Page &gt; Export &gt; PDF</p>
<p class="menuitem">This option opens a save dialogue box, allowing the current page to be saved as a multi-page PDF document.</p>

<p class="menupath" id="BrowserWindowMenuPageExportText">Page &gt; Export &gt; Text</p>
<p class="menuitem">This option opens a save dialogue box, allowing the current page to be saved as a text file.</p>

<p class="menupath" id="BrowserWindowMenuPageSaveLocation">Page &gt; Save location</p>
<p class="menuitem">This option allows the address of the current page to be saved in various formats. The options available are:</p>

<table class="menu">
<tr><th class="menutitle" colspan="2">Link</th></tr>
<tr><td><a href="#BrowserWindowMenuPageSaveLocationAcorn">Acorn URI</a></td><td class="menuarrow">&gt;</td></tr>
<tr><td><a href="#BrowserWindowMenuPageSaveLocationAnt">Ant URL</a></td><td class="menuarrow">&gt;</td></tr>
<tr><td><a href="#BrowserWindowMenuPageSaveLocationText">Text</a></td><td class="menuarrow">&gt;</td></tr>
</table>

<p class="menupath" id="BrowserWindowMenuPageSaveLocationAcorn">Page &gt; Save location &gt; Acorn URI</p>
<p class="menuitem">This option opens a save dialogue box, allowing the address of the current page to be saved to disc in Acorn URI format.</p>

<p class="menupath" id="BrowserWindowMenuPageSaveLocationAnt">Page &gt; Save location &gt; Ant URL</p>
<p class="menuitem">This option opens a save dialogue box, allowing the address of the current page to be saved to disc in Ant URL format.</p>

<p class="menupath" id="BrowserWindowMenuPageSaveLocationText">Page &gt; Save location &gt; Text</p>
<p class="menuitem">This option opens a save dialogue box, allowing the address of the current page to be saved to disc in plain text format.</p>

<p class="menupath" id="BrowserWindowMenuPagePrint">Page &gt; Print</p>
<p class="menuitem">This option opens a print dialogue box.</p>

<p class="menupath" id="BrowserWindowMenuPageNewwindow">Page &gt; New window</p>
<p class="menuitem">This option opens the current page in a new window.</p>

<p class="menupath" id="BrowserWindowMenuPageFindText">Page &gt; Find text</p>
<p class="menuitem">This option allows you to search the current page for a text string. The same function is available on the <a href="#BrowserWindowToolbar">toolbar</a>.</p>

<p class="menupath" id="BrowserWindowMenuPageViewSource">Page &gt; View source</p>
<p class="menuitem">This option opens the source code of the current page in a text editor window.</p>

<h4 id="BrowserWindowMenuObject" class="submenu">Object Submenu</h4>

<p>The Object submenu contains the following options relevant to the current object. This submenu is only available when the pointer is placed over an object such as a link or an image.</p>

<table class="menu">
<tr><th class="menutitle" colspan="2">Object</th></tr>
<tr><td><a href="#BrowserWindowMenuObjectObject">Object</a></td><td class="menuarrow">&gt;</td></tr>
<tr><td><a href="#BrowserWindowMenuObjectLink">Link</a></td><td class="menuarrow">&gt;</td></tr>
</table>

<p class="menupath" id="BrowserWindowMenuObjectObject">Object &gt; Object</p>
<p class="menuitem">This submenu contains options relating to the current object &ndash; e.g. the image under the pointer where the menu was opened.</p>

<table class="menu">
<tr><th class="menutitle" colspan="2">Object</th></tr>
<tr><td><a href="#BrowserWindowMenuObjectObjectInfo">Info</a></td><td class="menuarrow">&gt;</td></tr>
<tr><td><a href="#BrowserWindowMenuObjectObjectSave">Save</a></td><td class="menuarrow">&gt;</td></tr>
<tr><td><a href="#BrowserWindowMenuObjectObjectExport">Export</a></td><td class="menuarrow">&gt;</td></tr>
<tr><td><a href="#BrowserWindowMenuObjectObjectSaveLocation">Save location</a></td><td class="menuarrow">&gt;</td></tr>
<tr><td><a href="#BrowserWindowMenuObjectObjectReload">Reload</a></td><td></td></tr>
</table>

<p class="menupath" id="BrowserWindowMenuObjectObjectInfo">Object &gt; Object &gt; Info</p>
<p class="menuitem">This option displays information about the current object.</p>

<p class="menupath" id="BrowserWindowMenuObjectObjectSave">Object &gt; Object &gt; Save</p>
<p class="menuitem">This option opens a save dialogue box, allowing the object under the pointer to be saved in its original format.</p>

<p class="menupath" id="BrowserWindowMenuObjectObjectExport">Object &gt; Object &gt; Export</p>
<p class="menuitem">This option offers various export options for the current object. The options available are:</p>

<table class="menu">
<tr><th class="menutitle" colspan="2">Export</th></tr>
<tr><td><a href="#BrowserWindowMenuObjectObjectExportSprite">Sprite</a></td><td class="menuarrow">&gt;</td></tr>
<tr><td><a href="#BrowserWindowMenuObjectObjectExportDraw">Draw</a></td><td class="menuarrow">&gt;</td></tr>
</table>

<p class="menupath" id="BrowserWindowMenuObjectObjectExportSprite">Object &gt; Object &gt; Export &gt; Sprite</p>
<p class="menuitem">This option opens a save dialogue box, allowing the current object to be saved as a sprite.</p>

<p class="menupath" id="BrowserWindowMenuObjectObjectExportDraw">Object &gt; Object &gt; Export &gt; Draw</p>
<p class="menuitem">This option opens a save dialogue box, allowing the current object to be saved as a drawfile. This option is only available for vector images, such as SVG.</p>

<p class="menupath" id="BrowserWindowMenuObjectObjectSaveLocation">Object &gt; Object &gt; Save location</p>
<p class="menuitem">This option allows the address of the current object to be saved in various formats. The options available are:</p>

<table class="menu">
<tr><th class="menutitle" colspan="2">Save location</th></tr>
<tr><td><a href="#BrowserWindowMenuObjectObjectSaveLocationAcorn">Acorn URI</a></td><td class="menuarrow">&gt;</td></tr>
<tr><td><a href="#BrowserWindowMenuObjectObjectSaveLocationAnt">Ant URL</a></td><td class="menuarrow">&gt;</td></tr>
<tr><td><a href="#BrowserWindowMenuObjectObjectSaveLocationText">Text</a></td><td class="menuarrow">&gt;</td></tr>
</table>

<p class="menupath" id="BrowserWindowMenuObjectObjectSaveLocationAcorn">Object &gt; Object &gt; Save location &gt; Acorn URI</p>
<p class="menuitem">This option opens a save dialogue box, allowing the address of the current object to be saved to disc in Acorn URI format.</p>

<p class="menupath" id="BrowserWindowMenuObjectObjectSaveLocationAnt">Object &gt; Object &gt; Save location &gt; Ant URL</p>
<p class="menuitem">This option opens a save dialogue box, allowing the address of the current object to be saved to disc in Ant URL format.</p>

<p class="menupath" id="BrowserWindowMenuObjectObjectSaveLocationText">Object &gt; Object &gt; Save location &gt; Text</p>
<p class="menuitem">This option opens a save dialogue box, allowing the address of the current object to be saved to disc in plain text format.</p>

<p class="menupath" id="BrowserWindowMenuObjectObjectReload">Object &gt; Object &gt; Reload</p>
<p class="menuitem">This option reloads the current page and any objects that the page contains.</p>

<p class="menupath" id="BrowserWindowMenuObjectLink">Object &gt; Link</p>
<p class="menuitem">This submenu contains options relating to the current link &ndash; i.e. the link under the pointer where the menu was opened.</p>

<table class="menu">
<tr><th class="menutitle" colspan="2">Link</th></tr>
<tr><td><a href="#BrowserWindowMenuObjectLinkSave">Save</a></td><td class="menuarrow">&gt;</td></tr>
<tr><td><a href="#BrowserWindowMenuObjectLinkDownloadtarget">Download target</a></td><td></td></tr>
<tr><td class="menusplit"><a href="#BrowserWindowMenuObjectLinkNewwindow">New window</a></td><td class="menusplit"></td></tr>
</table>

<p class="menupath" id="BrowserWindowMenuObjectLinkSave">Object &gt; Link &gt; Save</p>
<p class="menuitem">This option allows the address of the current link to be saved in various formats. The options available are:</p>

<table class="menu">
<tr><th class="menutitle" colspan="2">Save</th></tr>
<tr><td><a href="#BrowserWindowMenuObjectLinkSaveAcorn">Acorn URI</a></td><td class="menuarrow">&gt;</td></tr>
<tr><td><a href="#BrowserWindowMenuObjectLinkSaveAnt">Ant URL</a></td><td class="menuarrow">&gt;</td></tr>
<tr><td><a href="#BrowserWindowMenuObjectLinkSaveText">Text</a></td><td class="menuarrow">&gt;</td></tr>
</table>

<p class="menupath" id="BrowserWindowMenuObjectLinkSaveAcorn">Object &gt; Link &gt; Save &gt; Acorn URI</p>
<p class="menuitem">This option opens a save dialogue box, allowing the address of the current link to be saved to disc in Acorn URI format.</p>

<p class="menupath" id="BrowserWindowMenuObjectLinkSaveAnt">Object &gt; Link &gt; Save &gt; Ant URL</p>
<p class="menuitem">This option opens a save dialogue box, allowing the address of the current link to be saved to disc in Ant URL format.</p>

<p class="menupath" id="BrowserWindowMenuObjectLinkSaveText">Object &gt; Link &gt; Save &gt; Text</p>
<p class="menuitem">This option opens a save dialogue box, allowing the address of the current link to be saved to disc in plain text format.</p>

<p class="menupath" id="BrowserWindowMenuObjectLinkDownloadtarget">Object &gt; Link &gt; Download target</p>
<p class="menuitem">This option starts a download of the file pointed to by the current link. It is the same as <span class="action">shift + clicking</span> on the link.</p>

<p class="menupath" id="BrowserWindowMenuObjectLinkNewwindow">Object &gt; Link &gt; New window</p>
<p class="menuitem">This option opens the page pointed to by the current link in a new window. It is the same as following a link with <span class="action">adjust</span>.</p>

<h4 id="BrowserWindowMenuSelection" class="submenu">Selection Submenu</h4>

<p>The selection submenu contains the following options, for manipulating the current selection and performing clipboard actions.</p>

<table class="menu">
<tr><th class="menutitle" colspan="2">Selection</th></tr>
<tr><td><a href="#BrowserWindowMenuSelectionSave">Save</a></td><td class="menuarrow">&gt;</td></tr>
<tr><td class="menusplit"><a href="#BrowserWindowMenuSelectionCopytoclipboard">Copy to clipboard</a></td><td class="menusplit"></td></tr>
<tr><td><a href="#BrowserWindowMenuSelectionCuttoclipboard">Cut to clipboard</a></td><td class="menuarrow"></td></tr>
<tr><td><a href="#BrowserWindowMenuSelectionPastefromclipboard">Paste from clipboard</a></td><td></td></tr>
<tr><td class="menusplit"><a href="#BrowserWindowMenuSelectionClearselection">Clear selection</a></td><td class="menusplit"></td></tr>
<tr><td><a href="#BrowserWindowMenuSelectionSelectall">Select all</a></td><td class="menuarrow"></td></tr>
</table>

<p class="menupath" id="BrowserWindowMenuSelectionSave">Selection &gt; Save</p>
<p class="menuitem">This option opens a save dialogue box, allowing the current selection page to be saved to disc as a text file.</p>

<p class="menupath" id="BrowserWindowMenuSelectionCopytoclipboard">Selection &gt; Copy to clipboard</p>
<p class="menuitem">This option copies the current selection to the clipboard, allowing it to be pasted into other applications or elsewhere in NetSurf.</p>

<p class="menupath" id="BrowserWindowMenuSelectionCuttoclipboard">Selection &gt; Cut to clipboard</p>
<p class="menuitem">This option cuts the current selection to the clipboard. It is only available when the current selection is editable, such as selections within a form's text area.</p>

<p class="menupath" id="BrowserWindowMenuSelectionPastefromclipboard">Selection &gt; Paste from clipboard</p>
<p class="menuitem">This option pastes the current clipboard contents at the postman of the caret.</p>

<p class="menupath" id="BrowserWindowMenuSelectionClearselection">Selection &gt; Clear selection</p>
<p class="menuitem">This option deselects any selected text on the current page.</p>

<p class="menupath" id="BrowserWindowMenuSelectionSelectall">Selection &gt; Select all</p>
<p class="menuitem">This option selects all the text on the current page.</p>

<h4 id="BrowserWindowMenuNavigate" class="submenu">Navigate Submenu</h4>

<p>The Navigate submenu contains the following options, useful for navigating the web.</p>

<table class="menu">
<tr><th class="menutitle" colspan="2">Navigate</th></tr>
<tr><td><a href="#BrowserWindowMenuNavigateHome">Home page</a></td><td class="menuarrow"></td></tr>
<tr><td><a href="#BrowserWindowMenuNavigateBack">Back one page</a></td><td class="menuarrow"></td></tr>
<tr><td><a href="#BrowserWindowMenuNavigateForward">Forward one page</a></td><td class="menuarrow"></td></tr>
<tr><td><a href="#BrowserWindowMenuNavigateUponelevel">Up one level</a></td><td class="menuarrow"></td></tr>
<tr><td class="menusplit"><a href="#BrowserWindowMenuNavigateReload">Reload this page</a></td><td class="menusplit"></td></tr>
<tr><td><a href="#BrowserWindowMenuNavigateStop">Stop loading this page</a></td><td class="menuarrow"></td></tr>
</table>

<p class="menupath" id="BrowserWindowMenuNavigateHome">Navigate &gt; Home page</p>
<p class="menuitem">This option takes you back to the NetSurf home page. The same function is available on the <a href="#BrowserWindowToolbar">toolbar</a>.</p>

<p class="menupath" id="BrowserWindowMenuNavigateBack">Navigate &gt; Back one page</p>
<p class="menuitem">This option takes you back one page in the local history. Any form information will not be resubmitted. The same function is available on the <a href="#BrowserWindowToolbar">toolbar</a>.</p>

<p class="menupath" id="BrowserWindowMenuNavigateForward">Navigate &gt; Forward one page</p>
<p class="menuitem">This option takes you forward one page in the local history. Any form information will not be resubmitted. The same function is available on the <a href="#BrowserWindowToolbar">toolbar</a>.</p>

<p class="menupath" id="BrowserWindowMenuNavigateUponelevel">Navigate &gt; Up one level</p>
<p class="menuitem">This option moves up the directory tree. For example, if you are looking at http://www.domain.com/directory/page.html, clicking on the up icon takes you to http://www.domain.com/directory/ and a further click would result in a location of http://www.domain.com/. The same function is available on the <a href="#BrowserWindowToolbar">toolbar</a>.</p>

<p class="menupath" id="BrowserWindowMenuNavigateReload">Navigate &gt; Reload this page</p>
<p class="menuitem">This fetches and displays the current page again. Any copy of the page that exists in the local cache will be overwritten. The same function is available on the <a href="#BrowserWindowToolbar">toolbar</a>.</p>

<p class="menupath" id="BrowserWindowMenuNavigateStop">Navigate &gt; Stop loading this page</p>
<p class="menuitem">This stops the current page from continuing to load. The same function is available on the <a href="#BrowserWindowToolbar">toolbar</a>.</p>

<h4 id="BrowserWindowMenuDisplay" class="submenu">Display Submenu</h4>

<p>The Display submenu contains the various options which affect the rendering of the current window. Other configuration options are described in the <a href="#Configuration">configuration</a> section.</p>

<table class="menu">
<tr><th class="menutitle" colspan="2">Display</th></tr>
<tr><td><a href="#BrowserWindowMenuDisplayScale">Scale view</a></td><td class="menuarrow">&gt;</td></tr>
<tr><td><a href="#BrowserWindowMenuDisplayImages">Images</a></td><td class="menuarrow">&gt;</td></tr>
<tr><td><a href="#BrowserWindowMenuDisplayToolbars">Toolbars</a></td><td class="menuarrow">&gt;</td></tr>
<tr><td><a href="#BrowserWindowMenuDisplayRender">Render</a></td><td class="menuarrow">&gt;</td></tr>
<tr><td class="menusplit"><a href="#BrowserWindowMenuDisplaySaveDefault">Save as default</a></td><td class="menusplit"></td></tr>
<tr><td class="menusplit"><a href="#BrowserWindowMenuDisplayWindow">Window</a></td><td class="menusplit">&gt;</td></tr>
</table>

<p class="menupath" id="BrowserWindowMenuDisplayScale">Display &gt; Scale View</p>
<p class="menuitem">This option allows you to scale the current page affecting both text and images. The scale is represented by a percentage, with 100% always referring to the pre-scaled state of the document. The same function is available on the <a href="#BrowserWindowToolbar">toolbar</a>.</p>

<p class="menupath" id="BrowserWindowMenuDisplayImages">Display &gt; Images</p>
<p class="menuitem">The Images submenu allows you to control the way images are displayed. The options available here only affect the local browser window.</p>

<table class="menu">
<tr><th class="menutitle" colspan="2">Images</th></tr>
<tr><td><a href="#BrowserWindowMenuDisplayImagesForeground">Foreground images</a></td><td class="menuarrow"></td></tr>
<tr><td><a href="#BrowserWindowMenuDisplayImagesBackground">Background images</a></td><td class="menuarrow"></td></tr>
</table>

<p class="menupath" id="BrowserWindowMenuDisplayImagesForeground">Display &gt; Images &gt; Foreground images</p>
<p class="menuitem">This option allows you to toggle the display of foreground images. When foreground images are enabled, a tick appears to the left of the menu entry. If foreground images are disabled, any alternate text that the page provides will be shown instead.</p>

<p class="menupath" id="BrowserWindowMenuDisplayImagesBackground">Display &gt; Images &gt; Background images</p>
<p class="menuitem">This option allows you to toggle the display of background images. When background images are enabled, a tick appears to the left of the menu entry. If background images are disabled, any background colour specified by the document will be used instead.</p>

<p class="menupath" id="BrowserWindowMenuDisplayToolbars">Display &gt; Toolbars</p>
<p class="menuitem">The Toolbars submenu allows you to control the way NetSurf's toolbars are displayed. The options available here only affect the local browser window.</p>

<table class="menu">
<tr><th class="menutitle" colspan="2">Toolbars</th></tr>
<tr><td><a href="#BrowserWindowMenuDisplayToolbarsButtons">Buttons</a></td><td class="menuarrow"></td></tr>
<tr><td><a href="#BrowserWindowMenuDisplayToolbarsAddress">Address bar</a></td><td class="menuarrow"></td></tr>
<tr><td><a href="#BrowserWindowMenuDisplayToolbarsThrobber">Throbber</a></td><td class="menuarrow"></td></tr>
<tr><td><a href="#BrowserWindowMenuDisplayToolbarsStatus">Status bar</a></td><td></td></tr>
<tr><td class="menusplit"><a href="#BrowserWindowMenuDisplayToolbarsEdit">Edit toolbar</a></td><td></td></tr>
</table>

<p class="menupath" id="BrowserWindowMenuDisplayToolbarsButtons">Display &gt; Toolbars &gt; Buttons</p>
<p class="menuitem">This option toggles the display of the buttons on NetSurf's toolbar at the top of the window. When the buttons are turned off, the URL bar (if enabled) stretches to fill the extra space.</p>

<p class="menupath" id="BrowserWindowMenuDisplayToolbarsAddress">Display &gt; Toolbars &gt; Address bar</p>
<p class="menuitem">This option toggles the display of the address (URL) bar on NetSurf's toolbar at the top of the window.</p>

<p class="menupath" id="BrowserWindowMenuDisplayToolbarsThrobber">Display &gt; Toolbars &gt; Throbber</p>
<p class="menuitem">This option toggles the display of the throbber on NetSurf's toolbar at the top of the window. When the throbber is turned off, the URL bar (if enabled) stretches to fill the extra space.</p>

<p>If the buttons, URL bar and throbber are all disabled, the toolbar at the top of the window is removed, leaving more space for the main content area.</p>

<p class="menupath" id="BrowserWindowMenuDisplayToolbarsStatus">Display &gt; Toolbars &gt; Status bar</p>
<p class="menuitem">This option toggles the display of the status bar at the bottom of the NetSurf window. When the status bar is turned off, the horizontal scroll bar stretches to the full width of the window.</p>

<p class="menupath" id="BrowserWindowMenuDisplayToolbarsEdit">Display &gt; Toolbars &gt; Edit toolbar</p>
<p class="menuitem">This option activates <a href="#ConfigurationToolbar">toolbar edit</a> mode.</p>

<p class="menupath" id="BrowserWindowMenuDisplayRender">Display &gt; Render</p>
<p class="menuitem">The Render submenu allows you to control the way NetSurf draws content to the screen.</p>

<table class="menu">
<tr><th class="menutitle" colspan="2">Render</th></tr>
<tr><td><a href="#BrowserWindowMenuDisplayRenderBufferAnim">Buffer animations</a></td><td></td></tr>
<tr><td><a href="#BrowserWindowMenuDisplayRenderBufferAll">Buffer all rendering</a></td><td class="menuarrow"></td></tr>
</table>

<p class="menupath" id="BrowserWindowMenuDisplayRenderBufferAnim">Display &gt; Render &gt; Buffer animations</p>
<p class="menuitem">This option buffers anything that NetSurf forces to be redrawn, other than redrawing a part of the window which has been obscured. Things like text areas, which are redrawn after typing, and animations are buffered. This has the effect of stopping these items from flickering.</p>

<p class="menupath" id="BrowserWindowMenuDisplayRenderBufferAll">Display &gt; Render &gt; Buffer all rendering</p>
<p class="menuitem">This option is highly advantageous on complex pages because it only draws the page once, rather than building it up in layers. In use its effect is to stop the flicker caused by gradual redraw of pages, for example when resizing or scrolling a window, and present a more pleasant browsing experience. Buffer all rendering is configured off by default as it is best suited to fast hardware, such as the Iyonix.</p>

<p class="menupath" id="BrowserWindowMenuDisplaySetDefault">Display &gt; Save as default</p>
<p class="menuitem">This option makes NetSurf use the display options you have set up for the current window as the default options.</p>

<p class="menupath" id="BrowserWindowMenuDisplayWindow">Display &gt; Window</p>
<p class="menuitem">The Window submenu allows you to control the size and positioning of new windows.</p>

<table class="menu">
<tr><th class="menutitle" colspan="2">Window</th></tr>
<tr><td><a href="#BrowserWindowMenuDisplayWindowSetdefault">Set as default position</a></td><td class="menuarrow"></td></tr>
<tr><td><a href="#BrowserWindowMenuDisplayWindowStagger">Stagger window position</a></td><td class="menuarrow"></td></tr>
<tr><td><a href="#BrowserWindowMenuDisplayWindowCopyposition">Copy window position</a></td><td class="menuarrow"></td></tr>
<tr><td class="menusplit"><a href="#BrowserWindowMenuDisplayWindowResetdefault">Reset default position</a></td><td></td></tr>
</table>

<p class="menupath" id="BrowserWindowMenuDisplayWindowSetdefault">Display &gt; Window &gt; Set as default position</p>
<p class="menuitem">This option sets the size and position of the current window to be the default size and position for new browser windows. If no default position is set, NetSurf opens new windows in the centre of the screen.</p>

<p class="menupath" id="BrowserWindowMenuDisplayWindowStagger">Display &gt; Window &gt; Stagger window position</p>
<p class="menuitem">This option toggles staggered window opening positions for new windows. When turned on, this option means that new windows will open with a small offset from the position of the previously opened window. This option is only available when a user defined default window position has been set.</p>

<p class="menupath" id="BrowserWindowMenuDisplayWindowCopyposition">Display &gt; Window &gt; Copy window position</p>
<p class="menuitem">This option toggles the copy window position feature. When the feature is turned off, all newly opened windows open at the default position. With this feature enabled, browser windows opened from other browser windows (by adjust clicking on a link), will inherit the size and position of the parent window, rather than use the default position.</p>

<p class="menupath" id="BrowserWindowMenuDisplayWindowResetdefault">Display &gt; Window &gt; Reset default position</p>
<p class="menuitem">This option removes any user defined default window position. The option is only available when a user defined default window position has been set.</p>

<h4 id="BrowserWindowMenuUtilities" class="submenu">Utilities Submenu</h4>

<p>The Utilities submenu allows you to access some of NetSurf's extra features.</p>

<table class="menu">
<tr><th class="menutitle" colspan="2">Utilities</th></tr>
<tr><td><a href="#BrowserWindowMenuUtilitiesHotlist">Hotlist</a></td><td class="menuarrow">&gt;</td></tr>
<tr><td><a href="#BrowserWindowMenuUtilitiesHistory">History</a></td><td class="menuarrow">&gt;</td></tr>
<tr><td><a href="#BrowserWindowMenuUtilitiesCookies">Cookies</a></td><td class="menuarrow">&gt;</td></tr>
</table>

<p class="menupath" id="BrowserWindowMenuUtilitiesHotlist">Utilities &gt; Hotlist</p>
<p class="menuitem">The Hotlist submenu allows you to manage the hotlist.</p>

<table class="menu">
<tr><th class="menutitle" colspan="2">Hotlist</th></tr>
<tr><td><a href="#BrowserWindowMenuUtilitiesHotlistAdd">Add to hotlist</a></td><td class="menuarrow"></td></tr>
<tr><td><a href="#BrowserWindowMenuUtilitiesHotlistShow">Show hotlist</a></td><td class="menuarrow"></td></tr>
</table>

<p class="menupath" id="BrowserWindowMenuUtilitiesHotlistAdd">Utilities &gt; Hotlist &gt; Add to hotlist</p>
<p class="menuitem">This option adds the current page to the bottom of your hotlist. The same function is available on the <a href="#BrowserWindowToolbar">toolbar</a>.</p>

<p class="menupath" id="BrowserWindowMenuUtilitiesHotlistShow">Utilities &gt; Hotlist &gt; Show hotlist</p>
<p class="menuitem">This option opens the <a href="#HotlistWindow">hotlist management window</a>. The same function is available on the <a href="#BrowserWindowToolbar">toolbar</a>.</p>

<p class="menupath" id="BrowserWindowMenuUtilitiesHistory">Utilities &gt; History</p>
<p class="menuitem">The History submenu allows you to access NetSurf's history features.</p>

<table class="menu">
<tr><th class="menutitle" colspan="2">History</th></tr>
<tr><td><a href="#BrowserWindowMenuUtilitiesHistoryLocal">Show local history</a></td><td class="menuarrow"></td></tr>
<tr><td><a href="#BrowserWindowMenuUtilitiesHistoryGlobal">Show global history</a></td><td class="menuarrow"></td></tr>
</table>

<p class="menupath" id="BrowserWindowMenuUtilitiesHistoryLocal">Utilities &gt; History &gt; Show local History</p>
<p class="menuitem">This option opens the <a href="#HistoryLocal">local history window</a>. The same function is available on the <a href="#BrowserWindowToolbar">toolbar</a>.</p>

<p class="menupath" id="BrowserWindowMenuUtilitiesHistoryGlobal">Utilities &gt; History &gt; Show global History</p>
<p class="menuitem">This option opens the <a href="#HistoryGlobal">global history window</a>. The same function is available on the <a href="#BrowserWindowToolbar">toolbar</a>.</p>

<p class="menupath" id="BrowserWindowMenuUtilitiesCookies">Utilities &gt; Cookies</p>
<p class="menuitem">The Cookies submenu allows you to perform actions on the cookies stored by NetSurf.</p>

<table class="menu">
<tr><th class="menutitle" colspan="2">Cookies</th></tr>
<tr><td><a href="#BrowserWindowMenuUtilitiesCookiesShowcookies">Show cookies</a></td><td class="menuarrow"></td></tr>
<tr><td><a href="#BrowserWindowMenuUtilitiesCookiesDeleteallcookies">Delete all cookies</a></td><td class="menuarrow"></td></tr>
</table>

<p class="menupath" id="BrowserWindowMenuUtilitiesCookiesShowcookies">Utilities &gt; Cookies &gt; Show cookies</p>
<p class="menuitem">This option opens the cookie management window.</p>

<p class="menupath" id="BrowserWindowMenuUtilitiesCookiesDeleteallcookies">Utilities &gt; Cookies &gt; Delete all cookies</p>
<p class="menuitem">This option deletes all the cookies currently stored by NetSurf.</p>

<h4 id="BrowserWindowMenuHelp" class="submenu">Help Submenu</h4>

<p>The Help submenu contains options for fast access to help and information while you're using NetSurf.</p>

<table class="menu">
<tr><th class="menutitle" colspan="2">Help</th></tr>
<tr><td><a href="#BrowserWindowMenuHelpContents">Contents</a></td><td class="menuarrow"></td></tr>
<tr><td><a href="#BrowserWindowMenuHelpGuide">User guide</a></td><td class="menuarrow"></td></tr>
<tr><td><a href="#BrowserWindowMenuHelpInfo">User information</a></td><td class="menuarrow"></td></tr>
<tr><td class="menusplit"><a href="#BrowserWindowMenuHelpAbout">About NetSurf</a></td><td></td></tr>
<tr><td class="menusplit"><a href="#BrowserWindowMenuHelpInteractive">Interactive help</a></td><td></td></tr>
</table>

<p class="menupath" id="BrowserWindowMenuHelpContents">Help &gt; Contents</p>
<p class="menuitem">This option opens the <a href="/documentation/">documentation contents page</a> in a new window.</p>

<p class="menupath" id="BrowserWindowMenuHelpGuide">Help &gt; User guide</p>
<p class="menuitem">This option opens this page in a new window!</p>

<p class="menupath" id="BrowserWindowMenuHelpInfo">Help &gt; User information</p>
<p class="menuitem">This option opens the <a href="info">user information page</a> in a new window.</p>

<p class="menupath" id="BrowserWindowMenuHelpAbout">Help &gt; About NetSurf</p>
<p class="menuitem">This opens NetSurf's about page in a new window. The about page contains a list of people who have contributed to the NetSurf project and a credits for the libraries NetSurf uses.</p>

<p class="menupath" id="BrowserWindowMenuHelpInteractive">Help &gt; Interactive help</p>
<p class="menuitem">This option loads Help, if it hasn't already been loaded, to display interactive help messages.</p>

<h2 id="FileTypes">File Types</h2>

<p>When NetSurf encounters a file type it does not recognise, it opens a <a href="#DownloadWindow">download window</a> to allow the file to be saved to disc. (Note, NetSurf ignores local files of unrecognised file types.) The file types that NetSurf understands are listed below, with their RISC OS file type and MIME type(s) .</p>

<table>
<tr><th>Name</th><th>Type</th><th>MIME type(s)</th></tr>
<tr><td>Acorn URI</td><td>&amp;f91</td><td><abbr title="Not Applicable">N/A</abbr></td></tr>
<tr><td>ANT URL</td><td>&amp;b28</td><td><abbr title="Not Applicable">N/A</abbr></td></tr>
<tr><td>CSS</td><td>&amp;f79</td><td>text/css</td></tr>
<tr><td>Drawfile</td><td>&amp;aff</td><td>application/drawfile<br>application/x-drawfile<br>image/drawfile<br>image/x-drawfile</td></tr>
<tr><td>Flash</td><td>&amp;188</td><td>application/x-shockwave-flash</td></tr>
<tr><td>GIF</td><td>&amp;695</td><td>image/gif</td></tr>
<tr><td>HTML</td><td>&amp;faf</td><td>text/html</td></tr>
<tr><td>IEURL</td><td>&amp;1ba</td><td><abbr title="Not Applicable">N/A</abbr></td></tr>
<tr><td>JNG</td><td>&amp;f78</td><td>image/jng<br>image/x-jng</td></tr>
<tr><td>JPEG</td><td>&amp;c85</td><td>image/jpeg<br>image/pjpeg</td></tr>
<tr><td>MNG</td><td>&amp;f83</td><td>image/mng<br>image/x-mng<br>video/mng<br>video/x-mng</td></tr>
<tr><td>NetSurf Theme</td><td><abbr title="Not Applicable">N/A</abbr></td><td>application/x-netsurf-theme</td></tr>
<tr><td>PNG</td><td>&amp;b60</td><td>image/png</td></tr>
<tr><td>Sprite</td><td>&amp;ff9</td><td>image/x-riscos-sprite</td></tr>
<tr><td>Text</td><td>&amp;fff</td><td>text/plain</td></tr>
</table>

<p>Flash files are not handled by NetSurf directly but are displayed by an <a href="info#GettingStartedAdditionalResources">external plugin</a>.</p>

<p>NetSurf recognises different file types by their RISC OS file type for local files and by their content-type header for files sourced from the internet. Files are not identified by their extension or content. This means that for a file to be displayed, servers must be configured to send the correct content-type header and local files must have the correct RISC OS file type set.</p>

<h2 id="DownloadWindow">Download Window</h2>

<p>Whenever you follow a link to a file that NetSurf doesn't know how to handle, NetSurf opens the download window. This allows you to save a local copy of the file. The download window is shown below.</p>

<p class="guidescreenshot"><img src="images/dwnld.png" title="Download Window" alt=""></p>

<p>As soon as the download window opens, NetSurf starts downloading the file to your Scrap directory. At any time, either as the file downloads or after it has finished, it is possible drag the file icon at the top of the window to the directory where you wish to keep the file. This action causes the file to be moved to your desired location from Scrap and if the download is incomplete, the remainder of the file will also go to the new location.</p>

<p>The Source field indicates the location of the file being downloaded.</p>

<p>Initially, the Destination field allows the local filename of the file being downloaded to be set. Once the local destination of the file has been set, by dragging the icon to a filer window, the local path is shown here. Clicking on it will open the associated directory.</p>

<p>The bottom part of the download window displays information about the download's progress. On the left, the amount already downloaded and the total size are displayed. In the middle, the download speed is indicated and that the right, and estimated time remaining is shown. A beige progress bar indicates the download's progress visually.</p>

<h2 id="History">History</h2>

<p>While browsing the World Wide Web, you may come across interesting pages and some time later, you may wish to return to them. NetSurf's history stores the addresses (URLs) of the web pages you visit so that you can return to a page without having to remember the URL or how you first came across it.</p>

<p>NetSurf supports two distinct types of history; local and global. Local history contains only the pages that are visited in any particular window. Global history contains all the pages that have been visited in NetSurf and is remembered when NetSurf is restarted.</p>

<h3 id="HistoryLocal">Local History Window</h3>

<p>NetSurf's local history window provides a diagrammatical overview of the browsing history of a particular window. Each web page that is visited is represented by a thumbnail in a tree diagram. Beneath each thumbnail the page title is shown. Clicking on a thumbnail will cause the NetSurf browser window to return to that particular page.</p>

<h3 id="HistoryGlobal">Global History Window</h3>

<p>NetSurf's global history stores the addresses (URLs) of all the web pages you visit. To open the global history window, you can adjust click on the history toolbar button on a <a href="#BrowserWindow">browser window</a>, use the browser window <a href="#BrowserWindowMenuUtilitiesHistoryGlobal">menu option</a> or use the <a href="#IconbarMenu">iconbar menu</a>. The global history is made up from &quot;addresses&quot; and &quot;directories&quot;.</p>

<p>An address consists of a name and a URL. Addresses in the global history can point to any kind of file and double clicking on one will launch the URL in NetSurf. Addresses also store the date the URL was visited. By default, addresses are listed in the order they were visited and they are grouped by date within directories.</p>

<p>Directories store groups of addresses. In the default global history view, there are directories for each day up to the beginning of last week and further directories for previous weeks. The global history is expired after a maximum of four weeks.</p>

<p>The global history display works in a similar way to a filer window, although there are some important differences. Directories are not opened in new windows. Instead, the whole of the history is displayed in one window and directories represented by branches in a tree diagram. Double clicking on a closed directory will open it, displaying its contents as a new branch. Double clicking on an open directory will close it. When addresses are double clicked on, their URL is launched by NetSurf.</p>

<p>Next to the address and directory icons there are toggle boxes, which can be used to expand and collapse branches in the history tree. Clicking on the branch toggle boxes next to directories has exactly the same effect as double clicking on a directory. Expanding an address with the branch toggle box displays the other information it contains. (The URL and the time it was visited.) The space bar can also be used to expand or collapse selected addresses.</p>

<p>As with filer windows, selections can be made by dragging selection boxes and adjust clicking can be used to add or remove items from the selection.</p>

<h4 id="HistoryGlobalToolbar">Toolbar</h4>

<p>The global history toolbar allows quick access to various commonly used features. More functions are available through the <a href="#HistoryGlobalMenus">menus</a>. The toolbar can be customised to contain only the icons you want, in the order you want, in toolbar edit mode. This is covered in the <a href="#ConfigurationToolbar">toolbar customisation</a> section. Available icons are listed below.</p>

<p class="guideiconinfo"><strong><img src="images/delete.png" class="guideicon" alt="Delete Selection" title="Delete Selection Button"></strong> Clicking on this button deletes any selected directories or addresses from the global history.</p>

<p class="guideiconinfo"><strong><img src="images/expand.png" class="guideicon" alt="Expand Addresses" title="Expand Addresses Button"></strong> Select clicking on this button expands any addresses that are being shown, to display additional information about each one. Adjust clicking hides the additional information for any expanded addresses.</p>

<p class="guideiconinfo"><strong><img src="images/launch.png" class="guideicon" alt="Launch Selection" title="Launch Selection Button"></strong> Clicking on this button launches all selected addresses in separate <a href="#BrowserWindow">browser windows</a>. If a directory is selected any addresses it contains will be launched.</p>

<p class="guideiconinfo"><strong><img src="images/open.png" class="guideicon" alt="Open Directories" title="Open Directories Button"></strong> Select clicking on this button opens every directory in the global history. Adjust clicking closes any open directories.</p>

<h4 id="HistoryGlobalMenus">Menus</h4>

<p>The global history menu contains options which allow you to manage the content of your global history. The options available are:</p>

<table class="menu">
<tr><th class="menutitle" colspan="2">History</th></tr>
<tr><td><a href="#HistoryGlobalMenuHistory">History</a></td><td class="menuarrow">&gt;</td></tr>
<tr><td><a href="#HistoryGlobalMenuSelection">Selection</a></td><td class="menuarrow">&gt;</td></tr>
<tr><td><a href="#HistoryGlobalMenuSelectAll">Select all</a></td><td></td></tr>
<tr><td><a href="#HistoryGlobalMenuClearSelection">Clear selection</a></td><td></td></tr>
</table>

<h5 id="HistoryGlobalMenuHistory" class="submenu">History Submenu</h5>

<p>The History submenu contains the following options which apply to the global history window in general.</p>

<table class="menu">
<tr><th class="menutitle" colspan="2">History</th></tr>
<tr><td><a href="#HistoryGlobalMenuHistoryExport">Export</a></td><td class="menuarrow">&gt;</td></tr>
<tr><td class="menusplit"><a href="#HistoryGlobalMenuHistoryExpand">Expand</a></td><td class="menuarrow">&gt;</td></tr>
<tr><td><a href="#HistoryGlobalMenuHistoryCollapse">Collapse</a></td><td class="menuarrow">&gt;</td></tr>
<tr><td><a href="#HistoryGlobalMenuHistoryToolbars">Toolbars</a></td><td class="menuarrow">&gt;</td></tr>
</table>

<p class="menupath" id="HistoryGlobalMenuHistoryExport">History &gt; Export</p>
<p class="menuitem">This option allows you to export the global history as an HTML file. The directory structure is represented by nested unordered lists and addresses are converted to clickable links.</p>

<p class="menupath" id="HistoryGlobalMenuHistoryExpand">History &gt; Expand</p>
<p class="menuitem">This option allows various parts of the global history to be shown.</p>

<table class="menu">
<tr><th class="menutitle" colspan="2">Expand</th></tr>
<tr><td><a href="#HistoryGlobalMenuHistoryExpandAll">All</a></td><td class="menuarrow"></td></tr>
<tr><td><a href="#HistoryGlobalMenuHistoryExpandDirectories">Directories</a></td><td class="menuarrow"></td></tr>
<tr><td><a href="#HistoryGlobalMenuHistoryEdpandAddresses">Addresses</a></td><td class="menuarrow"></td></tr>
</table>

<p class="menupath" id="HistoryGlobalMenuHistoryExpandAll">History &gt; Expand &gt; All</p>
<p class="menuitem">This option opens all directories and expands all addresses in the global history, making the entire directory structure and all address information visible.</p>

<p class="menupath" id="HistoryGlobalMenuHistoryExpandDirectories">History &gt; Expand &gt; Directories</p>
<p class="menuitem">This option opens all of the directories in the global history, making the entire directory structure visible.</p>

<p class="menupath" id="HistoryGlobalMenuHistoryExpandAddresses">History &gt; Expand &gt; Addresses</p>
<p class="menuitem">This option expands all of the addresses which are presently being displayed in the global history. Their URLs and additional usage information are made visible.</p>

<p class="menupath" id="HistoryGlobalMenuHistoryCollapse">History &gt; Collapse</p>
<p class="menuitem">This option allows various parts of the global history to be hidden.</p>

<table class="menu">
<tr><th class="menutitle" colspan="2">Collapse</th></tr>
<tr><td><a href="#HistoryGlobalMenuHistoryCollapseAll">All</a></td><td class="menuarrow"></td></tr>
<tr><td><a href="#HistoryGlobalMenuHistoryCollapseDirectories">Directories</a></td><td class="menuarrow"></td></tr>
<tr><td><a href="#HistoryGlobalMenuHistoryCollapseAddresses">Addresses</a></td><td class="menuarrow"></td></tr>
</table>

<p class="menupath" id="HistoryGlobalMenuHistoryCollapseAll">History &gt; Collapse &gt; All</p>
<p class="menuitem">This option closes all directories and collapses all addresses in the global history, reducing the display to the contents of the root directory.</p>

<p class="menupath" id="HistoryGlobalMenuHistoryCollapseDirectories">History &gt; Collapse &gt; Directories</p>
<p class="menuitem">This option closes all of the directories in the global history, hiding the directory structure.</p>

<p class="menupath" id="HistoryGlobalMenuHistoryCollapseAddresses">History &gt; Collapse &gt; Addresses</p>
<p class="menuitem">This option reduces all of the displayed addresses to just their name, hiding their URLs and additional usage information.</p>

<p class="menupath" id="HistoryGlobalMenuHistoryToolbars">History &gt; Toolbars</p>
<p class="menuitem">The Toolbars submenu allows you to control the way NetSurf's global history toolbar is displayed.</p>

<table class="menu">
<tr><th class="menutitle" colspan="2">Toolbars</th></tr>
<tr><td><a href="#HistoryGlobalMenuHistoryToolbarsButtons">Buttons</a></td><td class="menuarrow"></td></tr>
<tr><td><a href="#HistoryGlobalMenuHistoryToolbarsEdit">Edit toolbar</a></td><td class="menuarrow"></td></tr>
</table>

<p class="menupath" id="HistoryGlobalMenuHistoryToolbarsButtons">History &gt; Toolbars &gt; Buttons</p>
<p class="menuitem">This option toggles the display of the buttons on NetSurf's global history toolbar at the top of the window.</p>

<p class="menupath" id="HistoryGlobalMenuHistoryToolbarsEdit">History &gt; Toolbars &gt; Edit toolbar</p>
<p class="menuitem">This option activates <a href="#ConfigurationToolbar">toolbar edit</a> mode.</p>

<h5 id="HistoryGlobalMenuSelection" class="submenu">Selection Submenu</h5>

<p>The selection submenu, which is only available when a selection has been made in the global history window, contains the following options.</p>

<table class="menu">
<tr><th class="menutitle" colspan="2">Selection</th></tr>
<tr><td><a href="#HistoryGlobalMenuSelectionLaunch">Launch</a></td><td></td></tr>
<tr><td><a href="#HistoryGlobalMenuSelectionDelete">Delete</a></td><td></td></tr>
</table>

<p class="menupath" id="HistoryGlobalMenuSelectionLaunch">Selection &gt; Launch</p>
<p class="menuitem">This option allows you to launch all of the selected addresses in separate NetSurf browser windows. This option is also available on the global history window <a href="#HistoryGlobalToolbar">toolbar</a>.</p>

<p class="menupath" id="HistoryGlobalMenuSelectionDelete">Selection &gt; Delete</p>
<p class="menuitem">This option deletes the current selection from the global history. This option is also available on the global history window <a href="#HistoryGlobalToolbar">toolbar</a>.</p>

<p class="menupath" id="HistoryGlobalMenuSelectAll">Select all</p>
<p class="menuitem">This option allows you to select all the addresses and directories in the global history window.</p>

<p class="menupath" id="HistoryGlobalMenuClearSelection">Clear selection</p>
<p class="menuitem">This option allows you to deselect any selected items.</p>

<h2 id="Hotlist">Hotlist Management Window</h2>

<p>While browsing the World Wide Web, you may come across pages that you wish to return to. NetSurf's hotlist provides a convenient way of storing these addresses (URLs) so that you can return to the page without having to remember the URL or how you first came across the page. To open the hotlist management window, you can adjust click on NetSurf's iconbar icon or select click on the Hotlist toolbar button in a <a href="#BrowserWindow">browser window</a>. Hotlists are made up from &quot;addresses&quot; and &quot;directories&quot;. There can be as many of each of these as you like.</p>

<p>An address consists of a name and a URL. Hotlist addresses can point to any kind of file and double clicking on one will launch the URL in NetSurf. The name can be anything but, for web pages, it is set to the page title by default. The simplest way to add an address to the hotlist is to adjust click on the Hotlist <a href="#BrowserWindowToolbar">toolbar button</a> in a browser window. This adds the URL of the current page to the hotlist. Additionally, files on your hard disc can be added by dragging them to the hotlist from a filer window. Addresses also store other usage information, such as the date the address was added to the hotlist, when it was last visited and how many times it has been visited in total.</p>

<p>Directories are used to group related addresses to allow for easy location of the address you want. They can be nested and contain a mixture of addresses and other directories.</p>

<p>The hotlist display works in a similar way to a filer window, although there are some important differences. Directories are not opened in new windows. Instead, the whole hotlist is displayed in one window and directories represented by branches in a tree diagram. Double clicking on a closed directory will open it, displaying its contents as a new branch. Double clicking on an open directory will close it. When addresses are double clicked on, their URL is launched by NetSurf.</p>

<p>Next to the address and directory icons there are toggle boxes, which can be used to expand and collapse branches in the hotlist tree. Clicking on the branch toggle boxes next to directories has exactly the same effect as double clicking on a directory. Expanding an address with the branch toggle box displays the other information it contains, such as the URL and its usage statistics. The space bar can also be used to expand or collapse selected addresses.</p>

<p>As with filer windows, selections can be made by dragging selection boxes and adjust clicking can be used to add or remove items from the selection. Selections can then be dragged and dropped within the hotlist management window to move them around. It is possible to drop a selection into a closed directory by releasing it over the bottom half of the target directory. Dropping the selection over the top half of a directory or address will insert the selection above that item. Finally, dropping a selection over the lower half of an address will move it below the address.</p>

<p>Renaming of addresses and directories can by achieved by clicking on an item with the <em>Alt</em> key held down. The URLs within expanded address entries can also be altered in this way. Selected items can be deleted from the <a href="#HotlistToolbar">toolbar</a>, <a href="#HotlistMenuSelectionDelete">menus</a> or with Ctrl+X</p>

<p>NetSurf's hotlist is stored as an HTML file which can be found in <em>Choices:WWW.NetSurf</em>. This means the hotlist file can be loaded into a NetSurf browser window and used as a links page or set to your default home page. The hotlist file is saved when you quit NetSurf.</p>

<h3 id="HotlistToolbar">Toolbar</h3>

<p>The hotlist toolbar allows quick access to various commonly used features. More functions are available through the <a href="#HotlistMenus">menus</a>. The toolbar can be customised to contain only the icons you want, in the order you want, in toolbar edit mode. This is covered in the <a href="#ConfigurationToolbar">toolbar customisation</a> section. Available icons are listed below.</p>

<h4>Toolbar Icons</h4>

<p class="guideiconinfo"><strong><img src="images/create.png" alt="Create Directory" title="Create Directory Button" class="guideicon"></strong> Clicking on this button adds a new directory to the bottom of the hotlist. The cursor is placed at the name of the new directory. Either type Ctrl-U and rename it or press Return to accept the default name.</p>

<p class="guideiconinfo"><strong><img src="images/delete.png" class="guideicon" alt="Delete Selection" title="Delete Selection Button"></strong> Clicking on this button deletes any selected directories or addresses from the hotlist.</p>

<p class="guideiconinfo"><strong><img src="images/expand.png" class="guideicon" alt="Expand Addresses" title="Expand Addresses Button"></strong> Select clicking on this button expands any addresses that are being shown, to display additional information about each one. Adjust clicking hides the additional information for any expanded addresses.</p>

<p class="guideiconinfo"><strong><img src="images/launch.png" class="guideicon" alt="Launch Selection" title="Launch Selection Button"></strong> Clicking on this button launches all selected addresses in separate <a href="#BrowserWindow">browser windows</a>. If a directory is selected any addresses it contains will be launched.</p>

<p class="guideiconinfo"><strong><img src="images/open.png" class="guideicon" alt="Open Directories" title="Open Directories Button"></strong> Select clicking on this button opens every directory in the hotlist. Adjust clicking closes any open directories.</p>

<p>Icons that are greyed out indicate that their function is unavailable.</p>

<h3 id="HotlistMenus">Menus</h3>

<p>The hotlist menu contains options which allow you to manage the content of your hotlist. The options available are:</p>

<table class="menu">
<tr><th class="menutitle" colspan="2">Hotlist</th></tr>
<tr><td><a href="#HotlistMenuHotlist">Hotlist</a></td><td class="menuarrow">&gt;</td></tr>
<tr><td><a href="#HotlistMenuSelection">Selection</a></td><td class="menuarrow">&gt;</td></tr>
<tr><td><a href="#HotlistMenuSelectAll">Select all</a></td><td></td></tr>
<tr><td><a href="#HotlistMenuClearSelection">Clear selection</a></td><td></td></tr>
</table>

<h4 id="HotlistMenuHotlist" class="submenu">Hotlist Submenu</h4>

<p>The Hotlist submenu contains the following options which apply to the hotlist in general.</p>

<table class="menu">
<tr><th class="menutitle" colspan="2">Hotlist</th></tr>
<tr><td><a href="#HotlistMenuHotlistNew">New</a></td><td class="menuarrow">&gt;</td></tr>
<tr><td><a href="#HotlistMenuHotlistExport">Export</a></td><td class="menuarrow">&gt;</td></tr>
<tr><td class="menusplit"><a href="#HotlistMenuHotlistExpand">Expand</a></td><td class="menuarrow">&gt;</td></tr>
<tr><td><a href="#HotlistMenuHotlistCollapse">Collapse</a></td><td class="menuarrow">&gt;</td></tr>
<tr><td><a href="#HotlistMenuHotlistToolbars">Toolbars</a></td><td class="menuarrow">&gt;</td></tr>
</table>

<p class="menupath" id="HotlistMenuHotlistNew">Hotlist &gt; New</p>
<p class="menuitem">This option allows the creation of new addresses or directories.</p>

<table class="menu">
<tr><th class="menutitle" colspan="2">New</th></tr>
<tr><td><a href="#HotlistMenuHotlistNewDirectory">Directory</a></td><td class="menuarrow">&gt;</td></tr>
<tr><td><a href="#HotlistMenuHotlistNewAddress">Address</a></td><td class="menuarrow">&gt;</td></tr>
</table>

<p class="menupath" id="HotlistMenuHotlistNewDirectory">Hotlist &gt; New &gt; Directory</p>
<p class="menuitem">This option allows you to create a new directory, which is added to the bottom of the hotlist. The name of the directory can be set and once created, it can be dragged to a different location in the hotlist and <a href="#HotlistMenuSelectionEdit">renamed</a>. Directories can be nested and there is no limit to the number of sub directories. This option is also available on the hotlist management window <a href="#HotlistToolbar">toolbar</a>.</p>

<p class="menupath" id="HotlistMenuHotlistNewAddress">Hotlist &gt; New &gt; Address</p>
<p class="menuitem">This option allows you to create a new address. Its name and URL must be set before it is added to the bottom of the hotlist. The address can later be moved around in the hotlist and <a href="#HotlistMenuSelectionEdit">edited</a>. This option is also available on the hotlist management window <a href="#HotlistToolbar">toolbar</a>.</p>

<p class="menupath" id="HotlistMenuHotlistExport">Hotlist &gt; Export</p>
<p class="menuitem">This option allows you to export the hotlist as an HTML file. The directory structure is represented by nested unordered lists and addresses are converted to clickable links.</p>

<p class="menupath" id="HotlistMenuHotlistExpand">Hotlist &gt; Expand</p>
<p class="menuitem">This option allows various parts of the hotlist to be shown.</p>

<table class="menu">
<tr><th class="menutitle" colspan="2">Expand</th></tr>
<tr><td><a href="#HotlistMenuHotlistExpandAll">All</a></td><td class="menuarrow"></td></tr>
<tr><td><a href="#HotlistMenuHotlistExpandDirectories">Directories</a></td><td class="menuarrow"></td></tr>
<tr><td><a href="#HotlistMenuHotlistEdpandAddresses">Addresses</a></td><td class="menuarrow"></td></tr>
</table>

<p class="menupath" id="HotlistMenuHotlistExpandAll">Hotlist &gt; Expand &gt; All</p>
<p class="menuitem">This option opens all directories and expands all addresses in the hotlist, making the entire directory structure and all address information visible.</p>

<p class="menupath" id="HotlistMenuHotlistExpandDirectories">Hotlist &gt; Expand &gt; Directories</p>
<p class="menuitem">This option opens all of the directories in the hotlist, making the entire directory structure visible.</p>

<p class="menupath" id="HotlistMenuHotlistExpandAddresses">Hotlist &gt; Expand &gt; Addresses</p>
<p class="menuitem">This option expands all of the addresses which are presently being displayed in the hotlist. Their URLs and additional usage information are made visible.</p>

<p class="menupath" id="HotlistMenuHotlistCollapse">Hotlist &gt; Collapse</p>
<p class="menuitem">This option allows various parts of the hotlist to be hidden.</p>

<table class="menu">
<tr><th class="menutitle" colspan="2">Collapse</th></tr>
<tr><td><a href="#HotlistMenuHotlistCollapseAll">All</a></td><td class="menuarrow"></td></tr>
<tr><td><a href="#HotlistMenuHotlistCollapseDirectories">Directories</a></td><td class="menuarrow"></td></tr>
<tr><td><a href="#HotlistMenuHotlistCollapseAddresses">Addresses</a></td><td class="menuarrow"></td></tr>
</table>

<p class="menupath" id="HotlistMenuHotlistCollapseAll">Hotlist &gt; Collapse &gt; All</p>
<p class="menuitem">This option closes all directories and collapses all addresses in the hotlist, reducing the display to the contents of the hotlist root directory.</p>

<p class="menupath" id="HotlistMenuHotlistCollapseDirectories">Hotlist &gt; Collapse &gt; Directories</p>
<p class="menuitem">This option closes all of the directories in the hotlist, hiding the directory structure.</p>

<p class="menupath" id="HotlistMenuHotlistCollapseAddresses">Hotlist &gt; Collapse &gt; Addresses</p>
<p class="menuitem">This option reduces all of the hotlist addresses to just their name, hiding their URLs and additional usage information.</p>

<p class="menupath" id="HotlistMenuHotlistToolbars">Hotlist &gt; Toolbars</p>
<p class="menuitem">The Toolbars submenu allows you to control the way NetSurf's hotlist toolbar is displayed.</p>

<table class="menu">
<tr><th class="menutitle" colspan="2">Toolbars</th></tr>
<tr><td><a href="#HotlistMenuHotlistToolbarsButtons">Buttons</a></td><td class="menuarrow"></td></tr>
<tr><td><a href="#HotlistMenuHotlistToolbarsEdit">Edit toolbar</a></td><td class="menuarrow"></td></tr>
</table>

<p class="menupath" id="HotlistMenuHotlistToolbarsButtons">Hotlist &gt; Toolbars &gt; Buttons</p>
<p class="menuitem">This option toggles the display of the buttons on NetSurf's hotlist toolbar at the top of the window.</p>

<p class="menupath" id="HotlistMenuHotlistToolbarsEdit">Hotlist &gt; Toolbars &gt; Edit toolbar</p>
<p class="menuitem">This option activates <a href="#ConfigurationToolbar">toolbar edit</a> mode.</p>

<h4 id="HotlistMenuSelection" class="submenu">Selection Submenu</h4>

<p>The selection submenu, which is only available when a selection has been made in the hotlist management window, contains the following options.</p>

<table class="menu">
<tr><th class="menutitle" colspan="2">Selection</th></tr>
<tr><td><a href="#HotlistMenuSelectionEdit">Edit</a></td><td class="menuarrow">&gt;</td></tr>
<tr><td><a href="#HotlistMenuSelectionLaunch">Launch</a></td><td></td></tr>
<tr><td><a href="#HotlistMenuSelectionDelete">Delete</a></td><td></td></tr>
</table>

<p class="menupath" id="HotlistMenuSelectionEdit">Selection &gt; Edit</p>
<p class="menuitem">This option allows you to edit the currently selected item and is only available when either one directory or one item is selected. The names of directories can addresses can be altered. Addresses' URLs can also be changed.</p>

<p>Addresses added to the hotlist from a NetSurf browser window have a default name set. For HTML files, this is the page title.</p>

<p class="menupath" id="HotlistMenuSelectionLaunch">Selection &gt; Launch</p>
<p class="menuitem">This option allows you to launch all of the selected addresses in separate NetSurf browser windows. This option is also available on the hotlist management window <a href="#HotlistToolbar">toolbar</a>.</p>

<p class="menupath" id="HotlistMenuSelectionDelete">Selection &gt; Delete</p>
<p class="menuitem">This option deletes the current selection from the hotlist. This option is also available on the hotlist management window <a href="#HotlistToolbar">toolbar</a>.</p>

<p class="menupath" id="HotlistMenuSelectAll">Select all</p>
<p class="menuitem">This option allows you to select all the addresses and directories in the hotlist.</p>

<p class="menupath" id="HotlistMenuClearSelection">Clear selection</p>
<p class="menuitem">This option allows you to deselect any selected items.</p>

<h2 id="Configuration">Configuring NetSurf</h2>

<p>NetSurf can be tailored to suit your needs by configuring the way it looks and behaves. Most of NetSurf's configuration options are available from the <a href="#ConfigurationGlobal">global choices</a> panel. Display options for browser windows are set up for an individual browser window and then saved globally in the <a href="#BrowserWindowMenuDisplay">browser window menus</a>.</p>

<p>Toolbars can be customised to contain only the icons you want, in the order you want, in toolbar edit mode. This is covered in the <a href="#ConfigurationToolbar">toolbar customisation</a> section.</p>

<h3 id="ConfigurationGlobal">Global Configuration</h3>

<p>The configuration panel is opened from the <a href="#IconbarMenuChoices">iconbar menu</a>.</p>

<div class="window">
<ul>
<li><span><a href="#ConfigurationGlobalCache"><img src="images/cache.png" alt=""></a></span><a href="#ConfigurationGlobalCache">Cache</a></li>
<li><span><a href="#ConfigurationGlobalConnection"><img src="images/connect.png" alt=""></a></span><a href="#ConfigurationGlobalConnection">Connection</a></li>
<li><span><a href="#ConfigurationGlobalContent"><img src="images/content.png" alt=""></a></span><a href="#ConfigurationGlobalContent">Content</a></li>
<li><span><a href="#ConfigurationGlobalFonts"><img src="images/fonts.png" alt=""></a></span><a href="#ConfigurationGlobalFonts">Fonts</a></li>
<li><span><a href="#ConfigurationGlobalHome"><img src="images/homeconf.png" alt=""></a></span><a href="#ConfigurationGlobalHome">Home page</a></li>
<li><span><a href="#ConfigurationGlobalImages"><img src="images/images.png" alt=""></a></span><a href="#ConfigurationGlobalImages">Images</a></li>
<li><span><a href="#ConfigurationGlobalInterface"><img src="images/interface.png" alt=""></a></span><a href="#ConfigurationGlobalInterface">Interface</a></li>
<li><span><a href="#ConfigurationGlobalLanguage"><img src="images/language.png" alt=""></a></span><a href="#ConfigurationGlobalLanguage">Language</a></li>
<li><span><a href="#ConfigurationGlobalMemory"><img src="images/memory.png" alt=""></a></span><a href="#ConfigurationGlobalMemory">Memory</a></li>
<li><span><a href="#ConfigurationGlobalSecurity"><img src="images/security.png" alt=""></a></span><a href="#ConfigurationGlobalSecurity">Security</a></li>
<li><span><a href="#ConfigurationGlobalThemes"><img src="images/themes.png" alt=""></a></span><a href="#ConfigurationGlobalThemes">Themes</a></li>
</ul>

<p>NetSurf's global configuration sections</p>
</div>

<p>Clicking on one of the section icons will open a new configuration window, allowing you to set up that particular aspect of NetSurf.</p>

<p>All of NetSurf's configuration section windows have the following three buttons at the bottom.</p>

<div class="option_group">
<dl>
<dt>Default</dt>
<dd>This button can be used to reset NetSurf's options, for the current configuration window, to the original values that are built into NetSurf. Use this button if you think that you have configured something wrongly and want to try the &quot;factory settings&quot;.</dd>
<dt>Cancel</dt>
<dd>Select clicking on this button will close the window. Any changes you have made will be discarded.<br>Adjust clicking on this button will return all the options in the window back to the last saved values, that were shown when you opened the window.</dd>
<dt>Set</dt>
<dd>Select clicking on this button will save your changes and close the window.<br>Adjust clicking on this button will save your changes and leave the window open.</dd>
</dl>
</div>

<h4 id="ConfigurationGlobalCache">Cache Configuration</h4>

<p>NetSurf keeps local copies of some content, which has been downloaded from the internet. This local copy of downloaded data is called a cache and it improves NetSurf's performance. The cache is used so that if, for example, you visit a page that contains an image and then go to another page that uses the same image, NetSurf will not need to download the same image twice.</p>

<p>NetSurf has two separate caches, the memory cache and the disc cache.</p>

<h5>Memory cache</h5>

<p>The memory cache is used to store data related to the most recent pages you have seen. Since this data is stored in memory, it can be accessed very quickly. The memory cache is not preserved over sessions, and is lost when you quit NetSurf.</p>

<div class="option_group">
<dl>
<dt>Size</dt>
<dd>This option can be used to alter the size of NetSurf's memory cache. A larger cache will allow more content to be stored in memory, at the expense of greater memory usage.</dd>
</dl>
</div>

<h5>Disc cache</h5>

<p>The disc cache is used to store content from web sites on your computer's hard disc. This allows you to return to old pages without having to download them again. The disc cache also stores other persistent data (data that is recovered next time you start NetSurf). It stores web page thumbnails for showing in <a href="#HistoryGlobal">global history</a>.</p>

<div class="option_group">
<dl>
<dt>Duration</dt>
<dd>This option can be used to alter the maximum length of time data will stay in the disc cache, without being used, before it is dropped from the cache. Note that files are not automatically deleted from your hard disc when they are dropped from the cache. Files in the cache are each assigned a file name. When the file is dropped from the cache its file name is freed up, so that a new file to be written to the cache can overwrite it. NetSurf does not automatically delete dropped files for performance reasons and to keep hard disc usage to a minimum. To manually delete dropped files, use the "perform maintenance button below.</dd>
<dt>Perform maintenance</dt>
<dd>This button can be used to delete any redundant files from NetSurf's disc cache.</dd>
</dl>
</div>

<p class="note">At the current time the disc cache is not fully operational. It is only used for storing images.</p>

<h4 id="ConfigurationGlobalConnection">Connection Configuration</h4>

<p>NetSurf accesses the internet by contacting remote computers. The options here can be used to configure how it does this.</p>

<h5>HTTP Proxy</h5>

<p>Some computers need to be connected to the internet through a proxy server. If your Internet Service Provider has a proxy server, the details can be entered here.</p>

<div class="option_group">
<dl>
<dt>Proxy type</dt>
<dd>This option can be used to select a proxy type. &quot;No proxy&quot; means you do not require a proxy to connect to the internet. &quot;Simple proxy&quot; means use a proxy that does not require authentication (a username and password). &quot;Basic authentication&quot; means use a proxy that requires a username and password. &quot;NTLM authentication&quot; also means use a proxy that requires a username and password. Consult your ISP to find out which option to use. If a proxy is required, &quot;Simple proxy&quot; is the most common type.</dd>
<dt>Host</dt>
<dd>This option can be used to set the host name for the proxy server. This option will be greyed out if &quot;No proxy&quot; has been selected above.</dd>
<dt>Port</dt>
<dd>This option can be used to set the port number for the proxy server. This option will be greyed out if &quot;No proxy&quot; has been selected above.</dd>
<dt>Username</dt>
<dd>This option can be used to set a username for use with the proxy server. This option will be greyed out unless a proxy with authentication has been selected for the proxy type.</dd>
<dt>Password</dt>
<dd>This option can be used to set a password for use with the proxy server. This option will be greyed out unless a proxy with authentication has been selected for the proxy type.</dd>
</dl>
</div>

<h5>Fetching</h5>

<p>The way NetSurf fetches content from the internet can be tailored to suit your hardware and the speed of your internet connection. These are quite advanced configuration options and should not need to be modified, in most cases.</p>

<div class="option_group">
<dl>
<dt>Maximum fetches</dt>
<dd>This option can be used to set the maximum number of simultaneous fetches (downloading multiple things in parallel) that NetSurf will carry out at one time. After this limit is reached, new fetches will be queued and fetched as the current fetches are completed. High values will benefit people with fast connections and fast computers, that are able to keep up with all the incoming data.</dd>
<dt>Fetches per host</dt>
<dd>This option can be used to set the maximum number of simultaneous fetches per host. This means the limit to the number of simultaneous downloads from a particular web site. Simultaneous downloads from the same host can speed up fetching web pages quite dramatically because images on the page can be fetched in parallel, rather than in series.</dd>
<dt>Cached connections</dt>
<dd>This option can be used to set the maximum number of persistent connections that NetSurf can maintain at any one time. Persistent connections, or &quot;Keep-Alive&quot; connections are HTTP sessions that allow multiple requests to be sent over the same connection. In some cases they have been shown to result in an almost 50% speed up in latency times for HTML documents with lots of images.</dd>
</dl>
</div>

<h4 id="ConfigurationGlobalContent">Content Configuration</h4>

<p>Content is the name given to material downloaded from the World Wide Web. It can be web pages, images, animations and more.</p>

<h5>Content blocking</h5>

<p>NetSurf can prevent certain types of content from loading and stop pages from performing certain actions.</p>

<div class="option_group">
<dl>
<dt>Hide advertisements</dt>
<dd>This option can be used to stop NetSurf from displaying advertisements on web pages. This can be useful for pages which contain distracting or obtrusive adverts. Note that NetSurf can only make an educated guess at which content is an advert and which is not. This can mean that some adverts will be fail to be blocked, or more seriously, when advertisement blocking is enabled some valid content may occasionally be blocked.</dd>
<dt>Disable pop-up windows</dt>
<dd>This option can be used to stop web pages from opening new browser windows on your desktop. Some pages may try to open advertisements in new windows, when you visit the page, or open some links in pop-up windows, instead of the current window. Disabling pop-ups means that the only way a new window can be opened is when a user explicitly opens it.</dd>
<dt>Disable plug-ins</dt>
<dd>This option can be used to disable plug-ins. Plug-ins are external applications that can handle specific types of content, for example Flash files. This option disables the use of plug-ins, meaning that NetSurf will simply not display the particular file, or use any alternative content provided by a web page.</dd>
</dl>
</div>

<h4 id="ConfigurationGlobalFonts">Font Configuration</h4>

<p>Most content and information on the World Wide Web is text. It is important to set NetSurf up so that it displays text that you find comfortable to read.</p>

<h5>Font faces</h5>

<p>You can set which specific font on your system that you want NetSurf to use for each of the five styles of typeface that are available for use on the World Wide Web.</p>

<div class="option_group">
<dl>
<dt>Sans-serif</dt>
<dd>This option can be used to select a particular sans-serif font on your system. It will be used whenever a web page specifies a sans-serif typeface. Helvetica (Homerton) is an example of a sans-serif font.</dd>
<dt>Serif</dt>
<dd>This option can be used to select a particular serif font on your system. It will be used whenever a web page specifies a serif typeface. Times (Trinity) is an example of a serif font.</dd>
<dt>Monospace</dt>
<dd>This option can be used to select a particular monospace font on your system. It will be used whenever a web page specifies a monospace typeface. Courier (Corpus) is an example of a monospace font.</dd>
<dt>Cursive</dt>
<dd>This option can be used to select a particular cursive font on your system. It will be used whenever a web page specifies a cursive typeface. ZapfChancery (Churchill) is an example of a cursive font.</dd>
<dt>Fantasy</dt>
<dd>This option can be used to select a particular fantasy font on your system. It will be used whenever a web page specifies a fantasy typeface. There is no particular style of font associated with fantasy, so any fancy looking but readable font would be apt and suitable.</dd>
<dt>Default</dt>
<dd>This option can be used to set the default font style. It is used when web pages do not specify a font face of their own. Sans-serif and serif are the most typical options for this setting.</dd>
</dl>
</div>

<h5>Font size</h5>

<p>The size of text used to render web pages can be controlled with the following options. It is important to ensure that the text NetSurf renders is at a size you find comfortable to read.</p>

<div class="option_group">
<dl>
<dt>Default</dt>
<dd>This option can be used to set the default font size. The default font size is the size at which text will be rendered whenever web pages do not specify a size. It is also the base size that is used where web sites specify relative font sizes.</dd>
<dt>Minimum</dt>
<dd>This option can be used to set the minimum font size. No text will be rendered smaller than this size, even if a web site specifies a smaller size. This option is used to ensure that web pages are never rendered with smaller text than you find easy to read.</dd>
</dl>
</div>

<h4 id="ConfigurationGlobalHome">Home Page Configuration</h4>

<p>The home page is the page that is opened when you open a new window from the icon bar.</p>

<h5>Home page</h5>

<div class="option_group">
<dl>
<dt>URL</dt>
<dd>This option can be used to set NetSurf's home page address. Any address can be typed into the box, or an address can be selected from a menu of recently visited URLs. These URLs are addresses that have previously been typed into the <a href="#BrowserWindowURLBar">URL bar</a> of a NetSurf <a href="#BrowserWindow">browser window</a>.</dd>
<dt>Open browser window on start-up</dt>
<dd>This option can be used to make NetSurf open a new browser window on the desktop, when the application is started.</dd>
</dl>
</div>

<h4 id="ConfigurationGlobalImages">Image Configuration</h4>

<p>A great deal of content on the internet is in the form of images. NetSurf allows the display of images to be tailored to suit the hardware you use.</p>

<h5>Image quality</h5>

<p>NetSurf can use various different methods to display images on web pages. If you are using NetSurf in a 16 million colour screen mode, all the options will perform the same. If you use less than 16 million colours then there is a trade-off between image quality and rendering speed. The exception to this is the &quot;Use OS&quot; option, which will never display images with alpha channels (varying degrees of transparency) as well as any of the other options. The four image quality settings are described below.</p>

<dl>
<dt>Use OS</dt>
<dd>This means that RISC OS's routines (OS_SpriteOp) are used to display images. This option results in poor quality (especially so for images with alpha channels as the alpha channel is emulated using standard calls) and also poor speed. <em>This option is not recommended</em> unless you are having problems with the other options.</dd>
<dt>Direct to screen</dt>
<dd>This is the fastest available output, but suffers the same low quality as using the OS routines in less than 16 million colours. However, this option can render images with alpha channels correctly. If you are on a slow machine you may want to use this for background images.</dd>
<dt>Dithered</dt>
<dd>This is a quick method for improving the display of images in screen modes with less than 16 million colours. It emulates twice as many colours as are available in the current screen mode (for less than 16 million colours). It gives a fair increase in display quality for many images and you won't notice much speed loss. If you're on a slow machine you will probably find this best for foreground images.</dd>
<dt>Error diffused</dt>
<dd>This is another method for improving the display of images in screen modes with less than 16 million colours. It is slower than dithering but offers the highest quality representation of images. If you run in an 8bpp (256 colour) screen mode then this is as aesthetically pleasing as you can get. As it is slower than the other options, you may only want to use it for foreground images, even on a medium powered machine (such as a SA RiscPC).</dd>
</dl>

<p>Note that if you are using a 16 million colour mode then neither error diffusion or dithering will be used, even if one of these options is selected. This is because all possible colours can be displayed directly. Naturally, use of a 16 million colour million colour screen mode gives the best possible display, if you have the image quality setting set to &quot;Direct to screen&quot;, &quot;Dithered&quot; and &quot;Error diffused&quot;. If you use 16 million colours and have a fast machine, it is best to use &quot;Error diffused&quot;, so that if you ever drop to a low colour screen mode you still get the best available image quality.</p>

<div class="option_group">
<dl>
<dt>Foreground</dt>
<dd>This option can be used to set the type of rendering to be used for foreground images. Since foreground images are often important features of web pages and cover relatively small areas, it is worth setting this setting as high as you can get away with on your hardware. For details on what each of the options actually does, see the notes above.</dd>
<dt>Background</dt>
<dd>This option can be used to set the type of rendering to be used for background images. Since background images are rarely vital features of web pages and can cover large areas, it would be wise to set this setting to a lower quality than for foreground images, if you are not running NetSurf on one of the latest machines. For details on what each of the options actually does, see the notes above.</dd>
<dt>Preview image</dt>
<dd>This section shows the results of your image quality choices on the visual appearance of images. In 16 million colour screen modes, the &quot;Direct to screen&quot;, &quot;Dithered&quot; and &quot;Error diffused&quot; will look the same. If the &quot;Use OS&quot; option is used for the foreground image, the preview will demonstrate the poor handling of alpha channels that this mode exhibits. In 256 colour modes, the differences between the different quality settings should be quite pronounced.</dd>
</dl>
</div>

<h5>Animations</h5>

<p>Some web pages use animations, which are a series of still images played in sequence.</p>

<div class="option_group">
<dl>
<dt>Speed limit</dt>
<dd>This option can be used to set the minimum time delay between displaying each frame of an animation. Increasing this value will cause animations to run slower. Fast animations require a lot of computational effort, so a very low setting can cause your computer to slow down when rapid animations are displayed.</dd>
<dt>Disable animations</dt>
<dd>This option can be used to stop animations from being played. If animations are disabled then the first frame of the animation is shown as a  static image.</dd>
</dl>
</div>

<h4 id="ConfigurationGlobalInterface">Interface Configuration</h4>

<p>The way NetSurf interacts with its users is called its interface. Various aspects of NetSurf's behaviour can be tailored to suit your requirements.</p>

<h5>Downloading / saving files</h5>

<p>You can use NetSurf to save content from the internet onto your local hard disc.</p>

<div class="option_group">
<dl>
<dt>Strip filename extensions when saving</dt>
<dd>This option can be used to remove the file extensions (eg .html and .jpeg) from file names. The extensions are not needed on RISC OS as it records the file type by other means. You may want to retain file extensions if you plan to transfer saved files to other computers, running different operating systems.</dd>
<dt>Request confirmation before overwriting files</dt>
<dd>This option can be used to make NetSurf to ask for confirmation before overwriting a file of the same name, when saving. Please note that NetSurf does not allow directories to be overwritten. Also note that SparkFS causes zip files and other archives to be treated as directories.</dd>
</dl>
</div>

<h5>Interactive features</h5>

<p>NetSurf has various features that can provide information and additional functionality as you use or interact with the program.</p>

<div class="option_group">
<dl>
<dt>Display recently visited URLs as you type</dt>
<dd>This option can be used to enable NetSurf's URL suggestion feature. When this is enabled and you type into the <a href="#BrowserWindowURLBar">URL bar</a> of a NetSurf <a href="#BrowserWindow">browser window</a>, then a small window is opened up below the URL bar, which shows previously visited URLs that could be used to complete the URL you're typing. For more information, see the <a href="#BrowserWindowURLCompletion">URL completion</a> section.</dd>
<dt>Hover URLs by the pointer for local history</dt>
<dd>This option can be used to make NetSurf display the URL of the thumbnail under your mouse pointer in <a href="#HistoryLocal">local history</a> windows. The URL is displayed in a floating box, beside the pointer.</dd>
</dl>
</div>

<h4 id="ConfigurationGlobalLanguage">Language Configuration</h4>

<p>NetSurf has been designed to work in different languages and you can select the one that you find most suitable.</p>

<h5>Language</h5>

<div class="option_group">
<dl>
<dt>Interface</dt>
<dd>This option can be used to select the language to use for NetSurf's interface. This includes menus, dialogue boxes and interactive help text. The only available languages are those that have had resources prepared for them. At the current time, these are English, Dutch, French and German.</dd>
<dt>Web pages</dt>
<dd>This option can be used to request for web pages to be sent in your preferred language. Some web sites are available in a variety of languages. NetSurf will request that web servers send pages in the language of your choice. If your desired language is unavailable, the server will ignore the request and use a default language.</dd>
</dl>
</div>

<h4 id="ConfigurationGlobalMemory">Memory Configuration</h4>

<p>NetSurf provides you with a certain amount of control over how it uses the memory on your system. The way you set up NetSurf's memory usage will depend on how much memory your system has and how many other applications you tend to have running while browsing the World Wide Web.</p>

<h5>Image memory</h5>

<p>NetSurf uses memory to store images downloaded from the internet, while you are viewing them. It can store both compressed and uncompressed images in memory.</p>

<div class="option_group">
<dl>
<dt>Direct</dt>
<dd>This option can be used to set the maximum amount of memory NetSurf will use for storing uncompressed images. The more memory you allocate to this, the more images NetSurf will be able to hold in memory. Uncompressed images, held in memory can be displayed very quickly.</dd>
<dt>Automatic handling</dt>
<dd>This option can be used to tell NetSurf to make an intelligent guess at the best amount of memory to use for uncompressed images on your system. Generally, this option will work well for most users.</dd>
<dt>Compressed</dt>
<dd>This option can be used to set the maximum amount of memory NetSurf will use for storing compressed images. The more memory you allocate to this, the more images NetSurf will be able to hold in memory. Uncompressed images, held in memory, can be displayed quickly. When the &quot;direct&quot; and &quot;compressed&quot; memory is full, images can be dropped out of memory and stored on your hard disc. This is part of NetSurf's disc cache functionality and options for controlling this are provided in the <a href="#ConfigurationGlobalCache">cache configuration</a> section.</dd>
<dt>Automatic handling</dt>
<dd>This option can be used to tell NetSurf to make an intelligent guess at the best amount of memory to use for compressed images on your system. Generally, this option will work well for most users.</dd>
</dl>
</div>

<h4 id="ConfigurationGlobalSecurity">Security Configuration</h4>

<p>As the World Wide Web has grown in popularity, so too has the number of people who try to exploit its users for some nefarious end. Browser security and privacy features have become increasingly important.</p>

<h5>Cross-site privacy</h5>

<p>When you visit one page, after following a link on another page, a browser can tell the new page the address of the page that linked to them.</p>

<div class="option_group">
<dl>
<dt>Send site referral information</dt>
<dd>This option can be used to allow NetSurf to send referral information. When this option is disabled, NetSurf will not tell web sites the address of the page you came from. In most cases this should not cause any problems, but some sites do require you to send referral information. In these cases you might find images don't load or you get Forbidden messages from their server. On the other hand, if you do send referral information, web sites will be able to tell what web site you were at before you followed a link to their site. This allows them to find out what other sites are linking to them and is not usually any cause for distress.</dd>
</dl>
</div>

<h5>Site history</h5>

<p>NetSurf records all the web sites you have visited as part of its <a href="#HistoryGlobal">global history</a> feature. Entries can be deleted from the global history window directly and NetSurf allows the length of time items are kept in global history to be configured.</p>

<div class="option_group">
<dl>
<dt>Duration</dt>
<dd>This option can be used to set the length of time entries are stored in global history, before they are deleted. Setting the duration to zero days turns off the global history feature.</dd>
</dl>
</div>

<h4 id="ConfigurationGlobalThemes">Theme Configuration</h4>

<p>The 'look and feel' of NetSurf's interface can be changed. This is done by installing and selecting themes.</p>

<h5>Available themes</h5>

<p>This section displays a preview of all the currently installed themes. New themes are available at the <a href="http://www.netsurf-browser.org/downloads/themes/">NetSurf themes page</a>.</p>

<div class="option_group">
<dl>
<dt>Theme selection pane</dt>
<dd>This section can be used to select a theme. A theme is selected using the radio buttons. If a theme you have just installed does not appear for selection, NetSurf needs to be told to re-scan the themes directory. It is re-scanned when the choices window is opened or by adjust clicking on the Cancel button. The currently loaded theme is cached so any updates to that theme will not be loaded until NetSurf is restarted. Alternatively, it is possible to switch to another theme, re-scan themes and then switch back.</dd>
</dl>
</div>

<h3 id="ConfigurationToolbar">Toolbar customisation</h3>

<p>Icons on NetSurf's toolbars can be switched on &amp; off and moved around. The sprites used for the icons can be changed by installing different <a href="http://www.netsurf-browser.org/downloads/themes/">themes</a>.</p>

<p>To move the icons around, enable toolbar edit mode by clicking menu over the toolbar and choosing &quot;Edit toolbar&quot;. This will open the toolbar editing panel. Icons can be dragged back and forth between the temporary panel and the toolbar. Separators for groups of icons can be created by dragging the separator sprite from the toolbar edit panel and dropping it where you want it to go. To exit toolbar edit mode, select &quot;Edit toolbar&quot; again from the toolbar menu.<p>

<p>When you exit toolbar edit mode, the new toolbar layout is saved and new windows opened from then on will use your customised toolbar.</p>

<h2 id="Keys">Keyboard Shortcuts</h2>

<p>NetSurf supports keyboard shortcuts, which allow quick access to features and make NetSurf easier to use. The supported keypresses and corresponding functions are listed below.</p>

<h3>Content</h3>

<table>
<tr><th>Shortcut</th><th>Function</th></tr>
<tr><td>Ctrl+N</td><td>Open the current page in a new window</td></tr>
<tr><td>Ctrl+F1</td><td>Display information about the current page or content</td></tr>
<tr><td>F3</td><td>Save the page source</td></tr>
<tr><td>Ctrl+F3</td><td>Save the page as text</td></tr>
<tr><td>Shift+F3</td><td>Full save of the web page, including images etc</td></tr>
<tr><td>Ctrl+Shift+F3</td><td>Save the page as a Drawfile</td></tr>
<tr><td>F8</td><td>View the page source code in a text editor</td></tr>
<tr><td>Print</td><td>Open the print dialogue box</td></tr>
</table>

<h3>Display</h3>

<table>
<tr><th>Shortcut</th><th>Function</th></tr>
<tr><td>Page Down</td><td>Scroll down by one page</td></tr>
<tr><td>Page Up</td><td>Scroll up by one page</td></tr>
<tr><td>Cursor Down</td><td>Scroll down one line</td></tr>
<tr><td>Ctrl+Cursor Down</td><td>Go to the bottom of the page</td></tr>
<tr><td>Cursor Up</td><td>Scroll up one line</td></tr>
<tr><td>Ctrl+Cursor Up</td><td>Go to the top of the page</td></tr>
<tr><td>F11</td><td>Open the scale view window</td></tr>
<tr><td>Ctrl+Q</td><td>Reduce scale of view</td></tr>
<tr><td>Ctrl+W</td><td>Increase scale of view</td></tr>
<tr><td>Ctrl+Shift+Q</td><td>Reduce scale of view by 10%</td></tr>
<tr><td>Ctrl+Shift+W</td><td>Increase scale of view by 10%</td></tr>
<tr><td>Shift+F11</td><td>View box outlines. This may be useful if you are creating your own web page. Cyan marks the content's edge, magenta marks the padding's edge and yellow marks the margin's edge.</td></tr>
</table>

<h3>Navigation</h3>

<table>
<tr><th>Shortcut</th><th>Function</th></tr>
<tr><td>F5</td><td>Reload the current page</td></tr>
<tr><td>Ctrl+F5, Ctrl+R</td><td>Reload the current page and any images and style sheets that the page uses</td></tr>
<tr><td>Esc</td><td>Stop the current page loading</td></tr>
</table>

<h3>General</h3>

<table>
<tr><td>F1</td><td>Open the <a href="/documentation/">documentation contents page</a> in a new window</td></tr>
<tr><td>F2</td><td>Move the caret to URL bar and clear it to &quot;www.&quot;</td></tr>
<tr><td>F4</td><td>Open the text search window</td></tr>
<tr><td>F6</td><td>Open the hotlist management window</td></tr>
<tr><td>F7</td><td>Open the local history window</td></tr>
<tr><td>Ctrl+F7</td><td>Open the global history window</td></tr>
<tr><td>Ctrl+F2</td><td>Close the window</td></tr>
</table>


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

</div>


<form method="get" action="//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>