README file for JSonar (JAWS Scripts for Cakewalk Sonar), version 4.3

Copyright (©) 2006 JSonar Development Team: Victor Tsaran, James Teh and others
JSonar is subject to the terms and conditions of the GNU General Public License. The full text of the license can be found in the file license.txt distributed with these scripts.

Write us at JSonar@JSonar.org


*** Please READ ME before you ask questions! ***

If this is your first time using JSonar, please skim through this README file to familiarize yourself with features supported and, most importantly, for helpful tips and tricks to help you along the way.

To you: thanks for joining the JSonar community of users!

If you are upgrading from an earlier version of JSonar, please read the Revision History. It describes the changes made in each version of JSonar and may include useful information for those upgrading from earlier versions.


Contents of this README

  1. Credits
  2. Requirements
  3. Installation Instructions
  4. Supported Sonar Features
  5. Known Issues and Troubleshooting
  6. Tips and Tricks
  7. Revision History

Credits

The following people have contributed to this project:


Requirements

In order to use JSonar, you will need the following:


Installation Instructions

  1. If you are installing JSonar from a zip archive, please follow the manual installation instructions and then return to these instructions. If you installed JSonar using the installer, these steps have been performed automatically and you should skip this step. Please be aware that the installer is the recommended way to install JSonar. The zip archive should only be used in special circumstances and by advanced users.
  2. *** This step is essential ***
    Use Control+JAWSKey+R from a new Sonar project to start the "Setup Wizard", which enables the Sonar JAWS control surface plugin and trains JAWS to recognise track selection colours. You need only do this once, unless your display options change later. To create a new Sonar project, press Control+N.
  3. The following display settings are recommended, though are generally not essential. They can be set on the Appearance and Settings tabs of the Display applet in Control Panel.
  4. In order for some information to be read, certain toolbars must be enabled in Sonar. The visibility of toolbars can be toggled in the Toolbars dialog under the View menu. The following toolbars should be enabled to speak various information. Some are self explanatory, but notes have been included where this is not the case.

Manual Installation Instructions

If you installed JSonar using an installer, you can skip these instructions. If you decided not to use an installer but instead use a zip archive (not recommended), follow these steps after unzipping the scripts:

  1. Switch to the folder where you unzipped the scripts.
  2. Find and switch to the regkeys folder.
  3. Look for files with an extension .reg and the name containing your particular version of Sonar, e.g. the file with registry entries for Sonar 4.0 Producer Edition would be called "Sonar Producer 4.0 Accessibility Mode.reg".
  4. Press ENTER key on that file and answer positively to the two dialog boxes that are presented.
  5. Move back to the previous folder and switch to the surface folder.
  6. Copy the file named jsonar.dll to a non-temporary location on your system drive; e.g. c:\Program Files\JSonar 4.
  7. Register jsonar.dll in this new location with a command like the following from the Start menu->Run dialog:
    regsvr32 "c:\Program Files\JSonar 4\jsonar.dll"
  8. Now return to the normal installation instructions.


Supported Sonar Features

JSonar primarily supports the following features of Sonar:


Known Issues


Tips and Tricks

Here are some initial suggestions to help you along the way.


Revision History

The following is a summary of the changes in each revision. Note that there are most certainly other minor, less noteworthy changes, fixes, etc. not included here for brevity.

Key: new = new feature, bug = bug fix or work around, change = change in functionality.

4.3


4.2

4.1

4.0

4.0 beta 6


4.0 beta 5


 

4.0 beta 4 and prior