The main interface is comprised of the following areas (see Figure 2.2):
The real-estate of the main interface can be managed by resizing the amount of space a pane takes in the application window. Move the mouse pointer over either the vertical or horizontal pane separators. The pointer will change, then click and hold the mouse button while dragging the pointer to a new position in order to resize a pane.
SVN commands and eSvn functions are menu driven. Following is a description of the main menus, their options and shortcut keys where applicable.
When navigating the menu options look at the Status bar, located at the bottom of the main window, for tips about the function of the selected option.
Ctrl+O) : Displays a common dialog for browsing to and opening local folders containing resources which may or may not be under subversion control (see the section called “Opening a Working Directory”).-> (
Ctrl+W) : Displays the Workspace Manager dialog used to manage workspaces (see the section called “Managing Workspaces”).-> (
Ctrl+B) : Displays the repository browser which can be used to explore a remote or local subversion repository without performing a checkout (see the section called “Browsing Remote Repositories”).-> (
URL (see the section called “Importing a File System”).-> : Displays the import dialog used to specify a path that will be committed to a given
URL from which a clean directory tree will be made in a given local path (see the section called “Exporting a Folder System”).-> : Displays the export dialog used to specify a
eSvn (see the section called “Configuring Options”).-> : Displays the options dialog used to set preferences for
-> : A list of the most recently opened work spaces. Select an option to open the workspace.
eSvn.-> : Closes
Toolbar options.-> : Displays a sub menu listing the available
Ctrl+H) : Toggles visibility of files with the status "- unknown -" in the File View.-> (
-> : Clears all output from the output pane.
Alt+U) : Updates all local, unmodified files with new versions that may be residing in the repository (see the section called “Updating Local Copy”).-> (
Ctrl+U) : Displays the update dialog used to specify a revision number or date to which the local copy should be updated. Forward and backward revision updates are possible (the section called “Updating the Revision”).-> (
Alt+C) : Commits changes made locally back to the repository (see the section called “Committing to the Repository”).-> (
Alt+A) : Adds a folder or file to the workspace directory so that it comes under subversion control. The file or folder is only added to the server repository on the next commit operation (see the section called “Adding to the Repository”).-> (
Ctrl+A) : Adds a folder and its contents to the local repository so that it comes under subversion control. The folder and its contents are only added to the server repository on the next commit operation (see the section called “Recursive Addition”).-> (
Alt+D) : Deletes a folder or file from the working copy (see the section called “Deleting”).-> (
Alt+Q) : Displays the copy dialog used to specify a source folder path or file located in the workspace directory and the local destination to which it will be copied (see the section called “Copying Local Files”).-> (
Ctrl+Q) : Displays the copy dialog used to specify a source folder path or file located in a remote repository and the remote destination to which it will be copied (see the section called “Copying Remote Files”)-> (
Alt+V) : Displays the move dialog used to specify a source folder or file and the destination to which it will be moved (see the section called “Moving Items”).-> (
Alt+G) : Displays the make a directory dialog used to specify a folder name that will be created under the folder selected in the Tree View.-> (
Alt+M) : Displays the merge dialog used to specify to sources whose differences will be merged to a given location (see the section called “Merging”).-> (
Alt+S) : Displays the switch dialog used to specify a new location to which the local source will be updated (see the section called “Switching a Working Copy”).-> (
Alt+R) : Roles back all edits on the selected local item to the last version in the server repository (see the section called “Reverting”).-> (
Ctrl+R) : Roles back all edits on the selected local folder and it contents to the last version in the server repository (see the section called “Reverting”).-> (
Alt+Z) : Performs a recursive cleanup of the workspace directory, removing stale locks and resuming uncompleted operations (see the section called “Cleaning up”).-> (
Alt+E) : Removes conflicted state from selected folders or files (see the section called “Resolving Conflicts”).-> (
F4) : Opens the selected file with the editor specified (see the section called “Configuring Options”).-> (
Alt+L) : Displays commit log messages (see the section called “Log”).-> (
Alt+I) : Displays information about a selected path (see the section called “Info”).-> (
Alt+S) : Displays the status of a selected item. If a folder displays status of folder contents (see the section called “Status”).-> (
Alt+P) : Displays the properties associated with the selected path (see the section called “Properties”).-> (
F9) : Displays the diff dialog used to specify a version in the repository against which to compare the local item (see the section called “Quick Diff”).-> (
Shft+F9) : Displays the difference between the current local and the last revision in the repository (see the section called “Diff”).-> (
Ctrl+Shft+F9) : Invokes any 3-way-diff, as specified in the options settings, to be used for resolving conflicts, (see the section called “Diff-3 (conflict)”).-> (
Alt+B) : Displays the author and revision information for a selected folder, file or URL.-> (
Ctrl+S) : Displays the Changed items dialog that lists all changed items.-> (
F3) : Displays the contents of the last revision of a selected file from the repository (see the section called “View (cat)”).-> (
-> : Displays the Online Help system.
eSvn web site in a browser.-> : Opens the
-> : Displays the Version update dialog.
-> : Displays the About dialog.
There is a toolbar for each of the eSvn menus. The toolbars provide quick access to the options available on the menus. Each option is represented by a button. To use a option just click the toolbar button. If you are not certain of a buttons function, hold the mouse cursor over the button to display a tool-tip.
To display the File toolbar select-> -> .
To display the View toolbar select-> -> .
To display the Modify toolbar select-> -> .
To display the Query toolbar select-> -> .
When eSvn is first started the toolbars are not displayed. To display a toolbar select -> and choose one of the available sub menu options. Options displaying a checked symbol are enabled, those without are not. In this way toolbars can be toggled ON and OFF depending on preference.
When a toolbar is enabled it is by default displayed in the docked position below the main menu. Toolbars can be docked on any side of the main interface (top, left, bottom, right). To dock a toolbar select the toolbar handle and drag it to one of the sides. While moving the toolbar the contents are transparent and the outline of the area is represented by a thick lined rectangle. When the toolbar is brought close to any side this line is thin, indicating that the toolbar can be docked in this position. Release the toolbar when the outline changes and the toolbar will span into the docked position. Within the docked position the toolbar position can be adjusted according to preference.
Toolbars can also be free-floating within any area of the desktop real-estate, even beyond the eSvn window space. When a toolbar is free-floating it can be returned to the top docking position by double-clicking its title bar.
The layout and position of toolbars is set to be persistent so that the eSvn workspace is restored to the preferences of the previous session. As example of the interface with docked and free-floating menus can be seen in Figure 2.2.
The tree view displays the tree folder structure of the workspace directory. Folder levels can be expanded and collapsed. The status of a folder is displayed by changes in the folder icon as follows.
Table 2.1. Tree View Status Icons
|Folder open/closed. Exists in local and repository.|
|Folder open/closed. Exists local only.|
In addition to enabling exploration of the folder structure and displaying status, the tree view provides access to a number of subversion operations by way of a context menu (right-click).
The file view displays the contents of the folder selected in the "Tree View". For each item the following information is displayed is columns. Items can be ordered by column in ascending or descending order by clicking the column title.
The name of the file.
The status of the file, states include:
out of date
- unknown -
- missing -
The latest revision in the repository.
The last revision containing an a change.
The date and time of last up date.
The date and time of last modification made locally.
User name of subversion account that performed a modification and did commit.
The trunk, tag or branch of the repository filesystem under which the file resides. When the file resides in a branch or a tag folder the or icons are used respectively and the value is change from trunk to branch or tag accordingly.
The file view also provides visual indication item status by way of a graphic icon located before the item as described in the following table.
Table 2.2. File View Status Icons
|File unknown. Not under repository control.|
|File added. Scheduled for commit.|
|Up to date and writable.|
|Out of date. Needs Patch.|
|Conflict resulted from Merge or Update operation.|
|File locally removed.|
|Contents have been added to the folder but not yet sent to repository in commit, content is modified. Only displayed when Show folders in File List option is checked (see the section called “Configuring Options”).|
|Folder contains items under repository control that have been modified, contents are out-of-date. Only displayed when Show folders in File List option is checked (see the section called “Configuring Options”).|
To view the Log associated with a folder, double-click the folder.
In addition to displaying and providing access to and information about files, the file view provides access to a number of subversion operations by way of a context menu (right-click).
The log view displays the output of processing commands. Commands and the status of their results are highlighted.
Output can be selected in part or in whole and copied to the Clipboard. Right-click choose to select all the entire content of the output log or click and drag the mouse pointer across a part of the log to select a portion. Use Ctrl+C or right-click choose to place a copy of the selected output on the clipboard.
The Command Prompt enables manual input of subversion commands as an alternative to driving functions using the menu options. When working at the Command Prompt use the ⇑ & ⇓ direction keys to traverse the PREV and NEXT command history.
Type svn help to display the subversion help menu list of commands. Type svn help [command] to view more information about a command.