VSdocman allows you to define profiles with various settings for projects and solutions. This works the same way as configurations in VS.

There are two kinds of profiles:

  1. Project profile
  2. Solution profile

Each solution and project has always at least one profile named "default". This profile cannot be deleted. If you don't need more profiles, the "default" profile is all you need for storing your settings.

Project profiles

Project profile holds a set of settings for particular project. These are settings that can be specified on VSdocman project properties pages. The project properties page contains Project profile field at the top.

Here you can select for which project profile you want to edit the settings. The settings for selected profile are automatically saved when you close the window or compile documentation.

Note, you cannot create or delete project profile with this field. Moreover, selecting particular project profile in this field doesn't make this profile active! Active profile means that it will be used during compilation. Active project profile is determined by solution profile selected in Active solution profile field at the bottom of the window and it is marked as Active followed by project profile name in parentheses.

Solution profiles

Solution profile holds information about whole solution settings. You can define which projects will be included in compilation and assign project profiles to the solution profile.

Only solution profile can be selected as active which means that assigned project profiles will be used during compilation. You can select active solution profile in Active solution profile field at the bottom of VSdocman window.

You can invoke Profile manager from there as well.

Profile manager

Profile manager allows you to edit, create or delete project and solution profiles. You will find it very familiar because the interface is the same as Configuration manager of Visual Studio. To start Profile manager, open VSdocman window and select Profile Manager from Active solution profile field.

Active Solution Profile

This option specifies active solution profile and allows to create or delete the profile.

 

Creating solution profile

Select <New...> in Active Solution Profile field.

Enter the profile name and specify from which solution profile the initial setting will be copied. If you check Also create new project profile(s), new project profile with the same name as currently creating solution profile will be created for each project. The project profile for particular project will only be created if there was no profile with the same name. New project profiles will be the clones of project profiles assigned to the solution profile specified in Copy Settings From in New Solution Profile dialog. This way you'll get exact clone of existing solution profile.

 

Deleting solution profile

Select <Remove...> in Active Solution Profile field. Then you can select and remove solution profiles. The "default" profile cannot be deleted.

 

Managing project profiles in Profile Manager

The profile manager contains the list of all supported projects in the solution.

Each project contains checkbox indicating whether the project will be included in compilation. The Profile column specifies which project profile is assigned to the active solution profile. Here you can also create or delete the project profile.

 

Creating project profile

Click on the Profile column for the project and select <New...> from drop-down menu.

Enter the profile name and specify from which project profile the initial setting will be copied. If you check Also create new solution profile(s), new solution profile with the same name as currently creating project profile will be created (if already not).

 

Deleting project profile

Click on the Profile column for the project and select <Remove...> from drop-down menu. Then you can select and remove project profiles. The "default" profile cannot be deleted.

See Also

Project Properties