Syncro SVN Client 10.1

You can run the installation in unattended mode by running the installer from the command line with the -q parameter. By default, running the installer in unattended mode installs Syncro SVN Client with the default options and does not overwrite existing files. You can change many options for the unattended installer using the installer command line parameters.

You can run the installation in unattended mode by running the installer from the command line with the -q parameter. By default, running the installer in unattended mode installs Syncro SVN Client with the default options and does not overwrite existing files. You can change many options for the unattended installer using the installer command line parameters.

You can run the installation in unattended mode by running the installer from the command line with the -q parameter. By default, running the installer in unattended mode installs Syncro SVN Client with the default options and does not overwrite existing files. You can change many options for the unattended installer using the installer command line parameters.

You can run the installation in unattended mode by running the installer from the command line with the -q parameter. By default, running the installer in unattended mode installs Syncro SVN Client with the default options and does not overwrite existing files. You can change many options for the unattended installer using the installer command line parameters.

You can use one of the following license types with Syncro SVN Client:

1. A Named-User License may be used by a single Named User on one or more computers. Named-user licenses are not transferable to a new Named User . If you order multiple named-user licenses, you will receive a single license key good for a specified number of named users. It is your responsibility to keep track of the named users that each license is assigned to.
2. A Site License may be used by all the people that belong to the organization that purchased the site license.

For definitions and legal details of the license types, consult the End User License Agreement available at http://www.syncrosvnClient.com/eula.html .

You can obtain a license for Syncro SVN Client in one of the following ways:

• You can purchase one or more licenses from the Syncro SVN Client website at http://www.syncrosvnclient.com/buy.html . A license key will be sent to you by email.
• If your company or organization has already purchased licenses, please contact your license administrator to obtain a license key.
• If you want to evaluate the product, you can obtain a trial license key for 30 days from the Syncro SVN Client website at http://www.syncrosvnclient.com/register.html .

Syncro SVN Client checks for new versions automatically at start up. To disable this check, open the Preferences dialog box (Options ⇒ Preferences) , go to Global, and uncheck Automatic Version Checking.

To check for new versions manually, go to Help ⇒ Check for New Versions .

Syncro SVN Client checks for new versions automatically at start up. To disable this check, open the Preferences dialog box (Options ⇒ Preferences) , go to Global, and uncheck Automatic Version Checking.

To check for new versions manually, go to Help ⇒ Check for New Versions .

The global options cover a number of aspects of the overall operation of Syncro SVN Client. To configure the Global options, open the Preferences dialog box (Options ⇒ Preferences) and go to Global.

The following options are available in the Global preferences page:

Automatic Version Checking

If this option is enabled, Syncro SVN Client will check for a new version on startup.

Language

This option specifies the language used in the user interface. You can choose between English, French, German, Dutch, or Japanese. You must restart Syncro SVN Client for the change to take effect.

Other language

This option sets the language used in the user interface using an interface localization file. You can use this option to set the language of the user interface to a language that is not shipped with Syncro SVN Client.

Note

If some interface labels are not rendered correctly after restarting the application, (for example, Chinese or Korean characters are not displayed correctly), make sure that your operating system has the appropriate language pack installed (for example, the East-Asian language pack).

Line separator

This option sets the line separator used when saving files. Use System Default to select the normal line separator for your OS. If you want the existing file separator of a file to be maintained, regardless of your current OS, check Detect the line separator on file open.

Detect the line separator on file open

When this option is selected, the editor detects the line separator when a file is loaded and it uses it when the file is saved. New files are saved using the line separator defined by the Line separator option.

Show memory status

When this option is selected, the memorySyncro SVN Client uses is displayed in the status bar. To free memory, click the Free unused memory button located at the right side of the status bar. The memory status bar turns yellow or red when Syncro SVN Client uses too much memory. You can change the amount of memory available to Syncro SVN Client by changing the parameters of the application launcher.

Check opened files for file system changes

When this option is selected, Syncro SVN Client checks the content of the all opened editors to see if they have been updated by another application. If the file has changed, Syncro SVN Client will ask you if you want to reload the file.

Auto update unmodified editors on file system changes

If this option is selected, Syncro SVN Client automatically updates unmodified editors if the edited file changes externally.

Show Java vendor warning at startup

If this option is selected, Syncro SVN Client displays a warning on startup if a non-recommended version of the Java virtual machine is being used.

Show hidden files and directories

If this option is selected, Syncro SVN Client shows system hidden files and folders in the file browser dialog box and the folder browser dialog box. This setting is not available on OS X.

Syncro SVN Client allows you to choose the fonts to be used in the Text editor. To configure the font options, open the Preferences dialog box (Options ⇒ Preferences) and go to Appearance ⇒ Fonts .

The following options are available:

Editor

Allows you to choose the font that will be used in the editor.

Note

On Mac OS X, the default font, Monaco, cannot be rendered in bold.

Text antialiasing

This option allows you to set the text anti-aliasing behavior:

• Default - Allows the application to use the setting of the operating system, if available.
• On - Sets the text anti-aliasing to pixel level.
• Off - Disables text anti-aliasing.
• Sub-pixel anti-aliasing modes, such as GASP, LCD_HRGB, LCD_HBGR, LCD_VRGB, and LCD_VBGR.

Text components

This option allows you to choose the font to be used in text boxes within the interface.

GUI

This option allows you to choose the font to be used for user interface labels.

View titles font

This option allows you to choose the font to be used in the titles of the various views that are opened within the interface.

Syncro SVN Client lets you configure how character encodings are recognized when opening files and which encodings are used when saving files. To configure encoding options, open the Preferences dialog box (Options ⇒ Preferences) and go to Encoding.

The following encoding options are available:

Fallback character encoding

Specifies the default character encoding of non-XML documents if their character encoding cannot be determined from other sources (for example, it is not specified in the document or determined by the file type).

Note

For certain document types, the following encoding detection rules are used:

• For XML, DTD, and CSS documents, Syncro SVN Client tries to collect the character encoding from the document. If no such encoding is found, then UTF-8 is used.
• For JavaScript, JSON, SQL, XQuery, and RNC, the UTF-8 encoding is used.

