Projects & Bookmarks

The way to group repositories and working copies in subcommander is a Project.

A Project in subcommander can contain three special URLs to the repository and any number of repository and working copy bookmarks. The special URLs are the trunk folder of the repository, the branches folder of the repository and the tags folder of the repository. Since subversions branches and tags are only branches and tags by convention you have to tell subcommander where they are placed in the repository. That way you don't have to enter them every time you want to do something with a branch or tag. Any other bookmark into a repository has no special meaning.

The Projects are displayed in the Project Folders View (see the section called “The Main Window”).

Adding a New Project

You can create a new project either by using the new project.. item from the Project menu or by drag and drop. The menu item will add a new project item to the Project Folder View and switch it to edit mode so you can directly enter a name for the new project.

The other way to set up a new project is to use drag and drop. You can simply drag an URL from another application (like a web browser) and drop it into the Project Folder View (not on a project). Dropping the URL will automatically create a new project and will ask which slot the URL should fill. I.e. if the URL is the trunk, branches or tags URL.

In the same way you can drop multiple local directories from a file browser to the Project Folder View and tell subcommander to use the directories as working copies. Each working copy gets the last section of its path as the name in the project.

Adding, editing and deleting bookmarks from the new project can be done by choosing the corresponding item from the context menus of a project or a bookmark.

Modifying a Project

You can modify an existing project using the menu items in the Project menu or from the Settings Dialog.

Open the dialog from the Tools menu and select the project from the Projects category to edit it. You can directly open the project page in the settings dialog if you select the project and choose project settings.. from the Project menu.

Figure 2.5. subcommander Project Settings

subcommander Project Settings

To add folders, repository URLs or working copy paths, change to the project folders tab. Subcommander can help you to fill the URLs for trunk, branches and tags. In case your repository uses the standard repository layout (you don't have to) you can enter the root URL of your repository as the URL for the trunk type. Select the trunk folder, normally the first entry in the list view control, and enter the root URL in the edit control below the list view. Then press use Standard Layout to automatically fill the URLs with the root URL and an appended trunk, branches and tags string.

You can also modify an URL by browsing the repository with browse Repository.

To add a working copy Clear the edit controls and change the Project Folder Type to working copy. Enter a name and a path and finally press Add to add the new working copy. Selecting an existing working copy form the list view and pressing Add will duplicate it.

Another way of modifying a working copy path is by browsing the filesystem with browse Filesystem.

Removing a Project

To remove a project select it in the Project Folder View and run remove from the Project menu. Subcommander will request a confirmation that you really want to delete the project so you don't remove it by accident.

Changing the Order of Projects

You can simply drag a project root item and drop it on another project root item to move the source project to the location of the target project in the Project Folder View.

Adding Bookmarks

To add a new working copy or to change one of the URLs in a project you can use drag and drop in the same way you can create a new project. The only difference is that you drop the URL or paths directly on a project item. Subcommander will ask you where to place the dropped URL or paths. An URL will overwrite an existing URL in the same slot and working copies will be added to the project.

Modifying Bookmarks

Bookmark settings can be modified in the Bookmark Properties Dialog. You cann edit its name, its path or URL and in the case of a working copy you can activate the auto update option. Open the dialog by selecting edit.. from the bookmark menu.

Changing the Order of Bookmarks

To change the order of the bookmarks in a project simply drag a bookmark and drop it onto its new position.