MapGuide RFC 1 - Commandline Parameter Changes

This page contains an change request (RFC) for the MapGuide Open Source project. More MapGuide RFCs can be found on the RFCs page.

Status

RFC Template Version	(1.0)
Submission Date	October 31, 2006
Last Modified	Bruce Dechant Timestamp
Author	Bruce Dechant
RFC Status	adopted
Implementation Status	completed
Proposed Milestone	1.2
Assigned PSC guide(s)	(when determined)
Voting History	November 15, 2006
+1	Bruce, Tom, Haris, Paul, Andy, Bob
+0	Jason
-0
-1

Overview

Make the following MapGuide server commandline parameter changes:

1. Remove the need for the "/" character before the parameter name, but retain support for the "/" for backwards compatibility.
2. Change the "testmode" parameter to "test", but retain support for the "testmode" for backwards compatibility.
3. Remove the "/t" parameter from the renamed "testmode" parameter.
4. Change the "interactive" parameter to "run", but retain support for "interactive" for backwards compatibility.
5. 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.