#[

KRDOS has many config options, which you can set or modify in this file.
If you simply want to use the default settings for KRDOS,then you do not
need to change anything in this file.

Note: This file is updated frequently to work with the latest build of
this branch of KRDOS, currently at build 2017.03.15.

Don't try to include DOS config.sys or config.nt settings like KEYB= and
DEVICE=, that won't work!

Settings Key
------------
<value>: A numeric value or string.
[value]: Parameter is optional.
val1|val2: Supply one (no |).

Comments can be added to this file in three ways:

]#
REM Single-line comment
# Also a single-line comment
#[ Block or multi-line comment ]#
#[
Settings that begin with "REM" or "#" are inactive, meaning that default
setting is in effect. Remove "REM" or "#" to activate/change a setting.

The only exception to this is that you can optionally turn on a KRDOS
specific setting using the syntax "REM KRDOS:[setting]", which can be
useful if you want both KRDOS and original KRDOS use the same config file.
----------------------------------------------------------------------------

Memory
======
The first 64KB (low) memory is included in KRDOS by default.
You may want to turn it off if some very old DOS programs (e.g. WordPerfect
Office 3.0) report the "Packed file is corrupt" message. In this case only
about 575KB (instead of 640KB) conventional memory can be used in total:
]#
rem LOW = OFF
#[
160KB of upper memory (UMB) is available by default.
You can mainly use this for loading TSR's with the LH/LOADHIGH command.

16MB XMS memory is by default provided by KRDOS.

If your program supports more or a different type of memory, you can change
this by XMEM = [+]<MB> XMS|EMS|EXT.
]#
rem XMEM = 63 XMS
#[
The maximum XMS memory supported by this option is 255MB. If the XMS memory
specified by this option is 16MB or greater, then XMS version 3.0 will be
reported by KRDOS, or else XMS version 2.0 is reported. The maximum EMS
memory supported by this option is 63MB, and the EMS memory provided by this
option is LIM EMS 3.2 memory. To use LIM EMS 4.0 memory in KRDOS, make
sure the XMS memory is enabled here (16MB by default) and load the included
EMSMAGIC.COM, which will by default automatically convert half of the XMS
memory provided here (up to 32MB) to LIM EMS 4.0 memory, and if XMS version
2.0 is reported then it will automatically convert the rest to XMS 3.0 too.
The optional plus sign adds the first 64KB of the graphics adapter to the
640KB conventional memory.
Caution: you can't use graphics if this is set, it will override/destroy
this extra memory!
<MB> is 1-256. Note: bare EXTended memory is rarely used. Only set this
option if you're completely sure it is needed.

