User's Guide

By Andreas Garzotto
© 1995-2001 D&A Software

The Fine Print

As in most manuals, we have to start out with the stuff for the lawyers. While we must ask that you read this section, in general this is what it all means:

Copyrights and Trademarks

QUICK/LX, the QUICK/LX logo and the D&A Software logo are all trademarks of D&A Software. HP, HP 100LX and HP 200LX are trademarks of Hewlett-Packard Company. All other product names are copyright and registered trademarks / tradenames of their respective owners.

Limited Warranty

QUICK/LX is distributed on an "as is" basis. Neither D&A Software, nor the software author, guarantees this program to be free from defects and may not be held responsible for any losses caused, directly or indirectly, by the use of this software. If you are not completely satisfied with QUICK/LX within fifteen (15) days of purchase, you may receive a refund of your purchase price, when you return all items along with the proof of purchase. Further, since D&A Software does not have any direct affiliation with Hewlett Packard Co., future models of the HP Palmtop may not be compatible with QUICK/LX. D&A Software does not guarantee that updates will be available to maintain compatibility with future HP Palmtop models. Further, if updates are offered, an upgrade fee may be required. Your use of this program constitutes your acceptance of these terms.

Disclaimer of Warranty

With the exception of the Limited Warranty stated above, D&A Software, and the software author, disclaim any and all warranties, expressed or implied.

Use by the U.S. Government

RESTRICTED RIGHTS: Use, duplication, or disclosure by the U.S. Government is subject to restrictions as set forth in subparagraph (c)(1)(ii) of the Rights in Technical Data and Computer Software clause of DFARS 252.227-7013 or subparagraphs (c)(1) and (2) of the Commercial Computer Software Restricted Rights at 48 CFR 52.227-19.

SECTION 1 - INTRODUCTION

The HP Palmtop can be handy for entering almost any information that you can think of, but the small display and keyboard is often a limiting factor. However, most people find that they tend to enter the same information, use the same words and phrases many times in the course of their work.

QUICK/LX reduces the typing time by suggesting the rest of a word that you have partially typed. For example, when you type "sop", QUICK/LX displays "histicated" in a small window right next to the text you entered.

If you press the right arrow key (->), you tell QUICK/LX to accept the suggestion and QUICK/LX will complete the word "sophisticated" for you. You also can ignore the suggestion and just keep on typing. Thus, you will find that QUICK/LX is useful for entering long words, since you have only to type their beginning and QUICK/LX does the rest. With a carefully chosen set of words, you can reduce the needed keystrokes for entering text significantly. Also, you will find that QUICK/LX can correct your spelling or even run sophisticated macros to make using the Palmtop "QUICKer".

QUICK/LX can assist your typing in programs that run under the Palmtop's System Manager, as well as in DOS applications run in text mode.

1.1 How Does It Work?

QUICK/LX is a small TSR program that runs in the background and monitors all your typing both in applications that run under the HP100LX and HP200LX system manager and DOS applications in text mode.

QUICK/LX uses a dictionary file that contains the words or phrases that you want it to suggest. The file is saved as C:\_DAT\QUICK.DAT.

The dictionary file is a simple text file you can create and edit with any text editor, such as the built-in MEMO. Each line of C:\_DAT\QUICK.DAT, must contain a single word (or phrase).

Whenever you type a word that matches with at least the first two characters of any line in C:\_DAT\QUICK.DAT, QUICK/LX suggests that line.

We have provided you with a sample QUICK.DAT file to get you started. You can edit out the words you don't think you need and add new ones of your own.

NOTE:

If you are running the DEMO version of QUICK/LX, then you can only use the default dictionary provided with the demo. You can't add words or use the utility programs that are described in this manual. If you like what you see in the demo, you can order QUICK/LX (complete will the utilities) for $39.00 from D&A Software.
NOTE:
QUICK/LX works best with a relatively small dictionary file. If you add too many words, then QUICK/LX will make many suggestions that you rarely need. Therefore, to get the greatest benefit from QUICK/LX, you should develop a small, but well designed dictionary file with words you most often use.

1.2 How To Install QUICK/LX

First, you have to copy files contained on the distribution disk to your HP Palmtop.

We strongly recommend that you place the files in their own directory for easy access. You can create a new directory in FILER by entering the following key sequence on the Palmtop:

    {FILER}{MENU}{F}{T} C:\QUICK{ENTER}
