IBrowse² Documentation

Last Updated: 29th June 2003

<< Menus Chapter

Contents Chapter

Drag & Drop Chapter >>


	Section Quicklinks Browser History Search Current Webpage Print Manager Source Hotlist Manager Info Window Netstat Manager URL Clipboard Manager Global History Window Cookie Manager Download Manager Cache Explorer Password Manager Settings Authentication Requester Cookie Requester E-mail Composer Specify Title Specify action for Export CA certificate Password

IBrowse² contains many windows and requesters, some of which may only be seen during certain situations. Whilst most are straightforward to use, some require a more detailed description in order for you to get the most from IBrowse². This section gathers all of these windows and requesters, to document them in one place for your convenience. Each description will inform you how the window or requester can be opened, or when it will open for those that are triggered automatically, followed by a breakdown of the options available.

The Browser History window is opened via the Menus » Navigation » View browser history... entry. Each browser within IBrowse² has its own history of web sites visited during the current browsing session. By opening this window, you can review the history for that particular browser. If you have several browsers open in IBrowse², you can click on any of the browser tabs while the Browser History window is open, to view the history for that browser - the data in the Browser History window will automatically refresh for you. Although the Browser History is browser dependent, it is also attached to each main IBrowse² window, therefore if you have three IBrowse² windows open (each with several browser tabs), then you will need to open a new Browser History window for each of the main IBrowse² windows in order to view the history for each.

The list itself consists of two columns, Title and Location. Title is set to the name of the web page as set in the <title> tag, and the Location is set to the URL for that particular web page. Single clicking on one of the entries in the Browser History window, will load that URL into the browser, allowing you to quickly navigate through your browser history.

The history in the Browser History window is lost when the browser, main IBrowse² window(s), or IBrowse² itself is closed or exited.

The Search Current Webpage window is opened via the Menus » Webpage » Search... entry. This will open a small window with several options, which you can use to define your search criteria:
Ignore upper/lower case Enabling this option will make the search IBrowse² performs case insensitive. This means that IBrowse² will match on the words you search for whether they are all lowercase, all uppercase or mixed case.
e.g.	a search for IBrowse with this option enabled, would match IBrowse, IBROWSE, ibrowse, iBrowse, IbRoWsE etc. If this option were disabled, you would have to enter the text exactly as you want to match against, i.e. to search for IBrowse you would have to enter the text in that exact format.
Search for This gadget is used to enter the string that you would like to match within the current web page.
Search This gadget will cause IBrowse² to perform the search from the top of the current web page the first time it is used. If a word is matched, it will then be highlighted, and clicking this gadget a second time will cause IBrowse² to continue searching from the last position matched. Again, IBrowse² will highlight the next occurrence of the word, if there is one. This process can be repeated until the end of the web page is reached.
From top This gadget will cause IBrowse² to perform the search from the top of the current web page every time it is used, no matter where the current position may be within the text.
Backwards This gadget will cause IBrowse² to perform the search from the bottom of the current web page, backwards through the text the first time it is used. If a word is matched, it will then be highlighted, and clicking this gadget a second time will cause IBrowse² to continue searching backwards from the last position matched. Again, IBrowse² will highlight the next occurrence of the word, if there is one. This process can be repeated until the start of the web page is reached.
Cancel This gadget will cause IBrowse² to cancel searching and exit the Search current webpage window.

The Print Manager window is opened via the Menus » Webpage » Print... menu entry. The window itself contains the preferences for setting up your printer and how you would like to output your file. The options available to you are:

Print mode
This gadget is used to set the method of printing to use. Three different methods are available to choose from:

Text only
This option will cause IBrowse² to print the current web page as simple plain text. No layouting or formatting is performed, IBrowse² will just move from left to right printing any plain text and ignoring everything else.

Graphical
This option has no function in this release of IBrowse².

PostScript
This option will cause IBrowse² to print the current web page "WYSIWYG" (What You See Is What You Get) using the PostScript language.

Destination
This gadget is used to set the destination that IBrowse² should send the output to. Five different destinations are available to choose from:

Printer This option will cause the output to be sent to the printer.
File This option will cause the output to be written to the file specified in the string gadget adjacent to this option.
PAR: This option will cause the output to be sent to PAR:. You should use this option if your printer is connected to the parallel port and you want to bypass the AmigaOS® printer interface.
e.g.	Sending PostScript output directly to a PostScript printer.
SER: This option will cause the output to be sent to SER:. You should use this option if your printer is connected to the serial port and you want to bypass the AmigaOS® printer interface.
e.g.	Sending PostScript output directly to a PostScript printer.
Custom This option will cause the output to be written to the destination specified in the string gadget adjacent to this option.
e.g.	You can enter PS: here to use TurboPrint 7s PostScript printing facility.

Printer
These options have no function in this release of IBrowse².

Graphics
These options have no function in this release of IBrowse².

Pages
These options give you some control over how to output the web page.

Print page x to x
These gadgets are used to specify the range of pages you would like to print. The values of these are not automatically filled in due to the length of a page depending on a variety of other settings. To print the entire of the web page, leave both values blank.

Copies
This gadget is used to specify the number of copies you would like IBrowse² to print.

Print last page first
Enabling this gadget will cause IBrowse² to print the current webpage in reverse, starting with the last page and finishing with the first.

Scale
This option has no function in this release of IBrowse².

Header/Footer
These options allow you to specify the information that will be printed within each pages header and footer.

Header
This gadget is used to specify the information that will be printed within the page header. You can enter any custom string, which may include none, some or all of the following arguments:

%u	This will be the full URL of the current web page.
%f	This will be the filename of the remote web page, minus the path.
%p	This will be the number of the current page of the print run.
%#	This will be the total number of pages in the print run.
%t	This will be the title of the web page as defined by the <title> tag.
%c	This will be the current time of your system.
%d	This will be the current date of your system.
e.g.	%u = http://www.somesite.com/somepage.html %f = somepage.html

