[cm] spec is vague on if modifications from rank <0 or >1000 are ignored, but CT mandates it

[bjhargrave]

Original bug ID: BZ#3102
From: @tjwatson
Reported version: R7

[bjhargrave]

Comment author: @tjwatson

Javadoc for ConfigurationPlugin states:

By convention, plugins with service.cmRanking < 0 or service.cmRanking > 1000 should not make modifications to the properties.

The Configuration Admin service has the right to hide properties from plugins, or to ignore some or all the changes that they make. This might be done for security reasons. Any such behavior is entirely implementation defined.

The statement "Any such behavior is entirely implementation defined." is an interesting choice of words considering that the CT expects modififications from such cmRankings to be ignored.

[bjhargrave]

Comment author: @tjwatson

Table 104.2 does make it clear such modifications must be ignored. So this is just an issue with the javadoc IMO.

[bjhargrave]

Comment author: @bjhargrave

CPEG call: Tom will update javadoc to clarify.