Encoding errors handling

This setting specifies how to handle characters that cannot be represented in the character encoding that is used when the document is opened. The available options are:

• REPORT (default) - Displays an error identifying the character that cannot be represented in the specified encoding. Unrecognized characters are rendered as an empty box.
• REPLACE - The character is replaced with a standard replacement character. For example, if the encoding is UTF-8, the replacement character has the Unicode code FFFD, and if the encoding is ASCII, the replacement character code is 63.
• IGNORE - The error is ignored and the character is not included in the document displayed in the editor.

  Attention

  If you edit and save the document, the characters that cannot be represented in the specified encoding are dropped.

Syncro SVN Client lets you configure the appearance of various components and features of the main editor. To access these options, open the Preferences dialog box (Options ⇒ Preferences) and go to Editor.

The following options are available:

Selection background color

Allows you to set the background color of selected text.

Selection foreground color

Allows you to set the color of selected text.

Editor background color

Allows you to set the background color for the text editors.

Editor cursor color

Allows you to set the color of the cursor.

Line number foreground

Allows you to set the foreground color of the line numbers displayed in the editor panels.

Show line numbers

Shows line numbers in the editor panels.

Show TAB/NBSP/EOL/EOF marks

Makes the TAB/NBSP/EOL/EOF characters visible in the editor. You can use the color picker to choose the color of the marks.

Show SPACE marks

When checked, the space characters are rendered with a dot.

Cut/Copy whole line when nothing is selected

If enabled, Cut and Copy actions operate on the entire current line when nothing is selected in the editor.

Indent with tabs

If checked, indents are created using TAB characters. If unchecked, lines are indented using space characters.

Indent size

Allows you to set the number of space characters or the tab size that equals a single indent. For example, if set to 4, one tab equals:

• 4 space characters, if the Indent With Tabs option is unchecked.
• 1 tab that spans 4 characters, if the Indent With Tabs option is checked.

Undo history size

Allows you to set the maximum amount of undo operations you can perform in any of the editor modes (Text, Design, Grid).

To configure the options for the SVN client tool, open the Preferences dialog box (Options ⇒ Preferences) and go to SVN. Some other preferences for the embedded SVN client tool can be set in the global files called config and servers. These files contain parameters that act as defaults applied to all the SVN client tools that are used by the same user on their computer login account. To open these files for editing, launch the embedded SVN client tool ( Tools ⇒ SVN Client ) and select Global Runtime Configuration ⇒ Edit 'config' file or Global Runtime Configuration ⇒ Edit 'servers' file from the SVN client Options menu.

SVN Preferences Panel

The following SVN options can be configured in this preferences page:

Enable symbolic link support (available only on Mac OS X and Linux)

Apache Subversion™ has the ability to put a symbolic link under version control, via the usual SVN add command. The Subversion repository has no internal concept of a symbolic link. It stores a versioned symbolic link as an ordinary file with a svn:special property attached. On Unix/Linux, the SVN client sees the property and translates the file into a symbolic link in the working copy. If the symbolic link support is disabled, the versioned symbolic links appear as a text file instead of symbolic link.

Note

Windows file systems have no symbolic links, so a Windows client will not do any such translation and the object appears as a normal file.

Important

It is recommended to disable symbolic links support if you do not have versioned symbolic links in your repository, since the SVN operations will work faster. However, you should not disable this option when you do have versioned symbolic links in repository. In that case a workaround would be to reference the working copy by its real path, instead of a path that includes a symbolic link.

Allow unversioned obstructions

Controls how to handle a situation where working copy resources are ignored / unversioned when performing an update operation and incoming files (from the repository) with the same name and location intersect with those being ignored / unversioned. If the option is enabled, the incoming items will become BASE revisions of the ones already present in the working copy, and those present will be made versioned resources and will be marked as modified (exactly as if the user first made the update operation and then modified the files). If the option is disabled, the update operation will fail when encountering files in this situation, possibly leaving other files not updated. By default, this option is enabled.

Use unsafe copy operations

Sometimes when the working copy is accessed through Samba and the SVN client cannot make a safe copy of the committed file due to a delay in getting a write permission, the result is that the committed file will be saved with zero length (the content is removed) and an error will be reported. In this case, this option should be selected so that the SVN client does not try to make the safe copy.

HTTPS encryption protocols (available if you are using Java version 1.6 or older)

Sets a specific encryption protocol to be used when the application accesses a repository through HTTPS protocol. You can choose one of the following values:

• SSLv3, TLSv1 (default value)
• SSLv3 only
• TLSv1 only

Results Console

Specifies the maximum number of lines displayed in the Console view. The default value is 1000.

Annotations View

Sets the color used in the editor panel for highlighting all the changes contributed to a resource by the revision selected in the Annotations view.

Revision Graph

Enables caching for the action of computing a revision graph. When a new revision graph is requested, one of the caches from the previous actions may be used that will avoid running the whole query again on the SVN server. If a cache is used, it will finish the action much faster.

To configure the SVN Diff options, open the Preferences dialog box (Options ⇒ Preferences) and go to Diff.

The following options are available:

Default algorithm

The default algorithm used for performing comparisons. The following options are available:

• Auto - Selects the most appropriate algorithm, based on the compared content and its size (selected by default).

• Lines - Computes the differences at line level, meaning that it compares two files or fragments looking for identical lines of text.

• XML Fast - Comparison that works well on large files or fragments, but it is less precise than XML Accurate.

• XML Accurate - Comparison that is more precise than XML Fast, at the expense of speed. It compares two XML files or fragments looking for identical XML nodes.

Algorithm strength

Controls the amount of resources allocated to the application to perform the comparison. The algorithm stops searching more differences when reaches the maximum allowed resources. A dialog box is displayed when this limit is reached and partial results are displayed. Four settings are available: Low, Medium (default), High and Very High.

Show pseudo conflicts

Specifies whether or not the file comparison displays pseudo-conflicts. A pseudo-conflict occurs when two users make the same change (for example, when they both add or remove the same line of code).

