# DITA Best Practices : The oXygen Menus

Created by Todd Stupnik, last modified on Nov 21, 2014

The main menu of the Oxygen XML Editor is composed of the following menus:

- File menu:
  - New submenu:
    - New File - This operation creates a file in the working copy and adds it to version control. If the selected path is not under version control, the newly created file is added to the repository only by an explicit action. Creating a file in the working copy does not add it automatically to the repository. This action works only for selected paths in the Working Copy tree.
    - New Folder (Ctrl (Meta on Mac OS) + Shift + F) - This operation creates a new folder as child of the selected folder from the Repositories view tree or from the Working Copy view tree, depending on which view was focused last when performing this action. For the Working Copy view, the folder is added to version control only if the selected path is under version control, otherwise the newly created directory is not added to version control.
    - New External Folder (Ctrl (Meta on Mac OS) + Shift + W) - This operation sets a folder name in the property`svn:externals`of the selected folder. The repository URL to the folder to which the new external folder points and the revision number of that repository URL can be selected easily with the Browse and History buttons of the dialog. This action works only for selected paths in the Working Copy tree.

      Subversion 1.5 clients and higher support relative external URLs. You can specify the repository URLs to which the external folders point using the following relative formats:

      - ../ - Relative to the URL of the directory on which 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 on which the`svn:externals`property is set.
      - / - Relative to the root URL of the server on which the`svn:externals`property is versioned.
  - Open (Ctrl (Meta on Mac OS) + 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. In case of a folder the action opens the selected folder with the system application for folders (for example Windows Explorer on Windows, Finder on Mac OS X, etc). Folder opening is available only for folders selected in the Working Copy view. This action works on any file selection from the Repositories view, Working Copy view, History view or Directory Change Set view, depending on which view was last focused when invoking it.
  - Open with(Ctrl (Meta on Mac OS) + Shift + O) - Displays the Open with dialog for specifying the editor in which the selected file is opened. In case 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 which view was last focused when invoking it.

  - Show in Explorer/Show in Finder - Opens the parent directory of the selected working copy file and selects the file.

  - Save (Ctrl (Meta on Mac OS) + S) - Saves the local file currently opened in the editor or the Compare view.
  - Save as - Saves locally any file selected in the Repositories, History, and Directory Change Sets view.
  - Copy URL Location (Ctrl (Meta on Mac OS) + Alt + U) - Copies to clipboard the URL location of the resource currently selected in the Repositories view.
  - Copy to - Copies to a specified location the currently selected resource(s) either in Repositories or Working copy view.
    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 (Meta on Mac OS) + M) - Moves to a specified location the currently selected resource(s) either in Repositories or Working copy view.

  - 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 (Meta on Mac OS) + L) - Contacts the repository and recursively obtains the list of locks for the selected resources. A dialog containing the locked files and the lock description will be displayed. Only active for resources under version control. For more details see Scanning for locks.

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

    - Unlock (Ctrl (Meta on Mac OS) + 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 (Meta on Mac OS) + Shift + P) - Brings up the Properties view and displays the SVN properties for a selected resource from Repositories view or Working Copy view, depending on which view was last focused when invoking it.
  - File Information (Ctrl (Meta on Mac OS) + I) - Provides additional information for a selected resource from the Working Copy view. For more details please see the section Obtain information for a resource.
  - Exit (Ctrl (Meta on Mac OS) + Q) - Closes the application.
- Edit menu:
  - Undo (Ctrl (Meta on Mac OS) + Z) - Undo edit changes in the local file currently opened in the editor or the Compare view.
  - Redo (Ctrl (Meta on Mac OS) + Y) - Redo edit changes in the local file currently opened in the editor or the Compare view.
  - Cut (Ctrl (Meta on Mac OS) + X) - Cut selection to clipboard from the local file currently opened in the editor view or the Compare view.
  - Copy (Ctrl (Meta on Mac OS) + C) - Copy selection to clipboard from the local file currently opened in the editor or the Compare view.
  - Paste (Ctrl (Meta on Mac OS) + V) - Paste selection from clipboard in the local file currently opened in editor or the Compare view.
  - Find/Replace (Ctrl (Meta on Mac OS) + F) - Perform find / replace operations in the local file currently opened in the editor or the Compare view.
  - Find Next (F3) - Go to the next find match using the same find options of the last find operation. The 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 find match using the same find options of the last find operation. The action runs in the editor panel and in any non-editable text area, for example the Console view.
- Repository menu:
  - New Repository Location (Ctrl (Meta on Mac OS) + Alt + N) - Displays the Add SVN Repository dialog. This dialog 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 (Meta on Mac OS) + Alt + E) - Context-dependent action that allows you to edit the selected repository location using the Edit SVN Repository dialog. It is active only when a repository location root is selected.
  - Change the Revision to Browse (Ctrl (Meta on Mac OS) + Alt + Shift + B) - Context-dependent action that allows you to change the selected repository revision using the Change the Revision to Browse dialog. It is active only when a repository location root is selected.
  - Remove Repository Location (Ctrl (Meta on Mac OS) + Alt + Shift + R) - Allows you to remove the selected repository location from the view. It shows you a confirmation dialog before removal. It is active only when a repository location root is selected.
  - Refresh - Refreshes the resource selected in the Repositories view.
  - Check out (Ctrl (Meta on Mac OS) + Alt + Shift + C) - 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 - Exports a folder from the repository to the local file system.

  - Import sub-menu:
    - Import Folder Content (Ctrl (Meta on Mac OS) + Alt + Shift + M) - Depending on the selected folder from a repository, allows you to import the contents of a specified folder from the file system into it. To read more about this operation, see the section Importing resources into a repository.
      Note: The difference between Import Folder Content and Share project actions is that the latter one also converts the selected directory into a working copy.
    - Import File(s) (Ctrl (Meta on Mac OS) + Alt + I) - Imports the files selected from the files system into the selected folder from the repository.
