*** This is a -*-text-*- file

calc v2.0.0, Copyright (C) 1999 Eduardo M Kalinowski (ekalin@iname.com)
This program comes with ABSOLUTELY NO WARRANTY. See COPYING file for details.

Installation instructions:
--------------------------

	There are pre-built binaries for MS-DOS. If you use another
system or want to re-build the program, probably you just need to type
`make'. Due to the simplicity of the program, it is unlikely that
you'll need to change something in the source code or Makefile, except
the $(CC) option.

        To build calc, you'll need the GNU Readline library. The
MS-DOS binary is staticaly linked against Readline, so you'll just
need it if you want to re-build the calc. If you don't have Readline,
you can it from any GNU mirror, such as prep.ai.mit.edu .

        To install calc, run the command `make install'. This will by
default install calc in the /usr/local directory (and its
subdirectories). If you want another prefix, specify it this way:

  make install INSTALLPREFIX="/opt"

substituting /opt for the prefix you want.

        After building, you may want to run `make clean' to get rid of
the object files.


Instructions for building under MS-DOS:
---------------------------------------

	If you really want to re-build the sources under MS-DOS, I
recommend you using DJ Delorie's DJGPP (http://www.delorie.com/djgpp/ )
to do that. The program compiles fine with DJGPP and requires no
changes. The MS-DOS binary that comes with this package is made with
DJGPP.

        If you need to use another compiler, you might have to change
some things. The most likely thing you'll have to change is the
doShell function in the src/cmd_misc.c file. There are instructions in
the function saying what you might need to change.

        If you just run `make' from DJGPP, you'll get a calc file, and
a calc.exe file. Delete the first, it is not a real DOS executable. If
you want, you can edit the Makefile and replace the line

calc: $(OBJECTS)

with

calc.exe: $(OBJECTS)

to avoid that.

        Using `make install' will not work under MS-DOS systems.
You'll need to do the installation yourself. The calc.hlp file must
reside in the same directory as the executable. (But only for MS-DOS
systems, under _real_ operating systems this is not true.)


How to change the stack limit
-----------------------------

	The maximum number of elements in the stack is defined by the
macro MAXSTACKITEMS. It defaults to 25, but should you need (or want)
more elements, you just need to change it. Either modify the file
src/calc.h , or better yet, use the -D command line switch. For
example:

make CFLAGS=-DMAXSTACKITEMS=100

to allocate space for 100 stack items.

