README for the pfe fpaux module
--------------------------------
David N. Williams
02-Jan-2021

The fpaux module is external to the pfe distribution.

How to build fpaux-ext.c under linux and macOS
----------------------------------------------

1. The following three files contain source code for a pfe version
   0.33.71w loadable module.  Put them in a working directory.

     fpaux-ext.c
     fpaux-ext.h
     fpaux-dll.c

2. Put the current version of the appropriate one of the following two
   scripts in the working directory.

     mkmod-linux
     mkmod-macos

3. Edit the PREFIX line in the script to correspond to that in your pfe
   build configuration.  For example:

     PREFIX=$HOME   or   PREFIX=/usr/local

4. Make the script executable.  For example:

     chmod +x mkmod-linux

5. Execute the script.  For example, while in the working directory:

     ./mkmod-linux fpaux

   The script assumes an installed pfe tree.  It builds a dynamic
   library, fpaux.so, and installs it in $PREFIX/lib/pfe-forth.  It also
   puts fpaux-ext.h in $PREFIX/include.

6. To load the module, start pfe and execute "loadm fpaux".  For
   example:

     wichmann:~% pfe
     \ Portable Forth Environment 0.33.71w (Jan 14 2020 17:00:32)
     Copyright (C) Dirk Uwe Zoller  1993 - 1995.
     Copyright (C) Tektronix, Inc.  1998 - 2003.
     Copyright (C) Guido U. Draheim 2005 - 2008.
     ANS/ffa ITC Forth - Please enter LICENSE and WARRANTY. 
     Running on x86_64 darwin19.2.0 - to quit say BYE. ok 
     loadm fpaux ok