Enabling Keyword Expansion

By enabling keyword expansion for a project, you can embed keywords within text files. These keywords are automatically expanded during file check-outs, to provide file and revision information within the file. You should use only one keyword per line.

Keyword expansion and EOL conversion work correctly for UTF-8 unicode files, which previously could be corrupted on check-in. However, EOL conversion is not supported for UTF-16 or UTF-32 unicode files. The Cross-Platform Client allows you to select a file encoding as you check out a file.

StarTeam supports Log and History Keywords from the StarTeam Server and from the MPX Cache Agent.

CAUTION:
Never use a keyword in a revision comment, as it will be expanded during the keyword expansion process.
  1. Choose Project > Properties .
    The Project Properties dialog box opens.
  2. Click the Options tab.
  3. Check the Keyword Expansion check box to enable keyword expansion and use keywords in your text files.

    This check box applies to files added or checked in from StarTeam or from StarTeam integrations with third-party applications.

  4. In Expand Keywords for These File Extensions field, type the file extensions (for example, .bat, .cpp) for which you want to use keywords.

    You can use a space, comma, or semicolon as keyword delimiters. The file extensions list can contain a maximum of 254 characters. If you leave this text box blank, no keywords will be expanded.