SpeechUtilities.com

• Homepage
• SayWhatPro                 
  • Recent Features
  • Registered version
  • Installation
  • Command Help
  • Purchase
  • Macros
  • Download
• User Comments
• My Mailing List
• Web Resources
• Deprecated

DatTools Command Help (V1.1)

File menu  Tools Menu Edit menu  View menu  Program  Scope  Group  Help menu Modify, Abandon, Save Changes

File

Open

This command will allow you to open a macro command file (.dat) other than  the current user's mycmds.dat. It is very handy for looking at the contents of Exported .dat files (or files you are about to Import). All commands of the Tools Menu will also work on any Opened file, thus allowing fine-tuning of Exported or about to be Imported files.

 

Print COMMAND list

This command will print a report that is basically a listing of COMMANDS (and/or LISTS) with MENU and STATE headings.

 

Export to dvc

This command will create a syntactically correct Dragon .dvc file. Handy for sharing or moving macros.

 

Export to pseudo dvc

This command will create a file in the legacy dvc format, but will also contain the new version 6 style commands (Advanced Scripting, etc.) as well. This is especially handy for studying groups of the new style commands. Of course, do not try to import this file.

 

Export to spreadsheet

This command will create a comma delimited file (.csv) capable of being imported into a spreadsheet.

 

The 4 previous commands all allow their output to contain one of the following:

• Everything--All user and Dragon-supplied macros
• Just this Group--Only the commands in the current Group
• Just this Program--Only the commands in the current Program
• Just this STATE--Only the commands in the current STATE
• Pick and Choose--You can select any or all of the commands in the current STATE

Also, any output can be sent to the printer, to a file which can be user specified, or to the Windows Clipboard.

In addition, the scope of the print/export will conform to the current View (below).

 

Reload current user mycmds.dat

Use this if you leave DatTools open while making a change (or addition) with the NatSpeak Wizards that you want to see reflected in DatTools. Unnecessary if DatTools is closed during Wizard (or user) updates since DatTools will automatically detect any changes when firing up again. Also use this to go back to your main production mycmds.dat file after doing a File, Open.

 

Re-Specify DNS path

Use this if you have multiple installations of NatSpeak and DatTools uses the wrong one (rare).

Restore user 'username' mycmds.dat

Available for Registered users only. The first time each day that you use DatTools to make a modification to the current users mycmds.dat file, DatTools makes a backup copy of that mycmds.dat file in a subdirectory with the name of your user in the DatTools installation directory. If for some reason, you need to restore your mycmds.dat file to an earlier version, this is the command for you.  This command is actually very handy for testing DatTools modifications. You can make wide sweeping modifications and if you don't like the results, you can Restore to an earlier version.  The saved version of the mycmds.dat file is separate and additional to the Restore files created by SayWhatPro for extra redundancy.

Backup user 'username' mycmds.dat

You can choose to say that "now" is the time to make a backup copy of the current users mycmds.dat file, rather than the first time that a modification by DatTools on this day has been made.

Properties

This command shows several attributes of the currently open .dat file.

Tools

The following commands are available to registered users. All of the following commands in this Tools menu allow their scope to operate on:

• Everything--All user and Dragon-supplied macros
• Just this Group--Only the commands in the current Group
• Just this App--Only the commands in the current application
• Just this STATE--Only the commands in the current STATE (Window)
• Pick and Choose--You can select any or all of the commands in the current STATE

Export

This command will allow you to do the same thing as the Command Browser Export, but with a whole lot more power and ease. Another powerful ability of DatTools is that it allows Appending to an existing .dat file (Dragon Browsers only allow overwrites). It will further prompt if an existing command should be replaced or not.

Rename Group

This command will allow you to Rename every occurrence of an existing Group to a new Group name.

Rename Program

