@node  preferences
@section Preferences
@cindex Preferences

To access the preferences of TOra you select the @strong{Edit|Preferences} menu item, you will then be presented with the following dialog.

@image{images/preferences,15cm}

In windows preferences are stored in the registry, but in Linux it is stored in a file called @file{.torarc} in the users home directory. If this file doesn't exist a file called @file{/etc/torarc} is used if it exists.

@subheading Selecting page

To the left is a list containing the available option pages you can display.

@menu
* General global settings: globalsettings.
* Editor settings: editor.
* Global database settings: database.
* Additional manuals in help browser: additionalhelp.
* Settings regarding enabled tools: toolsetting.
@end menu

The rest of the settings are tool specific and covered under corresponding tool in the tools section(@pxref{tools, Available tools}).

Selecting a page does not discard the changes of another page, and no changes are saved until @strong{OK} is pressed. You can always discard any changes made by pressing the escape key or the @strong{Cancel} button.


@node globalsettings
@subsection Global Settings

These may vary some depending on how your system was compiled and configured. Not all options are displayed in the screenshot since that was made on a KDE version of TOra.

@multitable @columnfractions .2 .8 
@item @strong{Custom SQL} @tab The file in which to store your custom SQL. For more information about custom SQL and the SQL dictionary (@pxref{sqledit,SQL Editor tool}. The string @strong{@env{$HOME}} will be replaced by your home directory on UNIX or documents directory in Windows.
@item @strong{Help directory} @tab Should point to where the TOra help table of contents file is stored (toc.html). This should be set up correctly if you made a normal install.
@item @strong{Default session} @tab TODO.
@item @strong{Cache directory} @tab Should point to where the TOra Disk Cache files are stored. There is one file for each Connection.
@item @strong{Change current connection with active window} @tab If this option is set, changing the current window will also change the current connection to that of the active window. The connection is only changed when you change window so if you want to change the connection to something else you can still do so as long as you don't change the window.
@item @strong{Save passwords} @tab 	Whether or not TOra should store the passwords used to connect. @strong{Be aware that the passwords are obfuscated only and stored in either the windows registry or a file.}
@item @strong{Include DB in caption} @tab	If this is set the database name will be included in the caption of all your tool windows after the tool name. Observe that there often is no other way of knowing which database the window works on except for this.
@item @strong{Restore session on startup} @tab	TODO.
@item @strong{Prefer TOAD key bindings} @tab	TODO.
@item @strong{Use Disk Caching} @tab	This option tells TOra to Cache the Object List in the Cache Directory. Default is No Caching. When Caching is activated, you have to refresh the object cache with the menu option File->Reread Object Cache, because, the default source for the Object List is the diskfile.
@item @strong{Display gridlines in results}  @tab	Show grid lines in output result window.
@item @strong{Display alerts in statusbar only}	 @tab Display errors only in the statusbar. This is really useful since it doesn't interrupt you as much as a dialog window as long as you know to look for information in the statusbar when things doesn't work.
@item @strong{Arrange Tools in Tabs}	 @tab	Display the different tools as tabs instead of separate windows in the main window.
@item @strong{Use Colors in Connections}	 @tab	Assign colors to existing connection identifiers or create new ones.
@item @strong{Multi-line results}	 @tab All tables in all tools (Schema browser, SQL editor, Session list etc.) will have multi-line cells if text contains more than one line or if it does not fit into one cell horizontally.
@item @strong{Connect history}	 @tab How many connection entries to save in the new connection history list.
@item @strong{Status message}  @tab	The number of seconds to display error messages in the status bar. If you specify 0 they are kept until the next message is displayed.
@item @strong{Message history}	 @tab The number of status messages to store in the status message history before the oldest are removed when new are added.
@item @strong{Chart samples}  @tab	Number of samples to save by default in charts.
@item @strong{Display samples}	 @tab The number of samples to display in line and bar graph charts.
@item @strong{Size Unit}  @tab	The unit to display sizes with in TOra.
@item @strong{Refresh}	 @tab The default refresh time to use in TOra. Tools which refresh automatically use this setting as the default. It can also be changed on a per tool basis.
@item @strong{Default list format}	 @tab The default format when exporting data in SQL Editor or Schema Browser.
@item @strong{Style}  @tab	The GUI style to use for the TOra application. This switch is only available for Qt only applications.
@item @strong{Translation}	 @tab Which translation local to use for TOra. Requires restart to take effect.
@item @strong{SMTP Server}	 @tab TODO.
@end multitable

