Evaluate Changelogic without registration!
  

Command Line Reference


If you use Changelogic version 1.x, please follow the link: Build Script Command Reference V-1.x


Command line interface Besides web interface, some Changelogic's operations can be only carried out from command line. These operations include starting and ending development, integration and so forth, generally everything that changes either your working directory or interacts with CVS server.

Typing ant -projecthelp or just ant -p on command line gives a short overview of possible commands.


All command line interface commands assume that necessary environment has been set up and Changelogic targets have been integrated into build script. The commands should be issued from a checked out root directory of the project repository.


When command line command was successful, you can see the text BUILD SUCCESSFUL, in all other cases (usually BUILD FAILED), you have to look for error message and act correspondingly.


This section describes the command set available from the changelogic-build.xml of Changelogic; in particular project, some commands may be missing or use other names and prefixes.


ant -f changelogic-build.xml -p


Ant commands:

  • add_checkpoint – Add a checkpoint to the committed state of a change.
  • checkout_change – Check out a change. You will be prompted for the change number.
  • checkout_change_last_checkpoint – Check out the latest checkpoint of a change. You will be prompted for the change number.
  • checkout_submilestone_last_version – Check out the latest version of a submilestone. You will be prompted for the submilesone number.
  • checkout_version – Check out a version. You will be prompted for the version number.
  • commit – Commit local edits.
  • commit_change – End development of a change and hand it over for review.
  • edit_change – Start development of a change. You will beprompted for the change ID.
  • edit_module – Start development of a module. You will beprompted for the module code.
  • integrate – Start integration of a change. You will beprompted for the change number.
  • integrate_cancel – Cancel the integration of a change. All edits made by the integrator will be lost.
  • integrate_clean – Clean integration directories.
  • integrate_continue – Continue integration of a change.
  • integrate_step – Continue integration of a change from a specified step.
  • process_environment_adjustments – Retrieve a list of environment adjustments for manual application. You will be prompted on each adjustment.
  • query_change_last_checkpoint – Query for the la(te)st checkpoint of a change.
  • query_submilestone_last_version – Query for the la(te)st version of a submilestone.
  • refresh – Refresh current working directory retaining local edits.
  • refresh_all – Refresh current working directory (including not editable modules) retaining local edits.
  • reset – Resets the state of client application by deleting serialized commands file. Resetting might be needed when executing commands directly on the server (e.g. abandoning a change).
  • update – Update the base version of a change.
  • update_cancel – Cancel the base version update of a change.
  • update_continue – Continue the base version update of a change.
  • upgrade – Upgrade the local installation of Changelogic client.
  • upload_diff – Upload diff (without ending development) for intermediary review.

Proceed to build script client configuration to see how the parameters stored in files changelogic-personal.properties and changelogic-project.properties affect the clients behaviour.