I'm going through and removing old and deprecated information from the source tree.
I'm noticing that there are two makefiles for OS-X, one at ./make.osx and one in release/osx/Makefile. The former was updated in Sep 2010, the latter in Mar 2010. Our installation (installing.rst) recommends using the one in release/osx.
Also, the README.txt at the root of the source tree seems to be related to the Mac OS-X binary installer. We should probably move this elsewhere and put generic information in this file.
I'm not actually trying to build on OS-X, I haven't in many years, and I haven't really followed any of the mailing list threads on this topic -- so maybe that makes me a good example of a user coming to this blind and saying: "hey, there's two ways to do it, which is the right one?"
Science Software Branch
Space Telescope Science Institute
Baltimore, Maryland, USA