The following files should then be copied into this directory:
    QCLEAN.EXE
    QUICK.COM
    QSYNC.COM
You should then copy QUICK.DAT into the C:\_DAT directory.

Next, you must add a line to the AUTOEXEC.BAT file. Assuming, you have copied QUICK.COM to the directory C:\QUICK, the entry in the AUTOEXEC.BAT file should look like this:

    C:\QUICK\QUICK.COM
Be sure you add this line BEFORE the system manager is started, i.e. before the line "100" (or "200"). If you don't have a AUTOEXEC.BAT yet, copy D:\AUTOEXEC.BAT to C:\AUTOEXEC.BAT (or to A:\AUTOEXEC.BAT if you use a SRAM or flash memory card) and D:\CONFIG.SYS to either C: or A: (depending on where you placed the AUTOEXEC.BAT file. Then edit the AUTOEXEC.BAT file as indicated above.

Finally, you have to close all open applications and reboot your palmtop by pressing {CTRL}, Alt and Del all at the same time. After rebooting, QUICK/LX is ready.

1.3 How To Use QUICK/LX

When using QUICK/LX, the following keys are special: If you press {CTRL}-Q in any situation, other than immediately after entering a word, QUICK/LX will display a small setup status window that will show the text: "Setup: QBlD". The letters indicate whether certain features are enabled or not: When the "Setup" window is displayed, if you press one of the keys q, b, l or d, the associated feature is toggled.

1.4 Using QSYNC

QUICK/LX copies the dictionary file into system memory and uses this copy during operation. Therefore, if you change any words in C:\_DAT\QUICK.DAT or add new words to it, QUICK/LX will not notice these changes automatically.

To gain access to the new changes, after editing QUICK.DAT, run the utility QSYNC.COM to tell QUICK/LX you have changed something. QSYNC will synchronize the file and the dictionary that is in memory. Also, if you add new words to the QUICK/LX dictionary by pressing {CTRL}-Q, the new words are not added to the file C:\_DAT\QUICK.DAT automatically (although they are available in the memory resident copy of the dictionary currently being used by QUICK/LX.) You have to run the QSYNC utility to tell QUICK/LX to save these changes to the file.

When you run QSYNC, the following happens:

  1. Any new words (added by pressing {CTRL}-Q or by the learning feature) are appended to C:\_DAT\QUICK.DAT.
  2. The QUICK/LX memory resident dictionary is reloaded from the C:\_DAT\QUICK.DAT file.
Thus, after running QSYNC, the file and the used dictionary are synchronized.

One easy method to run QSYNC, is to highlight it in FILER then press {ENTER}.

SECTION 2 - ADVANCED FEATURES OF QUICK/LX

QUICK/LX has many advanced features which are discussed in the remainder of this manual. Before going further, it is suggested that you try experimenting with the features of QUICK/LX that you have learned so far. Once you feel comfortable with the program, read on to discover the many new ways to get the most out of QUICK/LX.

2.1 Customizing the Dictionary

There are several features of the QUICK/LX dictionary file C:\_DAT\QUICK.DAT) which can enhance the usefulness of QUICK/LX:

Delaying QUICK/LX's Suggestion

Often you will find that you have many words in the dictionary which all start with the same first two characters. In such cases, QUICK/LX's first suggestion is usually not the one you want. Fortunately, you can tell QUICK/LX to delay making a suggestion for such words until you have entered more characters.

If a word in the dictionary starts with a digit, this digit tells QUICK/LX that it only should display a suggestion if at least that number of characters match with the entered word. For example, "3sophisticated" (without the quotes) requires at least the first 3 characters to match, i.e., you have to type "sop" before QUICK/LX will suggest the word "sophisticated". If there is no leading digit, the default of at least two characters must match.

Expanding Acronyms

QUICK/LX can also be used to expand acronyms or even your own special "shorthand." If you enter the line:
    4asap=as soon as possible
into the QUICK/LX dictionary, QUICK/LX will suggest "as soon as possible" when you enter the four characters "asap". If you accept the suggestion, the four characters "asap" will be removed and replaced by the text "as soon as possible".

QUICK/LX Macros

QUICK/LX is not limited to entering printable characters. It can press almost any key on the HP keyboard for you. If QUICK/LX finds the character '#' within a word or phrase in the dictionary file, it takes the next four digits as the hexadecimal value of a scan code to be entered.

