Magic-Mirror/gecko-dev
1
0
Fork 0
mirror of https://github.com/mozilla/gecko-dev.git synced 2024-11-26 06:11:37 +00:00
Code Issues Actions Packages Projects Releases Wiki Activity

Fixing JavaDoc for @deprecated methods to make documentation to look less ugly

Browse Source
This commit is contained in:
igor%mir2.org 2004-12-31 00:00:44 +00:00
parent fe00b25319
commit 98401f483b
1 changed files with 38 additions and 41 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

79
js/rhino/src/org/mozilla/javascript/Context.java
View File

@ -69,10 +69,6 @@ import org.mozilla.javascript.xml.XMLLib;
* the current thread using the {@link #call(ContextAction)}
* or {@link #enter()} methods.<p>
*
* The behavior of the execution engine may be altered through methods
* such as <a href="#setLanguageVersion>setLanguageVersion</a> and
* <a href="#setErrorReporter>setErrorReporter</a>.<p>
*
* Different forms of script execution are supported. Scripts may be
* evaluated from the source directly, or first compiled and then later
* executed. Interactive execution is also supported.<p>
@ -579,11 +575,9 @@ public class Context
}
/**
* @deprecated Use
* {@link ContextFactory#addListener(ContextFactory.Listener)}.
* A simple way to upgrate the current code to new API is to replace
* <tt>Context.addContextListener(listener)</tt> with
* <tt>ContextFactory.getGlobal().addListener(listener)</tt>.
* @deprecated
* @see ContextFactory#addListener(ContextFactory.Listener)
* @see ContextFactory#getGlobal()
*/
public static void addContextListener(ContextListener listener)
{
@ -610,11 +604,9 @@ public class Context
}
/**
* @deprecated Use
* {@link ContextFactory#removeListener(ContextFactory.Listener)}.
* A simple way to upgrate the current code to new API is to replace
* <tt>Context.removeContextListener(listener)</tt> with
* <tt>ContextFactory.getGlobal().removeListener(listener)</tt>.
* @deprecated
* @see ContextFactory#removeListener(ContextFactory.Listener)
* @see ContextFactory#getGlobal()
*/
public static void removeContextListener(ContextListener listener)
{
@ -622,8 +614,9 @@ public class Context
}
/**
* @deprecated Use {@link ContextFactory#seal()} to seal
* appropriate <tt>ContextFactory()</tt>.
* @deprecated
* @see ContextFactory#seal()
* @see ContextFactory#getGlobal()
*/
public static void disableStaticContextListening()
{
@ -1294,9 +1287,9 @@ public class Context
}
/**
* @deprecated Use
* {@link #compileReader(Reader in, String sourceName, int lineno,
* Object securityDomain)}.
* @deprecated
* @see #compileReader(Reader in, String sourceName, int lineno,
* Object securityDomain)
*/
public final Script compileReader(Scriptable scope, Reader in,
String sourceName, int lineno,
@ -1422,11 +1415,8 @@ public class Context
}
/**
* @deprecated Use {@link #decompileScript(Script script, int indent)}
* instead.
* <p>
* The implementation simply calls <tt>decompileScript(script, indent)</tt>
* ignoring the scope argument.
* @deprecated
* @see #decompileScript(Script script, int indent)
*/
public final String decompileScript(Script script, Scriptable scope,
int indent)
@ -1674,7 +1664,8 @@ public class Context
}
/**
* @deprecated Use {@link #toObject(Object, Scriptable)}.
* @deprecated
* @see #toObject(Object, Scriptable)
*/
public static Scriptable toObject(Object value, Scriptable scope,
Class staticType)
@ -1742,11 +1733,11 @@ public class Context
}
/**
* @deprecated.
* Use {@link #jsToJava(Object, Class)} instead which throws
* {@link EvaluatorException} and not
* {@link java.lang.IllegalArgumentException} which allows to properly
* process exceptions in the script code.
* @deprecated
* @see #jsToJava(Object, Class)
* @throws IllegalArgumentException if the conversion cannot be performed.
* Note that {@link #jsToJava(Object, Class)} throws
* {@link EvaluatorException} instead.
*/
public static Object toType(Object value, Class desiredType)
throws IllegalArgumentException
@ -2001,9 +1992,9 @@ public class Context
}
/**
* @deprecated Use {@link #hasFeature(int)} and
* {@link #FEATURE_DYNAMIC_SCOPE} to control dynamic scoping that also works
* with nested functions defined by functions in the shared scope.
* @deprecated
* @see #FEATURE_DYNAMIC_SCOPE
* @see #hasFeature(int)
*/
public final boolean hasCompileFunctionsWithDynamicScope()
{
@ -2011,9 +2002,9 @@ public class Context
}
/**
* @deprecated Use {@link #hasFeature(int)} and
* {@link #FEATURE_DYNAMIC_SCOPE} to control dynamic scoping that also works
* with nested functions defined by functions in the shared scope.
* @deprecated
* @see #FEATURE_DYNAMIC_SCOPE
* @see #hasFeature(int)
*/
public final void setCompileFunctionsWithDynamicScope(boolean flag)
{
@ -2022,15 +2013,17 @@ public class Context
}
/**
* @deprecated Use {@link ClassCache#get(Scriptable)} and
* {@link ClassCache#setCachingEnabled(boolean)}.
* @deprecated
* @see ClassCache#get(Scriptable)
* @see ClassCache#setCachingEnabled(boolean)
*/
public static void setCachingEnabled(boolean cachingEnabled)
{
}
/**
* @deprecated Proxy to allow to use deprecated WrapHandler in place
* @deprecated
* Proxy to allow to use deprecated WrapHandler in place
* of WrapFactory.
*/
private static class WrapHandlerProxy extends WrapFactory
@ -2072,7 +2065,9 @@ public class Context
}
/**
* @deprecated Use {@link WrapFactory} and {@link #setWrapFactory(WrapFactory)}.
* @deprecated
* @see #setWrapFactory(WrapFactory)
* @see WrapFactory
*/
public final void setWrapHandler(WrapHandler wrapHandler)
{
@ -2085,7 +2080,9 @@ public class Context
}
/**
* @deprecated Use {@link WrapFactory} and {@link #getWrapFactory()}.
* @deprecated
* @see #getWrapFactory()
* @see WrapFactory
*/
public final WrapHandler getWrapHandler()
{