$Header$ -*-text-*-

This file enumerates the files in the NCO distribution and, where
appropriate, describes the purpose of the file.
Files with a (v) indicator are volatile
Volatile files are created automatically (e.g., by invoking
./configure) and may not be present in pristine source trees.

Top-level files:
AUTHORS		Whom to praise and blame
CITATION	How and why to cite NCO in your work
COPYING		GNU General Public License GPL3
COPYRIGHT	Copyright information
INSTALL		Boilerplate instructions for ./configure
LICENSE		License details
acinclude.m4	NCO M4 macro definitions used by aclocal to generate aclocal.m4
aclocal.m4	M4 macros generated from acinclude.m4 by aclocal
autogen.sh	Gather all autotools necessary to run autoconf
config.h.in(v)	Template header file generated from configure.ac by autoheader
config.h	NCO header file generated from configure.ac by autoconf
config.guess(v)
config.log(v)
config.status(v)
config.sub(v)
configure.eg	Example ./configure invocations by architecture and compiler
configure.ac	Template used by autoconf to generate configure script
configure	NCO configuration script generated by autoconf from configure.ac
conftest(v)	Directory used by configure to perform tests
libtool(v)
Makefile	Top-level Makefile created by configure from Makefile.in
Makefile.am	NCO directory structure used by automake to create Makefile.in
Makefile.in	Makefile template created from Makefile.am by automake and used by autoconf
README.md	GitHub Repository description in markdown format
stamp-h1(v)	Time-stamp
.gitignore	Git ignore
.travis.yml	Travis automated test-builds

Top-level directories:
nco/autobld	Files related to and used by autotools: autoconf/automake/autolib
nco/bin		Binary directory for NCO binary executable
nco/bld		Build directory for Makefile and ancillary scripts
nco/bm		Benchmark directory and related plot scripts
nco/debian	Scripts for Debian GNU/Linux .deb builds
nco/data	Sample I/O datasets
nco/doc		Documentation and logos
nco/m4		M4 macros for libtool
nco/man		Man pages
nco/obj		Object files
nco/qt		Qt and Visual Studio project files
nco/src		Source files

Autotools directory:
nco/autobld/compile	Wrapper for compilers which do not understand '-c -o'
nco/autobld/fxm		Many files need documentation here
(nco/autobld/mdate-sh)	(Formerly needed by TeXInfo for version.texi, could be installed by automake --add-missing)

Binary directory:
nco/bin/README		Description of binary directory

Benchmark directory:
nco/bm/gcm_T85.cdl	   CDL template files for ncgen
nco/bm/tms_lng.cdl	   CDL template files for ncgen
nco/bm/stl_5km.cdl	   CDL template files for ncgen
nco/bm/nco_bm.pl	   Core perl app that calls rest of BM pieces
nco/bm/nco_bm_benchmarks.pl Benchmark tests
nco/bm/nco_bm_md5wc_tbl.pl  Hash table for MD5 and wc values
nco/bm/NCO_bm.pm            Common code for nco_bm.pl
nco/bm/NCO_rgr.pm           Regression tests.
nco/bm/mk_bm_plots.pl       Perl script to autoplot benchmark data
nco/bm/nco_bm.sh            Script to run nco_bm.pl for various platforms

Build directory:
nco/bld/Makefile	Hand-crafted Makefile to create NCO executables
nco/bld/nco_dst.pl	Perl script to build NCO distributions
nco/bld/pbuilder-sid	Use pbuilder to build NCO in a chroot environment
nco/bld/pvmgetarch	Script used by Makefile to determine native machine type
nco/bld/libnco_c++_tst.cc Simplest front end to exercise libnco_c++.a
nco/bld/libnco_tst.c	Simplest front end to exercise libnco.a