For example, the line "3xxx=First line#1c0dSecond line" in C:\_DAT\QUICK.DAT has the following effect: When QUICK/LX sees you have pressed "xxx", it will remove the three x's and replace them with "First line", go to the beginning of the next line and enter "Second line". The sequence "#1c0d" is interpreted as a scan code to stuff. In this case, "1c0d" is the scan code of the {ENTER} key. For another, more complex example, add the following line to your C:\_DAT\QUICK.DAT file:

    @p=#0e08#7e83#7300#fe83#d500#b400#3e00#d600#1c0d
After you have saved the file, remember to run QSYNC to load it.

Now run MEMO and type a name, followed by a space and "@p". QUICK/LX will suggest to you the string of characters above. If you press the "right-arrow" key, the name preceding the @p will be searched in the phone book.

How did that work? To understand, let's look at what QUICK/LX entered step-by-step, examining each scan code:

  1. #0e08 is the "Backspace" which removes the blank after the name (the "@p" is removed by QUICK/LX.)
  2. #7e83 is the "Shift Make" which starts MEMO's cut / paste selection mode.
  3. #7300 the {CTRL}-{LEFT} combination, moves to the beginning of the previous word, thus, selecting the name.
  4. #fe83 "Shift break" releases the pressed shift key and completes the selection.
  5. #d500 "Copy" is the {Fn}-{=} key combination, which puts the selected name onto the clipboard.
  6. #b400 is the {PHONE} key which opens the phone book application.
  7. #3e00 is the {F4} key which, in PHONE, opens the "find" dialog box.
  8. #d600 is "Paste" ({Fn}-{+}) which pastes the name from the clipboard.
  9. #1c0d finally, presses the {ENTER} key and searches for the name.
When running the QUICK/LX macros above, the text shown in the suggestion window is not very easy to understand. In the example above QUICK/LX will display: "=#0e08#7e83#7300#fe8". However, there is an easy way to add a name for QUICK/LX to display instead of the macro itself. Simply add the name to be shown directly after the "=" character, and follow it with another "=" character.

For the previous example, the new line could be:

    @p=Phone=#0e08#7e83#7300#fe83#d500#b400#3e00#d600#1c0d
The string "=Phone" will be displayed, which makes it much easier to remember what the macro does.

These "QUICK/LX macros" have some very nice properties:

Note:
A 100LX / 200LX database called KEYCODE. GDB has been provided on the QUICK/LX distribution disk. Also, if you run the Shareware program BUDDY, you can find the keycodes by pressing {Fn}-K followed by the key. We wish to thank Mr. Ed Keefe for providing KEYCODE.GDB.

2.2 QUICK/LX Command Line Options

You can also customize QUICK/LX by starting it with optional parameters in the command line entered in the AUTOEXEC.BAT file. The following command line options are available:
/b
Do not beep when a suggestion is found.
/i
Ignore the case of the words.
/n
Do not write the sorted data back to the dictionary file. This allows you to find newly entered (and "learned") words easier, since they are all at the end of the file. However, if you use this option, QUICK/LX must sort the same words each time. Therefore, using this option will cause QUICK/LX to take longer to start, and QSYNC longer to run.
/c
Do not show the suggestion window in sysmgr applications if the graphics cursor is not shown. This prevents the QUICK/LX window from popping up in "strange" locations. However, it also prevents QUICK/LX from operating in 123 or DataComm since they do not use the graphics cursor.
/s
Allows scrolling through matching words by using the up and down arrow keys while a suggestion is displayed. You will see an arrow at the end of the suggested word that indicates there are more matching words available.
/a
automatically switch between the primary and the secondary dictionary (see Using Two Dictionaries)
/'n'
Makes a suggestion only if at least 'n' characters match with a word in the QUICK/LX dictionary. The default is 2.
/l'n'
Automatically adds all typed words that are at least 'n' characters long to the dictionary (learning mode). You also can toggle this feature online by pressing {CTRL}-Q l
/m'n'
If the learning mode is enabled (by /l), this option tells QUICK/LX how many times a word must be typed before it is added to the dictionary (the default is 1.) For example, if you start QUICK/LX with:
			    QUICK /l6 /m3
			