- Working Copy menu:
  - ( on Mac OS X) Working Copies Manager - Opens dialog with a list of working copies that the Apache SubversionTM client is aware of. In this dialog you can add existing working copies or remove no longer needed ones.
  - 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 (Meta on Mac OS) + 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 (Meta on Mac OS) + 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 to commit by selecting or not resources. A directory will always be committed recursively. The unversioned resources will be deselected by default. In the commit dialog you can also enter a commit comment before sending your changes to the repository.

  - Update all (Ctrl (Meta on Mac OS) + 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 (Meta on Mac OS) + Shift + V) - Undoes all local changes for the selected resources. It does not contact the repository, the files are obtained from Apache SubversionTM pristine copy. It is enabled only for modified resources. See Revert your changes for more information.

  - Edit conflict (Ctrl (Meta on Mac OS) + E) - Opens the Compare editor, allowing you to modify the content of the currently conflicting resources. For more information on editing conflicts, see Edit conflicts.

  - Mark Resolved (Ctrl (Meta on Mac OS) + Shift + R) - Instructs the Subversion system that you resolved a conflicting resource. For more information, see Merge conflicts.

  - Mark as Merged (Ctrl (Meta on Mac OS) + 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. Action available on resources with outgoing changes, including the 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. Action available on conflicting resources. See also the section 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 one and the source one) and depends on the state of the source item.
    Note: If you use an SVN 1.6 working copy or older, this action does not apply for directories.
  - 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 one and the source one (usually reported as missing)) and depends on the state of the source item.
    Note: If you use an SVN 1.6 working copy or older, this action does not apply for directories.
  - 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 one and the source one (usually reported as missing)) and depends on the state of the source item.
    Note: If you use an SVN 1.6 working copy or older, this action does not apply for directories.

  - Add to "svn:ignore" (Ctrl (Meta on Mac OS) + Alt + I) - Allows you to keep inside your working copy files that should not participate to the version control operations. This action can only be performed on resources not under version control. It actually modifies the value of the svn:ignore property of the resource's parent directory. Read more about this in the Ignore Resources Not Under Version Control section.

  - Add to version control (Ctrl (Meta on Mac OS) + Alt + V) - Allows you to schedule for addition 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 (Meta on Mac OS) + Shift + C) - Performs a maintenance cleanup operation to the selected resources from the working copy. This operation removes the Subversion maintenance locks that were left behind. Useful when you already know where the problem originated and want to fix it as quickly as possible. Only active for resources under version control.

  - Expand all (Ctrl (Meta on Mac OS) + Alt + X) - Displays all descendants of the selected folder. You can obtain a similar behavior by double-clicking on a collapsed folder.
  - Collapse all (Ctrl (Meta on Mac OS) + Alt + Z) - Collapses all descendants of the selected folder. The same behavior is obtained by double-clicking on a expanded folder.
- Compare menu:

  - Perform Files Differencing - performs a comparison between the source and target files;

  - Next Block of Changes - 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 in the document;

  - Previous Block of Changes - 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 in the document;

  - Next Change - 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;

  - Previous Change - 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;

  - Last Change - jumps to the last change from the current file;

  - First Change - jumps to the first change from the current file;

  - Copy All Non-Conflicting Changes from Right to Left - This action copies all non-conflicting changes from the right editor to the left editor. A non-conflicting change from the right editor is a change that does not overlap with a left editor change.
  - Copy Change from Right to Left (Ctrl (Meta on Mac OS) + Shift + Comma) - This action copies the selected change from the right editor to the left editor.

  - 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.

  - Ignore Whitespaces - Enables or disables the whitespace ignoring feature. Ignoring whitespace means that before the strings are compared they are first normalized and then the whitespace at the beginning and the end of the strings is trimmed.
- History menu:
  - Show History (Ctrl (Meta on Mac OS) + 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 (Meta on Mac OS) + Shift + A) - Complex action that does the following operations:
    - opens the selected resource in the Annotations editor;
    - displays corresponding annotations list in the Annotations view;
    - displays the history of the selected resource.

  - This operation is available for any resource selected from Repositories 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 (Meta on Mac OS) + Shift + 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 (Meta on Mac OS) + 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 (Meta on Mac OS) + 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 an external folder. To read more about this action, see the section Switching the Repository Location.
  - 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 the repository itself was relocated to a different server. This operation is available for a selected item of the working copy tree that is a versioned folder. To read more about this operation, see the section Relocate a Working Copy.
  - Create patch (Ctrl (Meta on Mac OS) + 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 - Allows you to upgrade the format of the current working copy to the newest one known by Syncro SVN Client, to allow you to benefit of all the new features of the client.
    - Downgrade - Allows you to downgrade the format of the current working copy to an older format. The formats allowed to downgrade to are SVN 1.5 and SVN 1.4. This is useful in case you wish to use older SVN clients with the current working copy, or, by mistake, you have upgraded the format of an older working copy by using a newer SVN client.
      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.
  - Menu Shortcut Keys - Opens the Preferences dialog directly on the Menu Shortcut Keys option 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 a 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 different viewing conditions and personal requirements.
  - Reset Layout - Resets all the views to their default position.
- Help menu:
  - Help (F1) - Opens the Help dialog.
  - Dynamic Help - Shows the Dynamic Help view.
  - Check for New Versions - Checks the availability of new Oxygen XML Editor versions.
  - Register - Opens the registration dialog.
  - Improvement Program Options - Allows you to activate or deactivate the Syncro Soft Product Improvement Program.
  - Report Problem - Opens a dialog that allows the user 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.