Data Directory:
nco/data/Makefile(v)	Autotools-generated Makefile
nco/data/Makefile.am	Automake instructions
nco/data/Makefile.in(v)	Autotools-generated Makefile
nco/data/big.cdl 	CDL file to test huge netCDF files
nco/data/bin_cnt.nco 	ncap2 sample script that bins wind speeds
nco/data/cf2.cdl 	CDL file to test CF group extensions
nco/data/cmip5.cdl 	CDL file to test ncbo functionality on groups
nco/data/cnk.cdl 	CDL file to test chunking
nco/data/ddra.nco	Sample ncap2 script that computes DDRA statistics
nco/data/dsm.cdl 	CDL file to test ncdismember
nco/data/hdn.cdl 	CDL file to test hidden attributes
nco/data/hdr_pad.sh	Utility to check size of metadata header
nco/data/in.cdl 	CDL file to generate netCDF test file in.nc
nco/data/in_1.cdl 	CDL file to test 2 input file operators
nco/data/in_2.cdl 	CDL file to test 2 input file operators
nco/data/in_4.cdl 	CDL file to generate netCDF4 test file in_4.nc
nco/data/in_grp.cdl 	CDL file to test netCDF4 group functionality
nco/data/in_grp_1.cdl 	CDL file to test ncbo functionality on groups
nco/data/in_grp_2.cdl 	CDL file to test ncbo functionality on groups
nco/data/in_grp_3.cdl 	CDL file to test ncbo functionality on groups
nco/data/in_grp_4.cdl 	CDL file to test ncbo functionality on groups
nco/data/in_grp_5.cdl 	CDL file to test ncbo functionality on groups
nco/data/in_grp_6.cdl 	CDL file to test ncbo functionality on groups
nco/data/in_grp_7.cdl 	CDL file to test ncbo functionality on groups
nco/data/in_rec_zero.cdl 	CDL file to test zero-record files
nco/data/mdl_1.cdl 	CDL file to test ensemble operations
nco/data/mdl_2.cdl 	CDL file to test ensemble operations
nco/data/mrd.cdl 	CDL file to test multiple record dimensions
nco/data/ncap.in	Sample ncap input script
nco/data/ncap.in2	ncap script to demonstrate #include capabilities
nco/data/ncap2.in	Sample ncap2 input script
nco/data/ncap2_tst.nco  ncap2 self-printing test script
nco/data/ncl.ncl	NCL script to compare to NCO scripts for speed
nco/data/nco_bnch.sh	Old (deprecated) NCO benchmark script
nco/data/ncclimo	ncclimo operator
nco/data/ncremap	ncremap operator
nco/data/netcdf4.nco	Sample input script for netCDF4-enabled ncap2
nco/data/obs.cdl 	CDL file to test group broadcasting
nco/data/psd.nco	Sample ncap2 script that computes particle size distributions
nco/data/psd_wrf.nco	Sample ncap2 script that computes WRF particle size distributions
nco/data/sld_nco.sh	NCO script to process (regrid) Swath-Like Data (SLD)
nco/data/swamp.sh	Demonstrate SWAMP usage
nco/data/tst.nco	Sample ncap script that computes geophysical quantities
nco/data/udunits.dat	UDUnits database for Debian compatibility
nco/data/xmp_500mb_hgt.nco ncap2 script to compute 500 mb height field