Ignore Whitespaces

If enabled, before performing the comparison, the application normalizes the content (collapses any sequence of whitespace characters into a single space) and trims its leading and trailing whitespaces.

Note

If the Ignore Whitespaces checkbox is selected, comparing the a b sequence with a b, Syncro SVN Client finds no differences, because after normalization, all whitespaces from the first sequence are collapsed into a single space character. However, when comparing a b with ab (no whitespace between a and b), Syncro SVN Client signals a difference.

XML Diff section

Ignore

Allows you to specify the types of XML nodes that will be ignored in the file comparison for the XML Fast and XML Accurate algorithms.

Ignore nodes by XPath

If enabled, you can enter an XPath expression to ignore certain nodes from the comparison. It will be processed as XPath version 2.0. The XPath expression specified in this option is used as the default ignore instructions only when the application is started. If you enter an XPath expression in the similar option on the Diff Files toolbar, that expression will be used instead.

Merge adjacent differences

If enabled, the application considers two adjacent differences as one when the differences are painted in the side-by-side editors. If disabled, every difference is represented separately.

Mark end tags as different for modified elements

If enabled, end tags of modified elements are also presented as differences. Otherwise, only the start tags are presented as differences.

Ignore expansion state for empty elements

If enabled, empty elements in both expansion states are considered matched (that is <element/> and <element></element> are considered equal).

External Diff section

Compare With External Application

Specifies an external application to be launched for compare operations in the following cases:

• When two history revisions are compared.
• When the working copy file is compared with a history revision.
• When a conflict is edited.

The parameters ${firstFile} and ${secondFile} specify the positions of the two compared files in the command line for the external diff application. The parameter ${ancestorFile} specifies the common ancestor (that is, the BASE revision of a file) in a three-way comparison. The working copy version of a file is compared with the repository version, with the BASE revision (the latest revision read from the repository by an Update or Synchronize operation) being the common ancestor of these two compared versions.

Important

If the path to the external compare application includes spaces (or any of the subsequent options or arguments), then each of these paths or tokens must be double-quoted for the Syncro SVN Client to correctly parse and identify them. For example, C:\Program Files\compareDir\app name.exe must be written as "C:\Program Files\compareDir\app name.exe".

You can use the Menu Shortcut Keys preferences page to configure shortcut keys for the actions available in Syncro SVN Client. The shortcuts assigned to actions are displayed in a table in this preference page. To access the full list of shortcut keys, open the Preferences dialog box (Options ⇒ Preferences) and go to Menu Shortcut Keys (or simply go to Options ⇒ Menu Shortcut Keys ).

Menu Shortcut Keys Preferences Page

To find a specific action, you can use the filter to search through any of the columns in the table. You can also click on a column header to sort that column.

The table includes the following columns:

• Description - A short description of the action.
• Category - A classification of the actions in categories for easier management and more flexibility in assigning multiple keys for the same action. For example, by default, the Remove all action has one shortcut key assigned for bookmarks and another one assigned for breakpoints.
• Shortcut key - The combination of keyboard keys that can be used to launch the action. To add or change a shortcut key, you can either double-click a row or select the row and press the Edit button.

Each type of file is associated with a type of editor that opens the files of that type for editing. The editor can be the built-in one specially provided for the file type (for example, the internal XML editor, the internal XSLT editor, the internal XSL-FO editor, etc) or an external application installed on the computer, either the default system application associated with that file type in the operating system or other particular application specified by the path to its executable file. To configure SVN file formats, open the Preferences dialog box (Options ⇒ Preferences) and go to SVN File Editors.

SVN File Editors Preferences Panel

The Edit button or a double-click a table row opens a dialog box for specifying the editor associated with the file type. The same dialog box is displayed on opening a file from one of the Syncro SVN Client views.

Open With Dialog Box

In this dialog box are offered three options for opening a file:

• System default application - Opens the selected file using the application that is associated with that file extension by default in the operating system.
• System application - Opens the selected file using an external application that you have to specify by the path of its executable file. Also, you can specify some arguments for the command line of that application, if they are needed. This option also works for directories, if you want to choose a file browser other than the system default.
• Internal editor - Allows you to select an editor type from the built-in editors that are included in Syncro SVN Client. By default, this option is disabled when selecting directories.

If a file type is associated with an internal editor other than an XML editor type then the encoding set in the preference for Encoding for non XML files is used for opening and saving a file of that type. This is necessary because in the case of XML files, the encoding is usually declared at the beginning of the XML file in a special declaration or it assumes the default value UTF-8, but in the case of non-XML files there is no standard mechanism for declaring the encoding of the file.

This section presents the options available in the Network Connection Settings preferences pages.

The Messages preferences page allows you to disable certain warning messages that may appear in the application. To configure these options, open the Preferences dialog box (Options ⇒ Preferences) and go to Messages.

This preferences page allows you to disable the following warning messages:

Show confirmation dialog when using the "Update All" action

Allows you to avoid performing accidental update operations by requesting you to confirm them before execution.

Show confirmation dialog for drag and drop actions in Working Copy

This option avoids doing a drag and drop when you just want to select multiple files in the Working Copy view.

Show warning dialog when editing conflicts

When the Edit Conflicts action is executed, a warning dialog box notifies you that the action overwrites the conflicted version of the file created by an update operation. The conflicted file is overwritten with the version of the same file that existed in the working copy before the update operation and then proceeds with the visual editing of the conflicting file.

Show warning dialog when "svn:externals" definitions are ignored

A warning dialog box is displayed when "svn:externals" definitions are ignored before performing any operation that updates resources of the working copy (such as Update and Override and Update).

Syncro SVN Client has an extensive set of options that you can configure. When Syncro SVN Client in installed, these options are set to default values. You can provide a different set of default values for an installation using an XML options file.

Actions for importing, exporting, and resetting global options are available in the Options menu. The export operation allow you to save global preferences as an XML properties file and the import operation allows you to load the property file. You can use this file to reload saved options on your computer or to share with others.

The following actions are available in the Options menu:

Reset Global Options

Restores the preferences to the factory defaults.

Import Global Options

