Reorg comments

config/gnu-warnings/error-general

@@ -5,35 +5,49 @@
 -Werror=bad-function-cast
 -Werror=declaration-after-statement
 -Werror=implicit-function-declaration
+-Werror=missing-declarations
+-Werror=missing-prototypes
 -Werror=nested-externs
+-Werror=old-style-definition
 -Werror=packed
 -Werror=pointer-sign
 -Werror=pointer-to-int-cast
 -Werror=redundant-decls
+-Werror=strict-prototypes
 -Werror=switch
+#
 #-Werror=discarded-qualifiers
--Werror=missing-declarations
--Werror=missing-prototypes
+#
 #
 # NOTE: File Driver files are not compatible with these warnings as errors
 #     H5FDdirect.c,H5FDmpio.c,H5FDros3.c,
 #       -Werror=unused-function
+#
 -Wunused-function
+#
 #     H5FDdrvr_module.h
 #       -Werror=unused-variable
+#
 -Wunused-variable
+#
 #     H5VLpassthru.c
 #       -Werror=unused-parameter
+#
 -Wunused-parameter
 #
 #
+#
 # NOTE: Tools files are not compatible with these warnings as errors
 #     lib/h5tools.c
 #       -Werror=cast-align
+#
 -Wcast-align
+#
 #     lib/h5diff_array.c
 #       -Werror=unused-but-set-variable
+#
 -Wunused-but-set-variable
+#
 #     lib/h5tools_utils.c
 #       -Werror=unused-parameter
 #
@@ -44,9 +58,13 @@
 #       -Werror=cast-align
 #     jni/h5util.c
 #       -Werror=format(-overflow)
+#
 -Wformat
 #
 #
+#Examples and tests do not use the same set of extensive warning flags as libraries
+# Here is a list of tests and examples that have issues with the stricter warnings as error
+#
 # NOTE: Test files are not compatible with these warnings as errors
 #     thread_id.c,
 #       -Werror=unused-function
@@ -63,9 +81,9 @@
 #     h5_vds-percival-unlim.c,h5_crtatt.c,h5_group.c,h5_attribute.c,h5_crtdat.c
 #     h5_reference_deprec.c
 #     h5_rdwt.c,h5_crtgrp.c,h5_crtatt.c,h5_crtdat.c
--Werror=strict-prototypes
+#       -Werror=strict-prototypes
 #     h5_rdwt.c,h5_crtgrp.c,h5_crtatt.c,h5_crtdat.c
--Werror=old-style-definition
+#       -Werror=old-style-definition
 #     h5_vds-exclim.c,h5_vds.c,h5_vds-exc.c,
 #       -Werror=unused-variable
 #     h5_elink_unix2win.c,h5_extlink.c,h5_attribute.c