Open topic with navigation

Getting the Latest Version of Source Control Files

After you bind a Flare project to a source control application, you can get the latest version of any of the source control files. When you do this, you are copying the most current files stored in the source control application to your local Flare project without necessarily checking out the files. This means that the "Read Only" designation will remain associated with the files until you check them out.

Following are steps for getting the latest version of all files in a project automatically, as well as steps for getting the latest version of files manually.

Automatic get

You might use this option if you are working with a team of authors and want to make sure that you include the latest changes from other writers in the output (without having to manually get those files).

With this option:

• You will not be prompted before the "get" is performed.
• Flare will not get the latest copy of the files in the Targets folder, because that would conflict with the generation of the output.
• Conflicts with files will not cause local files to be overwritten. Therefore, if your local files are writable or already checked out, those files will be kept, rather than overwritten with the source control files.

How to get the latest version of source control files automatically

1. Open the appropriate target.
2. In the Target Editor, select the Basic tab.
3. Select the check box labeled Automatically get latest version of all files before generating the target.
4. Press CTRL+S or click to save your work.
5. Build the target.

Note: The "automatic get" feature is not supported if you are building output using the command line, as opposed to the Flare interface.

Manual get

You can manually get the latest version of all of the files in the Flare project, specific content files only (e.g., topics, images, style sheets), specific project files only (e.g., TOCs, targets, glossaries, skins), or the main FLPRJ file only.

How to get the latest version of source control files manually

1. Do one of the following, depending on the particular file(s) that you want to work with.

   All files in the project: 

   1. In the Standard toolbar, click the down arrow next to the Source Control button . (You can also use the menu bar and select File>Source Control).
   2. Select Project.

   Specific content files only:

   1. Make sure the Content Explorer is open. By default, the Content Explorer is located on the left side of the interface in an accordion structure with the Project Organizer, unless you have previously moved it and saved the new layout. You may have to click the Content Explorer bar to bring it into view.

   2. Select the relevant folder or file.

      If you choose a folder, you can recursively select all files under the folder.

      If you want to choose all content files, select the root Content folder.

      Note: If you want to select several specific files at the same time, open the File List window pane instead (View>File List) and choose the appropriate files using the CTRL or SHIFT key.

   3. In the Standard toolbar, click the down arrow next to the Source Control button .

      Note: Alternatively, you can right-click on the file or folder and select Source Control from the popup menu.

   Specific project files only:

   1. Make sure the Project Organizer is open. By default, the Project Organizer is located on the left side of the interface in an accordion structure with the Content Explorer, unless you have previously moved it and saved the new layout. You may have to click the Project Organizer bar to bring it into view.

   2. Select the relevant folder or file.

      If you choose a folder, you can recursively select all files under the folder.

      If you want to choose all project files, select the root Project folder.

   3. In the Standard toolbar, click the down arrow next to the Source Control button .

      Note: Alternatively, you can right-click on the file or folder and select Source Control from the popup menu.

   Main FLPRJ file:

   1. Select Project>Project Properties.

      The Project Properties dialog opens.

   2. Select the Source Control tab.
   3. In the Project File section, click the down arrow next to the Source Control button .

2. Select Get Latest Version (or Get Latest Version All if working with all files in the project).

   The Get Latest Version dialog opens.

3. If you have selected a folder and want to get the latest version of all files under it (or if you are working with all project files), click the Recursive check box.

4. Select the appropriate option(s), depending on the following situations: (1) you already have the file(s) checked out, or (2) you do not have the file(s) checked out but have made them writable by manually removing the check mark from the "Read Only" from the file properties (which is a rare situation for most users).

   Checked Out File If you already have the file checked out and have made changes to it, select one of the following:

   • Prompt me for each file. Another dialog will open for each file, asking you to confirm whether to overwrite the local copy of the file or not.
   • Replace the local copy, losing any changes made to the file. Use this option if you are certain that the source control copy of the file is at least as current as the local copy (if not more current). If you have made changes to the local copy of the file and want to make sure that they are retained, select the next option below instead. You can then check the file into source control so that the latest version is stored there.
   • Leave the local copy, preserving any changes made to the file. Use this option if you do not want to overwrite the local copy of the file with the source control copy. If you select this option, the "get" will not be performed.

   Writable Local File If you do not have the file checked out, but have manually made it writable, select one of the following:

   • Prompt me for each file. Another dialog will open for each file, asking you to confirm whether to overwrite the local copy of the file or not.
   • Overwrite the local copy of the file and get the latest version. Use this option if you are certain that the source control copy of the file is at least as current as the local copy (if not more current). If you have made changes to the local copy of the file and want to make sure that they are retained, select the next option below instead. You can then check the file into source control so that the latest version is stored there.
   • Do not overwrite the local copy of the file. Use this option if you do not want to overwrite the local copy of the file with the source control copy. If you select this option, the "get" will not be performed.

5. Click OK.

   What happens next depends on the option you selected.

   If you selected "Prompt me for each file," the Confirm Get Latest Version dialog opens. If this is the case, select whether to overwrite each local copy or not and click OK.

   If you selected either of the other options, the changes are made or preserved, depending on your selection.

6. If you are working from the Project Properties dialog, click OK.

See Also

Open topic with navigation