annotate src/compiler.sig @ 201:f2cac0dba9bf

Consolidating compiler phase interface and adding timing
author Adam Chlipala <adamc@hcoop.net>
date Tue, 12 Aug 2008 14:40:07 -0400
parents 8a70e2919e86
children af5bd54cbbd7
rev   line source
adamc@1 1 (* Copyright (c) 2008, 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@1 28 (* Laconic/Web main compiler interface *)
adamc@1 29
adamc@1 30 signature COMPILER = sig
adamc@1 31
adamc@56 32 type job = string list
adamc@201 33 (*val compile : job -> unit*)
adamc@183 34 val compileC : {cname : string, oname : string, ename : string} -> unit
adamc@29 35
adamc@201 36 type ('src, 'dst) phase
adamc@201 37 type ('src, 'dst) transform
adamc@55 38
adamc@201 39 val transform : ('src, 'dst) phase -> string -> ('src, 'dst) transform
adamc@201 40 val o : ('a, 'b) transform * ('b, 'c) transform -> ('a, 'c) transform
adamc@1 41
adamc@201 42 val run : ('src, 'dst) transform -> 'src -> 'dst option
adamc@201 43 val runPrint : ('src, 'dst) transform -> 'src -> unit
adamc@201 44 val time : ('src, 'dst) transform -> 'src -> unit
adamc@201 45 val timePrint : ('src, 'dst) transform -> 'src -> unit
adamc@56 46
adamc@201 47 val parseLac : (string, Source.file) phase
adamc@201 48 val parseLig : (string, Source.sgn_item list) phase
adamc@201 49
adamc@201 50 val parse : (job, Source.file) phase
adamc@201 51 val elaborate : (Source.file, Elab.file) phase
adamc@201 52 val explify : (Elab.file, Expl.file) phase
adamc@201 53 val corify : (Expl.file, Core.file) phase
adamc@201 54
adamc@201 55 val toParse : (job, Source.file) transform
adamc@201 56 val toElaborate : (job, Elab.file) transform
adamc@201 57 val toExplify : (job, Expl.file) transform
adamc@201 58 val toCorify : (job, Core.file) transform
adamc@1 59
adamc@1 60 end