|author||David Robillard <firstname.lastname@example.org>||2006-06-09 15:07:31 +0000|
|committer||David Robillard <email@example.com>||2006-06-09 15:07:31 +0000|
Added Om aka Graph aka god knows what
git-svn-id: http://svn.drobilla.net/lad/grauph@9 a436a847-0d15-0410-975c-d299462d15a1
Diffstat (limited to 'README')
1 files changed, 44 insertions, 0 deletions
diff --git a/README b/README
new file mode 100644
@@ -0,0 +1,44 @@
+Om is a realtime modular synthesizer for Jack/Alsa/LADSPA/DSSI (ie GNU/Linux
+audio systems). More information may be found at http://om-synth.nongnu.org
+To build, do the typical "./configure; make; make install" routine - check
+"./configure --help" for options.
+You can build just the engine (and avoid all the gtk/libxml/etc dependancies)
+by doing the same in the src/engine directory.
+*** Optimisation ***
+Om's configure script, by default, does not clobber your CFLAGS or CXXFLAGS
+environment variables (which is the proper behaviour), though it does add
+a few flags that should be turned on in any case.
+If you have GCC4, it is HIGHLY recommended that you enable your SIMD
+instruction set (ie "-march=pentium4 -mfpmath=sse" in the case of a P4
+with SSE) through your CXXFLAGS environment variable. The performance
+improvement (and denormal avoidance if you have a P4) is significant.
+Om makes very heavy use of assertions to catch bugs. Assertions have a
+performance hit unless the preprocessor symbol NDEBUG is defined. By default
+the configure script will add this to the end of your flags, but it's worth
+noting. You really don't want assertions turned on in a production build.
+However, if you encounter a bug (especially a segfault) it would be a good
+idea to rebuild with --enable-debug, chances are you'll hit an assertion and
+the console output will be a sufficient bug report so I can fix the problem.
+*** Bugs ***
+If Om crashes, REPORT THE BUG. Things can't get fixed if I don't know about
+them, and if you report it, it will get fixed - probably immediately.
+Please, report the bug. There's a nice form on the Savannah page to do so,
+no mailing required.