From 0d37ccb0198d41ee013aca595251095a1013f2d3 Mon Sep 17 00:00:00 2001
From: Landon Curt Noll <github-mail@asthe.com>
Date: Mon, 11 Oct 1999 04:51:43 -0700
Subject: [PATCH] Release calc version 2.11.0t6.3

---
 HOWTO.INSTALL    |  3 +++
 README           | 33 +++++++++++++++++++++++++++++++++
 help/environment |  2 +-
 help/overview    |  6 +++++-
 lib/README       | 47 +++++++++++++++++++++++++++++++++++++++++------
 version.c        |  2 +-
 6 files changed, 84 insertions(+), 9 deletions(-)

diff --git a/HOWTO.INSTALL b/HOWTO.INSTALL
index b9b6b41..e9d8234 100644
--- a/HOWTO.INSTALL
+++ b/HOWTO.INSTALL
@@ -50,3 +50,6 @@ Installing calc in 4 easy steps:
     4) install calc:
 
 	make install
+
+We suggest that you might want to read the README file and look at
+the calc help subsystem.  See the README file for details.
diff --git a/README b/README
index 8f0d8ce..a008643 100644
--- a/README
+++ b/README
@@ -24,6 +24,39 @@ If you run into problems, see the BUGS file.
 
 =-=
 
+Calc is distributed with an extensive collection of help files that
+are accessible from the command line.  The following assume that you
+are running calc from the distribution directory or that you have
+installed calc.  In these examples, the ">" is the calc prompt, not
+something that you type in.
+
+For list of help topics:
+
+    > help
+
+For overview of calc overview:
+
+    > help intro
+    > help overview
+    > help command
+    > help define
+    > help statement
+    > help variable
+
+For list of builtin functions:
+
+    > help builtin
+
+C programmers should note some unexpected differences in the calc syntax:
+
+    > help unexpected
+
+Calc is shipped with a library of calc scripts.  For a list see:
+
+    > help stdlib
+
+=-=
+
 See the file:
 
     help/todo
diff --git a/help/environment b/help/environment
index d7b1fa2..696bed1 100644
--- a/help/environment
+++ b/help/environment
@@ -8,7 +8,7 @@ Environment variables
 	If this variable does not exist, a compiled value
 	is used.  Typically compiled in value is:
 
-		    .:./lib:~/lib:${LIBDIR}/calc
+		    .:./lib:~/lib:${LIBDIR}/calc:${LIBDIR}/custom
 
 	where ${LIBDIR} is usually:
 
diff --git a/help/overview b/help/overview
index e59347e..1a1ff9e 100644
--- a/help/overview
+++ b/help/overview
@@ -44,7 +44,7 @@
 
     for and overview of the help system.  The command:
 
-	    help builtins
+	    help builtin
 
     provides information on built-in mathematical functions, whereas:
 
@@ -67,6 +67,10 @@
     It contains information about differences between C and calc
     that may surprize you.
 
+    To learn about calc library files that are shipped with calc, try:
+
+	    help stdlib
+
     A full and extensive overview of calc may be obtained by:
 
 	    help full
diff --git a/lib/README b/lib/README
index 476ea23..843a0d4 100644
--- a/lib/README
+++ b/lib/README
@@ -1,10 +1,35 @@
-# Copyright (c) 1999 David I. Bell and Landon Curt Noll
-# Permission is granted to use, distribute, or modify this source,
-# provided that this copyright notice remains intact.
+To load a library, try:
 
-The following calc library files are provided because they serve as
-examples of how use the calc language, and/or because the authors thought
-them to be useful!
+    read filename
+
+You to not need to add the .cal extension to the filename.  Calc
+will search along the $CALCPATH (see ``help environment'').
+
+Normally a library will simply define some functions.  By default,
+most libraries will print out a short message when thei are read.
+For example:
+
+    > read lucas
+    lucas(h,n) defined
+    gen_u0(h,n,v1) defined
+    gen_v1(h,n) defined
+    ldebug(funct,str) defined
+
+will cause calc to load and execute the 'lucas.cal' library.
+Executing the library will cause several functions to be defined.
+Executing the lucas function
+
+    > lucas(149,60)
+	    1
+    > lucas(146,61)
+	    0
+
+shows that 149*2^60-1 is prime whereas 146*2^61-1 is not.
+
+=-=
+
+Calc library files are provided because they serve as examples of how use
+the calc language, and/or because the authors thought them to be useful!
 
 If you write something that you think is useful, please send it to:
 
@@ -63,6 +88,10 @@ something like:
 
 =-=
 
+The following is a brief description of some of the calc library files
+that are shipped with calc.  See above for example of how to read in
+and execute these files.
+
 beer.cal
 
     Calc's contribution to the 99 Bottles of Beer web page:
@@ -648,3 +677,9 @@ xx_print.cal
     error_print(a) defined
 
     Demo for the xx_print object routines.
+
+=-=
+
+# Copyright (c) 1999 David I. Bell and Landon Curt Noll
+# Permission is granted to use, distribute, or modify this source,
+# provided that this copyright notice remains intact.
diff --git a/version.c b/version.c
index 39ec2d7..8764827 100644
--- a/version.c
+++ b/version.c
@@ -12,7 +12,7 @@
 #define MAJOR_VER	2	/* major version */
 #define MINOR_VER	11	/* minor version */
 #define MAJOR_PATCH	0	/* patch level or 0 if no patch */
-#define MINOR_PATCH	"6.2"	/* test number or empty string if no patch */
+#define MINOR_PATCH	"6.3"	/* test number or empty string if no patch */
 
 /*
  * calc version constants