Conary:cvc shadow

From rPath Wiki

A shadow is a copy of a trove to a specific Conary repository branch, and it is identified with the parent from which it was copied. Conary allows developers to merge changes from a parent when desired.

Identify a shadow and its parent in Conary by viewing the full version string of the shadow. This information is useful in tracking updates to a parent branch before merging them to the shadow.

Use cvc shadow to create a new shadow. The arguments for the command include the destination (label to which to shadow) followed by the parent trove.

To modify a package or group recipe:

1. Shadow its source component. Specify the revision to shadow if you need an earlier revision instead of the latest.
2. Check out the shadow and modify the recipe as needed.
3. Commit the changes to the shadow.

In this example, the developer shadows distro-release from conary.rpath.com@rpl:1:

$> cvc shadow example.rpath.org@corp:devel distro-release:source=conary.rpath.com@rpl:1

The developer then checks out the package to the local build environment to make the necessary modifications as part of adapting packages for a project or appliance. In group recipes, the developer includes the example package from the label example.rpath.org@corp:devel instead of including the package from its original label.

To undo a shadow, or go back to using the parent package instead of the shadow, change the shadowed package to a redirect package, instead, pointing to the parent branch. See Conary:Redirect Packages for more information.