The following justification codes are also available for you to use to justify the text in the header:

\l	This will make the text immediately after left justified.
\c	This will make the text immediately after center justified.
\r	This will make the text immediately after right justified.

Footer
This gadget is used to specify the information that will be printed within the page footer. You can enter any custom string, which may include none, some or all of the following arguments:

%u	This will be the full URL of the current web page.
%f	This will be the filename of the remote web page, minus the path.
%p	This will be the number of the current page of the print run.
%#	This will be the total number of pages in the print run.
%t	This will be the title of the web page as defined by the <title> tag.
%c	This will be the current time of your system.
%d	This will be the current date of your system.
e.g.	%u = http://www.somesite.com/somepage.html %f = somepage.html

The following justification codes are also available for you to use to justify the text in the footer:

\l	This will make the text immediately after left justified.
\c	This will make the text immediately after center justified.
\r	This will make the text immediately after right justified.

Printer prefs
This gadget will load the AmigaOS® printer preferences located in SYS:Prefs/Printer.

PrinterGFX prefs
This gadget will load the AmigaOS® printer graphics preferences located in SYS:Prefs/PrinterGFX.

PrinterPS prefs
This gadget will load the AmigaOS® printer PostScript preferences located in SYS:Prefs/PrinterPS.

Print
This gadget will send the web page to the destination you have chosen in Destination, and commence printing. A progress bar will appear displaying the current page being printed and the number of pages to be printed in total.

It is not possible to cancel a print via IBrowse² once it has started.

Cancel
This gadget will cancel any changes, and close the Print Manager.

The Print Manager also has the following options via the menus:

Project
This menu contains all of the Project related menu options for controlling the settings.

Reset settings (RAmiga+E)
This menu entry will reset the Print Manager settings to the default IBrowse² settings.

Restore settings (RAmiga+R)
This menu entry will restore the Print Manager settings to the current settings when the window was first opened. Use this to cancel any changes you have made since you last modified the settings.

Save settings (RAmiga+S)
This menu entry will save the current Print Manager settings to your hard disk.

For further information on setting up IBrowse², TurboPrint 7, Ghostscript & AmigaOS® to produce better printouts, please refer to the Printing chapter.

The Source window is opened via the Menus » Webpage » Display source... menu entry. The window that IBrowse² opens contains the source code for the currently displayed web page. If Preferences » General » Editable source window is enabled, you can use this window to edit the source of the web page, updating the local memory cached version to quickly overcome silly errors (such as providing black text on a black background), or to save the changes permanently if the source being viewed is a local file. Disabling the option will provide a read-only window, but with the option enabled, the following gadgets will be available:

Reset
This gadget will cause IBrowse² to loose the changes you have made to the source of the web page, reverting to the original source used by the web page author. This will loose all changes made to the original source, it is not just a simple undo.

e.g. If you have edited some source to change the text colour, then click Update to apply the changes, then view the source and change the background colour, then click Reset, it will loose the changes to the background colour and the text colour, not just the changes made to the background colour.

Update
This gadget will cause IBrowse² to apply the changes you have made to the source of the current web page, updating the display in the browser. The window will remain open for additional editing until you close it via the close gadget.

Save
This gadget will cause IBrowse² to save the changes you have made to the source of the web page, to the actual source file on your hard disk. This option is only available when viewing the source of a local file opened via the Menus » Project » Open local file... menu entry, or by typing directly into the Location gadget.

E
This gadget will cause IBrowse² to open an external editor, with the source for the current web page preloaded. Saving the changes in the external editor will update the Source window, allowing you to then Update the source, or Reset to the original.

IBrowse² uses the EDITOR environment variable to determine the external editor. To configure your external viewer, enter the following into a Shell/CLI prompt:

For AmigaOS® 3.5 or below:


setenv EDITOR path:to/your/external/editor


copy ENV:EDITOR to ENVARC:

For AmigaOS® 3.9 or above:


setenv SAVE EDITOR path:to/your/external/editor

Please refer to the AmigaOS® 3.9+ documentation for information on the new setenv command.

The Hotlist Manager is opened via the Menus » Bookmarks » View bookmarks... menu entry, or the Open Bookmarks Button, when Preferences » General » Use Contact Manager for bookmarks is disabled. If this option is enabled, Contact Manger will open when selecting this option. Please refer to the documentation provided with Contact Manager for further information on how to use it.

The Hotlist Manager is the IBrowse² native bookmark manager. The window consists of a list of available bookmarks, which can be grouped together or individually listed, and a set of controls to manage and configure existing or new entries.

The list itself is split into three columns, Title, Alias and Location, and is fully Drag & Drop compatible, allowing easy re-organisation of the list. When adding a bookmark via Menus » Bookmarks » Add bookmark or the Add Bookmark Button, the Title will be set to that of the web page as specified in the <title> tag, and the Location is set to the URL for that particular web page. Alias will be left blank until it is edited using the options below.

When adding a bookmark manually, or editing an existing entry, the following options are available to you:

Add group
This gadget is used to add a new URL group to the Hotlist Manager. A group is simply an entry with a name, that can be used to store other bookmarks under, thus grouping them together.

e.g.

News could be a group name, where you then stored bookmarks to the BBC, CNN etc. news websites. When Hotlist Manager » Show in Bookmarks menu is enabled for a group, it will appear as a submenu in the Bookmarks menu.

Add link
This gadget is used to add a new entry to the Hotlist Manager manually. Adding a new entry will automatically set the Title to (Untitled) and leave all the other gadgets empty or disabled, ready for you to configure using the options below.

Remove
This gadget is used to remove the currently highlighted link or group from the Hotlist Manager.

