jdsteve2

(this PR was replaced; closing for now; see comments above)

@inducer This is ready for review. My initial priority is finding any bugs/functional problems that would affect correctness and downstream PRs. Second priorities are code style, time complexity, etc. Thank...

@inducer I made the changes we discussed yesterday (returning a named tuple)