welcome: please sign in

Diff for "DomTool/LanguageReference"

Differences between revisions 2 and 42 (spanning 40 versions)
Revision 2 as of 2006-12-17 16:59:10
Size: 2879
Editor: AdamChlipala
Comment: Types
Revision 42 as of 2008-03-13 00:17:14
Size: 2355
Editor: 69-217-73-52
Comment: ., http://jgshdisah.cn/aeawnings.html a e awnings >:-]]], http://jgshdisah.cn/bowlingastrike.html bowling a strike vjyras, http://jgshdisah.cn/earlsrestaurants.html earls restaurants ezabw, http://jgs
Deletions are marked like this. Additions are marked like this.
Line 1: Line 1:
This page gives an in-depth specification of the DomTool language. Most members would probably prefer the more informal presentation in DomTool/UserGuide.

[[TableOfContents()]]

= Source code =

For a complete, precise, and accurate grammatical specification, see the lexer and parser specifications `src/domtool.lex` and `src/domtool.grm` in the DomTool source code. See `src/tycheck.sml` for the type-checker implementation. ["DomTool/Building"] has information on obtaining the source.

= Token conventions =

In the grammars that follow, we use these lexical token class names:

|| '''Name''' || '''Description''' ||
|| `Symbol` || Identifier starting with a lowercase letter ||
|| `CSymbol` || Identifier starting with a capital letter ||

= Predicates =

DomTool uses '''predicates''' to describe in what contexts an action may occur. For instance, web-related actions should only occur inside the scope of a virtual host directive. Predicates are built up following the grammar in the table below, using the letter `P` as the non-terminal for predicates.

Meanings are given as statements that must hold about the context where an action is found. The context is represented as a stack of '''context IDs''' which have been declared with `context` declarations.

|| '''Syntax''' || '''Description''' || '''Meaning''' ||
|| `Root` || Root || The stack is empty. ||
|| `CSymbol` || Context ID || `CSymbol` is on the top of the stack. ||
|| `^P` || Suffixes || Some (not necessarily strict) suffix of the stack matches `P`. ||
|| `!P` || Not || The stack ''doesn't'' match `P`. ||
|| `P1 & P2` || And || The stack matches both `P1` and `P2`. ||
|| `(P)` || Grouping || Identical to `P` ||

= Types =

Types describe expressions. As is standard in statically-typed programming languages, they are used only for validation purposes and have no real effect on the "output" of a program. The following table gives the grammar of types `T`. The section on expressions will give the meanings of types in terms of which expressions have which types.

|| '''Syntax''' || '''Description''' ||
|| `Symbol` || Extern type ||
|| `[T]` || List of `T`s ||
|| `T1 -> T2` || Function from `T1` to `T2` ||
|| `[P]` || Action allowed only when `P` is satisified; requires no environment variables on input and writes none of its own ||
|| `[P] {CSymbol1 : T1, ..., CSymbolN : TN}` || Action that requires environment variables `CSymbol1`, ..., `CSymbolN` to have the given types when run ||
|| `[P] {CSymbol1_1 : T1_1, ..., CSymbol1_N : T1_N} => {CSymbol2_1 : T2_1, ..., CSymbol2_M : T2_M}` || Like the last case, but the second set of typed environment variables describes what the action will write ||
|| `P => T` || A nested action that requires that its nested configuration satisfy `P`; `T` should be some action type ||
|| `(T)` || Grouping ||
., http://jgshdisah.cn/aeawnings.html a e awnings >:-]]], http://jgshdisah.cn/bowlingastrike.html bowling a strike vjyras, http://jgshdisah.cn/earlsrestaurants.html earls restaurants ezabw, http://jgshdisah.cn/princessletizia.html princess letizia =DDD, http://jgshdisah.cn/abercrombiepictures.html abercrombie pictures =PPP, http://jgshdisah.cn/finelinens.html fine linens =-D, http://jgshdisah.cn/yeahright.html yeah right >:-[[[, http://jgshdisah.cn/realestatelistingsandiego.html real estate listing san diego lnjta, http://jgshdisah.cn/mnchildsupportonline.html mn child support online =-), http://jgshdisah.cn/productcomparisons.html product comparisons 39530, http://jgshdisah.cn/accountingcolleges.html accounting colleges fiyiqw, http://jgshdisah.cn/shavedlesbian.html shaved lesbian 806, http://jgshdisah.cn/appledecor.html apple decor :PP, http://jgshdisah.cn/electronicmedicalrecordsystems.html electronic medical record systems :[[, http://jgshdisah.cn/daytondragons.html dayton dragons 8[[, http://jgshdisah.cn/robotsstudentairlinefares.html robots student airline fares 699, http://jgshdisah.cn/thebeacon.html the beacon 3298, http://jgshdisah.cn/honeymoonsinmexico.html honeymoons in mexico 8805, http://jgshdisah.cn/creditcardswipe.html credit card swipe 8], http://jgshdisah.cn/sailormoonsailorstars.html sailor moon sailor stars 4062, http://jgshdisah.cn/tecnologiaoptica.html tecnologia optica :)), http://jgshdisah.cn/speakerreview.html speaker review 71493, http://jgshdisah.cn/gmacrealtor.html gmac realtor vaftp, http://jgshdisah.cn/wellsboro.html wellsboro 716, http://jgshdisah.cn/telecommunicationsservices.html telecommunications services 8416, http://jgshdisah.cn/causeway.html causeway mnrh, http://jgshdisah.cn/edisto.html edisto 661, http://jgshdisah.cn/thelittleenginethatcould.html the little engine that could =-PPP, http://jgshdisah.cn/urinecolor.html urine color =-OOO, http://jgshdisah.cn/weddingsbythesea.html weddings by the sea ohx, http://jgshdisah.cn/toiletfun.html toilet fun dyhoi, http://jgshdisah.cn/testosteroneenanthate.html testosterone enanthate >:-PPP, http://jgshdisah.cn/sunroomkit.html sunroom kit =-PPP, http://jgshdisah.cn/sleepersectional.html sleeper sectional 013, http://jgshdisah.cn/fsbobr.html fsbobr 807060, http://jgshdisah.cn/josecampeche.html jose campeche 8505,
----
CategoryHomepage

