updated README (#798)

* updated README

* working on README

* working on README

* working on README

* working on README

* working on README

Author: edwardhartnett

README.md

@@ -2,7 +2,8 @@
 
 # NCEPLIBS-g2 Library
 
-The NCEPLIBS-g2 library reads and writes GRIB edition 2 files.
+The NCEPLIBS-g2 library contains Fortran code to read and write GRIB
+edition 2 files, and itilities to manipulate GRIB2 files.
 
 GRIdded Binary or General Regularly-distributed Information in Binary
 form (GRIB) is a data format for meteorological and forecast data,
@@ -12,10 +13,18 @@ edition 2 (GRIB2) was approved by the WMO is 2003.
 This library is part of the
 [NCEPLIBS](https://github.com/NOAA-EMC/NCEPLIBS) project.
 
-For more detailed documentation see
-https://noaa-emc.github.io/NCEPLIBS-g2/. For the NCEP WMO GRIB2
-Documentation see
-https://www.nco.ncep.noaa.gov/pmb/docs/grib2/grib2_doc/. 
+For more detailed documentation on this library see the [NCEPLIBS-g2
+documentation](https://noaa-emc.github.io/NCEPLIBS-g2/). For more
+information about GRIB2, see the [NCEP WMO GRIB2
+Documentation](https://www.nco.ncep.noaa.gov/pmb/docs/grib2/grib2_doc/).
+
+Starting with NCEPLIBS-g2-4.0.0, this library depends on the
+[NCEPLIBS-g2c](https://github.com/NOAA-EMC/NCEPLIBS-g2c) library.
+
+Starting with NCEPLIBS-g2-4.0.0, this library includes the utilities
+formerly released in
+[NCEPLIBS-grib_util](https://github.com/NOAA-EMC/NCEPLIBS-grib_util). The
+NCEPLIBS-grib_util repository is deprecated.
 
 To submit bug reports, feature requests, or other code-related issues
 including installation and usage questions, please create a [GitHub
@@ -24,22 +33,36 @@ NCEPLIBS inquiries, contact [Edward
 Hartnett](mailto:edward.hartnett@noaa.gov) (secondary point of contact
 [Alex Richert](mailto:alexander.richert@noaa.gov)).
 
+## The Utilities
+
+Utility | Purpose
+--------|--------
+cnvgrib | Convert between GRIB1 and GRIB2.
+copygb | Copy all or part of a GRIB1 file.
+copygb2 | Copy all or part of a GRIB2 file.
+degrib2 | Inventory a GRIB2 file.
+grb2index | Create an index from a GRIB1 file.
+grbindex | Create an index from a GRIB2 file.
+tocgrib | Copy some GRIB2 fields to a new GRIB1 file.
+tocgrib2 | Copy some GRIB2 fields to a new GRIB2 file.
+tocgrib2super | Copy some GRIB2 fields to a new GRIB2 file with super WMO header.
+
 ## Related NCEPLIBS Projects
 
 Repository | Notes
 -----------|------
+[NCEPLIBS-ip](https://github.com/NOAA-EMC/NCEPLIBS-ip) | Interpolation.
 [NCEPLIBS-w3emc](https://github.com/NOAA-EMC/NCEPLIBS-w3emc) | Coders/decoders for GRIB1
 [NCEPLIBS-g2c](https://github.com/NOAA-EMC/NCEPLIBS-g2c) | C implementation of the GRIB 2 functions
-[NCEPLIBS-grib_util](https://github.com/NOAA-EMC/NCEPLIBS-grib_util) | A collection of GRIB1 and GRIB2 utilities
 [NCEPLIBS-g2tmpl](https://github.com/NOAA-EMC/NCEPLIBS-g2tmpl) | Utilities for GRIB2 templates
 
 ## Authors
 
 Harry Glahn, Kyle Gerheiser, Stephen Gilbert, Brent Gordon, Edward
-Hartnett, Mark Iredell, Hang Lei, Boi Vuong, and other NOAA scientists
-and developers.
+Hartnett, Mark Iredell, Hang Lei, Alyson Stahl, Boi Vuong, and other
+NOAA scientists and developers.
 
-Code Manager: [Hang Lei](mailto:hang.lei@noaa.gov), [Ed
+Code Manager: [Hang Lei](mailto:hang.lei@noaa.gov), [Edward
 Hartnett](mailto:edward.hartnett@noaa.gov)
 
 ## Prerequisites
@@ -52,6 +75,8 @@ This package requires the following third party libraries:
 - [zlib](http://www.zlib.net/)
 
 This package requires the following NCEPLIBS libraries:
+- [NCEPLIBS-g2c](https://github.com/NOAA-EMC/NCEPLIBS-g2c)
+- [NCEPLIBS-ip](https://github.com/NOAA-EMC/NCEPLIBS-ip)
 - [NCEPLIBS-bacio](https://github.com/NOAA-EMC/NCEPLIBS-bacio)
 - [NCEPLIBS-w3emc](https://github.com/NOAA-EMC/NCEPLIBS-w3emc) (optional)
 
@@ -67,7 +92,11 @@ make install
 
 ## References
 
-```
+Hartnett, E., Lei, H., Richert, A., Stahl, A., [A New API for
+NOAA's GRIB2
+Libraries](https://www.researchgate.net/publication/386906653_A_New_API_for_NOAA's_GRIB2_Libraries),
+American Geophysical Union (AGU) 2024.
+
 Hartnett, E., Ator, J, Lei, H., Richert, A., Woollen, J., King, A.,
 Hartnett, A., [NCEPLIBS GRIB and BUFR Libraries: Maintaining and
 Modernizing NOAA's Libraries for WMO Data
@@ -84,10 +113,8 @@ NCAR Improving Scientific Software, April 2022.  .
 Kumar, V. Krishna, Gilbert, Stephen A., [GRIB2 conversion and its
 usage at NCEP](docs/GRIB2_conversion_and_its_usage_at_NCEP.pdf), 14-18
 November 2005, 10th Workshop on Meteorological Operational Systems
-ECMWF User Orientation, retrieved on July 27, 2021 from
-https://www.yumpu.com/en/document/view/11925806/grib2-conversion-and-its-usage-at-ncep.
+ECMWF User Orientation.
 
-```
 ## Disclaimer
 
 ```