Title
This gadget is used to set the title of the entry in the Hotlist Manager, and in the Bookmarks menu if Hotlist Manager » Show in Bookmarks menu is enabled. It is only used for display purposes, so editing an existing entry will not affect the actual title of the web page when you visit.

Alias
This gadget is used to set a unique alias for this entry, which can be typed into the Location gadget in order to load the web page, without needing to select the entry from the Hotlist Manager or Bookmarks menu.

Care should be taken when entering the alias to ensure that it is not duplicated elsewhere in the Hotlist Manager. If a duplicate is found, the first entry in the Hotlist Manager will take priority over the other occurrences.

Location
This gadget is used to specify the URL that IBrowse² will load when the entry is selected from the Hotlist Manager or Bookmarks menu.

Show in Bookmarks menu
Enabling this option will cause IBrowse² to list the entry in the Bookmarks menu below the Menus » Bookmarks » View bookmarks... entry. Both groups and single entries can be shown, thus reproducing the Hotlist Manager in the bookmarks menu.

AmigaOS® has a number of limitations regarding menus, and IBrowse² obviously suffers from those. Only 60 entries can be shown in the Bookmarks menu, as IBrowse² itself uses the remaining 3. Of those 60, any number can be a sub-menu, but each sub-menu is limited to a single level, so you will notice that this option is not available for nested groups or entries past the first level. Additionally, only 31 items are allowed in each sub-menu, so the first 31 entries with this option enabled will be shown, with the remaining entries truncated from the list.

Barlabel
Enabling this option will cause IBrowse² to turn this entry into a barlabel, which is often used to separate sections of the menu. An example of this can be seen under the Menus » Project » Open local file... menu entry. A barlabel that is shown in the Bookmarks menu using the option above, will count as an entry in the menu so will reduce the number of actual bookmarks that can be shown.

The Hotlist Manager also has the following options via the menus:

Hotlist
This menu contains all of the Hotlist Manager related menu options.

Revert to last saved Hotlist (RAmiga+R) This menu entry will cause IBrowse² to reload the last Hotlist saved to your hard disk, replacing the current one in use by IBrowse². This will loose any changes you have made and not saved during the session.
Load Hotlist... (RAmiga+L) This menu entry will open a file requester where you can select a saved version of the Hotlist. This file will be loaded into the Hotlist Manager, and any existing entries will be cleared and lost, unless previously saved.
	Only bookmark files that have been saved from the IBrowse² Hotlist Manager can be opened, this is not an import facility for other bookmark file formats.
Append Hotlist... (RAmiga+A) This menu entry will open a file requester where you can select a saved version of the Hotlist. This file will be loaded into the Hotlist Manager, and added to the existing entries to merge the two together.
	Only bookmark files that have been saved from the IBrowse² Hotlist Manager can be opened, this is not an import facility for other bookmark file formats.
Insert Hotlist... (RAmiga+I) This menu entry will open a file requester where you can select a saved version of the Hotlist. This file will be loaded into the Hotlist Manager, and inserted into the entries. The exact position that the data is inserted depends on the currently highlighted entry. If the entry is a link, then the data will be inserted below this entry. If the entry is a group, then the data will be inserted into the group, and positioned at the end of the current group entries.
	Only bookmark files that have been saved from the IBrowse² Hotlist Manager can be opened, this is not an import facility for other bookmark file formats.
Save Hotlist as... (RAmiga+S) This menu entry will open a file requester allowing you to save the current Hotlist to hard disk. Saving the file as ibrowse-hotlist.html will cause IBrowse² to load it each time it is started. By specifying a different name, you can create separate Hotlists to load, as you require.

The Info Window is opened via the Menus » Windows » Info Window menu entry, and is used to provide some basic information about links and images used on web pages.
The window is split into two sections, Link and Image. The Link section is used to show the destination URL for the current link under the mouse pointer. The Image section is used to show the Name of the image followed by the URL to the image in brackets, and the Size. When an image used on a web page is scaled by use of the width="" and/or height="" attributes, the Size information will provide the scaled (displayed) size, and the original size (which will be show in brackets).
e.g.	110x32 (116x32). This shows the displayed size as 110x32 pixels, and the original image size as 116x32 pixels.

The Netstat Manager is opened via the Menus » Windows » Netstat Manager menu entry, or by clicking on the Netstat LEDs located in the Status Toolbar of the main IBrowse² window. It is used to manage the open connections IBrowse² has, or is making to the Internet itself. Every time you visit a web page, IBrowse² opens a connection to the remote web server(s) and requests, then downloads the file. Sometimes files can stall or be unavailable, and IBrowse² will wait until the connection times out before aborting the request. All of this information is shown in the Netstat Manager, allowing you to see exactly what is going on, and to control at a basic level, the connections themselves.

The list itself is split into two columns, File and Status. The File column lists the filename that IBrowse² is dealing with, and the Status column lists the status of each entry. The different status shown are:

Looking up This indicates the connection is looking for the details of the server to connect to.
Sending request This indicates the connection has been requested to the server and/or the file itself has been requested.
Waiting for response This indicates the request was successful and IBrowse² is now awaiting a response from the server.
e.g.	The response could be: proceed, there is an error etc.
xxx bytes of xxx bytes read This indicates the total bytes transferred for that particular file, when the remote file size is known.
xxxx bytes read This indicates the total bytes transferred for that particular file, when the remote file size is unknown.
e.g.	For a dynamically generated web page.
Waiting This indicates that IBrowse² is waiting for a response from the server before proceeding.
Decoding This indicates that IBrowse² has handed the image data over to the datatypes system and is waiting for them to decode the image before displaying them. This status may only be seen when image decoding is set to external.

The basic control that you have over the connections is simply to abort a single connection, or abort all of the connections, and is done using the following options:

Abort
This gadget will cause IBrowse² to terminate the currently highlighted connection, thus aborting this particular transfer. Doing so can cause the web page to not display at all, to display incompletely, or to display with errors, such as missing images or incomplete JavaScript execution.