then words which are at least six characters long, are added to the dictionary once you have typed them at least three times since you started QUICK/LX (or run QSYNC the last time.)
/r'n'
Reserve 'n' bytes for new words that are added using {CTRL}-Q or the learning feature (the default is 512.)
/h'x'
Set the QUICK/LX hot key (default is {CTRL}-Q) to the key with the scan code 'x' (in hexadecimal). For example, use "/h1e01" if you want the {CTRL}-A to be the hot key.
/o'x'
Set the "accept" key (default is the right-arrow key) to the key with the scan code 'x' (in hex). For example, "/o0f09" will cause the {TAB} key to be the accept key.
The following is an example of a QUICK/LX command line in the AUTOEXEC.BAT file with a few command line options:
    QUICK.COM /b /3 /r2000
This will cause QUICK/LX to suggest a word if the first three characters match, and when showing the suggestion window, QUICK/LX will not beep. A buffer of 2000 bytes is allocated for new words.

Note:

If you use the "/l" option, it is recommended that the word buffer be enlarged with the "/r" option. A useful command line setting might be: "QUICK.COM /r2000 /l6 /m3".
In addition to the options listed above, QUICK/LX accepts a file name on the command line. If a file name is given, the dictionary data is read from that file instead of from C:\_DAT\QUICK.DAT. This feature is useful if you don't want to keep the dictionary on the "small" C: drive.

If QUICK/LX is already resident in memory and you run it again, it will unload from memory if this is possible (it is not possible if another TSR has changed interrupt 16h or 5fh).

2.3 QSYNC Command Line Options

QSYNC accepts a file name on the command line. If a file name is given, the dictionary data is read from that file instead of from C:\_DAT\QUICK.DAT. You will need to use this option if you specify a dictionary file name when you start QUICK/LX. You also can use this feature if you use multiple dictionary files.

If you start QSYNC with the /i option, it runs in interactive mode. In this mode, QSYNC will prompt you to confirm if each word which has been added to the dictionary in memory should be added to the dictionary file.

2.4 The QCLEAN Utility

If you use the /l option to automatically add new words to the dictionary, you can cause the dictionary file to quickly grow. Going through the dictionary file deleting or correcting words and prepending them with well chosen digits can be quite a bit of work. The QCLEAN utility allows you to detect and delete suspicious words (those which contain characters other than only letters) and add prepending digits.

To start QCLEAN, simply type QCLEAN{ENTER} on the command line, or select it in FILER and press {ENTER}.

If QCLEAN displays a suspicious word, you can either press {DEL} to delete it or {ENTER} to keep it. When QCLEAN finds a group of words that start with the same character, it suggests to you what to do with each of the words in the group. You can press {ENTER} to accept the suggestion, {DEL} to delete the word, or press the digit you want to have prepended.

As with QUICK/LX and QSYNC, QCLEAN accepts an optional file name that is used as the dictionary file instead of C:\_DAT\QUICK.DAT

QCLEAN Command Line Options

QCLEAN accepts the following parameters on the command line:
/a
Do not ask any questions while processing the dictionary. When using this option, a digit is prepended to every line in the file regardless if there was a digit or not. Also, QCLEAN will not suggest to delete any words.
/s
Group words (by prepending appropriate digits) that differ only in their endings, so that you can choose the words with the up and down arrow keys if you also start QUICK/LX with the /s option.
/m
Prepend digits so that the number of keys one has to press in order to select any word in the dictionary is minimal. This option is only useful if you start QUICK/LX with the /s option.
/'n'
Only prepend digits that are 'n' or higher. For example, /2 has the effect that the smallest prepended digit is 2, i.e., there will never be a '1' prepended.

2.5 Using Two Dictionaries

QUICK/LX supports two dictionaries. You can toggle between a primary dictionary and a secondary dictionary by pressing "D" in the setup window. If the primary dictionary is selected, QUICK/LX only suggests words from the primary dictionary and adds new words to it. If the secondary dictionary is selected, QUICK/LX only suggests words from the secondary dictionary and adds new words to it.

If QUICK/LX is started with the /a option, then it will automatically switch between the two dictionaries whenever you type a complete word which is contained in one of the dictionary lists. This feature is most useful if you write documents in two languages. QUICK/LX can then automatically detect which language you are using and use the appropriate word list.

Both dictionaries are kept within the same file. Words that belong to the secondary dictionary have a dot ('.') prepended. A simple example of a bilingual (German-English) dictionary file:

    .Anfang
    .rostig
    .3ziemlich
    3beginning
    quite
    rusty
Note that the dot must proceed any digits. Thus, it should be ".3ziemlich" and not "3.ziemlich".

SECTION 3 - QUESTIONS & ANSWERS

The following are frequently asked questions and our answers:

