ChangeLog

2026.217: v3.5.4
  - Trace list packing optimization and improvement:
    * Reuse the record packer and its buffers across trace-list segments.
    * Skip speculative allocation when not enough samples for a v3 record.
    * Resume the trace-list pack scan where it left off.
    * Reduce system time calls.
  - Resolve year and month in ms_gmtime64_r() with closed-form arithmetic.
  - Return MS_ENDOFFILE instead of MS_NOTSEED when selections skip every record
    in a stream.

2026.211: v3.5.3
  - Optimize segment searches by tracking recently-active segments per trace ID,
    a significant improvement for creating trace lists from near time ordered
    input data.
  - End the segment search early once a segment starts beyond the record
    end plus tolerance, as no later segment can match in the sorted list.
  - Search backward from the last segment for zero sample rate records,
    which can only match a following segment, avoiding a full list scan.
  - Avoid FP division in sample rate comparisons: short-circuit identical
    rates and use a multiplicative form of MS_ISRATETOLERABLE().

2026.208: v3.5.2
  - Add MSF_RECORDLIST_NOEXTRAS to skip copying extra headers into
    MS3RecordList entries when building a record list.
  - Reject a blockette offset within the fixed header as fatal.
  - Break ms_parse_raw2() blockette walk on unknown length, treat a
    self-referential next offset as fatal, add Blockette 405 length.
  - Reject sample count that would overflow size_t when converting to
    doubles in mstl3_convertsamples(), avoiding undersized malloc on 32-bit.
  - Reject size_t overflow in libmseed_memory_prealloc() growth loop,
    avoiding an infinite hang on huge allocation requests.
  - Free duplicated MS3Record when record-list entry allocation fails.
  - Reject out-of-range leap-second epochs in ms_readleapsecondfile().

  2026.206: v3.5.1
  - Set MS3RecordPtr.msr->record to NULL when the raw record is not available,
    instead of leaving it dangling to a source buffer that may be freed or
    reused.
  - Accept a /FDSN/Calibration/Sequence/Type of ABORT when packing miniSEED v2,
    so a Blockette 395 read from a v2 record can be written back out.
  - Reject a /FDSN/Calibration/Sequence with a missing or non-string /EndTime
    when a Blockette 395 is the only representation, instead of silently
    writing no blockette.
  - Add msr3_duplicate_extra() to allow independent control of extra header
    duplication, with msr3_duplicate() now a thin wrapper that preserves its
    original always-copy behavior.
  - Export ms3_msfp_init(), msr3_duplicate_extra(), ms_rlog_pop() and
    libmseed_memory_prealloc() in libmseed.def, so they are available from
    Windows DLL builds as they already are elsewhere.

2026.205: v3.5.0
  Important fixes and changes:
  - Fix v2 miniSEED time encoding to use the carried second when 100 µs rounding
    rolls over, so continuation records and BTIME-encoded blockette times are no
    longer written one second early.
  - Fix cumulative start-time rounding drift when repeatedly packing partial
    trace segments by projecting new start times using the apparent rate
    implied by segment start and end times.
  - Add Blockette 1001 to v2 records whenever the sample period is not an
    integer number of 100 µs units.
  - Write Blockette 100 sample rate as Hz via msr3_sampratehz() instead of raw
    msr->samprate, so period-notation rates are not stored as negative Hz.
  - Fix msr3_repack_mseed2() fit check to use the original record length
    instead of the destination buffer length, avoiding silent truncation of
    encoded data when the destination buffer is larger than the record.
  - Fix out-of-bounds write in msr3_repack_mseed2() by checking the destination
    buffer size before zero-filling padding ahead of Steim-encoded data.
  - Fix invalid free of a caller-owned extra-headers buffer when packing
    multiple trace list segments with mstl3_pack_next().
  - Fix mstl3_pack_next() silently dropping the sample remainder of a
    MSF_MAINTAINMSTL segment that could not fill a full record; each
    segment is now packed completely (MSF_FLUSHDATA implied) the first
    time it is visited, since the trace list is not trimmed and a partial
    record cannot be completed on a later call.
  - A field was added to the LMIO struct, ABI-compatible, documented as internal.

  Minor fixes, hardening, cleanup:

  Reading and I/O:
  - Fix possible infinite loop in msio_fread() by clearing the curl pause flag
    before unpausing, since curl_easy_pause() may synchronously invoke the
    write callback and re-pause before the flag is cleared.
  - Fix msio_fopen() to reset CURLOPT_HEADERFUNCTION along with CURLOPT_HEADERDATA
    after reading response headers, so a later header callback invoked for HTTP
    trailers cannot abort the transfer or dereference a stale pointer.
  - Add connection and stall timeouts for URL transfers, configurable with
    ms3_url_timeout() or the LIBMSEED_URL_TIMEOUT environment variable, so a
    server that stops responding mid-transfer no longer hangs indefinitely.
  - Detect failed URL transfers instead of reporting them as end-of-file.
  - Fail when an HTTP server ignores a requested byte Range and returns the
    full body, instead of silently relabeling the start offset and returning
    records outside the requested range.
  - Enforce the end offset of a byte range on local file reads so a record
    extending past the end offset is reported as truncated (MS_ENDOFFILE),
    matching the existing behavior for URL byte-range reads.
  - Reject byte range values above INT64_MAX in path name suffixes and HTTP
    Content-Range headers, and reject a negative start or end offset when
    opening a stream, instead of silently wrapping to a negative offset.
  - Reject a path or URL longer than the internal buffer in ms3_readmsr()
    instead of silently truncating it and opening the wrong resource.

  Record parsing and decoding:
  - Fix out-of-bounds reads on truncated Blockette 2000 in ms_parse_raw2().
  - Fix one-byte stack overflow when decoding the Blockette 500 timing
    exception type and clock status, and serialize them by bounded length
    so full-width values are neither truncated nor concatenated.
  - Fix msr3_resize_buffer() and msr3_unpack_data() to use a temporary pointer
    for realloc(), avoiding a leak of the original data buffer and a NULL
    datasamples pointer left with a non-zero sample count on allocation
    failure.
  - Fix msr3_data_bounds() Steim trailing-empty-frame scan to inspect the
    payload's actual final frame instead of bytes offset by the header size.
  - Fix Blockette 500 microsecond precision from being added to an unset or
    invalid decoded time, which fabricated a timing-exception time. Also stop
    invalid blockette times from being written to extra headers as the
    literal string "ERROR".
  - Fix GEOSCOPE 24-bit decoding to assemble the 3-byte sample using the
    record's actual byte order instead of a host-order union read-back, which
    corrupted amplitudes for little-endian-declared GEOSCOPE24 payloads.
    This is only for completeness, such data may not exist.
  - Reject v2 records with an unset (year 0) start time instead of applying
    time corrections to the sentinel and producing a fabricated ~1901 time.
  - Reject miniSEED v3 records with a non-finite fixed-header sample rate,
    and ignore an invalid Blockette 100 sample rate instead of applying it.
  - Fix leak of the extra-headers JSON parse state on error returns from the
    v2 blockette loop in msr3_unpack_mseed2(), and avoid orphaning the first
    allocation when a record contains two Blockette 1001s.

  Trace lists:
  - Fix NULL dereference in mstl3_free() when the trace list pointer is NULL.
  - Reject a decoded sample buffer size that overflows size_t in
    mstl3_unpack_recordlist(), avoiding a heap overflow on 32-bit hosts
    when a segment holds close to 4 GiB of samples.
  - Fix mstl3_addmsr() to honor a sample rate tolerance callback returning 0.0
    as an exact match instead of falling back to the default tolerance, and warn
    and use the default when a time or sample rate tolerance callback returns a
    negative value.
  - Update MS3TraceID.earliest/latest after packing consumes or removes trace
    segment data so they no longer report stale extents.
  - Reject unrecognized target sample types in mstl3_convertsamples() instead of
    returning success with the data left unconverted.
  - Fix mstl3_convertsamples() silently converting NaN and out-of-range float
    and double samples to garbage integer values, and leaving the samples
    partially converted when a value is rejected.

  Packing and writing:
  - Fix mstl3_pack_next() to re-sync its segment data pointer before packing,
    avoiding a stale pointer when mstl3_addmsr() reallocates the buffer
    between calls, and reject a segment prepend during active packing.
  - Reject a non-positive record length in msr3_repack_mseed2(), avoiding a
    large out-of-bounds write when repacking a record with an unset reclen.
  - Fix data-offset overflow in msr3_repack_mseed2() that could hang on
    Steim-encoded input or corrupt non-Steim output when an oversized header
    pushed the data offset past 65535.
  - Prevent overflow on sample-count when writing miniSEED v2.
  - Fix mstl3_writemseed() to detect output write, flush, and close
    failures and return -1 instead of reporting a false success count
    on a full or read-only filesystem.
  - Fix negative /FDSN/Time/Correction values rounding toward zero instead of
    to the nearest 100 µs unit when written to miniSEED v2.
  - Fix mstl3_pack_free() to include samples from an active segment packing
    session in the returned packed sample count instead of discarding them,
    and to not under-report packed samples when mstl3_pack_next() aborts
    because the actively-packed segment was merged or removed.
  - Reject an unset or error start time in msr3_pack_init() instead of
    silently packing v2/v3 records dated 1902-001T00:00:00.
  - Warn when packing miniSEED 2 with a start year outside 1900-2100.
  - Reject a sample rate beyond the representable miniSEED 2 nominal rate,
    and NaN, before converting it to an integer when reducing the rate to a
    factor and multiplier, instead of converting it out of range.

  Extra headers:
  - Fix mseh_set_ptr_r() to avoid deleting the existing header value at a JSON
    Pointer and reporting success when a value allocation fails (e.g. OOM).
  - Fix mseh_get_ptr_type() and mseh_get_ptr_r() to consult a supplied
    parsestate before reporting "not found" on a record with no serialized
    extra headers, so a set-then-get through the same parsestate works on a
    fresh record.
  - Fix mseh_get_ptr_r() returning a bit-reinterpreted negative value for type
    'i' requests on extra header integers that are unsigned and out of range
    for int64_t, instead of the wrong-type indicator.
  - Limit extra-header float precision per-value instead of document-wide, so
    large or pre-existing values are not lost or rejected.

  Time handling:
  - Fix ms_sampletime() to adjust for every leap second contained in a span
    instead of only the first.
  - Parse fractional seconds in time strings locale-independently so
    period-decimal fractions are not silently dropped under comma-decimal
    locales (LC_NUMERIC).
  - Fix sign loss for negative sub-second epoch times (e.g. -0.5) when printing
    and parsing UNIXEPOCH/NANOSECONDEPOCH time strings.
  - Fix ms_mdtimestr2nstime() and ms_seedtimestr2nstime() to carry a fractional
    second that rounds up to 1.0 into the next second instead of rejecting the
    time string as invalid.
  - Fix ms_nstime2timestr_n() detection of a truncated output buffer.
  - Fix ms_sampletime() to reject a non-finite or out-of-range time span
    instead of casting it to an nstime_t and returning a garbage time.
  - Fix ms_sampletime() to reject a negative sample offset instead of
    silently returning the input time unchanged.
  - Reject epoch-time strings beyond the representable nstime range.
  - Reject epoch-time strings whose fractional seconds overflow the nstime
    range even though the integer seconds are in range.
  - Fix FILE* leak on error paths in ms_readleapsecondfile().
  - Fix ms_timestr2nstime() to include the input string, instead of an
    empty string, in the epoch conversion error message.

  Selections:
  - Fix selection file parsing to reject invalid start/end times instead of
    silently treating them as open-ended selections.
  - Reject a "Network Station Location Channel" selection line with a date in
    the Pubversion field instead of silently dropping it and misreading the
    following Starttime/Endtime fields.
  - Fix ms3_readselectionsfile() to reject a 4-field SourceID selection line
    with a non-integer publication version instead of silently misparsing it
    as a network/station/location/channel selection.
  - Reject over-long lines in ms3_readselectionsfile() instead of silently
    parsing the truncated tail as a new selection line.
  - Reject selection time windows whose start is later than end in
    ms3_addselect().
  - Fix off-by-one in selection file reading that rejected a selection line of
    the documented maximum length as too long.
  - Fix ms3_readselectionsfile() to count only selections actually added,
    instead of also counting skipped/unrecognized lines.
  - Fix FILE* leak in ms3_readselectionsfile() on error returns from the
    parse loop.

  Documentation:
  - Document that ISO month-day time strings conform to the RFC 3339 profile.

  Build:
  - Discover test and example programs with globbing in the CMake test suite,
    matching the Makefile, so added programs are built without editing lists.

