Specials

Table of Contents

• Specials valid for all languages
  • A generic directive and comment starter
  • string literals that are mandatory for eĿlipsis
  • Special include paths for all languages
• C specials
  • C comments
  • Special include paths for C
  • Character constants and wide strings
• Html specials
  • Html constructs with different syntax elements
  • Html comments
  • Directives in html
• Markdown specials
  • Verbatim code inclusion
• Decorations: specials for line starts only
  • C directives
  • C directives for one stage parsing
  • Markdown special that starts at the beginning of lines

Specials are special sequences of characters that have a specific sematics in the target language. They are encoded with two character sequences, a start and a closing, and have contents between these two.

Remarks

Some special starters may not start at arbitrary positions but have to be the first token on the line. This is not yet properly handled by eĿlipsis.

Many specials have the end of the line as closers. This is encoded by using "\n" as a closer.

See also

Decorations: specials for line starts only

Specials valid for all languages

A generic directive and comment starter

These two special directives on entire lines are recognized for all languages.

start	end	category	note
"⎔"	"\n"	directive	U2394, Software-Function Symbol
"⎔⎔"	"\n"	comment	two times U2394

string literals that are mandatory for eĿlipsis

start	end	category	note
"U\""	"\""	string
"\""	"\""	string
"u8\""	"\""	string
"u\""	"\""	string
"x\""	"\""	binary
"B\""	"\""	base64
"R\""	"\""	verbatim
"uR\""	"\""	verbatim
"UR\""	"\""	verbatim
"u8R\""	"\""	verbatim
"LR\""	"\""	verbatim

Special include paths for all languages

Pointing angle brackets (code points U27E8 and U27E9) are accepted as general syntax to determine include paths.

start	end	category	note
"⟨"	"⟩"	string
"〈"	"〉"	string

C specials

C comments

start	end	category	note
"//"	"\n"	comment
"/*"	"*/"	comment

Special include paths for C

In C, less and greater signs are accepted complementing pointing angle brackets to determine include paths.

start	end	category	note
"<"	">"	string

Character constants and wide strings

start	end	category	note
"\'"	"\'"	character
"U\'"	"\'"	character
"u\'"	"\'"	character
"u8\'"	"\'"	character
"L\'"	"\'"	character
"L\""	"\""	string

See also

C directives

Html specials

Html constructs with different syntax elements

start	end	category	note
"<!"	">"	special
"<style>"	"</style>"	special
"<script>"	"</script>"	special

Html comments

start	end	category	note
"<!--"	"-->"	comment

Directives in html

start	end	category	note
"<!--#"	"-->"	directive

Markdown specials

Verbatim code inclusion

start	end	category	note
"`"	"`"	code

See also

Markdown special that starts at the beginning of lines

Html comments

Directives in html

Decorations: specials for line starts only

A generic directive and comment starter

These two special directives on entire lines are recognized for all languages.

start	end	category	note
"⎔"	"\n"	directive	U2394, Software-Function Symbol
"⎔⎔"	"\n"	comment	two times U2394

C directives

start	end	category	note
"%\r:"	"\n"	directive
"#"	"\n"	directive

C directives for one stage parsing

In C, if we process in two steps, it is possible to mark directives for the second step with "%%" instead of "#". This means in particular, that the corresponding line will be expanded during the first step. To have the same effects when we process only in one step, under that mode the directive is prefixed with expand to make sure that expansion takes place as well.

start	end	category	note
"%"":"	"\n"	directive
"%%"	"\n"	directive
"#"	"\n"	directive

Markdown special that starts at the beginning of lines

start	end	category	note
"```"	"```"	codeblock