home *** CD-ROM | disk | FTP | other *** search
/ AmigActive 3 / AACD03.BIN / AACD / Programming / sofa / archive / SmallEiffel.lha / SmallEiffel / man / SmallEiffelFAQ.txt < prev    next >
Text File  |  1999-06-05  |  11KB  |  222 lines

  1.  
  2.                          Frequently Asked Questions
  3.                                       
  4.    Table of contents
  5.    
  6.    Q01: [1]Why the name SmallEiffel The GNU Eiffel Compiler?
  7.    Q02: [2]What's the matter with version numbering?
  8.    Q03: [3]Is it possible to have the complete Eiffel source code of
  9.    SmallEiffel?
  10.    Q04: [4]Is it possible to use SmallEiffel for large/commercial
  11.    applications?
  12.    Q05: [5]Is it possible to do incremental compilation with
  13.    SmallEiffel?
  14.    Q06: [6]Is there a SmallEiffel mailing list?
  15.    Q07: [7]What about the Guru section?
  16.    Q08: [8]Is it difficult to switch from ISE to SmallEiffel?
  17.    Q09: [9]Are there mirror FTP sites for SmallEiffel?
  18.    Q10: [10]Is it possible to use the Boehm-Demers-Weiser garbage
  19.    collector with SmallEiffel?
  20.    Q11: [11]Why don't you post more messages in newsgroups and/or mailing
  21.    lists?
  22.    Q12: [12]It is possible to create applets with compile_t_jvm?
  23.    Q13: [13]Where do I send bug reports?
  24.    Q14: [14]Is there a mechanism to precompile libraries?
  25.    Q15: [15]How is SmallEiffel compiled?
  26.    Q16: [16]How do I keep informed about SmallEiffel?
  27.    Q17:
  28.      [17]What documentation is provided with SmallEiffel?
  29.    Where can I find Eiffel documentation?
  30.    
  31.    Questions and answers
  32.    
  33.    Q01: Why the name SmallEiffel The GNU Eiffel Compiler?
  34.    A01: SmallEiffel comes from the mixing of the names Smalltalk and
  35.    Eiffel. Our aim is to offer an Eiffel development environment as easy
  36.    to use as Smalltalk and as safe as Eiffel. Since version -0.82,
  37.    SmallEiffel has been promoted by the Free Software Foundation the
  38.    official GNU Eiffel Compiler.
  39.    
  40.    Q02: What's the matter with version numbering?
  41.    A02: Version numbering uses negative numbers. The first distributed
  42.    version was numbered -0.99, the second one -0.98, the third -0.97, and
  43.    so on. Version number -0.0 should correspond to the very best Eiffel
  44.    compiler on this planet :-)
  45.    
  46.    Q03: Is it possible to have the complete Eiffel source code of
  47.    SmallEiffel?
  48.    A03: Since it is the GNU Eiffel Compiler, the complete source code of
  49.    SmallEiffel is of course in the distribution. The source code for
  50.    additional libraries is also provided.
  51.    
  52.    Q04: Is it possible to use SmallEiffel for large/commercial
  53.    applications?
  54.    A04: It is very possible to use SmallEiffel for a large application.
  55.    An Eiffel compiler is a really big project and SmallEiffel itself is
  56.    fully written in Eiffel. SmallEiffel is completely free and any
  57.    private compagny can use SmallEiffel freely, and distribute freely the
  58.    products made with it. They do not have to pay royalties. However,
  59.    SmallEiffel doesn't come with any warranty (please read the COPYING
  60.    file in the distribution). For extended support as well as consulting,
  61.    see [18]here.
  62.    
  63.    Q05: Is it possible to do incremental compilation with SmallEiffel?
  64.    A05: Before release -0.91 the answer was no. The answer is now YES.
  65.    Because of the SmallEiffel type inference mechanism, SmallEiffel
  66.    always produces all needed C files from scratch. As old C files are
  67.    automatically saved, only modified C files are recompiled. See
  68.    [19]man/compile for details.
  69.    
  70.    Q06: Is there a SmallEiffel mailing list?
  71.    A06: Yes! SmallEiffel users and developpers can share their
  72.    experiences and ideas by subscribing to the [20]SmallEiffel official
  73.    mailing list.
  74.    
  75.    Q07: What about the Guru section?
  76.    A07: Some feature section of the SmallEiffel library are labelled with
  77.    :
  78.         feature -- The Guru section :
  79.    If you really need your software to be portable on other Eiffel
  80.    compilers, do not use those features.
  81.    
  82.    Q08: Is it difficult to switch from ISE to SmallEiffel?
  83.    A08: If your original ISE software only uses simple types like
  84.    INTEGER, STRING, ARRAY, BOOLEAN, CHARACTER and DOUBLE, it is usually
  85.    very simple. It is a little bit difficult for simple input/output
  86.    (used with predefined `io') because some features have different
  87.    names. If your original software heavily relies on the EiffelBase
  88.    library, it may be very difficult. For example, one must keep in mind
  89.    that SmallEiffel.ARRAY inherit SmallEiffel.COLLECTION and that ISE
  90.    library also have a class COLLECTION. By the way, subclasses of
  91.    ISE.COLLECTION cannot be used. The ISE.LINKED_LIST can be used in
  92.    conjunction with SmallEiffel.ARRAY because ISE.LINKED_LIST do not
  93.    inherit ISE.COLLECTION (no clash).
  94.    
  95.    Q09: Are there mirror FTP sites for SmallEiffel?
  96.    A09: Australia
  97.    [21]ftp://ftp.progsoc.uts.edu.au/pub/Eiffel/SmallEiffel/
  98.    Austria [22]http://gd.tuwien.ac.at/pub/languages/SmallEiffel/
  99.    USA [23]ftp://ftp.cs.rit.edu/pub/mirrors/SmallEiffel/
  100.    
  101.    Q10: Is it possible to use the Boehm-Demers-Weiser garbage collector
  102.    with SmallEiffel?
  103.    A10: Yes.
  104.    You just have to disable the generation of the GC by SmallEiffel
  105.    (option -no_gc) and replace it by the BDW library. Note that the BDW
  106.    GC can be easily added because SmallEiffel only uses
  107.    malloc/realloc/calloc/free.
  108.    You can download the BDW library from :
  109.    [24]http://reality.sgi.com/boehm_mti/gc_source
  110.           
  111.    How to integrate the Boehm-Demers-Weiser garbage collector with
  112.    SmallEiffel (from a message of Dietmar Wolz) :
  113.     1. Make the gc.a file from the BDW package. Then move this gc.a file
  114.        to /usr/lib/libgc.a.
  115.     2. Move gc.h the to working directory and add the following lines:
  116.        #define malloc(n) GC_malloc(n)
  117.        #define calloc(m,n) GC_malloc((m)*(n))
  118.        #define realloc(p,n) GC_realloc((p),(n))
  119.        #define free(p) GC_free(p)
  120.     3. instead of calling
  121.            "compile -o executable -boost -O root"
  122.        now call
  123.            "compile -o executable -boost -O root -no_gc -lgc -include
  124.        gc.h
  125.        
  126.    
  127.    Q11: Why don't you post more messages in newsgroups and/or mailing
  128.    lists?
  129.    A11: First, because we strongly believe that too much information
  130.    kills information. Scientists call this "cognitive overload". :)
  131.    Second, because we don't have the time. It takes an awful amount of
  132.    time to follow discussions, whichever their quality. We try to do
  133.    that. But it's even more time-consuming to be part of them. So, we
  134.    often have too choose betwen posting/mailing, and working directly on
  135.    SmallEiffel. Since our mailboxes tend to overflood, we generally
  136.    choose the latter :)
  137.    
  138.    Q12: It is possible to create applets with compile_t_jvm?
  139.    A12: Not yet. SmallEiffel was designed to compile Eiffel applications
  140.    to C code or Java bytecode, but not applets.
  141.    
  142.    Q13: Where do I send bug reports?
  143.    A13: You can send them either to [25]Dominique.Colnet@loria.fr and
  144.    Olivier.Zendra@loria.fr, or to [26]the SmallEiffel mailing-list.
  145.    Don't worry if you don't get an ack: we don't send them because it
  146.    takes time, but we store all the bug reports we receive. And we even
  147.    try to fix them ASAP! :)
  148.    
  149.    Q14: Is there a mechanism to precompile libraries?
  150.    A14: No, there is no such mechanism in SmallEiffel. But if you're
  151.    concerned about speed, don't worry, precomputed libraries are not the
  152.    only way to be fast ! Just try SmallEiffel, and you'll see :)
  153.    
  154.    Q15: How is SmallEiffel compiled?
  155.    A15: With Eiffel optimization options -boost and -no_gc. The garbage
  156.    collector is indeed useless on the SmallEiffel commands: since
  157.    SmallEiffel did not include a GC in its first versions, we were very
  158.    careful about memory when we developped it.
  159.    With C compilation optimizations turned on (it depends on the C
  160.    compiler used; we generally use GCC).
  161.    The resulting executables are stripped.
  162.    
  163.    Q16: How do I keep well informed about SmallEiffel?
  164.    A16: The best way is to keep an eye on our web pages, more especially
  165.    on the [27]What's New? page and the [28]History of Changes.
  166.    People who want detailed information may also decide to stay tuned to
  167.    [29]the SmallEiffel mailing-list.
  168.    
  169.    Q17:
  170.      What documentation is provided with SmallEiffel?
  171.    Where can I find Eiffel documentation?
  172.    A17: The documentation provided with SmallEiffel is a transcript of
  173.    what you can find on the original SmallEiffel Web site, at
  174.    [30]http://SmallEiffel.loria.fr. It is related only to the use and
  175.    internals of SmallEiffel (yes, we know we still have to improve it ;)
  176.    ).
  177.    For information and documentation about the Eiffel language, check the
  178.    links on our [31]Internet resources page. Note that we are not aware
  179.    of any complete Eiffel language manual freely available on the Web
  180.    (yet?).
  181.    
  182.                                    [Line]
  183.                                       
  184.              Copyright © Dominique COLNET and Suzanne COLLIN -
  185.                            [32]<colnet@loria.fr>
  186.                      Last update: 14 May 1999, by OZ. 
  187.  
  188. References
  189.  
  190.    1. file://localhost/home/colnet/SmallEiffel/man/man/SmallEiffelFAQ.html#Q01
  191.    2. file://localhost/home/colnet/SmallEiffel/man/man/SmallEiffelFAQ.html#Q02
  192.    3. file://localhost/home/colnet/SmallEiffel/man/man/SmallEiffelFAQ.html#Q03
  193.    4. file://localhost/home/colnet/SmallEiffel/man/man/SmallEiffelFAQ.html#Q04
  194.    5. file://localhost/home/colnet/SmallEiffel/man/man/SmallEiffelFAQ.html#Q05
  195.    6. file://localhost/home/colnet/SmallEiffel/man/man/SmallEiffelFAQ.html#Q06
  196.    7. file://localhost/home/colnet/SmallEiffel/man/man/SmallEiffelFAQ.html#Q07
  197.    8. file://localhost/home/colnet/SmallEiffel/man/man/SmallEiffelFAQ.html#Q08
  198.    9. file://localhost/home/colnet/SmallEiffel/man/man/SmallEiffelFAQ.html#Q09
  199.   10. file://localhost/home/colnet/SmallEiffel/man/man/SmallEiffelFAQ.html#Q10
  200.   11. file://localhost/home/colnet/SmallEiffel/man/man/SmallEiffelFAQ.html#Q11
  201.   12. file://localhost/home/colnet/SmallEiffel/man/man/SmallEiffelFAQ.html#Q12
  202.   13. file://localhost/home/colnet/SmallEiffel/man/man/SmallEiffelFAQ.html#Q13
  203.   14. file://localhost/home/colnet/SmallEiffel/man/man/SmallEiffelFAQ.html#Q14
  204.   15. file://localhost/home/colnet/SmallEiffel/man/man/SmallEiffelFAQ.html#Q15
  205.   16. file://localhost/home/colnet/SmallEiffel/man/man/SmallEiffelFAQ.html#Q16
  206.   17. file://localhost/home/colnet/SmallEiffel/man/man/SmallEiffelFAQ.html#Q17
  207.   18. file://localhost/home/colnet/SmallEiffel/man/support/support.html
  208.   19. file://localhost/home/colnet/SmallEiffel/man/man/compile.html
  209.   20. file://localhost/home/colnet/SmallEiffel/man/support/mailing-list.html
  210.   21. ftp://ftp.progsoc.uts.edu.au/pub/Eiffel/SmallEiffel/
  211.   22. http://gd.tuwien.ac.at/pub/languages/SmallEiffel/
  212.   23. ftp://ftp.cs.rit.edu/pub/mirrors/SmallEiffel/
  213.   24. http://reality.sgi.com/boehm_mti/gc_source/
  214.   25. mailto:Dominique.Colnet@loria.fr,Olivier.Zendra@loria.fr
  215.   26. file://localhost/home/colnet/SmallEiffel/man/support/mailing-list.html
  216.   27. file://localhost/home/colnet/SmallEiffel/man/general/whatsnew.html
  217.   28. file://localhost/home/colnet/SmallEiffel/man/misc/HISTORY.html
  218.   29. file://localhost/home/colnet/SmallEiffel/man/support/mailing-list.html
  219.   30. http://SmallEiffel.loria.fr/
  220.   31. file://localhost/home/colnet/SmallEiffel/man/general/resources.html
  221.   32. mailto:colnet@loria.fr
  222.