ndgPutProv - Add an NDF to the list of ancestors

Description:

This function modifies the supplied provenance structure to indicate that a given NDF was used in the creation of the NDF associated with the supplied provenance structure.

Invocation:

ndgPutProv( NdgProvenance $*$prov, int indf, HDSLoc $*$more, AstKeyMap $*$more2, int isroot, int $*$status )

Arguments:

prov

An identifier for a structure holding the provenance information read from an NDF, as returned by ndgReadProv

indf

An identifier for an NDF that is to be added into the list of ancestor NDFs in the supplied provenance information.

more

A locator for an HDS structure containing arbitrary additional information about the new ancestor NDF, and how it was used in the creation of the output NDF. A NULL pointer can be supplied if required.

more2

A pointer to an AstKeyMap holding extra items of information to be added into the MORE component. Only entries holding primitive data values (scalar or vector) are used - entries holding nested KeyMaps, etc, are ignored. If an entry in this KeyMap has the same name as a component in the supplied "more" HDS structure, then the KeyMap value is used in preference to the HDS value. A NULL pointer can be supplied if required.

isroot

If non-zero, then the new ancestor NDF will be treated as a root NDF. That is, any provenance information in the supplied NDF is ignored. If zero, then any provenance information in the NDF is copied into the supplied provenance structure. The new ancestor NDF is then only a root NDF if it contains no provenance information.

status

The global status.