
IMPORTANT: Please see the section at the bottom of this file for
	   some important information on Makefiles used in calc.

###################################################################
# IMPORTANT: DO NOT use make in parallel mode!!!		  #
###################################################################
# Unfortunately due to the complex dependency issues between	  #
# Makefile, Makefile.ship and custom/Makefile, parallel make      #
# is NOT recommended.  Sorry (tm Canada) :)			  #
###################################################################

Installing calc from the bzip2-ed tarball: 4 easy steps:

    (0) If your platform supports i686 RPMs, you may want to go to:

	    https://github.com/lcn2/calc/releases

	Open up the 'Assets' tag below a given release and
	download these RPMs:

	    * calc*.i686.rpm
		- all that is needed if you just want to use calc

	    * calc-devel-*.i686.rpm
	        - calc *.h header and *.a lib files for use in other programs

	    * calc.*.src.rpm
	        - calc source via a SRPM package

	Alternately to the above github link, you might try looking at
	the RPMs under:

	    http://www.isthe.com/chongo/src/calc/

=-=

The following 4 steps apply to calc source tree that comes from either:

	bunzip2 -c calc-*.tar.bz2 | tar -xvf -

or from:

	rpm -ivh calc-*.src.rpm
	cd /var/tmp
	bunzip2 -c /usr/src/redhat/SOURCES/calc-*.tar.bz2 | tar -xvf -

4 steps:

(1)	Look at the makefile, and adjust it to suit your needs.

	The top level Makefile and the custom/Makefile require a modern
	Make (such as gmake) or an equivalently advanced make.	On many
	targets, the default make is sufficient.  On FreeBSD for example,
	probably want to use gmake instead of make.

	!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
	! By default, calc assumes you have the readline package installed !
	!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
	! macOS does not have readline, so mac users need to make a choice !
	!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!

	The readline package (-lreadline, -lhistory, -lncurses) used by and
	linked into calc by default.  If your system does NOT have those
	libaraies, then you have two options:

	(1-with readline) Install the readline package 		<- Recommended

	    Install the readline package first, then compile calc.

	    For information on the readline package, see:

		https://tiswww.case.edu/php/chet/readline/rltop.html

	    MacOS users can use MacPorts or HomeBrew to install readline:

		https://www.macports.org
		https://brew.sh

	    Or compile from the readline.git repo:

		http://git.savannah.gnu.org/cgit/readline.git/

	(1-w/o readline) Compile calc without readline 	(not recommended)

	    Why do we not recommend (1b)?  Because using calc with readline
	    provides a beter user experience.

	    If you feel you must use calc without the readline package, then you
	    will need to change your calc Makefile with this patch:

--- Makefile.old	2021-12-29 14:57:56.000000000 -0800
+++ Makefile	2021-12-29 14:59:13.000000000 -0800
@@ -1140,14 +1140,14 @@
 #
 # If in doubt, set USE_READLINE, READLINE_LIB and READLINE_INCLUDE to nothing.
 #
-#USE_READLINE=
-USE_READLINE= -DUSE_READLINE
+USE_READLINE=
+#USE_READLINE= -DUSE_READLINE
 #
-#READLINE_LIB=
-#READLINE_EXTRAS=
+READLINE_LIB=
+READLINE_EXTRAS=
 #
-READLINE_LIB= -lreadline
-READLINE_EXTRAS= -lhistory -lncurses
+#READLINE_LIB= -lreadline
+#READLINE_EXTRAS= -lhistory -lncurses
 #
 #READLINE_LIB= -L/usr/gnu/lib -lreadline
 #READLINE_EXTRAS= -lhistory -lncurses
@@ -1181,8 +1181,8 @@
 # # and using the readline, history, and ncurses libraries.
 # #
 ifneq ($(HOMEBREW_PREFIX),)
-READLINE_LIB:= -L${HOMEBREW_PREFIX}/opt/readline/lib -lreadline
-READLINE_INCLUDE:= -I${HOMEBREW_PREFIX}/opt/readline/include
+#READLINE_LIB:= -L${HOMEBREW_PREFIX}/opt/readline/lib -lreadline
+#READLINE_INCLUDE:= -I${HOMEBREW_PREFIX}/opt/readline/include
 endif
 #
 #endif  /* end of skip for non-Gnu makefiles */

	    If your target system does not have a modern Makefile
	    (such as gmake), then you will need to change your
	    Makefile.simple with this patch:

