ÚÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍ¿
                     º °±²ÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛ²±° º
                     º ±²ßÜÜßÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛ²± º
                     º ²ÛÜßßÜÛÛÛÛÛÛÛÛßßßßÛÛÛÛÛÛßßßßÛÛÛÛ² º
                     º ÛÛÛßßÜÜßÛßÜÜßÜÛÛÛÛÜßÛßÜÜÛÛÛÛÜßÛÛÛ º
                     º ÛÛݲÛÛÛÝÛݲÛÛÛßßÛÛÛÝݲÛÛÛßÛÛßÜÛÛÛ º
                     º ÛÛÛ ²ÛÛÝÛÞ²ÛÛ ÛݲÛÛÞÞÛÛÛÞÛÜÜÜÛÛÛÛ º
                     º ÛÛÛ ²ÛÛÞݲÛÛÝÛݲÛÛÝÛݲÛÛÜßßßÜÜßÛ² º
                     º ²Û ßßÜÜÛÜßßßÜÛݲÛÛÜßÛÜßßÛÛÛÛÛßܲ± ³
                     º ±²ÛÛÛÛÛÛÛÛÛÛÛÛÛÜßßÜÛÛÛÛÛÜÜÜÜܲ± ÜÜ 
                     º °±²ÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛ²± ß Üß
                     ÀÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÄÄ ßÜÜß
 
               INC-Pro III, By Andrew Cameron (KeLewAN) Dec 1996


ÚÄÄÄÄÄÄÄ¿        
³ Files ³
ÀÄÄÄÄÄÄÄÙ
  INCPRO  .COM   2550   Command-line utility
  INCPRO3 .DOC   9898   Document
  FILE_ID .DIZ    703   BBS description

ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿        
³ Requirements ³
ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ
  - MSDOS 2+ compatible system 
  - 386+ PC

ÚÄÄÄÄÄÄÄÄÄÄÄÄ¿        
³ Disclaimer ³
ÀÄÄÄÄÄÄÄÄÄÄÄÄÙ
 Anything that happens to your PC as a result of using this is NOT my
responsibility. Every disk-related action is performed by a DOS-based
operating system. Every measure of precaution has been taken to prevent
data loss. In other words, if the shit hits the fan - BLAME MICROSOFT!

ÚÄÄÄÄÄÄÄ¿
³ Intro ³
ÀÄÄÄÄÄÄÄÙ
 INC-Pro III is a coder's utility to convert a binary file to an ASM, C/C++,
GEMA, QuickBasic or Pascal include file. The point of this being that you
can include data inside an executable instead of reading from external files. 
Example uses of INC are for including:

        - Tables (ie. Sine tables, Hex tables)
        - Music for a demo/intro, adlib or tracker
        - Graphics files (fast decoding from memory)
        - Encrypted strings

ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿
³ Feature Summary ³
ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ
 - Written in 100% ASM and still faster than most pmode converters.
 - Supports ASM, C/C++, QuickBasic, GEMA, and Pascal output modes.
 - Very small at just under 2.5Kb.
 - Presented as a traditional DOS file utility.
 - Data labels can be specified from the command line.
 - File extensions are added automatically.
 - Screen-width progression meter.
 - Neat column data layout in include files.
 - Filename and file length are added to the include file.
 - Error handles _every_ file operation.
 - Free and 100% Australian Made. 

ÚÄÄÄÄÄÄÄÄÄÄÄÄÄ¿        
³ Performance ³
ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÙ
  - 1 disk read of 1200 bytes produces 100 rows of output.
  - 1 row of output occupies one disk write of around 75 bytes.

 Wanna run INC-Pro faster? Add a command line switch '/N' to the end of
Smartdrive. This lets you return to the DOS prompt before the include file
has been completely written.

ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿
³ INC-Pro Version History ³
ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ
 INC-Pro III  - New Pascal support             
              - The return of data labels!
              - Supports default file extensions
              - Added filename to the file header
              - More extensive error handling
              - Fixed command-line bugs
              - Can now process same source and dest filename
              - Stripped zeros from the file length
              - Removed cache write-backs             
              - Bit rotation dropped

 INC-Pro II   - Re-written in 100% ASM
              - MUCH smaller (lost about 8k)
              - MUCH faster
              - New GEMA support
              - Smarter cache system
              - Smartdrive & compatible support
              - Presented as a DOS utility
              - Removed the annoying DIZ file writing 
              - Removed that stoopid error beep
              - 386 requirement

 INC-Pro I    - Used 64kb read buffering which increased speed up to
                5x faster than the original versions of INC
              - Optional bit rotation added for security
              - Neat column layout in output files
              - Specify label and array names from the command line

 INC          - Five or so versions released
              - Written in Microsoft Quick-C 2.5
              - ANSI menu layout
              - Unformatted output
              - Supported ASM, C, and QB

ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿
³ Command line ³
ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ

