You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@sis.apache.org by "Martin Desruisseaux (JIRA)" <ji...@apache.org> on 2015/04/13 13:18:12 UTC
[jira] [Updated] (SIS-198) Remove "remarks" property from
ImmutableIdentifier (replaced by "description")
[ 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)