Allows you to import a set of Global Options from an exported XML properties file. You can also select a (.xpr) to import all the Global Options that are set in that project file. After you select a file, the Import Global Options dialog box is displayed, and it informs you that the operation will only override the options that are included in the imported file. You can enable the Reset all other options to their default values option to reset all options to the default values before the file is imported.

Export Global Options

Allows you to export Global Options to an XML properties file. Some user-specific options that are private are not included. For example, passwords and the name of the Review Author is not included in the export operation.

Syncro SVN Client automatically stores your options in an XML options file. Depending on the platform you are using, this file is located in the following directories:

• [user-home-folder]\AppData\Roaming\ com.syncrosvnclient for Windows Vista/7/8/10
• [user-home-folder]\Application Data\ com.syncrosvnclient for Windows XP
• [user-home-folder]/Library/Preferences/ com.syncrosvnclient for OS X
• [user-home-folder]/. com.syncrosvnclient for Linux

The name of the options file of Syncro SVN Client 10.1 is oxyOptionsSvn8.0.xml.

If you start Syncro SVN Client with the syncroSVNClient.bat command line script, you have to add or modify the -Xmx parameter to the java command at the end of the script.

For example, to set the maximum amount of Java memory to 600 MB in Windows, modify the -Xmx parameter like this:

java -Xmx600m -Dsun.java2d.noddraw=true ...

On Mac OS X, the java command should look like this:

java "-Xdock:name=SyncroSVNClient"\
 -Xmx600m\
 ...

On Linux, the Java command should look like this:

java -Xmx600m\

The startup launchers for Syncro SVN Client and its executable internal tools (Tree Editor, XML Schema Regular Expressions Builder, Large File Viewer, SVN Client, Compare Directories, and Compare Files) include a default .vmoptions file that contain some startup parameters (such the -Xmx parameter, which is used for allocating memory for that particular application). You can edit the parameters in these .vmoptions files so that the applications will launch with your desired values. However, if you re-install the application, install an update for the application, or deploy it to other users or machines, those parameters will be reset to their default values.

To avoid resetting user-defined startup parameters, you can create custom .vmoptions files and the application and the executable tools will automatically include your custom parameters at startup. The following custom files are recognized by the application and the executable tools:

• custom_commons.vmoptions - The parameters and their values of this file will be included in all the startup launchers.
• custom_<app name>.vmoptions - The <app name> is the name of the executable application or tool (for example, custom_diffFiles.vmoptions for the Compare Files tool). The parameters and their values of this file will be included in the startup launcher for this particular executable.

To be recognized and included, these custom startup parameter files must be saved in the installation directory of Syncro SVN Client.

The main window consists of the following views:

• Repositories view - Allows you to define and manage Apache Subversion™ repository locations.
• Working Copy view - Allows you to manage with ease the content of the working copy.
• History view - Displays information (author name, revision number, commit message) about the changes made to a resource during a specified period of time.
• Editor view - Allows you to edit various types of text files, with full syntax-highlight.
• Annotations view - Displays a list with information regarding the structure of a document (author and revision for each line of text).
• Compare view - Displays the differences between two revisions of a text file from the working copy.
• Image Preview panel - Allows you to preview standard image files supported by Syncro SVN Client: JPG, GIF and PNG.
• Compare Images view - Displays two images side by side.
• Properties view - Displays the SVN properties of a resource under version control.
• Console view - Displays information about the currently running operation, similar with the output of the Subversion command line client.
• Dynamic Help view - Shows information about the currently selected view.

The main window's status bar presents in the left side the operation in progress or the final result of the last performed action. In the right side there is a progress bar for the running operation and a stop button to cancel the operation.

The main menu of the Syncro SVN Client is composed of the following menus:

File Menu

New submenu:

New File

This operation creates a new file as a child of the selected folder from the Repositories view tree or the Working Copy view tree, depending on the view that was last used. Note that for the Working Copy view, the file is added to version control only if the selected folder is under version control.

New Folder(Ctrl (Command on OS X) + Shift + F)

This operation creates a new folder as a child of the selected folder from the Repositories view tree or the Working Copy view tree, depending on the view that was last used. Note that for the Working Copy view, the file is added to version control only if the selected folder is under version control.

New External Folder (Ctrl (Command on OS X) + Shift + W)

This operation allows you to add a new external definition on the selected folder. An external definition is a mapping of a local directory to a URL of a versioned directory, and ideally a particular revision, stored in the svn:externals property of the selected folder.

Tip

You can specify a particular revision of the external item by using a peg revision at the end of the URL (for example, URL@rev1234). You can also use peg revisions to access external items that were deleted, moved, or replaced.

The URL used in the external definition format can be relative. You can specify the repository URL that the external folder points to by using one of the following relative formats:

• ../ - Relative to the URL of the directory that the svn:externals property is set.
• ^/ - Relative to the root of the repository in which the svn:externals property is versioned.
• // - Relative to the scheme of the URL of the directory that the svn:externals property is set.
• / - Relative to the root URL of the server in which the svn:externals property is versioned.

Important

To change the target URL of an external definition, or to delete an external item, do the following:

1. Modify or delete the item definition found in the svn:externals property that is set on the parent folder.
2. For the change to take effect, use the Update operation on the parent folder of the external item.

Note

Syncro SVN Client does not support definitions of local relative external items.

Open (Ctrl (Command on OS X) + O)

This action opens the selected file in an editor where you can modify it. The action is active only when a single item is selected. The action opens a file with the internal editor or the external application associated with that file type. This action works on any file selection from the Repositories view, Working Copy view, History view, or Directory Change Set view, depending on the view that was last used to invoke it. In the case of a folder, the action opens the selected folder with the system application for folders (for example, Windows Explorer on Windows or Finder on OS X, etc). Note that opening folders is available only for folders selected in the Working Copy view.

Open with(Ctrl (Command on OS X) + Shift + O)

Displays the Open with dialog box for specifying the editor in which the selected file is opened. If multiple files are selected only external applications can be used to open the files. This action works on any file selection from Repositories view, Working Copy view, History view, or Directory Change Set view, depending on the view that was last used to invoke it.

