Merge pull request #2249 from DennisHeimbigner/updatedocs.dmh

Update selected documentation

RELEASE_NOTES.md

@@ -7,6 +7,7 @@ This file contains a high-level description of this package's evolution. Release
 
 ## 4.8.2 - TBD
 
+* [Enhancement] Update the documentation to match the current filter capabilities  See [Github #2249](https://github.com/Unidata/netcdf-c/pull/2249).
 * [Enhancement] Support installation of pre-built standard filters into user-specified location. See [Github #2318](https://github.com/Unidata/netcdf-c/pull/2318).
 * [Enhancement] Improve filter support. More specifically (1) add nc_inq_filter_avail to check if a filter is available, (2) add the notion of standard filters, (3) cleanup szip support to fix interaction with NCZarr. See [Github #2245](https://github.com/Unidata/netcdf-c/pull/2245).
 * [Enhancement] Switch to tinyxml2 as the default xml parser implementation. See [Github #2170](https://github.com/Unidata/netcdf-c/pull/2170).

docs/Doxyfile.in

@@ -754,7 +754,8 @@ INPUT = \
     @abs_top_srcdir@/docs/COPYRIGHT.md \
     @abs_top_srcdir@/docs/credits.md \
     @abs_top_srcdir@/docs/tutorial.dox \
-    @abs_top_srcdir@/docs/internal.dox \
+    @abs_top_srcdir@/docs/internal.md \
+    @abs_top_srcdir@/docs/dispatch.md \
     @abs_top_srcdir@/docs/inmeminternal.dox \
     @abs_top_srcdir@/docs/indexing.dox \
     @abs_top_srcdir@/docs/testserver.dox \

docs/FAQ.md

@@ -1079,9 +1079,22 @@ and writable by programs that used older versions of the libraries.
 However, programs linked to older library versions will not be able to
 create new data objects with the new less-restrictive names.
 
-How difficult is it to convert my application to handle arbitrary netCDF-4 files? {#How-difficult-is-it-to-convert-my-application-to-handle-arbitrary-netCDF-4-files}
+Can I use UTF-8 File Names with Windows? {#Can-I-use-UTF-8-File-Names-with-Windows}
 -----------------
 
+Starting with Windows 10 build 17134, Windows can support use of
+the UTF-8 character set. We strongly encourage Windows users to
+enable this feature. This requires the following steps.
+
+1. In the "run" toolbar, execute the command "intl.cpl".
+2. Move to the Administrative tab.
+3. Move to "Change system locale"
+4. Check the box at the bottom labeled something like
+"Beta: Use Unicode UTF-8 for worldwide language support"
+
+
+How difficult is it to convert my application to handle arbitrary netCDF-4 files? {#How-difficult-is-it-to-convert-my-application-to-handle-arbitrary-netCDF-4-files}
+-----------------
 
 Modifying an application to fully support the new enhanced data model
 may be relatively easy or arbitrarily difficult :-), depending on what

docs/Makefile.am

@@ -9,7 +9,7 @@
 # These files will be included with the dist.
 EXTRA_DIST = netcdf.m4 DoxygenLayout.xml Doxyfile.in footer.html	\
 mainpage.dox tutorial.dox			\
-architecture.dox internal.dox windows-binaries.md			\
+architecture.dox internal.md windows-binaries.md dispatch.md \
 building-with-cmake.md CMakeLists.txt groups.dox notes.md	\
 install-fortran.md all-error-codes.md credits.md auth.md filters.md \
 obsolete/fan_utils.html indexing.dox	\