--- Makefile.simple.orig	2021-12-29 15:00:53.000000000 -0800
+++ Makefile.simple	2021-12-29 15:01:00.000000000 -0800
@@ -1005,14 +1005,14 @@
 #
 # If in doubt, set USE_READLINE, READLINE_LIB and READLINE_INCLUDE to nothing.
 #
-#USE_READLINE=
-USE_READLINE= -DUSE_READLINE
+USE_READLINE=
+#USE_READLINE= -DUSE_READLINE
 #
-#READLINE_LIB=
-#READLINE_EXTRAS=
+READLINE_LIB=
+READLINE_EXTRAS=
 #
-READLINE_LIB= -lreadline
-READLINE_EXTRAS= -lhistory -lncurses
+#READLINE_LIB= -lreadline
+#READLINE_EXTRAS= -lhistory -lncurses
 #
 #READLINE_LIB= -L/usr/gnu/lib -lreadline
 #READLINE_EXTRAS= -lhistory -lncurses

	!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
	! By default, calc assumes you are using a modern gnu-like make tool !
	!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!

	If your target system does not have a modern Makefile (such as gmake),
	then you should try using the Makefile.simple and custom/Makefile.simple
	files:

	    mv Makefile Makefile.gmake
	    cp Makefile.simple Makefile
	    mv custom/Makefile custom/Makefile.gmake
	    cp custom/Makefile.simple custom/Makefile

	The Makefile, as shipped, is suitable for installation under
	Linux and Un*x-like environments.  For the most part, the default
	values should work.  If in doubt, follow the 'When in doubt'
	suggestion.

	If you are using a modern make (such as gmake), you may override
	any values set in the Makefile by adding them to Makefile.local
	using the := directive.  For example:

	    HAVE_STRING_H:= YES
	    HAVE_TIMES_H:= YES
	    SED:= /usr/local/bin/nsed

	!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
	! If you are building under Windows or a Windows-like environment !
	! (such as Cygwin or DJGPP), read the README.WINDOWS file.        !
	!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!

	You should determine if these Makefile variables are reasonable:

	    INCDIR		Where the system include (.h) files are kept.
	    BINDIR		Where to install calc binary files.
	    LIBDIR		Where to install calc link library (*.a) files.
	    CALC_SHAREDIR	Where to install calc help, .cal, startup, and
				config files.

	You may want to change the default installation locations for
	these values, which are based on the 4 values listed above:

	    HELPDIR            where the help directory is installed
	    CALC_INCDIR        where the calc include files are installed
	    CUSTOMCALDIR       where custom *.cal files are installed
	    CUSTOMHELPDIR      where custom help files are installed
	    CUSTOMINCDIR       where custom .h files are installed
	    SCRIPTDIR          where calc shell scripts are installed

	If you want to install calc files under a top level directory,
	then set the T value:

	    The calc install is performed under ${T}, the calc build is
	    performed under /.	The purpose for ${T} is to allow someone
	    to install calc somewhere other than into the system area.

	    For example, if:

		BINDIR= /usr/bin
		LIBDIR= /usr/lib
		CALC_SHAREDIR= /usr/share/calc

	    and if:

		T= /var/tmp/testing

	    Then the installation locations will be:

		calc binary files:	/var/tmp/testing/usr/bin
		calc link library:	/var/tmp/testing/usr/lib
		calc help, .cal ...:	/var/tmp/testing/usr/share/calc
		... etc ...		/var/tmp/testing/...

	    If ${T} is empty, calc is installed under /, which is the same
	    top of tree for which it was built.  If ${T} is non-empty, then
	    calc is installed under ${T}, as if one had to chroot under
	    ${T} for calc to operate.

	Look for the section that starts:

	    ################
	    # compiler set #
	    ################

	    Select a compiler set by commenting in the appropriate set
	    of cc options.  As shipped the Makefile assumes a gcc-like
	    environment such as Linux.  If a more appropriate cc set if
	    found below, comment out the Linux set and comment in that
	    set or edit the gcc set or the common cc set as needed.

	You may want to change these Makefile variables from their defaults:

	    RANLIB

		You may or may not need RANLIB when building libraries.
		As shipped the Makefile assumes RANLIB is needed.
		Comment the in/out the RANLIB value if ranlib does
		not work or does not exist.

	    CALCPAGER

		You may want to change the default pager used by calc.
		As shipped the Makefile assumes 'more'.  On your system
		you may find 'less' to be a better pager.

	    DEBUG

	       Some compilers (to put it mildly) have bugs.  Sometimes the
	       DEBUG Makefile variable causes the compiler / optimizer to
	       produce bad code.  Other compilers do just fine.

	       If possible try to use DEBUG=-O3 -g3 (maximum optimization
	       and debug symbols).  If the calc test fails (see step 3),
	       try lowering either the -O value and/or the -g3.  Also try
	       using -Osomething without -g.

	   Adjust other Makefile variables as needed.

    (2)	build calc:

	The top level Makefile and the custom/Makefile require a GNU
	Make (such as gmake) or an equivalently advanced make.	On many
	targets, the default make is sufficient.  On FreeBSD for example,
	one must use gmake instead of make.

	If your target system does not have GNU Make (or equivalent), then
	you should try using the Makefile.simple and custom/Makefile.simple
	files:

	    mv Makefile Makefile.gmake
	    cp Makefile.simple Makefile
	    mv custom/Makefile custom/Makefile.gmake
	    cp custom/Makefile.simple custom/Makefile

	make all

	==> We are interested in any compiler warnings (and errors) that
	    you may find.  See the BUGS file if you find any compiler
	    warning or errors.

	NOTE: You can force calc to build with only static libs:

		make clobber
		make calc-static-only BLD_TYPE=calc-static-only

	      or force calc to build with only dynamic libs:

		make clobber
		make calc-dynamic-only BLD_TYPE=calc-dynamic-only

    (3)	test calc:

	    make check

	NOTE: For a quiet check which only prints if something goes wrong:

	    make chk

    (4)	install calc:

	    make install

