MapGuide RFC 1 - Commandline Parameter Changes
This page contains an change request (RFC) for MapGuide Open Source. More MapGuide RFCs can be found on the MapGuide RFCs page.
Status
| RFC Template Version | (1.0) | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
| Submission Date | October 31, 2006 | ||||||||||
| Last Modified | Brucedechant 18:32, 17 November 2006 (CET) | ||||||||||
| Author | Bruce Dechant | ||||||||||
| RFC Status | adopted | ||||||||||
| Implementation Status | under development | ||||||||||
| Proposed Release Target | 1.2 | ||||||||||
| Assigned PSC guide(s) | (when determined) | ||||||||||
| |||||||||||
Overview
Make the following MapGuide server commandline parameter changes:
- Remove the need for the "/" character before the parameter name, but retain support for the "/" for backwards compatibility.
- Change the "testmode" parameter to "test", but retain support for the "testmode" for backwards compatibility.
- Remove the "/t" parameter from the renamed "testmode" parameter.
- Change the "interactive" parameter to "run", but retain support for "interactive" for backwards compatibility.
- Remove the need for adding the "Test" word in front of all specific unit test names. ie: CoordinateSystem instead of TestCoordinateSystem
Motivation
The current commandline parameters for the MapGuide server require the "/" character before the parameter name which is not really needed
The "testmode" and "interactive" parameter name changes and removal of the "Test" word for specific unit test names are really just changes for shortening the name for easier entry by the user.
The removal of the "/t" extra parameter for the renamed "testmode" ("test") parameter is recommended because it is really not needed. The user can simply specify what specific unit test they want to run without needing the "/t".
Funding/Resources
Bruce Dechant will be the resource to implement the changes outlined in this RFC.
Proposed Changes
The code and string resouces related to the commandline parameters of the server will be modified to work with the proposed changes.
Technical
The following files will be affected:
- Resources.cpp
- Resources.h
- main.cpp
- Server.cpp
- UnitTesting.cpp
Implications
The commandline help will show the updated parameter names without the "/" character. However, the old parameter names with the "/" character will still work in order to maintain backwards compatibility.
Test Plan
- Test that the existing and renamed commandline parameters work as expected.
- Test both the correct and incorrect spellings of commandline parameters.
- Test both valid and invalid specific unit test names to verify the removal of the "/t" parameter works.