home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / makdep4d.zip / MAKDPDOS.ZIP / MAKEDEP.DOC < prev   
Text File  |  1994-09-28  |  4KB  |  133 lines
  1.  
  2.                              MAKEDEP
  3.                              -------
  4.                    Dependecy generator for MAKE.
  5.  
  6.  
  7. This code is copyright (C) 1994, Sulyok Péter. It is placed in the public
  8. domain for non-commercial use, without fee. Commercial redistribution of
  9. this source code not permitted.
  10.  
  11.  
  12. 1. WHAT IS MAKEDEP ?
  13. --------------------
  14. MAKEDEP is a short program than generates dependencies of C or assembly
  15. files. This program is usefull when you work with a MAKE which cannot
  16. check dependencies.
  17.  
  18.  
  19. 2. COMMAND LINE SYNTAX
  20. ----------------------
  21. The command line syntax of MAKEDEP is the following :
  22.  
  23.    MAKEDEP [-option ...] objectfile [outputfile]
  24.  
  25. where the 'objectfile' is a MAKE target, and you need the list of
  26. dependecies of this file.
  27.  
  28.  
  29. 3. HOW MAKEDEP WORKS ?
  30. ----------------------
  31. - It takes the 'objectfile' and try to find the original source
  32.   file (C or assembly) in the source directories.
  33. - It reads the source file and searches include file in it.
  34. - Try to find include files (and its include files) in include
  35.   directories.
  36. - It write list of dependencies to 'outputfile' (or standard output
  37.   if 'outputfile' is not given).
  38.  
  39.  
  40. 4. OPTIONS
  41. ----------
  42. The list of available options :
  43.  
  44.    -a                Append to outputfile
  45.                      Append list of dependencies to the end of output file.
  46.  
  47.    -sPATH[;PATH...]  Source file search directories
  48.                      The list of directories where MAKEDEP try to find
  49.                      source file.
  50.  
  51.    -iPATH[;PATH...]  Include file search directories
  52.                      The list of directories where MAKEDEP try to find
  53.                      include files.
  54.  
  55.    -n                Ignore include file if not found
  56.                      This is usefull when you don't want that the system
  57.                      include files (STDIO.H etc.) appears in the list of
  58.                      dependecies.
  59.  
  60.    -d                Do not write objectfile
  61.                      Do not write name of object file to the list (see examples).
  62.  
  63.    -b                Write depencies base name
  64.                      Write base name of dependecies (in default MAKEDEP writes
  65.                      the full name of these files).
  66.  
  67.    -u                Use upper case
  68.  
  69.    -l                Use lower case
  70.  
  71.    -h,-?             Info text
  72.  
  73.    @respfile         Response file for options
  74.                      You can use response files for long command lines.
  75.  
  76.  
  77. 5. EXAPLES
  78. ----------
  79. If you have the next simple C program (MY.C)
  80.  
  81.    #include <stdio.h>
  82.    #include "my.h"
  83.  
  84.    void main(void)
  85.    {
  86.       printf("Hello.");
  87.    }
  88.  
  89. than
  90.  
  91.    makedep -ic:\bc\include my.obj
  92.  
  93. will generate the next list to the screen
  94.  
  95.    my.obj: my.c c:\bc\include\stdio.h my.h c:\bc\include\_defs.h c:\bc\include\_nfile.h c:\bc\include\_null.h
  96.  
  97. or
  98.  
  99.    makedep -b -ic:\bc\include my.obj
  100.  
  101. will generate
  102.  
  103.    my.obj: my.c stdio.h my.h _defs.h _nfile.h _null.h
  104.  
  105. If you use the -n option and don't give any include directory than
  106.  
  107.    makedep -n my.obj
  108.  
  109. will generate
  110.  
  111.    my.obj: my.c my.h
  112.  
  113. If you use the -d option than
  114.  
  115.    makedep -d -n my.obj
  116.  
  117. will write only dependencies
  118.  
  119.    my.c my.h
  120.  
  121. If you use
  122.  
  123.    makedep -d -n my.obj my.dep
  124.  
  125. than MAKEDEP writes list to MY.DEP file.
  126.  
  127.  
  128. 5. QUESTION
  129. -----------
  130. If you have any question or suggestion, I would appreciate hearing them.
  131. Send E-mail to the next address:
  132.                                             sulyok@math.klte.hu
  133.