|
6 | 6 | //
|
7 | 7 | // It is redundant to include "zig" in this name because it is already
|
8 | 8 | // within the Zig package namespace.
|
9 |
| - .name = "state-transition-z", |
| 9 | + .name = .state_transition_z, |
10 | 10 |
|
11 | 11 | // This is a [Semantic Version](https://semver.org/).
|
12 | 12 | // In a future version of Zig it will be used for package deduplication.
|
13 | 13 | .version = "0.0.0",
|
14 | 14 |
|
15 |
| - // This field is optional. |
16 |
| - // This is currently advisory only; Zig does not yet do anything |
17 |
| - // with this value. |
18 |
| - //.minimum_zig_version = "0.11.0", |
| 15 | + // Together with name, this represents a globally unique package |
| 16 | + // identifier. This field is generated by the Zig toolchain when the |
| 17 | + // package is first created, and then *never changes*. This allows |
| 18 | + // unambiguous detection of one package being an updated version of |
| 19 | + // another. |
| 20 | + // |
| 21 | + // When forking a Zig project, this id should be regenerated (delete the |
| 22 | + // field and run `zig build`) if the upstream project is still maintained. |
| 23 | + // Otherwise, the fork is *hostile*, attempting to take control over the |
| 24 | + // original project's identity. Thus it is recommended to leave the comment |
| 25 | + // on the following line intact, so that it shows up in code reviews that |
| 26 | + // modify the field. |
| 27 | + .fingerprint = 0xd1ddb6abe067ee04, // Changing this has security and trust implications. |
| 28 | + |
| 29 | + // Tracks the earliest Zig version that the package considers to be a |
| 30 | + // supported use case. |
| 31 | + .minimum_zig_version = "0.14.0", |
19 | 32 |
|
20 | 33 | // This field is optional.
|
21 | 34 | // Each dependency must either provide a `url` and `hash`, or a `path`.
|
|
27 | 40 | //.example = .{
|
28 | 41 | // // When updating this field to a new URL, be sure to delete the corresponding
|
29 | 42 | // // `hash`, otherwise you are communicating that you expect to find the old hash at
|
30 |
| - // // the new URL. |
| 43 | + // // the new URL. If the contents of a URL change this will result in a hash mismatch |
| 44 | + // // which will prevent zig from using it. |
31 | 45 | // .url = "https://example.com/foo.tar.gz",
|
32 | 46 | //
|
33 | 47 | // // This is computed from the file contents of the directory of files that is
|
|
45 | 59 | // // build root. In this case the package's hash is irrelevant and therefore not
|
46 | 60 | // // computed. This field and `url` are mutually exclusive.
|
47 | 61 | // .path = "foo",
|
48 |
| - |
| 62 | + // |
49 | 63 | // // When this is set to `true`, a package is declared to be lazily
|
50 | 64 | // // fetched. This makes the dependency only get fetched if it is
|
51 | 65 | // // actually used.
|
|
0 commit comments