= !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 [wiki:MapGuideRfcs 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.