name: subdir_done
returns: void
description: |
  Stops further interpretation of the Meson script file from the point
  of the invocation. All steps executed up to this point are valid and
  will be executed by Meson. This means that all targets defined before
  the call of [[subdir_done]] will be build.

  If the current script was called by `subdir` the execution returns to
  the calling directory and continues as if the script had reached the
  end. If the current script is the top level script Meson configures
  the project as defined up to this point.

example: |
  ```meson
  project('example exit', 'cpp')
  executable('exe1', 'exe1.cpp')
  subdir_done()
  executable('exe2', 'exe2.cpp')
  ```

  The executable `exe1` will be build, while the executable `exe2` is not
  build.