Show in Explorer/Show in Finder

Opens the parent directory of the selected working copy file and selects the file.

Save (Ctrl (Command on OS X) + S)

Saves the local file currently opened in the editor or the Compare view.

Save as

Saves any file selected in the Repositories, History, or Directory Change Set view.

Copy URL Location (Ctrl (Command on OS X) + Alt + U)

Copies the URL location of the resource currently selected in the Repositories view to clipboard.

Copy to

Copies the currently selected resource, either in Repositories or Working copy view, to a specified location.

Note

This action can also be used from History and Directory Change Set views to recover older versions of a repository item.

Move to(Ctrl (Command on OS X) + M)

Moves the currently selected resource, either in Repositories or Working copy view, to a specified location.

Rename(F2)

Renames the resource currently selected, either in Repositories or Working copy view.

Delete (Delete)

Deletes the resource currently selected either, in Repositories or Working copy view.

Locking:

• Scan for locks (Ctrl (Command on OS X) + L) - Contacts the repository and recursively obtains the list of locks for the selected resources. A dialog box containing the locked files and the lock description will be displayed. This is only active for resources under version control. For more details see Scanning for locks.

• Lock (Ctrl (Command on OS X) + K) - Allows you to lock certain files that need exclusive access. You can write a comment describing the reason for the lock and you can also force (steal) the lock. This action is active only on files under version control. For more details on the use of this action see Locking a file.

• Unlock (Ctrl (Command on OS X) + Alt + K) - Releases the exclusive access to a file from the repository. You can also choose to unlock it by force (break the lock).

Show SVN Properties (Ctrl (Command on OS X) + P)

Opens the Properties view and displays the SVN properties for a selected resource from Repositories view or Working Copy view, depending on the view that was last used to invoke it.

Show SVN Information (Ctrl (Command on OS X) + I)

Provides additional information for a selected resource. For more details, go to Obtain information for a resource.

Exit (Ctrl (Command on OS X) + Q)

Closes the application.

Edit Menu

Undo (Ctrl (Command on OS X) + Z)

Undo edit changes in the local file that is currently opened in the editor or the Compare view.

Redo (Ctrl (Command on OS X) + Y)

Redo edit changes in the local file that is currently opened in the editor or the Compare view.

Cut (Ctrl (Command on OS X) + X)

Cut selection from the local file that is currently opened in the editor view or the Compare view to clipboard.

Copy (Ctrl (Command on OS X) + C)

Copy selection from the local file that is currently opened in the editor or the Compare view to clipboard.

Paste (Ctrl (Command on OS X) + V)

Paste selection from clipboard into the local file that is currently opened in editor or the Compare view.

Find/Replace (Ctrl (Command on OS X) + F)

Perform find and replace operations in the local file that is currently opened in the editor or the Compare view.

Find Next (F3)

Go to the next match using the same find options of the last find operation. This action runs in the editor panel and in any non-editable text area (for example, the Console view).

Find Previous (Shift + F3)

Go to the previous match using the same find options of the last find operation. This action runs in the editor panel and in any non-editable text area (for example, the Console view).

Repository Menu

New Repository Location ( Ctrl + Alt + N (Command + Alt + N on OS X) )

Displays the Add SVN Repository dialog box. This dialog box allows you to define a new repository location.

Add SVN Repository Dialog Box

If the Validate repository connection option is selected, the URL connection is validated before being added to the Repositories view.

Edit Repository Location ( Ctrl + Alt + E (Command + Alt + E on OS X) )

Context-dependent action that allows you to edit the selected repository location using the Edit SVN Repository dialog box. It is active only when a repository location root is selected.

Change the Revision to Browse ( Ctrl + Alt + B (Command + Alt + B on OS X) )

Context-dependent action that allows you to change the selected repository revision using the Change the Revision to Browse dialog box. It is active only when a repository location root is selected.

Remove Repository Location ( Ctrl + Alt + R (Command + Alt + R on OS X) )

Allows you to remove the selected repository location from the view. It shows you a confirmation dialog box before removal. It is active only when a repository location root is selected.

Refresh ( F5 )

Refreshes the resource selected in the Repositories view.

Check out ( Ctrl + Alt + O (Command + Alt + O on OS X) )

Allows you to create a working copy from a repository directory, on your local file system. To read more about this operation, see the section Check out a working copy.

Export

Opens the Export dialog box that allows you to configure options for exporting a folder from the repository to the local file system.

Import:

Import folder ( Ctrl + Shift + L (Command + Shift + L on OS X) )

Allows you to import the contents of a specified folder from the file system into the selected folder in a repository. To read more about this operation, see the section Importing resources into a repository.

Note

The difference between the Import folder and Share project actions is that the latter also converts the selected directory into a working copy.

Import Files ( Ctrl + Shift + I (Command + Shift + I on OS X) )

Imports the files selected from the files system into the selected folder in the repository.

Working Copy Menu

( on OS X)Working Copies Manager

Opens a dialog box with a list of working copies that the Apache Subversion™ client is aware of. In this dialog box you can add existing working copies or remove those that are no longer needed.

Switch to

Selects one of the following view modes: All Files, Modified, Incoming, Outgoing, or Conflicts.

Refresh (F5)

Refreshes the state of the selected resources or of the entire working copy (if there is no selection).

Synchronize (Ctrl (Command on OS X) + Shift + S)

Connects to the repository and determines the working copy and repository changes made to the selected resources. The application switches to Modified view mode if the Always switch to 'Modified' mode option is selected.

Update (Ctrl (Command on OS X) + U)

Updates all the selected resources that have incoming changes to the HEAD revision. If one of the selected resources is a directory then the update for that resource will be recursive.

Update to revision/depth

Allows you to update the selected resources from the working copy to an earlier revision from the repository. You can also select the update depth for the current folder. You can find out more about the depth term in the sparse checkouts section.

Commit

Collects the outgoing changes from the selected resources in the working copy and allows you to choose exactly what resources to commit. A directory will always be committed recursively. Unversioned resources will be deselected by default. In the Commit dialog box you can also enter a comment before sending your changes to the repository.