2026.167: v3.4.1
  - Improve correctness of internal glob matching routines.
  - Fix inverted sample rate comparison with custom tolerance for trace lists.
  - Fix selection matching for open-ended query time windows.
  - Always return error from msr3_writemseed() on write or packing failure.
  - Fix ms3_msfp_init() to seek the dup'd descriptor to startoffset and
    set streampos accordingly.
  - Avoid spurious read error when record buffer is full.
  - Detect precision loss for negative samples in mstl3_convertsamples().
  - Fix buffer overflow in B201 MEDSNR packing.
  - Fix out-of-bounds access on long or failed log messages.
  - Fix out-of-bounds read in v2 blockette chain traversal.
  - Fix out-of-bounds write truncating long path with byte range suffix.
  - Fix NULL dereference in msio_fopen() byte range handling.
  - Use libmseed_memory.free for log registry entries.
  - Fix data size truncation for large fixed-length-encoded records.
  - Fix integer overflow computing v3 record length in ms3_detect().
  - Fix out-of-bounds read in msr3_data_bounds() from unvalidated v2 data offset.
  - Fix dangling stack pointer retained by libcurl header callback.
  - Fix resource leaks on msio_fopen() error paths.
  - Fix lookup for v2 Blockette lengths for uncommon blockettes for bounds checks.
  - Validate input payload size against sample count in ms_decode_data().
  - Propagate extra-header serialization failures in mseh_set_ptr_r().
  - Fix size_t underflow in ms_sid2nslc_n() on zero-size buffers.
  - Limit samples per record to 16-bit limit when packing miniSEED 2.
  - Accept value 255 for B201 MEDLookback and MEDPickAlgorithm.
  - Avoid undefined shift from Blockette 1000 record length exponent.
  - Reject Blockette 1000 record length larger than supplied buffer.
  - Guard NULL Xnp pointer in Steim byte-swap.
  - Reject day-of-month 0 in VALIDMONTHDAY check.
  - Fix memory leaks on error paths in extraheaders.c and tracelist.c.
  - Pass unsigned char to ctype functions.
  - Fix buffer overflow in msr3_repack_mseed3() from undersized buffer check.
  - Limit indent in mseh_print() to avoid negative field width.
  - Build: force "lib" prefix on Windows CMake library output for consistency.
  - Fix tutorial example code, thanks to P. Schmidt for reporting.

2026.094: v3.4.0
  - Support writing header-only records and add tests for header-only records.

2026.088: v3.3.0
  - Add `ms3_msfp_init()` to initialized MS3FileParam with start/end offsets.
  - Avoid closing I/O streams not opened by the library when reading or
  writing miniSEED, specifically stdin and stdout or a provided descriptor.
  - Update GitHub Actions dependencies for Node 24 changes.

NOTE Behavior change: I/O streams provided by the caller, such as stdin
and stdout, are no longer closed by the library.

2026.024: v3.2.4
  - Add ms_rlog_pop() to return messages from the error/warning log registry
  - Fix return value from ms_rlog_emit()
  - Fix tracking of message count in log registry.
  - Add tests for logging facility.
  - Add example/lm_extraheaders.c to demonstrate extra header functionality.

2026.001: v3.2.3
  - Add mseh_get_ptr_type() to determine type of an extra header.
  - Add unsigned integer (uint64_t) support to `mseh_set_ptr_r()` and `mseh_get_ptr_r()`.

2025.369: v3.2.2
  - Allow mseh_set_ptr_r() to create extra headers when none exist for a merge patch
  using the root pointer ("").  Pointers to non-root locations still must exist.

2025.354: v3.2.1
  - Rename ms3_mstl_init_fd() to ms3_msfp_init_fd() and add backward compatibility.
  - Add -fPIC to the build options for the static library target.
  - Update internal selection matching to support `!` in addition to `^` for
  character class negation and handle edge cases more robustly.
  - Avoid modifying record buffer during v3 CRC check and add CRC validation to testing.
  - Add v3 parsing test for ensuring header-indicated lengths are sane.
  - Small fixes of logic errors and increased portability.
  - Add GitHub action to build and test on multiple platforms.
  - Fix Windows symbol issues and CMake configuration.

2025.315: v3.2.0
  - Add generator-style packing interfaces for MS3Record and MS3TraceList.
  Specifically msr3_pack_init(), msr_pack_next(), msr_pack_free() and
  mstl3_pack_init(), mstl3_pack_next(), mstl_pack_free().
  - Fix mstl3_pack_ppupdate_flushidle() logic to flush only idle streams.
  - Fix memory leak in mseh_replace().
  - Addition of a CMake build system contributed by @lsawade, thank you!

2025.303: v3.1.11
  - Fix byte swapping in ms3_detect() for v3 records for big-endian systems.
  - Add MSF_SKIPADJACENTDUPLICATES to skip adjacent duplicate records while
  populating a MS3TraceList.

2025.298: v3.1.10
  - Add MSF_SPLITISVERSION flag to control using the splitversion value as the
  version instead the record publication version for mstl3_addmsr() and variants.
  - Add missing functions to libmseed.def for Windows library exports.

2025.267: v3.1.9
  - Add mstl3_pack_ppupdate_flushidle() for packing idle streams in combination
  with the use of MSF_PPUPDATETIME during trace list additions.
  - Convert mstl3_addmsr() from a macro to a real (thin) function.

2025.257: v3.1.8
  - Fix segment removal from MS3TraceList when packing

2025.239:
  - Add mstl3_pack_segment()
  - Deprecate mstraceseg3_pack()
  - mstl3_addmsr()/mstl3_addmsr_recordptr(): Ensure segments represent time
  coverage before adding new samples.

2025.234: 3.1.7
  - Add ms_nstime2timestr_n() with string size limit, deprecate ms_nstime2timestr().
  - With ms_nstime2timestr_n() print "ERROR" for NSTERROR and "UNSET" for NSTUNSET.
  - Avoid fatal errors when v2 record blockettes contain invalid time stamps.
  When invalid SEED "btime" values are encountered they are now set to NSTERROR and
  serialized in extra headers as "ERROR".
  - Limit float point values in extra headers to single precision to avoid
  unrealistically high precision values in the output
  - Update yyjson to v0.12.0

2025.227:
  - Properly round negative values when converting floats to integers
  in mstl3_convertsamples().

2025.207: 3.1.6
  - Properly propagate sub-fractional microseconds to v2 blockette 1001
  when packing more than one record.
  - Round sub-fractional and sub-microsecond times for v2 record fields
  to retain accuracy.
  - Ensure microsecond offsets in v2 record fields are -50 to +49, which
  matches previous major library version behavior and SEED recommendation.
  - Add msr3_repack_mseed2() to repack v2 records efficiently.
  - Add -s and -R options to example/lm_pack.c.
  - Fix some pedantic compiler warnings in msio.c.

2025.114: 3.1.5
  - Add new functions to libmseed.map and libmseed.def for public use.

