macSvn Help

Content

Icon badges (icon overlays)

Every file and folder has a Subversion status value as reported by the Subversion library. In the macSvn they are shown graphically using the icon badges (icon overlays).

If you want to display icon badges (icon overlays) in your working copy, you need to add it to the management list of macSvn. See the "How to manage an existing working copy?" and "How to check out and manage a new working copy?".

macSvn icon badges

The Normal icon badge is used to represent an item which is in the normal state. A fresh checked out working copy has this as badge. Because macSvn uses a background caching process to gather status, it may take a few seconds before the badge updates.

The Locked icon badge is used when the local working copy holds a lock for that file, and its Subversion status is normal. This icon badge reminds you that you should release the lock if you are not using it to allow others to commit their changes to the file.

The Read-only icon badge is used to indicate when a file has the svn:needs-lock property set, and Subversion makes that file read-only until you get a lock on that file. Such files have this badge to indicate that you have to get a lock first before you can edit that file.

The Switched icon badge is used when the item has a Switched URL relative to the parent, and its Subversion status is normal.

The External icon badge is used to represent an unversioned directory created by an externals definition, or a versioned file created by an externals definition.

The Modified icon badge represents the modified state, where you have made local modifications, and the merged state, where changes from the repository have been merged with local changes. As soon as you start editing a file, the status changes to modified and the icon then changes to use this badge. That way you can easily see which files were changed since you last updated your working copy and need to be committed.

The Replaced icon badge represents the replaced state, where a file has been deleted and replaced by another different file with the same name.

The Deleted icon badge represents the deleted state, where an item is scheduled for deletion. It shows you that some files or folders inside the current folder have been scheduled to be deleted from version control.

The Missing icon badge represents the missing state, where an item is not present. Naturally an item which is missing cannot have an icon itself, but the parent folder can be marked if one of its child items is missing.

The Moved-away icon badge represents the moved away state, where an item is scheduled to be moved away or renamed.

The Moved-here icon badge is used to represent an item which is renamed or moved here from another item which is under version control. And it has been scheduled to be added to version control.

The Added icon badge is simply used to represent the added status when an item is scheduled to be added to version control.

The Copied icon badge is used to represent the copied status when an item is copied from another item which is under version control, and scheduled to be added to version control.

The Conflicted badge is used to represent the conflicted state, where an update or switch results in conflicts between local changes and changes downloaded from the repository. If during an update a conflict occurs then the icon changes to display this badge.

The Unknown icon badge represents a versioned item whose state is not yet known.

The Unversioned icon badge is used to represent an item which is in the unversioned state. This is an item in a versioned folder, but which is not under version control itself, but have not been ignored.

The Ignored icon badge is used to represent an item which is in the ignored state, either due to a global ignore pattern, or the svn:ignore property of the parent folder. It tells you that a file or folder is ignored for version control purposes.

The Incompleted icon badge is used to indicate an item which is being processing by Subversion (e.g. commit, update, etc.). This is a temporary state.

The Obstructed icon badge is used to represent the obstructed state, it indicates the versioned item obstructed by some item of a different kind. Which can occur when an operation is unable to complete.

The Working-copy-locked icon badge is used to represent whether the working copy is locked for writing by another Subversion client modifying the working copy.