diff -r a8b137d12ad7 src/script/api/script_controller.hpp
--- a/src/script/api/script_controller.hpp	Fri Jul 19 19:51:21 2013 +0200
+++ b/src/script/api/script_controller.hpp	Sat Jul 20 11:50:18 2013 +0200
@@ -127,7 +127,8 @@
 
 	/**
 	 * Import a library.
-	 * @param library The name of the library to import.
+	 * @param library The name of the library to import. The name should be composed as ScriptInfo::GetCategory() + "." + 
+	 * ScriptInfo::CreateInstance() + "." + ScriptInfo::GetVersion().
 	 * @param class_name Under which name you want it to be available (or "" if you just want the returning object).
 	 * @param version Which version you want specifically.
 	 * @return The loaded library object. If class_name is set, it is also available (under the scope of the import) under that name.
diff -r a8b137d12ad7 src/script/api/script_info_docs.hpp
--- a/src/script/api/script_info_docs.hpp	Fri Jul 19 19:51:21 2013 +0200
+++ b/src/script/api/script_info_docs.hpp	Sat Jul 20 11:50:18 2013 +0200
@@ -18,9 +18,10 @@
  *       Scripts must or can implemented to provide information to OpenTTD to
  *       base configuring/starting/loading the Script on.
  *
- * @note The required functions are also needed for Script Libraries. As such
- *       the information here can be used for libraries, but the information
- *       will not be shown in the GUI except for error/debug messages.
+ * @note The required functions are also needed for Script Libraries, but in
+ *       that case you extend ScriptLibrary. As such the information here can 
+ *       be used for libraries, but the information will not be shown in the 
+ *       GUI except for error/debug messages.
  *
  * @api ai game
  */
@@ -43,6 +44,8 @@
 	 *
 	 * @return The name of the Script.
 	 * @note This function is required.
+	 * @note This name is not used as library name by ScriptController::Import,
+	 * instead the name returned by #CreateInstance is used.
 	 */
 	string GetName();
 
@@ -144,7 +147,8 @@
 
 	/**
 	 * Gets the name of main class of the Script so OpenTTD knows
-	 * what class to instantiate.
+	 * what class to instantiate. For libraries, this name is also
+	 * used when other scripts import it using @ScriptController::Import.
 	 *
 	 * @return The class name of the Script.
 	 * @note This function is required.