Update all(Ctrl (Command on OS X) + Shift + U)

Updates all resources from the working copy that have incoming changes. It performs a recursive update on the synchronized resources.

Commit all

Commits all the resources with outgoing changes. It is disabled when Incoming mode is selected or the synchronization result does not contain resources with outgoing changes. It performs a recursive commit on the synchronized resources.

Revert (Ctrl (Command on OS X) + Shift + V)

Undoes all local changes for the selected resources. It does not contact the repository and the files are obtained from Apache Subversion™ pristine copy. It is enabled only for modified resources. See Revert your changes for more information.

Edit conflict (Ctrl (Command on OS X) + E)

Opens the Compare editor, allowing you to modify the content of the currently conflicting resources. For more information about editing conflicts, see Edit conflicts.

Mark Resolved (Ctrl (Command on OS X) + Shift + R)

Instructs the Subversion system that you resolved a conflicting resource. For more information, see Merge conflicts.

Mark as Merged (Ctrl (Command on OS X) + Shift + M)

Instructs the Subversion system that you resolved the pseudo-conflict by merging the changes and you want to commit the resource. Read the Merge conflicts section for more information about how you can solve the pseudo-conflicts.

Override and Update

Drops any outgoing change and replaces the local resource with the HEAD revision. This action is available on resources with outgoing changes, including conflicting ones. See the Revert your changes section.

Override and Commit

Drops any incoming changes and sends your local version of the resource to the repository. This action is available on conflicting resources. For more information see Drop incoming modifications.

Mark as copied

You can use this action to mark an item from the working copy as a copy of an other item under version control, when the copy operation was performed outside of an SVN client. The Mark as copied action is available when you select two items (both the new item and source item), and it depends on the state of the source item.

Mark as moved

You can use this action to mark an item from the working copy as being moved from another location of the working copy, when the move operation was performed outside of an SVN client. The Mark as moved action is available when you select two items from different locations (both the new item and the source item that is usually reported as missing), and it depends on the state of the source item.

Mark as renamed

You can use this action to mark an item from the working copy as being renamed outside of an SVN client. The Mark as renamed action is available when you select two items from the same directory (both the new item and the source item that is usually reported as missing), and it depends on the state of the source item.

Add to "svn:ignore" (Ctrl (Command on OS X) + Alt + I)

Allows you to add files that should not participate in the version control operations inside your working copy . This action can only be performed on resources not under version control. It actually modifies the value of the svn:ignore property in the parent directory of the resource. Read more about this in the Ignore Resources Not Under Version Control section.

Add to version control (Ctrl (Command on OS X) + Alt + V)

Allows you to add resources that are not under version control. For further details, see Add Resources to Version Control section.

Remove from version control

Schedules selected items for deletion from repository upon the next commit. The items are not removed from the file system after committing.

Clean up (Ctrl (Command on OS X) + Shift + C)

Performs a maintenance cleanup operation on the selected resources from the working copy. This operation removes the Subversion maintenance locks that were left behind. This is useful when you already know where the problem originated and want to fix it as quickly as possible. It is only active for resources under version control.

Expand All (Ctrl (Command on OS X) + Alt + X)

Displays all descendants of the selected folder. The same behavior is obtained by double-clicking a collapsed folder.

Collapse all (Ctrl (Command on OS X) + Alt + Z)

Collapses all descendants of the selected folder. The same behavior is obtained by double-clicking a expanded folder.

Compare Menu

Perform Files Differencing

Looks for differences between the two files displayed in the left and right side panels.

Next Block of Changes ( Ctrl + Period (Command + Period on OS X) )

Jumps to the next block of changes. This action is disabled when the cursor is positioned on the last change block or when there are no changes.

Note

A change block groups one or more consecutive lines that contain at least one change.

Previous Block of Changes ( Ctrl + Comma (Command + Comma on OS X) )

Jumps to the previous block of changes. This action is disabled when the cursor is positioned on the first change block or when there are no changes.

Next Change ( Ctrl + Shift + Period (Command + Shift + Period on OS X) )

Jumps to the next change from the current block of changes. When the last change from the current block of changes is reached, it highlights the next block of changes. This action is disabled when the cursor is positioned on the last change or when there are no changes.

Previous Change ( Ctrl + Shift + Comma (Command + Shift + M on OS X) )

Jumps to the previous change from the current block of changes. When the first change from the current block of changes is reached, it highlights the previous block of changes. This action is disabled when the cursor is positioned on the first change or when there are no changes.

Last Change ( Ctrl + E (Command + E on OS X) )

Jumps to the last change.

First Change ( Ctrl + B (Command + B on OS X) )

Jumps to the first change.

Copy All Changes from Right to Left

Copies all changes from the file in the right panel to the file in the left panel.

Copy Change from Right to Left

Copies the selected difference from the file in the right panel to the file in the left panel.

Show Word Level Details

Provides a word-level comparison of the selected change.

Show Character Level Details

Provides a character-level comparison of the selected change.

Format and Indent Both Files ( Ctrl + Shift + P (Command + Shift + P on OS X) )

Formats and indents both files before comparing them. Use this option for comparisons that contain long lines that make it difficult to spot differences.

Note

When comparing two JSON files, the Format and Indent Both Files action will automatically sort the keys in both files the same to make it easier to compare.

Ignore Whitespaces

Enables or disables the whitespace ignoring feature. Ignoring whitespace means that before performing the comparison, the application normalizes the content and trims its leading and trailing whitespaces.

History Menu

Show History(Ctrl (Command on OS X) + H)

Displays the history for a SVN resource at a given revision. The resource can be one selected from the Repositories view, Working Copy view, or from the Affected Paths table from the History view, depending on which view was last focused when this action was invoked.

Show Annotation ( Ctrl + Shift + A (Command + Shift + A on OS X) )

Opens the Show Annotation dialog box that computes the annotations for a file and displays them in the Annotations view, along with the history of the file in the History view.

Repositories

This operation is available for any resource selected from view, Working Copy view, History view or Directory Change Sets view, depending on which view was last focused when this action was invoked.

