Changes between Version 1 and Version 2 of CsMapRfc8


Ignore:
Timestamp:
05/09/14 19:54:52 (11 years ago)
Author:
Norm Olsen
Comment:

--

Legend:

Unmodified
Added
Removed
Modified

  • CsMapRfc8

    v1 v2  
    2424Over the years, CS-MAP has accumulated a lot of unused and obsolete code which is no longer necessary.  This baggage has accumulated due to a variety of factors:
    2525
    26 * Being maintain by separate organizations and developers
    27 * Features being replaces by new RFC's.
    28 * Provisions for obsolete and/or non-standard operating system and compilers.
    29 * Old features maintained for legacy purposes which are now a liability rather than a positive.
     26 * Being maintain by separate organizations and developers
     27 * Features being replaces by new RFC's.
     28 * Provisions for obsolete and/or non-standard operating system and compilers.
     29 * Old features maintained for legacy purposes which are now a liability rather than a positive.
    3030
    3131The intent of this RFC is to itemize the proposed clean up efforts, have them reviewed and discussed, and upon final agreement, implement the clean up.
    … …  
    3535Implementing this clean up will:
    3636
    37 * reduce the amount of code maintained,
    38 * reduce confusion to new users and developers,
    39 * remove unnecessary restrictions originally written in to accommodate obsolete platforms/OS/compilers
    40 * improve build times
    41 * reduce distributable sizes
     37 * reduce the amount of code maintained,
     38 * reduce confusion to new users and developers,
     39 * remove unnecessary restrictions originally written in to accommodate obsolete platforms/OS/compilers
     40 * improve build times
     41 * reduce distributable sizes
    4242 
    4343== Proposed Solution ==
    … …  
    4545The following is a list of items proposed for the clean up.  Modifications, deletions, and additions are encouraged.
    4646
    47 * Remove the 'C' based CS_Test module.  It hasn't been maintained and is rarely, if ever, used any more.
    48 * Delete (SVN meaning of Delete) pre-RFC-2 geodetic transformation code modules which are no longer referenced.
    49 * Remove all code pertaining specifically to Windows CE.
    50 * Correct all warnings issued by VC++ and gcc compilers.
    51 * Enhance make files for Windows and Linux so that single make command builds the entire product.
    52 * Remove all .gdc and .mrt files from dictionaries and distributions.
    53 * Modify the capitalization of file names so that all comform to a consist naming convention.
    54 * Rename modules and internal functions to names conforming to the base CS-MAP naming convention.
    55 * Implement pre-compiled headers where ever possible in make/project files.
    56 * Re-organize the csTestCpp test module to better reflect the actual usage for the product (i.e. Categories in, Groups out, 3D coordinate testing, etc.)
     47 * Remove the 'C' based CS_Test module.  It hasn't been maintained and is rarely, if ever, used any more.
     48 * Delete (SVN meaning of Delete) pre-RFC-2 geodetic transformation code modules which are no longer referenced.
     49 * Remove all code pertaining specifically to Windows CE.
     50 * Correct all warnings issued by VC++ and gcc compilers.
     51 * Enhance make files for Windows and Linux so that single make command builds the entire product.
     52 * Remove all .gdc and .mrt files from dictionaries and distributions.
     53 * Modify the capitalization of file names so that all comform to a consist naming convention.
     54 * Rename modules and internal functions to names conforming to the base CS-MAP naming convention.
     55 * Implement pre-compiled headers where ever possible in make/project files.
     56 * Re-organize the csTestCpp test module to better reflect the actual usage for the product (i.e. Categories in, Groups out, 3D coordinate testing, etc.)
    5757
    5858== Implications ==
    5959
    60 I submit this as an RFC as it is likely that some of the changes may require an tweak or two external to the library itself. Assuming that no one is using the CS-Test.c module, and that few (if any) use modules below the EXP_LVL1 external interface, no external changes are envisioned, BUT . . .
     60I submit this as an RFC as it is likely that some of the changes may require an tweak or two external to the library itself. And also, a project such as this needs a lot of testing in different environments. Without the support of the entire community, embarking on this worthwhile project could be dangerous. Assuming that no one is using the CS-Test.c module, and that few (if any) use modules below the EXP_LVL1 external interface, no external changes are envisioned, BUT . . .
    6161
    6262== Implementation Plan ==
    … …  
    6464Each of the above listed items will be implemented, tested, reviewed, and submitted separately to the extent possible.  The easiest and safest will be performed first.  The following are considered to be the easiest and safest:
    6565
    66 * Remove the CS_Test module.
    67 * Delete RFC-2 left overs from the repository and remove all reference in project/make files.
    68 * Remove unused .gdc and all .mrt files from the distribution and code (i.e. the Dictionary compiler).
    69 * Remove the remaining .gdc files which are still used (Vertcon and Geoid Height), replacing them with the concept of simply using whatever files exist in a predefined folder.
    70 * Modify the names of source code modules to comply with the basic CS-MAP naming convention. (Changes to module names, and hence changes to make/project files only.  Function/Interface names remain unchanged.)
     66 * Remove the CS_Test module.
     67 * Delete RFC-2 left overs from the repository and remove all reference in project/make files.
     68 * Remove unused .gdc and all .mrt files from the distribution and code (i.e. the Dictionary compiler).
     69 * Remove the remaining .gdc files which are still used (Vertcon and Geoid Height), replacing them with the concept of simply using whatever files exist in a predefined folder.
     70 * Modify the names of source code modules to comply with the basic CS-MAP naming convention. (Changes to module names, and hence changes to make/project files only.  Function/Interface names remain unchanged.)
    7171
    7272== Test Plan ==
    … …  
    7676== Funding/Resources ==
    7777
    78 Hopefully, the primary patrons of the library will contribute funding and/or personnel resources to support some or all of these efforts.  In absence thereof, Nor Olsen will perform the work.  In the latter case, the effort will take 12 or more months to complete.
     78Hopefully, the primary patrons of the library will contribute funding and/or personnel resources to support some or all of these efforts.  In absence thereof, Norm Olsen will perform the work.  In the latter case, the effort will take 12 or more months to complete.