sis-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Martin Desruisseaux (JIRA)" <j...@apache.org>
Subject [jira] [Updated] (SIS-198) Remove "remarks" property from ImmutableIdentifier (replaced by "description")
Date Mon, 13 Apr 2015 11:18:12 GMT

     [ https://issues.apache.org/jira/browse/SIS-198?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel
]

Martin Desruisseaux updated SIS-198:
------------------------------------
    Description: 
The new revision of ISO 19115 published in 2013 introduces a new property in {{Identifier}}:
a {{description}} as a human-readable text. This description duplicates our non-standard {{remarks}}
property. Since {{ImmutableIdentifier.remarks}} was non-standard and {{Identifier.description}}
is standard by now, we should remove {{remarks}} in favour of {{description}}. More specifically:

* Remove {{remarks}} from {{ImmutableIdentifier}}
* Constructors expecting an {{InternationalString}} now store the value in the {{description}}
property rather than {{remarks}}.
* Deprecate {{getRemarks()}} and {{isDeprecated()}} method, with a Javadoc note saying that
those methods are still available in the {{Deprecable}} interface.
* {{ImmutableIdentifier}} does not implement {{Deprecable}} anymore (however internal sub-classes
does).


  was:
The new revision pf ISO 19115 published in 2013 introduces a new property in {{Identifier}}:
a {{description}} as a human-readable text. This description duplicates our non-standard {{remarks}}
property. Since {{ImmutableIdentifier.remarks}} was non-standard and {{Identifier.description}}
is standard by now, we should remove {{remarks}} in favour of {{description}}.

An exception to this change is when the identifier is deprecated. In such case, the {{remarks}}
property is useful for specifying what is the replacement. But we can keep this property in
the {{Deprecable}} interface only.

I side effect of this change is that {{ImmutableIdentifier}} does not need to implement {{Deprecable}}
anymore.



> Remove "remarks" property from ImmutableIdentifier (replaced by "description")
> ------------------------------------------------------------------------------
>
>                 Key: SIS-198
>                 URL: https://issues.apache.org/jira/browse/SIS-198
>             Project: Spatial Information Systems
>          Issue Type: Task
>          Components: Metadata
>    Affects Versions: 0.5
>            Reporter: Martin Desruisseaux
>            Assignee: Martin Desruisseaux
>            Priority: Minor
>             Fix For: 0.6
>
>
> The new revision of ISO 19115 published in 2013 introduces a new property in {{Identifier}}:
a {{description}} as a human-readable text. This description duplicates our non-standard {{remarks}}
property. Since {{ImmutableIdentifier.remarks}} was non-standard and {{Identifier.description}}
is standard by now, we should remove {{remarks}} in favour of {{description}}. More specifically:
> * Remove {{remarks}} from {{ImmutableIdentifier}}
> * Constructors expecting an {{InternationalString}} now store the value in the {{description}}
property rather than {{remarks}}.
> * Deprecate {{getRemarks()}} and {{isDeprecated()}} method, with a Javadoc note saying
that those methods are still available in the {{Deprecable}} interface.
> * {{ImmutableIdentifier}} does not implement {{Deprecable}} anymore (however internal
sub-classes does).



--
This message was sent by Atlassian JIRA
(v6.3.4#6332)

Mime
View raw message