-
Notifications
You must be signed in to change notification settings - Fork 0
/
README
175 lines (141 loc) · 6.39 KB
/
README
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
--------------------------------------------------------------------------------
README
--------------------------------------------------------------------------------
Kopi Suite
http://www.kopiright.com/kopi
--------------------------------------------------------------------------------
VERSION : 2.3B
RELEASED : 17 September 2007
THIS FILE : $Id$
--------------------------------------------------------------------------------
THIS PACKAGE IS PART OF THE "KOPI SUITE", PLEASE SEE THE LICENSE PROVIDED WITH
"KOPI" IF YOU WISH TO USE, MODIFY OR DUPLICATE THIS SOFTWARE.
--------------------------------------------------------------------------------
CONTENTS
FILES
README This file
COPYING GPL: The license for compilers
COPYING.LIB LGPL: the license for libraries
DIRECTORIES
doc To be documented
src
com
kopiright
kopi
lib
assertion Runtime classes for contracts
comp
kjc The Java Compiler of the Kopi Suite
util
base Utility classes shared by all tools
lpr An LPR-client implementation in Java
mailer An SMTP-client implementation in Java
ipp An IPP-client implementation in Java
compiler Tools and libraries used to build and run the compilers
base Utility classes shared by all compilers
resource Contains a skeleton for JFlex based scanners
tools Tools to build and run the compilers
antlr A modified (and simplified) version of ANTLR 2.7.1
runtime Run-time support classes for generated parsers
compiler Parser (and lexer) generator
extra Extra run-time classes developed by kopiRight
(will be integrated in runtime)
jperf A perfect hashcode generator (obsolete)
optgen An option class generator based on GNU Getopt
msggen A message class generator
lexgen A keyword preprocessor for ANTLR and JFlex
include A preprocessor to include files
bytecode Tools and libraries to manipulate JVM bytecode
classfile A library to manipulate JVM classfiles
optimizer A library to optimize JVM bytecode
ssa SSA representation to optimize JVM bytecode (experimental)
ksm An assembler for JVM classfiles
dis A disassembler for JVM classfiles
memcnt A package to instrument JVM classfiles (instance counting)
xkopi Compilers and run-time libraries for Java/SQL integration
lib
base The run-time library for XKOPI
type A set of new primitive types for the XKOPI language
oper Definitions of operators for XKOPI primitive types
comp
sqlc A simple SQL parser
xkjc A compiler for Java with embedded SQL and operator
overloading
database A library to verify SQL statements
dbi A translator between SQL dialects
dict Generates class with database information
vkopi Compilers and run-time libraries for Visual Kopi, 4GL tool
lib Run-time libraries for Visual Kopi
util Utility classes
visual Window handling classes
form Run-time library for Visual Kopi forms
print Run-time library for Visual Kopi printed reports
report Run-time library for Visual Kopi dynamic reports
cross Classes that use more than one module
doc A documentation generator for Visual Kopi programs
resource Predefined icons and skeletons
spellchecker Spellchecker interface
ui Visual Kopi user interface foundation classes
preview Run-time library for Visual Kopi document preview
list Run-time library for Visual Kopi lists
l10n Modules for forms,reports and messages localization
comp Compilers for Visual Kopi
trig A sub-compiler for Java triggers embedded in forms
and reports
base Grammars and classes common to forms and reports
form The form generator
report The generator for dynamic reports
print The generator for printed reports
main The compiler driver for Visual Kopi
drivers
ikjc A remote incremental compiler (client/server mode) for KJC
kopi A jar-Main for all Kopi tools
--------------------------------------------------------------------------------
OTHER PACKAGES YOU WILL NEED
JDK 1.4 or higher
JDOM
java api to manipulate xml files.
it can be downloaded from :
http://www.jdom.org/downloads/index.html
For KJC :
GNU GETOPT
The parsing of the arguments of the command line is made with gnu.getopt :
http://www.urbanophile.com/arenn/hacking/download.html
JFLEX
The lexical analysers are generated with JFlex :
http://www.jflex.de
Please note that Kopi currently works only with JFlex 1.4
For XKOPI :
IBM BIGDECIMAL CLASSES
An improved implementation of the java.math package (XKOPI only) :
http://www2.hursley.ibm.com/decimal
For VKOPI :
JavaBeans Activation Framework
JavaBeans Activation Framework can be downloaded from :
http://java.sun.com/products/javabeans/jaf/downloads/index.html
JavaMail API
JavaMail API can be downloaded from :
http://java.sun.com/products/javamail/downloads/index.html
Hylafax protocol for Java
The gnu.hylafax package is a pure-Java implementation of the HylaFAX (FAX server) client protocol.
it can be downloaded from :
http://sourceforge.net/projects/gnu-hylafax
MESP : Math Expression String Parser
Parser for mathematical expressions, used to make calculation for added at runtime report columns.
it can be downloaded from :
http://sourceforge.net/projects/expression-tree/
--------------------------------------------------------------------------------
BUILDING FROM SOURCE
You will need GNU make or Gradle.
Define an environment variable CLASSROOT to an existing directory in your
file hierarchy this is where the generated class files will be stored.
Define an environment variable EXTDIRS to an existing directory in your
file hierarchy this is where dependencies jars are stored.
Don't forget to include this directories in your CLASSPATH.
You will need a working Java compiler to build Kopi from source. You may need
to edit the Makefile in this directory if the Java compiler available on your
system is not Jikes.
Then just go to the "src/org/kopi" directory and type "make".
--------------------------------------------------------------------------------
REPORTING BUGS
Please, report all bugs to support@kopiright.com.