musicography (28may19)

git-svn-id: svn://tug.org/texlive/trunk@51251 c570f23f-e606-0410-a88d-b1316a301751

1 files changed, 96 insertions, 14 deletions

diff --git a/Master/texmf-dist/doc/latex/musicography/musicography.tex b/Master/texmf-dist/doc/latex/musicography/musicography.tex
index 54f26e0ca10..2b7981c188d 100644
--- a/Master/texmf-dist/doc/latex/musicography/musicography.tex
+++ b/Master/texmf-dist/doc/latex/musicography/musicography.tex
@@ -27,7 +27,7 @@
     {\nolinkurl{andrewacashner@gmail.com}}%
     }%
 }
-\date{May 21, 2018}
+\date{May 28, 2019}
 
 \begin{document}
 \maketitle
@@ -39,7 +39,8 @@ The \code{lilyglyphs} package uses Lilypond's fonts, but requires
 This package makes available the most commonly used symbols in writing about
 music in a way that can be used with \code{pdflatex} and looks consistent and
 attractive.
-It includes accidentals, meters, and notes of different rhythmic values.
+It includes accidentals, meters, notes of different rhythmic values, and
+automatic formatting of figured bass.
 
 This package builds on the approach used in the \code{harmony} package, where
 the symbols are taken from the MusiXTeX fonts.
@@ -58,6 +59,9 @@ the other package.
 The \code{bigger} option provides larger font sizes that match better with
 certain fonts.
 
+The package now (2019) provides full support for figured-bass notation using the
+\verb|\musFig| command.
+
 The \verb|\musNumFont| command allows you to change the font of the numerals
 used.
 For example, if using the \code{ebgaramond} font package, it looks better if you
