Documentation Center

  • Trial Software
  • Product Updates

Set Up Source Control (Microsoft Windows)

Create Projects in Source Control System

In your source control system, create the projects that your folders and files will be associated with.

All files in a folder must belong to the same source control project. Be sure the working folder for the project in the source control system specifies the correct path to the folder on disk.

Example of Creating Source Control Project

This example uses the project my_thesis_files in Microsoft® Visual SourceSafe®. This illustration of the Current Folder browser shows the path to the folder on disk, D:\my_thesis_files.

The following illustration shows the example project in the source control system.

To set the working folder in Microsoft Visual SourceSafe for this example, select my_thesis_files, right-click, select Set Working Folder from the context menu, and specify D:\my_thesis_files in the resulting dialog box.

Specify Source Control System with MATLAB Software

In MATLAB®, specify the source control system you want to access. On the Home tab, in the Environment section, click Preferences > MATLAB > General > Source Control.

The currently selected system is shown in the Preferences dialog box. The list includes all installed source control systems that support the Microsoft Common Source Control standard.

Select the source control system you want to interface with and click OK.

MATLAB remembers preferences between sessions, so you only need to perform this action again when you want to access a different source control system.

Source Control with 64-Bit Versions of MATLAB

If you run a 64-bit version of MATLAB and want MATLAB to interface with your source control system, your source control system must be 64-bit compliant. If you have a 32-bit source control system, or if you have a 64-bit source control system running in 32-bit compatibility mode, MATLAB cannot use it. In that event, MATLAB displays a warning about the problem in the Source Control preference pane.

Function Alternative for Specifying Source Control System

A function alternative to select a source control system is not available, but you can list all available source control systems using verctrl with the all_systems argument. Use cmopts to display the name of the currently selected source control system.

Register Source Control Project with MATLAB Software

Register a source control system project with a folder in MATLAB, that is, associate a source control system project with a folder and all files in that folder. Do this only one time for any file in the folder, which registers all files in that folder:

  1. In the MATLAB Current Folder browser, select a file that is in the folder you want to associate with a project in your source control system. For example, select D:\my_thesis_files\wind.m. This will associate all files in the my_thesis_files folder.

  2. Right-click, and from the context menu, select Source Control > Register Name_of_Source_Control_System Project with MATLAB. The Name_of_Source_Control_System is the source control system you selected using preferences as described in Specify Source Control System with MATLAB Software.

    The following example shows Microsoft Visual SourceSafe.

  3. In the resulting Name_of_Source_Control_System Login dialog box, provide the user name and password you use to access your source control system, and click OK.

  4. In the resulting Choose project from Name_of_Source_Control_System dialog box, select the source control system project to associate with the folder and click OK. This example shows my_thesis_files.

    The selected file, its folder, and all files in the folder, are associated with the source control system project you selected. For the example, MATLAB associates all files in D:\my_thesis_files with the source control project my_thesis_files.

Add Files to Source Control

Add files to the source control system. Do this only once for each file:

  1. In the Current Folder browser, select files you want to add to the source control system.

  2. Right-click, and from the context menu, select Source Control > Add to Source Control.

  3. The resulting Add to source control dialog box lists files you selected to add. You can add text in the Comments field. If you expect to use the files soon, select the Keep checked out check box (which is selected by default). Click OK.

If you try to add an unsaved file, the file is automatically saved upon adding.

Function Alternative

The function alternative is verctrl with the add argument.

Was this topic helpful?