Documentation directory:
nco/doc/ANNOUNCE	Announcement to accompany release notifications
nco/doc/ChangeLog	Chronological log of NCO changes
nco/doc/LICENSE		License and legal information
nco/doc/MANIFEST	This file. Describes all files in distribution
nco/doc/README		Description of NCO
nco/doc/README_Fedora	Short instructions for Fedora users
nco/doc/TAG		CVS tag for this version 
nco/doc/TODO		List of tasks for future releases
nco/doc/VERSION		NCO version 
nco/doc/beta.txt	Availability of beta- or pre-release Debian packages
nco/doc/build_hints.shtml Hints to build from source
nco/doc/debian.txt	Creating and updating Debian NCO .deb packages
nco/doc/dir		Example Info file to load nco.info
nco/doc/dods.sh		Install OPeNDAP 3.4.X for NCO DAP-enabled clients
nco/doc/doe.jpg		DOE logo (JPG format)
nco/doc/endorsements.txt Statements of support for NCO
nco/doc/help.txt	Advertisement for help with NCO (outdated---from 2000)
nco/doc/highlights_old.shtml Short summaries of old releases
nco/doc/index.shtml	Website homepage
nco/doc/logo_srl.png	Spiral logo PNG raster format
nco/doc/logo_srl.svg	Spiral logo Scalable Vector Graphic format
nco/doc/logo_srl.xcf	Spiral logo GIMP format
nco/doc/milestones_old.shtml Milestones in old releases
nco/doc/mpi.txt		MPI Environments for NCO
nco/doc/my-bib-macros.texi TeXInfo bibliography macros for nco.texi
nco/doc/nasa.png	NASA logo (PNG format)
nco/doc/ncap.txt	Description of the ncap operator (not yet used)
nco/doc/nco.dvi(v)	User's Guide: DVI format
nco/doc/nco.html(v)	User's Guide: HTML format
nco/doc/nco.info(v)	User's Guide: Info format
nco/doc/nco.pdf(v)	User's Guide: Portable Document Format
nco/doc/nco.png		Webpage icon (PNG format)
nco/doc/nco.ps(v)	User's Guide: Postscript format
nco/doc/nco.texi	User's Guide: TeXInfo format
nco/doc/nco_news.shtml	News archive
nco/doc/nco_rfr_crd.pdf(v) Quick Reference Card
nco/doc/netcdf.h.3.6.3	Version 3.6.X of netcdf.h for backward compatibility
nco/doc/netcdf4.sh	Install latest netcdf4 and HDF libraries for NCO
nco/doc/nsf.png		NSF logo (PNG format)
nco/doc/opendap.sh	Install OPeNDAP 3.5.X for NCO DAP-enabled clients
nco/doc/problems_old.shtml Summaries of old bugs
nco/doc/surfit.txt	Summer research project advertisement for UCI
nco/doc/tags_doc.sh	Generate Emacs tags for all NCO documents
nco/doc/valgrind.txt	Valgrind suppressions file for debugging NCO 

Man-page Directory:
nco/man/Makefile(v)	Autotools-generated Makefile
nco/man/Makefile.am	Automake instructions
nco/man/Makefile.in(v)	Autotools-generated Makefile
nco/man/ncap.1		ncap man page
nco/man/ncatted.1	ncatted man page
nco/man/ncbo.1		ncbo man page
nco/man/ncclimo.1	ncclimo man page
nco/man/nces.1		nces man page
nco/man/ncecat.1	ncecat man page
nco/man/ncflint.1	ncflint man page
nco/man/ncks.1		ncks man page
nco/man/nco.1		NCO man page
nco/man/ncpdq.1		ncpdq man page
nco/man/ncra.1		ncra man page
nco/man/ncrcat.1	ncrcat man page
nco/man/ncremap.1	ncremap man page
nco/man/ncrename.1	ncrename man page
nco/man/ncwa.1		ncwa man page

Object directory:
nco/obj/README		Description of object directory

Portable Object Template directory:
nco/po/nco.pot		Portable Object Template file for NCO

Portable Object Spanish directory:
nco/po/es/nco.po	Portable Object Spanish translations for NCO

Portable Object French directory:
nco/po/fr/nco.po	Portable Object French translations for NCO

Source code directories:
nco/src/nco		Source for base NCO library and operators
nco/src/nco_c++		Source for libnco_c++ C++ interface to netCDF API
nco/src/nco++		Source for NCO C++ operators (ncap2) and libnco++