Abort all
This gadget will cause IBrowse² to terminate all connections, thus aborting the entire connection to the web server(s). Doing so can cause the web page to not display at all, to display incompletely, or to display with errors, such as missing images or incomplete JavaScript execution.

The URL Clipboard Manager is opened via the Menus » Windows » URL Clipboard Manager menu entry, and is used as a "scratchpad" for storing URLs temporarily. The idea behind the URL Clipboard Manager is to quickly store URLs that you think look interesting and that you would like to return to when you have finished what you are doing, but it can obviously be used how ever you prefer. With Preferences » General » Save URL Clipboard on change enabled, IBrowse² will automatically save the contents of the window every time you add, or remove an entry, and also when you quit IBrowse².

The list itself consists of two columns, Title and Location, and is fully Drag & Drop compatible, allowing easy re-organisation of the list. When dragging a URL into the URL Clipboard Manager from the Location gadget, IBrowse² will set Title to the name of the web page as specified in the <title> tag, and Location to the URL for that particular web page. When adding a link from the current web page to the URL Clipboard Manager, IBrowse² will set Title to (Untitled) as it does not have the title of the web page in the current session.

Double clicking an entry from the list will load the web page into the current browser. To manage the entries in the list, the following options are available to you:

Remove
This gadget will cause IBrowse² to remove the currently highlighted entry from the URL Clipboard Manager. This change will be saved immediately if Preferences » General » Save URL Clipboard on change is enabled.

Remove all
This gadget will cause IBrowse² to remove all entries in the URL Clipboard Manager. This change will be saved immediately if Preferences » General » Save URL Clipboard on change.

The URL Clipboard Manager also has the following options via the menus:

Edit
This menu contains the standard edit menu options.

Cut (RAmiga+X) This menu entry will copy the URL of the currently highlighted entry to the system clipboard, and remove the entry from the URL Clipboard Manager.
Copy (RAmiga+C) This menu entry will copy the URL of the currently highlighted entry to the system clipboard, and leave the entry in the URL Clipboard Manager.
Paste (RAmiga+V) This menu entry will create a new entry at the end of the URL Clipboard Manager, using the contents of the system clipboard as the Location for the entry, and (Untitled) for the Title.
	Currently whatever text is in the system clipboard will be pasted, irrespective of whether it is a valid URL or not. A suggestion to solve this has been put forward for a future release of IBrowse.

The Global History Window is opened via the Menus » Windows » Global History Window menu entry, and contains a list of all URLs viewed or accessed with IBrowse², across all sessions as stored in the Global History file. The contents of the Global History Window is controlled by the Preferences » HTML » Links expire after option, which sets the duration to keep links marked as followed, and therefore present in the Global History Window.

The list itself consists of a Location column containing a list of URLs you have recently visited, and is Drag & Drop compatible allowing you to drag entries from the list. Double clicking on an entry will load the web page into the current browser. By default, the URLs shown are only the root URLs, and the column is sorted in alphabetical order (including the protocol). These can both be changed by using the following options from the menu:

Show
This menu allows you to control the content of the Global History Window.

All visited URLs This menu entry will list all of the URLs visited during the number of days denoted by the Preferences » HTML » Links expire after option.
Only root URLs This menu entry will list only the root URLs visited during the number of days denoted by the Preferences » HTML » Links expire after option. The root URL is calculated in one of two ways; it is either the lowest level URL visited on a specific server, or the first URL alphabetically when all URLs equal the same domain and path.
e.g.	If you visited http://www.somesite.com/dir/somepage.html and http://www.somesite.com/, then http://www.somesite.com/ would be the root URL.
	If you visited http://www.somesite.com/dir/somepage.html and http://www.somesite.com/dir/anotherpage.html, then http://www.somesite.com/dir/anotherpage.html would be the root URL.
	If you visited http://www.somesite.com/dir/somepage.html and http://www.somesite.com/dir/subdir/anotherpage.html, then http://www.somesite.com/dir/somepage.html would be the root URL.
	If you visited http://www.somesite.com/dir/ and http://www.somesite.com/dir/subdir/anotherpage.html, then http://www.somesite.com/dir/ would be the root URL.
Sort on URL This menu entry will sort the Global History Window in alphabetical order, based on the URL. The entire URL is used for sorting, so any local files opened via the file:// protocol will be sorted before the http:// entries etc.
Sort in visited order This menu entry will sort the Global History Window in the order in which the URLs were visited, with the most recently visited URL will be listed at the top.

The Cookie Manager is opened via the Menus » Windows » Cookie Manager menu entry, and contains a list of the current cookies available to IBrowse² during the current session. A cookie is a small text string that is controlled by a remote web server, and can be used to store information such as the last time you visited, the type of browser used, a username, even part of your shopping list. This can be very useful as the remote website can then provide information based on the settings of your cookie when you next visit.
e.g.	Only show the news added since your last visit, automatically log you into a forum by matching your username in the cookie, or recalling your shopping list if you left the online supermarket in a hurry!
There was some concern raised over the use of cookies for tracking user activities, and/or exploiting personal information, but in most cases, cookies are harmless and indeed useful.
	For more information about cookies, visit http://www.cookiecentral.com/.
The list itself consists of four columns, Path, Domain, Expiration date and Cookie. Path is the path on the remote web server that the cookie belongs to, and Domain is the root domain of the web server that sent the cookie. The Expiration date is the date that the cookie is valid until, after which the data is deemed invalid. Usually the server will re-issue a new cookie after this date. Once the cookie has expired, IBrowse² will retain the cookie in the Cookie Manager until your next visit to the website that generated it. At this point, it will be automatically deleted (as the current date will be past the expiry date), allowing the web server to generate a new cookie with a new expiry date, if required. Temporary cookies will be listed with an expiration date of After session. Finally, Cookie is the contents of the cookie itself. Generally, this contains numbers or encoded strings, which the remote web server uses to decode and retrieve your data. To manage the entries in the list, the following options are available to you:
Remove This gadget will cause IBrowse² to remove the currently highlighted entry from the Cookie Manager.
Remove all This gadget will cause IBrowse² to remove all entries in the Cookie Manager.
Changes to your cookies will be saved on exit if Preferences » Security » Save persistent cookies on exit is enabled.

