<html><head><title>
Standalone BookMaker: Preferences
</title>
</head>

<body link="#008000" alink="#7FFF00" vlink="#004000" bgcolor="#FFFFFF" text="#000000">

<h2>Setting up BookMaker</h2>
<P>
The BookMaker preferences can be set up using the !BMConfig application. In
addition, the &quot;Book&quot; and &quot;Address&quot; BookMaker menus have
&quot;Preferences&quot; options to display the preferences dialog box.

<p>
The Bookmaker preferences dialog box has a <a href="#help">help button</a>,
a set of <a href="#buttons">four action buttons</a> and a
scrolling window where the user preferences are set up.
Fully expanded, the scrolling window is shown below.

<p><hr><p>

<center><a name="preferences"><h2>The Preferences Dialog Box</h2></a>

<p>
<i>Click on a control for details of its function.</i>
<p>
<img src="GFKbkmkr/prefs1" alt="[ Preferences window ]" usemap="#prefs1map" width="306" height="343" border="0" ismap>
<br><img src="GFKbkmkr/prefs2" alt="[ Preferences window ]" usemap="#prefs2map" width="306" height="364" border="0" ismap>
<br><img src="GFKbkmkr/prefs3" alt="[ Preferences window ]" usemap="#prefs3map" width="306" height="260" border="0" ismap>
<br><img src="GFKbkmkr/prefs4" alt="[ Preferences window ]" usemap="#prefs4map" width="306" height="102" border="0" ismap>
<br><img src="GFKbkmkr/prefs5" alt="[ Preferences window ]" usemap="#prefs5map" width="306" height="157" border="0" ismap>

</center>

<map name="prefs1map">
<!-- Automatically created by Imagen, v1.44 -->
<area shape="rect" coords="19,21,151,42" href="#install">
<area shape="rect" coords="19,43,151,66" href="#quitonclose">
<area shape="rect" coords="19,66,151,90" href="#auto_save">
<area shape="rect" coords="19,90,169,114" href="#auto_open">
<area shape="rect" coords="19,114,169,138" href="#showaddr">
<area shape="rect" coords="19,138,145,162" href="#hotlist_only">
<area shape="rect" coords="19,162,145,186" href="#openhotlist">
<area shape="rect" coords="19,186,184,210" href="#defaulturllocn">
<area shape="rect" coords="19,211,156,234" href="#sortbookstotop">
<area shape="rect" coords="165,233,282,260" href="#toolbarsize">
<area shape="rect" coords="63,260,280,290" href="#adjustdblclk">
<area shape="rect" coords="40,292,281,336" href="#extdrag">
<area shape="rect" coords="0,0,306,343" href="">
</map>

<map name="prefs2map">
<!-- Automatically created by Imagen, v1.44 -->
<area shape="rect" coords="70,15,250,45" href="#linespacing">
<area shape="rect" coords="64,72,277,219" href="#colours">
<area shape="rect" coords="13,222,298,285" href="#fontdetails">
<area shape="rect" coords="67,294,259,321" href="#autoresize">
<area shape="rect" coords="67,321,259,351" href="#openlistat">
</map>
<map name="prefs3map">
<!-- Automatically created by Imagen, v1.44 -->
<area shape="rect" coords="95,21,248,46" href="#browser_client">
<area shape="rect" coords="135,53,247,79" href="#browser_interface">
<area shape="rect" coords="93,82,245,104" href="#warn_unsafe">
<area shape="rect" coords="92,110,249,134" href="#email_client">
<area shape="rect" coords="91,135,192,159" href="#messenger_public">
<area shape="rect" coords="91,164,249,188" href="#ftp_client">
<area shape="rect" coords="95,193,247,220" href="#telnet_client">
<area shape="rect" coords="92,225,246,245" href="#needs_ole">
</map>

<map name="prefs4map">
<!-- Automatically created by Imagen, v1.44 -->
<area shape="rect" coords="19,18,121,42" href="#confirm_book">
<area shape="rect" coords="19,42,130,66" href="#confirm_addr">
<area shape="rect" coords="19,66,139,93" href="#confirm_discard">
</map>

<map name="prefs5map">
<!-- Automatically created by Imagen, v1.44 -->
<area shape="rect" coords="22,18,292,144" href="#hotkeys">
</map>

<p>
<hr>

