============================================
Nagg version 1.2.0 released on 2012-05-31.
============================================

1. Introduction
===============

This document describes the NPP Aggregation tool, nagg, and contains
information on platforms tested, changes since last release and any known
problems.

If you have any questions or comments, please send them to:
    help@hdfgroup.org


2. Platforms Tested
===================
Linux 2.6 32bit and 64bits with gcc 4.1.2 and icc 12.0.4


3. New features and bug fixes since Version 1.1.1
=================================================
    Configuration
    -------------
    - None
    
    Features
    --------
    - Added dump option TOOLTEST in testnagg.sh so that it dumps the output
      files produced by the Nagg tool and verify the granules are as expected.
      (AKC 2012/05/30)

    - A user document, "NPP Aggregation Tool for JPSS Product Files (nagg)",
      is composed to explain the purpose of the Nagg tool and the procedure of
      building the tool, plus examples of using the tool. It is available in
      the doc directory as "nagg-User-Examples" in both Word and PDF formats.
      (LRK 2012/05/30).

    - The limit of the maximum number of granules that can be managed by the
      Nagg tool is increased from 7000 to 10000. (AKC 2012/05/22).

    - Added new test script called, testnagg_more.sh, which tests cases that
      require more resources such as big number of input files, long
      execution time, more disk spaces, etc.  This test will run only if 
      the extra test input files are present and the environment variable,
      NAGG_TESST_MORE, is defined. This test is intended for The HDF Group staff
      internal testing, therefore the extra test input files are not included
      in the source code distribution.  (AKC 2012/05/22)

    - Improve the testing by adding features to verify if the output generated
      matches the expected output. (AKC 2012/05/16)

    - Added the --debug option which, when given, prints all the granules in
      all input files. This includes fill granules plus geolocation granules
      if asked for.  It only reads and prints granules in the input files and
      does not do any further processing. (AKC 2012/05/10)
      
    Bug Fixes
    ---------
    - When there were more granules than the limit of maximum number of
      granules, the Nagg tool would ended in segmentation fault. It is fixed
      that the tool would report the limit exceeded and exit with a non-zero
      code. (AKC 2012/05/22).

    - There was a bug that would write duplicated granules of the same Granule
      and Product ID but different versions.  Now only the granule of the latest
      version is written. Other granules of earlier versions are filtered.
      (AKC 2012/05/22).

    - Testing with larger numbers of granules after the input file limit was 
      removed revealed several missing calls to H5Fclose, H5Gclose, and H5Dclose 
      that resulted in failure to open files due to too many open files.  The 
      missing calls to close objects have been added. (LRK 2012/05/18)   

    - Removed the limit of maximum number of input files (was 100).  Now if
      the user can specify the input files on the command line, Nagg will
      accept them all. (AKC 2012/05/18).

    Limits
    ------
    - See nagg.docx (html, pdf) in the same directory for proposed functionality.
    Current release has the following limitations: 
       * Environment variables or command line options for compliance 
         with file naming convention presume valid types and packaging as
	 defined in the "nagg.h" file.
       * Grouping by time rather than number of granules (-A flag) is not
         supported (e.g., 7 minute 59 second granules starting at a given time
	 rather than just at the earliest granule encountered.)
       * Warnings or failures if granule gaps exceed some threshold are not
         supported.
       * Compression on output is not supported.
       * Options to choose repair granule are not supported; for now, the one
         with the latest version is used.
       * Option to replace existing granule with repair granule is not
         supported.  
       * Restrictions on flags and input parameters:
            Directory input is not supported.
           -l - not supported
           -A - not supported
           -d - not suported

      
4. Known problems
=================
    Output file names generated do not have the product IDs appeared in sorted
    order. (AKC 2012/04/09).

    -d option is accepted but is not supported, that is, has no effect.
    (AKC 2012/3/29).