Perforce Command Reference:   [Index]  [Prev] [Next]


p4 label

Synopsis

Create or edit a label specification and its view

Syntax

p4 [g_opts] label [ -f -t template ] name
p4 [g_opts] label -o [ -t template ] name
p4 [g_opts] label -d [ -f ] name
p4 [g_opts] label -i [ -f ]

Description

Create a new label specification or edit an existing label specification. A name is required. The specification form is put into a temporary file and the editor (given by the environment variable $EDITOR) is invoked.

The label specification form contains the following fields:

Label: The label name (read only.)

Date: The date specification was last modified (read only.)

Description: A short description of the label (optional).

Options: either 'locked' or 'unlocked'.

View: A mapping to select files from the depot.

Normally, new labels are created with a default view that selects all depot files for the label. The -t flag uses the view from the named template label as a default instead.

A label definition is used only by the 'p4 labelsync' command. A label that has its Options: set to 'locked' cannot be updated.

Flag -d causes the named label to be deleted, as long as it is not locked. The -f flag forces the delete.

The -o flag causes the named label specification to be written to the standard output. The user's editor is not invoked.

The -i flag causes a label specification to be read from the standard input. The user's editor is not invoked.

The -f flag allows the superuser to delete any label; normally labels can only be deleted by their owner. -f also allows the last modified date to be set.



Perforce Command Reference:   [Index]  [Prev] [Next]


Copyright 1998 Perforce Software.
Contact us at [email protected]
Last updated: 06/14/98