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 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.
	2. 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
