File: browser-window.xml

package info (click to toggle)
galeon 2.0.2-4
  • links: PTS
  • area: main
  • in suites: etch, etch-m68k
  • size: 19,212 kB
  • ctags: 9,891
  • sloc: ansic: 77,793; cpp: 15,301; sh: 8,961; xml: 5,761; makefile: 888
file content (1012 lines) | stat: -rw-r--r-- 37,013 bytes parent folder | download | duplicates (4)
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
<!--
<!DOCTYPE Chapter PUBLIC "-//GNOME//DTD DocBook PNG Variant V1.1//EN">
-->

<chapter id="browser-window">
  <title>The Browser Window</title>
  <para>
    <application>Galeon</application>'s interface should be familiar to
    anyone who has used any popular Web browser like
    <application>Netscape</application> or
    <application>Mozilla</application>.  There is a menubar at the top of
    the window, a main toolbar below it, and a statusbar at the bottom of
    the window. There may also be other toolbars, created by the user for
    often used bookmarks, as described in <xref linkend="bookmarks-toolbars"/>.
  </para>

  <figure id="browser-window.png">
    <title>The Galeon Browser Window</title>
    <screenshot>
      <graphic fileref="figures/browser-window.png" format="PNG"></graphic>
    </screenshot>
  </figure>

  <sect1 id="navigation">
    <title>Basic Navigation</title>
      <para>
        As with any browser, the most common form of navigation is clicking
        on links.  Galeon also supports a number of other mouse interactions:
	<simplelist>
	  <member><guibutton>Shift+Left Click:</guibutton> Download link</member>
	  <member><guibutton>Middle Click:</guibutton> Open link in new tab, unless changed in 
	  preferences, see <xref linkend="prefs-mouse"/>
	  </member>
	  <member><guibutton>Shift+Middle Click:</guibutton> Open link in new window</member>
	  <member><guibutton>Right Click:</guibutton> Display context menu</member>
	</simplelist>
      </para>
  </sect1>

  <sect1 id="menubar">
    <title>Menus</title>
      <para>
	Depending on your window manager settings, there may be a small dashed
        line under each menu.  Clicking on this allows
	a menu to be detached from the menubar and to float above the browser
	window.
      </para>
  <sect2 id="menubar-file">
      <title>File Menu</title>
      <para>
	<variablelist>

	  <varlistentry>
	    <term><guimenuitem>New Window</guimenuitem></term>
	    <listitem><para>
	      Creates a new browser window and loads the home page into it.
	      Instructions for setting the home page are described in <xref
	      linkend="prefs-general"/>.
       	    </para></listitem>
	  </varlistentry>

	  <varlistentry>
	    <term><guimenuitem>New Tab</guimenuitem></term>
	    <listitem><para>
	      Creates a new notebook tab in the current browser window and
	      loads the home page into it.
       	    </para></listitem>
	  </varlistentry>

          <varlistentry>
            <term><guimenuitem>Open...</guimenuitem></term>
            <listitem><para>
	      Opens a local file.  A file selector window is opened,
	      allowing you to browse through the filesystem for the file
	      you'd like to open.
            </para></listitem>
          </varlistentry>

          <varlistentry>
            <term><guimenuitem>Save As...</guimenuitem></term>
            <listitem><para>
	      Saves a copy of the current page to disk.  A dialog window is
	      opened allowing you to choose the path and filename you'd
	      like to use.
            </para></listitem>
          </varlistentry>

          <varlistentry>
            <term><guimenuitem>Print...</guimenuitem></term>
            <listitem><para>
	      Prints the current page.  A dialog window is opened, allowing
	      you to specify various print-related settings.
            </para></listitem>
          </varlistentry>

          <varlistentry>
            <term><guimenuitem>Send Link To...</guimenuitem></term>
            <listitem><para>
              Creates an e-mail message referencing the current URL.
            </para></listitem>
          </varlistentry>

          <varlistentry>
            <term><guimenuitem>View Source</guimenuitem></term>
            <listitem><para>
              Shows the current source for the page
            </para></listitem>
          </varlistentry>

          <varlistentry>
            <term><guimenuitem>Properties</guimenuitem></term>
            <listitem><para>
              Shows a dialog containing the properties of the page (e.g. the
              size, images and links).
            </para></listitem>
          </varlistentry>


