home *** CD-ROM | disk | FTP | other *** search
/ Simtel MSDOS - Coast to Coast / simteldosarchivecoasttocoast2.iso / calculat / meval113.zip / README.DOC < prev   
Text File  |  1993-10-18  |  5KB  |  120 lines

  1. Eval is a floating point expression evaluator.
  2. This is version 1.13
  3. Copyright (C) 1993  Will Menninger
  4.  
  5.  
  6. NOTE:  This is not the same Eval program as the one by Copy Con, Inc,
  7.        though they have a similar purpose.  They are completely
  8.        independent efforts.  I put the "m" in the archive name
  9.        (meval113.zip--m for Menninger) to distinguish the archive
  10.        from Copy Con's EVAL106.ZIP.
  11.  
  12. Other MS-DOS utilities like Eval are UCalc, by Daniel Corbier, and
  13. MathFC, by Greg Kochaniak, both at garbo.uwasa.fi:/pc/math.  If Eval
  14. doesn't satisfy you, you might try these.
  15.  
  16.  
  17. Brief Description
  18. -----------------
  19. Eval 1.13 is an interactive floating point C-like expression evaluator.
  20. You give it an expression with numeric constants and variables and
  21. functions, and it churns out a numeric answer.    You can use it to
  22. immediately evaluate an expression from the DOS prompt, or you can run
  23. it interactively, storing variables as you go so that you can do more
  24. involved calculations.    To use Eval, just give it an expression:
  25.  
  26. Eval "2*3+sin(_pi*.44/2)"
  27.  
  28. (The quotes are necessary on some operating systems to prevent
  29. misinterpretation of the * and other special characters).
  30. Or just run Eval without arguments.  Documentation is built-in.
  31. To get Eval to print it's documentation, on most O/S's, just type
  32.  
  33. Eval help > evalhelp.txt
  34.  
  35. Then print the file evalhelp.txt.
  36.  
  37. Eval's features include good precision, input and output in any number
  38. base, a large number of built-in functions and constants, flexible
  39. numeric output format, and ability to save and recall sessions from disk.
  40. Eval, however, does not have these features:  arbitrary precision, symbolic
  41. manipulation, dynamic function definition, and complex numbers.
  42.  
  43. You can modify Eval to your heart's content.  The source code is included
  44. with this distribution.  To see how to add custom functions or constants,
  45. see the "Source Code" section below.  The source is in ANSI C and has no
  46. conditional compile directives.  I have compiled Eval without modification
  47. on several different ANSI C compilers, including the MIPS u-code C
  48. compiler, the NERSC cc compiler, Macintosh Think C 5.0, Turbo C 2.0,
  49. Manx Aztec C 5.2 (Amiga), and SAS C 6.0 (Amiga).  I have compiled on
  50. VMS with minor modifications due to the compiler I used not being ANSI
  51. standard.
  52.  
  53.  
  54. Licensing
  55. ---------
  56. This is my first venture into public domain software, and while I hate
  57. dealing with rules and licenses and all that, I decided that I had to
  58. protect myself, so I am using the GNU public license agreement to set
  59. the terms for redistributing this software.  Please read the GNU public
  60. license agreement in the file, COPYING.  In sum, the license allows you
  61. to freely copy and modify this software, but you can't pull any dirty
  62. tricks like using it for profit or calling it your own or making up your
  63. own restrictions on it if you redistribute it.
  64.  
  65.  
  66. Distribution Description -- MS-DOS
  67. ----------------------------------
  68. This distribution comes with the full source code to Eval, which is
  69. written for ANSI compliant C compilers.  This distribution also includes
  70. an executable version of Eval for MS-DOS machines, EVAL.EXE.
  71.  
  72. The IBM-PC version was compiled using Borland's Turbo C 2.0.  It
  73. auto-detects an FPU and uses it if available.  It should work on any PC.
  74.  
  75.  
  76. The source code
  77. ---------------
  78. In the SRC directory of this archive are nine C modules, one header
  79. file, and several make files.  If you would like to add custom constants
  80. to Eval, look at eval.c.  If you would like to add custom functions to
  81. Eval, look at funcs.c.    Step by step instructions are presented.
  82.  
  83. To compile on Unix:   Use Makefile.unx
  84.  
  85. To compile on a Mac:  There is no Makefile, but I had no trouble
  86.               compiling all modules with Think C 5.0.
  87.               I threw all of the modules into my project window,
  88.               added the "ANSI" library, put eval.c at the top,
  89.               and selected "Build Application."
  90.  
  91. To compile on Amiga:  Use Makefile.asa (SAS C 6.X)
  92.                or Makefile.ama (Manx C 5.X)
  93.  
  94. To compile on IBM-PC: Use Makefile (Borland Turbo C 2.X)
  95.  
  96. If you would like an Eval executable for an Amiga or a Macintosh,
  97. and you don't have a C compiler, check the file POSTS.DOC.
  98.  
  99.  
  100. Other files
  101. -----------
  102. COPYING        The GNU public license agreement
  103. posts.doc      List of FTP sites where Eval is posted
  104. history.doc    History of Eval versions
  105.  
  106.  
  107. Closing comments
  108. ----------------
  109. That's it.  I hope Eval is of use to you.
  110.  
  111.  
  112. Will Menninger
  113. MIT Graduate Student (until 1/94 at least :-)
  114.  
  115. 45 River St., #2, Boston, MA 02108-1124 (until I graduate)
  116. 2162 Dudley St., Pasadena, CA 91104 (after I graduate until 7/94)
  117. (You can mail to Pasadena to be safe.  I will get it.)
  118.  
  119. e-mail:  willus@ilm.pfc.mit.edu (until I graduate)
  120.