diff --git a/BUGS/VGA tearline bugs.txt b/BUGS/VGA tearline bugs.txt
index 733838017..8b1378917 100644
--- a/BUGS/VGA tearline bugs.txt	
+++ b/BUGS/VGA tearline bugs.txt	
@@ -1,3 +1 @@
-Project Angel (demo):
- - Tearline in VGA Mode-X sections of the demo (when demo matches refresh rate)
 
diff --git a/NOTES/Project Angel (demo).txt b/NOTES/Project Angel (demo).txt
index 2952b033a..a6a92634b 100644
--- a/NOTES/Project Angel (demo).txt	
+++ b/NOTES/Project Angel (demo).txt	
@@ -8,6 +8,12 @@ Requirements:
  - at least cycles count 12000
  - gus=true
  - machine=svga_s3 (will not start with machine=vgaonly)
+ - pit hack=project_angel_demo (this setting forces the PIT to fixed values that forces the demo to run and keep time properly)
+
+Note that the comments below apply to the demo when run without the PIT hack. The PIT hack forces the timer to tick
+at one of two time intervals in a way that forces the demo to run at the correct rate and helps prevent the demo
+from hanging at startup. For whatever reason, the PIT hack also resolves issues with music skipping forward during
+VGA mode changes, and eliminates the visible VGA tearline in the Mode-X parts.
 
 Demo comments:
  - This demo is very picky about timing. In fact, when you run the