# Version 2.0.0 2023-??-??

* API break: the headers `c/libmatroska.h` & `c/libmatroska_t.h` were
  removed. Their remaining content was moved to `KaxTypes.h`.
* API break: the `KaxSeedID` class can only be used to write EBML IDs
  that are exactly four bytes long (previously: at most four bytes).
* Updated the semantics to the latest specifications, deprecating the
  following elements by preventing code to write them:
  `KaxTrackMaxCache`, `KaxTrackMinCache`.
* libebml 2.0.0 or newer is now required.
* Bumped the library's soname to 8 due to several API & ABI breaking
  changes.
* Enabled building shared libraries via the usual CMake definition
  `BUILD_SHARES_LIBS` (default: off).

# Version 1.7.0 2022-09-30

* A C++14 compliant C++ compiler is now required.
* libEBML v1.4.3 is now required.
* Remove Coremake project files
* Add `KaxInternalBlock::GetRelativeTimestamp()` to access unscaled
  block timestamps.
* Fixed problems with the generated `pkg-config` files if any of the
  installation paths are absolute.
* Added several enums in `namespace libmatroska` for the various
  elements that are constrained to a set of options:
  `MatroskaTrackType`, `MatroskaTrackEncodingCompAlgo`,
  `MatroskaChapterTranslateCodec`, `MatroskaTrackTranslateCodec`,
  `MatroskaVideoFlagInterlaced`, `MatroskaVideoFieldOrder`,
  `MatroskaVideoStereoMode`, `MatroskaVideoAlphaMode`,
  `MatroskaVideoOldStereoMode`, `MatroskaVideoDisplayUnit`,
  `MatroskaVideoAspectRatioType`, `MatroskaVideoMatrixCoefficients`,
  `MatroskaColourChromaSitingHorz`, `MatroskaColourChromaSitingVert`,
  `MatroskaVideoRange`, `MatroskaVideoTransferCharacteristics`,
  `MatroskaVideoPrimaries`, `MatroskaVideoProjectionType`,
  `MatroskaAudioEmphasis`, `MatroskaTrackPlaneType`,
  `MatroskaContentEncodingScope`, `MatroskaContentEncodingType`,
  `MatroskaContentEncodingAlgo`, `MatroskaAESSettingsCipherMode`,
  `MatroskaContentSignatureAlgo`, `MatroskaContentSigHashAlgo`,
  `MatroskaChapterSkipType`, `MatroskaChapterProcessTime` and
  `MatroskaTargetTypeValue`.
* Updated the semantics to the latest specifications, deprecating the
  following elements by preventing code to write them:
  `KaxClusterSilentTracks`, `KaxClusterSilentTrackNumber`,
  `KaxSlices`, `KaxReferenceFrame`, `KaxReferenceOffset`,
  `KaxReferenceTimeCode`, `KaxTrackTimecodeScale`,
  `KaxCodecDecodeAll`, `KaxVideoAspectRatio`, `KaxTrickTrackUID`,
  `KaxTrickTrackSegmentUID`, `KaxTrickTrackFlag`,
  `KaxTrickMasterTrackUID`, `KaxTrickMasterTrackSegmentUID`,
  `KaxContentSignature`, `KaxContentSigKeyID`, `KaxContentSigAlgo` and
  `KaxContentSigHashAlgo`.
* Updated the semantics to the latest specifications, making the
  following elements mandatory (but having default values):
  `KaxCodecDelay`, `KaxVideoPixelCropBottom`, `KaxVideoPixelCropTop`,
  `KaxVideoPixelCropLeft`, `KaxVideoPixelCropRight`,
  `KaxVideoBitsPerChannel`, `KaxCueCodecState`,
  `KaxTagTargetTypeValue`, `KaxTrackLanguage`, `KaxVideoStereoMode`,
  `KaxVideoAlphaMode`, `KaxEditionFlagOrdered`,
  `KaxVideoChromaSitHorz`, `KaxVideoChromaSitVert`,
  `KaxVideoColourRange`, `KaxVideoColourMatrix`,
  `KaxVideoColourTransferCharacter`, `KaxVideoColourPrimaries` and
  `KaxVideoDisplayUnit`.
