0README

This directory has sources for the following programs:

/src
|-- areacode
|-- chgdate
|-- dugraph
|-- hexcalc
|-- hoc6
|-- misc1
|-- misc2
|-- note
|-- nrchbar
|-- react
|-- recipes
|-- simplex
|-- sunrise
`-- xtoys


AREACODE

areacode
|-- 0README                     this file
|-- areacode                    script
|-- areacode-posting
|-- areacode.1
`-- guide-areacodes

The areacode script matches one or more patterns of 3-digit areacodes,
states or provinces, or major cities, against an areacode database.
The last update was January, 2004



CDECLIST

cdeclist
|-- 0NOTE                       obvious
|-- 0README                     this file
|-- LLtest-ad.c                 test output
|-- LLtest-bs.c                 test output
|-- LLtest-ll.c                 test output
|-- adheader.h                  for testing
|-- cdeclist.1                  man page
|-- cdeclist1.l                 lex source
|-- cdeclist2.l                 lex source
|-- cdeclist3.l                 lex source
|-- cdeclist4.l                 lex source
|-- identlist.l                 lex source
|-- identlist1.l                lex source
|-- lex.yy.c                    [lex intermediate file]
|-- makefilea                   makefile
|-- mk_cdeclistA                script to make .....
|-- mk_identlist                script to make .....
|-- mk_identlist_inv            script to make .....
|-- test-ad.c                   for testing
|-- test-bs.c                   for testing
|-- test-ll.c                   for testing
`-- uncomment.l                 lex source


The files cdeclist?.l are lex sources for helping convert old C code (K&R)
to ansi std.

Uncomment.l -> uncomment is a prog useful on its own, for stripping comments
from a C source.



CHGDATE

chgdate
|-- 0NOTE                       obvious
|-- 0README                     this file
|-- Makefile                    makefile
|-- chgdate.1                   man page
|-- chgdate.c                   source file
|-- getdate.3                   man page
|-- getdate.c                   source file
|-- getlex.l                    source file
|-- getmisc.c                   source file
|-- getyacc.h                   source file
|-- getyacc.y                   source file
|-- jul_greg.c                  source file
`-- jul_greg.h                  source file


The getdate(3) function parses its arguments according to a
grammar and returns a date string in a selected format. 

Chgdate(1) is a wrapper for getdate(3) that prints the date string
returned for the command-line arguments.



DUGRAPH

dugraph
|-- 0NOTE                       obvious
|-- 0README                     this file
|-- dugraph.1                   man page
`-- dugraph.c                   source file


Dugraph gives a 60-line display of a directory hierarchy.  It filters
the output of du.  The listing allocates vertical space according
to the size of a directory; small directories are lumped into "etc";
subdirectories shown similarly.



HEXCALC

hexcalc
|-- 0NOTE                       obvious
|-- 0README                     this file
|-- Makefile                    makefile
|-- Makefile.log                log output of make
|-- bltins.c                    source file
|-- hctest01.txt                input for test
|-- hctest02.txt                input for test 
|-- hexcalc.1                   man page 
|-- hexcalc.h                   source file
|-- hexcalc.y                   source file
|-- init.c                      source file
|-- symbol.c                    source file
|-- ulpow.c                     source file
|-- ytab.h                      source file
`-- yylex.c                     source file


Hexcalc is a simple calculator for interconversion between octal,
hex, and decimal bases, and for carrying out standard C operations:



HOC 

hoc 
|-- 0NOTE                       obvious
|-- 0README                     this file
|-- hoc.jar                     directory - source of [some] sources
|-- hoc.uunet                   directory - source of [some] sources
|-- Makefile                    makefile
|-- hoc.1                       man page
|-- hoc.1.cat                   man page 
|-- hoc.1.man                   man page
|-- hoc.doc                     documentation
|-- hoc.ms                      documentation
|-- hoc.ms.ps                   documentation
|-- code.c                      source file
|-- hoc.h                       source file
|-- hoc.y                       source file
|-- init.c                      source file
|-- math.c                      source file
|-- symbol.c                    source file
|-- demo.ack                    test file
|-- demo.depth                  test file
|-- demo.fib                    test file
`-- test.hoc                    test file


Hoc was written by Kernighan and Pike, in the early days of C and
Unix.  It is a primer for use of yacc (now bison) and a grammar.
Given progs such as R (nee S), hoc is no longer useful (it never
was widely used, AFAIK).  But as a tutorial, and as part of C-Unix
history, hoc lives.



KINETICS

kinetics
|-- DISTRIBUTION                1991 code from Mike Whitbeck
|-- Docs                        docs from '91 distribution + posts + web + email
|-- Examples                    various applications of react or lsoda
|   |-- biphasic                        [not ported to macosx]
|   |-- cht                             [not revised for this dir structure]
|   |-- fd 
|   |-- run.examples
|   |-- run.lactamase
|   |-- run.models
|   |-- run.rate
|   `-- run.template
|-- reaction                    react: heavy mods of 1991 react distrib.
|                               ported to macosx
`-- reaction.sgi                as above, for irix


"React", posted on CCL (Computational Chemistry List) by Mike
Whitbeck in 1991, is a reaction simulator.  Given a reaction model,
reaction rate constants, and initial reactant concentrations, "react"
calculates a time series giving the course of the reaction (reactant
concentrations at a set of time points).  The usefulness of react,
is that the reaction model is input as a set of chemical reactions,
written in the usual fashion.  The model input is parsed by the
program, to generate appropriate input for a differential equation
solver.

React uses the lsoda integrator:



MISC.C

misc.C
|-- 0NOTE                       obvious
|-- 0README                     this file
|-- Makefile                    makefile
|-- ll.1                        man page
|-- ll.c                        source file
|-- pad.1                       man page
|-- pad.c                       source file
|-- tac.1                       man page
|-- tac.c                       source file
|-- whereis.1                   man page
`-- whereis.c                   source file


