                        Changes in version 1.1.8                        

    o   Spelling correction in DESCRIPTION by CRAN submission check.

                        Changes in version 1.1.7                        

    o   Added Federal Information Processing Standard codes for U.S. State and
	Territories in inst/helpers/getpks/FIPS.txt.

    o   Updated .gitignore for output of inst/helpers/getpks/getStatePKs.R whilst
	part of testing for full database retrieval and geopackaging. There is no
	expectation of bringing this utility formally into the package until after
	the USGS goes through deprecation of the dataRetrieval::readNWISpeak()
	to a new waterdata services API.

    o   Adjusted on.exit() in plotPeaks.R as certain applications made it impossible
	for a user to otherwise do additional plotting actions after the peaks
	were plotted. Spelling correction in comments of plotPeaks.R.

    o   makePeakMatrix.[R|Rd] as an adaptation of the code4 and code8 peaks being
	lesser and greater than flags for setting a matrix to contain discharge.

                 Changes in version 1.1.6 (2026-05-27)                  

    o   Change to DESCRIPTION fixing spelling error to word utilities on CRAN check.

                        Changes in version 1.1.5                        

    o   Change to DESCRIPTION to convert to new style of author identification.

    o   Changes in outdated urls or urls not providing reasonable reply times
	relative to CRAN checks in gtmoms.Rd, MGBT.Rd, peakTIMtoHRS.Rd,
	plotFFQevol.Rd, readNWISwatstore.Rd, and splitPeakCodes.Rd. Obviously, the
	fixes on the urls made in v1.1.4 were not ideal.

    o   Minor spelling corrections made in ASlo.Rd, EMS.Rd, gtmoms.Rd,
	plotFFQevol.Rd, plotPeaks.Rd, and ratioPeakMax1Day.Rd.

                        Changes in version 1.1.4                        

    o   Added peakTMtoHRS() for conversion of peak times to decimal hours and
	 optional computation of circular mean and standard deviations.

    o   Fixed url redirection to PeakFQ software homepage in gtmoms.Rd,
	 MGBT-package.Rd, MGBT.Rd, and readNWISwaterstore.Rd.

                        Changes in version 1.1.3                        

    o   Grammar edit in readNWISwaterstore.Rd.

    o   Added ratioPeakMax1Day().

    o   Added inst/helpers/pkdvrat as a CONUS demo on the repo by not in R build.

    o   Bug fix on jointPeaks(), in process of deletion of data.frame attributes
	 from dataRetrieval pull, logical variable columns from splitPeakCodes()
	 in an as.data.frame(as.matrix()) operation post splitPeakCodes() was
	 converted the logicals to character columns. Added error traps on nrow()
	 being zero "after" the two peak tables have been joined.

                        Changes in version 1.1.2                        

    o   Maintenance on the repository and code.json to catch up with appropriate
	 structure.

    o   Removed spurious leading spaces in several of the Rd macros across most of
	 the Rd files in the package.

    o   Added jointPeaks() for retrieving peaks from dataRetrieval with splitting the
	 peak codes by splitPeakCodes() for two streamgages. Then, the retrieved
	 data frames are merged into the union as the "joint peak data frame" that
	 should be useful in bivariate probability study, which is outside the
	 scope of this package. However, a demonstration is provided within the
	 copBasic package and specifically the copBasic::breveCOP.Rd Examples.

                        Changes in version 1.1.1                        

    o   Added more messaging about all_peaks_na_okay argument to splitPeakCodes()
	 when the function is returning NULL. The user might forget that one can
	 switch the behavior of the function and this could be very useful when
	 a user has a gage-height only streamgage and particularly so if such
	 site(s) are containing in a large list of streamgages. Worked with
	 Dan Wagner (USGS) in testing the changes.

    o   Added argument make_text_for_all_na_peaks=TRUE to plotPeaks() so that the
	 function while plotting a gage-height only site example, inserts the
	 sentence "There are no non-missing peaks for this streamgage." This will
	 assist many users who have a mixture of flow streamgages with the
	 less common (almost rare) gage-height only streamgages. Worked with
	 Dan Wagner (USGS) in testing the changes.

    o   Added all_peaks_na_okay=TRUE argument to readNWISwatstore() so that it can
	 dispatch this argument of the same name to splitPeakCodes(). The deafult
	 is different between the two functions because readNWISwatstore() in
	 particular is expected to operate on large numbers of site numbers as
	 part of setting up a regional study. Worked with Dan Wagner (USGS) in
	 testing the changes.

    o   Trapped error in code 4 and code 8 plotting in plotPeaks() when the table
	 of peaks had duplicated or more water years, which should not happen
	 by definition. A warning with explanation is triggered and the repeated
	 water years are plotted. The error was a
	 'Error in xy.coords(x, y) : 'x' and 'y' lengths differ'. At the time of
	 testing USGS streamgage 02317600 was the offender.

    o   Added warning to makeWaterYear() to issue warnings for each water year that
	 occurs more than once in the character vector or in the data frame.

    o   Added return.progress=FALSE to readNWISwatstore() that can be used to
	 return a data.frame of siteNumbers column and column vector of TRUE and
	 FALSE values whether the peaks were returned. This is useful for
	 situations in which a site has no peak records at all in NWIS.

    o   Added mtext.site=TRUE to plotPeaks() so as to disable the call of
	 mtext(site, line=0.5) therein but to still have a site being passed
	 into the plotPeaks() function. This provides then a seed for warning()
	 messaging in the event that one or more water years are duplicated,
	 which is not possible by design for a compliant annual peak series.

                        Changes in version 1.0.8                        

    o   Removed unneeded operation involving peak_va within makeWaterYear().

    o   Extended makeWaterYear() to also use character vector for parsing.

    o   BUG FIX: makeWaterYear() was returning zeros in the month_va and day_va
	 columns when the USGS was reporting "00" for the missing month or day.
	 The zeros are now set to missing (NA) values.

    o   Extended splitPeakCodes() to the newer code F and code R attributes and
	 extended the documentation splitPeakCodes.Rd for more citations and
	 further structured listings of both peak_cd and gage_height_cd. Also,
	 removed the code E from triggering the setting of the anyCodes column
	 on the returned table. The documentation clarifies now why E, F, and R
	 are not used to set records of the anyCodes column as TRUE. Colleague
	 Daniel Wagner is credited for discovering that code R has been added to
	 USGS NWIS and necessitate revision to MGBT::splitPeakCodes().

    o   Copied the inst/legend/legend_camera.pdf to
	          man/figures/plotPeaks_legend.jpg (72dpi)   and
	          man/figures/plotPeaks_legend.pdf
	 and then extended the documentation of plotPeaks.Rd to insert these two
	 figures as needed in the html help within an R session and also for the
	 PDF of the user manual. This will help users access the legend itself.

                 Changes in version 1.0.7 (2021-07-21)                  

    o   On CRAN

    o   Added readNWISwatstore() as a means to download WATSTORE formatted peak
	 streamflows using a URL to USGS NWIS. The file is downloaded to a local
	 directory. Optionally, also a tab delimited version of the data can be
	 downloaded and here the dataRetrieval package is needed, and again
	 optionally, the plotPeaks() function can be called for peak visualization.
	 The motivation for this function is to emplace a *.pkf, *.txt, and *.pdf
	 of the peak streamflow information into a directory (one streamgage only)
	 have the basic nomenclature of 08167000d/08167000.pdf
	                                          08167000.pkf
	                                          08167000.txt
	                                          CITATION.md
	 where 08167000 is a USGS streamgage identification number. Multiple
	 streamgages can be processed, but each will get is own directory. This
	 structure is highly conducive to using PeakFQ software for flood-
	 frequency analysis.

    o   Spelling corrections and addition of a See Also section in MGBT-package.Rd.

    o   Minor changes of \url{} declarations to \doi{} declarations as per R CRAN
	 checks using R4.1. Evidently, CRAN policy now is to have dois shown as
	 "doi: 10.3133/sir20175038" style and not the style of
	 https://doi.org/10.3133/sir20175038. This does not seem to extend to
	 the DESCRIPTION at least for the doi of the package shown under URL:

                        Changes in version 1.0.6                        

    o   On CRAN

    o   BUGGISH FIX: Switched to nmom=3 within plotFFQevol() because the function is
	 built around the Pearson type III, which only needs the first three
	 L-moments. So by stopping the computation at nmom=3, we do not have to
	 worry about the lmomco::are.lmom.valid() triggering FALSE on the Tau3 and
	 Tau4 bounds, which in small samples can be violated. The change in the
	 function keeps a cascade of errors from stacking up.

                        Changes in version 1.0.5                        

    o   BUG FIX: Deep testing with irregular use patterns found that the function
	 splitPeakCodes() was testing on water_year to trigger a call to
	 makeWaterYear() but the nomenclature of the package is "water_yr".

    o   DOC FIX: plotPeaks_batch() has a \donttest{} assertion using a named PDF
	 file. This now (R4.0.+) triggers note during --as-cran check. So the
	 example modified to use tempfile() instead.

    o   Color fix: It seems in R4.0.+ that colors 2,3,4 are not no longer limited
	red, green, blue, respectively. These have been replaced as
	"red", "green", and "blue" in plotPeaks.R/.Rd.

                 Changes in version 1.0.4 (2020-03-23)                  

    o   Added more additional discussion of the lot argument within plotPeaks.Rd.

    o   Minor improvement to messaging and "error" trapping with an empty data
	 frame passed to splitPeakCodes() and switched from warning() to
	 message() for the case when more than one streamgage exists on the data
	 frame, which is a situation never supported by anyway in prior releases.

    o   Added the plotPeaks_batch() as a wrapper on plotPeaks() for multiple
	 streamgage processing.

                        Changes in version 1.0.3                        

    o   Documentation updating

    o   Added the ./inst/INSTALL_HELP.md to detail use of RStudio on Windows for
	 package installation from sources.

    o   Additional tune up of several README.md.

                 Changes in version 1.0.2 (2019-10-31)                  

    o   On CRAN

    o   2nd CRAN Presubmission Review Reconciliations

    o   The CRAN team provided additional critique requiring GGBK.R to be modified
	 to issue a stop() instead of warning();return(NULL). The GGBK.Rd example
	 was not modified to a \donttest{} from \dontrun{} as per CRAN advice because
	 the stop() would cause "R CMD check --as-cran --run-donttest" to FAIL.

    o   Converted \dontrun{} to \donttest{} in CritK.Rd.

    o   Converted \dontrun{} to \donttest{} in RthOrderPValueOrthoT.Rd.
	 Some modification to arguments in the Examples made to keep reasonable
	 run times when --run-donttest is used. Notes were made to TAC's original
	 settings in these examples where needed.

    o   Converted \dontrun{} to \donttest{} in RSlo.Rd, but slight modification
	 to the used r-order statistics. Sample size kept at n=100, but the maximum
	 order statistic in is maxr=n/10 instead of n/2, which was the entire lower
	 tail. This is done so that forced testing of the example can still be
	 reasonably completed when --run-donttest is used. Notes were made to TAC's
	 original settings in the example.

    o   Converted \dontrun{} to \donttest{} in critK10.Rd. However, one \dontrun{}
	 is deliberately retained because the original example uses the GGBK(),
	 which now issues a stop().

    o   Converted \dontrun{} to \donttest{} in makeWaterYear.Rd, plotFFQevol.Rd,
	 plotPeaks.Rd, and splitPeakCodes.Rd.

    o   Added dataRetrieval to the DESCRIPTION:Suggests.

    o   Added USGS NWIS citation to makeWaterYear.Rd, plotPeaks.Rd, and
	 splitPeakCodes.Rd.

    o   Reversed the ordering of this NEWS.

                        Changes in version 1.0.1                        

    o   1st CRAN Presubmission Review Reconciliations

    o   Added two references and DOI numbers to the DESCRIPTION:Description.

    o   Opened up EMS.Rd to the running of its examples.

    o   Added note about very long run times for some of the \dontrun{} remaining for
	 RSlo.Rd and RthOrderPValueOrthoT.Rd.

    o   Switched selected \dontrun{} to \donttest{} in documentation files BLlo.Rd,
	 critK10.Rd (also added another example that does not use the GGBK),
	 MGBT.Rd, MGBT-package.Rd, and RthOrderPValueOrthoT.Rd.

    o   Confirmed passage of R CMD check --as-cran --run-donttest MGBT

    o   Added note about the deliberate non-need of the dataRetrieval package for MGBT
	 related to the \dontrun{} use in makeWaterYear.Rd, plotPeaks.Rd, and
	 splitPeakCodes.Rd.

    o   Added pairing of opar <- par(no.readonly=TRUE) ... on.exit(par(opar))
	 in plotPeaks.R and added xlab/ylab in the plotPeaks.Rd \dontrun{} examples.

    o   Added pairing of the following commands in plotFFQevol.Rd for restoration of
	 defaults:  opts <- options(scipen=7)     ...  options(opts)
	            opar <- par(no.readonly=TRUE) ...  par(opar)

    o   Added path=tempdir() in plotFFQevol.R with argument silent message() of file
	 locations.

                        Changes in version 1.0.0                        

    o   First attempt for a CRAN release (GitLab tagged "v1.0.0")

                        Changes in version 0.8.1                        

    o   Preparing various files for the prospect of being publically available as
	 approved software by USGS along https://code.usgs.gov/water/stats/MGBT.

                        Changes in version 0.7.1                        

    o   Adjusted plotPeaks.R/Rd with coordination with Nancy Barth, to use D as the
	 plotting character instead of the diamond, and updated ./inst/legend
	 accordingly.

    o   Adjusted beginning of the suite of MGBT*() functions to test for as.data.frame
	 and then attempt to extract a peak_va columns and added as.numeric conversion.
	 This accelerates using the MGBT() functions with data directly from USGS NWIS.

                        Changes in version 0.6.1                        

    o   Adjustments to supporting files (not .R or .Rd) in preparation for bureau approval
	 in parallel to working on the DOI number.

                        Changes in version 0.5.1                        

    o   Adjustments to supporting files (not .R or .Rd) in preparation for bureau approval.

                        Changes in version 0.4.1                        

    o   Auditing package README files as further preparation for publication.

    o   Added the zzz.R for the .onAttach().

                        Changes in version 0.1.6                        

    o   Added as.numeric() casing of gage_ht inside splitPeakCodes().

    o   Made many extensions to README.md in response to Nancy Barth peer review
	 along with phone discussions with John England (2019-05-26).

                        Changes in version 0.1.5                        

    o   Added support for the "O" discharge qualification code that was brought to the
	 authors' attention by Nancy Barth. Documentation upgrade in MGBT-package.Rd
	 from John England recommendations.

                        Changes in version 0.1.4                        

    o   Added more features to plotPeaks() to plot more nuances of the peak database
	 related to presence of gage height but no discharge and plotting when double
	 missing discharge and gage height exists.

                        Changes in version 0.1.3                        

    o   Another editing pass on the documentation.

                        Changes in version 0.1.2                        

    o   Added warning to multiple gages in splitPeakCodes() and early return NULL.
	This is related to data-mining scale testing on a project of one of the authors.
	Also minor adjustments to splitPeakCodes.Rd.

                        Changes in version 0.1.1                        

    o   Corrected the terminal year in splitPeakCodes().
