This is a brief description of the NatRenum.DLL file, of possible
interest to Borland C++ Builder developers who might wish to use
it in projects that involve processing NATURAL source code on the
Windows platform.

Functions exported by NatRenum.DLL
-------------------------------------
extern "C" bool __export WINAPI NatRenumberAvailable();
extern "C" void __export WINAPI NatRenumber(TRichEdit*);


Description of bool NatRenumberAvailable()
--------------------------------------------
Always returns true, does nothing else.



Description of void NatRenumber(TRichEdit*)
--------------------------------------------
Assumes the TRichEdit control contains NATURAL source code.
Assumes the first 4 characters of each line is a numeric line ident.
Lines that are completely empty except for whitespace are ignored.
All other lines will have a 4-digit sequence number
a) Overwritten if a sequence number already existed
   or
b) Affixed to left of line (if 4-digit id did not already exist)

Numeric back references contained in lines will be updated with
the correct values.

Detects the minimal number of blank characters between existing 
line ids and first characters of source code lines (can be zero,
1 or 2). Uses this minimal number to insert between new line ids
and original un-numbered lines.

eg. spacing = 1
Original code
---------------
0010 *************************************
0020 * Program: DATECALC
***   insert this line as a test.
0030 * Library: COMUTILS


Renumbered code
-----------------
0010 *************************************
0020 * Program: DATECALC
0030 ***   insert this line as a test.
0040 * Library: COMUTILS