The Download Manager is opened via the Menus » Windows » Download Manager menu entry, and is used to manage your file downloads from the Internet. As you download files, they are transferred into the Download Manager, which will open when the file download begins. File downloads differ from normal data downloads in that they are downloaded to the directories specified in Preferences » General » Directories » Downloads, and Preferences » General » MIME Types » Def. save dir, rather than into memory for display by IBrowse², and are controlled by the user, rather than by IBrowse².

The Download Manager itself consists of four main tabs, divided into a number of columns. The four tabs are Current downloads, Queued downloads, Completed downloads and Failed downloads.

The Current downloads tab is fully Drag & Drop compatible, so you can drag links anywhere that is compatible with Drag & Drop, and start the download of the file immediately. When you drag a link to the tab, if the number of current downloads matches your Preferences » Network » Max. simultaneous downloads setting, then the new download will be added to the Queued downloads tab automatically. The Current downloads tab consists of eight columns, S (or Status), Filename, Size, Completed, cps, Finish at, Location and Referer:

S(Status)
This column will show the current status of the download, via a small coloured LED image. The colors you will see are:

Blue This indicates that IBrowse² is looking up the details to the web server before connection.
White This indicates that IBrowse² is sending a request to the web server to determine how to continue.
Orange This indicates that IBrowse² is waiting for a response after the web server acknowledged the request.
Green / Light Green This indicates that IBrowse² is transferring the file data from the remote web server. The two-tone color is to give a pulsing effect as the data is transferred.
Red This indicates that IBrowse² has aborted the connection due to an error before the transfer began. This could be a problem at the remote web server, or a more local problem such as a DNS error at your ISP.
Yellow This indicates that IBrowse² is waiting as the transfer has stalled. This could be due to a dropped connection, or a problem communicating with the server after a transfer has begun.
e.g.	If your ISP has a time limit for your connection and the line drops after a few hours, the LED would change to this colour to reflect the stalled connection.

Filename
This column will display the local name of the file that is saved to your hard disk, including the path where necessary.

Size
This column will display the size in bytes of the file you are downloading where known. Occasionally you may see (unknown) when the file size cannot be determined.

Completed
This column will display the total bytes transferred for the file you are downloading.

cps
This column will display the transfer rate in characters per second. The transfer rate will vary from file to file, as it depends on a number of factors, and is an average of the bytes transferred in the time currently taken.

Finish at
This column will display the estimated time of completion based on the file size and the cps. When Size is shown as (unknown), Finish at will also be displayed as (unknown), due to being unable to calculate the time. The time is show in the 24hour format and is based on your local time.

Location
This column will display the actual URL to the file on the remote server, which is also used for the comment IBrowse² will add to the file before downloading.

Referer
This column will display, where applicable, the URL of the web page, or web server, that linked to the URL of the file you are downloading.

To manage your Current downloads, the following options are available to you:

Abort
This gadget will cause IBrowse² to terminate the transfer of the currently highlighted entry from the Current downloads tab. The aborted transfer will be moved into the Failed downloads tab unless you have Preferences » Network » Don't move aborted downloads enabled, in which case the entry will be retained and marked with a Red LED image to indicate an aborted connection.

Abort all
This gadget will cause IBrowse² to terminate the transfer of all the current entries from the Current downloads tab. The aborted transfers will be moved into the Failed downloads tab unless you have Preferences » Network » Don't move aborted downloads enabled, in which case they will be retained and marked with a Red LED image to indicate an aborted connection.

The Queued downloads is fully Drag & Drop compatible, so you can drag links anywhere that is compatible with Drag & Drop, and start the download of the file immediately. The main purpose of this tab is to list the extra downloads you have queued up for IBrowse² to process as the Current downloads complete. The queue will begin after the Preferences » Network » Max. simultaneous downloads figure is reached, and IBrowse² will automatically start transferring the next file from the queue as required. The Queued downloads tab consists of two columns, Location and Referer:

Location This column will display the actual URL to the file on the remote server, which is also used for the comment IBrowse² will add to the file before downloading.
Referer This column will display, where applicable, the URL of the web page, or web server, that linked to the URL of the file you are downloading.
To manage your Queued downloads, the following options are available to you:
Abort This gadget will cause IBrowse² to terminate the queuing of the currently highlighted entry from the Queued downloads tab.
Abort all This gadget will cause IBrowse² to terminate the queuing of all the current entries from the Queued downloads tab.
Force start This gadget will cause IBrowse² to override the Preferences » Network » Max. simultaneous downloads setting, forcing the currently highlighted entry to be added to the Current downloads tab, and the download initiated.

The Completed downloads tab is used to list those files that have successfully downloaded to your hard disk. Entries will always be listed here during each session, and if Preferences » Network » Log completed downloads is enabled, then they will also be preserved across sessions. This tab consists of three columns, Location, Filename and Referer:

Location This column will display the actual URL the file was downloaded from, which is also what IBrowse² used to set the file comment.
Filename This column will display the local name of the file when it was saved to your hard disk, including the path where necessary.
Referer This column will display, where applicable, the URL of the web page, or web server, that linked to the URL of the file when you downloaded it.
To manage your Completed downloads, the following options are available to you:
Remove This gadget will cause IBrowse² to remove the currently highlighted entry from the Completed downloads tab. This will not remove the physical file from your hard disk, just from the listing in the tab.
Remove all This gadget will cause IBrowse² to remove all entries from the Completed downloads tab. This will not remove the physical files from your hard disk, just from the listing in the tab.

