home *** CD-ROM | disk | FTP | other *** search
/ io Programmo 14 / IOPROG_14.ISO / soft / sdkjava / sdkjava.exe / SDKJava.cab / Bin / nmake.txt < prev    next >
Encoding:
Text File  |  1998-03-05  |  5.6 KB  |  112 lines
  1. The syntax for NMAKE is:
  2.  
  3. NMAKE [option...] [macros...] [targets...] [@commandfile...]
  4.  
  5. NMAKE builds only specified targets or, if none is specified, the first target 
  6. in the makefile. The first makefile target can be a pseudotarget that builds 
  7. other targets. NMAKE uses makefiles specified with /F; if /F is not specified, 
  8. it uses the Makefile file in the current directory. If no makefile is specified, 
  9. it uses inference rules to build command-line targets.
  10.  
  11. The commandfile text file contains command-line input. Other input can precede 
  12. or follow @commandfile. A path is permitted. In commandfile, line breaks are 
  13. treated as spaces. Enclose macro definitions in quotation marks if they contain spaces.
  14.  
  15.  
  16. NMAKE options are described in the following table. 
  17.  
  18. Options are preceded by either a slash (/) or a dash (û) and are not case sensitive. 
  19. Use !CMDSWITCHES to change option settings in a makefile.
  20.  
  21. Option          Action
  22. -----------     -----------------------------------------------------------------------
  23. /A              Forces build of all evaluated targets, even if not out-of-date with 
  24.                 respect to dependents. Does not force build of unrelated targets.
  25.  
  26. /B              Forces build even if timestamps are equal. Recommended only for very 
  27.                 fast systems (resolution of two seconds or less).
  28.  
  29. /C              Suppresses default output, including nonfatal NMAKE errors or warnings, 
  30.                 timestamps, and NMAKE copyright message. Suppresses warnings issued by /K.
  31.  
  32. /D              Displays timestamps of each evaluated target and dependent and a message 
  33.                 when a target does not exist. Useful with /P for debugging a makefile.
  34.                 Use !CMDSWITCHES to set or clear /D for part of a makefile.
  35.  
  36. /E              Causes environment variables to override makefile macro definitions.
  37.  
  38. /F filename     Specifies filename as a makefile. Spaces or tabs can precede filename. 
  39.                 Specify /F once for each makefile. To supply a makefile from standard
  40.                 input, specify a dash (û) for filename, and end keyboard input with 
  41.                 either F6 or CTRL+Z.
  42.  
  43. /HELP, /?       Displays a brief summary of NMAKE command-line syntax.
  44.  
  45. /I              Ignores exit codes from all commands. To set or clear /I for part of a
  46.                 makefile, use !CMDSWITCHES. To ignore exit codes for part of a makefile,
  47.                 use a dash (û) command modifier or .IGNORE. Overrides /K if both
  48.                 are specified.
  49.  
  50. /K              Continues building unrelated dependencies, if a command returns an error.
  51.                 Also issues a warning and returns an exit code of 1. By default, 
  52.                 NMAKE halts if any command returns a nonzero exit code. 
  53.                 Warnings from /K are suppressed by /C; /I overrides /K if both are specified.
  54.  
  55. /N              Displays but does not execute commands; preprocessing commands are executed.
  56.                 Does not display commands in recursive NMAKE calls. Useful for debugging
  57.                 makefiles and checking timestamps. To set or clear /N for part of a makefile,
  58.                 use !CMDSWITCHES.
  59.  
  60. /NOLOGO         Suppresses the NMAKE copyright message.
  61.  
  62. /P              Displays information (macro definitions, inference rules, targets, 
  63.                 .SUFFIXES list) to standard output, and then runs the build.
  64.                 If no makefile or command-line target exists, it displays information only. 
  65.                 Use with /D to debug a makefile.
  66.  
  67. /Q              Checks timestamps of targets; does not run the build. Returns a zero exit
  68.                 code if all targets are up-to-date and a nonzero exit code if any target 
  69.                 is not. Preprocessing commands are executed. Useful when running NMAKE
  70.                 from a batch file.
  71.  
  72. /R              Clears the .SUFFIXES list and ignores inference rules and macros that are 
  73.                 predefined.
  74.  
  75. /S              Suppresses display of executed commands. To suppress display in part of a 
  76.                 makefile, use the @ command modifier or .SILENT. To set or clear /S for 
  77.                 part of a makefile, use !CMDSWITCHES.
  78.  
  79. /T              Updates timestamps of command-line targets (or first makefile target)
  80.                 and executes preprocessing commands but does not run the build.
  81.  
  82. /U              Must be used in conjunction with /N. Dumps inline NMAKE files so that 
  83.                 the /N output can be used as a batch file.
  84.  
  85. /X filename     Sends NMAKE error output to filename instead of standard error. Spaces or 
  86.                 tabs can precede filename. To send error output to standard output, 
  87.                 specify a dash (û) for filename. Does not affect output from commands 
  88.                 to standard error.
  89.  
  90. /Y              Disables batch-mode inference rules. When this option is selected, 
  91.                 all batch-mode inference rules are treated as regular inference rules.
  92.  
  93.  
  94. NMAKE returns the following exit codes.
  95.  
  96. Code            Meaning
  97. --------        -------------------------------------------------------
  98. 0               No error (possibly a warning)
  99.  
  100. 1               Incomplete build (issued only when /K is used)
  101.  
  102. 2               Program error, possibly due to one of the following:
  103.                     A syntax error in the makefile 
  104.                     An error or exit code from a command 
  105.                     An interruption by the user 
  106.  
  107. 4               System errorùout of memory
  108.  
  109. 255             Target is not up-to-date (issued only when /Q is used)
  110.  
  111.  
  112.