Four old utilities:

	pad - pad lines to given length
	tac - concatenate and print files in reverse
	ll - line length
	whereis - locate source, binary, and or manual for program



NOTE 

note 
|-- 0NOTE                       obvious
|-- 0README                     this file
|-- Makefile                    makefile
|-- note.1                      man page
|-- note.c                      source file
`-- note.sha                    shell script [not tested with macsox]


"Chgdate" wraps a Lex and yacc-based analyzer and parser that calculates
a date offset from an input date by some number of days, weeks, months,
or years.  "Chgdate" also determines the number-th weekday in a month,
calculates differences between dates, and interconverts between Julian
and Gregorian dates.  Input format is pretty flexible.

"Note" attachs a date to a each line of input, and then _pre_-pends the
text to a file selected by command-line option.  "Note" makes it a bit
easier to file information properly.  Useful for adding to a calendar
file, or recording notes in a "memo" file.  Files are backed up before
each modification.  They are kept in $HOME/memos (except $HOME for
calendar).  Date specification is simple; e.g., the third monday in the
next month, for a dated calendar entry, is:

        note -c now +1 month 3 monday


	"Note" uses the "chgdate" parser to calculate the date from
	command-line
	arguments.  The date format is recognized by the UNIX "calendar"
	program.


RECIPES

recipes
|-- Distribution			alt.gourmand ~1988 distribution
|   |-- Cookbook			  PS file of all recipes
|   |-- Programs			  progs: format recipes, etc
|   `-- Recipes				  recipes in alt.gourmand style
|-- Programs				jar mods of alt.gourmand software
`-- Recipes				jar recipes in alt.gourmand style

alt.gourmand ~1988 distribution of recipes (~500) and programs

selected alt.gourmand programs, ported to macosx, with modifications by jar
	format recipes written in alt.gourmand style = tmac.recipe macros

recipes by jar (~100), in alt.gourmand style

[see 0README or *NOTE files in subdirectories for more information]



SIMPLEX

simplex
|-- 0NOTE                       local pedigrees of these files
|-- 0README                     this file
|-- Lib
|-- Lib                         C sources (1994):
|   |                                   S module for simplex fit
|   |                                   standalone program for simplex fit
|   `-- Lib-1992                C sources (1992): as above
|-- Nelder-Mead-paper           images of Nelder-Mead (1965) classic paper
`-- Simplex                     C sources (1991): standalone program
    |-- Doc
    |-- Ldh
    |-- Lib
    |-- Line
    |-- MANIFEST
    |-- Makefile 
    |-- README 
    |-- biphasic
    |-- distribution
    |-- lexa
    `-- mmfit


This code applies the Nelder-Mead simplex algorithm to the problem
of fitting a model to data.

It has not been compiled under Mac OSX [although it should with few
mods].

The Nelder-Mead simplex algorithm is robust, capable of handling
somewhat pathogenic functions.  It is a directed search of parameter
space.



SUNRISE

sunrise
|-- 0NOTE                       obvious
|-- 0README                     this file 
|-- Makefile                    makefile
|-- nethead                     info from posting = source of sources
|-- rise_set.c                  source file
`-- sunrise.6                   man page


A useful utility, especially if you hike/climb and want to know sunset/moon
phase for estimating hours available. 



XTOYS

xtoys
|-- 0NOTE                       obvious
|-- 0README                     this file 
|-- Xtoys.html                  web page -- feb 2001
|-- Distribution-15-Mar-2002    directory -- distribution for these sources
|-- Xtoys-old                   directory -- old distribution, 1994
|-- xtoys-patterns              directory -- patterns for xautomalab (and ?)
|-- Makefile                    makefile
|-- readme.txt                  distribution readme file (Mike Creutz)
|-- xtoys.1                     man page (sketchy) for all xtoys
|-- demo_lattice                tutorial: xburn, xising, xautomalab, xsand
|-- schrodinger.c               source file for ....
|-- xautomalab.c                soure file for ....
|-- xautomalab.txt              documentation for ....
|-- xburn-jar.c                 source file for ....
|-- xburn-jar.txt               documentation for ....
|-- xburn-seq.txt               file referenced in demo_lattice
|-- xburn.c                     source file for ....
|-- xburn.txt                   documentation for ....
|-- xfires.c                    source file for ....
|-- xfires.txt                  documentation for ....
|-- xising.c                    source file for ....
|-- xising.txt                  documentation for ....
|-- xpotts.c                    source file for ....
|-- xpotts.txt                  documentation for ....
|-- xsand.c                     source file for ....
|-- xsand.txt                   documentation for ....
|-- xwaves.c                    source file for ....
`-- xwaves.txt                  documentation for ....


This directory has a version (fairly recent) of the xtoys distribution
created by Mike Creutz at BNL.  It focusses mostly on lattice physics, i.e.,
the illustration of critical behavior and phase transitions.



ZAP

zap
|-- 0NOTE                       obvious
|-- 0README                     this file 
|-- Makefile                    makefile
|-- efopen.c                    source file
|-- make.out                    log of make output (warnings, etc.)
|-- pick.1                      man page
|-- pick.c                      source file
|-- strindex.c                  source file
|-- ttyin.c                     source file
|-- zap.1                       man page
`-- zap.c                       source file


Zap remains useful -- a quick way to kill a misbehaving program.

Old code from Kernighan and Pike -- zap is one of several
examples/utilities/subroutines.