The Failed downloads tab is used to list those files that have not been successfully downloaded to your hard disk. Entries will always be listed here during each session, and if Preferences » Network » Log failed downloads is enabled, then they will also be preserved across sessions. This tab consists of four columns, Status, Location, Filename and Referer:

Status This column will display the reason that the download failed. Failures can be due to a user action, or due to a network or server problem.
Location This column will display the actual URL the file was attempted to be downloaded from. If the transfer had successfully started, then this is also what IBrowse² used to set the file comment.
Filename This column will display the local name of the file that was attempted to be created when it was saved to your hard disk, including the path where necessary. If the transfer had successfully started, then this file will exist in an incomplete state.
Referer This column will display, where applicable, the URL of the web page, or web server, that linked to the URL of the file that you attempted to download.
To manage your Failed downloads, the following options are available to you:
Force Restart This gadget will cause IBrowse² to attempt to restart the currently highlighted entry from the Failed downloads tab immediately, overriding the Preferences » Network » Max. simultaneous downloads setting.
Remove This gadget will cause IBrowse² to remove the currently highlighted entry from the Failed downloads tab. This will not remove the physical file from your hard disk, just from the listing in the tab.
Remove all This gadget will cause IBrowse² to remove all entries from the Failed downloads tab. This will not remove the physical files from your hard disk, just from the listing in the tab.

The Download Manager also has the following options via the menus:

Preferences
This menu allows you to control various preference settings of the Download Manager.

Proxy
This menu entry is used to override the main preferences for quick access to the enable proxy option. The options available are:

Enable This menu entry is used to override the main Preferences » Network » Proxy » Use preference options to force IBrowse² to use the configured proxy (if applicable) for file downloads.
Disable This menu entry is used to override the main Preferences » Network » Proxy » Use preference options to force IBrowse² not to use the configured proxy (if applicable) for file downloads.
Default setting This menu entry will tell IBrowse² to use the default setting that you have defined for the Preferences » Network » Proxy » Use preference options.

The IBrowse² Cache Explorer (ICE), is opened via the Menus » Cache » Cache Explorer menu entry, and is used to manage your hard disk cache. Please refer to the ICE chapter for further information.

The Password Manager is opened via the Menus » Passwords » Password Manager menu entry, and is used to manage the passwords that IBrowse² has stored. Often, when you encounter a website that requires a password for you to gain access, IBrowse² will present you with the Authentication Requester. The information you enter into this requester, can be optionally saved into the Password Manager, so that on your next visit to the website, the requester will be automatically completed for you.
	Password submission can be performed in two common methods on the Internet, via the Authentication Requester, or via form submission, where the username and password fields are embedded in the web page. The Password Manager only works with those submitted via the Authentication Requester, and not those via form submission.
The list itself consists of three columns, Host, Realm and Username. Host is used to specify the name of the web server that the entry belongs to, and the Realm is the area within the host that the authentication is specific to.
e.g.	You could have two entries for the same Host, with different Realms and different Usernames & Passwords. Username is the same as that entered into the Authentication Requester, and is used by both IBrowse² and the remote web server to identify you in order to retrieve and confirm your password.
To manage your passwords, the following options are available to you:
Remove This gadget will cause IBrowse² to remove the currently highlighted entry from the Password Manager.
Remove all This gadget will cause IBrowse² to remove all entries from the Password Manager. This gadget has the same function as the Menus » Passwords » Reset authorization menu entry.

The Settings window is opened via the Menus » Preferences » Settings menu entry, and is used to configure various aspects of IBrowse² to meet your personal requirements. Please refer to the Preferences chapter for further information.

The Authentication Requester is opened when browsing to an area of a web server that requires a Password to gain access. The requester will show some information regarding the web server and the area you are trying to access, allow you to provide your Username & Password, and to control how the authentication data is stored. When the window opens, the name of the Host requesting the authentication will be shown in boldface. Just below, will be the Realm entry, which is the name of the area on the web server that your login details are valid for. This Realm is controlled by the web page author, and is used by IBrowse² to determine which Username & Password should be specified when asked by the web server. Below this information, are the controls for the requester. The options available to you are:
Username This gadget is used to specify your Username for this Realm on the web server. The web page author usually provides this information for the web page you are trying to access, or is one that you specified when requesting access to this area.
Password This gadget is used to specify your Password for this realm on the web server. The web page author usually provides this information for the web page, or is one that you specified when requesting access to this area.
	The Username/Password pair must match the information stored on the web server in order for you to be authenticated and gain access. Usually, these are both case sensitive, so double check that you have entered the details exactly as specified, if you receive any errors when trying to gain access.
Cache authentication Enabling this option will cause IBrowse² to store the authentication information for the Host, Realm, Username & Password, in memory for the session. If you disable this option, you will be prompted for your details on every request to the web server for this realm.
Save authentication Enabling this option will cause IBrowse² to store the authentication information for the Host, Realm, Username & Password, on your hard disk for use in future sessions. When you attempt to access this Realm in a future session, you will still be presented the Authentication Requester, but the Username and Password details will have be pre-entered by IBrowse². Disabling this option will mean that the Authentication Requester will be blank when attempting to access this Realm in a future session.
	Saving your Username and Password can be considered a security risk, as it will allow other users of your Amiga to access secure websites without needing to know your details, so it is recommended that you do not use this option. However, if you are the sole user of your Amiga, you may wish to enable this option, as long as you are aware of the dangers.
OK This gadget is used to close the Authentication Requester and submit the supplied data to the web server for checking. If the Username and/or Password are incorrect, or invalid, the Authentication Requester will be reopened with an error informing you so.
Cancel This gadget is used to close the Authentication Requester and cancel the access attempt. As the authentication was cancelled, it has effectively failed, so you will then be shown an authentication error.

