Question:
- What are the different file statuses and icons in the workspace?
- What are the decorators in the pending changes view over the files?
- What are the differences between changed and checked-out files?
Resolution:
UVCS has two main statuses for its files: private and controlled.
- Private files are those that are only on your local machine. They have never been submitted to the server, and thus UVCS has no control over them. It cannot modify, delete, or perform any operation on them on its own.
- Controlled files are the ones that have already been submitted. UVCS has control over them, holding one or more previous revisions of said files
As you can see, the controlled file has a green decorator over it, whereas the private one doesn't have anything. Its status is displayed in the "Status" column.
Regarding its management by the workspace, private files can have one sub-status, which is "Private | Ignored". Controlled files on the other side can have two: "Controlled | Hidden" and "Controlled | Cloaked".
When working with the files, they can have some other status and decorators, as shown here:
Each of them has its own category, and some of them have a special decorator:
- Changed items. There are two types:
- Checked-out: A file is checked-out when you have told UVCS that you are going to modify that file. It appears there, whether you have made some changes to it or not, and if you have locked rules configured that apply to said file, it will retain a lock so no one else can modify it. - It has a red background with a white exclamation mark decorator.
Changed: A changed file is one that has changes inside of it, and UVCS has detected that its content or timestamp doesn't match the one from the version it has on the server. It has a dark blue background with a white checkmark decorator.
If they have changes as well as being checked-out, no decorator will appear.
Deleted Items: Files that where submited at least once to the server but whose latest version is removed. It has a red background with a white stripe decorator. This doesn't remove the older versions from the server!
Moved files: Those previously controlled files that were either renamed or whose location was moved while in the workspace.
- Added and private: New files or existing private files that were not submitted to the server.