a/ziglings
1
0
Fork 0
mirror of https://codeberg.org/andyscott/ziglings.git synced 2024-09-19 19:38:07 -04:00
Code Issues Projects Releases Packages Wiki Activity

Second attempt at explaining the minimum build (#14)

Browse source
This commit is contained in:
Dave Gauer 2021-02-15 20:04:18 -05:00
parent a2b6b68a25
commit 3693a35aeb
2 changed files with 18 additions and 12 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

24
README.md
View file

@ -3,7 +3,10 @@
Welcome to `ziglings`! This project contains a series of tiny broken programs. Welcome to `ziglings`! This project contains a series of tiny broken programs.
By fixing them, you'll learn how to read and write By fixing them, you'll learn how to read and write
[Zig](https://ziglang.org/) [Zig](https://ziglang.org/)
code! code.
Those tiny broken programs need your help! (You'll also help some friendly
elephants stick together, which is very sweet of you.)
This project was directly inspired by the brilliant and fun This project was directly inspired by the brilliant and fun
[rustlings](https://github.com/rust-lang/rustlings) [rustlings](https://github.com/rust-lang/rustlings)
@ -26,9 +29,10 @@ to also check out these Zig language resources for more detail:
## Getting Started ## Getting Started
Install a [master build](https://ziglang.org/download/) of the Zig compiler. Install a [development build](https://ziglang.org/download/) of the Zig compiler.
(See the "master" section of the downloads page.)
Verify the installation and version of `zig` like so: Verify the installation and build version of `zig` like so:
```bash ```bash
$ zig version $ zig version
@ -50,16 +54,16 @@ $ zig build
## A Note About Versions ## A Note About Versions
The Zig language is under very active development. Ziglings will attempt to The Zig language is under very active development. In order to be current,
be current, but not bleeding-edge. However, sometimes fundamental changes Ziglings tracks development builds of the Zig compiler rather than versioned
will happen. Ziglings will check for a minimum version and build number. releases. The last stable release was `0.7.1`, but Ziglings needs a dev build
with pre-release version "0.8.0" and a build number at least as high as that
(See Getting Started above for the current minimum.) shown in the example version check above.
It is likely that you'll download a build which is _greater_ than the minimum. It is likely that you'll download a build which is _greater_ than the minimum.
Once you have a version of the Zig compiler that works with your copy of Once you have a build of the Zig compiler that works with Ziglings, they'll
Ziglings, they'll continue to work together. But if you update one, you may continue to work together. But keep in mind that if you update one, you may
need to also update the other. need to also update the other.
## Advanced Usage ## Advanced Usage

6
build.zig
View file

@ -273,9 +273,11 @@ pub fn build(b: *Builder) void {
stderrPrintFn( stderrPrintFn(
\\ERROR: Sorry, it looks like your version of zig is too old. :-( \\ERROR: Sorry, it looks like your version of zig is too old. :-(
\\ \\
\\The README lists the minimum version and build number. \\Ziglings requires a development ("master") build
\\ \\
\\Please download a master build from \\ 0.8.0-dev.1065
\\
\\or higher. Please download a development build from
\\https://ziglang.org/download/ \\https://ziglang.org/download/
\\ \\
, .{}); , .{});