This is the file /usr/local/teTeX/share/texmf.macosx/README.macosx. A symbolic
link to this file is maintained in /usr/local/teTeX

The following setup has been created. There are three directories for texmf
trees to be kept. The official tree is at it's default location
/usr/local/teTeX/share/texmf. teTeX can handle multiple trees. A file found in
one overrides one found in the other. The order of search is set in
environment variables which are set in a file called texmf.cnf. Luckily, there
is also the possibility to have a local texmf.cnf as
/usr/local/teTeX/texmf.cnf, this possibility is compiled into the TeX
programs.

So here is what I have chosen to do:
1. Keep the original texmf tree as default as possible, so that you may
upgrade it from a new teTeX release without destroying local modifications.
2. Make a second tree where Mac OS X specific settings are stored (e.g. use of
type1 fonts) as well as additional packages that are not in teTeX
3. Have a third tree where local modifications are stored.

Since I want to be able to create an installer package from my own setup, 2
and 3 should not reside inside the teTeX hierarchy. I have chosen for the
following solution:

1. /usr/local/teTeX/share/texmf is the default teTeX texmf tree, this is
maintained by the TeX community. 

2. /usr/local/teTeX/share/texmf.macosx is the Mac OS X tree, this is
maintained and distributed by me. TeX finds this tree as
/usr/local/teTeX/share/texmf.os which is a symbolic link.

3. /usr/local/teTeX/share/texmf.local is the local texmf tree, this is
maintained by the local TeX administrator. It is also the VARTEXMF tree that
is handled in a special way by texconfig, e.g. formats and changes are stored
here.

The above trees are only searched through the tex hash.

4. In this Mac OS X distribution, user trees in ~/Library/texmf are active
as well but they do not use a hash for lookup.

To conform to teTeX standards the directories outside the teTeX hierarchy are
linked symbolically to the right places inside the teTeX hierarchy.

PLEASE read also the file README.howtexfindsfiles before asking me why files
are not found by TeX.