Mouse
=====
In text mode the standard DOS mouse features are disabled by default (Some
DOS programs handle the mouse badly, being able to leave the window).
To enable the DOS mouse:
]#
rem MOUSE = ON
#[
Mouse wheel movements can be automatically converted into keyboard presses
in KRDOS. By default, the standard vertical scrolling is converted into
up and down arrows, but with the WHEELMOD directive you can customize the
keys. You may optionally also specify a second value if your mouse supports
horizontal scrolling (it's converted into left and right arrows by default).
Note that you can switch the two scrolling methods by pressing the middle
mouse button and either the left or the right mouse button at the same time;
the original behaviors can be restored by pressing the middle mouse button
alone. To customize the converted key presses of the mouse wheel movements:
(0: disabled; 1: up/down arrows; 2: left/right arrows; 3: PgUp/PgDn keys;
4: Ctrl+up/down arrows; 5: Ctrl+left/right arrows; 6: Ctrl+PgUp/PgDn keys;
7: Ctrl+W/Z, as supported by WordStar and MS-DOS EDIT. Default: 1,2)
]#
rem WHEELMOD = 1,3
#[
Left and right mouse button clicks can also be automatically converted into
keyboard presses such as the Enter key and the ESC key in KRDOS. This is
enabled only if you don't set MOUSE=ON by default, but you can turn this
feature on even if MOUSE=ON is set by putting a minus sign in front of the
mode number(s), e.g. "CLICKMOD = -1,-4". To customize the converted key
presses of the left and right mouse button clicks (0: disabled; 1: Enter;
2: Space; 3: Tab; 4: ESC; 5: BackSpace. Default: 1,4):
]#
rem CLICKMOD = 2,5
#[
In KRDOS you can also choose to automatically hide the mouse pointer
when typing. The mouse pointer will reappear when you move the mouse or
click the mouse button. The directive AUHIDEMS stands for AUto HIDE MouSe:
]#
rem AUHIDEMS = ON
#[
In VGA mode when you run programs with mouse support, there may be cases
that the KRDOS and VGA mouse pointers do not overlap in the vertical
direction. If you encounter this problem when the mouse is enabled:
]#
rem VGAFIXMS = ON
#[
PC speaker
==========
By default, KRDOS has basic sound support through internal PC speaker.
To turn PC speaker support off:
]#
rem SPEAKER = OFF
#[
Cursor blinking
===============
Original KRDOS does not support cursor blinking. Cursor blinking is on in
KRDOS by default, but to turn it off:
]#
rem BLINKC = OFF
#[
Keyboard speed
==============
By default, KRDOS uses the keyboard speed settings in the Windows Control
Panel. You can change the keyboard repeat delay and interval in milliseconds
here to override the Windows defaults. In this case you need to set both
KEYDELAY and KEYINTER in order to take effect (0 = use Windows settings):
]#
rem KEYDELAY = 400
rem KEYINTER = 20
#[
Keyboard INT9/IRQ1 support
==========================
Original KRDOS does not provide support for enhanced keyboard handling
through INT9/IRQ1. KRDOS provides two modes for keyboard INT9/IRQ1
support. It is generally fine to use the default setting, which is 2.
However, you can change it to 1 in case you want to map certain keys in
XyWrite/Nota Bene, or to 0 to disable INT9/IRQ1 support:
]#
rem KEYMODE = 1
#[
Windows Key
===========
The Win key is normally used when doing some special operations in KRDOS.
For instance pasting text is done by Win+Ctrl+V, the Win key is required so
DOS programs get and can handle Ctrl+V. If your program has no need for
Win+Ctrl+ combinations, and you prefer to use Ctrl+ without the Win key (or
your keyboard does not have this key), then you may want to turn this OFF.
Note that with WINKEY = OFF you have to break with Ctrl+Shift+C instead of
Ctrl+C, move the window with Ctrl+Shift+left mouse button instead of Ctrl+
left mouse button, and so on; also note that when in the KRDOS command
line you may in fact paste with Ctrl+V even if you do not set WINKEY = OFF.
]#
rem WINKEY = OFF
#[
Long Filename support
=====================
KRDOS supports both traditional DOS 8.3 short file names (SFN) and
Windows-style long file names (LFN). Long filename support is enabled by
default in KRDOS so that LFN-compatible programs (e.g. the 4DOS shell)
can make use of it. While not recommended, you can turn it off with the LFN
option in case you want support for short file names only. When LFN is OFF,
the FILTER83 = ON option mimics the original KRDOS behavior to filter out DOS
8.3 names that have corresponding long names. When LFN is ON, this option
filters out files/directories that do not have corresponding DOS 8.3 names:
]#
rem LFN = OFF
rem FILTER83 = ON
#[
Date/time synchronization
=========================
By default, KRDOS always synchronizes date and time with the host system
just like in original KRDOS. You can disable this behavior in KRDOS so
that it is possible to set date and time locally in KRDOS:
]#
rem SYNCTIME = OFF
#[
AUTOEXEC file
=============
KRDOS uses the file autoexec.txt as DOS autoexec.bat by default just like
original KRDOS. You can specify an alternative AUTOEXEC file for KRDOS:
]#
rem AUTOEXEC = autoexec.bat
#[
Reported DOS version
====================
The default DOS version reported by KRDOS is 7.10. However, you can
specify a different DOS version you want KRDOS to report (2.00-9.99):
]#
rem DOSVER = 5.00
#[
Reported disk space
===================
Some old DOS programs expect a disk space much lower than your actual disk
space. You may want to enable this option if you encounter the problem that
an old DOS program complains about the total or free disk space. Note this
only affects the disk space reported by INT21/AH=36, not the one reported by
the "modern" INT21/AX=7303 function (which is used by e.g. the 4DOS shell):
]#
rem SPACELOW = ON
#[
Auto USE Windows drives
=======================
By default, KRDOS only USE the current directory as Drive C. However,
you can let KRDOS automatically USE all Windows drives in KRDOS and
set the current Windows directory as the current KRDOS directory:
]#
USEDRVS = ON
#[
Windows applications
====================
Like original KRDOS, KRDOS launches a program loaded inside KRDOS in a
separate window by default when it is deemed to be a Windows PE application.
It is recommended to leave it on in general, or you will most likely see the
message "This program cannot be run in DOS mode" when you run such programs.
However, you might want to disable this behavior on certain occasions:
]#
rem WINRUN = OFF
#[
Window/screen
=============
Compared with original KRDOS, KRDOS has better multi-monitor support and
can be started on the specified screen or monitor.
You can change the screen to start KRDOS here (0 = default screen):
]#
rem SCREEN = 2
SCREEN = 1
#[
Window/transparency
===================
Unlike original KRDOS, KRDOS allows you to change the transparency of the
KRDOS screen (both windowed and full-screen modes). The valid value is
from 0 (no transparency, the default) to 90 (high transparency):
]#
rem TRANSWIN = 20
#[
Window/title
============
You can change the default window title string and icon for KRDOS here.
The title string you set will override both the default setting and the
shortcut name of KRDOS.
To change the default icon for KRDOS, you generally need to specify the
location of the icon file. It can be either a .ICO file or .DLL/.EXE file,
and in the case that the file contains multiple icons, you can enter either
the icon index (starting at 0) or resource name as the second parameter.
For example, to use the second icon in the file C:\WINDOWS\explorer.exe both
"ICON = C:\WINDOWS\explorer.exe,1" and "ICON = C:\WINDOWS\explorer.exe,#101"
are accepted. You can also use predefined Windows icons by simply specifying
a resource name and omitting the icon file, e.g. "ICON = ,#104".
It is recommended to also set FRAME = ON below if you want the title string
and icon to show up in the KRDOS title bar.
]#
rem TITLE = New window title for KRDOS
rem ICON = some-icon-file.ico
#[
Font
====
Text is displayed using a built-in scalable TTF font.
You can for example use the included Nouveau_IBM TTF font instead, which is
compatible with KRDOS:
]#
rem FONT = Nouveau_IBM
#[
To use another (monospaced) TTF font, locate it in the Windows font
folder and copy that file (consola.ttf...) to the KRDOS folder:
(If no file extension is supplied, .ttf is assumed)
]#
rem FONT = CONSOLA
#[
Or more directly (for Windows installed fonts):
]#
rem FONT = C:\WINDOWS\FONTS\CONSOLA
#[
Unlike original KRDOS, KRDOS supports displaying italicized text as
well as superscripts, subscripts and small text. In order for styled text
such as underlined or italicized text to be displayed visually, you also
need to set the WP directive. It can be set to either "5", "6" for
WordPerfect 5.x/6.x, "WS" for WordStar, or "XY" for XyWrite:
(Note: WP = XY should work for XyWrite 4 out of the box, but will also give
similar results for XyWrite 3 and Nota Bene 3. Moreover, for both WordStar
and XyWrite, you can also optionally set a second parameter to specify the
background color, e.g. WP = XY,0; see the DOS color table appeared later in
this file for more information about the second parameter)
]#
rem WP = 6
#[
There are two ways to display italicized text visually in KRDOS. One
way is to slant the characters automatically.

