This is the CDF V3.8.0 online software distribution directory for
Linux/Unix systems. The sub-incremental version is marked as "_#", e.g.,
_1, _2, etc, if it exists.  This directory contains the following files:

AAREADME.txt              This is the readme text file you're viewing.

Welcome.txt               Text describing what the main CDF distribution 
                          package, cdf38_0_#-dist-all.tar.gz contians.

Help_all.txt              Description of how to build the CDF package.

Help_test.txt             Description of how to test the build of the CDF package.

Help_install.txt          Description of how to install the build the CDF package.

CHANGES.txt               Description of the changes made for current and
                          previous releases.

Release.notes             Information about the current CDF release.

CDF_copyright.txt         Information about the CDF copyright.

cdf38_0_#-dist-all.tar.gz This file contains everything CDF offers except for 
                          the CDF Perl APIs, and it contains the following 
                          items:
 
                              - CDF library
                              - CDF C, FORTRAN, and Java APIs 
                              - C and Java version of the CDF tools
                              - CDF XML tools
                         
                          cdf38_0_#-dist-all.tar.gz is the combination of
                          cdf38_0_#-dist-cdf.tar.gz, 
                          cdf38_0_#-dist-java.tar.gz and
                          cdf38_0_#-dist-cdfj.tar.gz.

                          This file is compressed with the 'gzip' utility.

cdf38_0_#-dist-cdf.tar.gz This file contains the following items:
 
                              - CDF library
                              - CDF C and FORTRAN APIs
                              - C version of the CDF tools.

                          This file is compressed with the 'gzip' utility.

cdf38_0_#-dist-java.tar.gz This file contains the JNI-based Java APIs, tools,
                          (e.g. cdfedit, cdfexport, etc.) as well as CDF XML.
                          Download this file if you already have the CDF 
                          library installed on your machine and want to
                          develop CDF applications in Java or use the Java
                          version of the CDF tools. CDF library is needed to
                          run the JNI. The jar file is based on Java 1.6.

                          This file is compressed with the 'gzip' utility.

cdf38_0_#-dist-java_src.tar.gz
                          This file contains the JNI-based source code,
                          including the CDF Java APIs, Java version of the
                          tools (e.g. cdfedit, cdfexport, etc.) and CDF XML
                          tools. It contains the JNI that supports the CDF
                          Java APIs.  CDF library is needed to run the JNI.

cdf38_0_#-dist-cdfj_src.tar.gz
                          This file contains the source code for the pure
                          Java CDF APIs. 

                          This file is compressed with the 'gzip' utility.

cdfjava.jar               This is the latest version of JNI-based cdfjava.jar
                          that contains the latest Java APIs. This file is also
                          included in cdf38_0_#-dist-all.tar.gz and 
                          cdf38_0_#-dist-java.tar.gz. It should overwrite the
                          one in the distribution package if it has been
                          updated with a later date. For those who installed
                          the Java APIs of previous version, you can upgrade
                          it with this one.

                          If you are not sure whether you have the latest
                          version of the Java APIs, download this file and
                          replace the one you have in the 
                          <cdf38_0_dir>/cdfjava/classes directory. 

                          The latest version is multi-threaded safe. If you
                          encounter any problem using this version, you may 
                          need to recompile the JNI, cdfNativeLibrary.c, that 
                          is in cdfjava/jni directory in the (compressed) 
                          tarball, i.e., cdf38_0_#-dist-all.tar* or 
                          cdf38_0_#-dist-java.tar*.

cdfj.jar                  This is the latest version of Java cdfj.jar that 
                          contains the pure Java APIs for CDF read/write
                          without needing JNI and library. This file is also
                          included in cdf38_0_#-dist-all.tar.gz and 
                          cdf38_0_#-dist-java.tar.gz..

cdfml.jar                 This file contains the latest version of the CDF XML 
                          utilities (written in Java), and it contains the
                          following programs: 

                             CDF2CDFML: Extracts the contents of a CDF file
                                        into a XML file that conforms to the 
                                        CDF DTD or schema.
 
                             CDFML2CDF: Creates a CDF file from a XML file
                                        that conforms to the CDF DTD or 
                                        schema.  
 
                                        The XML parser, SAX, is required to run 
                                        this program.  Note that Sun's JDK 1.4  
                                        or a later version has a built-in XML 
                                        parser, so you don't need a separate
                                        XML parser run this program.
 
                          Note that this file is also included in 
                          cdf38_0_#-dist-all.tar.gz and
                          cdf38_0_#-dist-java.tar.gz, 
                          It should overwrite the one in the distribution
                          package if it has been updated with a later date.

                          If you are not sure whether you have the latest
                          version of the CDF XML tools, download this file and
                          replace the one you have in the 
                          <cdf38_0_dir>/cdfjava/cdfml directory. 

PerlCDF38_0.tar.gz        Compressed and tarred Perl-CDF APIs source file. You
                          need to install the CDF library prior to building
                          and using the Perl APIs.

cdf38_documentation       This file points to the documentation of CDF V3.8.0.

cdf.dtd                   This is CDFML's Document Type Definition (dtd).

cdf.xsd                   This is CDFML's schema.

testdtd.xml               This is sample XML that conforms to CDFML's DTD.

testxsd.xml               This is sample XML that conforms to CDFML's schema.

checkleapseconds.sh       Shell-script to check if the installed leap seconds
                          table is the latest.