javax.script.ScriptEngineManager uses service provider mechanism to find and load ScriptEngineFactory implementations. Instead of referring to META-INF/services directory, the javadoc should refer (hyperlink) to service providers doc in Jar File Specification. Also, it should avoid referring to bootstrap loader directly (as is done currently) -- instead specify 'factories bundled with platform'. Please refer to related implementation bug 6330073 as well.