Inconsistent Documentation for JS_SetOptions

The online JSAPI User Guide says we need to use JS_SetOptions:

>A minimal example:
>...
>The context: Use JS_NewContext and JS_DestroyContext. For maximum 
>ECMAScript standard compliance, applications should also use JS_SetOptions 
>to enable JSOPTION_VAROBJFIX. To get the latest JavaScript language features,
>applications may use JS_SetVersion. Error reporting is also per-context and 
>is enabled using JS_SetErrorReporter.

But at the same time JSAPI reference for JS_SetOptions:

>This feature is obsolete. Although it may still work in some browsers, 
>its use is discouraged since it could be removed at any time. Try to avoid 
>using it.

Seems like the documentation needs an update.