doc/hooks/zig.section.md: rewrite

- Normalize header IDs, in order to not cause conflicts with identically named
headers in other docs.
- Reorganize the hierarchy of information.

+8 -8
+8 -8
doc/hooks/zig.section.md
··· 4 4 5 5 In Nixpkgs, `zig.hook` overrides the default build, check and install phases. 6 6 7 - ## Example code snippet {#example-code-snippet} 7 + ## Example code snippet {#zig-hook-example-code-snippet} 8 8 9 9 ```nix 10 10 { lib ··· 27 27 } 28 28 ``` 29 29 30 - ## Variables controlling zig.hook {#variables-controlling-zig-hook} 30 + ## Variables controlling zig.hook {#zig-hook-variables-controlling} 31 31 32 - ### `zig.hook` Exclusive Variables {#zigHookExclusiveVariables} 32 + ### `zig.hook` Exclusive Variables {#zig-hook-exclusive-variables} 33 33 34 34 The variables below are exclusive to `zig.hook`. 35 35 36 - #### `dontUseZigBuild` {#dontUseZigBuild} 36 + #### `dontUseZigBuild` {#dont-use-zig-build} 37 37 38 38 Disables using `zigBuildPhase`. 39 39 40 - #### `dontUseZigCheck` {#dontUseZigCheck} 40 + #### `dontUseZigCheck` {#dont-use-zig-check} 41 41 42 42 Disables using `zigCheckPhase`. 43 43 44 - #### `dontUseZigInstall` {#dontUseZigInstall} 44 + #### `dontUseZigInstall` {#dont-use-zig-install} 45 45 46 46 Disables using `zigInstallPhase`. 47 47 48 - ### Similar variables {#similarVariables} 48 + ### Similar variables {#zig-hook-similar-variables} 49 49 50 50 The following variables are similar to their `stdenv.mkDerivation` counterparts. 51 51 ··· 55 55 | `zigCheckFlags` | `checkFlags` | 56 56 | `zigInstallFlags` | `installFlags` | 57 57 58 - ### Variables honored by zig.hook {#variables-honored-by-zig-hook} 58 + ### Variables honored by zig.hook {#zig-hook-variables-honored} 59 59 60 60 The following variables commonly used by `stdenv.mkDerivation` are honored by `zig.hook`. 61 61