# zig build system: change target, compilation, and module APIs · gitcafe/zig

[View on GitCafe](https://git.cafe/gitcafe/zig/commit/142471fcc46070326526e3976f0150fe734df0b6)

Repository: [gitcafe/zig](https://git.cafe/gitcafe/zig)

Visibility: public

Requested revision: 142471fcc46070326526e3976f0150fe734df0b6

Requested commit: 142471fcc46070326526e3976f0150fe734df0b6

Commit: 142471fcc46070326526e3976f0150fe734df0b6

Tree: 67d4dec7968cf6d6765cd3bc66524721cf0554d2

Author: Andrew Kelley

Committer: Andrew Kelley

## Message

```
zig build system: change target, compilation, and module APIs

Introduce the concept of "target query" and "resolved target". A target
query is what the user specifies, with some things left to default. A
resolved target has the default things discovered and populated.
In the future, std.zig.CrossTarget will be rename to std.Target.Query.
Introduces `std.Build.resolveTargetQuery` to get from one to the other.

The concept of `main_mod_path` is gone, no longer supported. You have to
put the root source file at the module root now.

* remove deprecated API
* update build.zig for the breaking API changes in this branch
* move std.Build.Step.Compile.BuildId to std.zig.BuildId
* add more options to std.Build.ExecutableOptions, std.Build.ObjectOptions,
  std.Build.SharedLibraryOptions, std.Build.StaticLibraryOptions, and
  std.Build.TestOptions.
* remove `std.Build.constructCMacro`. There is no use for this API.
* deprecate `std.Build.Step.Compile.defineCMacro`. Instead,
  `std.Build.Module.addCMacro` is provided.
  - remove `std.Build.Step.Compile.defineCMacroRaw`.
* deprecate `std.Build.Step.Compile.linkFrameworkNeeded`
  - use `std.Build.Module.linkFramework`
* deprecate `std.Build.Step.Compile.linkFrameworkWeak`
  - use `std.Build.Module.linkFramework`
* move more logic into `std.Build.Module`
* allow `target` and `optimize` to be `null` when creating a Module.
  Along with other fields, those unspecified options will be inherited
  from parent `Module` when inserted into an import table.
* the `target` field of `addExecutable` is now required. pass `b.host`
  to get the host target.

```

## Parents

- [579f572cf203eda11da7e4e919fdfc12e15f03e2](https://git.cafe/gitcafe/zig/commit/579f572cf203eda11da7e4e919fdfc12e15f03e2?format=markdown)

[Source at this commit](https://git.cafe/gitcafe/zig/tree/142471fcc46070326526e3976f0150fe734df0b6?format=markdown)