extras¶
vb extras [OPTIONS] [PATH1 ...]
Description¶
Print a list of all files in the source tree that are not part of the current check-out. See also the clean command. If paths are specified, only files in the given directories will be listed.
Files and subdirectories whose names begin with . are normally
ignored but can be included by adding the --dotfiles option.
Files whose names match any of the glob patterns in the ignore-glob
setting are ignored. This setting can be overridden by the --ignore
option, whose CSG argument is a comma-separated list of glob patterns.
Pathnames are displayed according to the relative-paths setting,
unless overridden by the --abs-paths or --rel-paths options.
Options¶
- --abs-paths¶
Display absolute pathnames
- --case-sensitive BOOL¶
Override case-sensitive setting
- --dotfiles¶
Include files beginning with a dot (
.)
- --header¶
Identify the repository if there are extras
- --ignore CSG¶
Ignore files matching patterns from the argument
- --rel-paths¶
Display pathnames relative to the current working directory
- --tree¶
Show output in the tree format
Examples¶
Init and open a repository
$ vb init extras_repo.vbyte
project-id: c834de1f2b1fe05007b47250d59f571d1980722c
server-id: a7e5f727437730290d60908b816fce82ba594887
admin-user: ubuntu (initial remote-access password is "RyVE8G9wYf")
$ vb open -f extras_repo.vbyte
project-name: <unnamed>
repository: /tmp/sphinx_tests/97c88c44/extras_repo/extras_repo.vbyte
local-root: /tmp/sphinx_tests/97c88c44/extras_repo/
config-db: /tmp/sphinx_tests/97c88c44/.visionbyte
project-code: c834de1f2b1fe05007b47250d59f571d1980722c
checkout: bd269e8cdfc66aae4d9ef45f65c25d5e3a3e10be 2026-03-31 13:00:16 UTC
tags: trunk
comment: initial empty check-in (user: ubuntu)
check-ins: 1
List unmanaged files in the working copy
$ vb sys echo "tmp" > a.tmp
$ vb sys echo "tmp" > b.tmp
$ vb sys mkdir src
$ vb sys echo "run" > src/run.log
$ vb sys touch .hidden
$ vb extras
a.tmp
b.tmp
src/run.log
Include dotfiles in the output
$ vb extras --dotfiles
.hidden
a.tmp
b.tmp
src/run.log
Limit output to a specific path
$ vb extras src
src/run.log
Use the default path style (relative to the repository root)
$ cd src & vb extras --abs-paths
a.tmp
b.tmp
src/run.log
Force paths relative to the current directory
$ cd src & vb extras --rel-paths
a.tmp
b.tmp
src/run.log