NCO base library and operators source directory:
nco/src/nco/Makefile(v)		Autotools-generated Makefile
nco/src/nco/Makefile.am		Automake instructions
nco/src/nco/Makefile.in(v)	Autotools-generated Makefile
nco/src/nco/libnco.h		All-inclusive libnco header
nco/src/nco/mpncbo.c		mpncbo main() MPI-enabled
nco/src/nco/mpncecat.c		mpncecat main() MPI-enabled
nco/src/nco/mpncflint.c		mpncflint main() MPI-enabled
nco/src/nco/mpncpdq.c		mpncpdq main() MPI-enabled
nco/src/nco/mpncra.c		mpncra/mpnces/mpncrcat main() MPI-enabled
nco/src/nco/mpncwa.c		mpncwa main() MPI-enabled
nco/src/nco/ncap.c		ncap main() MPI-enabled
nco/src/nco/ncap.h
nco/src/nco/ncap_lex.c(v)	Generated by ncap_lex.l
nco/src/nco/ncap_lex.l
nco/src/nco/ncap_utl.c
nco/src/nco/ncap_yacc.c(v)	Generated by ncap_yacc.y
nco/src/nco/ncap_yacc.y
nco/src/nco/ncatted.c		ncatted main()
nco/src/nco/ncbo.c		ncbo main()
nco/src/nco/ncecat.c		ncecat main()
nco/src/nco/ncflint.c		ncflint main()
nco/src/nco/ncks.c		ncks main()
nco/src/nco/nco.h		NCO library low-level header
nco/src/nco/nco_att_utl.c
nco/src/nco/nco_att_utl.h
nco/src/nco/nco_aux.c
nco/src/nco/nco_aux.h
nco/src/nco/nco_bnr.c
nco/src/nco/nco_bnr.h
nco/src/nco/nco_cln_utl.c
nco/src/nco/nco_cln_utl.h
nco/src/nco/nco_cnf_dmn.c
nco/src/nco/nco_cnf_dmn.h
nco/src/nco/nco_cnf_typ.c
nco/src/nco/nco_cnf_typ.h
nco/src/nco/nco_cnk.h
nco/src/nco/nco_cnk.c
nco/src/nco/nco_cnv_arm.c
nco/src/nco/nco_cnv_arm.h
nco/src/nco/nco_cnv_csm.c
nco/src/nco/nco_cnv_csm.h
nco/src/nco/nco_ctl.c
nco/src/nco/nco_ctl.h
nco/src/nco/nco_dbg.c
nco/src/nco/nco_dbg.h
nco/src/nco/nco_dmn_utl.c
nco/src/nco/nco_dmn_utl.h
nco/src/nco/nco_fl_utl.c
nco/src/nco/nco_fl_utl.h
nco/src/nco/nco_getopt.c
nco/src/nco/nco_getopt.h
nco/src/nco/nco_grp_trv.c
nco/src/nco/nco_grp_trv.h
nco/src/nco/nco_grp_utl.c
nco/src/nco/nco_grp_utl.h
nco/src/nco/nco_lmt.c
nco/src/nco/nco_lmt.h
nco/src/nco/nco_lst_utl.c
nco/src/nco/nco_lst_utl.h
nco/src/nco/nco_md5.h
nco/src/nco/nco_md5.c
nco/src/nco/nco_mmr.c
nco/src/nco/nco_mmr.h
nco/src/nco/nco_mpi.h
nco/src/nco/nco_msa.c
nco/src/nco/nco_msa.h
nco/src/nco/nco_mss_val.c
nco/src/nco/nco_mss_val.h
nco/src/nco/nco_netcdf.c	NCO-independent C wrappers for libnetcdf
nco/src/nco/nco_netcdf.h	NCO-independent C wrappers for libnetcdf
nco/src/nco/nco_omp.c
nco/src/nco/nco_omp.h
nco/src/nco/nco_pck.c
nco/src/nco/nco_pck.h
nco/src/nco/nco_ppc.c
nco/src/nco/nco_ppc.h
nco/src/nco/nco_prn.c
nco/src/nco/nco_prn.h
nco/src/nco/nco_rec_var.c
nco/src/nco/nco_rec_var.h
nco/src/nco/nco_rgr.c
nco/src/nco/nco_rgr.h
nco/src/nco/nco_rth_flt.c
nco/src/nco/nco_rth_flt.h
nco/src/nco/nco_rth_utl.c
nco/src/nco/nco_rth_utl.h
nco/src/nco/nco_scl_utl.c
nco/src/nco/nco_scl_utl.h
nco/src/nco/nco_scm.c
nco/src/nco/nco_scm.h
nco/src/nco/nco_sld.c
nco/src/nco/nco_sld.h
nco/src/nco/nco_sng_utl.c
nco/src/nco/nco_sng_utl.h
nco/src/nco/nco_srm.c
nco/src/nco/nco_srm.h
nco/src/nco/nco_typ.h
nco/src/nco/nco_uthash.h
nco/src/nco/nco_var_avg.c
nco/src/nco/nco_var_avg.h
nco/src/nco/nco_var_lst.c
nco/src/nco/nco_var_lst.h
nco/src/nco/nco_var_rth.c
nco/src/nco/nco_var_rth.h
nco/src/nco/nco_var_scv.c
nco/src/nco/nco_var_scv.h
nco/src/nco/nco_var_utl.c
nco/src/nco/nco_var_utl.h
nco/src/nco/ncra.c		ncra/nces/ncrcat main()
nco/src/nco/ncrename.c		ncrename main()
nco/src/nco/ncwa.c		ncwa main()

