API evolution plan

[terrelln]

• v1.5.4
  • Deprecate ZSTD_copyCCtx() & ZSTD_copyDCtx() (PR [T124890272] Mark 2 Obsolete Functions(ZSTD_copy*Ctx) Deprecated in Zstd #3196)
  • Deprecate advanced streaming functions (Mark v1.5.x deprecated functions as deprecated #3405)
• v1.5.6
  • Move ZSTD_c_targetCBlockSize CCtx parameter to stable (PR Promote ZSTD_c_targetCBlockSize Parameter to Stable API #3964)
• v1.6.0
  • Move ZSTD_frameHeader and ZSTD_getFrameHeader() to stable (Issue Can ZSTD_getFrameHeader() function be moved to stable API? #2471)
  • Delete ZSTD_copyCCtx() & ZSTD_copyDCtx()
  • Disable Legacy Decoders v0.5 v0.6 and v0.7 by default (can still be enabled on-demand)
  • Move ZSTD_createDDict_byReference() to stable Request: Stabilize ZSTD_createDDict_byReference #4283
  • Move ZSTD_DCtx_loadDictionary_advanced() to stable Adding ZSTD_DCtx_loadDictionary_advanced() to the stable API #3723
  • Remove deprecated ZBUFF_ API

[terrelln]

Adding this issue to track our plans for API evolution. Mainly moving functions to stable, or deprecating & deleting old functions. Marked as release-blocking so we don't forget about it in releases.

#3213, this could be a candidate.

[embg]

There are a few additional deprecations for 1.5.4: #3405