diff options
author | Karl Berry <karl@freefriends.org> | 2012-05-18 00:35:36 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2012-05-18 00:35:36 +0000 |
commit | ff3def13189580da6fe5254355c8f3b8091bb0fb (patch) | |
tree | 13092e119e26dd5354f66cf3746dd0a0cbdd8cb2 /Master/texmf-dist/doc/support/pmx | |
parent | 2721345a8954f1846ff48ba10e634bc65e7b954d (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/pmx')
-rw-r--r-- | Master/texmf-dist/doc/support/pmx/ChangeLog | 205 | ||||
-rwxr-xr-x | Master/texmf-dist/doc/support/pmx/OSX/pmxab | bin | 0 -> 1540260 bytes | |||
-rwxr-xr-x | Master/texmf-dist/doc/support/pmx/OSX/scor2prt | bin | 0 -> 208560 bytes | |||
-rw-r--r-- | Master/texmf-dist/doc/support/pmx/README | 79 | ||||
-rw-r--r-- | Master/texmf-dist/doc/support/pmx/pmx-install.pdf | bin | 0 -> 96996 bytes | |||
-rw-r--r-- | Master/texmf-dist/doc/support/pmx/pmx-install.tex | 163 |
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 linebreak 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 twovoice staves. By way of background, without the new option, +rests in twovoice staves have default positions based on a simple rule +that is not contextsensitive: those in the lower voice (the one before +"//") are 4\internote below their singlevoice default positions, +and those in the upper line are 2\internote above the singlevoice +default. The new option invokes a set of contextsensitive 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 userdefined 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 singlevoice default position. + +2.506 + +Fixes a bug in AK. Simultaneous, equalduration rests will be positioned +according to the default rules. + +2.507 + +Enhancement to global option AK for vertical positioning of rests in +twovoice 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 leftshifting (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 MTx). + +2.512 + +Enable multiplicity downup "][" 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 aftergrace is immediately +followed by normal grace. Bugfix: Correct transpose register when it +has been changed in a single aftergrace. + +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 wholebar 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 2voice 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 Binary files differnew file mode 100755 index 00000000000..9e02a8807c1 --- /dev/null +++ b/Master/texmf-dist/doc/support/pmx/OSX/pmxab diff --git a/Master/texmf-dist/doc/support/pmx/OSX/scor2prt b/Master/texmf-dist/doc/support/pmx/OSX/scor2prt Binary files differnew file mode 100755 index 00000000000..7617305ed4d --- /dev/null +++ b/Master/texmf-dist/doc/support/pmx/OSX/scor2prt 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 Binary files differnew file mode 100644 index 00000000000..cf6046c331f --- /dev/null +++ b/Master/texmf-dist/doc/support/pmx/pmx-install.pdf 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} |