From bddb073043efa12f753349a9944bc611f83bdf96 Mon Sep 17 00:00:00 2001
From: Dhiru Kholia <dhiru.kholia@gmail.com>
Date: Tue, 10 Oct 2017 09:16:36 +0530
Subject: [PATCH] Minor documentation updates

---
 HighSierra/README.md | 7 +++++++
 README.md            | 6 ++++++
 UEFI/README.md       | 3 +++
 boot-macOS-HS.sh     | 3 +++
 4 files changed, 19 insertions(+)

diff --git a/HighSierra/README.md b/HighSierra/README.md
index 9281d72..764efb6 100644
--- a/HighSierra/README.md
+++ b/HighSierra/README.md
@@ -11,6 +11,9 @@ Known to work on:
 
 * Ubuntu 17.04 running on i5-6500 CPU.
 
+* Gentoo (October-2017) running on AMD FX-8320 CPU with AMD RX 470 GPU
+  passthrough.
+
 Tested with QEMU >= 2.10 (with an out-of-tree patch) and Linux 4.10.x / 4.12.x.
 A CPU with SSE4.1 support is required for macOS High Sierra. Intel VT-x / AMD
 SVM is required.
@@ -22,6 +25,8 @@ SVM is required.
 
 * Download macOS High Sierra installer from Apple App Store.
 
+  If you are getting a partial installer from the Apple App Store, [follow the instructions here](http://osxdaily.com/2017/09/27/download-complete-macos-high-sierra-installer/) to get the full (5GB) version instead.
+
 * Clone this repository. Files included in this repository are needed for ISO
   creation.
 
@@ -129,6 +134,8 @@ changes and exit the OVMF menu. Relaunch the `boot-macOS-HS.sh` script.
 * For debugging and general tips, see the main [README.md](../README.md) file
   and [notes.md](../notes.md) file.
 
+* For USB and GPU passthrough notes, see [UEFI notes](../UEFI/README.md) file.
+
 
 ### Credits
 
diff --git a/README.md b/README.md
index c6f13e7..16a47a6 100644
--- a/README.md
+++ b/README.md
@@ -196,6 +196,12 @@ method or the following `virsh` method to install OS X / macOS.
   problematic, whereas Linux 4.9.x with QEMU 2.8.x works fine on the same
   distribution.
 
+### Is This Legal?
+
+The "secret" Apple OSK string is widely available on the Internet. It is also included in a public court document [available here](http://www.rcfp.org/sites/default/files/docs/20120105_202426_apple_sealing.pdf). I am not a lawyer but it seems that Apple's attempt(s) to get the OSK string treated as a trade secret did not work out. Due to these reasons, the OSK string is freely included in this repository.
+
+Gabriel Somlo also has [some thoughts](http://www.contrib.andrew.cmu.edu/~somlo/OSXKVM/#sec_4) on the legal aspects involved in running macOS under QEMU/KVM.
+
 ### References
 
 * https://github.com/Karlson2k/k2k-OSX-Tools
diff --git a/UEFI/README.md b/UEFI/README.md
index b82aba6..5602aee 100644
--- a/UEFI/README.md
+++ b/UEFI/README.md
@@ -117,6 +117,9 @@ I am running Ubuntu 17.04 on Intel i5-6500 + ASUS Z170-AR motherboard + NVIDIA
 * To reuse the keyboard and mouse devices from the host, setup "Automatic
   login" in System Preferences in macOS and configure Synergy software.
 
+Note: Many AMD GPU devices (e.g. AMD RX 480 & RX 580) should be natively
+supported in macOS High Sierra.
+
 ### USB passthrough notes
 
 These steps will need to be adapted for your particular setup.
diff --git a/boot-macOS-HS.sh b/boot-macOS-HS.sh
index b197ed0..1463f6f 100755
--- a/boot-macOS-HS.sh
+++ b/boot-macOS-HS.sh
@@ -3,6 +3,9 @@
 # See https://www.mail-archive.com/qemu-devel@nongnu.org/msg471657.html thread.
 #
 # The "pc-q35-2.4" machine type was changed to "pc-q35-2.9" on 06-August-2017.
+#
+# The "media=cdrom" part is needed to make Clover recognize the bootable ISO
+# image.
 
 ##################################################################################
 # NOTE: Comment out the "MY_OPTIONS" line in case you are having booting problems!