The Cookie Requester is opened when you are sent a cookie by a remote web server, and you have Preferences » Security » Temporary cookies and/or Preferences » Security » Persistent cookies set to Ask on first, or Always ask. The Cookie Requester will provide you with some information regarding the cookie that you have been sent, and will then ask how you would like to handle the cookie. The information you will be presented with consists of the Server sending the cookie, the Type of cookie, and the cookie Contents, which will be truncated if it is too long to be displayed. The options available to you will depend on the Type of cookie;

i.e.

Whether it is a Temporary cookie, or a Persistent cookie. The difference between the two is a Temporary cookie is valid for the session only, where as a Persistent cookie will last across multiple sessions (if Preferences » Security » Save persistent cookies on exit is enabled), and will expire on a given date in the future.

For a Temporary cookie, the options available to you are:

Accept This gadget is used to accept the specific Temporary cookie being sent to you. If Preferences » Security » Temporary cookies is set to Always ask, your acceptance of the Temporary cookie will not be cached in memory for the current session, and you will be shown the Cookie Requester every time you are sent this Temporary cookie.
Accept from this server This gadget is used to accept any Temporary cookies being sent to you from this specific server. Your acceptance of Temporary cookies from this server will be cached in memory, and this gadget will override Preferences » Security » Temporary cookies if it is set to Always ask, therefore no longer prompting you for acceptance of Temporary cookies from this server, for this session. Using this gadget in conjunction with Preferences » Security » Temporary cookies being set to Always ask, will allow you to maintain individual control of all Temporary cookies, whilst automatically accepting Temporary cookies from particular servers during your browsing session.
e.g.	If you want to individually control all Temporary cookies sent during a session, but you want to visit a shopping site such as Amazon.com (which you know and therefore want to automatically accept the Temporary cookies from them) you can use this gadget on the first Temporary cookie from the amazon.com server, whilst still using Accept or Refuse once on any other Temporary cookies from other sources through the browsing session.
Accept, and save This gadget is used to accept the specific Temporary cookie being sent to you, and change its Type to a Persistent cookie, therefore making it possible to save across sessions if Preferences » Security » Save persistent cookies on exit is enabled. If Preferences » Security » Temporary cookies is set to Always ask, your acceptance of the Temporary cookie will not be cached in memory for the current session, and you will be shown the Cookie Requester every time you are sent this Temporary cookie.
	This option is non-functional in this release of IBrowse², and will behave the same as clicking Accept.
Refuse once This gadget is used to refuse the specific Temporary cookie being sent to you. If Preferences » Security » Temporary cookies is set to Always ask, your refusal of the Temporary cookie will not be cached in memory for the current session, and you will be shown the Cookie Requester every time you are sent this Temporary cookie.
Refuse all from this server This gadget is used to refuse any Temporary cookie being sent to you from this specific server. Your refusal of Temporary cookies from this server will be cached in memory, and this gadget will override Preferences » Security » Temporary cookies if it is set to Always ask, therefore no longer prompting you for acceptance of Temporary cookies from this server, for this session. Using this gadget in conjunction with Preferences » Security » Temporary cookies being set to Always ask, will allow you to maintain individual control of all Temporary cookies, whilst automatically refusing Temporary cookies from particular servers during your browsing session.
e.g.	If you want to individually control all Temporary cookies sent during a session, but you want to refuse all Temporary cookies from an ad-server, you can use this gadget on the first Temporary cookie from the server, whilst still using Accept or Refuse once on any other Temporary cookies from other sources through the browsing session.

For a Persistent cookie, the options available to you are:

Accept This gadget is used to accept the specific Persistent cookie being sent to you. If Preferences » Security » Persistent cookies is set to Always ask, your acceptance of the Persistent cookie will not be cached in memory for the current session, and you will be shown the Cookie Requester every time you are sent this Persistent cookie. If Preferences » Security » Save persistent cookies on exit is enabled, this Persistent cookie will be saved when you exit IBrowse². This Persistent cookie will then be made available in the current, and subsequent browsing sessions, allowing a server matching the Domain and Path to retrieve the cookie Contents for its own use, e.g. to automatically log you into a forum.
Accept from this server This gadget is used to accept any Persistent cookies being sent to you from this specific server. Your acceptance of Persistent cookies from this server will be cached in memory, and this gadget will override Preferences » Security » Persistent cookies if it is set to Always ask, therefore no longer prompting you for acceptance of Persistent cookies from this server, for this session. Using this gadget in conjunction with Preferences » Security » Persistent cookies being set to Always ask, will allow you to maintain individual control of all Persistent cookies, whilst automatically accepting Persistent cookies from particular servers during your browsing session. If Preferences » Security » Save persistent cookies on exit is enabled, accepted Persistent cookies will be saved when you exit IBrowse². These Persistent cookies will then be made available in the current, and subsequent browsing sessions, allowing a server matching the Domain and Path to retrieve the cookie Contents for its own use, e.g. to automatically log you into a forum.
e.g.	If you want to individually control all Persistent cookies sent during a session, but you want to visit a shopping site such as Amazon.com (which you know and therefore want to automatically accept the Persistent cookies from them) you can use this gadget on the first Persistent cookie from the amazon.com server, whilst still using Accept or Refuse once on any other Persistent cookies from other sources through the browsing session.
Accept, don't save This gadget is used to accept the specific Persistent cookie being sent to you, and change its Type to a Temporary cookie, therefore causing it not to be saved across sessions, even if Preferences » Security » Save persistent cookies on exit is enabled. If Preferences » Security » Persistent cookies is set to Always ask, your acceptance of the Persistent cookie will not be cached in memory for the current session, and you will be shown the Cookie Requester every time you are sent this Persistent cookie.
	This option is non-functional in this release of IBrowse², and will behave the same as clicking Accept.
