%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
% musixjazzdoc.tex 21 Mar 2015
%
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
\documentclass[11pt]{article}
\usepackage[dvips,colorlinks=true,linkcolor=blue]{hyperref}
\usepackage[dvips]{graphicx}
\input musixjaz
\smallchords
\font\twelvrm cmr12
\def\MusiXTeX{MusiX\TeX}
\def\bs{{\tt\char'134}}
\newcommand\PMXX{\textbf{PMX}}
\newcommand\PMX{\PMXX~}
%
% Use \bfx for program names only.  Use \bf for single embedded letters 
%
\font\bfx=cmb10 scaled\magstephalf
\font\bbfx=cmb10 scaled1800
\setcounter{secnumdepth}3
\def\Bslash{\tt\char'134}
\textheight= 9.5in \voffset-.8in%
\textwidth= 6.5in \hoffset-1.0in
\hoffset-54pt
\begin{document}

\raggedright
\parindent24pt

\title{
  \bbfx
  MusiX{\Bigfont JAZZ}: Typesetting Jazz~with~\MusiXTeX
  \null\vskip10pt
  \Large\sl
  Version 1.0 - March 2015 
  \null\vskip-5pt
  \author{\twelvrm Don \sc Simons\\
  \includegraphics[scale=0.4]{file600.eps}}}
\date{}
\maketitle

\setcounter{page}1
\pagestyle{headings}

\section{Introduction}

       This document explains in detail how to use the new package 
MusiX{\tenrm JAZZ} to create \MusiXTeX\ 
scores that look like a jazz fake book. It is assumed
here that \TeX\ and \MusiXTeX\ version 1.15 or later are already present. If not, 
\href{http://icking-music-arihive.org}
{\underline{WIMA}} 
provides instructions and links for acquiring and installing those programs. On the contrary, 
the preprocessor \PMX is not required; however, as usual it is highly recommended, and all of the 
necessary commands can easily be inserted into a \PMX source file as inline \TeX. 

It is also assumed that you are familiar with using 
\MusiXTeX\ and/or \PMX, that you are producing postscript scores, and that they will be in the standard
size \bs{\tt normalmusicsize}.

To enable jazz typesetting you will need to have emplaced within your \TeX\ system the files
{\tt musixjaz.tex, musixJAZZ.pfb, musixJAZZ.tfm, LilyJAZZText.pfb and LilyJAZZText.tfm}, and to have 
appropriately modified {\tt psfonts.map}. Details will be given elsewhere.

\section{Getting started}

The first step is to insert into the \MusiXTeX\ file for your score the statement {\tt\bs input musixjaz}, 
somewhere after {\tt\bs input musixtex}. 
This file will
replace all of the usual \MusiXTeX\ text fonts with jazz text equivalents from {\tt LilyJAZZText}, 
define macros for entering jazz chord symbols, replace clefs, accidentals, time signatures, rests, 
and some ornaments with the jazz font versions from the font {\tt musixJAZZ}, and define 
various macros whose usage is detailed in the following.

\section{Jazz chord symbols}

The basic command for entering a chord symbol is {\bs\tt jcn}, with a single argument. For example
the command {\tt\bs jcn\{Bmi\}} would produce {\jcfn Bmi}. This example also highlights the fact that 
in the jazz text font, the lower case m is a small upper case m, so minor chords must be indicated 
either by {\jcfn mi} or {\jcfn -} (minus sign). Flats, sharps, and naturals in chord symbols are given by 
\bs{\tt jfl}, \bs{\tt jsh}, and \bs{\tt jna}. The command \bs{\tt sup}, with a single argument, makes 
that argument a superscript. So e.g. \bs{\tt jcn\{B\bs jfl\bs sup7\}} generates {\jcfn B\jfl\sup7}. 
Rarely you may need a 2-level superscript; this is done with \bs{\tt dsup} with two arguments, the upper
 and lower members of the superscript. So e.g. {\tt\bs jcn\{A\bs sup7\bs dsup\{+9\}\{-5\}\}} produces
{\jcfn A\sup7\dsup{+9}{-5}}. 

The default vertical position of the chord symbol relative to the staff is controlled by 
{\tt\bs jcheight} which is initially set to -10, meaning the baseline of the chord
characters would be 10 \bs{\tt internote}s below the bottom line of the staff. But if you
want the default position to be elsewhere, say just above the top line of the staff, you 
could enter for example {\tt\bs jcheight\{9\}} near the start of your input file. To place a single 
chord symbol at a different height than the default, use {\tt\bs jc\{\#1\}\{\#2\}} where
{\tt\#1} is the height and {\tt\#2} is the coding for the chord symbol as described above.
So as you may have guessed, {\tt\bs jcn} is defined by 
{\tt\bs def\bs jcn\#1\{\bs jc\{\bs jcheight\}\{\#1\}\}}.

The default horizontal position of the start of the chord symbol is just the current input 
position, which in a \MusiXTeX\ score is normally the position of the next spacing note 
in the input file. 
The command {\tt\bs jcf} is an alternative to {\tt\bs jcn} which shifts the chord symbol
one notehead width to the left. More generally, any symbol can be shifted horizontally with 
{\bs\tt kern} used within the argument of {\tt\bs jcn}, so e.g. {\tt\bs jcn\{\bs kern5pt G\}}
would produce a {\jcfn G} shifted 5 pt to the right of the default.

It may sometimes be convenient or necessary to include several consecutive chords within the
same {\tt\bs jcn} command, e.g. if there are two successive chords on the same note. This is fine,
and the two chord symbols can be shifted as needed using {\bs\tt kern}.

There are three sizes available for chord symbols. The size can be set near the start of the 
input file by entering {\tt\bs smallchords}, {\tt\bs medchords}, or {\tt\bs bigchords}. The
default is {\tt\bs medchords}. 

\section{Arbitrary text}

{\tt\bs musixjaz.tex} redefines the standard \MusiXTeX\ font names {\tt\bs eightrm, \bs ninerm, 
\bs tenrm, \bs twelverm, \bs bigfont, \bs Bigfont,} and {\tt\bs BIgfont} to provide different 
sizes of the jazz text font {\tt LilyJAZZtext}. In a score, you can use these for example
within the second argument of {\tt\bs zcharnote} to insert any text anywhere.


\section{Ornaments and other symbols}

The following \MusiXTeX\ commands have been redefined in {\tt\bs musixjaz.tex} so that the 
associated symbol is automatically replaced with one from one of the jazz fonts, with no user
intervention required:
{\tt\bs fermataup} (upward fermata\hbox to 8pt{}{\Bigjazzchar\char85}),
{\tt\bs fermatadown} (downward fermata\hbox to 8pt{}{\Bigjazzchar\char117}),
{\tt\bs ust} (upward tenuto\hbox to 8pt{}{\Bigjazzchar\char95}),
{\tt\bs lst} (downward tenuto\hbox to 8pt{}{\Bigjazzchar\char95}),
{\tt\bs usf} (upward accent\hbox to 8pt{}{\Bigjazzchar\char62}),
{\tt\bs lsf} (downward accent\hbox to 8pt{}{\Bigjazzchar\char62}),
{\tt\bs usfz} (duncecap accent\hbox to 8pt{}{\Bigjazzchar\char94}).

The coda symbol \hbox to 8pt{}{\bigjazzchar\char222}\hbox to 8pt{}can be posted using {\tt\bs jcoda}. 
Its default vertical position and
horizontal offset are 14 and 0. To alter either of these, use {\tt\bs jcodap\{\#1\}\{\#2\}} where
the two arguments are the desired vertical position in {\tt\bs internote}s and horizontal offset
in {\tt\bs Internote}s. If you wish to include the text {\Bigfont Coda} near the symbol, you can
post it in the usual way, using e.g. {\tt\bs zcharnote\{10\}\{\bs Bigfont Coda\}\}}.

The segno symbol\hbox to 8pt{} {\bigjazzchar\char37}\hbox to 8pt{} is posted 
similarly to a coda, using {\tt\bs jsegno} or {\tt\bs jsegnop\{\#1\}\{\#2\}}.

The rehearsal letter 
\raise6.5pt\hbox{\boxfont\char36}\kern-13pt{\bigjcfn A}\hbox to 4pt{}
for example can be entered as {\tt\bs reh A}. The default vertical position and horizontal offset are
12 {\tt\bs internote}s and -15 pts. To place it at a different position, use the command
{\tt\bs rehp\{\#1\}\{\#2\}\{\#3\}} where the three arguments are the desired letter,  
vertical position in {\tt\bs internote}s, and horizontal offset in pts.







\end{document}
