# HG changeset patch
# User Matti Hamalainen <ccr@tnsp.org>
# Date 1352121307 -7200
# Node ID 8c80b3c5c053b2d8e8d0dcb13da646e482a9f98c
# Parent  aa8f054e27a34105d55301c1c2da90677795fce2
Update documentation concerning libSIDPlay-FP etc.

diff -r aa8f054e27a3 -r 8c80b3c5c053 INSTALL
--- a/INSTALL	Mon Nov 05 15:08:44 2012 +0200
+++ b/INSTALL	Mon Nov 05 15:15:07 2012 +0200
@@ -15,7 +15,7 @@
 - You need AT LEAST one of the following emulation libraries:
 
    * libSIDPlay1
-   * libSIDPlay2
+   * libSIDPlay2 or libSIDPlay-FP (mutually exclusive)
 
   Only one emulator backend library is required, but all are
   supported with compile & run-time configuration. You may also
@@ -44,24 +44,32 @@
   libSIDPlay v1 does NOT support.
 
 
-- libSIDPlay v2: New, next generation modular SID-emulation framework.
-  Along with reSID-library it produces probably most accurate emulated
-  representation of SID-chip available. This, however, comes at high
-  cost: libSIDPlay2 tends to eat CPU like popcorn, depending on the
-  selected emulation options. It is also less spread, not as many
-  distributions/operating systems come with pre-packaged libSIDPlay2,
-  so you may have to roll your own.
+- libSIDPlay2+reSID or HardSID: A much more accurate emulation
+  framework. Unfortunately the original fork has mostly stalled,
+  though works. Much heavier CPU-load compared to libSIDPlay1,
+  but not as heavy as libSIDPlay-FP.
+
 
-  Also the API-stability of libSIDPlay2 is not yet 100%, there may
+- libSIDPlay-FP: Fork of libSIDPlay2. New, next generation modular
+  SID-emulation framework. Along with reSID-library it produces
+  probably most accurate software-emulated representation of
+  SID-chip available. This, however, comes at high cost:
+  libSIDPlay2/FP tends to eat CPU like popcorn.
+
+  It is also less spread, not packaged in distributions (that I know of,
+  at the time of writing of this), so you may have to roll your own.
+
+  Also the API-stability of libSIDPlay2/FP is not yet 100%, there may
   be changes. Bugs are evident, though many of them will be fixed
   eventually.
 
   
-Conclusion thus is as follows: If you are using an old system with not
-much spare CPU-power, choose libSIDPlay v1. On a relatively recent
-system (more powerful than Pentium III 650MHz) you may wish to choose
-libSIDPlay v2, although your mileage may vary depending on the emulation
-settings.
+Conclusion thus is as follows: If you are using a VERY old system with not
+much spare CPU-power, choose libSIDPlay v1. On a relatively "recent"
+system (Pentium-M, Pentium4 1GHz+) you may wish to choose libSIDPlay v2.
+
+On a Intel Core2 or Intel Core i5/7 level system you could choose
+libSIDPlay-FP, if you have ~20% CPU to spare.
 
 
 Where to get XMMS?