* Updated the semantics to the latest specifications, removing the
  default values from the following elements: `KaxCueBlockNumber`,
  `KaxFlagHearingImpaired`, `KaxFlagVisualImpaired`,
  `KaxFlagTextDescriptions`, and `KaxFlagOriginal`.
* Updated the semantics to the latest specifications, adding the
  following new elements: `TagDefaultBogus` (as a placeholder for
  accidentally used but wrong EBML ID 0x44b4), `KaxEmphasis`,
  `KaxChapterSkipType`, `KaxEditionDisplay`, `KaxEditionString` and
  `KaxEditionLanguageIETF`.

# Version 1.6.3 2021-02-18

* libEBML v1.4.2 is now required.
* Added classes for new track header elements:
  `KaxFlagHearingImpaired`, `KaxFlagVisualImpaired`,
  `KaxFlagTextDescriptions`, `KaxFlagOriginal` and
  `KaxFlagCommentary`.

# Version 1.6.2 2020-08-02

* In release 1.6.1 the version number in `CMakeLists.txt` wasn't
  updated, affecting the installed `cmake` and `pkg-config` files. The
  version number has been bumped to 1.6.2 in all relevant files now.

# Version 1.6.1 2020-08-02

* `KaxBlockAddIDValue` class: this class is no longer marked as
  "mandatory" in order to coincide with the latest specification.

# Version 1.6.0 2020-06-27

* libEBML v1.4.0 is now required.
* Due to breaking ABI the soname version has been bumped to 7.0.0.
* Default symbol visibility is now "hidden", reducing binary size.
* Converted some things pointed out by `cppcheck` & `clang-tidy` to
  C++11.
* Fixed a lot of issues pointed out by `clang-tidy`.
* A C++11 compliant compiler is now required. Several of its features
  are now used in the source.
* `KaxCueData` class: added `PositionSet` overrides taking
  `KaxSimpleBlock` arguments.
* `KaxSeekHead` class: the `IndexThis` function now returns a pointer
  to the newly allocated `KaxSeek` instance.
* `KaxBlockData` class: the `SetReferencedTimecode` function is now
  public.