<!--
          <varlistentry>
            <term><guimenuitem>Save session as...</guimenuitem></term>
            <listitem><para>
	      Opens a dialog allowing you to save the current session to a
	      file.
            </para></listitem>
          </varlistentry>

          <varlistentry>
            <term><guimenuitem>Open session...</guimenuitem></term>
            <listitem><para>
	      Opens a dialog allowing you to choose a session to load.
            </para></listitem>
          </varlistentry>

          <varlistentry>
            <term><guimenuitem>[Listing of recently-opened
	      sessions]</guimenuitem></term>
            <listitem><para>
	      Recently-opened sessions are listed here.  Clicking one opens
	      it.
            </para></listitem>
          </varlistentry>
-->

          <varlistentry>
            <term><guimenuitem>Close</guimenuitem></term>
            <listitem><para>
	      If multiple tabs are open, the currently-selected tab is
	      closed.  If only one tab exists in the window, the window is
	      closed.  If this window is the only window opened, the
	      program will exit as well.
             </para></listitem>
           </varlistentry>

          <varlistentry>
            <term><guimenuitem>Quit</guimenuitem></term>
            <listitem><para>
              Closes all open browser windows and quits the program.
             </para><para>
              If the "Save session on quit" option is checked on the
              <link linkend="prefs-general">General Preferences page</link>,
              then a record of the sites you are currently viewing is saved.
	      The next time you run
	      <application>Galeon</application>, your session will be
	      restored automatically for you. All the windows and
	      tabs you have open will be reopened, and their contents will
	      be reloaded.
            </para></listitem>
          </varlistentry>

	</variablelist>
       </para>
    </sect2>

    <sect2 id="menubar-edit">
      <title>Edit Menu</title>
      <para>
	<variablelist>

          <varlistentry>
            <term><guimenuitem>Cut</guimenuitem></term>
            <listitem><para>
	      Copies the currently selected text to the clipboard, and
	      also deletes the original version of the text if it is in an
	      editable field.
            </para></listitem>
          </varlistentry>

          <varlistentry>
            <term><guimenuitem>Copy</guimenuitem></term>
            <listitem><para>
	      Copies the currently selected text to the clipboard.
            </para></listitem>
          </varlistentry>

          <varlistentry>
            <term><guimenuitem>Paste</guimenuitem></term>
            <listitem><para>
	      If an editable field is selected, any text stored by the
	      clipboard is pasted into it.
            </para></listitem>
          </varlistentry>

          <varlistentry>
            <term><guimenuitem>Select All</guimenuitem></term>
            <listitem><para>
             Selects all the text in the currently selected web page or
             edit box.
            </para></listitem>
          </varlistentry>

          <varlistentry>
            <term><guimenuitem>Find...</guimenuitem></term>
            <listitem><para>
              Opens a dialog box that allows you to search for a word
	      in the page being viewed. The find dialog is described in
              <xref linkend="find"/>.
            </para></listitem>
          </varlistentry>

          <varlistentry>
            <term><guimenuitem>Find Next</guimenuitem></term>
            <listitem><para>
              Repeats previous Find.
            </para></listitem>
          </varlistentry>

          <varlistentry>
            <term><guimenuitem>Find Previous</guimenuitem></term>
            <listitem><para>
              Repeats the previous Find (search backwards).
            </para></listitem>
          </varlistentry>

          <varlistentry>
            <term><guimenuitem>Personal Data</guimenuitem></term>
            <listitem><para>
              Opens the <link linkend="pdm">Personal data manager</link>.
            </para></listitem>
          </varlistentry>

          <varlistentry>
            <term><guimenuitem>Toolbar</guimenuitem></term>
            <listitem><para>
              Opens the <link linkend="toolbar-editor">toolbar editor</link>.
            </para></listitem>
          </varlistentry>

          <varlistentry>
            <term><guimenuitem>Preferences</guimenuitem></term>
            <listitem><para>
              Opens the <link linkend="preferences">Preferences dialog</link>.
            </para></listitem>
          </varlistentry>

	</variablelist>
      </para>
    </sect2>

    <sect2 id="menubar-view">
      <title>View Menu</title>
      <para>
	<variablelist>

          <varlistentry>
            <term><guimenuitem>Toolbar</guimenuitem></term>
            <listitem><para>
              Toggles the display of the main toolbar.
            </para></listitem>
          </varlistentry>

          <varlistentry>
            <term><guimenuitem>Bookmarks Toolbars</guimenuitem></term>
            <listitem><para>
              Toggles the display of the bookmark toolbars.
            </para></listitem>
          </varlistentry>

          <varlistentry>
            <term><guimenuitem>Statusbar</guimenuitem></term>
            <listitem><para>
              Toggles the display of the statusbar.
            </para></listitem>
          </varlistentry>

          <varlistentry>
            <term><guimenuitem>Side Pane</guimenuitem></term>
            <listitem><para>
              Toggles the display of a side pane, where you can show the
              browser history, the bookmarks, or any Sidebars added from 
              web pages.
            </para></listitem>
          </varlistentry>

          <varlistentry>
            <term><guimenuitem>Fullscreen</guimenuitem></term>
            <listitem><para>
              Toggles full screen mode, which is described in more detail
	      in <xref linkend="full-screen-mode"/>.
	     </para></listitem>
          </varlistentry>

	  <varlistentry>
	    <term><guimenuitem>Images</guimenuitem></term>
	    <listitem><para>
              Allows toggling the preference to show images from the
              current server, always, or never. 
             </para><para>
             You set the policy for showing images for the current server.
	    </para></listitem>
	  </varlistentry>


	  <varlistentry>
	    <term><guimenuitem>Encoding</guimenuitem></term>
	    <listitem><para>
	      Sets the character set used to display the page, bypassing
	      <application>Mozilla</application>'s autodetection.
	    </para></listitem>
	  </varlistentry>

          <varlistentry>
            <term><guimenuitem>Styles</guimenuitem></term>
            <listitem><para>
	      Allows you to choose between using the current page's default
	      stylesheet, no stylesheet, or any alternate stylesheets that
	      may be defined by the page.
            </para></listitem>
          </varlistentry>

        <varlistentry>
    	  <term><guimenuitem>Zoom In</guimenuitem></term>
          <listitem><para>
 	    Increases the sizes of the fonts on the page.
	  </para></listitem>
	</varlistentry>

        <varlistentry>
    	  <term><guimenuitem>Zoom Out</guimenuitem></term>
          <listitem><para>
       	    Decreases the sizes of the fonts on the page.
	  </para></listitem>
	</varlistentry>

        <varlistentry>
          <term><guimenuitem>Normal Size</guimenuitem></term>
          <listitem><para>
	    Resets the sizes of the fonts on the page to their
	    defaults.
	  </para></listitem>
	</varlistentry>


          <varlistentry>
            <term><guimenuitem>Stop</guimenuitem></term>
            <listitem><para>
              Stops the current page load
            </para></listitem>
          </varlistentry>
          <varlistentry>
            <term><guimenuitem>Reload</guimenuitem></term>
            <listitem><para>
              Reloads the current page.
            </para></listitem>
          </varlistentry>

	</variablelist>
       </para>
    </sect2>

    <sect2 id="menubar-web">
      <title>Web Menu</title>
      <para>
  	The web menu offers quick access to some commonly used settings.
	<variablelist>

          <varlistentry>
            <term><guimenuitem>Cookies</guimenuitem></term>
            <listitem>
	    <para>
	      Cookie permissions can be set on a per-site basis from
	      this menu.  <guilabel>Allow cookies from this site</guilabel>
	      allows the currently loaded site to store cookies on your
	      computer.  <guilabel>Block cookies from this site</guilabel>
	      will prevent the currently loaded site from storing any
	      cookies on your computer.
             </para>
             <para>To view the current settings for all the sites, use the
             <link linkend="pdm-cookies">Cookie page</link> of the Personal 
             Data Manager.
            </para>
	    </listitem>
          </varlistentry>

          <varlistentry>
            <term><guimenuitem>Popups</guimenuitem></term>
            <listitem>
	    <para>
              Unrequested popup windows can be enabled for this site, or
              globally using the options on this submenu.
            </para>
	    </listitem>
          </varlistentry>

          <varlistentry>
            <term><guimenuitem>Allow Java</guimenuitem></term>
            <listitem><para>
               Allows Java code to be executed.  This has an effect only
	       if a Java plugin has been installed. 
               <!-- FIXME: add xref -->
             </para></listitem>
          </varlistentry>

          <varlistentry>
            <term><guimenuitem>Allow JavaScript</guimenuitem></term>
            <listitem><para>
              Allows JavaScript code to be executed.
            </para></listitem>
          </varlistentry>

          <varlistentry>
            <term><guimenuitem>Java Console...</guimenuitem></term>
            <listitem><para>
	      Opens a new window allowing you to read Java-related messages
	      that are emitted.
            </para></listitem>
          </varlistentry>

          <varlistentry>
            <term><guimenuitem>Javascript Console...</guimenuitem></term>
            <listitem><para>
	      Opens a new window allowing you to read Javascript-related
	      messages that are emitted.
            </para></listitem>
          </varlistentry>

	</variablelist>
      </para>
    </sect2>

    <sect2 id="menubar-go">
      <title>Go Menu</title>
      <para>
	The first six items in this menu, <guimenuitem>Back</guimenuitem>,
	<guimenuitem>Forward</guimenuitem>, <guimenuitem>Up</guimenuitem>,
	<guimenuitem>Home page</guimenuitem>, are simply
	copies of the corresponding toolbar buttons, which are described in
	<xref linkend="toolbar"/>.
      </para>
       <para>
        Other entries in the Go menu are:
       </para>

       <para>
	<variablelist>
          <varlistentry>
            <term><guimenuitem>History...</guimenuitem></term>
            <listitem><para>
	      Shows the history window or dock, which contains a list of
	      all previously visited locations.  You can learn more about
	      the dialog in <xref linkend="history"/>.
            </para></listitem>
          </varlistentry>

          <varlistentry>
            <term><guimenuitem>My Portal</guimenuitem></term>
            <listitem><para>
              Open the "My portal" page
            </para></listitem>
          </varlistentry>

          <varlistentry>
            <term><guimenuitem>Location</guimenuitem></term>
            <listitem><para>
               Highlight the "Location" entry
            </para></listitem>
          </varlistentry>

        </variablelist>
      </para>

      <para>
	At the bottom of the menu is a dynamically generated list of links to
	pages that have been recently visited in this window.
      </para>
    </sect2>

    <sect2 id="menubar-bookmarks">
      <title>Bookmarks Menu</title>
      <para>
	<variablelist>

          <varlistentry>
            <term><guimenuitem>Add Bookmark...</guimenuitem></term>
            <listitem><para>
              Creates a new bookmark from the current web page. A dialog
              will open allowing selection of the location to place the new
              bookmark.
            </para></listitem>
          </varlistentry>

          <varlistentry>
            <term><guimenuitem>Add Tabs as Folder...</guimenuitem></term>
            <listitem><para>
              Creates a new folder of bookmarks, containing all the tabs in
              the current window. A dialog
              will open allowing selection of the location to place the new
              folder.
            </para></listitem>
          </varlistentry>

          <varlistentry>
            <term><guimenuitem>Edit Bookmarks...</guimenuitem></term>
            <listitem><para>
              Opens the <link linkend="bookmarks-editor">
	      bookmarks editor</link>.
            </para></listitem>
          </varlistentry>

	</variablelist>
	The bottom portion of the menu consists of a listing of all of your
	bookmarks.
       </para>
    </sect2>

    <sect2 id="menubar-tab">
      <title>Tab Menu</title>
      <para>
	<variablelist>
          <varlistentry>
            <term><guimenuitem>Previous tab</guimenuitem></term>
            <listitem><para>
	      Selects the previous tab.
            </para></listitem>
          </varlistentry>

          <varlistentry>
            <term><guimenuitem>Next tab</guimenuitem></term>
            <listitem><para>
	      Selects the next tab.
            </para></listitem>
          </varlistentry>

          <varlistentry>
            <term><guimenuitem>Move tab left</guimenuitem></term>
            <listitem><para>
	      Moves the currently-selected tab to the previous position in
	      the notebook.
            </para></listitem>
          </varlistentry>

          <varlistentry>
            <term><guimenuitem>Move tab right</guimenuitem></term>
            <listitem><para>
	      Moves the currently-selected tab to the next position in the
	      notebook.
            </para></listitem>
          </varlistentry>

          <varlistentry>
            <term><guimenuitem>Move tab to another
	      window</guimenuitem></term>
            <listitem><para>
	      Clicking on one of the windows listed in this submenu
	      detaches the currently-selected tab and moves it to that
	      window.
            </para></listitem>
          </varlistentry>

          <varlistentry>
            <term><guimenuitem>Clone tab</guimenuitem></term>
            <listitem><para>
	      Creates a copy of the current tab.
            </para></listitem>
          </varlistentry>

          <varlistentry>
            <term><guimenuitem>Detach tab</guimenuitem></term>
            <listitem><para>
	      Detaches the currently-selected tab, placing it in a new
	      window.
            </para></listitem>
          </varlistentry>

	</variablelist>
      </para>
    </sect2>

    <sect2 id="menubar-help">
      <title>Help Menu</title>
      <para>
	<variablelist>

          <varlistentry>
            <term><guimenuitem>Help</guimenuitem></term>
            <listitem><para>
              Displays this manual.
            </para></listitem>
          </varlistentry>

          <varlistentry>
            <term><guimenuitem>About Plugins</guimenuitem></term>
            <listitem><para>
	      Opens a page in the current window displaying information
	      about the plugins that <application>Galeon</application> has
	      been configured to use.
            </para></listitem>
          </varlistentry>

          <varlistentry>
            <term><guimenuitem>About...</guimenuitem></term>
            <listitem><para>
	      Displays a window containing information about
	      <application>Galeon</application>.
            </para></listitem>
          </varlistentry>

	</variablelist>
       </para>
    </sect2>

  </sect1>

  <sect1 id="toolbar">
    <title>The Main Toolbar</title>
    <para>
      The main toolbar contains controls that let you use
      <application>Galeon</application> to browse the Web more efficiently.
      <figure id="toolbars-main.png">
        <title>The Main Toolbar</title>
        <screenshot>
          <graphic fileref="figures/toolbars-main.png" format="PNG"></graphic>
        </screenshot>
      </figure>
      You can enable, disable, or rearrange the order of the items
      appearing in the toolbar.  These and other related options are
      described in <xref linkend="toolbar-editor"/>.
      An alphabetical listing of the
      controls, along with brief descriptions of their functions, follows.

      <variablelist>

        <varlistentry>
          <term><guibutton>Back</guibutton> button</term>
          <listitem><para>
	    Clicking the <guibutton>Back</guibutton> button will go back to
	    the previous page in the browser's history.  To get a list of
	    pages in the browser's back history, press and hold the right
	    mouse button when the mouse pointer is over the button.
          </para></listitem>
        </varlistentry>

        <varlistentry>
          <term><guibutton>Back History</guibutton> button</term>
          <listitem><para>
	    Clicking the <guibutton>Back history</guibutton> button
	    displays a menu listing the pages in the browser's back
	    history.  The menu is identical to the one that is displayed
	    when right-clicking the <guibutton>Back</guibutton> button.
          </para></listitem>
        </varlistentry>

        <varlistentry>
          <term><guibutton>Drag handle</guibutton> icon</term>
          <listitem><para>
	    <application>Galeon</application> supports Drag and Drop (DnD)
	    extensively.  Pressing and holding the left mouse button on the
	    <guibutton>Link drag</guibutton> icon (blue globe with a red
	    arrow) allows you to drag a copy of the URL to your desktop, a
	    terminal window, the bookmarks editor or temporary bookmarks
	    window, another <application>Galeon</application> window (or
	    tab label in tabbed mode), or any other DnD enabled
	    application. You can also drag links directly from web pages.
          </para></listitem>
        </varlistentry>

        <varlistentry>
          <term><guibutton>Forward</guibutton> button</term>
          <listitem><para>
	    Clicking the <guibutton>Forward</guibutton> button will go
	    forward to the next page in the browser's history.  To get a
	    list of pages in the browser's forward history, press and hold
	    the right mouse button when the mouse pointer is over the
	    button.
          </para></listitem>
        </varlistentry>

        <varlistentry>
          <term><guibutton>Forward History</guibutton> button</term>
          <listitem><para>
	    Clicking the <guibutton>Forward history</guibutton> button
	    displays a menu listing the pages in the browser's forward
	    history.  The menu is identical to the one that is displayed
	    when right-clicking the <guibutton>Forward</guibutton> button.
          </para></listitem>
        </varlistentry>

        <varlistentry>
          <term><guibutton>Go</guibutton> button</term>
          <listitem><para>
	    Clicking the <guibutton>Go</guibutton> button will load
	    whatever location is currently in the location bar.  Clicking
	    the button with the middle mouse button will load the page in a
	    new window or tab, useful for cloning the current browser.
          </para></listitem>
        </varlistentry>

        <varlistentry>
          <term><guibutton>Home</guibutton> button</term>
          <listitem><para>
	    Clicking the <guibutton>Home</guibutton> button will load your
	    home page, which can be set as described in <xref
	    linkend="prefs-general"/>.  Clicking the button with
	    the middle mouse button will load your home page in a new
	    window or tab.
          </para></listitem>
        </varlistentry>

        <varlistentry>
          <term><guibutton>Location</guibutton> entry</term>
          <listitem><para>
	    The <guibutton>Location</guibutton> entry is where you enter
	    URLs that you want to visit.  Once you have typed an address
	    into the entry, pressing <keycap>Enter</keycap> or clicking on
	    the <guibutton>Go</guibutton> button will load the page.
          </para><para>
	    The <guibutton>Location</guibutton> entry also keeps a history
	    of previous addresses that were typed into it. Pressing the
	    arrow button will display a list of recently typed URLs.  If
	    the <guibutton>Go</guibutton> button is turned on, clicking on
	    an item in this list will replace the contents of the entry bar
	    but will not load the page. If the <guibutton>Go</guibutton>
	    button is turned off, the page will automatically be loaded.
          </para><para>
	    Finally, the location entry supports autocompletion. Once you
	    start typing in the location bar, your history will be searched
	    and the first possible match will be displayed.  If this is not
	    the URL you had in mind, continue typing or hit the
	    <keycap>Tab</keycap> key.  If you hit the <keycap>Tab</keycap>
	    key, a list of all possible matches will be display below the
	    location bar.  Click on an item or use the up/down arrow keys
	    and press <keycap>Enter</keycap> to load the desired URL. 
          </para></listitem>
        </varlistentry>

        <varlistentry>
          <term><guibutton>New</guibutton> button</term>
          <listitem><para>
	    Clicking the <guibutton>New</guibutton> button will open a
	    either a new window or a new tab, depending on the value of the
	    <guilabel>Open in tabs by default</guilabel> setting on the
	    <link linkend="prefs-tabs">Tabs page of the
	    Preferences window</link>.  To choose whether the new browser
	    should be in a window or a tab, press and hold the right mouse
	    button when the mouse pointer is over the button and select the
	    appropriate item from the menu that results.
          </para></listitem>
        </varlistentry>
