TXT2COM

                           TXT2COM.COM version 1.1
                           (C) Copyright 1991-2002
                      by Mike Wiering, Wiering Software
                        http://www.wieringsoftware.nl
                           info@wieringsoftware.nl


DESCRIPTION

   TXT2COM compiles text files to executeble .COM programs. If you don't use
   any commands, the program will only display your text file like the DOS
   command TYPE does. However, there are many commands, so you can write
   complete programs. For an example, see DOC.TXT and run the compiled
   version DOC.COM.

   To create a program, type a text file with any ASCII-editor, then compile
   it. TXT2COM always compiles your file to a program with the extension
   .COM. You can use COM2EXE to convert your program to an .EXE program,
   which can be compressed with LZEXE.

   Here is a list of the commands you can use: C, CHR, CLS, COLOR, DUP,
   FILL, FRAME, LOCATE, SETCURSOR, SKIP, JUMP, READKEY, IFKEY, IFSCAN, BEEP,
   LEFTMARGIN, CALL, RETURN, CR, LF.

   C

      Center the line horizontally within the current FRAME.

   CHR ascii-code   (0 .. 255)

      Write any ASCII-character.

   CLS

      Clear the entire screen.

   COLOR number   (0 .. 255)

      Changes the current text color. The default is 7 (Gray).

   DUP ascii-code, number

      Writes a number of the same chraracters with the specified ASCII code.

   FILL y1, x1, y2, x2, char

      Fill an area on the screen with one character. The parameters y1 and y2
      are line numbers (1 .. 25), x1 and x2 are column numbers (1 .. 80). y1
      and x1 must be smaller than y2 and x2. Char is a number in the range of
      0 .. 255.

   FRAME y1, x1, y2, x2, Line style

      Draw a frame (rectangle). There are seven line styles:
      (1 =  ; 2 =  ; 3 =  ; 4 =  ; 5 =  ; 6 =  ; 7 = ).
      The parameters y1 and y2 are line numbers (1 .. 25), x1 and x2 are
      colum numbers (1 .. 80).

   LOCATE row, column

      Move the cursor to a new location. Row is the line (1 .. 25), column is
      a number (1 .. 80). After the command CLS the cursor is always set to
      position (1, 1).

   SETCURSOR topline, bottemline   (0 .. 31)

      This changes the size of the cursor. The default is 12, 13. For a block
      cursor: SETCURSOR 0, 31. If you don't want to a cursor at all, use the
      parameters 31, 0. When your program is finished, the original cursor
      will be restored automatically.

   SKIP number   (1 .. 79)

      Move the cursor number spaces forward without writing anything.

   JUMP label-number

      This command is similar to GOTO in BASIC and in batch files. Label-
      number is a number of a label somewhere in your text file, defined with
      the command: LABEL label-number.

   READKEY

      The program waits until the user presses a key on the keyboard. The
      ASCII-code and the scan code are stored for the commands IFKEY and
      IFSCAN.

   IFKEY ascii-code, label-number

      If the last key that was read with the command READKEY is equal to the
      ascii-code you specify, the program will jump to label-number.

   IFSCAN scan-code, label number

      If the last key that was read with the command READKEY is equal to the
      scan-code you specify, the program will jump to label-number. Scan
      codes can be used to detect special keys, like the function keys and
      the arrow keys.

   BEEP

      This command makes a sound.

   LEFTMARGIN column   (1 .. 79)

      Set the left margin. The default is 1. Every time a new line starts,
      the cursor is placed in this column.

   CALL label-number

      This command is simular to the JUMP command, but now the old address is
      stored in memory. The command RETURN brings you back again.

   RETURN

      This command indicates the end of a subroutine and continues the
      program from after the last CALL-command. Be careful not to use RETURN
      without CALL.

   LF/CR

      Writes a line feed (chr 10) / cariage return (chr 13).


LICENSE

   This program is FREEWARE! Please see the file LICENSE.TXT for more
   details.


USAGE

   To compile a program:

      TXT2COM input-name[.txt] [output-name[.com]]
    
Back to Free DOS utilities by Mike Wiering