home *** CD-ROM | disk | FTP | other *** search
/ POINT Software Programming / PPROG1.ISO / misc / euphoria / readme.doc < prev    next >
Encoding:
Text File  |  1994-03-09  |  8.8 KB  |  190 lines
  1.             ---------------------
  2.                 Euphoria 1.2
  3.             Public Domain Edition
  4.             ---------------------
  5.  
  6.  Welcome to Euphoria! ... End User Programming with Hierarchical Objects
  7.               for Robust Interpreted Applications
  8.  
  9.  Euphoria is a very-high-level programming language with the following 
  10.  features: 
  11.  
  12.     * The language is extremely simple, flexible, and easier to learn 
  13.       than BASIC.
  14.  
  15.     * There is no waiting for compiles and links - just edit and run. 
  16.  
  17.     * Dynamic storage allocation with garbage collection is fundamental
  18.       to Euphoria. Variables can easily grow or shrink in size. Elements 
  19.       of an array (Euphoria sequence) can be a dynamic mixture of 
  20.       different types and sizes of data.
  21.  
  22.     * Variable types can be as rigid or as flexible as you like. You can 
  23.       specify the precise set of legal values that may be assigned to 
  24.       any variable. You can easily write generic code that works on any 
  25.       type of data.
  26.  
  27.     * Euphoria provides extensive run-time error checking for: 
  28.       out-of-bounds subscripts, uninitialized variables, bad parameter 
  29.       values for built-in functions, illegal value assigned to a variable,
  30.       and many more. If something goes wrong with your program you will
  31.       always get a full message with a traceback and a dump of variable 
  32.       values - no mysterious machine "lockups" or crashes.
  33.  
  34.     * Program execution speed is 10 to 20 times faster than 
  35.       Microsoft QBasic, and only a few times slower than compiled, 
  36.       optimized C/C++ -- an astonishing fact, given the flexibility, 
  37.       run-time safety and interpretive nature of the language.
  38.  
  39.     * Euphoria programs are not constrained by any 640K or 64K memory 
  40.       restrictions for which MS-DOS is infamous. You can use all of the 
  41.       multiple megabytes of extended memory on your system seamlessly,
  42.        and if that isn't enough you can use a swap file on disk to page
  43.       chunks of memory in and out based on a least-recently-used 
  44.       algorithm.
  45.  
  46.     * An integrated easy-to-use full-screen source-level debugger/tracer 
  47.       is included.
  48.  
  49.     * A statement-level profiler is included.
  50.  
  51.     * A full-screen editor with color syntax highlighting and 
  52.       auto-completion of Euphoria statements is provided, complete
  53.       with Euphoria source code that you are free to modify.
  54.  
  55.     * A large collection of interesting demo programs written in Euphoria
  56.       is provided.
  57.  
  58.  Who would benefit from using Euphoria?
  59.  
  60.      * novices / students
  61.         - Euphoria is one of the simplest and easiest of all 
  62.           languages to learn
  63.         - Euphoria completely shields you from machine-level
  64.           issues such as memory addresses, number of bits in a byte 
  65.           etc.
  66.         - Euphoria does more error checking than any other
  67.           popular language            
  68.         - Euphoria never leaves you with a locked-up or crashed
  69.           machine - you'll always get a clear explanation of what
  70.           went wrong
  71.  
  72.     * hobbyists 
  73.         - take a look at some of the interesting games and
  74.           graphics demos we've included
  75.         - do you really want to invest the time and money
  76.           needed to learn C++?
  77.         - do you really enjoy spending your weekends tracking
  78.           down subtle pointer corruption bugs?
  79.         
  80.     * professionals/businesses 
  81.         - You can develop a reliable, maintainable, fully-
  82.           debugged program in *much* less time in Euphoria
  83.           than in C/C++.  
  84.         - The level of experience and machine knowledge required
  85.           to use Euphoria is much lower than for C/C++. You won't
  86.           have to hire high-priced programmers. You can do the job
  87.           yourself, or hire lower-priced people.
  88.         - take a look at include\sort.e. Can you write a 
  89.           generic sort routine this easily in C++?
  90.         - See demo\mydata.ex. Can you set up a simple database this
  91.           easily in any other language? Or must you purchase an
  92.           expensive, complicated database management system that
  93.           can't really be customized to your liking?
  94.         - Euphoria started out as a language for rapid 
  95.           prototyping - then we discovered how to make it fast!
  96.  
  97.  Euphoria comes in two different editions: a Public Domain Edition and a
  98.  Complete Edition. Both editions will run any Euphoria program of any size at
  99.  full speed, and will report all "compile-time" errors such as syntax errors,
  100.  undeclared variables etc. The only restriction in the Public Domain Edition 
  101.  is that full diagnostic information for run-time errors is not provided
  102.  for large programs.
  103.  
  104.  For programs up to 50 executable statements in size you will enjoy the full 
  105.  support of Euphoria's excellent debugging facilities. Your program can have 
  106.  an infinite number of declarations, blank-lines, comments, "end if", etc.
  107.  -- they aren't counted. The standard include files are also free. 
  108.  
  109.  For larger programs, a run-time error will cause your program to halt
  110.  with just a brief message. The usual fully-detailed diagnostics with a dump
  111.  of variable values and other debugging information will not be provided.
  112.  However, the source debugger and profiler will remain fully operational,
  113.  so you can debug the way you would in C/C++ or other compiled languages.
  114.  In C/C++ very few run-time errors are even detected (until your machine
  115.  locks up or crashes). Your productivity will remain much higher in Euphoria, 
  116.  given the run-time safety, flexibility and expressive power of the language, 
  117.  plus the fact that you won't waste time compiling and linking.  
  118.  
  119.  We want you to enjoy writing some great programs in Euphoria. When you 
  120.  decide that you like the language, and want to save time developing 
  121.  large programs, we hope you will decide to purchase the latest Complete 
  122.  Edition and the desktop-published printed manual. See doc\register.doc for 
  123.  details.
  124.  
  125.  An ASCII text version of the complete Euphoria Reference Manual is in 
  126.  doc\refman.doc. 
  127.  
  128.  You are free to distribute the Public Domain Edition, without royalty, so 
  129.  anyone can run a Euphoria program that you have developed. The Rational 
  130.  Systems DOS-extender, "dos4gw.exe", required by Euphoria, is also 
  131.  royalty-free when used with Euphoria. Use bin\shroud.ex to create Euphoria's
  132.  equivalent to a DOS .exe file. 
  133.  
  134.  You may *not* distribute the Complete Edition, in particular the version of 
  135.  the file "ex.exe" that comes with the Complete Edition.
  136.  
  137.  The Public Domain Edition of Euphoria, in its entirety, is being placed 
  138.  in the Public Domain. This includes the Public Domain version of the 
  139.  compiler/interpreter "ex.exe" and all of the demo programs, including the 
  140.  editor. There's over 11,000 lines of free Euphoria source code in
  141.  this package. We encourage you to use it, copy it, distribute it, upload it 
  142.  to BBS's etc. 
  143.  
  144.  To run Euphoria you must have MS-DOS on any 386/486 or Pentium processor.
  145.  Euphoria runs comfortably on any 2 Mb PC that has at least 250K of 
  146.  free extended memory. It has been well tested under MS-DOS 4, 5, 6 and 
  147.  6.2, and Windows 3.1. If the Public Domain Edition runs on your machine, the 
  148.  Complete Edition will also run. Euphoria exploits the full 32-bit power of 
  149.  your PC. A Euphoria program will run under DOS, or as a DOS application under
  150.  Windows - just double-click on the file name, or open a DOS prompt window.
  151.  
  152.  What's in this Public Domain release:
  153.  
  154.     subdirectory (after installing)
  155.     BIN        - Euphoria (ex.exe), grep, lines, eprint, retab and more 
  156.  
  157.     INCLUDE    - standard .e include files
  158.  
  159.     DEMO       - games, benchmarks and other Euphoria programs that
  160.              you can run to check out Euphoria
  161.  
  162.            LEARN   - test your knowledge of Euphoria
  163.            LANGWAR - real-time action space wars game
  164.            BENCH   - benchmark programs and results
  165.  
  166.     DOC        documentation files, including the Reference Manual
  167.  
  168.     
  169.     -----------------------------------------------------
  170.     -- Read install.doc now to find out how easy it is --
  171.     -- to install Euphoria on your hard disk.          --                                       --
  172.     -----------------------------------------------------
  173.  
  174. ----------------------------------------------------------------------------
  175.   Notice to Shareware Vendors:
  176.   We encourage you to distribute this Public Domain Edition of Euphoria.
  177.   You can charge whatever you like for it. It is not shareware in the
  178.   usual sense. People can use Euphoria for as long as they like without
  179.   obligation. We make money from those who start to seriously develop large 
  180.   applications, and want to get the latest release, with printed manual, 
  181.   and enhanced debug support for large programs.
  182. ----------------------------------------------------------------------------
  183.  
  184. ----------------------------------------------------------------------------
  185.   DISCLAIMER: The Public Domain and Complete Editions of Euphoria are
  186.   provided "as is" without warranty of any kind. In no event shall 
  187.   Rapid Deployment Software be held liable for any damages arising 
  188.   from the use of or inability to use this product.
  189. ----------------------------------------------------------------------------
  190.