STAR4WIN CONFIGURATION

Rather than keeping configuration parameters in the Windows registry, Star4Win keeps them in a special initialization file called config.str. This file may contain both information needed for StarLing (most of which is ignored by Star4Win) and for Star4Win (most of which is ignored by StarLing). config.str is an ASCII file which can be edited by any text editor, including STAR4WIN itself. However, since the file contains many special and control characters, different text editors may handle them in different ways. A general recommendation for those who wish to modify their config.str file is: use the DOS version of STARLING (starling.exe or realstar.exe) to do that. This guarantees the safest processing of various control codes.

config.str consists of lines with the general structure:

PARAMETER = ...

Every time Star4Win is initialized it reads the configuration parameters from config.str. Different configuration files may be stored in different folders (directories), and Star4Win first loads its inner default parameters, next corrects them according to the config.str which is stored in its home folder (the folder where the program star32.exe is located), and finally corrects them according to the config.str which it may find in the current directory.

By now the following parameters are valid:

AUTOSAVE
Specifies the time (in seconds) before making a backup copy of the text file edited, e.g.: AUTOSAVE = 300 (the default setting). So far the backup copy is stored in the same folder with the same name as the edited file but preceded and followed by #.
CJK_FONT
Specifies the name and parameters of a Unicode CJK (Chinese/Japanese/Korean) font. The format of this line is like this:
CJK_FONT = 1, big5.tbl, UWCXMF (Big5), BIG524.dbf, Big5
Here 1 is the number of the font (from 1 to 7), corresponding to the respective number of the StarLing font (in this case big524.chr); big5.tbl is the name of the encoding file translating Big5 codes to Unicode and vice versa; UWCXMF (Big5) is the name of the Unicode font containing Chinese characters; BIG524.dbf is the database file containing Chinese readings; Big5 is the encoding parameter.
You may use up to 7 CJK fonts with STAR4WIN. The standard CJK package (starcjk.exe) contains fonts for Big5 (Traditional non-simplified Chinese characters), GB (the Beijing simplified Chinese characters) and JIS (Japanese characters).
CONSULTn
E.g.:
CONSULT1 = database1
CONSULT2 = database2, field1
CONSULT3 = database2, field3
Lines like this will enable you to search for the word under cursor by pressing Shift F1 - in the database1, by pressing Shift F2 - in the field field1 of the database database2, etc. Note that if you specify a particular field it requires that the database should be sorted on this field - otherwise search results will be incorrect. If you do not specify any field the search will be performed on the whole database, and may be continued by pressing, as usual, F4.
DICTIONARY
Specifies the location of Russian and English dictionary files (Z_... and M_...).
Example:
DICTIONARY = C:\STAR\DICT
EXTRACT
Specifies the sequence of comma-delimited characters (or sequences of characters) that will be ignored during search, sort and index procedures, as well as within the ALIKE() function.
Example:
EXTRACT = ´,°,¯
FONTSIZEMAX
Specifies the standard font size in points.
Example:
FONTSIZEMAX = 12
If this parameter is not specified, the default font size is 10 points.
FONTSIZEMIN
Specifies the condensed (small) font size in points.
Example:
FONTSIZEMIN = 10
If this parameter is not specified, the default condensed font size is 8 points.
KEYBOARD
Specifies the name of the file containing current keyboard settings. Provided with the system is a file called keyboard.dbf. It is in fact a database file, containing the following fields: LEFTSHIFT, RIGHTSHIFT, ALT, CTRL, ALT1LS, ALT1RS, ALT1ALT, ALT1CT etc. (up to ALT5CT). This means that you can configure as many as six keyboard registers, and within each of them you can switch between four subregisters by pressing left Shift, right Shift, Alt or Ctrl keys. Switching between 6 main registers is done by simultaneously pressing Alt and figure keys (Alt 1, Alt 2... etc.); returning to the default register is done by pressing Alt 0.
Note that it is possible to program any single key for a string of any length (not just a single letter). The length of a string is confined only by the length of fields in keyboard.dbf (by default - 6 letters maximum). If you are experienced enough in database handling, you may modify the structure of keyboard.dbf so as to meet your requirements.
You may devise your own alternative keyboard definition files and enter their names in the config.str as follows: KEYBOARD = MYNAME.KBD
Example:
KEYBOARD = C:\STAR\KEYBOARD.STR
NUMERIC
NUMERIC = ON lets the system show all numeric fields. NUMERIC = OFF hides them all.
ORDER
Specifies the string of letters regulating alphabetic order for the ORDER() function.
If you want, e.g., to make the letter b immediately follow the letter c, just place b immediately after c in this string and delete b in its original place. After that, when you will sort or index your database files using the ORDER() function, your data will be automatically positioned in the specified alphabetic order.
See the description of the ORDER() function to learn more about sorting in Star4Win.
Example:
ORDER = "ABCDEFGHIJKLMNOPQRSTUVWXYZ€aƒ„…bcˆ‰Š...."
RATE
Specifies the t replacement rate for glottochronological calculations (the default value is 0.05).
SYSCOLORS
SYSCOLORS = ON (default setting) lets the program use the current system color set. The setting SYSCOLORS = OFF allows the user to choose his own color set.
TOOLBAR
TOOLBAR = ON (default setting) makes the toolbar visible. TOOLBAR = OFF turns it off.
VARWIDTH
Specifies the width of variable fields used in INDEXing, SORTing and LISTing procedures. Increasing this figure will increase the precision of indexing but will also increase the size of index (.ntx) files.
Example:
VARWIDTH = 10
WINFONT
Specifies the name of a TrueType Windows font used in Star4Win.
Star4Win is constantly converting the default StarLing encoding into the encoding used in Windows fonts and vice versa. Therefore for every TrueType font a special file with the extension LST (which can be edited like any text file) is used.
The main font is introduced by the line:
WINFONT = c:/star/convert/standard.lst, Times New Roman Star, Lucida Console Star

Here standard.lst is the name of an auxiliary file with a recoding table from DOS STARLING format into STAR4WIN and vice versa; Times New Roman Star is the basic font file (used in the default "graphic" mode), Lucida Console Star is the font used in "text" mode.
Other fonts may be also introduced on separate lines as follows:
WINFONT = c:/star/convert/arab.lst, PersianNaskh Star
WINFONT = c:/star/convert/greek.lst, GreekMousa Star
Note that the main font can be a Unicode font. You may, for example, use the file arial.lst (provided in the setup package), specially shaped for the Arial Unicode MS font. Additional fonts (for the time being) are symbol fonts containing a maximum of 256 characters each - although we plan to adjust them for Unicode as well in the nearest future.

The FUNCTION and MACRO parameters of StarLing are not yet included into Star4Win, due to certain Windows keyboard restrictions, but may become available later.

The following parameters are obsolete, because of a complete change in the output system of Star4Win: COLOR, GRFILE, GRFILE2, GRFONT, HIGHDIA, HYPHENATE, LOWDIA, MEMOWIDTH, OFFSET, PRFILE, RESIZE, SCROLL, STARKEYS, TABULATION, TEXTMODE, TEXTROWS, TFONT, VIDEOMODE.