X-Git-Url: http://nsz.repo.hu/git/?a=blobdiff_plain;f=README;h=2f00c8ed9d66ac2b063a59b8e61e96c6662307fc;hb=82a090ed5ffcf25f9680eaab4de31f22dabef64c;hp=1df644864458594e45e1e687635f9aa7328f342f;hpb=34c0682b53b3cac893e8f58a36dd5886a6831e1c;p=libfirm diff --git a/README b/README index 1df644864..2f00c8ed9 100644 --- a/README +++ b/README @@ -1,27 +1,44 @@ -This is a library implementing the intermediate representation -FIRM developed at IPD Goos, Uni Karlsruhe. +This is a library implementing the intermediate representation FIRM +developed at IPD Goos, Uni Karlsruhe. -Create an architecture dependent directory (eg 'mkdir i686-linux') an cd -to it. Call ../configure with wanted features (see ../configure --help -for more hints). Call 'make depend; make' to construct the library. This +Create an architecture dependent directory (eg 'mkdir i686-linux') an +cd to it. Call ../configure with wanted features (see ../configure +--help for more hints). Call 'make' to construct the library. This creates a file libfirm.a -To test the library goto ./testprograms and make and run the -test examples placed there: +To test the library goto .//testprograms and call 'make test' +there. -make depend; make -cd testprograms -make -make run +If you have set up the include and libdir using configure you can +install the library and its headers by 'make install'. This is +encouraged if the library is hooked up to any other modules, e.g., a +front end. -If you have set up the include and libdir using configure you can install -the library and its headers by 'make install'. This is encouraged if the -library is hooked up to any other modules, e.g., a front end. Only the -external headers are guaranteed to remain stable, the implementation might -change. - -For more documentation see /include/firm.h. To generate FIRM code from a compiler frontend read the documentation -in ./include/ircons.h. -About Firm you can learn in UKA tech-report 1999-14. +"libFIRM: A Library for Compiler Optimization Reaserch Implementing +Firm", UKA tech-report 2002-5. About Firm you can learn in UKA +tech-report 1999-14. + + + +You can generate a Java Native Interface for the library. For this +configure libfirm with --enable-firmjni and give the path to +the jni headers, e.g. +--with-includedir=/usr/public2/java/jdk1.3.1-sun/include/:/usr/ + public2/java/jdk1.3.1-sun/include/linux/. +Then go to .//firmjni and call make. To test the native +interface go on to testprograms and call make test. + + +If you are using the library for heap analysis with libfirm you +have to configure libfirm with --enable-heapanalysis. If you +use the heap analysis through the java native interface you +must in addition give the paths to the heap analysis installation: +--with-includedir= +--with-libdir= + + + +You can also give the paths by setting environment variables +CPPFLAGS and LDFLAGS before configuring.