<!--
        <varlistentry>
          <term><guibutton>Print</guibutton> button</term>
          <listitem><para>
	    Pressing the <guibutton>Print</guibutton> button displays the
	    Print dialog, allowing you to print the current page.
          </para></listitem>
        </varlistentry>
-->
        <varlistentry>
          <term><guibutton>Reload</guibutton> button</term>
          <listitem><para>
	    Clicking the <guibutton>Reload</guibutton> button will reload
	    the page that is currently being viewed.
          </para></listitem>
        </varlistentry>

        <varlistentry>
          <term><guibutton>Spinner</guibutton></term>
          <listitem><para>
	    The <guibutton>Spinner</guibutton> is the <application>Galeon
	    </application> equivalent of the "throbber" in
	    <application>Netscape</application> or <application>Mozilla
	    </application>.  During a page load, the spinner plays back an
	    animation. Clicking on the spinner will take you to the Galeon
	    homepage.  The animation shown is taken from the current GNOME
            icon theme, which you can change from the <application>GNOME
            Control Center</application>.
	  </para></listitem>
        </varlistentry>

        <varlistentry>
          <term><guibutton>Stop</guibutton> button</term>
          <listitem><para>
	    Pressing the <guibutton>Stop</guibutton> button immediately
	    stops the loading of the current page.
          </para></listitem>
        </varlistentry>

        <varlistentry>
          <term><guibutton>Up</guibutton> button</term>
          <listitem><para>
	    Clicking the <guibutton>Up</guibutton> button will load the
	    page in the next-highest directory of the current URL.  For
	    example, pressing the button while at
	    <literal>http://www.example.com/a/b/</literal> would cause the
	    URL <literal>http://www.example.com/a/</literal> to be loaded.
          </para></listitem>
        </varlistentry>

        <varlistentry>
          <term><guibutton>Zoom control</guibutton> spinbutton</term>
          <listitem><para>
	    The <guibutton>Zoom control</guibutton> spinbutton allows you
	    to easily change the size of the fonts on the page being
	    viewed.  Pressing the up arrow will increase the size of the
	    fonts on the page, while pressing the down arrow will decrease
	    the size of the fonts on the page.  Additionally, you can set
	    the zoom to an arbitrary number by typing in the entry field.
          </para></listitem>
        </varlistentry>

      </variablelist>
    </para>
  </sect1>

  <sect1 id="statusbar">
  <title>The Statusbar</title>
    <para>
      The statusbar at the bottom of the window displays messages relating
      to network activity, and also contains a meter showing the progress
      of the page currently being loaded and a security icon.  When the
      cursor is over a link, the statusbar shows the target of the link.
      Some pages contain JavaScript code that writes messages into the
      statusbar. 
    </para>
      <figure id="statusbar.png">
        <title>The Statusbar</title>
        <screenshot>
          <graphic fileref="figures/statusbar.png" format="PNG"></graphic>
        </screenshot>
      </figure>


    <sect2 id="statusbar-padlock">
      <title>Padlock icon</title>
      <para>
        When viewing web pages, <application>Galeon</application>
        displays a lock icon in the status bar
        which shows you whether the current site is secure. Clicking the 
        lock icon will open the "Security" tab of the page properties dialog.
      </para>
      <variablelist>
        <varlistentry>
          <term>An unlocked padlock</term>
          <listitem>
            <para>
              Indicates that this site is insecure. It is
              possible for eavesdroppers to see sensitive information
              (such as addresses or credit card numbers) in transit
            </para>
          </listitem>
        </varlistentry>
        <varlistentry>
          <term>A locked padlock</term>
          <listitem>
            <para>
              Indicates that this site is secure, information sent
              to the server is encrypted.
            </para>
          </listitem>
        </varlistentry>
