ndgCopyProv - Copy a Provenance structure, optionally removing any hidden ancestors

Description:

This function produces a deep copy of the supplied Provenance structure, and then optionally uses ndgRemoveProv to remove any hidden ancestors from the copy. A pointer to the copy is returned.

Invocation:

NdgProvenance $*$ndgCopyProv( NdgProvenance $*$prov, int cleanse, int $*$status )

Arguments:

prov

A pointer to the provenance information to be Copied.

cleanse

If non-zero, then any ancestors which have been hidden using ndgHideProv are removed from the returned Provenance structure (see ndgRemoveProv).

status

The global status.

Returned Value:

A pointer to the new Provenance structure, which should be freed

using ndgFreeProv when no longer needed.