-------------------------
Manual to GDOS-Check v2.0
-------------------------


What GDOS-Check is good for
---------------------------
GDOS-Check is a little utility for testing the current GDOS installation.

GDOS-Check can do two things:

- Creating a test page showing the maximum area the GDOS device can print.

- Writing  a  list  of all fonts in all sizes that are installed for the used
GDOS device


What GDOS-Check costs
---------------------
Nothing.
Except some kBytes of free space at your hard disk or a floppy disk.

GDOS-Check  is  a freeware utility for the shareware program IdeaList. But it
can be used for general purpose just as well.
You  may copy and spread it as you want.  Under the condition, that all these
files are copied completely and unchanged:
- GD_CHECK.PRG : the program file
- GD_CHECK.RSC : the resource file
- GD_CHECK.INF : the configuration file
- GD_CHECK.TXT : this text


By whom GDOS-Check was written
------------------------------
(C) 1994/95 by
  Christoph Bartholme
  Dietrichstrae 9
  D-76227 Karlsruhe

The  author  is  not  responsible  for any damage of software and hardware by
using the program.


What GDOS-Check needs
---------------------
Of  course  GDOS-Check  only  is  useful  if  you  have  installed  any GDOS.
GDOS_Check also can manage SpeedoGDOS and NVDI 3.0.

Als  in the home directory of GD_CHECK.PRG the resource file GD-CHECK.RSC and
the  configuration  file  GD_CHECK.INF have to be found. If GD_CHECK.INF does
not exist, GDOS-Check will use its internal default parameters.


How GDOS-Check is used
----------------------
The  handling  of GDOS-Check is rather easy. GDOS-Check opens a window, where
the  buttons  for actions can be klicked. Also there are some popup menus for
selections.

- GDOS-Check  is  finished  by clicking the closer gadget of its window or by
selecting the menu "Quit".

-  "GDOS  device": Here  you can select one of the devices that are installed
in  the  system.  Metafile  devices are not selecable but all the rest of the
output devices that are set in ASSIGN.SYS.

-  The  font  selection: Just an option to limit the amout of the fonts to be
shown  in the font list. You may select the font type (bitmap only, or vector
only,  or  both)  and  limit  the  range  of the first characters of the font
names.

- "Info" shows something about the version and the author.

- "Help" explains the program's function.

- "Statistics"  shows  some  information  about the selected GDOS device: the
resolution  in dpi, the maximum area in mm and the amount of the fonts (total
and subset = selected range).

-  Font  list: GDOS-Check prints a font list of the selected GDOS device. The
amount  can  be  limited  (see  above).  The format of the list is set by the
configuration file GD_CHECK.INF which is scanned at starting.

-  Test  page: GDOS-Check  prints  a test page to find out the maximum of the
page's area to be printed.
At  the four scales you can see the additional margins, that can be set in an
adaptation   file   (IXA)  of  IdeaList  by  the  key  words  "GdosMargin_L",
"GdosMargin_R",  "GdosMargin_T"  and  "GdosMargin_B". F.i. to set symmetrical
margins.  Remember,  that  some  GDOS devices print out a bigger area than it
sizes  at  one  sheet  of paper. So GDOS-Check will print out the rest of the
test  page  at a secound page. In this case you must reduce the vertical size
in  the  IXA  by  "GdosMargin_B" as much as you see at the scale of the first
sheet of the test page.


How GDOS-Check can be customized - The configuration file GD_CHECK.INF
----------------------------------------------------------------------
The  format  of  the  font  list is set by GD-CHECK.INF. This is a pure ASCII
file you may change by any text editor.
GD-CHECK.INF  contains  some  key  words, followed by a parameter. Also there
may  be remarks marked by a "*". The order of the key words is insignificant.
Key  words  that  are  not  set  will  be  replaced  by  GDOS-Check's default
parameters. Names and texts have to be 'quoted'.

Key words:

- ShowHeadLine: Create a head-line at every page begin?
1 = yes, 0 = no (default = yes)

- HeadLineAtt: Text attributes of the head-line. Possible are:
0  =  none, 1 = bold, 2 = light, 4 = italic, 8 = underlined. For combinations
you may add them. (default = underlined)

For every font a title-line is created followed by a font sample.
(default: '"#N": #T-Font in #S pt, ID=#I'):
The key words to set the title-line are:

- TitelLine: The line itself; here there are some variables possible:

 #N: the font name

 #S: font size in pts

 #T:  font  type, i.e. "Bitmap" or "Vector"; since SpeedoGDOS 5.0 or NVDI 3.0
vector fonts are specified by "Speedo", "TrueType" and "Type1".

 #I: font index
Attention:  Since  SpeedoGDOS  4.2 and NVDI 3.0 an offset of 5000 is added to
the ID of any vector font. GDOS-Check shows the ID with this offset.

 ##: The character "#" itself

-  TitleFontName: defines the font of the title-line. If the name is empty or
if the font is not installed GDOS-Check uses the deccribes font instead.
(default: empty)

- TitleFontSize: the font size (in pts) of the title-line
(default 10 pt)

TitleAtt: text attributes of the title-line; possible are:
0  =  none, 1 = bold, 2 = light, 4 = italic, 8 = underlined. For combinations
you may add them. (default = none)

The  font  sample  can be shown in different sizes. For vector fonts there is
the  key word VecFontSize which defines the size (in pts). If different lines
of  this key word exist (up to 20), GDOS-Check writes as many title-lines and
font samples.
(default: one line, 12 pts)

At  bitmap  fonts  always  title-lines  and  font samples are created for ALL
installed  sizes.  Remember  that  the  GDOS  devices  offer each bitmap font
defined  in  ASSIGN.SYS in two sizes: The original size and the size enlarged
by  100%.  Of  course  you also may use these enlarged fonts, but the printer
resolution is halved and the fonts look blocky a little bit.

After  each title-line up to 20 sample lines may be printed. Therefor the key
word  Test exists. Each sample lines may contain up to 2000 characters. It is
recommended to set a blank line at the end (just: Test '').
(default: no sample line)


----------------------------------------------------------------------------