'\" t .\" Title: git-clean .\" Author: [FIXME: author] [see http://docbook.sf.net/el/author] .\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/> .\" Date: 06/01/2011 .\" Manual: Git Manual .\" Source: Git 1.7.5.4 .\" Language: English .\" .TH "GIT\-CLEAN" "1" "06/01/2011" "Git 1\&.7\&.5\&.4" "Git Manual" .\" ----------------------------------------------------------------- .\" * set default formatting .\" ----------------------------------------------------------------- .\" disable hyphenation .nh .\" disable justification (adjust text to left margin only) .ad l .\" ----------------------------------------------------------------- .\" * MAIN CONTENT STARTS HERE * .\" ----------------------------------------------------------------- .SH "NAME" git-clean \- Remove untracked files from the working tree .SH "SYNOPSIS" .sp .nf \fIgit clean\fR [\-d] [\-f] [\-n] [\-q] [\-e <pattern>] [\-x | \-X] [\-\-] <path>\&... .fi .sp .SH "DESCRIPTION" .sp Cleans the working tree by recursively removing files that are not under version control, starting from the current directory\&. .sp Normally, only files unknown to git are removed, but if the \fI\-x\fR option is specified, ignored files are also removed\&. This can, for example, be useful to remove all build products\&. .sp If any optional <path>\&... arguments are given, only those paths are affected\&. .SH "OPTIONS" .PP \-d .RS 4 Remove untracked directories in addition to untracked files\&. If an untracked directory is managed by a different git repository, it is not removed by default\&. Use \-f option twice if you really want to remove such a directory\&. .RE .PP \-f, \-\-force .RS 4 If the git configuration variable clean\&.requireForce is not set to false, \fIgit clean\fR will refuse to run unless given \-f or \-n\&. .RE .PP \-n, \-\-dry\-run .RS 4 Don\(cqt actually remove anything, just show what would be done\&. .RE .PP \-q, \-\-quiet .RS 4 Be quiet, only report errors, but not the files that are successfully removed\&. .RE .PP \-e <pattern>, \-\-exclude=<pattern> .RS 4 Specify special exceptions to not be cleaned\&. Each <pattern> is the same form as in $GIT_DIR/info/excludes and this option can be given multiple times\&. .RE .PP \-x .RS 4 Don\(cqt use the ignore rules\&. This allows removing all untracked files, including build products\&. This can be used (possibly in conjunction with \fIgit reset\fR) to create a pristine working directory to test a clean build\&. .RE .PP \-X .RS 4 Remove only files ignored by git\&. This may be useful to rebuild everything from scratch, but keep manually created files\&. .RE .SH "GIT" .sp Part of the \fBgit\fR(1) suite