<p>&nbsp;<p>
<a name="install"></a>
<h3><a href="#preferences">Install on icon bar</a></h3>
<p>
<ul>
<li><b>On</b>: BookMaker will create an icon on the iconbar. Clicking this
icon will display the main window. BookMaker will only quit when the &quot;Quit&quot; menu
item is selected.
<li><b>Off</b>: There will be no iconbar icon, and the main window will be displayed
immediately. Whether BookMaker quits when this window is closed is controlled by the
&quot;Quit on close&quot; preference below.
</ul>
<p><i>Changing this preference will have no effect while BookMaker is running.</i>

<p>&nbsp;<p>
<a name="quitonclose"></a>
<h3><a href="#preferences">Quit on close</a></h3>
<p>
<ul>
<li><b>On</b>: Closing the window will quit BookMaker - if there are any
outstanding changes, these are either <a href="#auto_save">automatically saved</a>, or you will
be offered the chance to save them.
<li><b>Off</b>: Closing the window will not quit BookMaker, and the window
can be re-opened by re-running BookMaker (this will <strong>not</strong> run
another copy of BookMaker). The only way to quit BookMaker is to select the
&quot;Quit&quot; option from one of the menus.

</ul>
<p>
This preference is only relevant if the &quot;Install on icon bar&quot; preference is
<i>off</i>.
<p><i>Changes to this preference will take effect immediately.</i>

<p>&nbsp;<p>
<a name="auto_save"></a>
<h3><a href="#preferences">Auto-save on quit</a></h3>
<p>
Ticking this option will cause BookMaker to save any outstanding changes automatically when
the program quits - there is no way to discard any changes made by mistake.

<p><i>Changes to this preference will take effect immediately.</i>

<p>&nbsp;<p>
<a name="auto_open"></a>
<h3><a href="#preferences">Auto-open new books</a></h3>
<p>
If this option is selected, whenever a new book is created it will be opened immediately.
<p><i>Changes to this preference will take effect immediately.</i>


<p>&nbsp;<p>

<a name="showaddr"></a>
<h3><a href="#preferences">Show address in toolbar</a></h3>
<p>
Selecting this option will tell BookMaker to provide a continually updating display of the 
title or address under the mouse pointer in the toolbar. If &quot;Names&quot; are displayed
in the main window, the toolbar will show the address; and <i>vice-versa</i>. Holding down
the &lt;CTRL&gt; key will freeze the display until the key is released.

<p><i>Changing this preference will take effect immediately.</i>

<p>&nbsp;<p>

<a name="toolbarsize"></a>
<h3><a href="#preferences">Toolbar</a></h3>
<p>
This control will allow you to specify whether you wish to use a large toolbar, a small toolbar,
or no toolbar at all.

<p><i>Changing this preference will take effect immediately.</i>


<p>&nbsp;<p>

<a name="sortbookstotop"></a>
<h3><a href="#preferences">Sort books to top</a></h3>
<p>
If selected, the &quot;Sort Addresses&quot; menu option will force all sub-books to the top of
the list.

<p><i>Changing this preference will take effect immediately.</i>


<p>&nbsp;<p>

<a name="hotlist_only"></a>
<h3><a href="#preferences">Hotlist Only</a></h3>
<p>
Selecting this option will prevent BookMaker from opening any of the address books other
than the browser hotlist(s). If this is enabled,  BookMaker will normally start up with
the main hotlist open.

<p><i>Changing this preference will have no effect while BookMaker is running.</i>

<p>&nbsp;<p>

<a name="openhotlist"></a>
<h3><a href="#preferences">Open Hotlist</a></h3>
<p>
Selecting this option will force BookMaker to start with the main browser hotlist open.
This option is faded if the &quot;Hotlist Only&quot; option is set.

<p><i>Changing this preference will have no effect while BookMaker is running.</i>

<p>&nbsp;<p>

<a name="defaulturllocn"></a>
<h3><a href="#preferences">Add URLs to main book</a></h3>
<p>
This option controls the location for URLs added when the client browser's &quot;Add to hotlist&quot; button is clicked.
<p>If selected, URLs will be added ad the end of the main browser hotlist.
<p>If deselected, the &quot;Add to hotlist&quot; button will bring up a hierarchical menu of hotlist folders. The URL will be added at the end of whichever folder is selected.

<p><i>Changing this preference will take effect immediately.</i>

<p>&nbsp;<p>

<a name="adjustdblclk"></a>
<h3><a href="#preferences">Adjust Double-Click</a></h3>
<p>
This preference allows you to control the action BookMaker will take on an double-click
on an address with the mouse Adjust button, and when a double-click with the Select button
is made when the &lt;CTRL&gt; key is held down.
<p>The result of preference settings are shown in the table below<p>