1) Why does QUICK/LX sometimes suggest a word while I am selecting from a menu (or in other strange places)?

QUICK/LX does not see in which application you are nor what you are currently doing. It just sees the keys you are pressing. For example, if you choose "Menu File Open" by pressing the keys "{MENU}FO", QUICK/LX sees that you have typed the characters "fo". If the word "format" is in your dictionary, QUICK/LX suggests it. Use prepended digits (typically the digit 3) in order to prevent this from occurring. You can also use alternate keys for entering commands (e.g. "{F9}" to open a file) or simply ignore such suggestions.

2) How come a word or phrase is sometimes truncated in the suggestion window?

Even though the words entered by QUICK/LX may be arbitrary long, only the first 20 characters will be displayed within the suggestion window in order to keep the window within a manageable size.

3) Why does QUICK/LX not recognize characters entered by Buddy such as double clicked upper case characters)?

If QUICK/LX is installed before Buddy, it cannot see the characters that Buddy enters. Load QUICK/LX after Buddy if you want that these characters are seen. However, note that Buddy cannot unload itself automatically when leaving the system manager if QUICK/LX is loaded after Buddy.

4) What does it mean when ***FULL*** is displayed instead of a suggestion?

When QUICK/LX initially starts, it reserves 512 bytes for new words (or the amount that you specify using the "/r" option). If you add words by pressing {CTRL}-Q or automatically by using the "/l" option, this space fills up until there is no space left for new words. In this case, the message ***FULL*** is shown. If this happens, it is best to run QSYNC and restart QUICK/LX so that new memory can be allocated. If you run into this problem often, simply increase the amount of memory allocated to the new word buffer by using the "/r" option.

5) Why does QUICK/LX display the ***FULL*** message, but when I run QSYNC, only a few words are appended to the dictionary?

This may happen if you use QUICK/LX with the "/m" option. For example, if you run QUICK/LX with the command line parameters "/l5 /m3 /r1000", then every word that is at least 5 characters long is placed into the new words buffer. Thus the 1000 bytes reserve is used up quickly. However, if you run QSYNC, only those words that you have typed at least three times are appended to the dictionary. You can solve this be either using a higher value than 5 for the /l option or a higher value for the /r option.

6) Why does QUICK/LX sometimes steal characters from the display when I am working with my communications program?

If you are using a DOS-based communication program, it is best to disable QUICK ({CTRL}-Q q) while on-line. QUICK/LX restores the background of the suggestion window whenever a key is pressed, assuming this is the only situation that leads to a change of the display. However, communication programs may change the display when something is received through the serial port. Note that you won't have that problem when using the built-in DataComm application.

7) How much memory does QUICK/LX need?

When QUICK/LX is started, it needs 64 KB memory. As soon as it terminates (after sorting the dictionary and processing the command line options), the part of QUICK/LX that remains resident needs about 4 kB plus the size of C:\_DAT\QUICK.DAT plus the size of the buffer for new words (512 by default).

8) How large may my dictionary file grow?

The maximum size of the dictionary is 48 kB.

9) How can I tell QUICK/LX not to make suggestions while in Filer, when speed searching or in other strange places?

Start QUICK with the /c option. Note that in this case, QUICK/LX will also not make any suggestions in 123 and DataComm.

10) Why does the /i option (ignore case) not work for some characters?

The ignore case option works correctly for ASCII characters, but not for international characters.

11) QSYNC tells me that the word buffer is too small. What can I do?

When QUICK/LX initially starts, it reserves 512 bytes for new words (or the amount that you specify using the /r option). If your dictionary file grows more than 512 bytes, the additional words cannot be accommodated. Unload QUICK/LX and restart it, so that it can allocate more memory. (If you start QUICK/LX from the AUTOEXEC.BAT file, simply reboot).

12) When I try to unload QUICK/LX it says: "Cannot unload QUICK" What does this mean?

Unloading QUICK/LX does not work if any other program started after QUICK/LX modified the interrupts 16h or 5fh (such as the System Manager) You first have to unload these programs before QUICK/LX can unload.

13) How can I make QUICK/LX type a '#' or a '='?

You cannot directly have QUICK/LX type these two characters since they are used by QUICK/LX for entering scan codes and abbreviations. If you want QUICK/LX to enter '#', use #0423, for '=', use #0d3d.

14) How can I get most out of QUICK/LX?

Edited by Avi Meshar, 15 March 2000