;;;; -*- coding: utf-8; fill-column: 78 -*-

This documents the current status of the trunk code.  It's meant as a
high-level overview of what to expect if you compile Benben using the code in
the current checkout.

=======
Overall
=======

Only partially working, lots of bugs or incomplete things.  Expect the program
to be fragile.

KNOWN ISSUE: When playing a module, using Ctrl-C can cause the entire Lisp
instance to die when in Slime.  This doesn't seem to happen when Benben is a
command line program.

=======
Loading
=======

* VGM loading: working
* Module loading: working
* MIDI: working
* SoundFonts: working
* MP1/2/3: working
* FLAC: working
* Opus: working
* Vorbis: working
* WAV/Au: working
* QOA: working
* XQAF: working
* WavPack: working
* XSPF/JSPF: working
* SID: working
* Local files: working

=============
Audio/Formats
=============

* VGMs (satousynth): working
* Modules (cl-remichips): working
* MIDI (cl-remichops): working
* MP1/2/3 (cl-remiaudio): working
* FLAC (cl-remiaudio): working
* Opus (cl-remiaudio): working
* Vorbis (cl-remiaudio): working
* WAV/Au (cl-remiaudio): working
* QOA (cl-remiaudio): working
* XQAF (cl-remiaudio): working
* WavPack (cl-remiaudio): working
* SID (cl-remichips): working
* Seeking: working
* Resampling (cl-remiaudio): working
* ReplayGain: working for all CL-RemiAudio format that support it

======
Config
======

* Overall: working
* Song-specific configs: working

=========
Rendering
=========

* VGMs: working
* Modules: working
* MIDI: working
* MP1/2/3: working
* FLAC: working
* Opus: working
* Vorbis: working
* WAV/Au: working
* QOA: working
* XQAF: working
* SID: working
* WavPack: working
* CUE writing: working
* Normalization: working
* Auto-directories: working

=======================
Original User Interface
=======================

* Overall: working
* Input: working
* Tags: working
* VU: working
* Themes: working
* Total time display: working
* Song queue: working

=======================
Minimal User Interface
=======================

* Overall: working
* Input: not applicable
* Tags: working
* VU: not applicable
* Themes: not applicable
* Total time display: working
* Song queue: not applicable

=======
Effects
=======

* EQ: working
* Reverb: working
* Soft clipping: working
* Stereo enhancer: working
* DC offset filter: working

NOTE 1: There is a bug in RemiAudio where MVerb cannot reliably play back files
at or below a sample rate of 23465 Hz.  If you need to play files at or below
this rate, use Zita for a reverb effect for the time being until this is fixed
in RemiAudio.  It's assumed this carried over into the Common Lisp code.  The
upstream ticket is here:
https://chiselapp.com/user/MistressRemilia/repository/remiaudio/tktview/2d98cef604baaece841e5d6fa4580dcd184e3023

===============
Error Reporting
===============

* Startup errors: working
* Initial file checking errors: working
* Errors loading songs during playback: working
* Redirect stderr: working

==============
Remote Control
==============

* Server-side: working
* CLI program: working