However, if there is an actual italic version of your font as specified by

the FONT directive, it is recommended to use it instead. For example, the
font "CONSOLAI" is the italic version of the font "CONSOLA", so if you
specify the font "CONSOLA" using the FONT directive then you can specify the
font "CONSOLAI" using the ITALFONT directive:
]#
rem ITALFONT = CONSOLAI
#[
Like the italic version of the font, you may as well optionally specify
the bold version and bold italic version of the font.
For example, the bold and the bold italic versions of the font "CONSOLA" are
named "CONSOLAB" and "CONSOLAZ" respectively:
]#
rem BOLDFONT = CONSOLAB
rem BOITFONT = CONSOLAZ
#[
Superscript and subscript text can be displayed visually in KRDOS and
is on by default when the WP directive is set. To turn it off:
]#
rem SUBPSCR = OFF
#[
You can also turn off visual display for italicized text in KRDOS (it
is always off in original KRDOS except some early versions):
]#
rem SHOWITAL = OFF
#[
Visual display for strikeout (strikethru) text is disabled by default in
KRDOS. To turn it on:
]#
rem STRIKOUT = ON
#[
The default output color for small text is 7 (white; see the DOS color table
below for more details). To change the output color of such text:
]#
rem SMALLCLR = 2
#[
The Euro symbol isn't displayed by default. Generally it's ASCII 128, to get
it displayed instead of C-cedilla:
]#
rem EURO = 128
#[
ASCII codes 176-223 mostly display a mix of lines/boxes and extended
characters. If your program displays characters where you expect lines,
force these to lines/boxes by the optional minus sign:
]#
rem FONT = -[fontname]
#[
The default text mode window is lean and mean. No borders or title bar. Give
it a try for some time to get accustomed to. Hover over the top line, the
standard system icons (minimize, maximize/restore and close) will appear in
the upper right corner. Left click that line (or hold the Ctrl key) and drag
the window to move it around. If you don't like this approach and want the
familiar Windows borders and title bar:
]#
FRAME = ON
#[
There are 3 visual styles for the system icons (minimize, maximize/restore
and close) mentioned above when the KRDOS screen is frameless or in the
full-screen mode; you can change the style here or simply disable the icons:
(0: disabled; 1: ASCII style; 2: graphical - default; 3: bigger graphical)
]#
rem SYSICONS = 1
#[
You can also set the border padding for the text-mode KRDOS screen.
The padding value will be automatically converted into row/column spacing.
The optional second argument can be used for specifying the padding color:
(default is 0 or black; see the DOS color table below for more details)
]#
rem PADDING = 40,1
#[
The KRDOS window will cover about (max) 75% of the screen. You can change
this by WINDOW = [-][max percentage]. In text mode, the window has some
extra blank space to the left and right, the minus sign will disable this.
This would give you a full screen view (100%). Mind it's still a window (in
disguise), so it won't obscure Windows messages:
]#
WINDOW = 90
#[
Alternatively, you can of course use Alt+Enter while your program is running
to switch to and back from full screen.
The KRDOS window is centered on the screen. This can be changed by:
WINDOW = [-][max percentage][,left x-pos:top y-pos]
Note: The window is ensured to be fully visible. If not, the eventual x and
y-pos parameters are ignored.
]#
rem WINDOW = 60,250:160
#[
rem The number of lines and columns in text mode are the standard DOS 25x80.
rem It can be set differently by LINS = <24-60> and/or COLS = <80-160>.
rem See for yourself if this is useful or supported by your program.
]#
rem LINS = 30
rem COLS = 100
#[
By default, font size selection is in even point sizes and rounded pixel
dimensions as in original KRDOS. To turn this behavior off in KRDOS:
]#
rem EVENSIZE = OFF
#[
The KRDOS window is not the topmost window by default, so part of the
window can be hidden by the taskbar when they overlap. To make the KRDOS
window the topmost window when it is active:
]#
rem TOPWIN = ON
#[
In original KRDOS Ctrl+Alt+? shortcuts for other Windows applications may
not work if you run KRDOS in full-screen mode. You can enable these shortcuts
explicitly for KRDOS in full-screen mode if you encounter this problem:
]#
rem SHORTCUT = ON
#[
To use a different color scheme in text mode, supply all 16 color values
in RGB: (r,g,b) or hexadecimal as in HTML: #RRGGBB.

