This is musixtex-for-unix.txt, produced by makeinfo version 4.1 from musixtex-for-unix.texi. 1 Updating existing _MusiXTeX_ software **************************************** Start by unpacking the latest version of the _MusiXTeX_ distribution, for example into a temporary directory, for example `/usr/local/src'. To perform the unpacking say `tar -zxf musixtex-T112.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 . *Note unpacking tar archives: unpack-tar. 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 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_ . *Note Updating existing Update-Musixtex. 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'. 2.2.1 A "private" `TEXMF' tree for all users -------------------------------------------- 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. 2.2.2 A "private" `TEXMF' tree for single users ----------------------------------------------- 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'. 2.3 _MusiXTeX_ macros ====================== Start by unpacking the latest version of the _MusiXTeX_ distribution, for example `musixtex-T112.tar.gz' into a temporary directory. *Note unpacking tar archives: unpack-tar. 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 . 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 Setting up a local `PATH' environment ========================================= If you're doing a single user _MusiXTeX_ installation you'll need to install executable files belonging to _MusiXTeX_ so that your shell interpreter may look them up in the program search path `PATH'. If it does not already exists then create a directory `bin' in your home directory for storing executable files. Check whether the `PATH' environment includes this directory by saying `echo $PATH' If the output contains something like `:/home/christian/bin:/usr/local/bin:' then your shell interpreter will first look for executable files in your own `bin' directory. If `/home/christian/bin' doesn't show up you'll need to add `$HOME/bin' to the `PATH' environment. 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') PATH="$PATH:$HOME/bin" export PATH If you're using `csh' or `tcsh' add this line to your configuration file `$HOME/.login' setenv PATH "$PATH:$HOME/bin" 2.8 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' or `$HOME/bin'. *Note Setting up a local `PATH' environment: Local-Path. 2.9 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. *Note type-1. 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 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 into a temporary directory, for example `/usr/local/src/pmx2412' and unpack it. `unzip -axL pmx2412.zip' 3.1.1 Compiling the _FORTRAN_ source files ------------------------------------------ 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.1.1.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.1.1.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. *Note unpacking rpm packages: unpack-rpm. Otherwise you'll have to install _f2c_ from the source distribution which you may download from 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.1.2 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'. If you're doing a single user installation you should copy `pmxab' and `scor2prt' to `$HOME/bin'. *Note Setting up a local `PATH' environment: Local-Path. 3.2 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. *Note Setting up `TEXMFLOCAL': 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.3 The _PMX_ manual ==================== Pdf versions of the _PMX_ manual and reference card are available as and . 4 Installing _M-Tx_ ******************* 4.1 Compiling the `prepmx' source ================================= Download the _M-Tx_ source distribution into a temporary directory, for example `/usr/local/src' and unpack it. The result is a directory `mtx054b'. *Note unpacking tar archives: unpack-tar. 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. If you're doing a single user installation you should set the install directory to `$HOME/bin'. *Note Setting up a local `PATH' environment: Local-Path. 4.2 The _M-Tx_ manual ===================== A pdf version of the _M-Tx_ manual is available as 4.3 Installing the _M-Tx_ _MusiXTeX_ macros ============================================ If you have created a "private" `TEXMFLOCAL' directory structure then copy the file `mtx.tex' from the _M-Tx_ source distribution to the directory where you store the _MusiXTeX_ macros. *Note Setting up `TEXMFLOCAL': texmflocal. Otherwise copy `mtx.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' 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 to that directory and unpack it. *Note unpacking tar archives: unpack-tar. 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. *Note Setting up `TEXMFLOCAL': 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. *Note type-1. 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' _2003-08-24_, Christian Mondrup Werner Icking Music Archive  Tag Table: Ref: Update-Musixtex177 Ref: unpack-tar340 Ref: type-12209 Ref: unpack-rpm3123 Ref: texmflocal3570 Ref: Local-Path9284  End Tag Table