Docs file normalization.

This commit is contained in:
Johannes Findeisen 2026-11-06 15:20:20 +01:00
commit 619c2d0808
46 changed files with 3587 additions and 2579 deletions

View file

@ -1,50 +1,60 @@
# 0.1.0 development release notes
# 0.1.0 Development Release Notes
This remains a development prototype, not a production-qualified DAW. The local
release workflow is complete without bumping the application version, creating a
tag or publishing artifacts. The exact source archive SHA-256 and
reviewed Git commit identify a build; version 0.1.0 alone does not identify all
of the development revisions that used that version.
tag or publishing artifacts. The exact source archive SHA-256 and reviewed Git
commit identify a build; version 0.1.0 alone does not identify all of the
development revisions that used that version.
## Included functionality
---
The C99 engine provides bounded graphs, immutable plan publication, stereo audio,
MIDI instruments and controller bindings, track/bus mixing, automation and inline
MIDI editing. The C++17 FLTK application adds arrangement, routing, recording,
undo/redo and a generic LADSPA editor. JACK is the only live audio/MIDI backend;
core validation and offline rendering work without it. Native/LADSPA processors
are trusted in-process code. No proprietary energyXT resources are included.
## Included Functionality
Project format v13 reads versions 1–13 transactionally. Syntax diagnostics identify
records and lines. `xtc-check --inspect` lists dependency paths without executing
plugins. Timing/CPU/RSS reports, repeatable stress runs and virtual endurance are
available. Configurable install directories, shared install/remove inventory,
installed MIDI examples and source archive checksum sidecars are also included.
The C99 engine provides bounded graphs, immutable plan publication, stereo
audio, MIDI instruments and controller bindings, track/bus mixing, automation
and inline MIDI editing. The C++17 FLTK application adds arrangement, routing,
recording, undo/redo and a generic LADSPA editor. JACK is the only live
audio/MIDI backend; core validation and offline rendering work without it.
Native/LADSPA processors are trusted in-process code. No proprietary energyXT
resources are included.
## Upgrading and removal
Project format v13 reads versions 1–13 transactionally. Syntax diagnostics
identify records and lines. `xtc-check --inspect` lists dependency paths without
executing plugins. Timing/CPU/RSS reports, repeatable stress runs and virtual
endurance are available. Configurable install directories, shared install/remove
inventory, installed MIDI examples and source archive checksum sidecars are also
included.
---
## Upgrading and Removal
Back up documents and external media before upgrading. Opening an older project
does not rewrite it; saving upgrades it to v12, which older readers may reject.
Use Save As for a separate migrated copy. Moving a project folder preserves media
stored inside it via relative references. Absolute media and plugin module paths
must be restored separately. There is no bundled plugin/media migration or saved
JACK port configuration. See PROJECT_FORMAT.md and RECOVERY.md for exact policies.
Use Save As for a separate migrated copy. Moving a project folder preserves
media stored inside it via relative references. Absolute media and plugin module
paths must be restored separately. There is no bundled plugin/media migration or
saved JACK port configuration. See PROJECT_FORMAT.md and RECOVERY.md for exact
policies.
Install to the same layout to repair owned files. Only documented owned filenames
are replaced; unrelated files with other names remain. Use the same source
version and directory variables for uninstall. It removes owned files and empty
owned directories, never recordings or recursively deleting a prefix. A changed
layout or an older release with a different inventory may require removing that
old version before installing the new one. No database/package-manager registration
or automatic cleanup of historical inventories is performed.
Install to the same layout to repair owned files. Only documented owned
filenames are replaced; unrelated files with other names remain. Use the same
source version and directory variables for uninstall. It removes owned files and
empty owned directories, never recordings or recursively deleting a prefix. A
changed layout or an older release with a different inventory may require
removing that old version before installing the new one. No
database/package-manager registration or automatic cleanup of historical
inventories is performed.
## Known qualification limits
---
## Known Qualification Limits
Physical devices, multi-hour wall-clock endurance, power-cut behavior and other
Linux distributions remain unqualified. There is no disk streaming, crash autosave,
plugin sandbox, latency compensation or stable shared-library ABI. A trusted
plugin can allocate, block or crash the process. Metadata inspection checks file
availability only. See KNOWN_LIMITATIONS.md for the complete list.
Linux distributions remain unqualified. There is no disk streaming, crash
autosave, plugin sandbox, latency compensation or stable shared-library ABI. A
trusted plugin can allocate, block or crash the process. Metadata inspection
checks file availability only. See KNOWN_LIMITATIONS.md for the complete list.
The retained graph performance gate has a documented small-case timing alert on
the shared development host; the project timing comparison passed. This alert
@ -53,56 +63,60 @@ measurements as latency expectations. Sanitizers and virtual endurance qualify
software paths, not hardware timing.
Default-configuration CLAP/VST2/VST3 mono effect loaders, common GUI
discovery/insertion/replacement and v11 format identity are supported. Pinned MIT CLAP and
BSD-3-Clause VST3 C headers ship with notices; VST2 uses original compatibility
declarations. Modern instruments, parameters/state/editors and multichannel
layouts remain unsupported. No third-party modern plugin has been qualified.
discovery/insertion/replacement and v11 format identity are supported. Pinned
MIT CLAP and BSD-3-Clause VST3 C headers ship with notices; VST2 uses original
compatibility declarations. Modern instruments, parameters/state/editors and
multichannel layouts remain unsupported. No third-party modern plugin has been
qualified.
CLAP/VST2/VST3 mono instruments are supported, bound to MIDI tracks, with
sample-offset notes, a saved live target, track mixing, GUI assignment/undo and
v12 persistence.
See PLUGIN_HOSTING.md for compatibility and controller/state limits.
v12 persistence. See PLUGIN_HOSTING.md for compatibility and controller/state
limits.
A flat DAW workspace, shared dark theme, track-creation sidebar, read-only
musical transport/track inspector, colored track clips and real MIDI previews are
included. New MIDI/audio track commands are undoable and prepare candidates
before adoption. The default window is 1280 × 800, minimum 1220 × 720.
No dependency or project-format change. See WORKSPACE.md and the new
musical transport/track inspector, colored track clips and real MIDI previews
are included. New MIDI/audio track commands are undoable and prepare candidates
before adoption. The default window is 1280 × 800, minimum 1220 × 720. No
dependency or project-format change. See WORKSPACE.md and the new
`modern-session.xtc` example; existing engine/plugin limitations still apply.
A sequencer grid/Snap dropdown, absolute grid snapping for moves and trims,
MIDI double-click editing, a piano velocity lane/slider and per-track instrument
A sequencer grid/Snap dropdown, absolute grid snapping for moves and trims, MIDI
double-click editing, a piano velocity lane/slider and per-track instrument
dropdowns are included. Snap preferences are UI state; velocity and instrument
bindings use the existing v12 format. No new dependency or engine feature is
required. See WORKSPACE.md for supported divisions, controller semantics and limits.
required. See WORKSPACE.md for supported divisions, controller semantics and
limits.
Edit / Preferences provides an Apply button and `~/.xtc.conf` INI persistence,
configurable plugin search paths and a file library, plus sequencer ruler loop
selection and sample-boundary playback wrapping. See PREFERENCES.md
for settings, reconnect behavior and looping limits.
selection and sample-boundary playback wrapping. See PREFERENCES.md for
settings, reconnect behavior and looping limits.
The single-track mixer panel is replaced by a scrolling studio mixer: vertical
dB faders, flat pan knobs, mute/solo, routing and stereo meters on every track and
bus, plus a pinned master monitor. Selected-track automation remains
below the strips. No project format or engine changes. Screenshots are refreshed;
see MIXER.md and screenshots/README.md.
dB faders, flat pan knobs, mute/solo, routing and stereo meters on every track
and bus, plus a pinned master monitor. Selected-track automation remains below
the strips. No project format or engine changes. Screenshots are refreshed; see
MIXER.md and screenshots/README.md.
Searchable Commands (Ctrl+P), editable project BPM, a live track inspector,
session statistics, Fit song and an optional persistent Follow playhead control
are included. Numeric input remains intact during display refreshes.
Screenshots are refreshed, including the command palette. See WORKSPACE.md.
are included. Numeric input remains intact during display refreshes. Screenshots
are refreshed, including the command palette. See WORKSPACE.md.
Dependency-free Soft Keys/Sub Bass instruments and Delay/Reverb effects are
included, with saved controls and automation. Choose instruments in track headers;
insert effects on selected graph wires from Edit. See [BUILTIN_DEVICES.md](BUILTIN_DEVICES.md).
included, with saved controls and automation. Choose instruments in track
headers; insert effects on selected graph wires from Edit. See
[BUILTIN_DEVICES.md](BUILTIN_DEVICES.md).
## Audio source editing
---
Audio clips now open a modal waveform editor with native frame selection,
zoom, source statistics, nondestructive timeline trims, selection export and
save-copy adoption. Local one-step undo supports reverse, polarity inversion,
DC removal, linear/equal-power fades and gain/normalization. Silence boundaries,
## Audio Source Editing
Audio clips now open a modal waveform editor with native frame selection, zoom,
source statistics, nondestructive timeline trims, selection export and save-copy
adoption. Local one-step undo supports reverse, polarity inversion, DC removal,
linear/equal-power fades and gain/normalization. Silence boundaries,
zero-crossing snapping and amplitude attack markers support transactional clip
slicing. Originals are never overwritten; exported media remains available to
project undo/redo. Source editing uses the existing mono downmix and bounded