Earlier versions documentation can be found here.

After installing R# Settings Manager it will add 'Settings Manager' node to the Resharper 'Options' dialog, under Tools tree node and 'Tools\Manage Settings...' menu item in the 'Resharper' menu.

RSM Options Page

RSM Options Page.png

Available options:
  1. Personal Settings Folder - a folder containing your personal settings files. Please note that this folder is not meant to contain any settings, shared among team members for a specific solution. It should be used for storing your personal settings, for back-up purposes for example. For settings sharing configuration please use the options available at 'Manage Settings' dialog described below.
  2. Default settings file - you can specify which of the availale personal settings files will be loaded by default for solutions without settings sharing configured. Use 'Manage Settings' dialog to create\edit personal settings files.

'Manage Settings...' menu item

Manage Settings Menu Item.png

Clicking on 'Manage Settings...' menu item will display the Manage Settings Dialog.

Manage Settings Dialog.png

The dialog contains a list of files in the specified personal settings folder and all available shared settings files for the current solution (only available if a solution was loaded).
Available options:
  1. Add drop-down - creates new settings file and displays Settings File Options Dialog described below.
    1. Personal Settings button - creates new personal settings file with the specified name at the personal settings folder, configured at the RSM options page.
    2. Solution Settings - creates new solution settings file with the name of the currently loaded solution at the solution folder. The file will be loaded by the current solution only, i.e. it won't be available for other solutions at the same folder. See Configuring Settings Sharing section for details.
    3. Global Settings - creates new global settings file at the specified location. Global settings files can be used to share settings across multiple solutions located at the global settings file folder and sub-folders. See Configuring Settings Sharing section for details.
  2. Remove button - removes the selected settings file.
  3. Update R# Settings button - updates the selected setting file with the current Resharper configuration.
  4. Load R# Settings button - loads the settings from a selected file. Clicking the 'Advanced...' menu item will show the 'Load Settings Options' dialog described below.
  5. Configure button - displays Settings File Options Dialog described below.

Settings File Options Dialog

Settings File Options Dialog.png

The content of this page is only available if you have a solution opened.

Available options:
  1. Update Common settings automatically - If checked the settings file will be automatically updated with common settings changes (spell-check dictionaries, abbreviation lists and etc) each time the solution is closed. All other settings (Code style, Inspection Severity and etc) will remain unchanged.
  2. Store R# settings in an external file - Allows you to specify an external settings file path with the actual R# settings.
  3. Absolute path - Changes the external settings file path to absolute.
  4. Stored ReSharper Settings - Defines which of the available R# settings will be stored in the file. See Configuring Settings Sharing section for details.

Load Settings Options Dialog

Load Settings File Options Dialog.png

In the check-box list you can specify which settings to load from the selected file. This might be helpful if you need to update the specific configuration section from the chosen file.

Configuring Settings Sharing

When working with multiple solutions it is sometimes needed to adjust a portion of R# configuration for a single solution and\or a group of solutions. In previous releases you could achieve that by creating a solution settings file, but that created a separate file for a single solution. You could also move those solutions to a separate folder and create a shared settings file at that folder. Both approaches created new settings files making it difficult to maintain base R# configuration across all your solutions.

Starting from v4.0 RSM introduces new model of settings sharing, making it possible to define several shared settings files at different folder levels and configure which settings should be loaded by each file. Whenever you load a solution, RSM will first try to locate the corresponding solution settings file, then it will start inspecting the current folder and all parent folders for global settings. This way RSM may locate several settings files available for the current solution and will load them one by one, taking into account which settings groups were already loaded. For example, you can create a global settings file at the root project folder with default R# configuration and a solution settings file or a global settings file located at a sub-folder, containing only highlighting settings. RSM will first find the file with highlighting settings and load it, then it will locate the root settings file and load the remaining settings. This way you can override any part of R# configuration based on your requirements.

Assigning 'Manage Settings' Dialog Shortcut

You can assign a shortcut in VS Tools\Options dialog as shown below:

Assigning Shortcut.png

Last edited Apr 15, 2011 at 1:06 PM by 4uxnbIx, version 2

Comments

No comments yet.