TODO
====
Bugs To Fix
-----------
Problem: running out of bugs to fix.
Features To Enhance
-------------------
Feature: script interface should include runtime statistics.
Feature: script interface should include level to radius fading.
Feature: script interface should include view validity testing.
Feature: script interface should include more complete input handling.
Feature: 'transition.lua' should work without 'dt' depending on 'z'.
Feature: large tiled texture might be more efficient when drawing.
Other Known Issues
------------------
Problem: script errors terminate 'mandulia' abruptly.
Cause: lack of error checking in 'Interface.hs'.
Solution: don't write buggy scripts.
Problem: real-time operation lags Julia rendering at rapid movements.
Cause: Your system is too SLOW to play this!
Solution: get a faster computer.
Problem: recording enabled leads to higher quality.
Cause: main thread blocks on image output, Julia renderer threads don't.
Solution: use another worker thread for image output (but HQ recs are nice).
Problem: scripts printing to 'stdout' corrupts recordings.
Cause: recordings go to 'stdout', which expects nothing but recordings.
Solution: somehow redirect all Lua 'stdout' to 'stderr'.
Problem: script's 'render()' doesn't get called when the window is hidden.
Cause: that's exactly the way GLUT is supposed to behave.
Solution: switch to a less smelly UI library to wrap OpenGL. SDL?
Problem: 'extra/' in git repository contains unrelated code.
Cause: ppmtoy4m was a video encoding bottleneck, needed speeding up.
Solution: move that code to a different repository.
Problem: very occasional glibc realloc() crashes.
Cause: possibly an nVidia driver issue?
Solution: unknown. seems sporadic and random.
Cause: possibly a Lua stack overflow?
Solution: fixed in eb8a82052c7f50a64bd23d19278757a649f23f9c