The original DOS colors (0-15):

0 - Black 1 - Blue 2 - Green 3 - Cyan 4 - Red 5 - Magenta
6 - Yellow / Brown 7 - White / Light Gray 8 - Dark Gray / Bright Black
9 - Bright Blue 10 - Bright Green 11 - Bright Cyan 12 - Bright Red
13 - Bright Magenta 14 - Bright Yellow 15 - Bright White
For example:
COLORS = #000000 #0000aa #00aa00 #00aaaa #aa0000 #aa00aa #aa5500 #aaaaaa
#555555 #5555ff #55ff55 #55ffff #ff5555 #ff55ff #ffff55 #ffffff

The following would give you a gray scaled color scheme:

COLORS = (0,0,0) #0e0e0e (75,75,75) (89,89,89) (38,38,38) (52,52,52)
#717171 #c0c0c0 #808080 (28,28,28) (150,150,150)
(178,178,178) (76,76,76) (104,104,104) (226,226,226) (255,255,255)

Select a MDA card with an underline attribute. Mind it doesn't work for all
programs (an example it will work for is WordPerfect).
]#
rem COLORS = MONO[,color scheme]
#[
Scale the window when in graphics mode: SCALE = <1-9> (that's 100-900%).
It can be 0 (default) which will be expanded to the maximal supported scale
on the current monitor(s). It won't be that nice, and with a scale of 2 a
single point is simply enlarged to 2x2 points:
]#
rem SCALE = 2
#[
You can also optionally specify a second parameter for the graphical scale
if you want the vertical scale to be different from the horizontal scale. A
setting of "0,0" will be expanded to the maximal supported values for them:
]#
rem SCALE = 0,0
#[
Config warnings
===============
By default, KRDOS will warn you at startup if some options in this file
are not configured correctly and will then continue KRDOS's execution.
To bypass these warnings at startup:
]#
rem CONFWARN = OFF
#[
Printing
========
LPT<1-9> and COM<1-9> are available for printing, though many programs only
support LPT<1-3> and COM<1-4>.
Printer output is collected as a print job, considered to be finished if the
DOS application doesn't send any data for some time. If you experience
problems with printing (broken pages) or like the printer to respond
quicker. You can try if disabling this mechanism will help:
]#
rem TIMEOUT = OFF
#[
By default, the temporary printing files (.asc, .txt, .pdf) are located in
the current directory, but you can specify a different directory for them:
]#
rem TEMPDIR = %TEMP%
#[
The program DOSPrinter by default handles printer output.
If nothing is set, it will pop up a Windows printer selection dialog as your
application finished printing.

