Changelog format

[Buy One]

I think it would be easier to navigate if change descriptions were grouped by categories denoting type of change, e.g.

◙ New features

◙ Bug fixes

◙ Enhancements

◙ Improvements

◙ Regressions

◙ Other (can't think of anything else)

And within each of these categories the change descriptions would be grouped by the usual sub-categories.

A changelog in this format could at least exist in addition to the main one and be published elsewhere, not necessarily on the main website.

[vitalker]

Yeah, nice idea. New features lines could be also just bold, so it is easier to understand what is what. Grouping is a cool idea to distinguish changes fast.

[mpl]

+ automatically post on the forum thread

[vitalker]

Originally Posted by mpl

+ automatically post on the forum thread

Yep, so no one will make a mistake posting something else.

[X-Raym]

A simple symbol prefix front can do it


+ new features
# improvements

* bug fix
~ change





something like that


(what is diff between enhancement/improvements ?)

[Buy One]

Originally Posted by X-Raym

(what is diff between enhancement/improvements ?)

Enhancement could be an extension of an existing feature, like addition of new options, so it covers new use cases

Improvement is akin to a bug fix but for something short of a bug, like addressing edge cases not reported as bugs or behaviors which isn't clear if they were intended but which are prone to impede workflow, or upgrading quality of processes

But yeah, the difference is subtle if any, and it's only a suggestion

[Buy One]

Went ahead and cobbled together a changelog parser dividing it into the suggested categories denoting type of change, in two formats

__________________________________________________ ___________________

Format 1

v6.74 - February 2 2023

BUG FIXES

• Audio Units
  • fixed bridged plug-in parameter unit names and tail time change detection
  
  
• CLAP
  • fix default path list on Windows [t=274405]
  
  
• Envelope point editor
  • fix disappearing shapes after editing tempo/mute envelopes
  
  
• Filtering
  • fix matching of accented characters at start of search filter
  
  
• Group manager
  • fix redundant refreshes
  
  
• IDEs
  • fix inconsistency in column indicators, improve behavior of Ctrl+End (thanks Giorgos Vougioukas)
  • fix loss of X position when scrolling vertically in some instances [t=274248]
  
  
• LV2
  • fix potential crash on macOS UI destruction [t=274448]
  
  
• macOS
  • fix ampersand drawing in tooltips [p=2628462]
  
  
• Media explorer
  • fix action to open file in explorer with certain paths [t=274502]
  • fix button appearance on Linux when using DPI scaling
  
  
• Media items
  • fix potentially-dropped MIDI events at end of item [p=2625908]
  
  
• MIDI list editor
  • fix mousewheel action bindings [t=275224]
  
  
• Mouse modifiers
  • fix potential crash when deleting track via user-assigned action from media item click/razor edit click
  • fix support for binding actions with small ID numbers to click/doubleclick contexts
  
  
• Notation editor
  • fix UI quirks when the piano roll is set to project synchronized time base [t=260878]
  
  
• Preferences
  • fix searching when starting from a preferences page that is added by an extension [t=274326]
  
  
• Razor edits
  • fix adjusting media item length when using timebase beats (position only) [p=2627203]
  • fix envelope cut/paste (6.72 regression)
  • fix some behaviors when pasting razor edit areas to master track [p=2627688]
  • fix action to move razor edit areas up/down/forward/back without contents for master track [p=2630344]
  • fix restoring master track razor edits on project load
  • fix undo for razor edits on master track envelopes [p=2630348]
  
  
• Recording
  • fix $recpass000 wildcard when used in the middle of the filename [t=222312]
  • fix potential extra count-in measure being added with round-to-measure checked [t=274889]
  
  
• Track grouping manager
  • fix Unicode characters in group names on Windows
  
  
• Track manager
  • fix visibility of collapsed child tracks when filtering [t=275048]
  • fix gridline display when hiding columns on Windows [t=274194]
  
  
• Virtual MIDI keyboard
  • fix entering center note via keyboard

NEW FEATURES

• Accessibility
  • add higher-contrast default I-Beam (time selection) cursor
  
  
• Actions
  • add action to play/stop (move edit cursor on stop)
  
  
• Actions window
  • add join/heal, during/while as default synonyms
  
  
• API
  • add midi editor play cursor preview override API for PlayTime
  • add GetInputActivityLevel()
  • add support for audio control signal x2/y2 parameters in FX_GetNamedConfigParm() [t=274236]
  
  
• Audio Units
  • support custom string displays for parameters [p=2456294]
  
  
• CLAP
  • support text_to_value to improve manual editing of envelope point parameters
  
  
• Filtering
  • support matching Unicode Latin Extended-A characters when searching for unaccented characters
  
  
• FX chain window
  • add menu item to cut FX including automation
  
  
• JSFX
  • add mem_multiply_sum(), mem_insert_shuffle(), get_host_placement() [jss=mem_multiply_sum] [jss=get_host_placement]
  • support log/exp-scaled sliders for controls, specify :log or :log=offset after step size [sdk=js/js.php#slider_shaping]
  • support polynomial-scaled fader scaling, default is square, specify :sqr for x^2 or :sqr=3 after step size
  • support up to 256 sliders per FX, longer parameter names, very long lines [t=272052]
  • support EEL2 preprocessing [sdk=js/preproc.php]
  
  
• Media explorer
  • add action to calculate peak volume for all media (will skip files that have already been calculated)
  • support editing metadata via right-click menu for .mid files [t=274771]
  
  
• Mixer
  • add Cut menu items to FX context menu
  
  
• Preferences
  • add setting in Preferences/Seeking to seek playback when clicking on media items
  
  
• Razor edits
  • add action to enclose media items in separate razor edit areas for each selected media item, rather than a single razor edit enclosing all selected media items
  • add mouse modifiers to move razor edits without contents horizontally/vertically/on one axis only
  • add option to move edit cursor on razor edit change
  • support cut/copy/paste on project play rate envelope [p=2629413]
  
  
• ReaScript
  • add EEL2 mem_multiply_sum(), mem_insert_shuffle() [jss=mem_multiply_sum]
  • support EEL2 preprocessing [sdk=js/preproc.php]
  
  
• Render
  • support $takemarker(name) and $takemarker(name)[separator] wildcards [t=275011]
  • support wildcard case conversion for Unicode Latin Supplemental and Latin Extended-A accented characters [t=274162]
  
  
• Timestretch
  • add new ReaReaRea mode that uses randomized overlapped windows and project resampling mode [t=266425]
  
  
• Video
  • add get_host_placement()
  • support EEL2 preprocessing [sdk=js/preproc.php]
  
  
• VST
  • add compatibility setting to pass channel silence flags to VST3 plug-ins [t=274038]

IMPROVEMENTS

• Accessibility
  • improve descriptions of ReaEQ/ReaPitch/ReaDelay enabled buttons
  • improve ordering of controls in GetUserInputs() API
  • improve keyboard navigation/screen reader behavior for sends in track routing menu
  • improve screen reader behavior for hardware output list in track routing menu
  
  
• Actions
  • respect group-disable setting in action to duplicate items [t=272939]
  • improve description of action to glue items to match menu description [t=275171]
  
  
• API
  • avoid performance issues due to old SWS versions flooding with calls to RefreshToolbar()
  
  
• Dynamic split
  • respect track edit grouping when splitting grouped items
  
  
• FX chain window
  • improve list focus behavior when renaming instance
  
  
• IDEs
  • improve international keyboard support
  • improve home-key behavior (thanks Giorgos Vougioukas)
  • improve autocomplete behavior when using EEL2 namespaces [t=274334]
  • improve behavior of panes and undo/redo [t=274972]
  
  
• JSFX
  • improve gfx_getchar() to return discrete unicode values when available [jss=gfx_getchar]
  • extend slider_automate() to allow for touch recording [jss=slider_automate]
  • improve manual editing of envelope points for parameters that have named values
  
  
• Localization
  • improve support for various loudness-related displays
  
  
• LV2
  • improve manual editing of envelope points for parameters that are named enums
  
  
• macOS
  • improve compatibility of 'Open source file' mouse modifier dragging [p=2636376]
  
  
• Media explorer
  • improve handling of RfxChain and FX preset files [t=265842]
  
  
• Media item properties
  • improve start-in-source display in certain stretch marker scenarios [t=274036]
  
  
• Menu/toolbar editor
  • increase width of listview columns [p=2636334]
  
  
• Notation editor
  • improve layout when resizing, make limits affected by size [p=2032295]
  
  
• Paste
  • improve behavior when pasting .RfxChain/.fxb/.vstpreset files into track or item context
  
  
• Razor edits
  • improve behavior when "overlap and crossfade media when finalizing razor edits" enabled [p=2623951]
  
  
• ReaEQ
  • correct label for band bandwidth parameter
  
  
• ReaScript
  • extend gfx.getchar() to return discrete unicode values when available
  
  
• Recording
  • improve behavior with MIDI replace recording mode
  
  
• Render
  • improve tab order around output format configuration
  
  
• Routing matrix
  • improve record input selection indication on multichannel record inputs
  
  
• Timestretch
  • improve ordering of modes menu
  
  
• Virtual MIDI keyboard
  • improve keyboard navigation
  
  
• VST
  • improve multiprocessing performance with UADx plug-ins
  
  
• Windows
  • improve ASIO channel defaults, remember channel configuration per device

ENHANCEMENTS

• Actions window
  • update toggle states in response to actions [t=247947]
  
  
• JSFX
  • update Super8, channel mixer to use preprocessor
  
  
• Media explorer
  • do not allow shortcuts panel to be resized to exactly zero [t=215631]
  
  
• Razor edits
  • prevent moving razor edit areas to tempo envelope when using mouse modifier to move razor edit area ignoring envelope type [p=2627676]
  
  
• Render
  • update dialog when changing render region selection [t=274119]
  
  
• Tooltips
  • prevent tooltips from occuring when window is inactive [t=233380]
  
  
• Track grouping
  • prevent grouping razor edits on master track [p=2627694]
  
  
• Windows
  • do not allow setting default ASCII keybindings to global, require manual remap first [t=275243]

REGRESSIONS

• Razor edits
  • fix envelope cut/paste (6.72 regression)

OTHER

• Accessibility
  • set description for FX active (bypass) checkbox
  
  
• Actions window
  • when sorting by command ID, sort by identifier string [t=275016]
  
  
• API
  • SetMouseModifier(ctx,-1,-1) will reset all modifiers to default for that context; SetMouseModifier(-1,-1,-1) will reset all modifiers to default for all contexts
  
  
• Audio Units
  • respond to kAudioUnitProperty_ParameterList to update parameter list at plug-in request
  
  
• Defaults
  • change snap-to-nearby-media-items to by default only snap to items on the same track as the current item
  
  
• Freeze
  • when freezing, preserve MIDI-only receives [t=275106]
  • when freezing to mono/stereo, preserve audio sidechain receives [t=275106]
  
  
• Grouping
  • reset automatic track grouping to default when creating new project
  
  
• IDEs
  • smarter selection of suggested items on initial mousemove [p=2629534]
  • suggest list does not respond to mouse movement when inactive [t=275197]
  
  
• JSFX
  • if 'tags: instrument' is present in header, treat as an instrument [sdk=js/js.php#tags]
  • per-sample and per-automated-block performance optimizations
  • throttle calls to gfx_showmenu() to prevent accidental annoyance [t=272767]
  
  
• LV2
  • do not unload plug-in bundles on macOS or Linux [t=274448]
  
  
• Media items
  • always account for media item label drawn above item when calculating vertical offset for overlapping items [t=272679]
  
  
• MIDI
  • when trimming items due to split, chase CC/pitch/etc
  
  
• Project load
  • always show details of unrecognized project tokens
  
  
• Razor edits
  • handle master track in action to move nearest razor edit edge to cursor [p=2630311]
  • only copy fade-in/fade-out if the start/end of the media item is included in the razor edit
  
  
• Render
  • display render statistics as list view in render progress window
  • swap order of close and back buttons after successful render
  
  
• Routing window
  • display track parent name in routing dialog title
  
  
• Routing matrix/track wiring
  • show if signal is present on audio/MIDI inputs
  
  
• Track grouping
  • items on edit-grouped tracks follow mouse-click take selection changes [t=274295]
  
  
• Undo
  • consolidate undo points when inserting multiple FX via action [t=274365]
  
  
• Virtual MIDI keyboard
  • remove space from note names
  
  
• VST
  • detect VST2 shell plug-in synth status using same logic as non-shell plug-ins
  • re-map automation by parameter ID if parameters change due to restartComponent

[Buy One]

Format 2

v6.74 - February 2 2023

API

• New features
  • add midi editor play cursor preview override API for PlayTime
  • add GetInputActivityLevel()
  • add support for audio control signal x2/y2 parameters in FX_GetNamedConfigParm() [t=274236]
• Improvements
  • avoid performance issues due to old SWS versions flooding with calls to RefreshToolbar()
• Other
  • SetMouseModifier(ctx,-1,-1) will reset all modifiers to default for that context; SetMouseModifier(-1,-1,-1) will reset all modifiers to default for all contexts

Accessibility

• New features
  • add higher-contrast default I-Beam (time selection) cursor
• Improvements
  • improve descriptions of ReaEQ/ReaPitch/ReaDelay enabled buttons
  • improve ordering of controls in GetUserInputs() API
  • improve keyboard navigation/screen reader behavior for sends in track routing menu
  • improve screen reader behavior for hardware output list in track routing menu
• Other
  • set description for FX active (bypass) checkbox

Actions

• New features
  • add action to play/stop (move edit cursor on stop)
• Improvements
  • respect group-disable setting in action to duplicate items [t=272939]
  • improve description of action to glue items to match menu description [t=275171]

Actions window

• New features
  • add join/heal, during/while as default synonyms
• Enhancements
  • update toggle states in response to actions [t=247947]
• Other
  • when sorting by command ID, sort by identifier string [t=275016]

Audio Units

• Bug fixes
  • fixed bridged plug-in parameter unit names and tail time change detection
• New features
  • support custom string displays for parameters [p=2456294]
• Other
  • respond to kAudioUnitProperty_ParameterList to update parameter list at plug-in request

CLAP

• Bug fixes
  • fix default path list on Windows [t=274405]
• New features
  • support text_to_value to improve manual editing of envelope point parameters

Defaults

• Other
  • change snap-to-nearby-media-items to by default only snap to items on the same track as the current item

Dynamic split

• Improvements
  • respect track edit grouping when splitting grouped items

Envelope point editor

• Bug fixes
  • fix disappearing shapes after editing tempo/mute envelopes

FX chain window

• New features
  • add menu item to cut FX including automation
• Improvements
  • improve list focus behavior when renaming instance

Filtering

• Bug fixes
  • fix matching of accented characters at start of search filter
• New features
  • support matching Unicode Latin Extended-A characters when searching for unaccented characters

Freeze

• Other
  • when freezing, preserve MIDI-only receives [t=275106]
  • when freezing to mono/stereo, preserve audio sidechain receives [t=275106]

Group manager

• Bug fixes
  • fix redundant refreshes

Grouping

• Other
  • reset automatic track grouping to default when creating new project

IDEs

• Bug fixes
  • fix inconsistency in column indicators, improve behavior of Ctrl+End (thanks Giorgos Vougioukas)
  • fix loss of X position when scrolling vertically in some instances [t=274248]
• Improvements
  • improve international keyboard support
  • improve home-key behavior (thanks Giorgos Vougioukas)
  • improve autocomplete behavior when using EEL2 namespaces [t=274334]
  • improve behavior of panes and undo/redo [t=274972]
• Other
  • smarter selection of suggested items on initial mousemove [p=2629534]
  • suggest list does not respond to mouse movement when inactive [t=275197]

JSFX

• New features
  • add mem_multiply_sum(), mem_insert_shuffle(), get_host_placement() [jss=mem_multiply_sum] [jss=get_host_placement]
  • support log/exp-scaled sliders for controls, specify :log or :log=offset after step size [sdk=js/js.php#slider_shaping]
  • support polynomial-scaled fader scaling, default is square, specify :sqr for x^2 or :sqr=3 after step size
  • support up to 256 sliders per FX, longer parameter names, very long lines [t=272052]
  • support EEL2 preprocessing [sdk=js/preproc.php]
• Improvements
  • improve gfx_getchar() to return discrete unicode values when available [jss=gfx_getchar]
  • extend slider_automate() to allow for touch recording [jss=slider_automate]
  • improve manual editing of envelope points for parameters that have named values
• Enhancements
  • update Super8, channel mixer to use preprocessor
• Other
  • if 'tags: instrument' is present in header, treat as an instrument [sdk=js/js.php#tags]
  • per-sample and per-automated-block performance optimizations
  • throttle calls to gfx_showmenu() to prevent accidental annoyance [t=272767]

LV2

• Bug fixes
  • fix potential crash on macOS UI destruction [t=274448]
• Improvements
  • improve manual editing of envelope points for parameters that are named enums
• Other
  • do not unload plug-in bundles on macOS or Linux [t=274448]

Localization

• Improvements
  • improve support for various loudness-related displays

MIDI

• Other
  • when trimming items due to split, chase CC/pitch/etc

MIDI list editor

• Bug fixes
  • fix mousewheel action bindings [t=275224]

Media explorer

• Bug fixes
  • fix action to open file in explorer with certain paths [t=274502]
  • fix button appearance on Linux when using DPI scaling
• New features
  • add action to calculate peak volume for all media (will skip files that have already been calculated)
  • support editing metadata via right-click menu for .mid files [t=274771]
• Improvements
  • improve handling of RfxChain and FX preset files [t=265842]
• Enhancements
  • do not allow shortcuts panel to be resized to exactly zero [t=215631]

Media item properties

• Improvements
  • improve start-in-source display in certain stretch marker scenarios [t=274036]

Media items

• Bug fixes
  • fix potentially-dropped MIDI events at end of item [p=2625908]
• Other
  • always account for media item label drawn above item when calculating vertical offset for overlapping items [t=272679]

Menu/toolbar editor

• Improvements
  • increase width of listview columns [p=2636334]

Mixer

• New features
  • add Cut menu items to FX context menu

Mouse modifiers

• Bug fixes
  • fix potential crash when deleting track via user-assigned action from media item click/razor edit click
  • fix support for binding actions with small ID numbers to click/doubleclick contexts

Notation editor

• Bug fixes
  • fix UI quirks when the piano roll is set to project synchronized time base [t=260878]
• Improvements
  • improve layout when resizing, make limits affected by size [p=2032295]

Paste

• Improvements
  • improve behavior when pasting .RfxChain/.fxb/.vstpreset files into track or item context

Preferences

• Bug fixes
  • fix searching when starting from a preferences page that is added by an extension [t=274326]
• New features
  • add setting in Preferences/Seeking to seek playback when clicking on media items

Project load

• Other
  • always show details of unrecognized project tokens

Razor edits

• Bug fixes
  • fix adjusting media item length when using timebase beats (position only) [p=2627203]
  • fix some behaviors when pasting razor edit areas to master track [p=2627688]
  • fix action to move razor edit areas up/down/forward/back without contents for master track [p=2630344]
  • fix restoring master track razor edits on project load
  • fix undo for razor edits on master track envelopes [p=2630348]
• New features
  • add action to enclose media items in separate razor edit areas for each selected media item, rather than a single razor edit enclosing all selected media items
  • add mouse modifiers to move razor edits without contents horizontally/vertically/on one axis only
  • add option to move edit cursor on razor edit change
  • support cut/copy/paste on project play rate envelope [p=2629413]
• Improvements
  • improve behavior when "overlap and crossfade media when finalizing razor edits" enabled [p=2623951]
• Enhancements
  • prevent moving razor edit areas to tempo envelope when using mouse modifier to move razor edit area ignoring envelope type [p=2627676]
• Regressions
  • fix envelope cut/paste (6.72 regression)
• Other
  • handle master track in action to move nearest razor edit edge to cursor [p=2630311]
  • only copy fade-in/fade-out if the start/end of the media item is included in the razor edit

ReaEQ

• Improvements
  • correct label for band bandwidth parameter

ReaScript

• New features
  • add EEL2 mem_multiply_sum(), mem_insert_shuffle() [jss=mem_multiply_sum]
  • support EEL2 preprocessing [sdk=js/preproc.php]
• Improvements
  • extend gfx.getchar() to return discrete unicode values when available

Recording

• Bug fixes
  • fix $recpass000 wildcard when used in the middle of the filename [t=222312]
  • fix potential extra count-in measure being added with round-to-measure checked [t=274889]
• Improvements
  • improve behavior with MIDI replace recording mode

Render

• New features
  • support $takemarker(name) and $takemarker(name)[separator] wildcards [t=275011]
  • support wildcard case conversion for Unicode Latin Supplemental and Latin Extended-A accented characters [t=274162]
• Improvements
  • improve tab order around output format configuration
• Enhancements
  • update dialog when changing render region selection [t=274119]
• Other
  • display render statistics as list view in render progress window
  • swap order of close and back buttons after successful render

Routing matrix

• Improvements
  • improve record input selection indication on multichannel record inputs

Routing matrix/track wiring

• Other
  • show if signal is present on audio/MIDI inputs

Routing window

• Other
  • display track parent name in routing dialog title

Timestretch

• New features
  • add new ReaReaRea mode that uses randomized overlapped windows and project resampling mode [t=266425]
• Improvements
  • improve ordering of modes menu

Tooltips

• Enhancements
  • prevent tooltips from occuring when window is inactive [t=233380]

Track grouping

• Enhancements
  • prevent grouping razor edits on master track [p=2627694]
• Other
  • items on edit-grouped tracks follow mouse-click take selection changes [t=274295]

Track grouping manager

• Bug fixes
  • fix Unicode characters in group names on Windows

Track manager

• Bug fixes
  • fix visibility of collapsed child tracks when filtering [t=275048]
  • fix gridline display when hiding columns on Windows [t=274194]

Undo

• Other
  • consolidate undo points when inserting multiple FX via action [t=274365]

VST

• New features
  • add compatibility setting to pass channel silence flags to VST3 plug-ins [t=274038]
• Improvements
  • improve multiprocessing performance with UADx plug-ins
• Other
  • detect VST2 shell plug-in synth status using same logic as non-shell plug-ins
  • re-map automation by parameter ID if parameters change due to restartComponent

Video

• New features
  • add get_host_placement()
  • support EEL2 preprocessing [sdk=js/preproc.php]

Virtual MIDI keyboard

• Bug fixes
  • fix entering center note via keyboard
• Improvements
  • improve keyboard navigation
• Other
  • remove space from note names

Windows

• Improvements
  • improve ASIO channel defaults, remember channel configuration per device
• Enhancements
  • do not allow setting default ASCII keybindings to global, require manual remap first [t=275243]

macOS

• Bug fixes
  • fix ampersand drawing in tooltips [p=2628462]
• Improvements
  • improve compatibility of 'Open source file' mouse modifier dragging [p=2636376]