home *** CD-ROM | disk | FTP | other *** search
/ Chip 2000 May / chip-cd_2000_05.zip / 05 / aktualnosci / shareware / euphoria / README.DOC < prev   
Text File  |  2000-01-13  |  14KB  |  301 lines
  1.  
  2.  
  3.  ---> Is this the latest version of Euphoria?
  4.       Visit:  http://www.RapidEuphoria.com
  5.       
  6.  ---> To install Euphoria see install.doc
  7.       
  8.  ---> What's new in this release?
  9.       See relnotes.doc (after installing)
  10.  
  11.  
  12.  
  13.                              Euphoria version 2.2
  14.                               for WIN32 + DOS32
  15.                               January 14, 2000
  16.  
  17.  
  18.  
  19.  Welcome to Euphoria! ... End User Programming with Hierarchical Objects for
  20.                           Robust Interpreted Applications
  21.  
  22.  
  23.  Euphoria has come a long way since v1.0 was released in July 1993. There are
  24.  now several hundred registered users, located in 45 countries around the
  25.  world. There are several thousand non-registered users. Each year has seen
  26.  significantly more registrations than the year before. There is a Euphoria
  27.  newsgroup, alt.lang.euphoria, as well as an automated mailing list with
  28.  hundreds of users subscribed. The Euphoria Web site contains over 500
  29.  contributed .zip files packed with Euphoria source programs and library
  30.  routines. Dozens of people have set up their own independent Web pages with
  31.  Euphoria-related content. Euphoria has been used in a variety of commercial
  32.  programs. The 32-bit DOS version has been used to create many exciting
  33.  high-speed action games, complete with Sound Blaster sound effects. The 32-bit
  34.  Windows version has been used to create numerous GUI, utility and
  35.  Internet-related programs. The Linux version has been used to write X Windows
  36.  GUI programs, CGI programs, and lots of useful tools and utilities.
  37.  
  38.  
  39.  Yet Another Programming Language?
  40.  =================================
  41.  
  42.  Euphoria is a very-high-level programming language with several features that
  43.  set it apart from the crowd:
  44.  
  45.       * Euphoria programs run on 32-bit extended DOS, 32-bit Windows and now
  46.         Linux.
  47.  
  48.       * The language is flexible, powerful, and easier to learn than BASIC.
  49.  
  50.       * There is no waiting for compiles and links - just edit and run.
  51.  
  52.       * You can create and distribute a royalty-free, stand-alone .exe file.
  53.  
  54.       * Dynamic storage allocation is fundamental to Euphoria. Variables grow
  55.         or shrink in size without the programmer having to worry about
  56.         allocating and freeing chunks of memory. Elements of an array (Euphoria
  57.         sequence) can be a dynamic mixture of different types and sizes of
  58.         data.
  59.  
  60.       * Variable types can be as rigid or as flexible as you like. You can
  61.         specify the precise set of legal values that may be assigned to any
  62.         variable. You can easily write generic code that works on any type of
  63.         data.
  64.  
  65.       * Euphoria is not a true object-oriented language, but has features that
  66.         support object-oriented programming. Euphoria is simple, but very
  67.         powerful. Problems that require dozens of obscure statements in C++,
  68.         can often be solved in Euphoria with just a few simple statements.
  69.  
  70.       * Euphoria provides extensive run-time error checking for: out-of-bounds
  71.         subscripts, uninitialized variables, bad parameter values for library
  72.         routines, illegal value assigned to a variable, and many more. If
  73.         something goes wrong you'll get a full error message, with a traceback
  74.         and a dump of variable values - no mysterious machine "lockups" or
  75.         crashes.
  76.  
  77.       * Program execution speed is 10 to 20 times faster than Microsoft QBasic,
  78.         and 34 times faster than either Perl or Python.
  79.  
  80.       * Euphoria programs are not constrained by any 640K or 64K memory
  81.         restrictions for which MS-DOS is infamous. The DOS32, WIN32 and Linux
  82.         versions of Euphoria let you use all of the megabytes of memory on your
  83.         system seamlessly, and if that isn't enough, a swap file on disk will
  84.         provide additional virtual memory.
  85.  
  86.       * An integrated, easy-to-use, full-screen source-level debugger/tracer is
  87.         included.
  88.  
  89.       * Both an execution-count profiler, and a time profiler are available.
  90.  
  91.       * A full-screen, multi-file editor with color syntax highlighting and
  92.         auto-completion of Euphoria statements is provided, complete with
  93.         Euphoria source code that you are free to modify.
  94.  
  95.       * A large collection of interesting demo programs written in Euphoria is
  96.         provided.
  97.  
  98.       * There is a large and rapidly growing collection of excellent 3rd party
  99.         programs and libraries, most with full source code.
  100.  
  101.       * The DOS32 implementation of Euphoria on MS-DOS is full and complete. If
  102.         necessary, you can access DOS software interrupts. You can call
  103.         machine-code routines. You can even set up your own hardware interrupt
  104.         handlers. Several high-speed action games, complete with Sound Blaster
  105.         sound effects have been developed 100% in Euphoria, without the need
  106.         for any machine code. Some of these games are now in commercial
  107.         distribution.
  108.  
  109.       * The WIN32 implementation of Euphoria lets you access WIN32 API
  110.         routines, as well as C routines in 32-bit DLLs created by yourself or a
  111.         3rd party. With David Cuny's Win32Lib and other free 3rd-party packages
  112.         you can easily create Windows GUI and Internet programs in Euphoria.
  113.  
  114.       * The Linux implementation of Euphoria lets you access C routines and
  115.         variables in Linux shared libraries, for tasks ranging from graphics,
  116.         to X windows GUI programming, to Internet CGI programming. The good
  117.         news is, you'll be programming in Euphoria, not C.
  118.  
  119.  
  120.  Who Would Benefit from Using Euphoria?
  121.  ======================================
  122.  
  123.  novices / students - Euphoria is one of the simplest and easiest of all
  124.                       languages to learn.
  125.  
  126.  hobbyists          - Take a look at some of the games and high-speed graphics
  127.                       demos we've written, then visit the Web site and download
  128.                       some much better games and demos written by Euphoria
  129.                       users.
  130.  
  131.  professionals      - You can develop a reliable, maintainable, fully-debugged
  132.                       program in much less time in Euphoria than in C/C++.
  133.  
  134.                     - Euphoria can be used as a sophisticated batch file
  135.                       language.
  136.  
  137.                     - Euphoria is great for quick, easy development of file
  138.                       filters and other utilities.
  139.  
  140.                     - You can easily develop GUI and Internet programs without
  141.                       needing a 6-week training course.
  142.  
  143.                     - You can distribute your program royalty-free as a .exe
  144.                       file.
  145.  
  146.  
  147.  
  148.  Platforms and Editions
  149.  ======================
  150.  
  151.  Euphoria runs on three different platforms, DOS32, WIN32 and Linux, and comes
  152.  in two different editions: a Public Domain Edition and a Complete Edition.
  153.  Both editions will run any Euphoria program of any size at full speed, and
  154.  will report all "compile-time" errors such as syntax errors, undeclared
  155.  variables etc. The Complete (registered) Edition has these extra features:
  156.  
  157.       * you can convert any Euphoria program into a single, stand-alone,
  158.         tamper-resistant .exe file for easy distribution. (See bind.doc)
  159.  
  160.       * you can profile any Euphoria program to determine the performance "hot
  161.         spots" and to find logical errors. Both execution-count profiling and
  162.         time-profiling (DOS32 only) are provided.
  163.  
  164.       * you can get full diagnostic information for run-time errors in any size
  165.         of program. The Public Domain Edition provides full run-time
  166.         diagnostics for programs up to 300 statements in size.
  167.  
  168.  For programs over 300 statements, a run-time error in this Public Domain
  169.  Edition will simply cause your program to halt with a brief message. The usual
  170.  fully-detailed diagnostics, including a dump of all variable values and other
  171.  debugging information, will not be provided. However, the excellent
  172.  source-level debugger will remain fully operational, and you can insert debug
  173.  print statements the way you would in C/C++ or other languages. Note that
  174.  C/C++ and other compiled languages do very little checking for run-time
  175.  errors, and provide very little diagnostic information when a run-time error
  176.  occurs. Your productivity will be much higher, programming in Euphoria.
  177.  
  178.  Regarding Statement Count:
  179.  --------------------------
  180.         Blank-lines and comments are not counted, and the standard include
  181.         files in euphoria\include are free (if not altered significantly).
  182.         Useful 3rd party files can be stamped by RDS, making them free,
  183.         provided they are not altered significantly. You can put many
  184.         statements on one line, or you can split a statement across many lines
  185.         -- it won't affect your statement count.
  186.  
  187.  
  188.  We want you to enjoy writing some great programs in Euphoria. Later, when you
  189.  decide that you like the language, and want to take advantage of the enhanced
  190.  features in the Complete Edition, we hope you will register. Registration
  191.  costs only $39 (DOS32+WIN32) or $25 (Linux), and you can reduce or even
  192.  eliminate this cost by contributing useful code for our Web site. See
  193.  register\register.doc for details, or run: ex how2reg.ex in the register
  194.  subdirectory.
  195.  
  196.  The documentation contained in this package comes in both plain text and HTML
  197.  form. The plain text (.doc) files can be viewed with any text editor, such as
  198.  Windows NotePad or WordPad. The HTML (.htm) files can be viewed with your Web
  199.  browser. A tool that we developed in Euphoria allows us to automatically
  200.  generate both plain text and HTML files, from a common source. Thus the
  201.  content of each file in the doc subdirectory should be identical to the
  202.  content of the corresponding file in the html subdirectory, aside from the
  203.  lack of links, fonts, colors, etc. See doc\overview.doc (or html\overview.htm)
  204.  for a summary of the documentation files.
  205.  
  206.  There's over 20,000 lines of free Euphoria source code in this package. We
  207.  encourage you to use it, copy it, modify it, distribute it, upload it etc.
  208.  
  209.  You can freely distribute this Public Domain Edition, in whole or in part, so
  210.  anyone can run a Euphoria program that you have developed. You are completely
  211.  free to distribute any Euphoria programs that you write, royalty-free, even if
  212.  you don't register.
  213.  
  214.  You may *not* distribute the files "ex.exe", "exw.exe", "exu", "bind.ex",
  215.  "bind.bat", "bindw.bat", "bindu", "shroud" or "shroud.bat" that come with the
  216.  Complete Editions.
  217.  
  218.  To run the WIN32 version of Euphoria you need Windows 95, Windows 98, Windows
  219.  NT, or (soon) Windows 2000.
  220.  
  221.  To run the DOS32 version you need MS-DOS (or PC-DOS etc.) on any 386 or higher
  222.  processor. ex.exe will use extended memory if it is available, but can run in
  223.  640K of conventional memory if that is all you have. It has been well tested
  224.  under MS-DOS 4, 5, 6, 6.2 and 7.0, as well as DOS-prompt windows under Windows
  225.  3.1, Windows 3.11, Windows NT, Windows 95, Windows 98 and OS/2. Euphoria
  226.  exploits the full 32-bit power of your PC. A DOS32 Euphoria program will run
  227.  under DOS, or as a DOS application under Windows or OS/2 - just double-click
  228.  on the file name, or open a DOS prompt window.
  229.  
  230.  To run the Linux version of Euphoria you need any reasonably up-to-date Linux
  231.  distribution, that has libc6 or later. For example, Red Hat 5.2, 6.0 or later
  232.  will work fine.
  233.  
  234.  
  235.  Getting Started
  236.  ===============
  237.  
  238.  1.   On DOS/Windows install Euphoria by typing:
  239.  
  240.               install
  241.       
  242.       Don't worry, it's easy to uninstall - see  install.doc.
  243.  
  244.       On Linux see  install.doc.
  245.  
  246.  2.   After you install Euphoria, the documentation files will be in the doc
  247.       and html directories. overview.doc gives an overview of the
  248.       documentation. refman.htm (or refman.doc) should be read first. If you
  249.       want to search for information on any topic, type guru.
  250.  
  251.  3.   Have fun running the programs in the demo directory. Feel free to modify
  252.       them, or run them in trace mode by adding:
  253.  
  254.               with trace
  255.               trace(1)
  256.       
  257.       as the first two lines in the .ex or .exw file.
  258.  
  259.  4.   Try typing in some simple statements and running them. You can use any
  260.       text editor. Later you may want to use the Euphoria editor, ed, or
  261.       download David Cuny's Euphoria editor from the Euphoria Web site.
  262.  
  263.       Don't be afraid to try things. Euphoria won't bite!
  264.  
  265.  5.   See what2do.doc for more ideas.
  266.  
  267.  6.   Visit the Euphoria Web site, download some files, and subscribe to the
  268.       Euphoria mailing list (see web.doc).
  269.  
  270.  
  271.  If you are new to programming, and you find refman.htm hard to follow,
  272.  download David Gay's interactive tutorial called "A Beginner's Guide To
  273.  Euphoria". There's a link to it from the Euphoria Web site.
  274.  
  275.  
  276.  *** If you have any trouble installing, see install.doc ***
  277.  
  278.  
  279.  
  280.  Notice to Shareware Vendors:
  281.  ============================
  282.         We encourage you to distribute this Public Domain Edition of Euphoria.
  283.         You can charge whatever you like for it. People can use Euphoria for as
  284.         long as they like without obligation. We make money from those who
  285.         start to seriously develop large applications, and want technical
  286.         support plus enhanced bind, profile, and debug support for large
  287.         programs.
  288.  
  289.  
  290.  
  291.  DISCLAIMER:
  292.  ===========
  293.         The Public Domain and Complete Editions of Euphoria are provided "as
  294.         is" without warranty of any kind. In no event shall Rapid Deployment
  295.         Software be held liable for any damages arising from the use of or
  296.         inability to use this product.
  297.  
  298.  
  299.  
  300.  
  301.