home *** CD-ROM | disk | FTP | other *** search
/ Hacker / Hacker.iso / HACKER / DECOMP / Fox3 / FOXDCOMP.DOC next >
Encoding:
Text File  |  1990-12-04  |  7.6 KB  |  221 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.                                    FOXDCOMP
  9.                        A DECOMPILER FOR FOXBASE PROGRAMS
  10.                                      by
  11.                               Doyle and Associates
  12.  
  13.  
  14.  
  15.               FOXDCOMP is a program reads a precompiled Foxbase program
  16.          and recreates the original program source. This is an essential
  17.          utility for the Foxbase environment that can be used for the
  18.          following purposes:
  19.  
  20.               - Recreating lost, unavailable, or destroyed source code.
  21.                 This will allow modifications to an existing system
  22.                 without starting from scratch.
  23.  
  24.               - As an aid in understanding a purchased compiled package
  25.                 that was delivered without source code. This can be
  26.                 a very useful tool when adding a customized front-end
  27.                 to a purchased compiled system.
  28.  
  29.               - To view the source code of professionally-developed
  30.                 systems in order to learn programming techniques
  31.                 used to create efficient, reliable, and visually-
  32.                 appealing systems.
  33.  
  34.  
  35.  
  36.          FEATURES
  37.  
  38.  
  39.               - Simple DOS command-line operation.
  40.  
  41.               - Correctly decompiles programs compiled with
  42.                 Foxbase version 2.1 or lower.
  43.  
  44.               - Written in efficiently structured C language
  45.                 for FAST execution.
  46.  
  47.               - Fully indented source code is produced.
  48.  
  49.               - Language keywords are printed in capital letters.
  50.                 Variable name are printed in lower-case.
  51.  
  52.               - Macros, arrays, user-defined functions, and
  53.                 functions with variable arguments are fully
  54.                 supported.
  55.  
  56.          DOYLE AND ASSOCIATES              FOXDCOMP FOXBASE DECOMPILER
  57.          -------------------------------------------------------------
  58.  
  59.          LICENSE AND REGISTRATION
  60.  
  61.               FOXDCOMP is distributed as a "share ware" program.
  62.          Please help us get it known by giving unmodified copies of
  63.          the program and documentation to other people who may find
  64.          FOXDCOMP useful.
  65.  
  66.               FOXDCOMP is copyright (C) 1990 by Doyle and Associates.
  67.          It is not public domain or free software.  Non-registered
  68.          users are granted a limited license to use FOXDCOMP on a trial
  69.          basis for determining whether or not it is suitable for their
  70.          needs.  Registration permits the use of FOXDCOMP on one CPU.
  71.  
  72.               The registration fee is $5 or $10.  Users who pay the
  73.          $10 fee will be sent a disk containing the most current
  74.          version of the program and documentation, and the fully-
  75.          commented Turbo C source code for the program. Users who pay
  76.          the $5 fee are not sent a new disk but are included in the
  77.          mailing list for announcements about both current and future
  78.          products, including a version that will support Foxpro. Your
  79.          prompt registration of your copy of FOXDCOMP is greatly
  80.          appreciated.
  81.  
  82.               Register your usage of FOXDCOMP by sending the registra-
  83.          tion fee to:
  84.  
  85.                         Doyle and Associates
  86.                         101 Westminster Road
  87.                         Rochester, NY  14607
  88.                         Telephone: (716) 461-1148
  89.  
  90.          Your comments regarding the FOXDCOMP program or any suggestions
  91.          you have for extensions or for other programs that would be
  92.          useful to you are welcomed.
  93.  
  94.               Doyle and Associates makes no warranties whatsoever
  95.          regarding the FOXDCOMP computer programs or the supporting
  96.          documentation.
  97.  
  98.  
  99.          USING FOXDCOMP
  100.  
  101.               FOXDCOMP is executed from the DOS command prompt with
  102.          the following syntax:
  103.  
  104.  
  105.               FOXDCOMP <input filename> <output filename>
  106.  
  107.               The <input filename> is the name of a compiled Foxbase
  108.               program (usually with a .FOX or .FMX extension).
  109.  
  110.                                    Page 2
  111.  
  112.  
  113.          DOYLE AND ASSOCIATES              FOXDCOMP FOXBASE DECOMPILER
  114.          -------------------------------------------------------------
  115.  
  116.               The <output filename> is the name of the file that the
  117.               source program will be produced in. If <output filename>
  118.               already exists, it will be over-written. If it does not
  119.               exist, a new file will be created.
  120.  
  121.  
  122.               Example:
  123.  
  124.  
  125.                   FOXDCOMP test.fox testout.prg
  126.  
  127.  
  128.                   In this example 'test.fox' is the input file
  129.                   'testout.fox' is the output file.
  130.  
  131.  
  132.                   There are two files included in the FOXDCOMP
  133.                   distribution files - 'test.fox' and 'test.prg'          be
  134.                   - that can be used to try the above example.
  135.                   'test.prg' was the original source file that
  136.                   was compiled to produce 'test.fox'.
  137.  
  138.  
  139.          ERROR MESSAGES:
  140.  
  141.               FOXDCOMP will display the following error messages
  142.          if exception conditions are encountered:
  143.  
  144.          - Specify both an input file and an output file.
  145.  
  146.            Meaning    : FOXDCOMP syntax requires both the input
  147.                         and output file names to be specified.
  148.            Resolution : Enter the command correctly.
  149.  
  150.          - Can not open input file.
  151.  
  152.            Meaning    : The input file does not exist.
  153.            Resolution : Enter the command with the correct file name.
  154.  
  155.          - Can not open output file.
  156.  
  157.            Meaning    : The output file can not be opened by DOS.
  158.  
  159.          - Empty input file.
  160.  
  161.            Meaning    : The input file is empty.
  162.            Resolution : Enter the command with the correct file name.
  163.  
  164.                                    Page 3
  165.  
  166.  
  167.  
  168.          DOYLE AND ASSOCIATES              FOXDCOMP FOXBASE DECOMPILER
  169.          -------------------------------------------------------------
  170.  
  171.          - Unexpected end of input file.
  172.  
  173.            Meaning    : The end of the input file was reached before
  174.                         it was logically possible. The input file may
  175.                         be damaged.
  176.            Resolution : Attempt to recover the file from a backup.
  177.  
  178.          - File is not a compiled Foxbase program.
  179.  
  180.            Meaning    : The input file does not have a Foxbase header,
  181.                         and was determined to not be a Foxbase program.
  182.            Resolution : Enter the command with the correct file name.
  183.  
  184.          - Warning - possible error in trailer.
  185.  
  186.            Meaning    : The input file contains logical errors in its
  187.                         trailer.
  188.            Resolution : The program may decompile correctly. Examine
  189.                         the output closely. If the output looks
  190.                         incorrect, attempt to recover the file from a
  191.                         backup.
  192.  
  193.          - Unable to allocate procedure names buffer.
  194.          - Unable to allocate code buffer.
  195.          - Unable to allocate names buffer.
  196.  
  197.            Meaning    : Internal error in allocation memory for buffers.
  198.            Resolution : Remove memory-resident programs from memory
  199.                         and try again. If the problem persists, call
  200.                         Doyle and Associates for technical support.
  201.  
  202.  
  203.  
  204.  
  205.  
  206.  
  207.  
  208.  
  209.  
  210.  
  211.  
  212.  
  213.                             Doyle and Associates
  214.                             101 Westminster Road
  215.                             Rochester, NY  14607
  216.                             Telephone: (716) 461-1148
  217.  
  218.                                    Page 4
  219.  
  220.  
  221.