# Version of the language definition syntax used in the file
version = "1"

%include "${__TOOLS_DEFAULTS_DIR__}/syntax_coloring/cpp.gsc"

# language specification for syntax coloring and
# auto-indention in MULTI's editor.
language {
    general {
	# Official name for the language, like
	# 	C/C++/Pascal/Java/Ada/Fortran
	# or
	# 	GHS-Script/GHS-Linker/GHS-LanguageDefinition etc.
	name = "GHS-Transport-Protocol-Script"
	description = "GHS Transport Protocol Script"
	# File extensions for the language
	extension = {"stpspec"}

	# The following are some other information about the language

	# Is the language case-sensitive? If no explicit specification
	# for it, the default value is true.
	#case_sensitive = true

	# Priority conflict solution.
	# Comment, string and character have the same priority.
	# When preprocessor conflicts with them, some language, like
	# C/C++, let comment, string and character have higher priority,
	# other language, like PASCAL, do the other choice.
	# We choose the behavior of C/C++ as the default behavior.
	# If you want to change, like for PASCAL, use the following 
	# statement:
	# pascal_style_priority = true

	# Separator of the language to delimit syntax tokens
	#separator = "\\\"+-*/<=>:,;\'\t()[]^%!~|& {}?"
    
	# Escape sequence leader: one character(like the one in C).
	#escape = "\\"
    }

    keyword {
	# description section
	name += {"DESCRIPTION"}
	name += {"GROUP"}
	name += {"SIDE1", "SIDE2"}
	name += {"NAME"}
	name += {"STAMP"}
	name += {"BINARYAPI"}
	name += {"ASCIIAPI"}
	name += {"COMMANDSYSTEM"}
	name += {"SIDE1STAMP","SIDE1_STAMP","SIDE2STAMP","SIDE2_STAMP"}
	name += {"TMPDEPTH", "TMP_DEPTH"}
	name += {"MESSAGE_DESCRIPTIONS_REQUIRED"}
	# includes section
	name += {"INCLUDES"}
	# constants section
	name += {"CONSTANTS"}
	# types section
	name += {"TYPES"}
	name += {"STRUCT", "CLASS", "UNION", "ENUM"}
	name += {"USERDEFINED"}
	name += {"AS"}
	name += {"PASSBYREF","NOPASSBYREF"}
	name += {"SELFDESTRUCT"}
	name += {"FAST","INLINE"}
	# messages section
	name += {"MESSAGES"}
	name += {"to"}
	name += {"BLOCKING","SYNC","CALL"}
	name += {"NONBLOCKING","ASYNC","LISTEN"}
	name += {"SAFE","UNSAFE"}
	name += {"DELIVERINCOMING","DELIVER_INCOMING","DONT_DELIVER_INCOMING_EXCEPT_SAFE"}
	name += {"OPTIONAL"}
	name += {"MAYRAISEWINDOW","MAY_RAISE_WINDOW","RAISEWINDOW","RAISE_WINDOW"}
	name += {"IN","OUT"}
	name += {"MD"}
	# builtin data types
	name += {"bool"}
	name += {"char"}
	name += {"string","temp_string"}
	name += {"float","double"}	
	name += {"int8","uint8","int16","uint16"}
	name += {"int32","uint32","int64","uint64"}
	name += {"int","uint"}
	name += {"file_name"}
	name += {"string_list"}
	
	# If color is not defined for keyword, default color is used.
	# color = "#0000ff"
	# If auto-completion is not explicitly specified, it is true
	# by default.
	# autocomplete = false
    }

    preprocessor {	
	# If color is not defined for preprocessor, default color is used.
	# color = "#008080"
	# If auto-completion is not explicitly specified, it is true
	# by default.
	# autocomplete = false
	# Is the preprocessor case-sensitive? If no explicit specification
	# for it, the default value is the language's case-sensitive
	# attribute.
    }

    line_comment {
	# Because multiple line comment leaders can be defined,
	# use an index for each of them.
	1 = {"#"}
#	2 = {"//"}
	# If color is not defined for line_comment, default color is used.
	# color = "#008000"
    }

# They are defined in cpp.gsc
%if 0
    comment {
	# Because multiple pairs of comment delimiters can be defined,
	# use a index for each of them.
	# 1 { begin = "/*"; end = "*/" }
	# If color is not defined for comment, default color is used.
	# color = "#008000"
    }

    string {
	# Because multiple pair of string delimiters can be defined,
	# use an index for each of them.
	1 { begin = "\""; end = "\"" }
	# If color is not defined for string, default color is used.
	# color = "#008000"
    }

    character {
	# Because multiple pair of string delimiters can be defined,
	# use an index for each of them.
	1 { begin = "\'"; end = "\'" }
	# If color is not defined for character, default color is used.
	# color = "#008000"
    }

    integer {
	# Support hex integer?
	hex = true
	# Case-sensitive for integer suffix? Default is true.
	case_sensitive = true
	decimal_suffix = {"l", "u", "lu", "ul", "llu", "lul", "ull"}
	hex_suffix = {"l", "u", "lu", "ul", "llu", "lul", "ull"}
	# If color is not defined for integer, default color is used.
	# color = "#008000"
    }

    float {
	# Support scientific float?
	scientific = true
	# Case-sensitive for float suffix? Default is true.
	case_sensitive = false
	suffix = {"f", "l", "fl", "fl"}
	# If color is not defined for float, default color is used.
	# color = "#008000"
    }
%endif

    customized {
	#pattern = {"$*"}
	# More customized stuff.
	# If auto-completion is not explicitly specified, it is true
	# by default
	# autocomplete = false
	# If color is not defined for customized items, default color is used.
	# color = "#0080a0"
    }

    autocomplete {
	# "match" is used to defined match algorithm, it has 
	# the following values:
	#	"best" - default value
	#	"first"
	# As an example, if there are 3 strings for auto-completion:
	# 	"main", "mail" and "misc"
	# When you type in "m", "best match" will not auto-complete it,
	# because the 3 strings do not have a common prefix beginning with
	# "m", but "first match" will auto-complete it into "main".
	# When you type in "ma", "best match" will auto-complete it
	# into "mai", but "first match" will still auto-complete it
	# into "main".
	match = "best"

	# By default, you can use the following key-strokes in MULTI Editor
	# to manually find an auto-completed string for the string ending
	# at the caret:
	# 1. "ctrl+]": navigate to the next matched string.
	# 2. "ctrl+[": navigate to the previous matched string.
	# You can continuously press the keys to scan the matched
	# string list until you find the one you want.
	# 3. "ctrl+/": launch a popup menu to show a list of matched
	# strings(up to a certain number configured by the following option).
	# Then you can pick what you want form the popup menu.

	# Max number of strings to match when user types "ctrl+/".
	# The default value is 10. Use the following statement to change it.
	# max_match = 15
	
	# Minimum length for a string to which auto-completion can be applied.
	# The default value is 1. Use the following statement to change it.
	min_string_length = 3

	# "autocomplete" let you can turn on/off the whole
	# auto-completion mechanism. The default value is true.
	# When the setting here is true, you can still turn on/off
	# about if using keywords, preprocessors or customized items
	# not containing wild card as the auto-completion source.
	# autocomplete = false

	# Define extra auto-completion items in addition to
	# 1. keywords
	# 2. preprocessors
	# 3. customized items not containing wild card

	# Auto-complete strings
	#name = {"main"}
    }

    # Override c-style preprocessors loaded from cpp.gsc.
    preprocessor {
	name = {""}
    }
}