<table celpadding=3 border=3>
<tr align=center>
<th>Setting
<th>Adjust button
<th>Select button + &lt;CTRL&gt;</tr>
<tr align=center>
<th>Close
<td>Close hotlist
<td>Re-open hotlist at front</tr>
<tr align=center>
<th>ReOpen
<td>Re-open hotlist at front
<td>Close hotlist</tr>
</table>

<p><i>Changes to this preference will take effect immediately.</i>

<p>&nbsp;<p>

<a name="extdrag"></a>
<h3><a href="#preferences">Save dragged links as...</a></h3>
<p>
If the shift key is held down when a hotlist address is dragged, BookMaker will allow the URL
to be dragged to a filer window. The format in which the URL is saved can be in one of two formats - ANT URL (File type &f91) or Acorn URI (File type &b28). This preference specifies which
of the two file formats is used.
<p>
In either case, the name of the file will be URL&lt;n&gt;, where &lt;n&gt; is a number that starts at 1 and is incremented every time a file is saved by dragging.
<p>
If multiple addresses (or a folder) are selected, it is still possible to shift-drag the selection, but in this case all addresses will end up in an HTML files called Hotlist&lt;n&gt.

<p><i>Changing this preference will take effect immediately.</i>

<p>&nbsp;<p>

<a name="linespacing"></a>
<h3><a href="#preferences">Line spacing</a></h3>
<p>
This preference allows you to specify the spacing of the lines in the main window, as a 
percentage of the notional font size. It can be adjusted from 100% (the default)
to 120%.

<p><i>Changes to this preference will take effect immediately.</i>

<p>&nbsp;<p>

<a name="colours"></a>
<h3><a href="#preferences">Colours</a></h3>
<p>
This group consists of of four colour menus and two option buttons, and allows you to set
the colours used by the BookMaker list window:

<ul>
<li>Background colour. If the background colour is set to 1 (one), the &quot;Marbled&quot;
option button below the colour menu can be used to select between a marbled and solid
colour background.
<li>Foreground colour
<li>Distribution list - the foreground colour used by distribution list
entries in the Email book
<li>As Address Book - the Email book(s) will use the foreground colours as set up
by the Messenger Pro or !Posty email client. Ticking this option will disable the
&quot;Distribution list&quot; colour menu. The Email colours can be set with
the Colour item from the <a href="index.html#menu_address">Address menu</a>.
<li>Bad URL - On startup, BookMaker scans all the addresses in all the books checking
for legality. Any addresses that BookMaker thinks are invalid will be be shown in this
colour.
</ul>

<p><i>Changes to this preference will take effect immediately.</i>

<p>&nbsp;<p>

<a name="fontdetails"></a>
<h3><a href="#preferences">Font details</a></h3>
<p>
This group of preferences can be used to define the font face and size used in the main BookMaker
window.
<p>If the &quot;Font&quot; option button is unselected, BookMaker will use the default font
(for RISCOS 3.5 and later, this is the desktop font; for earlier versions of the OS, it is the System
Font).
<p>If the &quot;Font&quot; option button is selected, the font face and size controls will be unfaded,
and you may specify any font face available on your computer, and any font size between 8 and 24 point.

<p><i>Changes to this preference will take effect immediately.</i>

<p>&nbsp;<p>

<a name="autoresize"></a><h3>
<a href="#preferences">Auto-resize</a></h3>
<p>
This menu is used to select when BookMaker will resize the window. This can be set to one of:
<ul>
<li><b>Never</b>: The window will only ever be shrunk to avoid whitespace at the bottom.
<li><b>Full size</b>: When a book is opened, the window will grow as necessary to display the
contents, but only if it had been toggled to full size before the book was opened.
<li><b>Always</b>: The window will grow whenever a book is opened.
</ul>
 
<p>
<i>Changing this preference will have no effect while BookMaker is running.</i>

<p>&nbsp;<p>

<a name="openlistat"></a><h3>
<a href="#preferences">Open list at</a></h3>
<p>
This menu controls whether the main list window will be initially opened at
the left, centre or right of the screen.
 
<p>
<i>Changing this preference will have no effect while BookMaker is running.</i>

<p>&nbsp;<p>

<a name="browser_client"></a>
<h3><a href="#preferences">Select Browser</a></h3>
<p>
BookMaker provides support for a range of browsers - select your preferred browser
from the pull-down menu.

<p>BookMaker also allows the some browsers (Browse, Fresco, Oregano1 and NetSurf) to share their (HTML-based) hotlists. To share these hotlists, it is necessary to update the browser config file (or in the base of Oregano1, the !Run file). For simplicity, the location of the Browse hotlist is taken as the reference location.
<p>To update the Fresco configuration:
<ol>
<li>Locate the Fresco configuration file - this is the file <i>Config</i> located inside !Fresco.