We suggest that you might want to read the README.FIRST file and look at
the calc help subsystem.  See also the README.md file.

In general, if you run into problems, read the BUGS file and follow
the instructions.

=-=

On calc Makefiles:

How to tell the origin of of a Makefile:

    The "# SRC: ... - ..." comment line near the top
    of the file indicates the origin of this file.
    In each segment below, we indicate what the SRC
    comment like will read.

SHELL= ...

    On some systems, /bin/sh is a rather reduced shell with
    deprecated behavior.

    If your system has a up to date, bash shell, then
    you may wish to edit the Makefile to use:

	    SHELL= /bin/bash

    On some systems such as macOS, the bash shell is very
    far behind to the point where is cannot be depended on.
    On such systems, the sh may be a much better alternative
    shell for this Makefile to use:

	    SHELL= /bin/sh

Makefile.local

    # SRC: Makefile.local - tweaks to the top level Makefile

    Between releases, Makefile.local at the top of the master branch
    will contain how we typically build calc and test calc (FYI: we
    normally enable things such as -Werror -Wextra -pedantic).  When we
    push out a release, Makefile.local will be stripped of non-comment
    lines.  Thus, releases of calc, and, released "calc*.src.rpm"
    files and the source tarballs, will have a Makefile.local with
    only comments.

    If the Makefile is not suitable for you (say because you fetch it
    from the top of the master branch between releases), then you may
    wish to remove all non-comment lines.  I.e., lines that do not start
    with the # character.

    This Makefile.local assumes you have a modern make command such as
    the GNU make.  See Makefile.simple comment below if you do not
    have such a modern make command.

    In the calc GitHub repo, Makefile is the calc build environment
    and Makefile.ship is the top level Makefile:

	https://github.com/lcn2/calc

