Table of Contents * 1 Updating existing MusiXTeX software o 1.1 MusiXTeX macros o 1.2 MusiXTeX bitmapped fonts o 1.3 MusiXTeX type 1 fonts o 1.4 Updating the TeX search path * 2 Installing new MusiXTeX software o 2.1 Installing from rpm distribution o 2.2 Setting up a "private" TEXMF tree o 2.3 MusiXTeX macros o 2.4 MusiXTeX bitmapped fonts o 2.5 MusiXTeX type 1 fonts o 2.6 Updating the TeX search path o 2.7 The MusiXTeX program musixflx o 2.8 The MusiXTeX manual * 3 Installing PMX o 3.1 Installing from rpm distribution o 3.2 Compiling the pmxab- and scor2prt sources + 3.2.1 Compiling using Makefile + 3.2.2 Compiling the FORTRAN source files + 3.2.2.1 Compiling with g77 + 3.2.2.2 Compiling with f2c + 3.2.3 Installing pmxab and scor2prt o 3.3 Installing the PMX MusiXTeX macros o 3.4 The PMX manual * 4 Installing M-Tx o 4.1 Compiling the prepmx source o 4.2 The M-Tx manual * 5 musixlyr o 5.1 Installing the musixlyr macros o 5.2 The musixlyr manual 1 Updating existing MusiXTeX software Start by unpacking the latest version of the MusiXTeX distribution, for example musixtex-T103.tar.gz into a temporary directory, for example /usr/local/src. To perform the unpacking say tar -zxf musixtex-T103.tar.gz The result will be a new directory /usr/local/src/musixtex-T103. You'll need to know the locations of the MusiXTeX macros and METAFONT font sources. Use the command kpsewhich musixtex.tex to look up the directory storing the MusiXTeX macros. The output will be something like /usr/share/texmf/tex/generic/musixtex/musixtex.tex. Use the command kpsewhich musix20.mf to look up the directory storing the MusiXTeX METAFONT fonts sources. The output will be something like /usr/share/texmf/fonts/source/public/musixtex/musix20.mf In the following text replace /usr/share/texmf/tex/generic/musixtex/ and /usr/share/texmf/fonts/source/public/musixtex/ with the actual pathes of musixtex.tex and musix20.mf resp. 1.1 MusiXTeX macros From the subdirectory tex of the MusiXTeX distribution copy all files to /usr/share/texmf/tex/generic/musixtex/. 1.2 MusiXTeX bitmapped fonts 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. 1.3 MusiXTeX type 1 fonts You should consider also installing Takanori Uchiyama's type 1 versions of the MusiXTeX fonts which allow you to generate high quality pdf output from your MusiXTeX sources. Begin by downloading and unpacking the font distribution musixps-unix.tar.gz . See unpacking tar archives. Then follow the instructions in the section "3. INSTALLATION" of the accompanying file README 1.4 Updating the TeX search path 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 2 Installing new MusiXTeX software 2.1 Installing from rpm distribution For some types of linux there is an rpm distribution of MusiXTeX , release T101 available. Download the file musixtex-T101-1.i386.rpm into a temporary directory, for example /usr/local/src and say as root rpm -i musixtex-T101-1.i386.rpm You may later want to update macros and fonts to the latest version of MusiXTeX . See Updating existing MusiXTeX software. 2.2 Setting up a "private" TEXMF tree TeX macros and fonts coming with MusiXTeX are additions to the standard TeX distribution. In order to keep the MusiXTeX stuff independent of TeX you may want to create a directory structure separate from that of the base TeX installation. If for example TeX has been installed within the directory structure /usr/share/texmf then you could create a "private" structure /usr/local/share/texmf for storing all TeX macros and fonts belonging to MusiXTeX . However, you must tell TeX where to search for files in /usr/share/texmf. This is done in the configuration file texmf.cnf the location of which you may look up by saying kpsewhich texmf.cnf the output of which will be something like /usr/share/texmf/web2c/texmf.cnf. Below follows an excerpt from a teTeX installation texmf.cnf containing some commented out (% = comment) examples of adding "private" search directory structures for TeX . Edit texmf.cnf as shown below by defining the environment variable TEXMFLOCAL and setting the overall environment variable TEXMF to incorporate TEXMFLOCAL. % 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. 2.3 MusiXTeX macros Start by unpacking the latest version of the MusiXTeX distribution, for example musixtex-T103.tar.gz into a temporary directory. See unpacking tar archives. In your "private" TEXMF tree create a directory tex/musixtex. Copy all files from the subdirectory tex of the MusiXTeX distribution to tex/musixtex. 2.4 MusiXTeX bitmapped fonts 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. 2.5 MusiXTeX type 1 fonts You should consider also installing Takanori Uchiyama's type 1 versions of the MusiXTeX fonts which allow you to generate high quality pdf output from your MusiXTeX sources. In order to do so download and unpack the fonts distribution musixps-unix.tar.gz . In your "private" TEXMF tree create a directory fonts/type1/musixtex. Then follow the instructions from point 3 of section "3. INSTALLATION" of the accompanying file README. 2.6 Updating the TeX search path 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. 2.7 The MusiXTeX program musixflx 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 The resulting binary executable file musixflx must be copied to a directory listed in your environment PATH, for example /usr/local/bin. 2.8 The MusiXTeX manual 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 To get a reasonable result out of using the command pdflatex type 1 fonts must be installed. See MusiXTeX type 1 fonts. If you have only bitmapped fonts installed you should use the command latex instead. The result will be a postscript document. You may also generate a postscript manual from the file musixdoc.dvi by saying dvips musixdoc.dvi -o musixdoc.ps 3 Installing PMX 3.1 Installing from rpm distribution For some types of linux there is an rpm distribution of PMX, version 2.20 available. Download the file pmx-2.20-1.i586.rpm into a temporary directory, for example /usr/local/src and say as root rpm -i pmx-2.20-1.i586.rpm There is also an rpm distribution of PMX, beta release 2.305, pmx-2.3.0.5-1.i386.rpm 3.2 Compiling the pmxab- and scor2prt sources If you can't install from an rpm distribution or if you want a PMX release with no rpm package available download a PMX source distribution, for example pmx-unix-230.tgz into a temporary directory, for example /usr/local/src and unpack it. The result is a directory pmx-230. See unpacking tar archives. 3.2.1 Compiling using Makefile If your operating system is linux you may be able to compile pmxab and scor2prt by simply saying make 3.2.2 Compiling the FORTRAN source files 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. 3.2.2.1 Compiling with g77 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 3.2.2.2 Compiling with f2c 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 do this you must make sure that the utility to convert FORTRAN sources to C sources, f2c is installed on your computer. For some types of linux there are rpm distributions of f2c available. See unpacking rpm packages. Otherwise you'll have to install f2c from the source distribution which you may download from ftp://netlib.bell-labs.com/netlib/f2c To perform the FORTRAN-to-C conversion say f2c pmxab.f -Nx400 -Nn802 and then gcc pmxab.c -lf2c -lm -o pmxab Perform the same two steps with scor2prt.f. 3.2.3 Installing pmxab and scor2prt The resulting binary executable files pmxab and scor2prt must be copied to a directory listed in your environment PATH, for example /usr/local/bin. 3.3 Installing the PMX MusiXTeX macros If you have created a "private" TEXMFLOCAL directory structure then copy the file pmx.tex from the PMX source distribution to the directory where you store the MusiXTeX macros. See Setting up TEXMFLOCAL. Otherwise copy pmx.tex to any directory within the TEXMF directory structure, for example /usr/share/texmf/tex/generic/musixtex/. Don't forget to update the TeX file search database by saying as root mktexlsr or texhash 3.4 The PMX manual Pdf versions of the PMX manual and reference card are available as pmx230.pdf and ref230.pdf . 4 Installing M-Tx 4.1 Compiling the prepmx source Download the M-Tx source distribution mtx052-unix.tar.gz into a temporary directory, for example /usr/local/src and unpack it. The result is a directory mtx052-unix. See unpacking tar archives. Compile the C-source files by saying make and - as root make install You may want to edit the upper line of Makefile to change the default target install directory /usr/local/bin to meet your needs. 4.2 The M-Tx manual A pdf version of the M-Tx manual is available as mtxdoc.pdf 5 musixlyr Processing MusiXTeX -, PMX- and M-Tx source files involving lyrics requires the musixlyr macros to be installed. In a temporary directory, for example /usr/local/src create a directory Musixlyr. Download the distribution archive musixlyr20.tgz to that directory and unpack it. See unpacking tar archives. 5.1 Installing the musixlyr macros If you have created a "private" TEXMFLOCAL directory structure then copy the file musixlyr.tex from the musixlyr distribution to the directory where you store the MusiXTeX macros. See Setting up TEXMFLOCAL. Otherwise copy musixlyr.tex to any directory within the TEXMF directory structure, for example /usr/share/texmf/tex/generic/musixtex/. 5.2 The musixlyr manual In order to generate a pdf version of the manual say pdflatex mxlyrdoc.tex musixflx mxlyrdoc.tex pdflatex mxlyrdoc.tex To get a reasonable result out of using the command pdflatex type 1 fonts must be installed. See MusiXTeX type 1 fonts. If you have only bitmapped fonts installed you should use the command latex instead. The result will be a postscript document. You may also generate a postscript manual from the file mxlyrdoc.dvi by saying dvips mxlyrdoc.dvi -o mxlyrdoc.ps ------------------------------------------------------------------------ 2001-10-24, Christian Mondrup, Werner Icking Music Archive