1 files changed, 16 insertions, 8 deletions
diff --git a/audio/foo-yc20/README b/audio/foo-yc20/README
index 83a7436789..4cea340315 100644
--- a/audio/foo-yc20/README
+++ b/audio/foo-yc20/README
@@ -1,20 +1,28 @@
 foo-yc20 (Yamaha YC-20 organ emulator for JACK and LV2)
 
-This is an implementation of a 1969 designed Yamaha combo organ,
-the YC-20.
+This is an implementation of a 1969 designed Yamaha combo organ, the YC-20.
 
 Original YC-20 organs have a touch vibrato control, which is vibrato
-induced by horizontal movement of the keys. As there very few (almost
-none) midi keyboards which produce such information, this feature has
+induced by horizontal movement of the keys. As there are very few (almost
+no) MIDI keyboards which produce such information, this feature has
 been left out of the emulation. Instead of the touch vibrato control,
 the control panel hosts a "realism" switch.
 
-By default, the package is built with -march=native, which tells gcc
-to use the host CPU's features such as SSE2. You can disable this by
-passing FORCE_SLACK_CFLAGS=yes to the script.
-
 This package uses POSIX filesystem capabilities to execute with
 elevated privileges (required for realtime audio processing). This
 may be considered a security/stability risk. Please read
 http://www.slackbuilds.org/caps/ for more information. To disable
 capabilities, pass SETCAP=no to the script.
+
+Since audio synthesis is compute-intensive, compiler optimizations might
+actually make a noticeable difference. The environment variable OPTIMIZE
+can be set to:
+
+- OPTIMIZE="default" (or, unset) builds with -O2 -march=native.
+
+- OPTIMIZE="slack" builds with standard Slackware flags. Use this if you're
+  going to e.g. build a package on a system with SSE2 that you're going to
+  install on a system without SSE2).
+
+- OPTIMIZE="upstream" builds with -O3 -march=native. This requires up to
+  6GB of memory (ram + swap) and takes up to 10 times as long to build.