Makefile

    # SRC: Makefile.ship - top level Makefile

    This is the main top level Makefile.

    In calc packages such as RPMs, and the tar.bz2 source tarball,
    Makefile.ship has been moved into Makefile.

    In the calc GitHub repo, Makefile is the calc build environment
    and Makefile.ship is the top level Makefile:

	https://github.com/lcn2/calc

    The Makefile.simple rule of Makefile.ship, when forming the
    Makefile.simple file, removes lines from Makefile.ship between
    pairs of '#if 0' AND '#endif':

	#if 0
	lines removed when forming Makefile.simple
	...
	lines removed when forming Makefile.simple
	#endif

    The '#if 0' AND '#endif' MUST be at the start of the line.
    Any text after the '#if 0' OR '#endif' is ignored.

    While they may look like a CPP directives, they are not.  The
    inline awk script of the Makefile.simple rule does NOT allow
    them to nest:

	#if 0 /* DO NOT DO THIS */
	lines removed when forming Makefile.simple
	...
	#if 0 /* DO NOT DO THIS */
	...
	#endif /* DO NOT DO THIS */
	...
	#endif /* DO NOT DO THIS */

Makefile.simple

    # SRC: Makefile.simple - non-GNU version

    This is a non-GNU or simple Makefile designed for environments
    that do not have a modern make command.

    If you have a Makefile.simple file, use these commands to
    form a Makefile:

	if [ -f Makefile ]; then mv -f Makefile Makefile.orig; fi
	cp Makefile.simple Makefile

    The Makefile.simple rule from Makefile.ship is used to construct
    this file from the contents of Makefile.ship.

    In calc packages such as RPMs, and the tar.bz2 source the
    Makefile.simple exists.  In the calc GitHub repo:

	https://github.com/lcn2/calc

    this file does NOT exist and must be made via the Makefile.simple
    make rule.  Therefore, non-GNU and simple make commands are NOT
    supported by the calc GitHub repo master branch.  Instead, you
    need to extract Makefile.simple from one of the calc tar.bz2
    source tarball source from a calc source mirror:

	http://www.isthe.com/chongo/tech/comp/calc/calc-mirror.html

custom/Makefile

    # SRC: Makefile via make -f Makefile custom/Makefile

    This is the custom directory Makefile.

custom/Makefile.simple

    # SRC: custom/Makefile.simple - non-GNU version

    This is a non-GNU or simple Makefile for the custom directory
    that is designed for environments that do not have a modern make
    command.

    In calc packages such as RPMs, and the tar.bz2 source the
    Makefile.simple exists.  In the calc GitHub repo:

	https://github.com/lcn2/calc

    this file does NOT exist and must be made via the
    custom/Makefile.simple make rule.  Therefore, non-GNU and simple
    make commands are NOT supported by the calc GitHub repo master
    branch.  Instead, you need to extract custom/Makefile.simple
    from one of the calc tar.bz2 source tarball source from a calc
    source mirror:

	http://www.isthe.com/chongo/tech/comp/calc/calc-mirror.html

cal/Makefile

    # SRC: cal/Makefile

    The Makefile for the cal sub-directory.

cscript/Makefile

    # SRC: cscript/Makefile

    The Makefile for the cscript sub-directory.

help/Makefile

    # SRC: help/Makefile

    The Makefile for the help sub-directory.

## Copyright (C) 1999-2007,2021  Landon Curt Noll
##
## Calc is open software; you can redistribute it and/or modify it under
## the terms of the version 2.1 of the GNU Lesser General Public License
## as published by the Free Software Foundation.
##
## Calc is distributed in the hope that it will be useful, but WITHOUT
## ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
## or FITNESS FOR A PARTICULAR PURPOSE.	 See the GNU Lesser General
## Public License for more details.
##
## A copy of version 2.1 of the GNU Lesser General Public License is
## distributed with calc under the filename COPYING-LGPL.  You should have
## received a copy with calc; if not, write to Free Software Foundation, Inc.
## 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
##
## Under source code control:	1999/09/27 20:48:44
## File existed as early as:	1999
##
## chongo <was here> /\oo/\	http://www.isthe.com/chongo/
## Share and enjoy!  :-)	http://www.isthe.com/chongo/tech/comp/calc/