NCO C++ interface to netCDF directory:
nco/src/nco_c++/ChangeLog
nco/src/nco_c++/INSTALL
nco/src/nco_c++/Makefile(v)	Autotools-generated Makefile
nco/src/nco_c++/Makefile.am	Automake instructions
nco/src/nco_c++/Makefile.in(v)	Autotools-generated Makefile
nco/src/nco_c++/Makefile.old	Hand-edited Makefile for developers
nco/src/nco_c++/README
nco/src/nco_c++/TODO
nco/src/nco_c++/tst.cc		Front-end program to test libnco_c++
nco/src/nco_c++/libnco_c++.hh	All-inclusive libnco_c++ header
nco/src/nco_c++/nco_att.cc	C++ wrappers for libnetcdf attribute routines
nco/src/nco_c++/nco_att.hh	C++ wrappers for libnetcdf attribute routines
nco/src/nco_c++/nco_dmn.cc	C++ wrappers for libnetcdf dimension routines
nco/src/nco_c++/nco_dmn.hh	C++ wrappers for libnetcdf dimension routines
nco/src/nco_c++/nco_fl.cc	C++ wrappers for libnetcdf file routines
nco/src/nco_c++/nco_fl.hh	C++ wrappers for libnetcdf file routines
nco/src/nco_c++/nco_hgh.cc	High-level C++ routines to control libnco_c++
nco/src/nco_c++/nco_hgh.hh	High-level C++ routines to control libnco_c++
nco/src/nco_c++/nco_utl.cc	Low-level C++ routines used by libnco_c++
nco/src/nco_c++/nco_utl.hh	Low-level C++ routines used by libnco_c++
nco/src/nco_c++/nco_var.cc	C++ wrappers for libnetcdf variable routines
nco/src/nco_c++/nco_var.hh	C++ wrappers for libnetcdf variable routines

NCO C++ operators (ncap2) and libnco++ directory:
nco/src/nco++/Makefile(v)	Autotools-generated Makefile
nco/src/nco++/Makefile.am	Automake instructions
nco/src/nco++/Makefile.in(v)	Autotools-generated Makefile
nco/src/nco++/Makefile.old	Hand-edited Makefile for developers
nco/src/nco++/Invoke.cc
nco/src/nco++/libnco++.hh	All-inclusive libnco++ header
nco/src/nco++/ncap2.cc		ncap2 main()
nco/src/nco++/ncap2.hh
nco/src/nco++/Ncap2.hh
nco/src/nco++/ncap2_utl.cc
nco/src/nco++/NcapVar.cc
nco/src/nco++/NcapVar.hh
nco/src/nco++/NcapVarVector.cc
nco/src/nco++/NcapVarVector.hh
nco/src/nco++/NcapVector.hh
nco/src/nco++/ncoGrammer.g	ncap2 ANTLR grammer
nco/src/nco++/ncoLexer.cpp(v)
nco/src/nco++/ncoLexer.hpp(v)
nco/src/nco++/ncoParser.cpp(v)
nco/src/nco++/ncoParser.hpp(v)
nco/src/nco++/ncoParserTokenTypes.hpp(v)
nco/src/nco++/ncoParserTokenTypes.txt
nco/src/nco++/ncoEnumTokenTypes.hpp(v) Derived from ncoParserTokenTypes.hpp
nco/src/nco++/ncoTree.cpp(v)
nco/src/nco++/ncoTree.hpp(v)
nco/src/nco++/nco_antlr_pst_prc.pl Perl script to post-process ANTLR files
nco/src/nco++/sdo_utl.cc	Stand-alone C++ utilities C++ code
nco/src/nco++/sdo_utl.hh	Stand-alone C++ utilities header, templates
nco/src/nco++/VarOp.hh