<!--
        <varlistentry>
          <term>A broken padlock</term>
          <listitem>
            <para>
              Indicates that some parts of this page are secure, and others
              are not.
            </para>
          </listitem>
        </varlistentry>
-->
      </variablelist>
    </sect2>

   <sect2 id="statusbar-popup">
    <title>Popup blocking</title>
    <para>
      If a popup window was blocked, a little "popup blocked" icon will appear to
      the left of the padlock. If you click the icon, you will be able to add
      the site to the list of sites that can open popup windows.
    </para>
    <para>
      You can view the list of sites that can open popup window in the
      <link linkend="pdm-popup-sites">Popup section</link> of the Personal
      Data manager. The setting for the current site can be altered using the
     <menuchoice><guimenu>Web</guimenu><guisubmenu>Popups</guisubmenu></menuchoice>
      menu options.
    </para>
  </sect2>
  </sect1>

  <sect1 id="tabbed-browsing">
  <title>Tabbed Browsing</title>
    <para>
      <application>Galeon</application>'s "tabbed browsing" feature can
      help you avoid cluttering your desktop with browser windows.
      Multiple pages can be stored in a single
      <application>Galeon</application> window, and you can switch between
      them with a click of the mouse.  The behavior of the tabbed browsing
      mode can be configured in the <link
      linkend="prefs-tabs">"Tabs" page of the Preferences
      Window</link>.
    </para>
    <figure id="tabbed-browsing.png">
      <title>Tabbed Browsing in Galeon</title>
      <screenshot>
        <graphic fileref="figures/tabbed-browsing.png" format="PNG"></graphic>
      </screenshot>
    </figure>
    <para>
      To start using tabs, either create a new tab through the <link
      linkend="menubar-file"><guimenu>File menu</guimenu></link> or open a
      link in a new tab by right-clicking it and choosing the
      <guimenuitem>Open in a new tab</guimenuitem> item from the context
      menu.  By default, a tab listing will appear below the toolbar at the
      top of the window.  You can also drag links onto a tab to have that
      link loaded in a particular tabbed window. This is handy if you want
      to load a page in a different tab than the one you are currently
      viewing but don't necessarily want to open a new tab.
    </para>
    <para>
      You can switch to different pages by clicking on their corresponding
      tabs.  When the tab listing becomes too long to fit in the window,
      arrows will appear at its right, allowing you to scroll through the
      listing.  Additionally, right-clicking on a tab will display a menu
      containing all of the tabs.  The <guimenuitem>Previous
      tab</guimenuitem> and <guimenuitem>Next tab</guimenuitem> menu items
      in the <link linkend="menubar-tab"><guimenu>Tab menu</guimenu></link>
      allow you to jump to the previous or next tab in the listing.
      Finally, you can jump directly to a tab by typing <keycombo>
      <keycap>Alt</keycap><keycap>[0-9]</keycap> </keycombo> where 1 is the
      first page and 0 is the tenth page.
    </para>
    <para>
      You can close tabs either by making them active and then using the
      <guimenuitem>Close</guimenuitem> item from the <link
      linkend="menubar-file"><guimenu>File menu</guimenu></link>, or by
      clicking the small "X" button that appears at the
      right edge of each tab.
    </para>
    <para>
    <!--
      Tabs can also be moved, either to different positions in the listing
      or to different windows altogether.  The easiest way to do this is by
      holding the left mouse button down on a tab and dragging it either to
      another tab or to another window.  Alternately, you can use the
      <guimenuitem>Move tab left / up</guimenuitem> and <guimenuitem>Move
      tab right / down</guimenuitem> menu items in the <link
      linkend="menubar-tab"><guimenu>Tab menu</guimenu></link> to shift a
      tab within its current tab listing.  The <guimenuitem>Detach
      tab</guimenuitem> item will move the currently selected tab into a
      new window.
      -->
      Tabs can also be moved, either to different positions in the listing
      or to different windows altogether, by use of the items in the <link
      linkend="menubar-tab"><guimenu>Tab menu</guimenu></link>.
    </para>
  </sect1>

  <sect1 id="full-screen-mode">
  <title>Full Screen Mode</title>
    <para>
      Browsing in full screen mode can be very handy if you're running at a
      low resolution and find it difficult to fit the contents of pages in
      <application>Galeon</application>'s window.
    </para>
    <para>
      When you enable this option, through the <guimenu>View</guimenu> menu
      (described in <xref linkend="menubar-view"/>) or by hitting the
      <keycap>F11</keycap> key, the window will be expanded to fill the
      entire screen and the visibility of the menubar, toolbars, and
      statusbar will be toggled off.  Full screen mode can be toggled off in the same
      ways that can be used to toggle it on.
</para>
<!--
   <para>
     The visibility of these components of
      the interface can be enabled again by typing the appropriate
      shortcuts:
      <keycombo><keycap>Shift</keycap><keycap>Ctrl</keycap><keycap>M</keycap></keycombo> for the
      menubar, <keycombo><keycap>Shift</keycap><keycap>Ctrl</keycap><keycap>T</keycap></keycombo>
      for the toolbars, and
      <keycombo><keycap>Shift</keycap><keycap>Ctrl</keycap><keycap>S</keycap></keycombo>
      for the statusbar.  
       <tip>
          <title>Tip</title>
	  <para>
	    It's possible to browse in full screen mode with the menubar,
	    toolbars, and status bar turned off.  Navigation controls are
	    available from the context menu or through keyboard shortcuts,
	    and a bookmark listing can be displayed by clicking the
	    <mousebutton>middle</mousebutton> mouse button.  To enter a new
	    URL, just hit
	    <keycombo><keycap>Ctrl</keycap><keycap>O</keycap></keycombo> to
	    display the dialog box.
	  </para>
       </tip>
     </para>
-->
  </sect1>

</chapter>