Calling PHCpack from C as a state machine in PHCv2.3.22

This directory was created in release 2.3 as subdirectory to CtoPHC.
The idea for using PHCpack as a state machine originated from the need
to create a parallel path tracker with MPI, first used in release 2.2,
to be used in the implementation of a parallel Pieri homotopy.
New in release 2.3 are additions to this state machine to implement
a parallel monodromy breakup algorithm.

The default extension is .ads (specification of Ada package).
In mixing C with Ada we give the extension, because sometimes we give
the same name (but different suffix) to related C and Ada routines.

------------------------------------------------------------------------------
file name                        : short description
------------------------------------------------------------------------------
assignments_in_ada_and_c         : assign data in Ada and C format
systems_container                : management of Ada polynomial systems
ts_syscon                        : tests the systems container
use_syscon                       : Ada gateway to the systems container
ts_use_syscon.c                  : C routine calls the Ada gateway use_syscon
solutions_container              : management of Ada solution lists
assignments_of_solutions         : converts between PHCpack and (b,c) format
ts_solcon                        : tests the solutions container
use_solcon                       : Ada gateway to the solutions container
ts_use_solcon.c                  : C routine calls the Ada gateway use_solcon
phcpack_operations               : PHCpack as a state machine
phcpack_operations_io            : input/output of main data of PHCpack
c_to_phcpack                     : Ada routine as gateway to the machine
ts_c2str.c                       : test on having phc write C strings
use_track                        : access to jumpstarting path trackers
------------------------------------------------------------------------------
pieri_homotopy                   : Pieri homotopies as a state machine
ts_pirhom                        : interactive test on pieri_homotopy
use_c2pieri                      : Ada routine as gateway to Pieri machine
ts_use_c2pieri                   : C test on the interactive operations
------------------------------------------------------------------------------
monodromy_permutations           : computes permutations by monodromy
sampling_operations              : provides access to the sampling machine
use_c2fac                        : Ada gateway to factorization in PHCpack
ts_use_c2fac                     : C testing operations in use_c2fac
------------------------------------------------------------------------------
cells_container                  : manages mixed-cell configurations
ts_celcon                        : tests the cells container
use_celcon                       : Ada gateway to the cells container
ts_use_celcon.c                  : C routine to test the cells container
------------------------------------------------------------------------------
ts_c2phc.c                       : C routine calls the Ada gateway to PHCpack
use_c2phc                        : bundles containers and c_to_phcpack
ts_use_c2phc.c                   : C test on the interactive operations
-----------------------------------------------------------------------------
