summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/octave
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2017-08-21 20:46:20 +0000
committerKarl Berry <karl@freefriends.org>2017-08-21 20:46:20 +0000
commit94a3ec7f333b2bc7b4d29565c2b4a57ae04c5180 (patch)
tree3c13d7cbdeaa60166e7e0189e242552bf7560c29 /Master/texmf-dist/doc/latex/octave
parent5deeb76a6baef361a08ab9afca70b2eb35cf6f31 (diff)
octave (21aug17)
git-svn-id: svn://tug.org/texlive/trunk@45089 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex/octave')
-rw-r--r--Master/texmf-dist/doc/latex/octave/README.md14
-rw-r--r--Master/texmf-dist/doc/latex/octave/octave.pdfbin0 -> 253260 bytes
-rw-r--r--Master/texmf-dist/doc/latex/octave/octave.tex122
3 files changed, 136 insertions, 0 deletions
diff --git a/Master/texmf-dist/doc/latex/octave/README.md b/Master/texmf-dist/doc/latex/octave/README.md
new file mode 100644
index 00000000000..533e9707fc7
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/octave/README.md
@@ -0,0 +1,14 @@
+# The `octave` Package for Typesetting Musical Pitches with Octave Designations
+
+The `octave` package typesets musical pitch names with designations for the
+octave in either the Helmholtz system (letter name with subscript numeral for
+the octave, where middle C is `C4`), or the traditional system with upper- and
+lowercase letters and prime symbols, where middle C is `c'`.
+
+Using this package, authors can just write `\pitch{C}{4}` and then by calling a
+package option (`number` or `prime`), can render all the pitch names in either
+system.
+The system can also be changed mid-document.
+
+This material is subject to the current version of the LaTeX Project Public License.
+The author and maintainer is Andrew A. Cashner, `andrewacashner@gmail.com`.
diff --git a/Master/texmf-dist/doc/latex/octave/octave.pdf b/Master/texmf-dist/doc/latex/octave/octave.pdf
new file mode 100644
index 00000000000..26c991fec7c
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/octave/octave.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/octave/octave.tex b/Master/texmf-dist/doc/latex/octave/octave.tex
new file mode 100644
index 00000000000..5d59dc2f686
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/octave/octave.tex
@@ -0,0 +1,122 @@
+\documentclass{article}
+
+\usepackage{lmodern}
+\usepackage[T1]{fontenc}
+\usepackage[utf8]{inputenc}
+\usepackage{semantic-markup}
+\usepackage{octave}
+\usepackage{fancyvrb}
+\frenchspacing
+\usepackage[
+ pdftitle={The octave Package for Typesetting Musical Pitches with Octave
+ Designations},
+ pdfauthor={Andrew A. Cashner},
+ pdfsubject={LaTeX package},
+ pdfkeywords={LaTeX, music, musicology, humanities}
+]{hyperref}
+
+\title{The \code{octave} Package for Typesetting Musical Pitches with Octave
+Designations}
+\author{Andrew A. Cashner\thanks{%
+ \href{mailto:andrewacashner@gmail.com}
+ {\nolinkurl{andrewacashner@gmail.com}}%
+ }%
+}
+
+\begin{document}
+\maketitle
+
+There are two standard ways of indicating the octave of a musical pitch:
+\begin{enumerate}
+ \item The Helmholtz system, which uses subscript numerals after the pitch
+ letter name, where \soCalled{middle C} is \pitch{C}{4}
+ \item {\octaveprimes
+ The traditional system, which uses upper- and lowercase letters followed
+ by prime (tick) marks, where \soCalled{middle C} is \pitch{C}{4} and
+ an octave higher is \pitch{C}{5}.}
+\end{enumerate}
+
+This package allows you to typeset pitch names conveniently using either method
+(or even switching between) without worrying about typography, with a simple,
+semantically meaningful interface.
+Authors can write their documents without worrying about which system of
+nomenclature their editor or press will prefer.
+Simply changing the option with which the package is called will change the
+display of all the pitches in the document that have been written with this
+package's commands.
+
+\tableofcontents
+
+\section{Package Options}
+
+\begin{center}
+ \begin{tabular}{ll}
+ \code{number} & (Default) Use Helmholtz numbers \\
+ \code{prime} & Use the traditional system with prime/tick marks \\
+ \end{tabular}
+\end{center}
+
+To use octave numbers, just add \verb|\usepackage{octave}| to your preamble.
+To use the traditional system, write \verb|\usepackage[prime]{octave}| instead.
+
+
+
+\section{Switching Systems within One Document}
+
+At any time, you can change from one system to the other.
+
+\begin{center}
+\begin{tabular}{ll}
+ \verb|\octaveprimes|
+ & Switch to the traditional system (prime/tick marks) \\
+ \verb|\octavenumbers|
+ & Switch to the Helmholtz system (numbers) \\
+\end{tabular}
+\end{center}
+
+\section{Style}
+
+The default setup (stored in the command \verb|\pitchfont|) is for pitch letters
+and numbers in the Helmholtz system to be in the normal font, while pitch
+letters and prime marks are in italic. You can change this, for example:
+
+\verb|\renewcommand{\pitchfont}{\mdseries}|.
+
+\section{Entering Pitch Names}
+
+To enter a pitch name, use the \verb|\pitch| command.
+It takes three arguments:
+\begin{enumerate}
+ \item (Mandatory) Letter name of the pitch: Can be upper- or lowercase; the
+ package will adjust the case as necessary
+ \item (Optional, in square brackets) Accidental command, e.g., \verb|$\sharp$| or \verb|\sh|
+ from the \code{semantic-markup} package
+ \item (Mandatory) Number of the pitch in the Helmholtz system
+\end{enumerate}
+
+Yes, the package requires you to use the numbered system, even if you want the
+output to be in the traditional system.
+Thus middle C is \verb|\pitch{C}{4}|, and an octave and a semitone above that is
+\verb|\pitch{C}[\sh]{5}| (using the \code{semantic-markup} package for the
+accidental).
+
+
+\section{Table of Octave Designations in the Two Systems}
+
+The package also provides the \verb|\octavetable| which displays a comparison
+of the two systems, shown in table~\ref{octavetable}.
+
+\begin{table}
+ \caption{Pitch designations in traditional (\code{prime}) and Helmholts
+ (\code{number}) systems}
+ \label{octavetable}
+ \begin{center}
+ \octavetable
+ \end{center}
+\end{table}
+
+\section{Code}
+
+\VerbatimInput{octave.sty}
+
+\end{document}