Artifact f5fbdc276ee75a142b76e2c20ee1ba0ced54019d
File
www/cmd_extra.wiki
part of check-in
[9eb6ea75c1]
- doc changes -- spelling corrections and embedded ref pages.
by
kejoki on
2008-11-11 03:50:39.
<h2>extra</h2>
The <code>extra</code> command is informational, it doesn't do anything to
a checked-out project, but it tells you something about it.
Extra files are files that exist in a checked-out project, but don't belong to
the repository.
The <code>fossil extra</code> command will get you a list of these files.
This is convenient for figuring out if you've <code>add</code>ed every file
that needs to be in the repository before you do a commit. It will also
tell you what will be removed if you <code>clean</code> the project.
Suppose, for example, you have a "noodle.src" file as a scratch pad for source
code, and you don't want to include your latest hare-brained ideas in the
repository? You don't <code>add</code> it to the repository, of course—though there are ways you might add it unintentionally. If your
project is big, and you want to find noodle.src, and anything else that isn't
under source control within the project directories, then
<code>fossil extra</code> will give you a list.
If you don't think this is all that useful, then you've never had to write
a shell script that only affects project files and leaves everything
else alone. ;)
The <code>extra</code> command is almost, but not quite entirely, the exact
opposite of the <a href="wiki?name=fossil+ls"><code>ls</code></a> command.
See also: [fossil clean], [fossil ls], [Reference]