Refuse once This gadget is used to refuse the specific Persistent cookie being sent to you. If Preferences » Security » Persistent cookies is set to Always ask, your refusal of the Persistent cookie will not be cached in memory for the current session, and you will be shown the Cookie Requester every time you are sent this Persistent cookie.
Refuse all from this server This gadget is used to refuse any Persistent cookie being sent to you from this specific server. Your refusal of Persistent cookies from this server will be cached in memory, and this gadget will override Preferences » Security » Persistent cookies if it is set to Always ask, therefore no longer prompting you for acceptance of Persistent cookies from this server, for this session. Using this gadget in conjunction with Preferences » Security » Persistent cookies being set to Always ask, will allow you to maintain individual control of all Persistent cookies, whilst automatically refusing Persistent cookies from particular servers during your browsing session.
e.g.	If you want to individually control all Persistent cookies sent during a session, but you want to refuse all Persistent cookies from an ad-server, you can use this gadget on the first Persistent cookie from the server, whilst still using Accept or Refuse once on any other Persistent cookies from other sources through the browsing session.

The E-mail Composer window will open when clicking on a mailto: link when Preferences » Network » E-mail & Telnet » Type (mailto:) is set to Internal. The window is divided into two main areas, the Headers and the main Message Body. The Headers section consists of two gadgets, the To: address, and the Subject. IBrowse² will have entered the To: address automatically when you clicked on the mailto: link, so usually will not need to be changed. The Subject and Message Body will also be completed automatically, depending on the format of the mailto: link that you clicked on.
If ?subject= was specified, this will be transferred into the Subject gadget for you, and if &body= was specified, this will be transferred into the Message Body area for you. Obviously these can both be edited, but bear in mind that they may have been completed in such a way that is specific to what the web page author requires, so changing them could cause a problem.
e.g.	Subscribing to, or unsubscribing from a mailing list requires the Subject, or sometimes the Message Body, to be formatted in a specific way so editing these could result in the request failing.
There are two options available to you in the E-mail Composer:
Send This gadget will cause IBrowse² to send the message you have composed to the e-mail destination specified in the To: address gadget.
Cancel This gadget will cause IBrowse² to close the E-mail Composer, loosing any changes to the message.

The Specify title window will open when adding a new entry to the Fastlinks, via a Drag & Drop operation, or via the ADDFASTLINK ARexx command when using PROMPTTITLE/S switch. The window itself consists of three gadgets:
Title This gadget is used to specify the text that will be displayed in the fastlink button. Title will default to (Untitled) when dragging a link from within a web page, or to the <title> of the page if dragged from the Location gadget. The buttons will all be sized to match the longest entry, so to ensure that as many entries as possible are shown per row, try to use concise and clear names.
Add This gadget is used to close the Specify title window, and add the new button to the fastlinks GUI element. Should the newly added fastlink not appear, the number of fastlinks is greater than can be displayed in the number of rows you have specified in Preferences » GUI » Fastlinks » Rows, causing the fastlinks that do not fit to be truncated from the GUI element.
Cancel This gadget is used to close the Specify title window, and cancel the operation, without making any changes to the fastlink buttons.

The Specify action for window will open when Preferences » General » MIME Types » Action is set to Ask user, or IBrowse² receives a file with a MIME Type that has not been configured under Preferences » General » MIME Types. The window itself consists of four tabs: Download to disk, View in window, View with external program and Download as MIME, giving you a variety of means of control.
Download to disk This tab allows you to download the file to the directory and filename specified in the Filename: string gadget. You can use the file requester gadget to the right to browse to the directory you require, or type directly into the string gadget.
View in window This tab allows you to view the file directly in IBrowse². Only MIME Types understood by IBrowse² can be displayed, and a list of which can be found by viewing the Plugins available to IBrowse². These can be found by looking at the about:plugins page.
	This release of IBrowse² only supports the native HTML Viewer plugin, allowing text/html, text/plain and images/* to be viewed internally. The Plugin API for 3rd party plugins will be made available in the next release of IBrowse.
View with external program This tab allows you to view the file in the program specified in the Viewer: string gadget. You can use the file requester gadget to the right to browse to the program you require, or type directly into the string gadget. Any command line parameters the need to be passed to the external program should be entered into the Parameters: string gadget directly.
Download as MIME This tab allows you to select the MIME Type IBrowse² should treat the file as. The MIME Types available are those configured in Preferences » General » MIME Types.
e.g.	If you have an application/x-shockwave-flash MIME Type set up, and this file is an application/shockwave-flash MIME Type, you can select application/x-shockwave-flash instead to download the file. Optionally, you can then add the new MIME Type to Preferences » General » MIME Types, to avoid the Specify action for window appearing for this MIME Type in the future.

The Export CA certificate window is opened when using the Preferences » Security » CA certs » Export gadget. The window consists of four gadgets:
Format This gadget is used to select the format the selected certificate should be exported in, either Base-64 encoded X.509, or DER encoded X.509.
Filename This gadget is used to specify the directory and filename to export to. You can use the file requester gadget to the right to browse to the directory you require, or type directly into the string gadget.
OK This gadget is used to close the Export CA certificate window and commence the exportation of the certificate to the filename specified.
Cancel This gadget is used to close the Export CA certificate window and cancel the exportation operation.

The Password requester is opened when using the Preferences » Security » User certs » Import gadget. The window consists of three gadgets:
Password This string gadget is used to enter the password the certificate you are importing is protected with, and will be masked so that the text you type is not visible.
OK This gadget is used to close the Password requester and compare the password supplied with that in the certificate. If they match, then importation of the certificate will commence.
Cancel This gadget is used to close the Password requester and cancel the importation operation.

<< Menus Chapter

Contents Chapter

Drag & Drop Chapter >>



IBrowse² Documentation v2.3 © 2002, 2003 Dave Fisher ~ IBrowse² Development Team	Revision 1.0