Introduce "deprecated" feature in SARL

[gallandarakhneorg]

It may be useful for the SARL developer to have a "deprecated" feature that permits to make the generated Java code as deprecated. Then the feature associted to the issue #153 will output a warning if the deprecated SARL code is used.

[gallandarakhneorg]

Language	Syntax	Text	Deprecated date	Replacement
Java	@Deprecated	no	no	no
Scala	@deprecated(message="",since="")	yes	yes	no
Ruby	deprecate("","",int,int)	no	yes	yes
Xtend	@Deprecated	no	no	no
GNU C	__attribute__((deprecated))	no	no	no
MS VC	__declspec((deprecated))	no	no	no
C++14	[[deprecated("")]]	yes	no	no
C#	[Obsolete("")]	yes	no	no
D	deprecated("")`	yes	no	no
VB.net	<Obsolete("")>	yes	no	no
Lisp	(make-obsolete oldfun newfun)	yes	no	yes

[gallandarakhneorg]

We should keep in mind the issue #9. Indeed, deprecation and pre/post/invariant conditions are all markers/attributes/annotations on a statement.

We may use a syntax that is common. In think this is one reason why the Java consortium has introduced the annotation syntax: one rule in the grammar for all types of annotations.

[gallandarakhneorg]

This issue should be fixed after the issue #34.

[gallandarakhneorg]

The annotation @Deprecated could be used for deprecate a feature.