tools/build/options/WITH_META_MODE

   1 .\" $FreeBSD$
   2 Creates
   3 .Xr make 1
   4 meta files when building, which can provide a reliable incremental build when
   5 using
   6 .Xr filemon 4 .
   7 The meta file is created in the OBJDIR as
   8 .Pa target.meta .
   9 These meta files track the command ran, its output, and the current directory.
  10 When the
  11 .Xr filemon 4
  12 module is loaded, any files used by the commands executed will be tracked as
  13 dependencies for the target in its meta file.
  14 The target will be considered out-of-date and rebuilt if any of the following
  15 are true compared to the last build:
  16 .Bl -bullet -compact
  17 .It
  18 The command to execute changes.
  19 .It
  20 The current working directory changes.
  21 .It
  22 The target's meta file is missing.
  23 .It
  24 [requires
  25 .Xr filemon 4 ]
  26 Files read, executed or linked to are newer than the target.
  27 .It
  28 [requires
  29 .Xr filemon 4 ]
  30 Files read, written, executed or linked are missing.
  31 .El
  32 The meta files can also be useful for debugging.
  33 .Pp
  34 The build will hide commands ran unless
  35 .Va NO_SILENT
  36 is defined.
  37 .Pp
  38 The build operates as it normally would otherwise.
  39 This option originally invoked a different build system but that was renamed
  40 to
  41 .Va WITH_DIRDEPS_BUILD .