annotate src/compiler.sig @ 1181:618f9f458da9

Got split1 working, but noticed a nasty type inference bug with transplanted unification variables
author Adam Chlipala <adamc@hcoop.net>
date Sat, 06 Mar 2010 19:14:48 -0500
parents 7a2a7a8f9cab
children 9d3ccb8b39ac
rev   line source
adamc@1082 1 (* Copyright (c) 2008-2009, Adam Chlipala
adamc@1 2 * All rights reserved.
adamc@1 3 *
adamc@1 4 * Redistribution and use in source and binary forms, with or without
adamc@1 5 * modification, are permitted provided that the following conditions are met:
adamc@1 6 *
adamc@1 7 * - Redistributions of source code must retain the above copyright notice,
adamc@1 8 * this list of conditions and the following disclaimer.
adamc@1 9 * - Redistributions in binary form must reproduce the above copyright notice,
adamc@1 10 * this list of conditions and the following disclaimer in the documentation
adamc@1 11 * and/or other materials provided with the distribution.
adamc@1 12 * - The names of contributors may not be used to endorse or promote products
adamc@1 13 * derived from this software without specific prior written permission.
adamc@1 14 *
adamc@1 15 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
adamc@1 16 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
adamc@1 17 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
adamc@1 18 * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE
adamc@1 19 * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
adamc@1 20 * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
adamc@1 21 * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
adamc@1 22 * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
adamc@1 23 * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
adamc@1 24 * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
adamc@1 25 * POSSIBILITY OF SUCH DAMAGE.
adamc@1 26 *)
adamc@1 27
adamc@244 28 (* Ur/Web main compiler interface *)
adamc@1 29
adamc@1 30 signature COMPILER = sig
adamc@1 31
adamc@270 32 type job = {
adamc@385 33 prefix : string,
adamc@270 34 database : string option,
adamc@274 35 sources : string list,
adamc@274 36 exe : string,
adamc@274 37 sql : string option,
adamc@502 38 debug : bool,
adamc@673 39 profile : bool,
adamc@764 40 timeout : int,
adamc@764 41 ffi : string list,
adamc@764 42 link : string list,
adamc@765 43 headers : string list,
adamc@766 44 scripts : string list,
adamc@765 45 clientToServer : Settings.ffi list,
adamc@765 46 effectful : Settings.ffi list,
adamc@1171 47 benignEffectful : Settings.ffi list,
adamc@765 48 clientOnly : Settings.ffi list,
adamc@765 49 serverOnly : Settings.ffi list,
adamc@768 50 jsFuncs : (Settings.ffi * string) list,
adamc@769 51 rewrites : Settings.rewrite list,
adamc@769 52 filterUrl : Settings.rule list,
adamc@866 53 filterMime : Settings.rule list,
adamc@866 54 protocol : string option,
adamc@1164 55 dbms : string option,
adamc@1164 56 sigFile : string option
adamc@270 57 }
adamc@1045 58 val compile : string -> bool
adamc@1045 59 val compiler : string -> unit
adamc@742 60 val compileC : {cname : string, oname : string, ename : string, libs : string,
adamc@1045 61 profile : bool, debug : bool, link : string list} -> bool
adamc@29 62
adamc@201 63 type ('src, 'dst) phase
adamc@201 64 type ('src, 'dst) transform
adamc@55 65
adamc@201 66 val transform : ('src, 'dst) phase -> string -> ('src, 'dst) transform
adamc@270 67 val o : ('b, 'c) transform * ('a, 'b) transform -> ('a, 'c) transform
adamc@1 68
adamc@346 69 val check : ('src, 'dst) transform -> 'src -> unit
adamc@201 70 val run : ('src, 'dst) transform -> 'src -> 'dst option
adamc@201 71 val runPrint : ('src, 'dst) transform -> 'src -> unit
adamc@201 72 val time : ('src, 'dst) transform -> 'src -> unit
adamc@201 73 val timePrint : ('src, 'dst) transform -> 'src -> unit
adamc@56 74
adamc@244 75 val parseUr : (string, Source.file) phase
adamc@244 76 val parseUrs : (string, Source.sgn_item list) phase
adamc@270 77 val parseUrp : (string, job) phase
adamc@1082 78 val parseUrp' : (string, {Job : job, Libs : string list}) phase
adamc@201 79
adamc@201 80 val parse : (job, Source.file) phase
adamc@201 81 val elaborate : (Source.file, Elab.file) phase
adamc@448 82 val unnest : (Elab.file, Elab.file) phase
adamc@313 83 val termination : (Elab.file, Elab.file) phase
adamc@201 84 val explify : (Elab.file, Expl.file) phase
adamc@201 85 val corify : (Expl.file, Core.file) phase
adamc@454 86 val core_untangle : (Core.file, Core.file) phase
adamc@202 87 val shake : (Core.file, Core.file) phase
adamc@607 88 val rpcify : (Core.file, Core.file) phase
adamc@202 89 val tag : (Core.file, Core.file) phase
adamc@202 90 val reduce : (Core.file, Core.file) phase
adamc@315 91 val unpoly : (Core.file, Core.file) phase
adamc@202 92 val specialize : (Core.file, Core.file) phase
adamc@692 93 val marshalcheck : (Core.file, Core.file) phase
adamc@732 94 val effectize : (Core.file, Core.file) phase
adamc@1170 95 val css : (Core.file, Css.report) phase
adamc@202 96 val monoize : (Core.file, Mono.file) phase
adamc@202 97 val mono_opt : (Mono.file, Mono.file) phase
adamc@202 98 val untangle : (Mono.file, Mono.file) phase
adamc@202 99 val mono_reduce : (Mono.file, Mono.file) phase
adamc@202 100 val mono_shake : (Mono.file, Mono.file) phase
adamc@567 101 val jscomp : (Mono.file, Mono.file) phase
adamc@506 102 val fuse : (Mono.file, Mono.file) phase
adamc@377 103 val pathcheck : (Mono.file, Mono.file) phase
adamc@202 104 val cjrize : (Mono.file, Cjr.file) phase
adamc@643 105 val scriptcheck : (Cjr.file, Cjr.file) phase
adamc@282 106 val prepare : (Cjr.file, Cjr.file) phase
adamc@879 107 val checknest : (Cjr.file, Cjr.file) phase
adamc@274 108 val sqlify : (Mono.file, Cjr.file) phase
adamc@201 109
adamc@270 110 val toParseJob : (string, job) transform
adamc@1082 111 val toParseJob' : (string, {Job : job, Libs : string list}) transform
adamc@270 112 val toParse : (string, Source.file) transform
adamc@270 113 val toElaborate : (string, Elab.file) transform
adamc@448 114 val toUnnest : (string, Elab.file) transform
adamc@313 115 val toTermination : (string, Elab.file) transform
adamc@270 116 val toExplify : (string, Expl.file) transform
adamc@270 117 val toCorify : (string, Core.file) transform
adamc@454 118 val toCore_untangle : (string, Core.file) transform
adamc@270 119 val toShake1 : (string, Core.file) transform
adamc@607 120 val toRpcify : (string, Core.file) transform
adamc@642 121 val toCore_untangle2 : (string, Core.file) transform
adamc@642 122 val toShake2 : (string, Core.file) transform
adamc@1181 123 val toUnpoly1 : (string, Core.file) transform
adamc@1062 124 val toEspecialize1 : (string, Core.file) transform
adamc@1062 125 val toCore_untangle3 : (string, Core.file) transform
adamc@1062 126 val toShake3 : (string, Core.file) transform
adamc@270 127 val toTag : (string, Core.file) transform
adamc@270 128 val toReduce : (string, Core.file) transform
adamc@1181 129 val toUnpoly2 : (string, Core.file) transform
adamc@315 130 val toSpecialize : (string, Core.file) transform
adamc@1062 131 val toShake4 : (string, Core.file) transform
adamc@1062 132 val toEspecialize2 : (string, Core.file) transform
adamc@898 133 val toReduce2 : (string, Core.file) transform
adamc@1062 134 val toShake5 : (string, Core.file) transform
adamc@692 135 val toMarshalcheck : (string, Core.file) transform
adamc@732 136 val toEffectize : (string, Core.file) transform
adamc@1170 137 val toCss : (string, Css.report) transform
adamc@270 138 val toMonoize : (string, Mono.file) transform
adamc@270 139 val toMono_opt1 : (string, Mono.file) transform
adamc@270 140 val toUntangle : (string, Mono.file) transform
adamc@270 141 val toMono_reduce : (string, Mono.file) transform
adamc@270 142 val toMono_shake : (string, Mono.file) transform
adamc@572 143 val toMono_opt2 : (string, Mono.file) transform
adamc@567 144 val toJscomp : (string, Mono.file) transform
adamc@572 145 val toMono_opt3 : (string, Mono.file) transform
adamc@506 146 val toFuse : (string, Mono.file) transform
adamc@506 147 val toUntangle2 : (string, Mono.file) transform
adamc@601 148 val toMono_reduce2 : (string, Mono.file) transform
adamc@506 149 val toMono_shake2 : (string, Mono.file) transform
adamc@916 150 val toMono_opt4 : (string, Mono.file) transform
adamc@1017 151 val toMono_reduce3 : (string, Mono.file) transform
adamc@916 152 val toFuse2 : (string, Mono.file) transform
adamc@916 153 val toUntangle3 : (string, Mono.file) transform
adamc@916 154 val toMono_shake3 : (string, Mono.file) transform
adamc@377 155 val toPathcheck : (string, Mono.file) transform
adamc@270 156 val toCjrize : (string, Cjr.file) transform
adamc@643 157 val toScriptcheck : (string, Cjr.file) transform
adamc@282 158 val toPrepare : (string, Cjr.file) transform
adamc@879 159 val toChecknest : (string, Cjr.file) transform
adamc@274 160 val toSqlify : (string, Cjr.file) transform
adamc@1 161
adamc@1079 162 val debug : bool ref
adamc@1079 163
adamc@1089 164 val addPath : string * string -> unit
adamc@1090 165 val addModuleRoot : string * string -> unit
adamc@1089 166
adamc@1 167 end