summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/support
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2012-05-18 00:35:36 +0000
committerKarl Berry <karl@freefriends.org>2012-05-18 00:35:36 +0000
commitff3def13189580da6fe5254355c8f3b8091bb0fb (patch)
tree13092e119e26dd5354f66cf3746dd0a0cbdd8cb2 /Master/texmf-dist/doc/support
parent2721345a8954f1846ff48ba10e634bc65e7b954d (diff)
pmx 2.6.18 (16may12)
git-svn-id: svn://tug.org/texlive/trunk@26478 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/support')
-rw-r--r--Master/texmf-dist/doc/support/pmx/ChangeLog205
-rwxr-xr-xMaster/texmf-dist/doc/support/pmx/OSX/pmxabbin0 -> 1540260 bytes
-rwxr-xr-xMaster/texmf-dist/doc/support/pmx/OSX/scor2prtbin0 -> 208560 bytes
-rw-r--r--Master/texmf-dist/doc/support/pmx/README79
-rw-r--r--Master/texmf-dist/doc/support/pmx/pmx-install.pdfbin0 -> 96996 bytes
-rw-r--r--Master/texmf-dist/doc/support/pmx/pmx-install.tex163
6 files changed, 447 insertions, 0 deletions
diff --git a/Master/texmf-dist/doc/support/pmx/ChangeLog b/Master/texmf-dist/doc/support/pmx/ChangeLog
new file mode 100644
index 00000000000..e4e72d6c87d
--- /dev/null
+++ b/Master/texmf-dist/doc/support/pmx/ChangeLog
@@ -0,0 +1,205 @@
+Changes from PMX 2.5 to 2.603, 15 April 2011
+
+2.501 (Note: new scor2prt)
+
+Bugfix: initialize index in PMX subroutine putorn to eliminate subscript
+error detected in some compilers Bugfix in scor2prt: Ignore special
+treatment of special symbols if they appear between double quotes.
+Tweak: move end of first part of line­break ties slightly to the right.
+
+2.502 (Note: new pmx.tex)
+
+The height of a figured bass vertical stack can now be adjusted upward by
+an integral number of \internote by appending "+" and the number. Recall
+that it can already be moved downward 4\internote by prepending "_"
+(underscore). The two options can be combined to provide full control
+over the vertical position. Ties can now be represented with braces
+"{" before a note and "}" after. Both are equivalent to "t" after the
+note. (Thanks to Dirk Laurie). In pmx.tex all the commands of the form
+\font\...=\fontid sy1000 have been changed to \font\...=cmsy10 (Thanks
+to Olivier Vogel).
+
+2.503
+
+Enable arpeggio left shift with ?­[x] Allow musicsize of 24 and 29.
+Bugfix: Fix bug introduced in 2.415 which caused error in printing
+replacement number in xtup.
+
+2.504
+
+Gap between normal grace and main note: X[x] as option to the G command,
+where x is the gap size in notehead widths. Bugfix: og (segno) now
+works OK when nv .ne. noinst.
+
+2.505
+
+A new global option AK activates special rules for vertical positioning of
+rests in two­voice staves. By way of background, without the new option,
+rests in two­voice staves have default positions based on a simple rule
+that is not context­sensitive: those in the lower voice (the one before
+"//") are 4\internote below their single­voice default positions,
+and those in the upper line are 2\internote above the single­voice
+default. The new option invokes a set of context­sensitive rules to
+set the default position. The baseline rule is to align the rest in
+a horizontal line with the next following note in the same bar. If
+there is no following note in the bar, then it is aligned with the next
+prior note. If there are simulataneous rests in both voices, the old
+rule is applied. When the AK option is in force, it only affects places
+where there are two voices in a staff. It may be toggled on and off at
+the beginning of any input block, using just AK. When the option is in
+effect, any user­defined tweaks on the height of a rest will supersede
+the option for that particular rest, i.e., the tweak will be applied
+relative to the single­voice default position.
+
+2.506
+
+Fixes a bug in AK. Simultaneous, equal­duration rests will be positioned
+according to the default rules.
+
+2.507
+
+Enhancement to global option AK for vertical positioning of rests in
+two­voice staves (see version 2.505): The option L ("look left") in a rest
+will cause the vertical position of that rest to be based on the preceding
+note, rather than the following one as is the default when AK has been
+issued Partial bugfix: In unbeamed xtuplets, the length of the bracket
+and position of the number are now adjusted to account for any inserted
+hardspaces. Bugfix: unbeamed xtups with two flags are now allowed.
+
+2.508
+
+Allow grace notes in xtuplets.
+
+2.509
+
+Correct small bug in arpeggio left­shifting (it got confused when there
+was more than one voice on a staff).
+
+2.510
+
+Bugfix: Correct omission of character variable declarations in new
+subroutine getgrace introduced in 2.508.
+
+2.511 (Note: new scor2prt named s2p2511.exe)
+
+Bugfix: Correct error in horizontal spacing introduced in 2.507.
+Experiment: Remove prohibition against tempo changes in MIDI macros.
+Bugfix in scor2prt: Make it work right when "R" command occurs at end
+of input block and "/" is on next line (as produced by M­Tx).
+
+2.512
+
+Enable multiplicity down­up "][" within xtuplet
+
+2.513
+
+Bugfix: If there is more than one rest at start of a beamed xtuplet marked
+as a forced beam, beam height and slope tweaks are now properly handled.
+Bugfix: If an xtuplet with multiplicity 2 or 3 starts with a rest, the
+rest is now printed correctly. Bugfix: Unbeamed xtuplets (with option
+'a' on first note) with multiplicity 2 or 3 are now printed correctly.
+
+2.514
+
+Bugfix: Correct horizontal spacing when after­grace is immediately
+followed by normal grace. Bugfix: Correct transpose register when it
+has been changed in a single after­grace.
+
+2.515
+
+Bugfix: Correct error in automatic forced beams. Before the fix, if the
+beam did not start an integral number of beam durations from the start
+of the bar, incorrect results would occur. Bugfix: Properly center
+fermata over centered whole­bar rest.
+
+2.516 (Note: new pmx.tex)
+
+Allow figures in voice #2.
+
+2.517
+
+Allow figures in two voices, voice 1 and any other one.
+
+2.518
+
+Bug fixes in 2­voice figures.
+
+2.519
+
+Fix bug that prevented \sk from being output, misaligning some voices.
+
+2.520
+
+New feature: special characters 2+, 4+, 5+, 6+, 9+ for figured bass. In
+the PMX string for any figure, follow the number by 's'. This uses the
+font cmrj from the new package figbas. You must install this font in
+your TeX setup for this to work.
+
+2.521
+
+Bugfix: Font definition syntax corrected so no extra space is introduced.
+
+2.602 (Note: new pmx.tex; requires eTeX)
+
+Allow 24 voices, beams, slurs. Require etex. Include comment about
+doubling size of internal buffer to 131072, requiring gfortran for
+Windows to compile. Correct slur indexing in linebreakslurs. Account for
+comment lines in line count for error messages
+
+2.603 (Note: new scor2prt)
+
+In getpmxmod.for, decrease nline by 2 to fix locating errors following
+reading in an include file. Add some error messages in g1etset.for
+setup data
+
+2.610
+
+Instrument-wise transposition: Ki[instrument #][+/-][trans
+amt.][+/-][new key]. For more than one instrument, may immediately
+repeat everything after "K". Must either be at start of score (right
+after setup), or if later, must be preceded by normal (full score) key
+change command K+0[+/-][new key]. Must be used with relative accidentals
+("Ar"). Part(s) to be transposed must be entered in concert key, and
+will appear transposed in the score. MIDI behavior not yet tested.
+Has not yet been integrated into scor2prt, so for now if you want to
+make parts, only use Ki... as score-only (on line after "%%") and/or
+instrument only (on same line after %[Instrument #]).
+
+2.613
+
+Set error trap if "D" is entered before any notes.
+
+Enhance "AS" to allow spacing adjustments tailored for either smallsize
+or tinysize. As before, "AS" must be followed by nv characters, but now
+they may be "0" for normal, "-" or "s" for small, or "t" for tiny. Still
+must set sizes of instruments with inline TeX.
+
+Bugfix: Fixed broken "K-..." in 2.610.
+
+2.614
+
+Bugfix: revise raised dotted rests by separately raising rest and dot.
+
+2.615 *(Note: new scor2prt)*
+
+Command "AS", described above under 2.163, now also causes staff sizes
+to change (in score only, not parts), so inline TeX is no longer needed
+to change sizes of selected staves.
+
+Scor2prt transfers partwise transposition commands Ki... (see 2.610
+above) into parts.
+
+2.616
+
+"Feature" added: Hairpin dynamics now may span input blocks.
+
+2.617
+
+Repaired several obscure bugs related to platform and compiler
+dependencies; see pmxab.f for details.
+
+2.618
+
+For letter and a4 paper respectively, commands "Acl" and "Ac4" set
+horizontal and vertical sizes and offsets that center the page with no
+further adjustments required in dvips.
diff --git a/Master/texmf-dist/doc/support/pmx/OSX/pmxab b/Master/texmf-dist/doc/support/pmx/OSX/pmxab
new file mode 100755
index 00000000000..9e02a8807c1
--- /dev/null
+++ b/Master/texmf-dist/doc/support/pmx/OSX/pmxab
Binary files differ
diff --git a/Master/texmf-dist/doc/support/pmx/OSX/scor2prt b/Master/texmf-dist/doc/support/pmx/OSX/scor2prt
new file mode 100755
index 00000000000..7617305ed4d
--- /dev/null
+++ b/Master/texmf-dist/doc/support/pmx/OSX/scor2prt
Binary files differ
diff --git a/Master/texmf-dist/doc/support/pmx/README b/Master/texmf-dist/doc/support/pmx/README
new file mode 100644
index 00000000000..69a4f36f641
--- /dev/null
+++ b/Master/texmf-dist/doc/support/pmx/README
@@ -0,0 +1,79 @@
+This is PMX, version 2.6.18 (May 15th, 2012). PMX provides a preprocessor for MusiXTeX.
+
+pmxab builds a TeX input file based on a .pmx input file in a much
+simpler language, making most of the layout decisions by itself. It has
+most of MusiXTeX's functionality, but it also permits in-line TeX to
+give access to virtually all of MusiXTeX. For proof-listening, pmxab will
+make a MIDI file of your score.
+
+scor2prt is an auxiliary program that makes parts from a score.
+
+pmx2pdf is a wrapper script that runs pmxab, all 3 passes of MusiXTeX,
+and subsequent conversions to PDF.
+
+The author of pmxab and scor2prt is Don Simons (dsimons@roadrunner.com).
+The author of the pmxccn tutorial is Cornelius C. Noack.
+
+This package consists of
+
+ (i) pmx-texmf.zip, which contains macros, documentation, and the
+ pmx2pdf.lua script
+
+ (ii) pmx-2.6.18.tar.gz, which contains the source code for
+ pmxab and scor2prt
+
+(iii) directories Windows and OSX, which contain pre-compiled
+ pmxab and scor2prt executables for those platforms
+
+ (iv) pmx-install.{tex,pdf}, which is a more detailed version of the
+ following instructions:
+
+To install (on TDS-compliant TeX systems):
+
+ + unzip pmx-texmf.zip at the root of a texmf tree and, if necessary,
+ update the filename database; e.g., texhash texmf. Documentation for
+ PMX is installed under doc/generic/pmx.
+
+ + on Windows or OS-X: copy the pre-compiled executables appropriate for your
+ platform to a folder on the executable PATH
+
+ + on any Unix-like system with gcc and standard development tools installed:
+ unpack the pmx tarball (anywhere), move to the resulting pmx-2.6.18 directory
+ and do
+
+ ./configure
+ make
+ make install (as root)
+
+ + on Windows: copy the file scripts\pmx\Windows\pmx2pdf.bat to a folder on the
+ executable PATH
+
+ + on any Unix-like system: install a symbolic link pmx2pdf in any
+ directory on the executable PATH to scripts/pmx/pmx2pdf.lua
+
+In this release of PMX, the original Fortran sources for pmxab and
+scor2prt have been included but the C files actually used have been
+obtained from these by the f2c translator. The source files for libf2c,
+which is needed at link time, are also included.
+
+Documentation for PMX is installed under
+
+doc/generic/pmx
+
+Many examples of PMX and MusiXTeX typesetting may be found at the Werner
+Icking Music Archive at
+
+http://icking-music-archive.org/
+
+Support for users of MusiXTeX and related software may be obtained via
+the MusiXTeX mail list at
+
+http://tug.org/mailman/listinfo/tex-music
+
+PMX may be freely copied, duplicated and used in conformance to the GNU
+General Public License (see included file COPYING). The libf2c source
+files are governed by a Notice that allows copying, modification and
+distribution.
+
+This CTAN distribution is maintained by Bob Tennent (rdt@cs.queensu.ca).
+May 15th, 2012.
diff --git a/Master/texmf-dist/doc/support/pmx/pmx-install.pdf b/Master/texmf-dist/doc/support/pmx/pmx-install.pdf
new file mode 100644
index 00000000000..cf6046c331f
--- /dev/null
+++ b/Master/texmf-dist/doc/support/pmx/pmx-install.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/support/pmx/pmx-install.tex b/Master/texmf-dist/doc/support/pmx/pmx-install.tex
new file mode 100644
index 00000000000..67b27d82905
--- /dev/null
+++ b/Master/texmf-dist/doc/support/pmx/pmx-install.tex
@@ -0,0 +1,163 @@
+\documentclass[11pt]{article}
+\usepackage[textwidth=6.5in,textheight=8.5in]{geometry}
+\usepackage[osf]{mathpazo}
+\PassOptionsToPackage{urlcolor=black,colorlinks}{hyperref}
+\RequirePackage{hyperref}
+\usepackage{xcolor}
+\newcommand{\myurl}[1]{\textcolor{blue}{\underline{\textcolor{black}{\url{#1}}}}}
+\newcommand{\pmxVersion}{2.6.18}
+\begin{document}
+\title{Installation of the CTAN PMX Distribution}
+\author{Bob Tennent\\
+\small\url{rdt@cs.queensu.ca}}
+\date{\today}
+\maketitle
+\thispagestyle{empty}
+
+\section{Introduction}
+We assume that you have already installed a MusiXTeX distribution.
+Before trying to install PMX from CTAN, check whether your TeX distribution
+provides a package for PMX; this will be easier than doing it yourself.
+But if your TeX distribution
+doesn't have PMX (or doesn't have the most recent version), this distribution
+of PMX is very easy to install, though
+you may need to read the material on
+installation of (La)TeX files in the
+TeX FAQ\footnote{%
+\myurl{http://www.tex.ac.uk/cgi-bin/texfaq2html}},
+particularly
+the pages on
+which tree to use\footnote{%
+\myurl{http://www.tex.ac.uk/cgi-bin/texfaq2html?label=what-TDS}}
+and installing files\footnote{%
+\myurl{http://www.tex.ac.uk/cgi-bin/texfaq2html?label=inst-wlcf}}.
+
+\section{Installing \texttt{pmx-texmf.zip}}
+
+In this distribution of PMX, most of the files to be installed
+(including macros, documentation, and a processing script) are in
+\texttt{pmx-texmf.zip}, a zipped TEXMF
+hierarchy. Simply unzip this archive in the root folder/directory of whichever TEXMF tree
+you decide is most appropriate, likely a ``local'' or ``personal'' one.
+This should work with any TDS\footnote{%
+\myurl{http://www.tex.ac.uk/cgi-bin/texfaq2html?label=tds}}
+compliant TeX distribution, including MikTeX, TeXlive and teTeX.
+
+After unzipping the archive, update the filename database as necessary,
+for example, by executing \verb\texhash ~/texmf\ or
+clicking the button labelled ``Refresh FNDB" in the MikTeX settings program.
+
+Documentation for PMX is installed under \verb\doc/generic/pmx\
+in the TEXMF tree.
+
+\section{Installing \texttt{pmxab} and \texttt{scor2prt}}
+
+The next step in the installation is to install
+the two essential files that can't be installed in a TEXMF tree: the \texttt{pmxab} preprocessor
+and \texttt{scor2prt}, an executable used to produce single-player parts from multi-player scores.
+
+\subsection{Pre-Compiled Executables}
+
+On Windows
+systems, one can install \texttt{pmxab.exe} and
+\texttt{scor2prt.exe} in the \texttt{Windows} sub-directory; these are pre-compiled
+executables and should be copied to any
+folder on the PATH of executables.
+This might entail creating a suitable folder and adding that folder
+to the PATH as follows:
+in ``My Computer''
+click on
+\begin{center}
+View System Information\quad$\rightarrow$\quad Advanced\quad$\rightarrow$\quad Environment Variables
+\end{center}
+scroll
+down to ``path'', select it, click edit, and add the path to \verb|...\scripts\musixtex\Windows| after a semi-colon.
+
+
+On the MAC OS-X platform (version 10.2 or better), one can install \texttt{pmxab} and \texttt{scor2prt} that are in the
+\texttt{OSX} sub-directory.
+
+\subsection{Compilation from Source}
+
+If you have conventional GNU development tools (\texttt{tar}, \texttt{gunzip}, \texttt{make})
+and \texttt{gcc}\footnote{%
+\myurl{http://gcc.gnu.org/gcc/}}
+on your platform,
+you should be able to build \texttt{pmxab} and \texttt{scor2prt} executables.
+
+To build \texttt{pmxab} and \texttt{scor2prt} for your platform:
+\begin{enumerate}
+\item Unpack the \texttt{pmx-\pmxVersion.tar.gz} archive:
+\begin{list}{}{}
+\item \texttt{tar zxvf pmx-\pmxVersion.tar.gz}
+\end{list}
+and move to the resulting \texttt{pmx-\pmxVersion} directory.
+\item Configure:
+\begin{list}{}{}
+\item \verb\./configure\
+\end{list}
+or, if you want the executables to be installed in your own path,
+\begin{list}{}{}
+\item \verb\./configure --prefix=$HOME\
+\end{list}
+\item Install:
+\begin{list}{}{}
+\item \verb\make install\
+\end{list}
+as root (admin) to install to the system path, or just
+\begin{list}{}{}
+\item \verb\make install\
+\end{list}
+to install in your own path.
+\end{enumerate}
+You should now have executables \verb\pmxab\ and
+\verb\scor2prt\ available for use.
+
+\section{The Processing Script}
+
+The Lua script \verb\.../scripts/pmx/pmx2pdf.lua\
+is simply a convenient wrapper that
+by default runs the following processes in order (and then deletes intermediate files):
+\begin{itemize}\topsep=0pt\itemsep=0pt
+\item \verb\pmxab\ (pre-processing pass)
+\item \verb\etex\ (1st pass)
+\item \verb\musixflx\ (2nd pass)
+\item \verb\etex\ (3rd pass)
+\item \verb\dvips\ (to convert \verb\dvi\ output to Postscript)
+\item \verb\ps2pdf\ (to convert \verb\ps\ output to Portable Document Format)
+\end{itemize}%
+There are many options to vary the default behaviour.
+
+On a Unix-like system (with \texttt{luatex} installed), put a
+symbolic link \texttt{pmx2pdf} in any directory on the executable PATH as follows:
+\begin{list}{}{}
+\item \verb\ln -s <path to pmx2pdf.lua> pmx2pdf \
+\end{list}
+On Windows, you can \emph{either}
+copy the batch file
+\begin{list}{}{}
+\item \verb|...\scripts\pmx\Windows\pmx2pdf.bat|
+\end{list}
+to a folder
+on the executable PATH \emph{or} add the folder
+\verb|...\scripts\pmx\Windows| to the executable PATH as explained above.
+
+Documentation for \verb\pmx2pdf\ is in the
+\verb\doc/generic/pmx/scripts\ directory.
+
+
+\section{Discussion}
+
+
+
+Other pre-processor packages, additional documentation, additional
+add-on packages, and many examples of PMX and MusiXTeX typesetting may be found
+at the Werner Icking Music Archive\footnote{%
+\myurl{http://icking-music-archive.org}}.
+Support for users of MusiXTeX and related software may be obtained via
+the MusiXTeX mail list\footnote{%
+\myurl{http://tug.org/mailman/listinfo/tex-music}}.
+PMX may be freely copied, duplicated and used in conformance to the
+GNU General Public License (Version 2, 1991, see included file \verb\gpl.txt\).
+
+\end{document}