Note: Your DOS application has to be configured to print to an Epson printer

(the most widely used and emulated one). Your Windows printer can be
anything.
Some examples, look at the DOSPrinter.pdf file for all options:
]#
rem LPT1 = /SEL2 /CPIA /LEFT0.50 /TOP0.50
rem COM1 = /SEL /SEL2 /RTF /CPIA /LEFT0.75 /TOP0.75 /65
#[
If your (DOS) printer is supported directly by your application:
]#
rem LPT2 = /SEL'HPLaserJet2200' /RAW
#[
Other options, not using DOSPrinter.
For example, you may want KRDOS to postpone handling the print data (or
spooling) until the Win+Ctrl+S shortcut is pressed when printing to LPT1:
]#
rem LPT2 = SPOOL
#[
Just ignore the output (e.g. using another DOS to Windows printer program):
]#
rem LPT3 = DUMMY
#[
Use a printer port to exchange data with the Windows clipboard:
]#
rem LPT4 = CLIP
#[
Open the printer output in Notepad:
]#
rem COM2 = notepad #com2.txt
#[
Run a Windows application hidden with the printer data (@ followed by
the Windows path to the program):
]#
rem COM2 = @%windir%\system32\notepad.exe /p #com2.txt
#[
If your (DOS) printer is supported directly by your application
(/D:<Windows printer port>):
]#
rem LPT1 = @%windir%\system32\print /D:LPT1 C:\KRDOS\#lpt1.asc
#[
If your DOS application prints to a PCL or PostScript (PS) printer:
Output to these printers is automatically detected, converted to PDF and
shown in the default PDF reader if you have the pcl6/gswin32c program.

More information about this and download:

http://www.columbia.edu/~em36/ghostpcl.html ]#