@@ -66,6 +70,7 @@ do this:
     \verb|\renewcommand{\musNumFont}[1]{\liningnums{#1}}|.
 \end{quote}
 
+
 \section{Symbols and Commands}
 
 \subsection{Accidentals}
@@ -92,6 +97,8 @@ there are also aliases for older note names.
     Eighth note (corchea) & \verb|\musEighth| or \verb|\musCorchea| &
     \musEighth\\
     Sixteenth note & \verb|\musSixteenth| & \musSixteenth\\
+    Thirty-second note & \verb|\musThirtySecond| & \musThirtySecond\\
+    Sixty-fourth note & \verb|\musSixtyFourth| & \musSixtyFourth\\
 \end{codetable}
 
 A dot may be added to any of the above by adding \code{Dotted} to the end of the
@@ -100,6 +107,8 @@ command. For example:
 \begin{codetable}
     Dotted whole note & \verb|\musWholeDotted| & \musWholeDotted\\
     Dotted quarter note & \verb|\musQuarterDotted| & \musQuarterDotted\\
+    Dotted thirty-second note & \verb|\musThirtySecondDotted| &
+    \musThirtySecondDotted\\
 \end{codetable}
 
 \subsection{Meter Signatures}
@@ -111,12 +120,66 @@ command. For example:
     Ternary with $3:2$ proportion & \verb|\meterCThreeTwo| &
     \meterCThreeTwo\\
     Spanish 17th-cent. ternary & \verb|\meterCZ| & \meterCZ\\
+    Medieval \term{tempus perfectum} & \verb|\meterO| & \meterO\\
 \end{codetable}
 
-For other time signatures, use \verb|\musMeter{}{}|. 
-The command \verb|\musFigures| is an alias for \verb|\musMeter| that can be used
-for notating figured bass. 
-Both commands take two arguments and stack the arguments vertically.
+For other time signatures, use \verb|\musMeter{}{}|; the two arguments are the
+numerator and denominator of the fraction, respectively.
+
+\subsection{Figured Bass}
+
+For figured-bass notation, use \verb|\musFig{}|.
+The command, as of May 2019 now re-implemented using the \code{stackengine}
+package, takes a single argument which may contain as many space-separated
+elements as you like. 
+(The \verb|\musFig| command is implemented with \verb|\musStack{}|, which is
+also used to for \verb|\musMeter|.)
+
+The elements in the argument will be stacked vertically and left-aligned.
+Multiple figures in a row should be enclosed in brackets if there are spaces
+between them.
+
+To align figures when there are empty slots, as in \musFig{6--5
+\noFig[5--]\musSharp}, use \verb|\noFig[]|. 
+It will insert horizontal space the
+same width as its optional argument when typeset; the default value is the
+width of the numeral 5.
+It does this using \verb|\hphantom|, so you should supply the same text in the
+argument as the figure with which you want to align. 
+The code for the example at the beginning of this paragraph was 
+\verb|\musFig{6--5 \noFig[5--]\musSharp}|.
+
+The font may be controlled by redefining \verb|\musFigFont{}|.
+Its default value is as follows:
+\begin{Verbatim}
+\NewDocumentCommand{\musFigFont}{}{%
+    \scriptsize
+    \let\musFontLarge\musFontBig
+}
+\end{Verbatim}
+This reduces the size of numbers and the music font so that they fit better with
+surrounding text and so that numerals and accidentals in the figures match.
+
+
+
+{\renewcommand{\arraystretch}{2.5}
+\small
+\begin{codetable}
+    Two figures & \verb|\musFig{7 5\musSharp}| 
+    & \musFig{7 5\musSharp}\\
+    Three figures & \verb|\musFig{7\musFlat{} 5 3}| 
+    & \musFig{7\musFlat{} 5 3}\\
+    Four figures & \verb|\musFig{7 5 4 2}| &
+    \musFig{9 7 5 3}\\
+    Voice leading & \verb|\musFig{7--6 5--4 3}| 
+    & \musFig{7--6 5--4 3}\\
+    Voice leading & \verb|\musFig{6--7 4--5 \noFig[2--]3}| 
+    & \musFig{7--6 5--4 \noFig[2--]3}\\
+    Multiple figures per row 
+    & \verb|\musFig{{6\musFlat{} 5} {\noFig[6\musFlat] \musSharp}}|
+    & \musFig{{6\musFlat{} 5} {\noFig[6\musFlat] \musSharp}}\\
+\end{codetable}}
+
 
 \subsection{Customization}
 
@@ -129,14 +192,33 @@ See \verb|\musSymbol| and \verb|\musAccidental| in the code listing below.
 
 \section{Changes}
 
-\begin{tabular}{r p{0.75\textwidth}}
-    2018/05/21 & Override semantic-markup's \verb|\fl|, \verb|\sh|, \verb|\na|
-    commands if it is loaded \\
-    2017/10/31 & Corrected glyph used for \verb|\musHalf| and documented
-    \verb|\musMeter| and \verb|\musFigures|\\
-    2017/08/29 & First version on CTAN\\
-    2017/04/12 & Created\\
-\end{tabular}
+\begin{itemize}
+    \item[2019/05/28] Bux fixes and new features, especially figured bass
+        \begin{itemize}
+            \item Fix issue 1 on Bitbucket, thanks to Christian Mondrup
+                \begin{itemize}
+                    \item Correct mistaken notehead symbol for values less than
+                        quarter note (was hollow, now filled)
+                    \item Add 32nd and 64th notes, regular and dotted varieties
+                    \item \verb|\musSymbol| is now typeset inside an
+                        \verb|\mbox| to fix alignment problems when used in
+                        tables
+                \end{itemize}
+            \item New features (some requested in issue no. 1):
+                \begin{itemize}
+                    \item Add medieval perfect meter
+                    \item Add aliases for \term{fusa} ($=$ corchea $=$ eighth note)
+                    \item Replace musStack implementation with \code{stackengine}
+                    \item Add full figured-bass support
+                \end{itemize}
+        \end{itemize}
+    \item[2018/05/21] Override semantic-markup's \verb|\fl|, \verb|\sh|,
+        \verb|\na| commands if it is loaded
+    \item[2017/10/31] Corrected glyph used for \verb|\musHalf| and documented
+        \verb|\musMeter| and \verb|\musFigures|
+    \item[2017/08/29] First version on CTAN
+    \item[2017/04/12] Created
+\end{itemize}
 
 \section{Code}