Command Line Reference
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 simplified command set available from the sample build.xml of Changelogic; in particular project, some commands may be missing or use other names and prefixes.
Ant commands:
- change_auth_token – change authentication code
- checkout_change – downloads a change from repository
- checkout_version – downloads a version from repository
- commit – saves changes into repository
- devweb_upgrade – updates Changelogic build script; this is usually needed only when there has been version update in Changelogic
- edit – starts change development
- edit_module – retrieves a module for editing
- end_edit – ends change development
- integrate – starts change integration
- integrate_cancel – cancels change integration
- integrate_continue – continues change integration after resolving conflicts
- integrate_step – allows to skip or repeat some integration steps; shows selection of steps from which to continue
- sync_main – synchronizes repository MAIN branch and latest version
- sync_main_continue – continues synchronizing repository MAIN branch and latest version
- test_checkout – checks for CVS metafiles correctness
- update – refreshes local working directory to use the last state of change from repository; this is useful when same change is developed in many different working directories by turns or in parallel
- update_all – refreshes local working directory, including modules that have not been marked editable in current change
- update_base – starts base version update
- update_base_cancel – cancels base version update
- update_base_continue – continues base version update after resolving conflicts
- upload_diff – loads changes of edited files into web interface
You can see the whole public interface command set by typing ant -f devweb-build.xml -projecthelp.
Proceed to build script client configuration to see how the parameters stored in files devweb-personal.properties and devweb-project.properties affect the clients behaviour.