* Fixed classes for updates in the current specification:
  `KaxTrackTimecodeScale` (can be written again), `TimeSlice`,
  `SliceLaceNumber`, `TrackAttachmentLink` (these cannot be written
  anymore), `KaxContentEncAlgo` (it's mandatory),
  `KaxChapLanguageIETF` (can occur multiple times),
  `KaxFileUsedStartTime`, `KaxFileUsedEndTime` (DivX-related elements,
  cannot be written anymore)
* Added classes for new elements from the current specification:
  `KaxBlockAdditionMapping`, `KaxBlockAddIDValue`,
  `KaxBlockAddIDName`, `KaxBlockAddIDType`, `KaxBlockAddIDExtraData`,
  `KaxContentEncAESSettings`, `KaxContentEncAESSettings`.
* The `MATROSKA_VERSION` pre-processor definition has been
  removed. You used to be able toe restrict compiling with only those
  classes for elements contained in Matroska v1, but that hasn't
  worked since 2010, so… yeah.
* Build system: more fixes for building libMatroska as a DLL on
  Windows wrt. symbol visibility.

# Version 1.5.2 2019-05-27

* Build system: fixed symbol visibility issue causing linker failures
  since 1.5.1.

# Version 1.5.1 2019-05-25

* Build system: libEBML 1.3.8 is now required.
* Build system: various fixes to the cmake rules regarding visibility,
  naming and building DLLs on Windows.
* `KaxBlock`: fixed a potential access to invalid memory due to
  invalid lace sizes read from invalid data.
* `KaxBlock`: fixed a potential null pointer dereference triggerable
  by reading invalid data.

# Version 1.5.0 2019-03-12

* Build system: libEBML 1.3.7 is now required.
* Build system: fixed a problem that prevented libMatroska from being
  embedded in other builds.

# Version 1.4.9 2018-04-20

* Converted the build system from `autoconf`/`automake` to
  `cmake`. Patches by Github user "evpobr" with fixes by myself.
* Added a code of conduct to the project.

# Version 1.4.8 2017-09-25

* `KaxBlockGroup`, `KaxSimpleBlock`: fixed writing the block header if
  the track number is 128.

# Version 1.4.7 2017-03-10

* Released v1.4.7 with the single change of setting the version number
  in the `KaxCodeVersion` variable correctly.

# Version 1.4.6 2017-03-10

* `KaxSemantic`: add new elements dealing with 360°/VR content and for
  language descriptors based on IETF BPC 47.

# Version 1.4.5 2016-07-02

* `KaxSemantic`: add new colour-related elements.
* `KaxSemantic`: add the new FieldOrder element.
* `KaxVersion.cpp`: in order to enable deterministic builds the
  `KaxCodeDate` variable has been set to `"Unknown"` instead of the
  date and time of compilation. Patch by Ed Schouten <ed@nuxi.nl>.

# Version 1.4.4 2015-10-20

* `KaxInternalBlock::ReadData()`: Fixed an invalid memory access. When
  reading a block group or a simple block that uses EBML lacing the
  frame sizes indicated in the lacing weren't checked against the
  available number of bytes. If the indicated frame size was bigger
  than the whole block's size the parser would read beyond the end of
  the buffer resulting in a heap information leak.

# Version 1.4.3 2015-10-17

* all: a couple of optimizations in the main library and a memory leak
  fix in the tests
* build system: fix linking against libEBML

# Version 1.4.2 2015-01-04

* build system: switched the build system from hand-crafted
  `Makefiles` to an `autoconf`/`automake`-based system. A `pkg-config`
  file will be installed as well; its name is `libmatroska`. Based on
  a similar patch for libEBML by Jan Engelhardt <jengelh@inai.de>.
* `KaxBlock::ReadData()`: fixed several instances of unchecked memory
  access leading to invalid memory access/segmentation faults with
  invalid or broken data inside block groups/simple blocks.
* `KaxBlock::ReadInternalHead()`: fixed a off-by-one buffer overflow
  if with EBML lacing and exactly one frame in the lace.

# Version 1.4.1 2013-09-17

* Added new elements/classes `DiscardPadding`, `CodecDelay` and
  `SeekPreRoll`
* The licensing information has been cleared up/unified.
* The Makefile now contain options for specifying the destination base
  directory during installation (`DESTDIR`) and for specifying which
  library types to build (`link`).
* The libraries are built without the `-ansi` and `-fno-gnu-keywords`
  flags on Linux
* Code cleanup

# Version 1.4.0 2013-03-19

* Note that this release is not binary compatible to 1.3.0 due to the
  dependancy on libEBML 1.3.0 which is not binary compatible to its
  predecessor.
* Added new elements `CueDuration`, `CueRelativePosition`,
  `ChapterStringUID`, `VideoAlphaMode` and
  `DefaultDecodedFieldDuration`
* Removed the Debian build files from our package.

# Version 1.3.0 2011-09-23

* initialize all data members
* The `KaxCodeVersion` variable now resides in the library instead of
  being declared static in the header file.
* make `KaxChapterSegmentEditionUID` an unsigned integer to match the
  `KaxChapterEditionUID` it's supposed to target
* This release is not binary compatible to 1.2.x.

# Version 1.2.0 2011-06-26

* skip data from `KaxBlockVirtual` as it should not be used
* use semantic generated from the specs so there is no more possible
  mismatch
* trunk/libmatroska/test/test9.cpp
* also remove no longer needed tests for old/outdated/previous tag
  system

# Version 1.1.0 2011-01-30

* give access to the `SetParent` to `KaxSimpleBlock` as well
* change the placement of a `MATROSKA_DLL_API` so that it actually
  works
* remove all references to the old/outdated/previous tag system
* add the possibility for a `DataBuffer` class to use its own internal
  memory
* `KaxCues::AddBlockGroup()` was removed as it's broken beyond repair
* add `KaxTrackOperation` and related elements for combined stereo/3D
  tracks or joined virtual tracks
* fix a memory leak in `KaxReferenceBlock` when an internal
  `KaxBlockBlob` was created
* Increased library `.so` name due to binary incompatible changes in
  libebml

# Version 1.0.0 2010-06-04

* rename the library `.so` name as it's backward incompatible

# Version 0.9.0 2010-04-30

* fix a memory freeing issue in `KaxBlock`
* use the macros from the new libebml 0.8.0 to simplify the element
  definitions and avoid possible typo bugs
* fix some building issues on Linux and MinGW
* add `matroska_init()` and `matroska_done()` functions, necessary
  when used with libebml v2
* use the new libebml iterators of `EbmlMaster` where possible