From the subdirectory tex of the MusiXTeX distribution copy all files to /usr/share/texmf/tex/generic/musixtex/.

From the subdirectory mf of the MusiXTeX distribution copy all files to /usr/share/texmf/fonts/source/public/musixtex/. Use the command

kpsewhich musix20.tfm

to look up the directory storing the MusiXTeX font metric files. The output will be something like /usr/share/texmf/fonts/tfm/public/musixtex/musix20.tfm. Then either delete all files from the directory /usr/share/texmf/fonts/tfm/public/musixtex/ or copy all files from the directory tfm of the MusiXTeX distribution.

If you just delete the files from /usr/share/texmf/fonts/tfm/public/musixtex/ then they will be regenerated by TeX when you start processing your MusiXTeX source files.

In order to tell TeX where to look for the MusiXTeX files update the TeX file search database by saying as root

mktexlsr

or

texhash

Below follows an excerpt from a teTeX installation texmf.cnf containing some commented out (% = comment) examples of adding "private" search directory structures for TeX . If you have root root priviliges you may edit texmf.cnf as shown below by defining the environment variable TEXMFLOCAL and setting the overall environment variable TEXMF to incorporate TEXMFLOCAL.

% The main tree, which must be mentioned in $TEXMF, below:
TEXMFMAIN = /usr/share/texmf

%   TEXMFLOCAL = /usr/share/texmf.local
TEXMFLOCAL = /usr/local/share/texmf

% If defined, teTeX's texconfig stores modifications here (instead of the
% TEXMFMAIN tree).
%   VARTEXMF = /usr/share/texmf-var

% User texmf trees can be catered for like this...
%   HOMETEXMF = $HOME/texmf

% Now, list all the texmf trees. If you have multiple trees you can
% use shell brace notation, like this:
%   TEXMF = {$HOMETEXMF,!!$TEXMFLOCAL,!!$TEXMFMAIN}
% The braces are necessary.  If you set VARTEXMF, you also have to
%   - list $VARTEXMF in the TEXMF definition;
%   - make sure that $VARTEXMF precedes $TEXMFMAIN in the TEXMF definition.
TEXMF = {!!$TEXMFLOCAL,!!$TEXMFMAIN}

When you have finished editing texmf.cnf say as root

mktexlsr

or

texhash

to update the TeX file search database to reflect the new TEXMFLOCAL directory structure.

On some unix machines the global TeX configuration file texmf.cnf may have defined an environment variable HOMETEXMF as $HOME/texmf and made it part of the environment TEXMF. In that case you'll be able to establish your own "private" TEXMF tree by creating a directory texmf in your home directory. You should also initially add the directories $HOME/texmf/tex and $HOME/texmf/fonts for storing TeX

files and METAFONT font definitions resp.

You may install all files belonging to MusiXTeX within your "local" texmf directory structure. Don't forget to make these - and other files added to $HOME/texinf - known to the TeX

file search database by saying

mktexlsr $HOME/texmf

or

texhash $HOME/texmf

If the global TeX environment HOMETEXMF has not been defined you should ask the system administrator to do so. Alternatively you may define your own TeX environment variables TEXINPUTS (search path for TeX files) and MFINPUTS (search path for METAFONT font definitions). If you're using sh as your shell interpreter add this line to your configuration file $HOME/.profile (or to $home/.bash_profile if you're using bash)

TEXINPUTS=".:$HOME/texmf/tex//"
MFINPUTS=".:$HOME/texmf/fonts//"
export TEXINPUTS MFINPUTS

If you're using csh or tcsh add this line to your configuration file $HOME/.login

setenv TEXINPUTS ".:$HOME/texmf/tex//"
setenv MFINPUTS ".:$HOME/texmf/fonts//"

The two slashes after the path names cause TeX to search all directories under $HOME/texmf.

Start by unpacking the latest version of the MusiXTeX

In your "private" TEXMF tree create a directory fonts/source/musixtex. Copy all files from the subdirectory mf of the MusiXTeX distribution to fonts/source/musixtex.

In order to tell TeX where to look for the MusiXTeX files you must update the TeX file search database of your "private" TEXMFLOCAL by saying

mktexlsr /usr/local/share/texmf

or

texhash /usr/local/share/texmf

where /usr/share/texmf must be replaced with the actual path of your "private" TEXMFLOCAL directory structure.

Processing MusiXTeX sourcefiles requires a programme musixflx that must be compiled from a c-source file musixflx.c found in the directory systems/c-source of the MusiXTeX distribution.

The compilation is done by saying

gcc musixflx.c -o musixflx

In your "private" TEXMF tree create a directory doc/musixtex. Copy all files from the subdirectory doc of the MusiXTeX distribution to doc/musixtex. The MusiXTeX manual has been compiled into the file musixdoc.dvi which you may view on screen with the programme xdvi.

In order to generate a pdf version of the manual say

pdflatex musixdoc.tex

musixflx musixdoc.tex

pdflatex musixdoc.tex

If your operating system is linux you may be able to compile pmxab and scor2prt by simply saying

make

The f2c libraries libF77.o and libI77.o referenced to in the Makefile may not necessarily be compatible with your type of unix. In that case you must compile the FORTRAN sources pmxab.f and scor2prt.f yourself "from the ground up".

You'll need to perform a few edits of both fortran sources. Locate in each source file the lines containing references to getarg. That'll be something like

        call getarg(1,jobname,idum) ! May need to replace this w/ next line
c        call getarg(1,jobname)

Do as indicated in the comment text May need to replace this w/ next line so that the lines now look like this

c        call getarg(1,jobname,idum) ! May need to replace this w/ next line
        call getarg(1,jobname)

There are two such pairs of lines in pmxab.f and one in scor2prt.f The letter c in front of the line makes the whole line a comment which doesn't become compiled.

On some unix computers it may be sufficient to compile the FORTRAN sources edited as above described with the FORTRAN compiler g77 coming with the gcc c-compiler. In fact g77 translates the FORTRAN into C, then compiles the C-source with gcc, but all this happens transparently. To use this method say

g77 pmxab.f -o pmxab

and

g77 scor2prt.f -o scor2prt

Some users have encountered problems with a g77-compiled pmxab. In that case you'll have to do the compilation in two separate steps, 1. converting the FORTRAN sources to C sources and 2. compiling the resulting C sources.

In order to generate a pdf version of the manual say

pdflatex mxlyrdoc.tex

musixflx mxlyrdoc.tex

pdflatex mxlyrdoc.tex