fixed URLs in documentation (#709)

* fixed URLs in documentation

* adding BUILD_DEPRECATED to w3emc workflow

* adding BUILD_DEPRECATED to w3emc workflow

* added comment about parameter PRMSL

* fixed param numbers

* working on CI

.github/workflows/Linux_options.yml

@@ -40,7 +40,7 @@ jobs:
             options: "-DBUILD_WITH_W3EMC=OFF"
           }
         - { 
-            options: "-DBUILD_UTILS=ON"
+            options: "-DBUILD_UTILS=ON -DBUILD_WITH_W3EMC=OFF"
           }
 
     steps:
@@ -88,15 +88,15 @@ jobs:
       with:
         repository: NOAA-EMC/NCEPLIBS-w3emc
         path: w3emc
-        ref: v${{ matrix.w3emc-version }}
+        ref: v${{ matrix.w3emc-version }}-1
 
     - name: build-w3emc
       if: steps.cache-w3emc.outputs.cache-hit != 'true'
       run: |
         cd w3emc
         mkdir build
         cd build
-        cmake -DCMAKE_PREFIX_PATH=~/bacio -DCMAKE_INSTALL_PREFIX=~/w3emc -DBUILD_WITH_BUFR=OFF -DBUILD_WITH_EXTRA_DEPS=ON ..
+        cmake -DCMAKE_PREFIX_PATH=~/bacio -DCMAKE_INSTALL_PREFIX=~/w3emc -DBUILD_WITH_BUFR=OFF -DBUILD_WITH_EXTRA_DEPS=ON -DBUILD_DEPRECATED=ON ..
         make -j2
         make install
         

src/params.F90

@@ -269,6 +269,13 @@ module params
   data paramlist(235) /gribparam(2, 189, 0, 0, 15, 'VPTMP')/
   data paramlist(236) /gribparam(2, 198, 0, 1, 207, 'NCIP')/
   data paramlist(237) /gribparam(2, 239, 0, 1, 208, 'SNOT')/
+  ! The following param shares the same GRIB2 discipline, category,
+  ! and number as PRMSL. Since the parameter lookup subroutine starts
+  ! at the beginning of the list, and returns the first abbreviation
+  ! with matching G2 numbers, the MSLSA abbreviation can never be
+  ! returned. According to Boi: In the past, some user used PRMSL or
+  ! MSLSA in grib1. Then, they converted to grib2 and these parameters
+  ! were in same "0,3,1".
   data paramlist(238) /gribparam(2, 128, 0, 3, 1, 'MSLSA')/
   data paramlist(239) /gribparam(2, 137, 0, 3, 199, 'TSLSA')/
   data paramlist(240) /gribparam(129, 141, 0, 3, 200, 'PLPL')/
@@ -936,10 +943,10 @@ module params
   data paramlist(898) /gribparam(255, 255, 2, 3, 21, 'SOILICE')/
   data paramlist(899) /gribparam(255, 255, 2, 3, 22, 'CISICE')/
   data paramlist(900) /gribparam(255, 255, 2, 3, 23, 'LWSNWP')/
-  data paramlist(901) /gribparam(255, 255, 2, 3, 23, 'FRSTINX')/
-  data paramlist(902) /gribparam(255, 255, 2, 3, 23, 'SNWDEB')/
-  data paramlist(903) /gribparam(255, 255, 2, 3, 23, 'SHFLX')/
-  data paramlist(904) /gribparam(255, 255, 2, 3, 23, 'SOILDEP')/
+  data paramlist(901) /gribparam(255, 255, 2, 3, 24, 'FRSTINX')/
+  data paramlist(902) /gribparam(255, 255, 2, 3, 25, 'SNWDEB')/
+  data paramlist(903) /gribparam(255, 255, 2, 3, 26, 'SHFLX')/
+  data paramlist(904) /gribparam(255, 255, 2, 3, 27, 'SOILDEP')/
   data paramlist(905) /gribparam(255, 255, 2, 4, 0, 'FIREOLK')/
   data paramlist(906) /gribparam(255, 255, 2, 4, 1, 'FIREODT')/
   data paramlist(907) /gribparam(255, 255, 2, 4, 3, 'FBAREA')/

utils/tocgrib2.F90

@@ -7,8 +7,9 @@
 !> Field separator block and WMO Header in front of each GRIB2 field,
 !> and writes them out to a new file. The output file is in the format
 !> required for TOC's FTP Input Service, which can be used to
-!> disseminate the GRIB2 bulletins. This service is described at
-!> http://weather.gov/tg/ftpingest.html.
+!> disseminate the GRIB2 bulletins. See [File Transfer Input Service
+!> Guide - Input examples and how to FTP files to the Gateway]
+!> (https://www.weather.gov/tg/ftpingest).
 !>
 !> @note The "EXTRACT" variable in the namelist allows users to choose
 !> whether they want the entire GRIB2 message containing the requested

utils/tocgrib2super.F90

@@ -3,14 +3,15 @@
 !> with WMO super header.
 !> @author Gilbert @date 2004-05-17
 
-!> This program reads selected GRIB2 fields from a file, adds a flag Field
-!> separator block and the size in bytes of the grib file, and the WMO
-!> super header and the time stamp, adds a TOC Flag Field separator
-!> block and WMO Header in front of each GRIB2 field, and writes them
-!> out to a new file. The output file is in the format required for
-!> TOC's FTP Input Service, which can be used to disseminate the GRIB2
-!> bulletins. This service is described at
-!> http://weather.gov/tg/ftpingest.html.
+!> This program reads selected GRIB2 fields from a file, adds a flag
+!> Field separator block and the size in bytes of the grib file, and
+!> the WMO super header and the time stamp, adds a TOC Flag Field
+!> separator block and WMO Header in front of each GRIB2 field, and
+!> writes them out to a new file. The output file is in the format
+!> required for TOC's FTP Input Service, which can be used to
+!> disseminate the GRIB2 bulletins. See [File Transfer Input Service
+!> Guide - Input examples and how to FTP files to the Gateway]
+!> (https://www.weather.gov/tg/ftpingest).
 !>
 !> @note The "EXTRACT" variable in the namelist allows users to choose
 !> whether they want the entire GRIB2 message containing the requested