static.js.dojo.src.experimental.js Maven / Gradle / Ivy
/*
Copyright (c) 2004-2006, The Dojo Foundation
All Rights Reserved.
Licensed under the Academic Free License version 2.1 or above OR the
modified BSD license. For more information on Dojo licensing, see:
http://dojotoolkit.org/community/licensing.shtml
*/
dojo.provide("dojo.experimental");
dojo.experimental = function(/* String */ moduleName, /* String? */ extra){
// summary: Marks code as experimental.
// description:
// This can be used to mark a function, file, or module as experimental.
// Experimental code is not ready to be used, and the APIs are subject
// to change without notice. Experimental code may be completed deleted
// without going through the normal deprecation process.
// moduleName: The name of a module, or the name of a module file or a specific function
// extra: some additional message for the user
// examples:
// dojo.experimental("dojo.data.Result");
// dojo.experimental("dojo.weather.toKelvin()", "PENDING approval from NOAA");
var message = "EXPERIMENTAL: " + moduleName;
message += " -- Not yet ready for use. APIs subject to change without notice.";
if(extra){ message += " " + extra; }
dojo.debug(message);
}