This is the README file for MusiXTeX example music scores, excerpt from
the MusiXTeX T.73 User's Manual (pp. 96-97) on Sunday, July 13, 1997
by Anthony Fok <foka@debian.org> for Debian GNU/Linux.

There is a Makefile written by Andreas Tille <tille@debian.org> which
tries to make its best to compile the examples.

To try out the examples, mkdir a new directory and copy the files
and gunzip them there.  For example, to compile the music scores for
Ave Maria, run the command:
  
    musixtex avemaria.tex
  
or, if that doesn't work, try the following instead:
  
    tex avemaria.tex
    musixflx avemaria
    tex avemaria.tex

If you like to print the samples on Letter size paper, try adjusting
the parameters in the *.tex files.  Enjoy!  ^_^

----------------------------------------------------------------------------

Chapter 4
Examples

Due to compatibility problems with LaTeX (used to produce this notice) large
examples must be TeX-ed separately, i.e. using plain TeX and not LaTeX.
Therefore, the MusiXTeX future user is suggested to produce some of the
following examples and to look carefully at the way some special features
have been coded.

     When producing this examples, care should be taken about the fact that
several given files are supposed to be included (by means of \input) in
other files. Thus the only good files to be directly TeX-ed are those which
begin with "\input musixtex" or "% \input musixtex". This latter command is
often commented out so that the examples can be run either using a MusiXTeX
format including musixcpt.tex and musixsty.tex -- namely the format
generated by musixtex.ins -- or using a MusicTeX format including
musictrp.tex, musicvbm.tex and musicsty.tex -- namely the format generated
by musixtex.ins.

     In addition, it must be noted that most DVI previewers and laser
printers have their origin at one inch below and one inch right of the right
upper corner of the paper, while the musical examples have their upper left
significant corner only at one centimeter right and below the left top of
the paper. Therefore, special parameters have to be given to the DVI
transcription programs unless special \hoffset and \voffset TeX commands are
introduced within the source TeX text.


4.1  Clean MusiXTeX examples
~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 * "avemaria.tex" to get the "M馘itation" (alias "Ave Maria")
   by Charles Gounod for organ and violin or song in clean MusiXTeX-input.

 * "traeumer.tex" to get the famous "Tr舫merei" by Robert Schumann for piano,
   in genuine MusiXTeX-input but with some additions to perform ascending
   crescendos.

 * "parnasum.tex" to get the first page of "Doctor gradus ad Parnassum"
   by Claude Debussy for piano.

 * "glorias.tex" to get a local melody for the French version of
   "Gloria in excelsis Deo", showing use of lyrics commands.
   "gloriab.tex" is the same, with organ accompaniment.

 * Other clean MusiXTeX examples seem to be no more compatible with the
   present version, but they should be updated in a near future.

     These examples are packed (zipped) in the musixexa.zip file of the
MusiXTeX distribution.  [Note: They are included as gzipped files
in the /usr/doc/musixtex/examples directory on your computer. -- AF]


4.2  Nearly compatible MusicTeX examples
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
These are examples using not only musixtex but also musixcpt and musixsty,
which means their coding is easily understandable for MusicTeX previous
users. However, they cannot be run as is with MusicTeX, since a few specific
commands have been included, either for spacing, or for oblique slurs. They
are given in musixexa.zip, for example:

 * gymnoman: an imitation of Erik Satie's Gymnop馘ies

 * canticor.tex/canticox.tex: a famous tune by Georg Friedrich Haendel

 * ilfaitda.tex/ilfaitdx.tex: a famous choral by J.S. Bach adapted with
   French lyrics for French churches,

 * widor_20.tex: the famous toccata for organ by Charles-Marie Widor
   in 10 pages (more compact than commercial editions, and easier to play
   if nobody can turn the pages), and widor_16.tex which is the same in
   16pt size, i.e. more compact.

 * souveni*.tex: a nice French tune of the fifties, by Oreste Rossi
   and Fernand Capitani with several transpositions.

 * marcello.tex: the adagio of Benedetto Marcello's oboe concerto,
   transcribed for organ.

 * hymnepas.tex: a modern Eastern canticle by A. Gouzes and Palestrina,
   showing heavy use of \hardlyrics for choral music.


4.3  Compatible MusicTeX examples
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
They are all the examples provided in the MusicTeX distribution. To run them
the easiest way is to have both a musictex and a musixtex format as
described in \ref{formatbuild. Otherwise, insert

   \input musixtex
   \input musixcpt
   \input musixsty

at the beginning of each example, and TeX it.


4.4  Looking at examples before installing MusiXTeX
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Most of the above examples (and some others) are posted, ready to print, as
PostScript files in:

 * ftp://hprib.lps.u-psud.fr/pub/music_scores.zip/*/*/*.zip
   (zipped PostScript 300dpi files)
 * ftp://hprib.lps.u-psud.fr/pub/music_scores.gz/*/*/*.ps.gz
   (gzipped PostScript 300dpi files)

Printing them on any PostScript printer (needs A4 paper) is a good means of
getting an overview of MusiXTeX's capabilities.