Page tree
Skip to end of metadata
Go to start of metadata

The directory tree and the file table display the status of your working tree (and Index). The primary directory states are listed in Primary Directory States, and possible states of submodules in Submodule States. Every primary and submodule state may be combined with additional states, which are listed in Additional Directory States. The possible file states are listed in File States.

File Filtering

The Files table of the project window can be filtered by file state and name. The state filters can be set using the small toolbar buttons above the table as well as the menu items in the View menu. By default, if committable files (e.g. index-only changed or untracked) are hidden, the background turns to light-red as a reminder to not forget about them. If this annoys you because you permanently have untracked files in your working, you should consider to mark them as ignored. If this is no option for you, you can deactivate this coloring feature in the Preferences (page User Interface, option Use background color for the file table to indicate certain states).

To filter by name, use the input field (or <Ctrl/Cmd>+<F>-keystroke) above the file table. The context menu allows to enable regular expressions and save patterns for later usage or delete them. Even if unchanged files are hidden, they can be found by filtering by name - the files matching by name but not by state are shown in gray, while a light-yellow background indicates the name-filtering state.

Primary Directory States

Default Directory is present in the repository (more precisely: there is at least one versioned file below this directory stored in the repository).
Unversioned Directory (and contained files) are present in the working tree, but have not been added to the repository yet. Use Stage to add the files to the repository.
Ignored Directory is not present in the repository (exists only in the working tree) and is marked as to be ignored.
Missing Directory is present in the repository, but does not exist in the working tree. Use Stage to remove the files from the repository or Discard to restore them in the working tree.
Conflict Repository contains conflicting files (only displayed on the root directory). Use Resolve to resolve the conflict.
Merge Repository is in 'merging' or 'rebasing' state (only displayed on the root directory). Either Commit the merge/rebase or use Discard to cancel the merge/rebase.
Root/Submodule Directory is either the project root or a submodule root, see Submodule States.

Submodule States

Submodule Unchanged submodule.
Modified in working tree Submodule in working tree points to a different commit than the one registered in the repository. Use Stage to register the new commit in the Index, or Reset to reset the submodule to the commit registered in the repository.
Modified in Index Submodule in working tree points to a different commit than the one registered in the repository, and this changed commit has been staged to the Index. Commit this change or use Discard to revert the Index.
Modified in WT and Index Submodule in working tree points to a different commit than the one in the Index, and the staged commit in the Index is different from the one in the repository. Use either Stage to register the changed commit in the Index (overwriting the Index change), Discard to revert the Index, or Reset to reset the submodule to the commit registered in the Index.
Foreign repository Nested repository is not registered in the parent repository as submodule. Use Stage to register (and add) the submodule to the parent repository.

Additional Directory States

Direct Local Changes There are local (or Index) changes within the directory itself.
Indirect Local Changes There are local (or Index) changes in one of the subdirectories of this directory.

File States

Unchanged File is under version control and neither modified in working tree nor in Index.
Unversioned File is not under version control, but only exists in the working tree. Use Stage to add the file or Ignore to ignore the file.
Ignored File is not under version control (exists only in the working tree) and is marked to be ignored.
Modified File is modified in the working tree. Use Stage to add the changes to the Index or Commit the changes immediately.
Modified (Index) File is modified and the changes have been staged to the Index. Either Commit the changes or Unstage changes to the working tree.
Modified (WT and Index) File is modified in the working tree and in the Index in different ways. You may Commit either Index changes or working tree changes.
Modified (File Mode) The content of the file is not modified, but the executable bits are set different than in the repository. Refer to Fixing 'Modified (File Mode)' on Windows on how to fix that state on Windows.
Added File has been added to Index. Use Unstage to remove from the Index.
Removed File has been removed from the Index. Use Unstage to un-schedule the removal from the Index.
Missing File is under version control, but does not exist in the working tree. Use Stage or Remove to remove from the Index or Discard to restore in the wirking tree.
Modified (Added) File has been added to the Index and there is an additional change in the working tree. Use Commit to either commit just the addition or commit addition and change.
Intent-to-Add File is planned to be added to the Index. Use Add or Stage to add actually or Discard to revert to unversioned.
Conflict A merge-like command resulted in conflicting changes. Use the Conflict Solver to fix the conflicts.

Fixing 'Modified (File Mode)' on Windows

On Windows, the Modified (File Mode) state is usually caused due to a misconfiguration of your local repository, when not having core.filemode configuration option explicitly set to false (the default value is true).

Hence, if this option in not present in .git/config of your repository, invoke git config core.filemode false in the root directory of your repository to fix this problem.

  • No labels