The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.

NAME

populate - Syncronize the development web server with the CVS tree

SYNOPSIS

populate { -h | project_name } [ options... ]

DESCRIPTION

The populate tool is the first stage of the three-tool release process. It is used to synchronize the development web server documents area with the CVS repository.

OPTIONS

There are a wide range of options to this tool. Unless using the -h option, the command line must include at least one project name. Other options are:

-h

Print a short usage summary and terse explanation of the available options. Exits immediately, even if passed with project names.

-t title

When updating the topic-list file, use title in lieu of the project name. The topic-list file is used by the release management system during other stages, in constructing headers for data transmission, etc.

-r symbol

Specificy a particular CVS/RCS tag for the CVS commands to retrieve during the update of files from the CVS repository. Without this, CVS will update using the most-recent (head) revisions of files.

-e addr

If any errors occur that are deemed critical enough to warrant e-mail, this will specify additional addresses. The person running the command, the listed "owner" of the project, and the Webmaster Team are already targeted in the e-mail, so this option need not reference any of those.

-cvsroot dir

Specify an alternate CVSROOT value. This is rarely used, as the CVS environment is very carefully managed by ATG.

-debug

Enable some debugging-related output. This is mostly to keep users abreast of what point within the process the tool is currently at.

-verbose

Enable some additional informational messages within the tool. This differs from -debug in that the messages are more geared towards progress reporting than iterating command-line options before command execution, for example.

-terse

Suppress the majority of the "normal" output, resulting in less feedback from the tool than is usually generated.

-log file

Specify a different file name for logging output. The normal run of the release tools generates some amount of logging data, used mainly as a checklist in the case of problem diagnosis. If you wish the output to go to a specific location, use this option. Note that if the file exists, it must be writable by the user ID that the tools run as, not your own. This is generally idsweb. If the file does not exist, it will be created and owned by this UID.

-h

Lastly, this option displays a brief summary of these options, then causes the tool to exit, even if there are any projects specified.

For any of the options besides -h, one or more project names must be specified. If more than one is passed, they are processed in the order given. At the end of execution, you will be informed if any were not able to successfully complete execution.

SEE ALSO

stage, release, cvs

CAVEATS

Rather than always force redundant processing, the stage tool no longer runs populate unconditionally. It first checks that it is necessary to run this tool.

AUTHOR

Randy J. Ray <randyr@nafohq.hp.com>

ENHANCEMENTS

Kevin Greene