netcdf-c/docs
Dennis Heimbigner 2ea1cf5f1b There was a request to extend the provenance information
stored in the _NCProperties attribute to allow two things:
1. capture of additional library dependencies (over and above
   hdf5)
2. Recognition of non-netcdf libraries that create netcdf-4 format
   files.

To this end, the _NCProperties format has been extended to be
and arbitrary set of key=value pairs separated by commas.
This new format has version = 2, and uses commas as the pair separator.
Thus the general form is:
    _NCProperties = "version=2,key1=value,key2=value2..." ;

This new version is accompanied by a new ./configure option of the form
    --with-ncproperties="key1=value1,key2=value2..."
that specifies pairs to add to the _NCProperties attribute for all
files created with that netcdf library.

At this point, what is missing is some programmatic way to
specify either all the pairs or additional pairs
to the _NCProperties attribute. Not sure of the best way
to do this.

Builders using non-netcdf libraries can specify
whatever they want in the key value pairs (as long
as the version=2 is specified first).

By convention, the primary library is expected to be the
the first pair after the leading version=2 pair, but this
is convention only and is neither required nor enforced.

Related changes:
1. Fixed the tests that check _NCProperties to properly operate with version=2.
2. When reading a version 1 _NCProperties attribute, convert it to look
   like a version 2 attribute.
2. Added some version 2 tests to ncdump/tst_fileinfo.c and
   ncdump/tst_fileinfo.sh

Misc Changes:
1. Fix minor problem in ncdap_test/testurl.sh where a parameter to
   buildurl needed to be quoted.
2. Minor fix to ncgen to swap switches -H and -h to be consistent
   with other utilities.
3. Document the -M flag in nccopy usage() and the nccopy man page.
4. Modify a test case to use the nccopy -M flag.
2018-08-25 21:44:41 -06:00
..
images Cleaned up Makefile.am 2014-12-05 15:14:40 -07:00
obsolete Misc. source comment typos 2018-04-26 23:04:01 -04:00
old Misc. source comment typos 2018-04-26 23:04:01 -04:00
static-pages Merge remote-tracking branch 'origin/sftlist.dmh' into pr-consolidate.wif 2018-05-08 11:12:07 -06:00
.gitignore Fix up documentation to replace old auth documentation 2017-08-20 18:27:48 -06:00
all-error-codes.md introduce error code NC_EPNETCDF for errors at PnetCDF level 2018-07-29 15:33:08 -05:00
architecture.dox Reorganization of user guide documentation. Moved accessing opendap data page to sit within the users guide dap-support section. 2015-03-12 12:58:57 -06:00
attribute_conventions.md There was a request to extend the provenance information 2018-08-25 21:44:41 -06:00
auth.html Misc. source comment typos 2018-04-26 23:04:01 -04:00
auth.md The pr does some cleanup on the internal documentation 2018-06-29 15:06:27 -06:00
bestpractices.md Cleaned up best practices document. 2016-05-09 20:42:35 -06:00
building-with-cmake.md Updated documentation to reflect minimum cmake version of 2.8.12. 2014-07-29 14:53:12 -06:00
cdl.dox Misc. source comment typos 2018-04-26 23:04:01 -04:00
CMakeLists.txt fixed make clean in docs 2018-06-05 11:30:59 -06:00
COPYRIGHT.dox Reorganized Copyright file, removed some improper references. 2014-12-08 13:13:08 -07:00
credits.md Additional dead link modification. 2016-01-15 14:39:32 -07:00
DAP4.dox Add initial DAP4 documentation 2017-04-06 10:06:32 -06:00
dispatch.dox Renamed man4 directory to docs. 2014-05-21 14:40:39 -06:00
docmap.pdf The 'Credits' page is now a generated document distributed with netcdf, even though the contents are static. It is currently included as a subpage underneath the NetCDF Overview page. Also, renamed 'Credits' on the Overview page to 'About NetCDF'. 2014-12-10 11:14:43 -07:00
Doxyfile.developer Misc. source comment typos 2018-04-26 23:04:01 -04:00
Doxyfile.in Doxygen is apparently buggy when trying to combine a markdown 2018-07-01 21:56:59 -06:00
DoxygenLayout.xml Further reorganization. Figured out how subpage works with different files. Renamed some of the header cells. 2014-12-09 16:36:15 -07:00
esg.md More doxygen tweaks. 2016-01-15 12:23:56 -07:00
FAQ.md add missing note about CDF-5 format 2018-07-05 22:54:41 -05:00
file_format_specifications.md Misc. source comment typos 2018-04-26 23:04:01 -04:00
filters.md master merge 2018-05-03 21:02:12 -06:00
footer.html Fix pull request https://github.com/Unidata/netcdf-c/pull/374 (dap4.dmh) 2017-04-03 21:39:44 -06:00
groups.dox Renamed man4 directory to docs. 2014-05-21 14:40:39 -06:00
guide.dox add missing note about CDF-5 format 2018-07-05 22:54:41 -05:00
header.html Renamed man4 directory to docs. 2014-05-21 14:40:39 -06:00
indexing.dox The pr does some cleanup on the internal documentation 2018-06-29 15:06:27 -06:00
inmemory.md re: esupport MQO-415619 2018-02-25 21:45:31 -07:00
install-fortran.md Fix doxygen list 2015-06-08 10:20:50 -06:00
install.md Typo 2018-07-13 11:41:57 -06:00
internal.dox The pr does some cleanup on the internal documentation 2018-06-29 15:06:27 -06:00
known_problems.md Rolled known problems into generated documentation, and cleaning up broken links. 2015-09-23 13:49:06 -06:00
mainpage.dox Corrected links to cdash dashboard. 2017-12-20 12:37:02 -07:00
Makefile.am fixed make clean in docs 2018-06-05 11:30:59 -06:00
netcdf-50x50.png Renamed man4 directory to docs. 2014-05-21 14:40:39 -06:00
netcdf.m4 Fix spelling errors. 2016-08-28 15:45:36 +02:00
notes.md More document reorganization. 2015-03-15 15:29:58 -06:00
OPeNDAP.dox Merge branch 'master' into dapparams.dmh 2018-05-16 14:34:28 -06:00
release_header.html Added release to release header. 2016-11-21 11:23:02 -07:00
release.css Tweaks to css 2016-01-21 11:19:23 -07:00
tests.md Added a document to catalog what the various tests are. 2016-06-06 14:51:57 -06:00
testserver.dox Doxygen is apparently buggy when trying to combine a markdown 2018-07-01 21:56:59 -06:00
tutorial.dox Merge branch 'master' into var_par_access 2018-07-26 01:35:39 -05:00
types.dox add missing note about CDF-5 format 2018-07-05 22:54:41 -05:00
unidata_logo_cmyk.png Renamed man4 directory to docs. 2014-05-21 14:40:39 -06:00
user_defined_formats.md Add warning about user formats 2018-07-13 11:47:58 -06:00
windows-binaries.md Corrected an incorrect download link for Windows NC3-only binary 2017-11-20 13:43:16 -07:00