Using P4 Server forms

Some P4 Server commands, for example p4 client and p4 submit, use a text editor to display a form into which you enter the information that is required to complete the command. An example is the description of the changes you are submitting. After you change the form, save it, and exit the editor, P4 Server parses the form and uses it to complete the command.

To configure the text editor that is used to display and edit P4 Server forms, set P4EDITOR.

When you enter information into a P4 Server form, observe the following rules:

  • Field names (for example, View:) must be flush left (not indented) and must end with a colon.
  • Values (your entries) must be on the same line as the field name, or indented with tabs on the lines beneath the field name.

Some field names, such as the Client field in the p4 client form, require a single value. Other fields, such as Description field, take a block of text. Fields like View:, take a list of lines.

Certain values, like Client: in the client workspace form, cannot be changed. Other fields, like Description: in p4 submit, must be changed. If such a rule is broken, P4 Server displays an error. For details about which fields can be modified, see the P4 CLI Reference or use p4 help command.