From 295578875f9f4dab1cc102f555929814d12c77a2 Mon Sep 17 00:00:00 2001 From: Brooke Kuhlmann Date: Wed, 13 Mar 2019 07:06:31 -0600 Subject: [PATCH] Added XCode installer fix to troubleshooting section. I've not experienced this yet but others have so adding to the troubleshooting section in case it is of help. [ci skip] --- README.md | 21 ++++++++++++++------- 1 file changed, 14 insertions(+), 7 deletions(-) diff --git a/README.md b/README.md index 70be9b4..81d4294 100644 --- a/README.md +++ b/README.md @@ -179,13 +179,20 @@ project is built upon the functions found in the `lib` folder. See the ## Troubleshooting -When using the boot disk, you might experience a situation where you see a black screen with a white -circle and diagonal line running through it. This means macOS lost or can't find the boot disk for -some reason. To correct this, shut down and boot up the system again while holding down the -`OPTION+COMMAND+R+P` keys simultaneously. You might want to wait for the system boot sound to happen -a few times before releasing the keys. This will clear the system NVRAM/PRAM. At this point you can -shut down and restart the system following the boot disk instructions (the boot disk will be -recognized now). +- When using the boot disk, you might experience a situation where you see a black screen with a + white circle and diagonal line running through it. This means macOS lost or can't find the boot + disk for some reason. To correct this, shut down and boot up the system again while holding down + the `OPTION+COMMAND+R+P` keys simultaneously. You might want to wait for the system boot sound to + happen a few times before releasing the keys. This will clear the system NVRAM/PRAM. At this point + you can shut down and restart the system following the boot disk instructions (the boot disk will + be recognized now). +- Sometimes, when installing XCode development tools (i.e. the `t` option), not all of the macOS + headers will be installed. This can cause issues with compiling and building native packages. For + example: `fatal error: 'stdio.h' file not found`. This can happen due to an intermittent bug with + the XCode installer. To fix this, you'll need to install this package: + `/Library/Developer/CommandLineTools/Packages/macOS_SDK_headers_for_macOS_10.14.pkg`. Depending on + your system, the version might differ, so look for a `*.pkg` in the + `/Library/Developer/CommandLineTools/Packages` folder. ## Versioning