<li>Load the file into your favourite text editor, and find the line
<br><code>files.hots: &lt;something-or-other&gt;</code>
<li>Replace this line by
<br><code>files.hots: &lt;Choices$Write&gt;.WWW.Browse.Hotlist</code>
<li>Save the file
</ol>

<p>To update the NetSurf configuration:
<ol>
<li>Locate the NetSurf choices file (Choices:WWW.NetSurf.Choices)
<li>Load the file into your favourite text editor, and find the line
<br><code>hotlist_path: &lt;something-or-other&gt;</code>
<li>Replace this line by
<br><code>hotlist_path: &lt;Choices$Write&gt;:WWW.Browse.Hotlist</code>
<li>Find the line
<br><code>hotlist_save: &lt;something-or-other&gt;</code>
<li>Replace this line by
<br><code>hotlist_save: &lt;Choices$Write&gt;:WWW.Browse.Hotlist</code>
<li>Save the file
</ol>

<p>To modify Oregano1 to share the hotlist:

<ol>
<li>Load the file !Oregano.!Run into your favourite text editor, and find the line
<br><code>Set Oregano$Bookmarks OreganoChoices:Bookmarks</code>
<li>To share the hotlist between Oregano and Browse, change this line to:
<br><code>Set Oregano$Bookmarks &lt;Choices$Write&gt;.WWW.Browse.Hotlist</code>
<li>To share the hotlist between Oregano and Fresco, change the
&quot;OreganoChoices:Bookmarks&quot; to the location of the Fresco hotlist
(this is given in the file !Fresco.Config in the line beginning &quot;files.hots&quot;).
<li>Save the !Oregano.!Run file.
</ol>

<p>Although this mechanism will allow Oregano to share a hotlist with Browse or Fresco,
the !Run file is typically overwritten during an upgrade and the modification will hence
be lost. It will therefore be necessary to re-apply the edit after each upgrade.

<p>To share the hotlist between all three browsers, apply <em>both</em> procedures - i.e. edit the !Fresco.Config file and the !Oregano.!Run file.

<p>
<b>After changing from Fresco or Oregano to the &quot;Shared&quot; option, 
it is essential that you start BookMaker and save the hotlist <i>before</i>
loading Browse. Failure to do so may result in the folder names being
corrupted. </b>

<p>
<i>Changing this preference will have no effect while BookMaker is running.</i>

<p>&nbsp;<p>

<a name="browser_interface"></a>
<h3><a href="#preferences">Show Hotlist</a></h3>
<p>
If the configured browser is Fresco or Browse, BookMaker can be automatically invoked when the
&quot;Show Hotlist&quot; button in the browser's toolbar is clicked - this is courtesy of Christina
West's HotClickX module. This control allows you to specify which mouse buttons will invoke
BookMaker in this way.

<p>Oregano is designed to work with BookMaker, so this option is not relevant.

<p><i>Changes to this preference will take effect immediately.</i>

<p>&nbsp;<p>

<a name="warn_unsafe"></a>
<h3><a href="#preferences">Warn of unsafe saves</a></h3>
<p>
The integration of BookMaker with certain browsers is less than ideal - any
hotlist changes saved by BookMaker can be overwritten by the browser when it
exits. These problems can be avoided if the browser is quit before saving from
BookMaker
<p>Selecting this option will result in a reminder warning being displayed
when an attempt to save changes is made that may cause problems.
<p><i>Changes to this preference will have no effect while BookMaker is
running.</i>

<p>&nbsp;<p>

<a name="email_client"></a>
<h3><a href="#preferences">Select Email Client</a></h3>
<p>
BookMaker provides support for the !Posty, !Messenger, !Marcel and GMail email clients.
Select your preferred client from the pull-down menu.

<p>
<i>Changing this preference will have no effect while BookMaker is running.</i>

<p>&nbsp;<p>

<a name="messenger_public"></a>
<h3><a href="#preferences">Public only</a></h3>
<p>
If the configured email client is Messenger, selecting this option will ensure that
only those addresses in the Public address book are visible (i.e. BookMaker will not
display user-specific address books).

<p>
<i>Changing this preference will have no effect while BookMaker is running.</i>

<p>&nbsp;<p>

<a name="ftp_client"></a>
<h3><a href="#preferences">Select FTP Client</a></h3>
<p>
BookMaker supports the Voyager FTP client and !FTPc. Select your preferred client from
the pull-down menu.

<p>
<i>Changing this preference will have no effect while BookMaker is running.</i>

