home *** CD-ROM | disk | FTP | other *** search
/ PC Consument 1998 January / PCC11998.bin / demos / euphor.exe / README.DOC < prev    next >
Encoding:
Text File  |  1997-03-20  |  10.6 KB  |  224 lines
  1.  
  2.  ---> is this the latest version of Euphoria?
  3.       See:  http://ourworld.compuserve.com/homepages/robert_craig/
  4.       
  5.  ---> To install Euphoria see INSTALL.DOC 
  6.             
  7.             
  8.               ---------------------------
  9.                  Euphoria version 1.5
  10.                 March 21, 1997
  11.               ---------------------------
  12.  
  13.  
  14.  Welcome to Euphoria! ... End User Programming with Hierarchical Objects
  15.               for Robust Interpreted Applications
  16.  
  17.  Euphoria is a very-high-level programming language with the following 
  18.  features: 
  19.  
  20.     * The language is flexible, powerful, and easier to learn than BASIC.
  21.  
  22.     * There is no waiting for compiles and links - just edit and run. 
  23.       However, if desired, you can create and distribute a royalty-free,
  24.       stand-alone .exe file.
  25.  
  26.     * Dynamic storage allocation is fundamental to Euphoria. Variables 
  27.       grow or shrink in size without the programmer having to worry
  28.       about allocating and freeing chunks of memory. Elements of an array 
  29.       (Euphoria sequence) can be a dynamic mixture of different types and 
  30.       sizes of data.
  31.  
  32.     * Variable types can be as rigid or as flexible as you like. You can 
  33.       specify the precise set of legal values that may be assigned to 
  34.       any variable. You can easily write generic code that works on any 
  35.       type of data. 
  36.       
  37.     * Euphoria is NOT an object-oriented language. It's much simpler, yet
  38.       in many ways more powerful. Problems that require dozens of obscure 
  39.       statements in C++, can often be solved in Euphoria with just a few 
  40.       simple statements.
  41.  
  42.     * Euphoria provides extensive run-time error checking for: 
  43.       out-of-bounds subscripts, uninitialized variables, bad parameter 
  44.       values for library routines, illegal value assigned to a variable,
  45.       and many more. If something goes wrong you will get a full error 
  46.       message, with a traceback and a dump of variable values - no 
  47.       mysterious machine "lockups" or crashes.
  48.  
  49.     * Program execution speed is 10 to 20 times faster than Microsoft 
  50.       QBasic, and 8 times faster than Sun Microsystems' Java interpreter.
  51.       This is remarkable, given that Euphoria provides much greater 
  52.       flexibility, and run-time safety than either of those languages.
  53.     
  54.     * Euphoria programs are not constrained by any 640K or 64K memory 
  55.       restrictions for which MS-DOS is infamous. You can use all of the 
  56.       multiple megabytes of extended memory on your system seamlessly,
  57.        and if that isn't enough, Euphoria will use a swap file on disk to 
  58.        page chunks of memory in and out based on a least-recently-used 
  59.       algorithm.
  60.  
  61.     * An integrated, easy-to-use, full-screen source-level debugger/tracer 
  62.       is included.
  63.  
  64.     * Both a statement-count profiler, and a time profiler are included.
  65.  
  66.     * A full-screen, multi-file editor with color syntax highlighting and 
  67.       auto-completion of Euphoria statements is provided, complete
  68.       with Euphoria source code that you are free to modify.
  69.  
  70.     * A large collection of interesting demo programs written in Euphoria
  71.       is provided.
  72.  
  73.         * There is a rapidly growing collection of 3rd party programs and 
  74.           libraries. See WEB.DOC
  75.  
  76.         * The implementation of Euphoria on MS-DOS is full and complete.
  77.           If necessary, you can access DOS software interrupts. You can call 
  78.           machine-code routines. You can even set up your own hardware 
  79.           interrupt handlers. Several high-speed action games, complete with 
  80.           Sound Blaster sound effects have been developed 100% in Euphoria,
  81.           without the need for any C/C++ or machine code. Some of these games 
  82.           are now entering commercial distribution. 
  83.           
  84.  Who would benefit from using Euphoria?
  85.  
  86.      * novices / students
  87.         - Euphoria is one of the simplest and easiest of all 
  88.           languages to learn.
  89.         - Euphoria shields you from machine-level issues such as 
  90.           memory addresses, number of bits in a byte etc.
  91.         - Euphoria does more error checking than any other popular 
  92.           language.            
  93.         - Euphoria never leaves you with a crashed machine - 
  94.           you'll always get a clear explanation of what went wrong
  95.  
  96.     * hobbyists 
  97.         - take a look at some of the interesting games and
  98.           high-speed graphics demos we've written, then visit
  99.           the Web and download some even better games and demos
  100.           written by Euphoria users.
  101.         - do you really want to invest the time and money
  102.           needed to learn C++?
  103.         - do you really enjoy spending your weekends tracking
  104.           down subtle pointer corruption bugs?
  105.         
  106.     * professionals/businesses 
  107.         - You can develop a reliable, maintainable, fully-debugged 
  108.           program in *much* less time in Euphoria than in C/C++.  
  109.         - The level of experience and machine knowledge required
  110.           to use Euphoria is much lower than for C/C++. You won't
  111.           have to hire high-priced programmers. You can do the job
  112.           yourself, or hire lower-priced people.
  113.         - take a look at include\sort.e. Can you write a 
  114.           generic routine this easily in C++?
  115.         - See demo\mydata.ex. Can you set up a simple database this
  116.           easily in any other language? 
  117.         - Euphoria can be used as a sophisticated batch file 
  118.           language. 
  119.         - Euphoria is great for quick, easy development of file 
  120.           filters and other utilities.
  121.         - You can distribute your program royalty-free as a .exe file.
  122.         
  123.  Euphoria comes in two different editions: a Public Domain Edition and a
  124.  Complete Edition. Both editions will run any Euphoria program of any size at
  125.  full speed, and will report all "compile-time" errors such as syntax errors,
  126.  undeclared variables etc. The only restriction in the Public Domain Edition 
  127.  is that full diagnostic information for run-time errors is not provided
  128.  for large programs.
  129.  
  130.  For programs up to 300 statements in size you will enjoy the full support of
  131.  Euphoria's excellent debugging facilities. Blank-lines and comments are not 
  132.  counted, and the standard include files are free (if not bound or "shrouded").
  133.  You can put many statements on one line, or you can split a statement across 
  134.  many lines -- it won't affect your statement count.
  135.  
  136.  For larger programs, a run-time error will cause your program to halt
  137.  with just a brief message. The usual fully-detailed diagnostics with a dump
  138.  of variable values and other debugging information will not be provided.
  139.  However, the source debugger and profiler will remain fully operational,
  140.  and you can insert debug print statements the way you would in C/C++ or other 
  141.  languages. In C/C++ very few run-time errors are even detected (until your 
  142.  machine locks up, crashes, or you get a "GPF"). Your productivity will remain
  143.  much higher in Euphoria, given the run-time safety, flexibility and expressive 
  144.  power of the language, plus the fact that you won't waste time compiling and
  145.  linking.  
  146.  
  147.  We want you to enjoy writing some great programs in Euphoria. When you 
  148.  decide that you like the language, and want to save time developing 
  149.  large programs, we hope you will decide to purchase the latest Complete 
  150.  Edition, and the desktop-published printed manual. See doc\register.doc for 
  151.  details, or run doc\how2reg.ex.
  152.  
  153.  An ASCII text version of the complete Euphoria Reference Manual is in 
  154.  doc\refman.doc and doc\library.doc. To save time, just type:  guru  
  155.  to search for subjects that you are interested in.
  156.  
  157.  The Public Domain Edition of Euphoria, in its entirety, is being placed 
  158.  in the Public Domain. This includes the Public Domain version of the 
  159.  compiler/interpreter "ex.exe" and all of the demo programs, including the 
  160.  editor. There's 15,000 lines of free Euphoria source code in this package. 
  161.  We encourage you to use it, copy it, modify it, distribute it, upload it etc. 
  162.  
  163.  You are free to distribute the Public Domain Edition, without royalty, so 
  164.  anyone can run a Euphoria program that you have developed. You can even 
  165.  bind your Euphoria program with a copy of ex.exe to make a single, stand-alone
  166.  .exe file. 
  167.  
  168.  You may *not* distribute the version of the file "ex.exe" that comes with 
  169.  the Complete Edition.
  170.  
  171.  To run Euphoria you must have MS-DOS (or PC-DOS etc.) on any 386 or higher 
  172.  processor. Euphoria will use extended memory if it is available, but can run
  173.  in 640K of conventional memory if that is all you have. It has been well 
  174.  tested under MS-DOS 4, 5, 6, 6.2 and 7.0, Windows 3.1, Windows 3.11, 
  175.  Windows NT, Windows 95 and OS/2. If the Public Domain Edition runs on your 
  176.  machine, the Complete Edition will also run. Euphoria exploits the full 
  177.  32-bit power of your PC. A Euphoria program will run under DOS, or as a 
  178.  DOS application under Windows or OS/2 - just double-click on the file name, 
  179.  or open a DOS prompt window. A Windows WIN32 API version of Euphoria is under
  180.  development, and a Linux version is planned.
  181.  
  182.  What's in this Public Domain release:
  183.  
  184.     subdirectory (after installing)
  185.     BIN        - Euphoria (ex.exe), search, guru, bind, and more 
  186.  
  187.     INCLUDE    - standard .e include files
  188.  
  189.     DEMO       - games, benchmarks and other Euphoria programs that
  190.              you can run to check out Euphoria
  191.  
  192.              \LANGWAR - real-time action space wars game
  193.              \BENCH   - benchmark programs and results
  194.  
  195.     DOC        - documentation files, including the complete 
  196.                  Reference Manual
  197.         
  198.         REGISTER   - information on ordering the Complete Edition, and a
  199.                      program (HOW2REG) to help you register
  200.         
  201.  You can run some of the programs without installing Euphoria, but you really
  202.  should run install.bat to organize the files into subdirectories and
  203.  set yourself up properly. Some programs will not run until you have
  204.  installed.
  205.  
  206.      *** See INSTALL.DOC for easy instructions on installing Euphoria ***
  207.  
  208. ----------------------------------------------------------------------------
  209.   Notice to Shareware Vendors:
  210.   We encourage you to distribute this Public Domain Edition of Euphoria.
  211.   You can charge whatever you like for it. It is not shareware in the
  212.   usual sense. People can use Euphoria for as long as they like without
  213.   obligation. We make money from those who start to seriously develop large 
  214.   applications, and want to get the latest release, with printed manual, 
  215.   and enhanced debug support for large programs.
  216. ----------------------------------------------------------------------------
  217.  
  218. ----------------------------------------------------------------------------
  219.   DISCLAIMER: The Public Domain and Complete Editions of Euphoria are
  220.   provided "as is" without warranty of any kind. In no event shall 
  221.   Rapid Deployment Software be held liable for any damages arising 
  222.   from the use of or inability to use this product.
  223. ----------------------------------------------------------------------------
  224.