This command will allow you to Rename every occurrence of an existing Program to a new Program name. It is only intended for situations where when you receive a newer version of a program, it actually changes the executable filename. Ex. wpwin9.exe to wpwin10.exe. When some programs give you a new version, they use the same executable filename, while others change the executable filename. In simpler dvc days, one could open up a dvc file, and change one little line to make your old macros work with the newer version. This feature will do this job in the mycmds.dat days. Because NatSpeak stores information other than the executable filename in the mycmds.dat file, this technique will generally not work for copying sets of macros to a completely different program.

Search and Replace

This command will allow you to do a .dat file-wide (or less) search and replace in the body of Advanced Scripting, KEYS and SCRIPT macros and LISTs. My motivation was that I got a new computer, and many drive letters embedded in macros needed to be changed. However, ANY text in these macros is available for searching and replacing.

 

Delete

This command will allow you to Delete all macros of a certain type.

Convert to 6.0

This command will change the .dat file header to that of version 6.0 AND change all occurrences of 'SendDragonKeys' to 'SendKeys' in Advanced Scripting commands. This command is particularly handy if you are Exporting macros to be used by someone using version 6.0. It can even be used to help you revert to 6.0 command handling (using dmcbrowser).

Convert to 6.1

This command will change the .dat file header to that of version 6.1 AND change all occurrences of 'SendKeys' to 'SendDragonKeys' in Advanced Scripting commands.

Edit

Find

Search through all commands for strings contained in:

• COMMAND or LIST names
• body of COMMANDS or LISTS
• specific STATE names

Match case--you may select to search for an exact case match.

 

You may search repeatedly forward and backward with "Find Again" (or F11 key) and "Find Previous" (or F12 key).

View

KEYs

Toggle on/off to show/not show KEYS type COMMANDs

 

SCRIPTs

Toggle on/off to show/not show SCRIPT type COMMANDs

 

LISTs

Toggle on/off to show/not show LISTs

 

Text and Graphics

Toggle on/off to show/not show Text and Graphic Commands

 

Macro Recorder

Toggle on/off to show/not show Macro Recorder Commands

 

Step-by-step

Toggle on/off to show/not show Step-by-step Commands

 

Advanced Scripting

Toggle on/off to show/not show Advanced Scripting Commands

 

All of the above

Turns on all KEYS, SCRIPTS, Text and Graphics, Macro recorder, Step-by-step, Advanced Scripting and LISTs

Only 1 of the above

Drops down a list to pick only 1 of the above.  This makes it very easy to turn off all of the above except for one type.

---

 

1 COMMAND with its LISTs

This is handy for easily viewing only 1 COMMAND and its referenced LISTs. Example: if the cursor were highlighting the following command:

<SelectOrDelete> <NextOrPrevious> <2To20> Words

When this command is selected, only 4 entries will be shown in the list:

• <SelectOrDelete> <NextOrPrevious> <2To20> Words
• SelectOrDelete
• NextOrPrevious
• 2To20

This makes it much easier to study individual components of a particular command. When this mode is active, Exporting can also only apply to this View if desired. This is especially handy for sending 1 command and all it's LISTs to another person or to be included in an e-mail message.

 

1 LIST with calling COMMANDS

This is sort of the corollary of the above. When this View mode is invoked with a LIST highlighted, it will then show all COMMANDS that reference that LIST.

Program

This command allows you to choose which application (MENU) to display macros for. Everyone has a Global Commands application.

Scope

This command allows you to choose the Scope to display from the current application. I have defined an application-specific STATE for newly created application-specific macros.

Group

This command allows you to choose which Group to display. Everyone has at least 2 groups (Dragon and User-defined) and more if you have defined them.  Think of this menu item as being similar to the View menu. The implementation has been improved to then only show Programs and Scopes in the selected Group.

Help

About

Information about DatTools.

 

Command Help

This document.

License

The fun part.

Modify, Abandon, Save changes

Modify

This grouping allows you to make changes to individual Advanced Scripting, SCRIPT, and KEYS macros (and LISTs), similar to SayWhatPro, but different in the fact that the method used to make the change is by writing out the changes directly to the open .dat file (rather than automating an Import script through the Command Browser). This opens up the ability to do "off-line" editing of .dat files, (either of a mycmds.dat file, or an Exported .dat file).