override

Name

override  --  override fetch-options for files or packages

Synopsis

override {pattern} [rev=revision] [root=url]

Description

override overrides fetch-options for all packages matching the glob pattern for subsequent calls to fetch(3) or functions that call fetch(3) (e.g. sub(3), include(3) etc).

Options

rev=revision

The revision of the file or package to override.

root=url

The repository root of the file or package to override.

Caveats

Glob patterns must be escaped so that they are not expanded by the shell before the call to override.

To override options for a file or package, override must be called with a pattern that matches the file or package before the file or package is supposed to be fetched by the script.

Examples

Override the revision of apps/init to fetch R1_3_0 instead of the revision specified later in the script (or in a file included later on):

    override apps/init rev=R1_3_0
    

Override repository root to be "http://packages.example.com" for all files and packages that begin with "packages/web/".

    override 'packages/web/*' root=http://packages.example.com
    

See Also

fetch(3), include(3), sub(3)