<p>&nbsp;<p>

<a name="telnet_client"></a>
<h3><a href="#preferences">Select Telnet Client</a></h3>
<p>
BookMaker supports the Voyager Telnet client, !FreeTerm and !Nettle.
Select your preferred client from the pull-down menu.

<p>
<i>Changing this preference will have no effect while BookMaker is running.</i>

<p>&nbsp;<p>

<a name="needs_ole"></a>
<h3><a href="#preferences">Needs OLE Support</a></h3>
<p>
If the configured Telnet client is FreeTerm, BookMaker provides an easy
way to load script files into a text editor without having to search inside
!FreeTerm; however, this requires the use of a text editor that supports
Object Linking and Embedding (OLE). Both Zap and StrongEd are OLE-aware, but
the standard !Edit is not. However, !Edit can be made to function as if it
supported OLE if the OLESupport module is running. Selecting this option will
make BookMaker load the OLESupport module when BookMaker is booted, if the
module is available in the system's modules directory.

<p>
<i>Changing this preference will have no effect while BookMaker is running.</i>

<p>&nbsp;<p>
<a name="confirm_book"></a>
<h3><a href="#preferences">Confirm Delete Book</a></h3>
<p>
Selecting this item will make BookMaker ask for confirmation before deleting a book.
<p><i>Changes to this preference will take effect immediately.</i>

<p>&nbsp;<p>
<a name="confirm_addr"></a>
<h3><a href="#preferences">Confirm Delete Address</a></h3>
<p>
Selecting this item will make BookMaker ask for confirmation before deleting an address.
<p><i>Changes to this preference will take effect immediately.</i>

<p>&nbsp;<p>
<a name="confirm_discard"></a>
<h3><a href="#preferences">Confirm Discard Changes</a></h3>
<p>
If there are outstanding (unsaved) changes when you quit BookMaker, this item will make
BookMaker request confirmation that you wish to discard these changes.
<p><i>Changes to this preference will take effect immediately.</i>

<p>&nbsp;<p>
<a name="hotkeys"></a>
<h3><a href="#preferences">Hotkeys</a></h3>
<p>
This group allows you to alter the keyboard accelerators (aka &quot;hotkeys&quot;) used by BookMaker.
The functions that can be invoked via keyboard accelerators are:
<p>
<ul>
<table border="3" cellpadding="2">
<tr>
<th>Function</th>
<th>Default key</th>
</tr>
<tr>
<td>Help</td>
<td align="center">F1</td>
<tr>
<td>Preferences Help</td>
<td align="center">^F1</td>
</tr>
<tr>
<td>Preferences</td>
<td align="center">F6</td>
</tr>
<tr>
<td>Save</td>
<td align="center">F3</td>
</tr>
<tr>
<td>Delete</td>
<td align="center">Backspace</td>
</tr>
<tr>
<td>Find</td>
<td align="center">F4</td>
</tr>
<tr>
<td>Find again</td>
<td align="center">^F4</td>
</tr>
<tr>
<td>Quit</td>
<td align="center">^Q</td>
</tr>
</table>
</ul>

<p>
To change the key used to invoke a function, enter the new key name into the appropriate field.
Most key names will be correctly recognized (e.g. TAB, BACK or BS for Backspace, ENTER, etc).

<p>The&quot;hat&quot; character (^) indicates the use of the control key (i.e. ^Q is Ctrl-Q,
^F1 is Ctrl-F1), while Shift is indicated by the character generated by Alt-139 (this may be
displayed oddly, as it is outside the normal ASCII range).
<p>
When the preferences window is closed, you may see the error &quot;One or more hotkeys ignored&quot;.
This means that the key name(s) specified for one or more of the hot keys was not recognised. Should
this occur, the key names mapped to those particular functions will be unchanged from their previous
settings.

<p>
<i>Changing this preference will have no effect while BookMaker is running.</i>

<p>&nbsp;<p>
<a name="help"></a>
<h3><a href="#preferences">Help button</a></h3>
<p>This button will open this help file in a browser window.

<p>&nbsp;<p>
<a name="buttons"></a>
<h3><a href="#preferences">Action buttons</a></h3>
<p>
This group of buttons are used to control the Preferences dialog box.
<ul>
<li><b>Cancel</b>: Close the dialog box without making any changes.
<li><b>Restore</b>: Update the display to show the current preferences.
<li><b>Set</b>: Set the preferences for the current session only.
<i>This button is faded for !BMConfig.</i>
<li><b>Save</b>: Change the preferences permanently.
</ul>

<a href="index.html">Back to main Help.</a>
</body></html>