Add Folder: add-folder

Use add-folder to add StarTeam folders to a view from the command line. You can add the folder to the root folder or any other folder in that view. The working folder for your new StarTeam folder is created by default within StarTeam, not on your workstation. The working folder has the same name as the StarTeam folder. It is a child folder of the working folder for the StarTeam folder’s parent.

For example, suppose you create a StarTeam folder named Wizard. Wizard is a child of a StarTeam folder whose working folder is C:\StarDraw. Therefore, Wizard’s working folder becomes C:\StarDraw\Wizard.

Using the -is option allows you to add a branch of folders to the project view’s folder hierarchy. When you use -is, use either -rp or -fp to specify the folder on your workstation whose child folders will become the new StarTeam folder’s child folders. Using -fp is recommended, as it specifies the path directly to the parent of those child folders. In contrast, -rp, which specifies the path to the working folder used for the view's root folder, appends StarTeam folder names in the hierarchy from the root folder to the new folder to the path you specify. Only when you use the -is option do -rp and -fp have any effect on this command.

Syntax

The syntax for this command is:

stcmd{Ex} add-folder [[-p "projectSpecifier"] [-epwdfile "filePath"] 
[-cmp] [-csf] [-encrypt encryptionType] ][-is] [-rp "folderPath" | 
-fp "folderPath"] -name "folderName" [-d | -r "description"| -rf "fileName"]
[-ex "excludeType"] [-q|-pf "filterName"] [-ofp "resultsOutputFilePath"] 
[-exlist "fileMask" | -exfile "fileName"]

Parameters

For information about the command parameters, refer to Operation Parameters.

Example

The following example uses add-folder to create a folder named Wizard as a child of the StarDraw folder, the root folder of the StarDraw project view. In addition, it sets a local exclude list for Wizard. By default, Wizard inherits its parent folder’s exclude lists and use the local one as well.

Use the set command to set the context of the project/view/parent folder.

stcmd add-folder -name "Wizard" -d "StarDraw setup wizard" -exlist "*.bak"

The next example creates the same folder as in the previous example. However, it includes child folders. In this case, the folder with the path C:\Wizard has child folders (Source, Spec, and Doc), all of which are added as StarTeam folders in addition to Wizard. All of the new folders (Wizard, Source, Spec, and Doc) will have the default working folders assigned to them automatically by the StarTeam Server, regardless of the setting for -fp. Wizard will be the parent of Source, Spec, and Doc. StarDraw is the parent of Wizard.

stcmd add-folder -name "Wizard" -d "StarDraw setup wizard" -is -fp "C:\Wizard" exlist "*.bak"

Parameters

For information about the command parameters, refer to Operation Parameters.