Revision Graph (Ctrl (Command on OS X) + G)

This action allows you to see the graphical representation of a resource's history. For more details about a resource's revision graph see the section Revision Graph. This operation is enabled for any resource selected into the Repositories view or Working Copy view.

Tools Menu

Share project

Allows you to share a new project using an SVN repository. The local project is automatically converted into an SVN working copy.

Branch / Tag

Allows you to copy the selected resource from the Repositories view or Working Copy view to a branch or tag into the repository. To read more about this operation, see the section Creating a Branch / Tag.

Merge (Ctrl (Command on OS X) + J)

Allows you to merge the changes made on one branch back into the trunk, or vice versa, using the selected resource from the working copy. To read more about this operation, see the section Merging.

Switch (Ctrl (Command on OS X) + Alt + W)

Allows you to change the repository location of a working copy, or only of a versioned item of the working copy, within the same repository. It is available when the selected item of the working copy is a versioned resource, except for external items. To read more about this action, see the Switching the Repository Location section.

Relocate

Allows you to change the base URL of the root folder of the working copy to a new URL when the base URL of the repository changed. For example, if the repository itself was moved to a different server. This operation is only available for the root item of the working copy. To read more about this operation, see the Relocate a Working Copy section.

Create patch (Ctrl (Command on OS X) + Alt + P)

Allows you to create a file containing all the differences between two resources, based on the svn diff command. To read more about creating patches, see the section about patches.

Working copy format

This submenu contains the following two operations:

Upgrade

Upgrades the format of the currently loaded working copy to the newest one known by Syncro SVN Client. This allows you to benefit of all the new features of the client.

Downgrade

Downgrades the format of the currently loaded working copy to SVN 1.7 format. This is useful if you want to use older SVN clients with the current working copy, or, by mistake, you have upgraded the format of an older working copy to SVN 1.8.

Note

SVN 1.7 working copies cannot be downgraded to older formats.

See the section Working Copy Format to read more about this subject.

Options Menu

Preferences

Opens the Preferences dialog box.

Menu Shortcut Keys

Opens the Menu Shortcut Keys preferences page, where users can configure in one place the keyboard shortcuts available for menu items available in Syncro SVN Client.

Global Run-Time Configuration

Allows you to configure SVN general options, that should be used by all the SVN clients you may use:

• Edit 'config' file - In this file you can configure various SVN client-side behaviors.
• Edit 'servers' file - In this file you can configure various server-specific protocol parameters, including HTTP proxy information and HTTP timeout settings.

Export Options

Allows you to export the current options to an XML file.

Import Options

Allows you to import options you have previously exported.

Reset Options

Resets all your options to the default ones.

Reset Authentication

Resets the Subversion authentication information.

Window Menu

Show View

Allows you to select the view you want to bring to front.

Show Toolbar

Allows you to select the toolbar you want to be visible.

Enable flexible layout

Toggles between a fixed and a flexible layout. When the flexible layout is enabled, you can move and dock the internal views to adapt the application to various viewing conditions and personal requirements.

Reset Layout

Resets all the views to their default position.

Help Menu

Help (F1)

Opens the Help dialog box.

Use online help (Enabled by default)

If this option is enabled, when you select Help or press F1 while hovering over any part of the interface, Syncro SVN Client attempts to open the help documentation in online mode. If this option is disabled or an internet connection fails, the help documentation is opened in offline mode.

Show Dynamic Help view

Displays the Dynamic Help view.

Check for a New Version

Checks the availability of new Syncro SVN Client versions.

Browse Syncro SVN Client Website

Opens the Syncro SVN Client website in a browser.

Register

Opens the registration dialog box.

Report Problem

Opens a dialog box that allows you to write the description of a problem that was encountered while using the application.

Support Center

Opens the Support Center web page in a browser.

Support Tools ⇒ Clipboard Inspector

Opens a dialog box that displays extensive details of all the transferable objects from the clipboard. This is helpful if you experience problems while copying content from other applications and pasting it into Syncro SVN Client. You can use the Copy button to copy all of this data and then paste it into an email to be sent to the Syncro SVN Client support team.

About

Opens the About dialog box.

The toolbar of the Syncro SVN Client SVN Repositories window contains the following actions:

Check out

Checks out a working copy from a repository. The repository URL and the working copy format must be specified.

Synchronize

Synchronizes the current working copy with the repository.

Update All

Updates all resources of the working copy that have an older revision that repository.

Commit All

Commits all resources of working copy that have a newer version compared to that of the repository.

Refresh

Refreshes the whole content of the current working copy from disk starting from the root folder. At the end of the operation, the modified files and folders that were not committed to repository yet, are displayed in the Working Copy view.

Compare

The selected resource is compared with:

• The BASE revision, when the selected resource is:
  • Locally modified and the All Files view mode is currently selected (no matter if there are incoming changes).
  • Locally modified and there are no incoming changes when any other view mode is selected.
• The remote version of the same resource, when remote information is available after a Synchronize operation (only when one of Modified, Incoming, Outgoing and Conflicts view modes is selected).
• The working copy revision, when the selected resource is from the History view.

Show History

Displays the history of the selected resource (from the Working Copy or Repository views) in the History view.

Show Annotation

Displays the annotations of the selected resource. The selected resource can be in the Working Copy or the History views.

Revision Graph

Displays the revision graph of the selected resource. The selected resource can be in the Working Copy or the Repositories views.

Enable/Disable flexible layout

Toggles between a fixed and a flexible layout. When the flexible layout is enabled, you can move and dock the internal views to adapt the application to various viewing conditions and personal requirements.

The status bar of the Syncro SVN Client window displays important details of the current status of the application. This information is available only in the Working Copy view.

Status bar

The status bar is composed of the following areas:

• The path of the currently processed file from the current working copy (during an operation such as Check out or Synchronize) or the result of the last operation.
• The current status of the following working copy options:
  • Show ignored files ( ).
  • Show deleted files ( ).
  • Process svn:externals definitions ( ).
  The options for ignored and deleted files are switched on and off from the Settings menu of the Working Copy panel:
