PocketVoc

PocketVoc Version 1.42

THIS SOFTWARE IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND. THE AUTHOR DISCLAIMS ALL WARRANTIES, EITHER EXPRESS OR IMPLIED, INCLUDING THE WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DAMAGES WHATSOEVER INCLUDING DIRECT, INDIRECT, INCIDENTAL, CONSEQUENTIAL, LOSS OF BUSINESS PROFITS OR SPECIAL DAMAGES.
Even though PocketVoc is freeware, it is not in the public domain, I reserve all rights to it. You may freely distribute copies of PocketVoc as long as you do so in an unmodified form and include all files and documentation that are present in the original archive. You may not charge for the distribution of PocketVoc other than a reasonable fee to cover your distribution costs.

Author

mailto:hfr@hfrmobile.com

http://www.hfrmobile.com

Contents

Training options

Frequency & time limit

Menu	Description
File	New Makes PocketVoc ready to create a new vocabulary file. The file is created when the user uses the menu item File\|Input.
	Open Opens a vocabulary file. A vocabulary file must contain four or more vocabulary lines otherwise it is treated as invalid and the following error message will be displayed: "Invalid vocabulary file." You can open the last nine files using Recent files.
	Input Input words into a vocabulary file (a vocabulary file is a text file with special syntax). You can determine a text editor using Options\|Settings.
	View Read words from a vocabulary file. You can determine which viewer is used using the Options\|Settings menu item.
	Start training Starts a vocabulary training. A Vocabulary file must be opened. You can use the "< I know it! >" button but it might be more useful if you using the return key to finish your inputs because the button is hidden by the input panel during a vocabulary training.
	Stop training Stops the current vocabulary training. You will lose the current training state. The next training will start at the beginning.
	Pause training Suspends the current vocabulary training. This menu item is only available: during an active training if this feature was enabled by Options\|Advanced Settings>'Enable Pause Training...'
	Recent files Enables you to open the last nine files. If the selected file is not available an error message is displayed and the file is removed from the menu.
	Quit Closes PocketVoc without asking for saving files because PocketVoc does not open files for editing.
Options	Training options Some basic training options.
	Training Determines Frequency & time limit for answering words.
	Settings Specify text editor text editor and name of langauges.
	Advanced Settings Some advanced settings.
Help	Index Opens this help.
	About PocketVoc Displays program, version and Copyright information about PocketVoc.

Vocabulary file
A vocabulary file is just a text file with a special syntax. Vocabulary files have the extension ".vok".

Syntax of a PocketVoc vocabulary file:

; Comment
@Command
Wordsleft : Wordsright

A word may also contain brackets which are treated correctly in a vocabulary training. The behavior how words are treated can be specified with the menu Options|Training options.

e.g. for the word Word(s) following answers are possible: Word, Words.

Comment lines, empty lines are ignored.

Syntax for a word:

xx[*]xx[(xx[*]xx)]

The xx stands for any character (e.g. a-z, A-Z, Ä, Ü, Ö, â, Â, ...)

Note: Nested brackets are not supported. e.g. test(ab(cd)) is not valid! Correct would be: test, test(abcd), test(ab).

Syntax for a @Command:

@XXX[=Value]

@Commands
These commands enables you to specialize vocabulary files e.g. if you learn more than one language. It is also possible to learn foreign words of your own language, countries and their capitals etc.

Some samples of such specialized vocabulary files can be found in "PocketVocSamples (Version major.minor) (English).CAB".

CAUTION: In this version @Commands are still not supported (but it's sure that they come ;-))

Training options
Using the trainings option dialog you can setup some important settings for your vocabulary trainings. Using this dialog is only possible if there is no active training.

Ignore separators
Entered separators are ignored. A separator is a * which indicates where words can be separated e.g. con*tain. It is optional to enter separators. Default setting is no.

Remove spaces
Ignores spaces and tabs. It is highly recommended to use this option.

Case insensitive
If this option is used PocketVoc does not distinguish between capital letters and small letters. These special letters are also treated correctly: ä ö ü á é í ó ú â ê î ô û.

Show correct words
Displays answers even you have answered correctly. This makes sense because for some words more than one answers are possible and so you also learn other possible answers.

Direction
In this version only "One after other" is possible.

Translation direction
Determines which language is translated to the other language.

Training
The training dialog can be used to determine frequency and time limit for answering words.

Debit
With "Debit" you can specify how often the word must be answered correctly so that it can dropped out from the training. If a answer was wrong you have to answer this word one more time. So words are asked more frequently if you don't know them.

Max
The upper limit of Debit.

Attempts
Determines how many attempts you have to translate a word.

Time
Number of seconds you have to translate a word.

Settings
Using this dialog you can specify which text editor and viewer should be used to edit or view vocabulary files. Default setting for both is notetake.exe (Note Taker). If you specify another editor you may have to provide the whole path to the ".exe" file.

Further you can specify the name of languages you learn. If the @Commands @leftlang and @rightlang are used in the current vocabulary file the values from the file are used for some PocketVoc dialogs.

Advanced Settings

Enable 'Pause Training...'
If this option is enabled the user can suspend a training and continue it at a later time.

Add space after input
After you have typed your word(s) and committed them a space is added at the end. This space should avoid that the word completion of Windows CE remembers invalid words. Only available if "Quick Input" mode is not enabled.

"Quick Input" mode
Available since Version 1.4! Displays a combo box instead of a simple text box for input. Since the combo box contains all possible values you can answer by selecting the correct word(s) instead of typing the word(s). If Quick Input is enabled the input panel will not be displayed.

History

Version	Description
1.42	improved setup internal improvements for WM5 and WM6
1.41	adjusted for hfrmobile style guide fixed bugs
1.4	adjusted for hfrmobile.com improved help "Quick Input" mode
1.3	added support for Palm-size PC: SH3 added support for Pocket PC: MIPS, SH3 and ARM Look&Feel for Pocket PC's adjustments for Windows CE 3.0 / Pocket PC 2002 File type registration for ".vok" files (vocabulary files)
1.2	improved help internal improvements fixed bug displaying remaining words (occurred only if more than 99 words) registering PocketVoc file type (.vok) added advanced options (pause training, etc.)
1.1	improved help English version
1.0	first release only in German language (functionality from WinVok 3.0.3)