1 files changed, 19 insertions, 0 deletions
diff --git a/OvmfPkg/README b/OvmfPkg/README
index 04a658fa31..51041a0551 100644
--- a/OvmfPkg/README
+++ b/OvmfPkg/README
@@ -115,3 +115,22 @@ To add network drivers to OVMF:
     -net nic,model=e1000,addr=3 -net nic,model=e1000,addr=4
     -net user,restrict=yes -net user,dhcpstart=10.0.2.10
 
+=== UNIXGCC Debug ===
+
+If you build with the UNIXGCC toolchain, then debugging will be disabled
+due to larger image sizes being produced by the UNIXGCC toolchain. The
+first choice recommendation is to use GCC44 or newer instead.
+
+If you must use UNIXGCC, then you can override the build options for
+particular libraries and modules in the .dsc to re-enable debugging
+selectively. For example:
+  [Components]
+  OvmfPkg/Library/PlatformBdsLib/PlatformBdsLib.inf {
+    <BuildOptions>
+      GCC:*_*_*_CC_FLAGS             = -UMDEPKG_NDEBUG
+  }
+  IntelFrameworkModulePkg/Universal/BdsDxe/BdsDxe.inf {
+    <BuildOptions>
+      GCC:*_*_*_CC_FLAGS             = -UMDEPKG_NDEBUG
+  }
+