• The format of the currently loaded working copy.
• The current numbers of incoming changes ( ), outgoing changes ( ) and conflicting changes ( ).
• A progress bar for the currently running SVN operation and a button ( ) that allows you to stop it.

This section explains how to add and edit the repository locations in Syncro SVN Client.

Even if you start developing a new project, or you want to migrate an existing one to Subversion, the Syncro SVN Client allows you to easily share it with the rest of your team. The shared project directory is automatically converted to a working copy and added under Syncro SVN Client management. The Share project action is available in the Tools menu and the contextual menu of the Repositories view.

Share Project Dialog Box

The following options can be configured in the Share project dialog box:

Project

The location of the project folder on the local disk by using the text box or the Browse button. This folder should not be empty or already under version control.

Important

By default, the SVN system only imports the content of the specified folder, and not the root folder itself. Therefore, it is recommended to use the Browse button to select the project folder so that the client will automatically append the name of it to the specified URL.

URL

The new location of the project (inside the repository) that will be used to access it.

Note

Peg revisions have no effect for this operation since it is used to send information to the repository.

Attention

If the new location already exists, make sure that it is an empty directory to avoid mixing your project content with other files (if items exist with the same name, an error will occur and the operation will not proceed). Otherwise, if the address does not exist, it is created automatically.

Format

The SVN format of the working copy. You can choose between SVN 1.8 or SVN 1.7.

Share files matching global ignore patterns

When enabled, the file names that match the patterns defined in either of the following locations are also imported into the repository:

• The global-ignores property in the SVN configuration file.
• The File name ignore patterns option in the SVN ⇒ Working Copy preferences page.

Enable automatic properties/Disable automatic properties

Enables or disables automatic property assignment (per runtime configuration rules), overriding the enable-auto-props runtime configuration directive, defined in the SVN configuration file.

Note

This option is available only when there are defined properties to be applied automatically for newly added items under version control. You can define these properties in the SVN config file (in the auto-props section). Based on the value of the enable-auto-props runtime configuration directive, the presented option is either Enable automatic properties, or Disable automatic properties.

An Apache Subversion™ working copy is an ordinary directory tree on your local system, containing a collection of files. You can edit these files however you want, your working copy being your private work area. To make your own changes available to others or incorporate changes made by others, you must explicitly tell Subversion to do so. You can even have multiple working copies of the same project.

Working Copy View

A Subversion working copy also contains some extra files, created and maintained by Subversion, to help it keep track of your files. In particular, each directory in your working copy contains a subdirectory named .svn, also known as the working copy administrative directory. This administrative directory contains an unaltered copy of the last updated files from the repository. This copy is usually referred to as the pristine copy or the BASE revision of the working copy. These files help Subversion recognize which files contain unpublished changes, and which files are out-of-date with respect to others' work.

A typical Subversion repository often holds the files (or source code) for several projects. Usually each project is a subdirectory in the repository's file system tree. In this arrangement, a user's working copy usually corresponds to a particular sub-tree of the repository.

This section explains how to work with the resources that are displayed in the Working Copy view.

In the work cycle you will need to incorporate other people's changes (update) and to make your own work available to others (commit). This is what the Incoming and Outgoing modes of the Working Copy view was designed for, to help you send and receive modifications from the repository.

The Incoming and Outgoing modes of this view focus on incoming and outgoing changes. The incoming changes are the changes that other users have committed in the repository since you last updated your working copy. The outgoing changes are the modifications you made to your working copy as a result of editing, removing or adding resources.

The view presents the status of the working copy resources against the BASE revision after a Refresh operation. You can view the state of the resources versus a repository HEAD revision by using the Synchronize action from the Working Copy view.

This section explains how to obtain information for a SVN resource:

In the Properties view you can read and set the Apache Subversion™ properties of a file or folder. There is a set of predefined properties with special meaning to Subversion. For more information about properties in Subversion see the SVN Subversion specification. Subversion properties are revision dependent. After you change, add or delete a property for a resource, you have to commit your changes to the repository.

If you want to change the properties of a given resource you need to select that resource from the Working Copy view and run the Show properties action from the contextual menu. The Properties view will show the local properties for the resource in the working copy. Once the Properties view is visible, it will always present the properties of the currently selected resource. There are actions available in the Properties view toolbar that allow you to add, change, and delete the properties.

If you choose the Add a new property action, a new dialog box will appear that contains the following:

• Name - Combo box that allows you to enter the name of the property. The drop-down menu of the combo box presents the predefined Subversion properties (such as svn:ignore, svn:externals, svn:needs-lock, etc.)
• Current value - Text area that allows you to enter the value of the new property.

If you want to change the value for a previously set property, you can use the Edit property action, which will display a dialog box with the following information:

• Name - Property name (cannot be changed).
• Current value - The current value (can be changed).
• Base value - The value of the property, if any, from the resource in the pristine copy (cannot be changed).

If you want to completely remove a property previously set you can choose the Remove property action. It will display a confirmation dialog box in which you can also choose if the property will be removed recursively.

There is a Refresh action in the Properties view that can be used when the properties have been changed from outside the view. This can happen, for example, when the view was already presenting the properties of a resource and they have been changed after an Update operation.

One of the fundamental features of version control systems is the ability to create a new line of development from the main one. This new line of development will always share a common history with the main line if you look far enough back in time. This line is known as a branch. Branches are mostly used to try out features or fixes. When the feature or fix is finished, the branch can be merged back into the main branch (trunk).

Another feature of version control systems is the ability to take a snapshot of a particular revision, so you can at any time recreate a certain build or environment. This is known as tagging. Tagging is especially useful when making release versions.

In Apache Subversion™ , there is no difference between a tag and a branch. On the repository, both are ordinary directories that are created by copying. The trick is that they are cheap copies instead of physical copies. Cheap copies are similar to hard links in Unix, which means that they merely link to a specific tree and revision without making a physical copy. As a result, branches and tags occupy little space on the repository and are created very quickly.

Provided that nobody ever commits to the directory in question, it remains a tag. If people start committing to it, it becomes a branch.