# narrow

Contents

- Commands
  - Repository maintenance

create clones which fetch history data for subset of files (EXPERIMENTAL)

# Commands

## Repository maintenance

### tracked

show or change the current narrowspec:

    hg tracked [OPTIONS]... [REMOTE]

With no argument, shows the current narrowspec entries, one per line. Each line will be prefixed with 'I' or 'X' for included or excluded patterns, respectively.

The narrowspec is comprised of expressions to match remote files and/or directories that should be pulled into your client. The narrowspec has include and exclude expressions, with excludes always trumping includes: that is, if a file matches an exclude expression, it will be excluded even if it also matches an include expression. Excluding files that were never included has no effect.

Each included or excluded entry is in the format described by 'hg help patterns'.

The options allow you to add or remove included and excluded expressions.

If --clear is specified, then all previous includes and excludes are DROPPED and replaced by the new ones specified to --addinclude and --addexclude. If --clear is specified without any further options, the narrowspec will be empty and will not match any files.

If --auto-remove-includes is specified, then those includes that don't match any files modified by currently visible local commits (those not shared by the remote) will be added to the set of explicitly specified includes to remove.

--import-rules accepts a path to a file containing rules, allowing you to add --addinclude, --addexclude rules in bulk. Like the other include and exclude switches, the changes are applied immediately.

Options:

`--addinclude <VALUE[+]>`
| new paths to include
`--removeinclude <VALUE[+]>`
| old paths to no longer include
`--auto-remove-includes`
| automatically choose unused includes to remove
`--addexclude <VALUE[+]>`
| new paths to exclude
`--import-rules <VALUE>`
| import narrowspecs from a file
`--removeexclude <VALUE[+]>`
| old paths to no longer exclude
`--clear` | whether to replace the existing narrowspec
`--force-delete-local-changes`
| forces deletion of local changes when narrowing
`--backup` | back up local changes when narrowing (default: True)
`--update-working-copy`
| update working copy when the store has changed
`-e, --ssh <CMD>`
| specify ssh command to use
`--remotecmd <CMD>`
| specify hg command to run on the remote side
`--insecure` | do not verify server certificate (ignoring web.cacerts config)

[+] marked option can be specified multiple times