Update build scripts

Author: sapphyrus

build_gitbook.rb

@@ -61,7 +61,7 @@
 		end
 
 		func_text = "`#{data["name"]}(#{data["all_optional"] ? "[#{arg_names}]" : arg_names})`"
-		func_text << ": #{data["return_type"]}" if data.key? "return_type"
+		func_text << ": #{data["return_type"]}#{data.key?("return_description") ? " (#{data["return_description"]})" : ""}" if data.key? "return_type"
 
 		func_name = data["name"] || "#{global}.#{name}"
 		func_name = func_name.include?(":") ? (":" + func_name.split(":").last) : func_name
@@ -93,7 +93,12 @@
 					description.gsub!(orig, rep)
 				end
 
-				contents << (ARGS_AS_TABLE ? "  **#{argument["name"]}** | #{argument["type"] || ""} | #{description}" : "  - **#{argument["name"]}**: #{description}")
+				contents << if ARGS_AS_TABLE
+					"  **#{argument["name"]}** | #{"#{argument["type"]}#{argument.key?("type_description") ? " (#{argument["type_description"]})" : ""}" || ""} | #{description}"
+				else
+					"  - **#{argument["name"]}**: #{description}"
+				end
+
 			end
 			contents << ""
 		end

build_globals.rb

@@ -12,7 +12,7 @@
 	gem "activesupport", :require => ["active_support/core_ext/hash", "active_support/core_ext/string/inflections"]
 end
 
-SORT_ORDER = %w[name description return_type deprecated args]
+SORT_ORDER = %w[name description return_type return_description deprecated args]
 
 BUILD_DIR = Pathname.new("build/")
 SRC_DIR = Pathname.new("src/")
@@ -25,6 +25,7 @@
 globals_replacements = extra_docs["globals_replacements"]
 globals_deprecated_regex = Regexp.new(extra_docs["globals_deprecated_regex"])
 globals_optional_regex = Regexp.new(extra_docs["globals_optional_regex"])
+globals_type_description_regex = Regexp.new(extra_docs["globals_type_description_regex"])
 
 class ReturnTypes
 	def initialize()
@@ -178,7 +179,12 @@ def get_argument_type(arg, data)
 			return_type = rettypes.get_return_type(data["name"], data)
 			data["return_type"] = return_type unless return_type.nil?
 		end
-		unless data.key? "return_type"
+		if data.key? "return_type"
+			if match = data["return_type"].match(globals_type_description_regex)
+				data["return_type"] = match[1]
+				data["return_description"] = match[2]
+			end
+		else
 			puts "#{global}.#{name}: No return type"
 		end
 		data["deprecated"] = true if !data.key?("deprecated") && data["name"].match?(globals_deprecated_regex)
@@ -203,6 +209,13 @@ def get_argument_type(arg, data)
 					argument["type"] ||= type_info
 				end
 
+				if argument.key? "type"
+					if match = argument["type"].match(globals_type_description_regex)
+						argument["type"] = match[1]
+						argument["type_description"] = match[2]
+					end
+				end
+
 				if !argument.key?("type") && argument["name"] != "..."
 					puts "#{global}.#{name}: Type of argument #{argument.inspect} unknown"
 				end