Label (Command Line)

See Also

Assigns a label to the specified version or current version of a file or project.

Syntax

ss Label VSS items [-C] [-H] [-I-] [-Llabel] [-N] [-O] [-V] [-Y] [-?]

Examples

Assigns a label to the current version of the current project:

ss Label

Assigns a label to the current version of the project $/WORD:

ss Label $/WORD

Assigns a label to version 5 of the file HELP.C:

ss Label HELP.C -V5

The following table describes the command-line options available with this command.

Option Description
-C Use the same comment for all labels.
-V Label an existing file or project version.
-L Specify the new label on the command line (instead of being prompted).
-O Paginate or redirect the command output.
-I- Ignore: Do not ask for input under any circumstances.
-N Change between long and short file name mode.
-Y Specify a username and/or password.
-?, -H Request online Help on a command.

Access Rights

You must have the Add access right to use this command.

Remarks

The Label command creates a new version of the specified project or file, and assigns your label to that version. However, if you use the -V option to refer to a specific version, the label is simply applied to that version.

If you assign a label to a version that already has a label, or if you assign a label to an item that already uses that label for a different version, the old label is replaced. In either case, VSS issues a warning before replacing the old label.

If you specify multiple items on the command line, VSS prompts you for a different label for each item. The -C option asks for only one label, which VSS applies to all the items you have listed. The -L option bypasses the label prompt entirely by specifying the label on the command line, for example, -L2.00b.