This help text can be viewed by executing INC-Pro with the '/?' option...

 INCPRO <source> <destination> <label> [/a | /c | /p | /g | /q] 

   /a               Output Assembler include file.
   /c               Output C/C++ header file.
   /p               Output Pascal source file.
   /g               Output GEMA include file.
   /q               Output QuickBasic include file.


Notes: - These switches are CASE SENSITIVE to allow for expansion.
       - INC-Pro goes by the last mode switch given on the command line.
       - INC-Pro will use ASM output if no mode option is specified.
       - Remember to ALWAYS specify a label name.

ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿
³ Assembler Notes ³
ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ
 INC-Pro will create an "*.INC" file that can be included using the INCLUDE
directive. It is fully compatible with all assemblers eg. Borland, Microsoft
and Watcom. Example:

        include mydata.inc

ÚÄÄÄÄÄÄÄÄÄÄÄÄÄ¿
³ C/C++ Notes ³
ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÙ
 INC-Pro will create a "*.H" header file. This is fully compatible with all
compilers that support the "//" comment style. Array elements may only be
referenced singularly as unsigned char. Example:

        #include "mydata.inc"

ÚÄÄÄÄÄÄÄÄÄÄÄÄ¿
³ GEMA Notes ³
ÀÄÄÄÄÄÄÄÄÄÄÄÄÙ
 GenPC Elite Assembler is a non-standard assembler by Sector One. GEMA does
have support for including binaries (INCBIN), but hey, you never know when
you might need this. Basically this output mode is a lot like ASM. Example:

        INCLUDE mydata.inc

ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿
³ QuickBasic Notes ³
ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ
 INC-Pro will create a "*.BI" include file. This QuickBasic output is in
DATA format so you'll need to use READ to access it (refer to quick-help).
Note that QB shits itself over long source code, so an idea might be to use
the chain function. Example:

        rem $include: 'mydata.bi'

ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿
³ Pascal Notes ³
ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ
 INC-Pro will create a "*.PAS" source file. Some compilers support an
include directive whereas others don't, so I've left this in source format.
For those without include-file support it's simply a matter of cut-and-paste.

 Note: Not many Pascal compilers support preset arrays if they're variable,
       so arrays are constant by default.

ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿
³ Hey! My format's not supported! ³
ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ
 If your include file format is not supported, then PLEASE email me with an
example layout. If I get at least a couple of these then I may consider
releasing another version of INC-Pro. In the meantime though, there are two
utilities I strongly recommend:

        BINOBJ32        By Mr.Baggins / Extravaganza.
        2OBJ            By Mark Thomas / NPS Software.

 The first is for flat mode OBJ's, the second for real mode. Both support
source files > 64Kb and should work with most languages. These files and
the latest version of INC-Pro are available from:

        ftp://ftp.cdrom.com/pub/demos/incoming/code

ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿
³ Error Messages Explained ³
ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ
 INC-Pro returns 0 on error, 1 on success. The following is a list of
possible error messages which may occur...

'386+ CPU Required!':

  This means that your processor doesn't support 32 bit registers, you
  have no choice but to return to the DOS prompt.

'Invalid switch - / ':

  You've passed an invalid switch on the command-line. This will occur
  if the switch character is unsupported... remember that switches are
  case-sensitive.

'Invalid number of parameters':

  It means just that. Check the help text to make sure you've passed the
  three required strings on ther command-line.

'Error reading source file':

  This may occur at anytime, but usually when the filename passed on the
  command-line is invalid. If INC-Pro has difficulty reading part of a
  file, for instance if it lies on a bad sector, then this message will
  come up during conversion.

'Error writing destination file':

  This may occur at anytime, but usually when the filename passed on the
  command-line is invalid or read-only. Use ATTRIB to correct the attribute
  flags and make sure that the filename conforms to DOS standards. This may
  also occur if INC-Pro has trouble writing to the destination file due
  to a disk failure.

'Cannot process null file':

  The source file has zero length, and therefore INC-Pro has nothing to do. 

ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿
³ Contact Info ³
ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ
  Email........ kelewan@adam.com.au
  Homepage..... http://www.adam.com.au/~kelewan

 These addresses should stay current for at least another 6 months. Check
out my homepage for info on the Adelaide scene, coding, techno, emulation,
photos and my own Luis Royo art gallery. Email me for anything... even mail
me to say what part of the world has received this! Just don't send large
email messages because I'm chained to a 2Mb quota :( 

ÚÄÄÄÄÄÄÄÄÄÄÄÄÄ¿
³ Other stuff ³
ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÙ
 As a final word, I'd just like to say that this is THE final release of
INC-Pro. If anyone reports a bug or something then fine, but there's only
so much time you should spend on a file converter. I have plenty of real
projects lined up for 1997 now that school's ended - for news on any of this
stuff you can visit my homepage as listed above. Merry christmas y'all!