2025.113: 3.1.4
  - Fix msr3_duplicate() to properly terminate duplicated extra headers.
  - Add mstraceseg3_pack() to individually packet MS3TraceSeg entries.
  - Add lmp_systemtime() to return current system time as nstime_t.
  - Add MS3Record_INITIALIZER for efficient heap initialization of an MS3Record.
  - Change the default initialization for MS3Record.starttime to NSTUNSET.
  Previously this was a value of 0, corresponding to 1970-01-01T00:00:00Z.
  - msr3_print(): do not force high resolution printing of sample rate.
  - Add MSF_PPUPDATETIME flag to store update time (as nstime_t) at MS3TraceSeg.prvtptr.
  - Add support for generating SourceIDs from SEED codes with (illegal) spaces.
  - Add ms_sid2nslc_n() with destination buffer sizes for memory safety.
  - Deprecate ms_sid2nslc(), supports max buffers needed for SEED codes.
  - Fix some potential undefined behavior due to load of unaligned values.

2024.165: 3.1.3
  - Use sequence number from extra headers (/FDSN/Sequence) if present when writing format v2.

2024.148: 3.1.2
  - Update yyjson to v0.9.0.
  - Simplify mstl3_addmsr_recordptr() a bit.

2024.146:
  - Replace ms_dabs() with macro to use system fabs(), document as deprecated.
  - Add CRC values to diagnostic message when header values does not match calculated.

2024.137:
  - Add msr3_nsperiod() to calculate the sample period in nanoseconds.
  - Add tests for msr3 utility functions.

2024.106:
  - When writing v2 derive the quality code from the publication version when the
  extra-header "/FDSN/DataQuality" is not present.  Use quality indicator 'D' when
  the publication version cannot be mapped, e.g. > 4.

2024.024: 3.1.1
  - Change library compatibility version in Makefile to MAJOR.1.0, as this is now
  incompatible with the x.0.0 releases.

2024.024: 3.1.0
  BREAKING CHANGES, data structure and an API changes:
  - `MS3Record.encoding` now int16_t instead of int8_t.
  - `MS3Record.datalength` now uint32_t instead of uint16_t (change in 3.0.18).
  - `MS3Record.datasize` and `MS3TraceSeg.datasize` now uint64_t instead of size_t.
  - `ms3_detect()` now returns int64_t instead of int.
  - `mstl3_unpack_recordlist()`'s `outputsize` argument is now uint64_t instead of size_t.
  - `mseh_get_ptr_r()`'s `maxlength` is now uint32_t instead of size_t.

  - Fix to handle full range of allowed encoding values from 0-255.
  - Fix to handle detection of huge record lengths beyond MAXRECLEN gracefully.
  - Add more checks to avoid writing impossible values to miniSEED v2 blockette fields.
  - Fix all compiler warnings at level -Wextra for clang, gcc, and \W3 for MSVC.

2024.015:
  - Fix build of DLL target on Windows by defining exports in libmseed.def.

2024.007:
  - Improve formatting of gap list produced by mstl3_printgaplist().

2024.006: 3.0.18
  - ms_nslc2sid() requires all codes except location to be set to reduce misuse.
  - Fix raw, diagnostic generation of SIDs from miniSEED v2 when full codes are used.
  - Fix handling of data length field in miniSEED v3 as 32-bits instead of 16-bits.
  - Increase MAXRECLEN from 131172 to 10485760 (10 MiB) for v3 records.
  - Define MAXRECLENv2 as 131172 (131+ KiB) to limit miniSEED v2 records and add
  test for sample counts beyond the 16-bit field limit in v2 records when packing.
  - Update yyjson to release 0.8.0.

2023.335:
  - Add LMIO_FD type of reading IO via arbitrary file descriptor and hooks for setting.
  - Add mseh_replace() to replace extra headers.
  - Consistently initialize header values to 0, fixing edge cases like header-only records.
  - Update link in documentation of ms_readleapsecondfile() for sources of leap-seconds.list.

2023.206: 3.0.17
  - Add tests for default record length and encoding.
  - Document versioning schema as semantic versioning.
  - Add const qualifiers to packing routines that do not modify the
  passed MS3Record structure.

2023.204: 3.0.16
  - Additional Steim 1 & 2 decoder optimization.
  - Add more const qualifiers to pointer values.  Thanks @damb.

2023.185:
  - Fix logic in `msr3_duplicate()` for certain cases.
  - Add many const qualifiers to pointer values where the library
  interface does not modify the data.  Thanks @damb

2023.180:
  - Add const qualifier to record pointer declarations where the
  library interface does not modify the data.

2023.177:
  - Incorporate ms_gswapX() functions into libmseed.h to promote inlining.
  - Optimize Steim 1 & 2 decoders.
  - Change test for environment variable DECODE_DEBUG to compile-time define
  - Change test for environment variable ENCODE_DEBUG to compile-time define

2023.162: 3.0.15
  - Print sample rate in Hz consistently in msr3_print()
  - Fix writing of SNR values field 9 of Blockette 201 (v2)
  - Read and write microsecond offsets to/from Blockette 500 (v2)
  - Fix addition of Clock Model field 9 of Blocketee 500 (v2)

2023.160: 3.0.14
  - Add FAQ to documentation and update example code to match API changes.
  - Change sample type for text encoding to 't', value 'a' still supported.

2023.159:
  WARNING: API change as follows:
  The `fpos` and `last` arguments of ms3_readmsr(), ms3_readmsr_r(),
  and ms3_readmsr_selection() have been removed.  The same capabilities
  is avaiable and details are included in the porting guide.

  - Add JSON Merge Patch capability to mseh_set_ptr_r().
  - Fix zero-padding of empty bytes following data in miniSEED v2 creation.
  - Rename DE_ASCII to DE_TEXT to generalize to UTF-8, legacy mapping provided.
  - Add MS3Tolerance_INITIALIZER for MS3Tolerance values.

2023.155:
  WARNING: API change as follows:
  The `MS3TraceList.numtraces` was renamed `MS3TraceList.numtraceids`.

  - New test suite based on Tau :https://github.com/jasmcaus/tau.
  Many tests were added and the suite now works on MS-Windows.

  - Update example/lm_pack.c:
    * Use improved test sinusuoid that contains all differences for
      Steim1 and Steim2 encoding.
    * Add `-2` option to generate miniSEED v2 instead of default v3.

2023.105:
  - Handle special case of year 0 when parsing version 2 blockettes. These
  are now treated as "unset" and not included in the extra headers.
  - Add nstime_t special value of NSTUNSET for use as "unset" meaning.

