CONFIGMELD

Compare two configs using a visual file comparison tool

Description:

This script uses a visual file comparison tool such as " meld" , to display two sets of configuration parameters, highlighting the differences between them. Each config may be supplied directly, as is done when running a SMURF command such as MAKEMAP, or can be read from the History component of an NDF that was created by a command that has a CONFIG parameter (such as SMURF:MAKEMAP).

Maps created using SKYLOOP contain configs for both SKYLOOP and MAKEMAP. By defaut, the MAKEMAP config will be displayed. To See the SKYLOOP config instead, run this script with " app=skyloop" .

Usage:

configmeld config1 config2 app waveband defaults tool

Parameters:

APP = LITERAL (Read)
The application for which configuration parameters should be displayed. Only used if CONFIG1 or CONFIG2 is an NDF [" MAKEMAP" ]
CONFIG1 = LITERAL (Read)
The first configuration. This can be a normal config such as is supplied for the CONFIG parameter of a SMURF application, or an NDF created by the application specified by parameter APP.
CONFIG2 = LITERAL (Read)
The second configuration. This can be a normal config such as is supplied for the CONFIG parameter of a SMURF application, or an NDF created by the application specified by parameter APP. If a value is supplied for PARAM, then CONFIG2 defaults to null (!). []
WAVEBAND = LITERAL (Read)
This parameter is not used if either CONFIG1 or CONFIG2 is an NDF created by a SMURF command. It should be one of " 450" or " 850" . It specifies which value should be displayed for configuration parameters that have separate values for 450 and 850 um. If either CONFIG1 or CONFIG2 is an NDF, then the wavebands to use are determined from the headers in the NDFs.
DEFAULTS = _LOGICAL (Read)
If TRUE, then each supplied configuration (CONFIG1 and CONFIG2) is extended to include default values for any config parameters that it does not specify. These defaults are read from the application s defaults file (e.g. " $SMURF_DIR/smurf_makemap.def" ). The dynamic default is TRUE if a defaults file can be found and FALSE otherwise. []
PARAM = LITERAL (Read)
If supplied, then the value used for the specified parameter is displayed on standard output, and no visual comparison is displayed. Separate values are displayed for CONFIG1 and (if supplied) CONFIG2. [!]
TOOL = LITERAL (Read)
Gives the name of the file comparison tool to use. The named command should be available on the current PATH. It should take the names of two files to compare as command line arguments. If null (!) is supplied, the first available tool in the following list is used:
  • meld: www.meldmerge.org

  • opendiff: developer.apple.com

  • diffmerge: www.sourcegear.com/diffmerge

  • kdiff3: kdiff3.sourceforge.net

  • tkdiff: sourceforge.net/projects/tkdiff

  • diffuse: diffuse.sourceforge.net

[!]