[Promotion-technology] Fwd: Testing JAWS scripts for NoteTab, WordPad, & Script Manager (fwd)

Tue Apr 3 17:26:40 CDT 2007

>Subject: Testing JAWS scripts for NoteTab, WordPad, & Script Manager
>
>Executable installer
>http://www.EmpowermentZone.com/kitsetup.exe
>
>Zip archive
>http://www.EmpowermentZone.com/kitsetup.zip
>
>I am seeking testers of a JAWS script library and editor interface
>documented below.  If interested, install all files in the JAWS user
>script folder, either with the executable installer or zip archive.  If
>you try the scripts and find them unsatisfactory for whatever reason,
>delete the files to restore use of the corresponding factory-supplied
>scripts in the All Users folder.
>
>If reporting a problem, please be as specific as possible about the JAWS
>version, Windows version, application, and task.  Describing a few steps
>that reproduce the problem is especially helpful.
>
>Jamal
>
>----------
>
>Homer Editor
>Public Beta
>April 3, 2007
>Copyright 2007 by Jamal Mazrui
>GPL License
>Contents
>
>Introduction
>Editing
>Navigating
>Querying
>Managing Files
>Miscellaneous
>Script Manager Specifics
>----------
>
>Introduction
>HomerKit is a free, open source set of tools to aid the development of
>scripts for the JAWS screen reader (version 6.2 and above).  It includes
>an extensive library of functions written in the JAWS scripting language.
>Functions promote access and productivity by JAWS users and script
>developers by exploiting MSAA (Microsoft Active Accessibility), the
>Windows Script Host, and the Win32 API.  The library is demonstrated by
>its application to create a consistent and convenient interface for
>certain editors that are based on a RichEdit control:  JAWS Script
>Manager, WordPad, and NoteTab Light, wich is freely available at
>http://www.NoteTab.com
>
>Homer features also work in Notepad with files under 64K in size.
>
>The source code is based primarily in two files:  Homer.jss, containing
>general purpose routines, and Editor.jss, containing RichEdit and user
>interface oriented routines.  A small utility, IniForm.exe, facilitates
>dynamic creation of dialogs that are not otherwise possible in the JAWS
>scripting language.
>
>Application-specific code is contained in the files Script Manager.jss,
>WordPad.jss, NoteTab.jss, and Notepad.jss.  Essentially, the editor
>interface for these applications is a subset  of commonly used features of
>the TextPal editor, available at
>http://www.EmpowermentZone.com/palsetup.exe
>
>The Homer library will be documented separately for script developers
>based on feedback, questions, and suggestions that help to refine it.
>Homer editor features, the focus of this guide, may be explained in the
>following categories:  editing, navigating, querying, managing files, and
>miscellaneous.
>
>----------
>
>Editing
>As usual, you may press Control+C or Control+X to copy or cut selected
>text to the clipboard.  The Homer interface tries to make an an
>intelligent guess when no text is selected.  In this case, the current
>line is assumed .  Press Alt+C or Alt+X to perform a copy or cut operation
>that appends rather than replaces text on the clipboard.
>
>An alternative way of selecting text uses F8 to mark the start of a
>selection.  Navigate to the end point by whatever means (arrow keys, find
>command, etc.) without having to hold down the Shift key.  Press Shift+F8
>to select text from the marked point.  Homer says the number of characters
>selected.
>
>Press Control+F8 to copy all text to the clipboard with a single command.
>Press Control+Space to select a chunk of text at the cursor position.  A
>chunk is defined as a contiguous sequence of non-space characters.  It may
>be more than what Control+Shift+RightArrow selects, since such word
>movement commands stop at punctuation marks.  Press Control+Space again to
>extend the selection to the next chunk.
>
>As usual, Control+V pastes clipboard text at the cursor position.  Press
>Control+Shift+V to insert the content of another file.  Press Control+N to
>start a new document, or Control+Shift+N to initialize one with clipboard
>text.
>
>Press Control+R to replace text and hear the number of matches.  Press
>Control+Shift+R to replace with a "regular expression" -- a complex but
>powerful syntax that permits almost any transformation of text.  Homer
>replaces within selected text, or all text if there is no selection.
>Press Control+Shift+E to extract parts of text based on a regular
>expression.  The matching parts are placed in a new editing window
>separated by a configurable, divider sequence of characters.
>
>As usual, Delete (without a selection) deletes a character in the forward
>direction, and Backspace deletes backward.  Control+Delete deletes forward
>by a word, and Control+Backspace deletes backward.  Control+Shift+Delete
>deletes from the cursor to the end of the line, and
>Control+Shift+Backspace deletes from the cursor to the start of the line.
>Alt+Shift+Delete deletes from the cursor to the end of the document, and
>Alt+Shift+Backspace deletes from the cursor to the top of the document.
>Alt+Backspace deletes the current line.  After deleting, Homer reads the
>new character, word, or line at the cursor.
>
>----------
>
>Navigating
>Press Home or End to go to the start or end of the line, and automatically
>hear the character there.  Press Alt+Home or Alt+End to go to the first or
>last non-blank character of the line.  Press Control+Home or Control+End
>to go to the top or bottom of the document, and automatically hear the
>line there.
>
>As usual, Control+F finds text in a forward direction.  Control+Shift+F
>reverses the search.  F3 repeats forward, and Shift+F3 repeats backward.
>Press Control+J to jump to a line, or Alt+J to repeat the jump with the
>previous number.
>
>Press Alt+RightArrow or Alt+LeftArrow to read by sentence.  Press
>Alt+DownArrow or Alt+UpArrow to read by paragraph.
>
>----------
>
>Querying
>Use the Address command, Alt+A or Alt+Delete, to hear the line, column,
>and percent position of the cursor in the document.  As usual, JAWSKey+T
>says the title of the editing window.  Press Alt+P to hear the full path
>of the current file on disk.  Press Alt+Shift+P to copy the path to the
>clipboard, permitting it to be easily pasted into dialogs of other
>aplications.  Press Control+Shift+P to copy to the clipboard a list of
>files that match a wildcard pattern yu specify.
>
>Press Alt+F8 to hear the whole document without moving the cursor.  Use
>the Quote Clipboard command, Alt+Apostrophe, to hear the textual content
>of the clipboard.  Press Shift+Space (or the usual
>JAWSKey+Shift+DownArrow) to hear selected text.   Use the Yield command,
>Alt+Y, to hear the number of bytes, words, and lines in the document.
>
>----------
>
>Managing Files
>Press Alt+R to open a file from the list of those recently used.  Press
>Control+L to add the current file to the list of favorites.  Press
>Control+Shift+L to remove it from that list.  Press Alt+L to open a file
>from the list of favorites.
>
>Press Control+K to set a bookmark at the cursor position.  Press
>Control+Shift+K to clear the bookmark (one per file).  Press Alt+K to go
>to the bookmark.
>
>As usual, press Control+S to save.  Press Control+Shift+S to Save As,
>giving the document a new name in the editor and on disk.  Press
>Alt+Shift+S to save a copy of the document under a different name while
>keeping the original name in the editor.
>
>----------
>
>Miscellaneous
>Press Control+W to turn word wrap on, or Control+Shift+W to turn it off.
>Press Alt+Shift+O to adjust editor options.  Use the Manual Options
>command, Alt+Shift+M, to directly edit additional options provided by
>these JAWS scripts.
>
>Press F4 to activate an editing window from a list of those currently
>open.  Use the Alternate Menu command, Alt+F10, to execute a script from
>an alphebetized list of those available.  Press JAWSKey+H to read a hot
>key summary in the JAWS virtual viewer, or Alt+Shift+H to read it in an
>editing window.  Press JAWSKey+H twice quickly to display this help guide
>in a web browser.
>
>Press F1 to load documentation for the application, or Alt+F1 just to
>confirm its version (the about box).  Use the Elevate Scripts command,
>JAWSKey+Control+F11, to update HomerKit to the current version available
>at
>http://www.EmpowermentZone.com/kitsetup.exe
>
>----------
>
>Script Manager Specifics
>JAWS Script Manager supports the features described except for word
>wrapping.  As usual, F2 goes to the next function or script, and Shift+F2
>goes to the previous one.  Control+I inserts a function, Control+Shift+I
>inserts a script, and Control+D adds documentation.
>
>Using Homer, delete the current script with Control+Shift+D instead of
>Control+Delete.  Select it with Control+Shift+Space instead of Control+R.
>
>Press Control+O to open a user file, or Control+Shift+O for a shared file.
>Press Control+S to save a user file, or Control+Shift+S for a shared file.
>
>You can quickly open either Windows Explorer or a command prompt in
>particular directories.  Press Alt+0 for Windows Explorer in the JAWS
>program folder, or Control+0 to open a command prompt there.  Press Alt+1
>for Windows Explorer in the user script folder, or Control+0 for a command
>prompt there.  Press Alt+2 for Windows Explorer in the All Users folder,
>or Control+0 for a command prompt there.
>
>Press JAWSKey+F5 to refresh text in an editing window containing a .jss,
>.jsd, or .jkm file.  If a .jss file (JAWS script source), Homer will sort
>the routines alphabetically, and place functions before scripts.  If a
>.jsd file (JAWS script dictionary), Homer will generate a new script
>dictionary based on the .jss file with the same base name, preserving
>existing Synopsis and Description entries.  If a .jkm file (JAWS key map),
>Homer will sort the key assignments alphabetically by script name.