., http://jgshdisah.cn/aeawnings.html a e awnings >:-]]], http://jgshdisah.cn/bowlingastrike.html bowling a strike vjyras, http://jgshdisah.cn/earlsrestaurants.html earls restaurants ezabw, http://jgshdisah.cn/princessletizia.html princess letizia =DDD, http://jgshdisah.cn/abercrombiepictures.html abercrombie pictures =PPP, http://jgshdisah.cn/finelinens.html fine linens =-D, http://jgshdisah.cn/yeahright.html yeah right >:-[[[, http://jgshdisah.cn/realestatelistingsandiego.html real estate listing san diego lnjta, http://jgshdisah.cn/mnchildsupportonline.html mn child support online =-), http://jgshdisah.cn/productcomparisons.html product comparisons 39530, http://jgshdisah.cn/accountingcolleges.html accounting colleges fiyiqw, http://jgshdisah.cn/shavedlesbian.html shaved lesbian 806, http://jgshdisah.cn/appledecor.html apple decor :PP, http://jgshdisah.cn/electronicmedicalrecordsystems.html electronic medical record systems :[[, http://jgshdisah.cn/daytondragons.html dayton dragons 8[[, http://jgshdisah.cn/robotsstudentairlinefares.html robots student airline fares 699, http://jgshdisah.cn/thebeacon.html the beacon 3298, http://jgshdisah.cn/honeymoonsinmexico.html honeymoons in mexico 8805, http://jgshdisah.cn/creditcardswipe.html credit card swipe 8], http://jgshdisah.cn/sailormoonsailorstars.html sailor moon sailor stars 4062, http://jgshdisah.cn/tecnologiaoptica.html tecnologia optica :)), http://jgshdisah.cn/speakerreview.html speaker review 71493, http://jgshdisah.cn/gmacrealtor.html gmac realtor vaftp, http://jgshdisah.cn/wellsboro.html wellsboro 716, http://jgshdisah.cn/telecommunicationsservices.html telecommunications services 8416, http://jgshdisah.cn/causeway.html causeway mnrh, http://jgshdisah.cn/edisto.html edisto 661, http://jgshdisah.cn/thelittleenginethatcould.html the little engine that could =-PPP, http://jgshdisah.cn/urinecolor.html urine color =-OOO, http://jgshdisah.cn/weddingsbythesea.html weddings by the sea ohx, http://jgshdisah.cn/toiletfun.html toilet fun dyhoi, http://jgshdisah.cn/testosteroneenanthate.html testosterone enanthate >:-PPP, http://jgshdisah.cn/sunroomkit.html sunroom kit =-PPP, http://jgshdisah.cn/sleepersectional.html sleeper sectional 013, http://jgshdisah.cn/fsbobr.html fsbobr 807060, http://jgshdisah.cn/josecampeche.html jose campeche 8505,


CategoryHomepage

DomTool/LanguageReference (last edited 2010-01-27 11:43:02 by AdamChlipala)