home *** CD-ROM | disk | FTP | other *** search
/ Programmer 7500 / MAX_PROGRAMMERS.iso / PASCAL / MXLIST.ZIP / READ.ME < prev    next >
Encoding:
Text File  |  1993-01-04  |  5.9 KB  |  164 lines
  1.  
  2.                           DMX Text Listing Programs
  3.                            (C) 1990  Randolph Beck
  4.  
  5.  
  6.   These programs and units can create a README-like program that will
  7.   display and scroll text-files.  It is window-sensitive, so that the
  8.   text-file can be displayed in any area of the screen.
  9.  
  10.   A variation allows one file to contain several separate help-screens.
  11.   The original DMX demonstration program DMXAMORT.PAS has been modified,
  12.   and now uses this help-file system.
  13.  
  14.   ───────────────────────────────────────────────────────────────────────
  15.  
  16.   This software assumes that you have already obtained the central DMX
  17.   unit to compile these programs.  This also assumes that you have the
  18.   Turbo Pascal 5.5 compiler and some familiarity with Turbo Pascal and
  19.   object-oriented programming.
  20.  
  21.   If you do not already have it, you should be able to upload the DMX unit
  22.   from the same source as this program (named TP_DMX23.ZIP or DMX23.ZIP).
  23.  
  24.   DMX is a shareware product and may be copied and distributed freely.
  25.   Its registration cost (free to tinkerers, but $12 minimum for support)
  26.   is detailed in its accompanying documentation.
  27.  
  28.   There are no additional fees required for these accompanying units.
  29.  
  30.  
  31.   ───────────────────────────────────────────────────────────────────────
  32.  
  33.   Files included:
  34.  
  35.         READ.ME            This.
  36.  
  37.         DMX_LIST.PAS       Listing program unit.
  38.         DMX_WIND.PAS       Supporting window procedures.
  39.  
  40.         README.PAS         Source code for the README program.
  41.  
  42.         AMORT2.PAS         Source code for a revised amortization program.
  43.         AMORT.HLP          Help file for AMORT2.EXE.
  44.  
  45.  
  46.   ───────────────────────────────────────────────────────────────────────
  47.  
  48.                                DMX_LIST Unit
  49.  
  50.  
  51.   In its generic sense, the DMX unit creates software for editing "flat"
  52.   databases.  With object-oriented enhancements, programs can manipulate
  53.   more complex structures.  The DMX_LIST unit treats each line of text as
  54.   a variable-length record with just one field.
  55.  
  56.   DMX_LIST uses the DMXviewer object --which is a descendant object that
  57.   only allows scrolling.
  58.  
  59.   All the "object-orientedness" is handled internally within this unit.
  60.   There are two global procedure to be called by the main program.
  61.  
  62.   The first procedure name and syntax is:
  63.  
  64.         ViewTextWindow (Filename : pathstr;  Bor,Txt : word);
  65.  
  66.                 FILENAME is the name of the text file;
  67.                 BOR is the border color;
  68.                 TXT is the text color.
  69.  
  70.  
  71.   Since DMX is window-sensitive, the position and size may be determined
  72.   by the individual programmer.  That way, it can be used for both README
  73.   files or HELP files.  Text color is also variable.
  74.  
  75.   The only caveat is that the number of text-lines is limited by the value
  76.   set in the constant LASTLINE, which is now set at 999.  You may change
  77.   this if you feel that this is too much or too little.
  78.  
  79.   The second procedure name and syntax is:
  80.  
  81.         ViewHelpWindow (Filename : pathstr;  Help : char;
  82.                             Y1,X1,Y2,X2, Bor,Txt : word);
  83.  
  84.                 FILENAME, BOR, and TXT are as above;
  85.                 HELP is a character code, for using multiple windows;
  86.                 Y1,X1,Y2,X2 denote the window size.
  87.  
  88.  
  89.   The first procedure used the current window size.  ViewHelpWindow uses
  90.   the dimensions from the parameters given --via by windowing procedures
  91.   from the file DMX_WIND.PAS.  The window size is reset to the original
  92.   dimensions when the procedure is completed.
  93.  
  94.   The use of a HELP variable is the major difference between the two
  95.   procedures.  Each line of text in the help-file must begin with a
  96.   character that denotes which help screen is displayed.  This way,
  97.   one file can be used for several help screens.
  98.  
  99.  
  100.   ───────────────────────────────────────────────────────────────────────
  101.  
  102.                                DMX_WIND Unit
  103.  
  104.  
  105.   The ViewHelpWindow procedure in the DMX_LIST unit requires procedures
  106.   to save and restore the screen.
  107.  
  108.   The DMX_WIND unit uses the simplest methods to do this.  This was done
  109.   with the premise that programmers may choose to use their own windowing
  110.   procedures.  The two procedures are SaveWindow and RestoreWindow.
  111.  
  112.   Please refer to the DMX_WIND.PAS file for more information.
  113.  
  114.  
  115.   ───────────────────────────────────────────────────────────────────────
  116.  
  117.                              The README program
  118.  
  119.  
  120.   The README program uses the DMX2 and DMX_LIST units to create a simple
  121.   text-file lister.  The filesize is about 20k, which is admittedly high
  122.   for a program of this type.  Although disk-space is becoming less of a
  123.   problem for many, this is still an important consideration.
  124.  
  125.   But when using the DMX unit for other purposes (like actually editing
  126.   data) most of the overhead is already taken.  You can see this by
  127.   comparing the file sizes of the new and old amortization programs.
  128.  
  129.  
  130.   ───────────────────────────────────────────────────────────────────────
  131.  
  132.                              The AMORT2 program
  133.  
  134.  
  135.   AMORT2.PAS is an improved version of DMXAMORT.PAS, which is with the
  136.   original DMX code.  AMORT2 makes it much easier to compare several
  137.   mortgages:  Up to five mortgages can be entered at a time, and it
  138.   supports context-sensitive help.
  139.  
  140.   As already mentioned, the file size is not much greater than the first
  141.   amortization program.
  142.  
  143.  
  144.   More notes are embedded within the source code and help-file.
  145.  
  146.  
  147.   ───────────────────────────────────────────────────────────────────────
  148.  
  149.   Trademark acknowledgement:
  150.               Turbo Pascal is a trademark of Borland International, Inc.
  151.  
  152.  
  153.   ───────────────────────────────────────────────────────────────────────
  154.  
  155.       Randolph Beck
  156.       DMX Registration
  157.       P.O. Box 56-0487
  158.       Orlando, FL
  159.       32856-0487
  160.  
  161.       Please include any questions or comments.
  162.  
  163.  
  164.