zig-bootstrap icon indicating copy to clipboard operation
zig-bootstrap copied to clipboard

Add copy-pastable build instructions

Open matklad opened this issue 2 years ago • 3 comments

The main value here is to put CMAKE_GENERATOR=Ninja front-and-center, so that users realize that extra steps are needed for a parallel build.

It is documented quite clearly already, but, from my very personal experience:

  • people don't read the docs and spend hours hammering one poor core
  • even if people do read the docs, when the come back to the repo the second time around, they forget, and hammer that single poor core again :-)

matklad avatar Aug 25 '23 12:08 matklad

This makes it look like ninja is a requirement rather than an option.

people don't read the docs and spend hours hammering one poor core

Perhaps we could put CMAKE_BUILD_PARALLEL_LEVEL=$(nproc) instead?

daurnimator avatar Aug 26 '23 10:08 daurnimator

I think ninja is a better default (simpler, faster, consistent across platforms), so, given that we already need CMake, nudging towards ninja seems like the right call.

matklad avatar Aug 26 '23 22:08 matklad

Maybe also add Windows Build Instructions to TL;DR?

LinuxUserGD avatar Aug 30 '23 14:08 LinuxUserGD