2023.099:
  WARNING: API change as follows:
  The `path` argument to mseh_get and mseh_set routines is now in
  JSON Pointer (RFC 6901) format.  This is a more appropriate, and
  standardized, format than the pseudo-JSON Path, dotted string style
  previously used.  It also allows more flexibility such as specification
  of an array element.

  - `mseh_get_path_r()` and `mseh_set_path_r()`, previously named without
  the `_r` suffix, now take a additional `parsestate` argument.  This
  functionality allows the parsed extra headers to be retained between
  calls to avoid re-parsing.  For advanced usage, this allows more efficient
  getting or setting of multiple extraheader values.  If used, this state
  information must be free'd with `mseh_free_parsestate()`.  If used
  with `mseh_set_path_r()` the headers must also be serialized with
  `mseh_serialize()`.

  - `mseh_get_path_r()` and `mseh_set_path_r()` accept a value type of `i`
  that is used with int64_t values.

  - Replace JSON library with yyjson (https://github.com/ibireme/yyjson).
  Benefits include performance, shortest accurate real number representation,
  JSON Pointer support, and UTF-8 support.


2023.082:
  WARNING: API changes as follows:
  1. mstl3_printtracelist() now takes an additional `versions` argument.
  When non-zero the routine will decorate SIDs with publication versions.
  1. The MS3TraceID structure is no longer a simple linked list.  Instead
  it is a skip list, slightly changing the syntax for traversing the list
  as illustrated in the examples.

  - Significant optimization for the case of constructing trace lists with
  large numbers of differnt source IDs, by using a skip list. Implementation
  inspired by: https://github.com/tdeck/c-skiplist, thanks @tdeck!
  - Add new mstl3_findID() function for searching a trace list for specific
  SourceID and, optionally, publication version.

2023.068:
  - Optimize trace construction in mstl3_addmsr_recordptr() for the case
  of duplicate records.
  - Add 'const' declarations to ms_sid2nslc() and ms_nslc2sid() to guarantee
  input will not be modified.
  - Add cURL detection and full build support to example/Makefile.
  - Fix logic test for LIBMSEED_NO_THREADING declaration.

2023.029: 3.0.13
  - Embed current leap second list, used by default and replaced by
  ms_readleapsecondfile().

2023.028:
  - Add ISOMONTHDAY_DOY time string variant, with day-of-year.
  - Add '_Z' variants of time string formats for trailing Z versions.
  - Print record timestamp in new ISOMONTHDAY_DOY_Z format.
  - Deprecated the ms_nstime2timestrz() function.
  - Re-brand to EarthScope.

2022.338: 3.0.12
  - Change printing of bit flag sets to print each bit flag in
  most-significant-bit first order to match binary number representation.

2022.156: 3.0.11
  - Generate proper HTTP Range header by always including a start value,
  defaulting to 0, when a range end is specified.
  - When time correction value is present always set the time correction
  applied bit when creating V2 records. Thanks @nicoleroy-ipgp.
  - mseedview example: always emit accumulated log messages, and print
  basic summary correctly.

2022.103: 3.0.10
  - Fix uninitialized file position in ms3_readtracelist_selection() (#80)
  by @anowacki.
  - Fix array index warning in crc32c.c.
  - Update emmbedded Parson to 1.4.0.
  - Simplify byte swapping routines (#75) by @QuLogic.
  - Initialize selection.pubversion to 0 in ms3_readtracelist_timewin()
  by @Cuda-Chen.
  - Make logging facility thread safe, with per-thread parameters.
  - Add lm_pararead.c example to illustrate reading miniSEED in parallel
  using re-entrant interfaces and POSIX threading.
  - Add Add MS_HPTIME2NSTIME and MS_NSTIME2HPTIME macros to convert
  to/from version 2.x time values.

2021.234: 3.0.9
  - Update Source Identifier handling to the adopted specification of:
      FDSN:NET_STA_LOC_BAND_SOURCE_POSITION

2020.156: 3.0.8
  - Add error/warning log registry for accumulation of messages.
  - Log and diagnostic printing callbacks now require 'const char *'.
  - Verbose-triggered messages are now sent to stdout instead of stderr.

2020.137:
  - Add capability to read data from URLs.  This feature is optional,
  enabled at build time with LIBMSEED_URL and requires libcurl to be
  available on the system.

2019.216:
  - Copy only UTF-8 characters in ms_strncpclean(), ms_strncpcleantail(),
  and ms_strncpopen().

2019.172: 3.0.7
  - Add conversion of epoch values via ms_timestr2nstime().
  - Allow trailing 'Z' in date-times in ms_timestr2nstime().

2019.170: 3.0.6
  - Generalize ms_timestr2nstime() to detect all supported time formats.
  - Rename old ms_timestr2nstime() to ms_mdtimestr2nstime().
  - Change minimum valid year from 1000 to 1678 to avoid wrap-around.
  - ms_nstime2timestr(): fix printing of pre-epoch values for UNIXEPOCH.
  - Add test for time string parsing and conversion.

2019.166: 3.0.5
  - Allow trace list packing with multiple data sample types.

2019.163:
  - Portable printing of size_t values.

2019.162:
  - Re-license all libmseed code under the Apache License V2.0.

2019.161: 3.0.4
  - Add record record list capability, replacing segment-level record metadata.

2019.142:
  - Add ability to pack miniSEED version 2 records.

2019.137:
  - Allow packing records with no payload, i.e. header-only.

2019.135:
  - Add pre-allocation of data buffers, enable on Windows and disable otherwise.

2019.123: 3.0.3
  - Fix version splitting, clarify behavior
  - Fix publication version filtering, thanks @krischer
  - Allow selections without time ranges, thanks @krischer
  - Normalize encoding string lookups, the SEED manual values are messy no need to perpetuate them
  - Add option to build PDF manual and clarifications in documentation
  - Remove steps in install target of Makefile that no longer function, thanks @senshu

2019.103: 3.0.2
  - mstl3_pack() can be called without modifying the Trace List with MSF_MAINTAINMSTL flag.
  - Add lm_pack_rollingbuffer.c example of generating records with a rolling buffer.
  - Consistently provide extra headers as terminated string from MS3Record.extra.
  - Fix segment start time tracking in mstl3_pack().

2019.102: 3.0.1
  - Add mstl3_readbuffer_selection() and fix selection-based ms3_readmsr_selection().
  - Use callback functions for time and sample rate tolerance instead of fixed values.
  - Fix progression of record start time when packing records.
  - Optionally store record-level metadata, header flags and extra headers, in a MS3TraceList.
  - More documentation and examples.

2019.094: 3.0.0
  - A new major version refactored to support the next generation miniSEED
  Documentation including porting guide avilable at:
  https://iris-edu.github.io/libmseed/

  Almost all core data structures and functions have been modified,
  often mostly in name (due to structure changes), so porting is required.

  Major new features and changes of note:

  - Support for reading/writing of miniSEED 3 and read support of miniSEED 2.

  - Support for nanosecond time resolution:
  The HPTMODULUS is renamed NSTMODULUS and changed for nanoseconds.
  Related change of HTPERROR to NSTPERROR value.
  hptime_t changed to nstime_t and all time functions changed accordingly.
  The hptime2XYZtimestr() function is combined into single nstime2timestr()
    function with format flag.

  - Added mstl3_readbuffer() to read all records in a data buffer into a Trace List.

  - Add global libmseed_memory that contains user-definable function pointers to
  malloc(), realloc() and free().  This allows all memory management from the library
  to be performed with user-defined functions.

  - Data structure change and rename:
  Rename MSRecord to MS3Record and restructure for miniSEED 3.
  Rename MSTrace[ID,Seg,List] to MS3Trace[ID,Seg,List] and restructure for miniSEED 3.
  Rename Selections and SelectTime to MS3Selections and MS3SelectTime.

  - Remove MSTrace_s and MSTraceGroup and related functions, use MS3Trace[ID,Seg,List] instead.

  - Remove all platform defines (LWP_*) except LWP_WIN for MS Windows.

  - Rename all library structs by removing the "_s" suffix so they match their typedef names

  - Rename macros and functions specific to miniSEED 2.x by adding "2".

  - Remove packheaderbyteorder and packdatabyteorder handling and related
  envrionment variables. Byte order is either detected or fixed.

  - Decrease MINRECLEN from 256 to 40, decrease MAXRECLEN from 1MB to 128 KiB.

  - Increase 'recbuflen' to msr3_parse[_selection]() to uint64_t to work with very large buffers.

  - Remove record length specifier from many parsing routines, always autodetermined.

  - Remove MS_ISVALIDBLANK macro, was only used for notification of archaic structure.

  - Add JSON handling and general wrapper functions to support extra headers

  - Add CRC-32C calculation, new ms_crc32c() function.

  - Set msr->swapflag bit flags to indicate if header and payload need swapping during parsing.

  - Selection file format allows two selection listing variants
  If the "quality" field is an integer it is assumed to be a publication version,
  otherwise it is ignored.

  - Remove capability to read the deprecated "pack" file format used at IRIS DMC.

  - Remove StreamState tracking, effectively dropping the compression history capability
  between records.  Not worth the complexity.

2017.283: 2.19.5
  - msr_endtime(): calculate correct end time during a leap second.
  - Fixed signedness comparison warning.

2017.125:
  - Export LM_SIZEOF_OFF_T on Windows via libmseed.def.

2017.118: 2.19.4
  - Add global LM_SIZEOF_OFF_T variable that is set to the size of
  the off_t data type as determined at compile time.

2017.075: 2.19.3
  - Add missing public, global symbols to libmseed.map, thanks
  to Elliott Sales de Andrade.

2017.061: 2.19.2
  - Provide install target in Makefile thanks to by Pierre Duperray.
  - Deprecate dynamic build target, the shared target will now build
  shared or dynamic (Darwin) libraries depending on the system.
  - Limit symbols exported in shared libraries to public interfaces
  as defined in libmseed.map, thanks again to Pierre Duperray.
  - Allow tests to work on Darwin with dynamic libraries.

2017.060: 2.19.1
  - Derive versioning of shared/dynamic library from canonical version
  defined as LIBMSEED_VERSION in libmseed.h.
  - Apply updates to more standardized use of NAME and typos in man pages,
  submitted by Pierre Duperray.

2017.053: 2.19
  - Incorporate lmplatform.h details into libmseed.h for improved usage.
  All that is needed is the static/shared/dynamic library and libmseed.h.
  - Avoid undefined left shifts of signed values that would go out of
  range and specify the types of some constants.

2016.290:
  - Remove dependency on ntwin32.mak for Windows nmake makefiles, now
  building works in plain MSVC development environments.

2016.286: 2.18
  - Remove limitation on sample rate before calling ms_genfactmult()
  in the normal path of packing records.  Previously generating the
  factor and multiplier was not attempted for rates higher than
  32,767.

2016.281: 2.18rc4
  - ms_genfactmult() now support a much larger range of integer
  sample rates and periods.
  - ms_genfactmult() now sets the factor and multiplier using the
  SECONDS/SAMPLE notation for sample rates less than 1.0 to retain
  precision for low rates.
  - ms_genfactmult() now assumes the specified rate is a sample
  period in seconds if the samprate value is negative.
  - Add ms_rsqrt64() as a general use reciprocal sqrt for doubles.
  - Use memcpy() instead of assignment when unpacking float32 and
  float64 samples to avoid problems with NaN's.  Thanks Lion Krischer.
  - Add test for reading records without Blockette 1000.
  - Reformat all source code using included clang-format profile.

2016.277:
  - A more elegant sanity check for output length in packing by mbyt.

2016:276: 2.18rc3
  - Improvements for test suite, more consistency.
  - Remove msr_decode_steim? from libmseed.def, they are internal.
  - Add sanity to length check before memset calls in packing functions.

2016:274: 2.18rc2
  - Check for environment variables ENCODE_DEBUG and DECODE_DEBUG
  and set debugging output, at this point it is Steim frame details
  and differences being encoded/decoded.
  - Fix padding in steim[12] encoding routines.
  - Remove unneeded output buffer checks in steim[12] decoding routines.

2016.272: 2.18rc1
  - Replace data sample packing and unpacking routines from qlib2 with
  new routines developed from scratch.  All code is now LGPL licensed.
  - Add test suite with tests for encoding, decoding, parsing, etc.
  - Update licensing to GNU-LGPL version 3 and include (L)GPL licenses
  in LICENSE.txt.

2015.053:
  - Define needed C99 int types for MSVC 2012 or earlier.  Previously
  this was only done for versions earlier than MSVC 2010.

2015.213: 2.17
  - Round Fixed Section Data Header start time values to the nearest
  tenth of millisecond and restrict the microsecond offset value
  to a range between -50 and +49 as recommended in SEED.  Previously
  start times were truncated at tenths of millisecond resolution
  and the microsecond offset value was between 0 and +99.  This also
  addresses a bug where microsecond offsets were off by 100ms for times
  before Jan 1 1970.  Thanks to Lion Krischer for reporting.

  Note to future hackers: the definition of HPTMODULUS governing the
  time tick interval for high precision time values implies that this
  tick interval may be changed.  In reality, this should not be changed
  from the default, microsecond tick value without thorough testing.
  Some logic is know to be dependent on the microsecond tick.

2015.134: 2.16m
  - Add defines for needed integer types and macros from inttypes.h
  missing in older MSVC versions.  MSVC 2010 and later appear to have
  enough C99 support.
  - Add define tests for _WIN32 and _WIN64 to cover all WINs.
  - ms_fread(): Add cast to quiet warning for conversion from size_t
  to int.  In this case the read will always be <= MAXRECLEN, much
  smaller than int, making the conversion safe.

2015.113: 2.16
  - Update minor release version in Makefile.

2015.108:
  - Cleanup of lmplatform.h removing unneeded headers and using C99
  standard headers except for a few platform specific cases.
  - Convert all printf() and scanf() usage of %lld for 64-bit integers
  to use the C99 PRId64 and SCNd64 macros for portability (MinGW).
  - Change detection of Linux/Cygwin to set global define LMP_LINUX
  instead of LMP_GLIB2 (now marked as deprecated).
  - Change detection of Windows to set global define LMP_WIN instead
  of LMP_WIN32 (now marked as deprecated).
  - Add detection of __MINGW64__ define.
  - Tested building on Win7 with: Open Watcom 1.9, MinGW gcc 4.8.1 and
  Cygwin 1.7.35 (gcc 2.9.2).

2015.074:
  - Define NTP-Posix time epoch conversion constant specifically as
  a long long integer to avoid warnings on some compilers.

2015.070: 2.15
  - Fix infinite loop if blockette chain is corrupt.  Patch submitted
  by Elliott Sales de Andrade.

2015.062: 2.14
  - Fix memory leak when msr_pack() returns after an error. Patch
  contributed by Larry Baker and Eric Thomas.
  - Change casting of values passed to isdigit() to int intead of
  unsigned character.  Apparently this was consufing on ARM archs.

2015.061:
  - Add ms_readleapseconds() and ms_readleapsecondfile() routines to
  read a leap seconds file into an internal list.
  - Modify msr_endtime() to check for an internal leap second list,
  check for overlap with the record and adjust the end time as needed
  when leap seconds are present.  When a leap second list is present
  any indication of positive leap seconds in the fixed section data
  header are ignored.

2014.248:
  - Add casting to size_t and int to avoid build warnings on certain
  build systems (e.g. older MS Visual Studio).
  The effective maximum sample buffer and record buffer size is ~2GB.

2014.234: 2.13
  - Clean up Makefile and example/Makefile, remove all GCC-specific and
  debug targets.  Makefiles are compatible with both GNU and BSD make.
  As before, the shared target works only for GCC-compatible compilers.
  Thanks to Elliott Sales de Andrade for pointing out that shared library
  targets did not work with parallel builds, prompting this clean up.

2014.197: 2.13rc
  - Support 128-byte record length by changing MINRECLEN to 128 (was 256).
  The current SEED specification is a minimum record length of 256-bytes,
  but there are cases (e.g. low latency data flow) using 128-byte records.
  - Add declarations, casting and string truncation to clear warnings
  uncovered in ObsPy testing (thanks to Elliott Sales de Andrade).

2014.074:
  - Add __CYGWIN__ defined test to Linux section of lmplatform.h.

2013.273: 2.12
  - Add mst_convertsamples() and mstl_convertsamples() to convert sample
  types.  When converting from float & double types to integer type
  a simple rounding is employed to compensate for machine representation
  of floating point numbers.

2013.267:
  - msr_endtime(): Check activity flags in fixed section of data header,
  if bit 4 is set then a positive leap occurred during the record and
  the end time should be reduced by one second to properly match the now
  shifted UTC time.  As long as the next record in the series is
  properly marked with the correct UTC time no artificial time tear
  will be generated when reconstructing the time series.

2013.137:
  - Update docs for transition to 64-bit sample counts done in 2011!

2013.117: 2.11
  - Initialize internal counters in mst_pack() to avoid their use
  in error conditions. Thanks to D. Ketchum and M. Potter for help.
  - Add 'const' qualifier to the msfile argument of the file reading and
  writing family of routines to stop compiler warnings resulting from
  generated binding functions.  Thanks to M. Bach for reporting.

2013.056: 2.10
  - Add more sanity checks to msr_unpack_data() to catch bad/corrupted
  data records and avoid crashes due to impossible pointer construction.

2013.053: 2.9
  - Extend parsing of day-of-year style time strings to allow parsing
  of time fields separated by dashes in addition to allowing the day
  and time fields to be separated by a 'T' or space.  Modifications
  were made to ms_seedtimestr2hptime().
  - Extend parsing of year-month-day style time strings to allow parsing
  of time fields separated by commas.  Modifications were made to
  ms_timestr2hptime().

2013.050:
  - Add MS_ISVALIDYEARDAY() macro to test range for year and day values,
  years between 1900 and 2100 and days between 1 and 366.
  - Use new macro to determine when byte swapping is needed.  This test
  leaves a non-determination of byte order for days 1, 256 and 257 in
  the year 2056, beware future data users.

2013.007: 2.8 (again)
  - Add msr_parse_selection() to libmseed.def for Windows builds.
  - Fix errors in pseudo code in doc/msr_parse.3.

2012.363: 2.8
  - Implement msr_parse_selection() which is a wrapper of msr_parse()
  that searches for the first parsable miniSEED record in a memory
  buffer and returns it.  Optionally a Selections list may be specified
  to limit the returned data to records matching specific criteria.

2012.357:
  - Fix corruption of float sample types when opposite byte order than
  host in certain architecture combinations.  By not addressing
  individual float samples directly as floats prior to byte swapping
  we avoid the values being placed into the FPU where they may be
  corrupted.  Thanks to Moritz Beyreuther and Lion Krischer for discovery
  and testing.
  - Expose the msr_unpack_data() function for use by removing the static
  declaration.  Change verbose flag type to match others and document.
  - Fix some logging messages, typos, etc.

2012.138: 2.7
  Add define for MINGW32 to use _fstat and _stat.

2012.114: 2.7rc2
  - Change record parsing code to trim trailing spaces from network,
  station, location and channel parameters.  Spaces in between non-space
  characters remain.

2012.111:
  - Update example/test.mseed to new data with an earthquake to make it
  more recognizable compared to ambient noise in the previous example.

2012.105: 2.7rc1
  - Add many type casts to quiet newer GCC and MSVC compilers.
  For 32-bit programs there are some places, mostly in packing routines,
  where 64-bit integers are converted to 32-bit values for sample buffer
  sizes and counts leaving the potential for overflow.  This will become
  a problem when byte counts for sample buffers are beyond 2^31, for
  32-bit integer sample values that is more than 536 million samples.
  So programmer beware if using such buffer sizes for packing miniSEED.

2012.088:
  - When parsing records copy the ASCII string fields (sequence number,
  network, station, location, channel) directly without removing spaces.
  This makes the parser more lenient to unallowed characters and
  synchronizes read and write capabilities.

  - For sampling rates above 32,767 Hz only print a warning for high
  verbosity settings and set the sample rate factor and multipler to zero.
  Previously an error was printed during rational approximation.
  The expectation is that a record with such a high sample rate will
  include a blockette 100 to specify the actual sample rate.
  This is not an official convention for SEED, but is a kludge to
  support extremly high sample rates without printing errors.

  - Fix conversion to doubles in examples/msrepack.c.

2011.304: 2.6.2
  - Increase precision of sample rate in SYNC printing routines to
  avoid trucation of rate values.

2011.262:
  - Add '_lm' suffix to declaration of pivotal_gmtime_r_stamp in
  genutils.c to avoid conflicts with other libraries.  Thanks to Doug
  Neuhauser for the tip.

2011.164:
  - example/msrepack.c: add -N option to specify network code for output
  data records.

2011.160:
  - example/msrepack.c: make sure input buffer is flushed/packed, retain
  good input data when the end of the file contains bad data.

2011.158:
  - example/msrepack.c: convert samples to needed type for specified
  output encoding, e.g. integers to floats.
  - example/msrepack.c: do not open output file until after all options
  have been parsed to avoid clobbering the output file unnecessarily.

2011.144: 2.6.1
  - Update dynamic library version.
  - Add notes to the users guide and intro about functions useful for
  detecting and parsing records in a memory buffer.

2011.129:
  - Correctly determine record lengths implied by presence of pack header
  by avoiding record header searches in buffer beyond pack header.
  - Fix ms_parse to return correct hint of how many more bytes are needed
  when record length has not been determined.
  - Change the samplecnt and numsamples elements of the MSRecord, MSTrace
  and MSTraceSeg structures to 64-bit integers to avoid overflow.

2011.124:
  - Allow lowercase 't' in ISO time string parsing.

2011.090:
  - Add check for invalid blockette offset in ms_detect().

2011.056: 2.6
  - Fix handling of sample data in internal MSTraceList routines.
  - Cleanup WIN32 defines, make MSVC and Open Watcom play nicely.
  - Default data byte order to big endian when blockette 1000 contains
  invalid byte order value, previously defaulted to host byte order.

2011.042:
  - Update libmseed.def to match current libmseed.h declaractions.
  - Cleanup to avoid MSVC warnings.

2011.039: 2.6rc4
  - Do not return MS_NOTSEED when no records read from packed file.
  - Update user guide to include note about MSTraceLists and change
  the miniSEED creation example to use mst_writemseed().

2011.036: 2.6rc3
  - Fix parsing of records without blockette 1000, use pack headers
  and end-of-file to determine implied record lengths.

2011.032: 2.6rc2
  - Fix handling of truncated records, partial reads at EOF.
  - Fix offset tracking when reading from stdin.

2011.006: 2.6rc1
  - Add convience routines to only read selected records from a file:
     ms_readtracegroup_timewin()
     ms_readtracegroup_selection()
     ms_readtracelist_timewin()
     ms_readtracelist_selection()
  - Add convience routines to write miniSEED data to specified file:
     msr_writemseed()
     mst_writemseed()
     mst_writemseedgroup().
  - Fix bug when either mst_pack() or mst_packgroup() was called with
  a NULL packedsamples pointer.
  - Fix bugs when (re)initializing read buffer.
  - Fix return of file position in ms_readmsr_main()..

2010.365:
  - Add internal ms_gmtime_r() to replace call to system gmtime_r(). The
  internal version handles dates beyond year 2038 and avoids the system
  call.  Tested with years up to 5000.

2010.363:
  - Add parseutils.c source file.
  - Add msr_parse() to detect & unpack a record in a memory buffer.
  - Add ms_detect() to check a memory buffer for a record.

  - Rewrite ms_readmsr_main() to use msr_parse() and reduce I/O by
  using a double-buffer to increase the average read size and other
  simplifications and optimizations.

  The internal read buffer size is MAXRECLEN as defined in libmseed.h.
  Each file parameter structure used, including the global default,
  will allocate a buffer of this size.  For specialized applications
  requiring low memory use the MAXRECLEN, current 1 MB, can be reduced.

  - Change ms_readmsr_main() to interpret reclen <= 0 as a request
  for autodetection of each record, a value of 0 no longer means all
  records are the same length as the first record.
  - Remove ms_find_reclen() function, replacement is ms_detect().
  - Move ms_parse_raw() into parseutils.c.
  - Change year sanity check to allow range 1800 to 5000.
  - Use 64-bit values in hptime calculation to correctly handle years
  beyond 2038.
  - The "last" record indicator argument to the ms_readmsr() family
  is considered deprecated and will probably be removed in future
  releases.  New programs should not use this functionality, it does
  not, and will never, work in cases where there is more than
  MINRECLEN padding after the last valid record in a file.

2010.304:
  - Use gmtime_r() to avoid the non-thread-safe system gmtime() function.
  - Define gmtime_r() for WIN32 and WIN64 in terms of gmtime() which is
  thread-safe under WIN32.
  - Add define for WIN64 even though WIN32 is probably defined for 64-bit.

2010.291:
  - Add check for spaces as valid characters in sequence numbers.

2010.253:
  - Add check for log parameters in ms_log_main().

2010.129:
  - Fix small printing bug in diagnostic ms_printselections().

2010.068: 2.5.1
  - Allow file name for ms_readselectionfile() to be "-" and read
  stdin as a special case.

2010.047: 2.5
  - Fix tracking of first and last MSTraceSeg entries in mstl_addmsr().
  - Make the non-fatal Steim integrity failure and sample mismatch log
  output print as "Warning" instead of "ERROR".

2010.015: 2.4
  - Change ms_addselect() to take a srcname argument and create
  ms_addselect_comp() as a wrapper that creates a srcname from
  individual source name components.

2010.012:
  - Fix unpacking of 16-bit integer encoded data, thanks to
  Robert Barsch.

2010.008:
  - Fix special case of "--" location ID in ms_addselect().

2010.007:
  - Add SelectTime **ppselecttime argument to ms_matchselect()
  and msr_matchselect() routines so that the matching time range
  can optionally be returned to the caller.

2010.006:
  - Add a check for ATTRIBUTE_PACKED define (lmplatform.h) and
  if set add an __attribute__((packed)) qualifier to all structs
  that are mapped to SEED structures (and cannot be padded).
  This is useful on platforms such as ARM that pad structures
  for alignment by default.  To use add "-DATTRIBUTE_PACKED" to
  CFLAGS or equivalent.
  - Fixes to gswapX() routines for platforms where structures
  are padded for alignment; patch from Laurence Withers, thanks.
  - Add msr_matchselect and ms_printselections() routine to
  selections.c.

2010.005:
  - Simplify packed file reading in ms_readmsr_main() and allow
  data sections to be skipped based on a Selection list, packed
  files are used internally at the IRIS DMC.
  - Rename ms_readmsr_r() to ms_readmsr_main() and create a
  simple wrapper function for ms_readmsr_r().

2010.004:
  - Add selection.c containing routines to manage data selection
  lists based on network, station, location, channel, quality,
  start and end times.  The name parameters may contain globbing
  charaters for matching.  External routines are: ms_addselect(),
  ms_matchselect(), ms_readselectionfile() and ms_freeselections().

2009.365:
  - Correctly track microsecond offset in Blockette 1001 when
  msr_pack() creates more than one record.

2009.357:
  - Reduce error accumulation of record start times in pack.c,
  thanks to Roman Racine for the report and suggested fix.
  The error only accumulated to significant values when packing
  a large number of records with a single call to msr_pack().

2009.354:
  - Change return type of internal ms_readpackinfo() to off_t and
  fix small error return check.

2009.353:
  - Add ms_splitsrcname() routine to split "NET_STA_LOC_CHAN[_QUAL]"
  into separate components.
  - Update MINOR_VER version to 4 anticipating the 2.4 release
  (seem to have forgotten 3).

2009.201: 2.3
  - msr_unpack(): change new blockette count and data offset
  test failures to "Warning" instead of "ERROR".

2009.194: 2.3rc
  - Fix record offset reporting when record length detection fails.
  - Add diagnostic reporting of data problems in ms_readmsr_r()
  by calling ms_parse_raw().

2009.174:
  - Fix corner case trace sorting error in mstl_addmsr().
  - Add ms_nomsamprate() to genutils.c to calculate the sample rate
  specified as a SEED sample rate factor and multiplier.
  - Add ms_parse_raw() implementing a simple validating parser
  to report invalid header values and print raw header fields.
  - msr_unpack(): add tests for blockette count and data offset.
  - Change byte swapping test of year to 1920 to 2050 range.
  - Store blockette offset in BlktLink structure.

2009.111: 2.2
  - Add CDSN decoding support due to popular demand.
  - Incorporate enhanced dynamic library versioning as recommended
  by Laurence Withers.
  - Fix bug in ASCII encoding routine, thanks again Laurence Withers.
  - Add and update libmseed.def which can be used with the Win32 DLL
  for linking, original file contributed by Robert Barsch.

2008.361: 2.2rc3
  - Improve mstl_addmsr() sorting and suturing logic so that it
  matches the healed and sorted output from the trace group routines.

2008.327: 2.2rc2
  - Add ms_readtracelist() to read all records from a file into a
  MSTraceList.
  - Update all man pages with changes and add new man pages.
  - Fix auto sorting of traces in mstl_addmsr().

2008.320: 2.2rc
  - Add MSTraceList facility which is functionally equivalent to
  the existing MSTraceGroup facility but more efficiently populated,
  especially when data records are in time order or the time series
  are very gappy.  The MSTraceList related functions are prefixed
  with "mstl_" and exist in the new source file tracelist.c.
  - Add mst_printsynclist() and mstl_printsynclist() functions to
  print trace segment lists in SYNC format.

2008.318:
  - Change one call in fileutils.c to fseeko() to lmp_fseeko()
  so Win32 builds work again.

2008.313:
  - Optimize mst_findadjacent() by first testing for time segment
  match, then sample rate and finally source name components.

2008.283: 2.1.7
  - Allow a caller of ms_readmsr()/ms_readmsr_r() to specify a
  starting offset into the file by setting the value pointed to by
  the fpos argument to a negative value (interpreted as a positive
  offset).

2008.220: 2.1.6
  - Optimize Steim 1 & 2 encoders significantly by using small local
  working buffers and eliminating many redundant calculations.
  Thanks to Jean-Francois Fels.

2008.171:
  - Add Matlab/GNU Octave interface routines, thanks to Stefan Mertl.
  - Remove 'const' qualifier from argument of log printing function
  pointers, too many useless compiler warnings.

2008.163:
  - Allow data record sequence numbers to be NULL values in addition
  to ASCII numbers.

2008.161: 2.1.5
  - Fix string parsing error for IRIS DMC packed files, thanks Sandy!
  - Use a merge sort algorithm insteam of the bubble sort previsouly
  used in mst_groupsort(), better performance.
  - Do raw string manipulation in msr_srcname() and mst_srcname()
  instead of using sprintf(), slightly better performance.
  - Do raw string comparison in mst_findmatch() for better performance.

2007.228: 2.1.4
  - Include compression history for Steim encodings by tracking the
  last sample value packed for each data stream.  For the first
  record of a stream, a cold-start, the first difference is zero.
  This included the addition of a StreamState struct and associated
  pointers for MSRecord and MSTrace which get allocated during packing
  routines.
  - Do not adjust start time of record header during packing when
  sampling rate is zero or negative.
  - Add ms_hptime2mdtimestr() and ms_btime2mdtimestr routines to
  create time strings in month-day format, this is the same as
  the ISO format without the 'T' between the date and time.
  - Add a 'subsecond' flag argument to all ms_hptime2<string>
  routines to control the addition of sub-second precision.

2007.178: 2.1.3
  - Fix log message bug for unknown encoding format while unpacking,
  this could cause certain systems to segfault if encountered.
  - Rename MS_UNPACKENCODINGFORMATFALLBACK macro to
  MS_UNPACKENCODINGFALLBACK to match the actual variable name.
  - Fix handling of fallback encoding format in unpack.c, worked
  earlier but had regressed to a broken state.
  - Remove declaration for lmp_strerror() which does not exist.

2007.148: 2.1.2
  - Use calloc instead of malloc to allocate and clear a fsdh_s
        in msr_pack_header_raw() when none is available in the passed
        MSRecord.  Previously this could result in a subtle bug for systems
        where malloc'd memory is not zeroed.  This would only have effected
  programs that were creating miniSEED in a particular way.

2007.138: 2.1.1
  - Create LMP_BSD platform definition to cover the BSDs including
  Apple Mac OS X, this replaces LMP_DARWIN.  Specifically FreeBSD,
  OpenBSD, NetBSD and Apple are detected for this platform.

2007.118:
  - Add msr_duplicate() function to duplicate an MSRecord struct.
  - Use msr_duplicate() in example/msrepack.c example program to
  track the most current MSRecord as a template for packing.

2007.102: 2.1
  - Removed caveat comment from mst_groupheal() man page.

2007.083:
  - mst_groupheal() now sorts the MSTraceGroup before it tries to
  heal the traces, this increases the chances of healing all
  possible segments.
  - msr_pack(): add void *handlerdata argument that wil be passed
  directly to the record_handler(), this is intended to allow
  private data to be passed from the msr_repack() caller to the
  record handling routine.
  - mst_pack(): add void *handlerdata argument that is passed
  directly to msr_pack() and used as described above.
  - mst_packgroup(): add void *handlerdata argument that is passed
  directly to mst_pack() and used as described above.
  - Add macros for setting the pack & unpack, header & data byte
  order override variables: MS_PACKHEADERBYTEORDER(X),
  MS_PACKDATABYTEORDER(X), MS_UNPACKHEADERBYTEORDER(X) and
  MS_UNPACKDATABYTEORDER(X).
  - Add macros for setting the unpack encoding format override and
  encoding format fallback variables: MS_UNPACKENCODINGFORMAT(X)
  and MS_UNPACKENCODINGFORMATFALLBACK(X).

2007.074:
  - Fix typos in the docs referring to msr_readtraces() that should
  be ms_readtraces(), thanks Richard Boaz.

2007.034:
  - mst_groupheal(): fix removal of first trace in group.
  - mst_groupheal(): reset MSTrace data quality indicator when
  merged traces do not have matching qualities.

2007.030: 2.0
  - Set no default CFLAGS and CC variables for building and add a
  note to the Makefile about using them for build configuration.
  - Eliminate compiler warning for genutils.c routines.

2007.028:
  - Add new pack file type 8.
  - Allow 'M' as a valid data record indidator/quality flag.

2007.023:
  - Determine needs for GEOSCOPE decoding and remove the need
  for using the pow() function and linking with the math library.

2007.005:
  - Fix resetting of global MSFileParam in ms_readmsr_f() when
  cleanup is requested.

2006.363:
  - Change mst_groupsort() to sort on: srcname, then starttime,
  then descending endtime and finally sample rate.  This moves
  sample rate to the end of the criteria, the previous order was:
  srcname, sample rate, starttime and endtime.

2006.354: 2.0rc1
  - Stamp 2.0rc1.
        - Fix diagnostic printing bug in pack.c.
  - Fix ms_gswap.3 man page.

2006.346:
  - Change "get_" prefix for lookup routines to "ms_".
  - Change ms_encoding() to ms_encodingstr().
  - Document ms_errorstr() in the lookup and other man pages.
  - Document and use ms_log(3) in User Guide/ms_intro(3).

2006.344:
  - Add "ms_" prefix to gswap routines.
  - Change SWAPBTIME macro to MS_SWAPBTIME.

2006.339: 2.0pre8
  - Add buffer length sanity check in ms_find_reclen() suggested by
  Doreen Pahlke.
  - Change mst_printracelist() and mst_printgaplist() to print
  "-0" when the gap is 0 (one sample overlap) and "==" when there
  is no gap.

2006.332:
  - Add memory allocation checks, every allocation is now tested.
  - Fix usage message for example programs, use fprintf for the long
  section of the output.

2006.331: 2.0pre7
  - Add source name to all unpacking error and diagnostic messages.
        - Add source name to all packing error and diagnostic messages.
  - Reorganize sanity check code in msr_unpack() to use the
  MS_ISVALIDHEADER macro.
  - Add ms_recsrcname() function to calculate the source name for
  an unpacked record.

2006.326: 2.0pre6
  - Add ms_readmsr_r() as a reenentrant, thread safe version of what
  ms_readmsr() used to be and make ms_readmsr() a wrapper for the new
  reentrant version that uses global file reading parameters.
  - Use ms_readmsr_r() in ms_readtraces() so that it's now thread
  safe too.
  - Add logging.c routines and declarations in libmseed.h.  This
  constitutes a new logging facility that is used throughout the
  library and can be used by libmseed based programs.  The facility
  allows the caller to redirect all the log, diagnostic and error
  output from the library to specific functions.  The facility
  also allows user specifed prefixes for all output messages.

2006.321:
  - Prefix all data encoding type defines with DE_ to avoid collision.
  - Add GEOSCOPE (three subtypes), SRO and DWWSSN data decoders, there
  are no encoders for these types.
  - Need of the pow() function now requires linking with -lm (math lib).

2006.312: 2.0pre5
  - Add MS_ISVALIDBLANK macro to libmseed.h to test memory for valid
  blank/noise records: valid sequence number followed by ASCII spaces.
  - Use MS_ISVALIDBLANK in ms_find_reclen() to implicitly find record
  lengths, when reading ahead the record length can now be determined
  if then next record is a real data record or a blank record.
  - Use MS_ISVALIDBLANK in ms_readmsr() to print out a more specific
  message when skipping blank records as opposed to non-data records
  records.

2006.311: 2.0pre4
  - Use MS_ISVALIDHEADER instead of MS_ISDATAINDICATOR when verifying
  data records when the record length is not autodetected in ms_readmsr().
  - In msr_unpack_data() move the test of reallocation directly after
  the reallocation so it's only tested when actually done.
  - In msr_unpack_data() include text description of encoding in the
  unsupported encoding error message.

2006.296: 2.0pre3
  - Add 'quality' flag argument to mst_srcname() to control the
  addition of the quality indicator in the srcname.
  - Add 'quality' flag argument to mst_groupsort() to control the
  inclusion of quality indicator in the sorting.

2006.292: 2.0pre2
  - Use memory-aligned swap functions in unpackdata.c for speed.

2006.291:
  - Fix return type of ms_readtraces() on success and documentation.
  - Tweak verbose flag checking in fileutils.c to avoid spurious msgs.
        - Add gcc32gprof and gcc64gprof targets to Makefiles for profiling.

2006.284: 2.0pre
  - Fix dynamic target and update API version in Makefile.
        - Require GCC for shared and dynamic library building.
  - Include ctype.h header in lmplatform.h for WIN32 platform.

2006.283:
  - Add function msr_normalize_header() to update the FSDH and
  blockettes with values at the MSRecord level.
  - Add 'normalize' flag argument to msr_pack_header() control the
  calling of msr_normalize_header() when packing.
  - Change the MSRecord element 'private' to 'prvtptr' to avoid
  collision with the C++ reserved word.
  - Add a 'quality' flag argument to msr_srcname() to control the
  addition of the quality indicator to the srcname.
  - Move MS_ISVALIDHEADER(X) macro to libmseed.h for general use; this
  macro tests for valid SEED data record signatures and is used for
  detection of data records when reading data from files.
  - Remove two redundant tests of swapflag in Steim-1 decompression.
  - Declare starttime in msr_starttime() as hptime_t instead of double,
  testing indicates that this never caused a problem in practice.
  - Update example programs for API changes.
  - Add -fPIC to GCCFLAGS in Makefile.
  - Remove declaration for non-existent ms_verify_header() in libmseed.h
  (thanks LLoyd Carothers).

2006.251:
  - Add correct swapping of fsdh.numsamples and fsdh.data_offset,
  problem and fix reported by Doreen Pahlke (thanks!).  This fixes
  packing of data when packing to a byte-order opposite of the host
  machine.

2006.208: version 1.8
  - Fix memmove bounds for out-of-time-order data additions in both
  mst_addmsr() and mst_addspan().
  - Fix memory leak in mst_pack() by freeing the temporary MSRecord
  when no template is used.
  - Add get_errorstr() function in lookup.c to return text descriptions
  for specified libmseed return/error codes.
  - Add gcc32, gcc32debug and gcc64debug targets to Makefiles.

2006.182: version 1.7
  - Add MS_WRONGLENGTH error code and have msr_unpack() and the
  file reading routines return it when the read length does not match
  length specified in the Blockette 1000.  This most commonly occurs
  when either the specified record length or the length of the first
  record is auto detected and the following record lengths assumed
  do not match the actual records.
  - Use MS_ISRATETOLERABLE macro in mst_groupsort() to compare the
  sampling rates of adjacent trace segments.  This is how sampling
  rates are compared in other routines and will avoid problems
  associated with testing the equality of floating point values.

2006.173:
  - Remove some of the useless error codes.
  - Steim compression integrity check failure and sample count
  mismatch are not fatal unpacking errors, only warnings are printed.

2006.172:
  - Changed return type of ms_readmsr() to int and added a pointer
  to a pointer to an MSRecord to the arguments.  Function now returns
  status/error codes.
  - Changed return type of ms_readtraces() to int and added a pointer
  to a pointer to an MSTraceGroup to the arguments.  Function now
  returns status/error codes.
  - Changed return type of msr_unpack() to int.  Function now
  returns status/error codes.
  - Changes to many internal functions to support the new unpacking
  error code bubble.
        - Removed the MSRecord.unpackerr element as it is now unneeded.
  - Found and fixed bug resulting in the assumption that all sample
  sizes were 8 bytes (which would usually be wrong) during unpacking.

2006.124: version 1.6.3
  - Fix (int *)packedsamples handling for packing routines.
  - Fix compilation under Open Watcom (Win32).

2006.122: version 1.6.2
  - More fixes for sampling rate == 0 when calculating the sample
  period.

2006.121: version 1.6.1
  - msr_endtime() now checks that the sample count is greater than
  zero.  If the sampling rate or sample count is less than or equal
  to zero msr_endtime() returns the starttime.

2006.115: version 1.6
  - Rename mst_heal() to mst_groupheal().
  - Change examples for ms_readtraces() in documentation that implied
  an incorrect return type.
  - Small changes to error messages for clarity (e.g. add file read
  offset, print sample types as char not int).
  - Fix offset determination for packed files and files without
  blockette 1000s.

2006.107:
  - Add MS_ISVALIDHEADER macro to fileutils.c, verifies that a
  specified buffer contains a valid fixed section data header.
  - ms_find_reclen(): moved to fileutils.c
  - ms_find_reclen(): More data record verification by checking
  for valid time values (e.g. 0 <= hour <= 23 ).
        - ms_find_reclen(): Detect record lengths even when no blockette
  1000 is found by reading the next 48 bytes from the file and
  looking for another record header or EOF.  This check is not
  performed if the specified FILE pointer is NULL.  The original
  file read position is restored.  This required adding another
  argument: FILE *fileptr.
  - Change output of msr_print() to include record length for
  the lowest detail output (single line per record).
  - Change example msview program to autodetect each record by
  default.

2006.082: version 1.5.2
        - Make msr_pack() emit a warning with the function pointer to
  the record_handler() is not set instead of bombing out.  The
  packed record is not accessible any other way.
  - Make the packedsamples argument to msr_pack() optional, the
  pointer can be NULL if this information is not needed.
  - Modify ms_readmsr() to be able to read packed files which are
  indexed files used internally at the IRIS-DMC and probably no
  where else.
  - Add lmp_fseeko() portable function (used in fileutils.c).

2006.079: version 1.5.1
  - Add file name check in ms_readmsr() to make sure subsequent
  reads are done on the same file.  If the function is called with a
  different file name than the file that is currently open the
  current file will be closed and the new one opened and an error
  message printed.
  - Change mst_srcname to include the data quality code in the
  srcname if it is non-zero.
  - Remove the data quality code specifics from mst_print* functions
  as it is now included in the source name.

2006.076: version 1.5
  - No changes, just stamp 1.5.

2006.058:
  - Change structure names:
    * Trace -> MSTrace
    * TraceGroup -> MSTraceGroup
    * MSrecord -> MSRecord
  A bothersome change, but it will ease inclusion into source
  base of other libraries, etc.
  - Change struct fsdh.drec_indicator to fsdh.dataquality.
  - Change MSRecord.drec_indicator to MSRecord.dataquality.
  - Add MSTrace.dataquality element.
  - Add data quality matching flag arguments to ms_readtraces()
  and mst_addmsrtogroup() to control matching of data qualities.
  - Add data quality value arguments to mst_findmatch() and
  mst_findadjacent() to control matching of data qualities.
  - Modify mst_printtracelist() and mst_printgaplist() to include
  data quality flags in their output when they have been set.

2005.336: 1.4.5
  - Improve the data record verification in ms_find_reclen() to
  improve the detection of non-data versus data records.  In
  particular the routine now requires a record to start with
  6 ASCII digits followed by a valid data record indicator
  followed by either a space or NULL character (even though
  a NULL here is not valid SEED).
  - Fix mst_groupsort for near srcname matches.

2005.325: 1.4.4
  - Add end time sort level to mst_groupsort(), now the function
  will sort on: source name, sample rate, start time and
  descending end time in that order.

2005.315: 1.4.3
  - Include WIN32 define for strcasecmp->_stricmp.
  - Fix typo in blockette 200 printing.

2005.300: 1.4.2
  - Include sys/types.h for Win32 systems in lmplatform.h and
  do not typedef off_t.

2005.299: 1.4.1
  - In mst_findadjacent() do not perform the time and sample
  rate tolerance checks if the tolerance is specified as -2.0.
  - Remove the msi.c example program, it has diverged from the
  separate released msi.

2005.292: 1.4
  - In mst_addmsr() and mst_addspan() test if data sample
  memory needs to be moved before moving, allows adding an
  msr to a trace which has no data samples (e.g. a flushing
  pack has been done).
  - Do not try to pack Traces with numsamples==0 in
  mst_packgroup().

2005.289:
  - Add check for sample count mismatch and decrement
  mst->samplecnt when packing in mst_pack().
  - Free mst->private in mst_init().

2005.271: 1.3
  - Add lmplatform.[ch] to hold platform dependent defines
  and portability routines.
  - Create lmp_ftello() portable routines and use it.
  - Change all uses of fopen() to include a 'b' in the mode
  in order to open files in "binary" mode on Win32.
  - Add Makefile.wat for Open Watcom's wmake.
  - Add Makefile.win for Microsoft's nmake.
  - Test using Open Watcom 1.3 under Win32 (Windows XP).
  - Add 'dynamic' target in Makefile to build a dynamic lib
        on Mac OSX.

2005.269: 1.2
  - Update many unpacking routines so that the MS_SAMPMISMATCH
  error code is correctly returned and that none of the errors
  are show stoppers, it is left to the application to decide.
  - Remove error message when read fails during detection, the
  end of the file is simply that, no error.
  - Fix definition of MS_EPOCH2HPTIME and MS_HPTIME2EPOCH in
  ms_time.3 man page.
  - Change int64_t types to hptime_t types in documentation.

2005.203: 1.1
  - Add 'chainpos' argument to msr_addblockette() to control
  which end of the blockette chain the blockette is added to.
  - Change msr_pack() to add any missing 1000 Blockettes to
  the end of the blockette chain.

2005.201: 1.0 Final
  - Change version of example programs so they don't conflict
  with future, non-example versions.
  - Generate links to man pages and tar up a source package.
  - No library code changes since pre6.

2005.173: 1.0pre6
  - Set MSrecord->reclen to -1 in msr_init() to trigger
  the default value in msr_pack(), etc.

2005.157: 1.0pre5
  - Fix off-by-one error in number of samples for overlaps.

2005.146: 1.0pre4
  - Add check for an UNPACK_DATA_FORMAT_FALLBACK environment
  variable that defines a fallback format for when no encoding
  format is specified in the data record (no blkt 1000).
  - Set a default format fallback encoding of 10 (Steim 1).
  If this default gets invoked, the byteorder will fallback
  to big-endian if it has not been specified.
  - Change the MS_EPOCH2HPTIME(X) and MS_HPTIME2EPOCH(X)
  macro definitions to not include a semi-colon, duh.
  - Add a 'timeformat' flag to the mst_printtracelist() and
  mst_printgaplist() functions that indicates which format
  the time stamp will be in: SEED time, ISO time or epoch.
  - Add an option to msi to specify the time format in trace
  and gap listings.

2005.117: 1.0pre3
  - Add check for the following environment variable to force
  the data encoding format when unpacking:
  UNPACK_DATA_FORMAT = data encoding format
  - Add '-e' option to msi/msrepack to specify the input data
  encoding format allowing them to work with plain data records.
  - Define _LARGEFILE_SOURCE in fileutils.c to get ftello()
  without a compiler warning on Linux.
  - Fixup swapping when byte order is forced on LE arch.

2005.116: 1.0pre2
  - Add checking for the following environment variables that
  can be used to force the byte-order for the header and data:
  PACK_HEADER_BYTEORDER = 0 or 1
  PACK_DATA_BYTEORDER = 0 or 1
  UNPACK_HEADER_BYTEORDER = 0 or 1
  UNPACK_DATA_BYTEORDER = 0 or 1
  - Change the fpos argument to ms_readmsr() to be type off_t.
  - Change the calls to ftell() in ms_readmsr() to ftello() to
  return type off_t, this is required for large file support
  where 64-bit offsets are needed.
  - Change the header byte order determination to check for
  start years between 1920 and 2020.
  - Add gcc64 target to Makefile and example/Makefile.

2005.102: 1.0pre1
  - Change msr_pack() to use a 'D' record indicator by default.
  - Cleanup examples directory.

2005.097: 0.9.9b
  - Remove '-g' from common GCCFLAGS in examples/Makefile.
  - Small update to ms_time.3 to clarify that MS_HPTIME2EPOCH
  can be used to get both a truncated integer epoch or a
  double precision epoch.

2005.093: 0.9.9a
  - Remove '-g' from common GCCFLAGS in Makefile.

2005.091: 0.9.9
  - Fix printing of Blockette 500.
  - Change macro defines to upper case macro names.

2005.080: 0.9.8
  - Add ms_isratetolerable() macro to perform the default
  sample rate tolerance check. Update appropriate functions.
  - Fix sample rate checking in mst_print*() functions.
  - Fix msi example code so negative min/max gaps (overlaps)
  are parsed correctly from command line.

2005.069: 0.9.7
  - Change mst_print() to mst_printtracelist() and add
  mst_printgaplist().
  - Both of the above routines now report gaps as the time
  of the first sample after the gap minus the time of the last
  sample before the gap, sample "coverage" time is no longer
  included.
  - Make mst_groupsort() sort on source->samplerate->starttime
  instead of source->starttime.
  - ms_readmsr() will now skip non-data records when doing
  record length autodetection.
  - Add ms_hptime2epoch() macro to convert hptimes to
  Unix/POSIX epoch times, integer truncation, no rounding.
  - Add macro ms_isdataindicator() which tests a character
  for a valid data record header indicator (D,R,Q,etc.)
  - Example program msi now takes -min and -max options to
  specify min and max gap/overlap to display in gap list.

2005.047: 0.9.6
  - Add ms_epoch2hptime() macro to convert Unix/POSIX
  epoch times to hptimes.

2005.025: 0.9.5
  - Add 'skipnotdata' flag argument to ms_readmsr() and
  ms_readtraces() and update their respective man pages.
  - Shuffle order of arguments for ms_readtraces(), no big
  deal but since the interface was changing anyway...

2005.004: 0.9.4
  - Change printing of sample rates to print higher precision
  so that small differences in rates are noticeable.
  - Change fixed section header printing of sample rate to be
  the actual calculated value using the factor and multiplier.
  - Spell check README/INSTALL files and man pages.
  - Remove WIN32 Makefiles and hooks in example sources.
  - Minor printing fixups in the example code msi.c.

2004.352: 0.9.3
  - Change ms_readmsr() to search valid record lengths up
  to 8192 bytes when auto detecting the record size.
  - Change msr_addblockette() to always add Blockette 1000s
  to the beginning of the blockette chain and others to the
  end of the blockette chain.

2004.349:
  - Fix reduction of precision when unpacking doubles.
  - Change typo in pack.c from 'Unpacking' to 'Packing'.
  - Improve printing of float/double samples in msi.

2004.342: 0.9.2
  - Add proper rounding for span calculation in msr_endtime().

2004.341 - Release version 0.9.1