LoginPreferencesHelp/GuideAbout Trac
WikiBrowse SourceView Tickets

source: trunk/source/Fox.Tool @ 8647

Revision 8513, 5.6 KB checked in by negelef, 8 weeks ago (diff)

Unified spelling

Line 
1Fox - Flexible Oberon Cross Compiler
2Build and Test Tool
3(c) Felix Friedrich (fof), ETH Zürich, 2008-2018
4Conceptual design of the compiler has been worked out together with Florian Negele.
5
6Heaps.SetYoung
7Heaps.SetOld
8
9Compiler.Compile --noInterfaceCheck
10(*
11        System.DoCommands
12        System.Timer start ~
13
14        Compiler.Compile *)
15
16        BitSets.Mod ObjectFile.Mod GenericLinker.Mod Linker.Mod
17        FoxBasic.Mod  FoxProgTools.Mod  FoxScanner.Mod FoxCSharpScanner.Mod FoxSyntaxTree.Mod FoxGlobal.Mod
18        FoxFormats.Mod  FoxFingerprinter.Mod FoxPrintout.Mod
19        FoxParser.Mod FoxCSharpParser.Mod  FoxSemanticChecker.Mod
20        FoxBackend.Mod FoxSections.Mod
21        FoxFrontend.Mod
22        Compiler.Mod
23        FoxOberonFrontend.Mod FoxCSharpFrontend.Mod
24        FoxInterfaceComparison.Mod FoxTextualSymbolFile.Mod
25        FoxBinaryCode.Mod FoxIntermediateCode.Mod FoxIntermediateBackend.Mod FoxCodeGenerators.Mod
26        FoxGenericObjectFile.Mod
27        FoxAMD64InstructionSet.Mod FoxAMD64Assembler.Mod FoxAMDBackend.Mod
28        FoxAssembler.Mod FoxIntermediateAssembler.Mod FoxDisassembler.Mod
29        FoxARMInstructionSet.Mod FoxARMAssembler.Mod FoxARMBackend.Mod  FoxMinosObjectFile.Mod
30        FoxIntermediateParser.Mod FoxIntermediateObjectFile.Mod FoxIntermediateLinker.Mod
31        FoxTRMInstructionSet.Mod FoxTRMAssembler.Mod FoxTRMBackend.Mod
32        FoxInterpreterBackend.Mod FoxTranspilerBackend.Mod
33        FoxDocumentationScanner.Mod FoxDocumentationTree.Mod FoxDocumentationPrinter.Mod FoxDocumentationHtml.Mod
34        FoxDocumentationParser.Mod FoxDocumentationBackend.Mod
35
36        FoxTRMTools.Mod
37        ActiveCellsRuntime.mod
38        ActiveCellsRunner.mod
39
40        FoxProfiler.Mod
41        TextCompiler.Mod FoxA2Interface.Mod Versioning.Mod TestSuite.Mod FoxTest.Mod
42       
43        PersistentObjects.Mod FoxInterpreterSymbols.Mod FoxInterpreter.Mod
44        InterpreterShell.Mod WMInterpreterShell.Mod
45        ~
46System.Show Time elapsed: ~ System.Ln ~
47System.Timer elapsed ~ System.Ln ~
48~
49
50compiler options:
51                --print                 flag            printout source code (for debugging)
52                --silent                        flag            do not printout success messages
53        -c      --check                 flag            semantically check module (auto-check if backend is installed)
54        -e      --traceError    flag            report a stack traceback for each error (for debugging)
55        -I      --interface             flag            printout interface (for debugging)
56        -i      --info                          flag            report more detailed information in error messages and in printout (for debugging)
57        -b      --backend               string  specification of backend (such as, for example, -b=AMD or -b=Intermediate)
58        -f      --findPC                        integer specification of a pc to be located in code
59                --symbolFile    string  specification of a symbol file format (example: --symbolFile=Textual)
60                --objectFile            string  specification of an object file format(example: --objectFile=Generic)
61                --activeCells   flag            use active cells language extension
62        -w      --warnings              flag            show warnings
63                --darwinHost    flag            use Darwin (MacOSX) calling convention for ext. C procedures
64                --hardware      string  hardware generation hint for ActiveCells
65                --documentation string  install documentation engine
66        -S      --sourcePath    string  specification of a source path
67        -D --destPath           string  specification of a destination path
68        -p      --platform              string  compiler options for platforms such as ARMA2, Win32, defined in Compiler.Mod
69        -d      --define        string  define comma-separated identifiers for conditional compilation
70
71backend options (intermediate and AMD)
72                --trace                 string  display trace information for sections (--trace=* : all sections)
73
74generic object file options
75                --textualObjectFile             flag            store the object file in textual (UTF8) form
76                --objectFileExtension   string  extension to be used for object file
77
78textual symbol file options
79                --symbolFileExtension   string  extension to be used for symbol file (for reading only)
80                --noRedefinition                flag            redefinition of symbols is forbidden (no new symbols)
81                --noModification                flag            modification of symbols is forbidden
82               
83AMD backend options
84                --bits                                  number          number of bits (32 or 64)
85                --traceable                             flag                    include instructions in procedure call in order to make a trace possible -- for debugging only
86                --useFPU                                flag                    use FPU for floating point computations (in contrast to SSE and SSE2)
87               
88ARM backend options
89                --useFPU32                              flag                    use FPU (32 bit) for floating point computations
90                --useFPU64                              flag                    use FPU (64 bit and 32 bit) for floating point computations
91
92ActiveCells options
93                --cellsAreObjects       flag    Cells are compiled to (active) Objects. For simulation/emulation and for code generation.
94
95
96
97run regression tests
98
99System.DoCommands
100        FoxTest.Compile  -l=Test.Log  Oberon.Compilation.Test Oberon.Compilation.AMD64TestDiff ~
101        FoxTest.Compile -l=Test.Log Oberon.Execution.Test Oberon.Execution.AMD64TestDiff ~
102        FoxTest.Compile -l=Test.Log ActiveCells.Execution.Test ActiveCells.Execution.TestDiff ~
103        FoxTest.Compile -l=Test.Log MathArrays.Execution.Test  ~
104~
105        TextCompiler.CompileClipboard -p=Win32  ~
106        TextCompiler.CompileSelection -p=Win32 ~
107
108open regression test files
109PET.Open Oberon.Compilation.Test ~
110PET.Open Oberon.Execution.Test ~
111
112
113PET.Open MathArrays.Compilation.Test ~
114PET.Open MathArrays.Execution.Test ~
115
116PET.Open MathArrays.Compilation.Test ~
117PET.Open MathArrays.Execution.Test ~
118
119
120some documentation rules
121(** text *) ~ documentation line, will be extracted by documentation generator
122(*! text *) ~ todo comment
123(*? text *) ~ to be examined / open question comment
124
125
126-----------------------------------------------------------------------------------
127
128
129Building a library:
130
131        FoxGenericObjectFile.MakeLibrary
132                Kernel.Lib Builtins.GofW Trace.GofW
133                Kernel32.GofW Machine.GofW Heaps.GofW Modules.GofW Objects.GofW
134                Kernel.GofW KernelLog.GofW Streams.GofW Commands.GofW Files.GofW
135                WinFS.GofW Clock.GofW Dates.GofW Reals.GofW Strings.GofW Diagnostics.GofW BitSets.GofW StringPool.GofW ObjectFile.GofW GenericLinker.GofW Reflection.GofW
136                Loader.GofW
137                WinTrace.GofW StdIO.GofW
138                ~
139               
140
141
Note: See TracBrowser for help on using the repository browser.
 
 
© 2005 ETH Zürich | Imprint | 26.09.2007 | Version 0.12.5
top