[doc] Initially add documentation

diff --git a/doc/guitarsections.tex b/doc/guitarsections.tex
new file mode 100644 (file)
index 0000000..27f0496
--- /dev/null
+++ b/doc/guitarsections.tex
@@ -0,0 +1,112 @@
+\documentclass[a4paper, 11pt]{article}
+\PassOptionsToPackage{table}{xcolor}
+\usepackage{guitarsections}
+\usepackage{parskip}
+\usepackage{array}
+\usepackage{multirow}
+\usepackage{rotating}
+\usepackage{xcolor}
+\title{Comments to {\em guitarsections}}
+\author{Gustav Eek}
+\date{2024-08-08}
+\begin{document}
+\maketitle
+
+Overview of colour schema for musical annotations in the package {\em guitarsections}:
+
+\newcommand\hlines{\noalign{\medskip}\hline\noalign{\medskip}}
+\newcommand\clines[1]{\noalign{\medskip}\cline{#1}\noalign{\medskip}}
+
+\begin{table}[htb]
+  \label{t:model}
+  \centering
+  \caption{Abstract model of a colour schema for musical annotation}\vspace{\baselineskip}
+
+  \begin{tabular}{c c c}
+    \hlines
+    \(r\) &
+    \begin{tabular}{c c c}
+      Intensity & Occurrence & Repetitivity \\
+      \(\updownarrow\) & \(\updownarrow\) & \(\updownarrow\) \\
+      Discretion & Sparcity & Uniquness
+    \end{tabular} &
+    \begin{tabular}{c} Dark \\ Bright \\ Light \end{tabular}\\\hlines
+
+    \multirow{3}{*}{\(\rho\)}
+
+    & Music: \begin{tabular}[c]{c} Tones \\ Harmonies \\ Rythm \end{tabular} &
+    \begin{tabular}{c}  Red \\ Orange \end{tabular} \\\clines{2-3}
+
+    & Structure and sectioning &
+    \begin{tabular}{c}  Yellow \\ Green \\ Turquoise \end{tabular} \\\clines{2-3}
+
+    & People and division of responsibility &
+    \begin{tabular}{c}  Blue \\ Purple \end{tabular} \\\hlines
+  \end{tabular}
+\end{table}
+
+
+The colour wheel (within {\em xcolor} base set of colors and some additions) goes as follows:
+
+\rotatebox{90}{
+  \begin{tabular}{p{4em}l}
+    \cellcolor{black} & black \\
+    \cellcolor{blackgray} & blackgray \\
+    \cellcolor{darkgray} & darkgray \\
+    \cellcolor{gray} & gray \\
+    \cellcolor{lightgray} & lightgray \\
+    \cellcolor{white} & white \\\hlines
+    \cellcolor{red} & red \\
+    \cellcolor{brown} & brown \\
+    \cellcolor{orange} & orange \\
+    \cellcolor{yellow} & yellow \\
+    \cellcolor{olive} & olive \\
+    \cellcolor{lime} & lime \\
+    \cellcolor{green} & green \\
+    \cellcolor{cyan} & cyan \\
+    \cellcolor{teal} & teal \\
+    \cellcolor{blue} & blue \\
+    \cellcolor{violet} & violet \\
+    \cellcolor{magenta} & magenta \\
+    \cellcolor{purple} & purple \\
+    \cellcolor{pink} & pink \\
+\end{tabular}}
+
+\begin{table}[htb]
+  \centering
+  \label{t:inter}
+  \caption{The concrete interpretations from Table \ref{t:model}}\vspace{\baselineskip}
+  \begin{tabular}{l l p{3em} r@{~}l}
+    \multicolumn{2}{l}{Song content}      & \cellcolor{gtr@let@black} & & black \\\hline
+    \multicolumn{2}{l}{Chord annotations} & \cellcolor{gtr@let@heavy-red} & heavy & red \\
+    \hline\multirow{11}{*}{\rotatebox{90}{Sections}}
+    & Introduction
+    & \cellcolor{gtr@let@medium-turquoise} & medium & turquoise \\
+    & Verse
+    & \cellcolor{gtr@let@soft-turquoise-green} & soft & turquoise-green \\
+    & Bridge
+    & \cellcolor{gtr@let@medium-turquoise-green} & medium &  turquoise-green \\
+    & Pre-chorus
+    & \cellcolor{gtr@let@soft-green} & soft & green \\
+    & Chorus or refrain
+    & \cellcolor{gtr@let@heavy-green} & heavy & green \\
+    & Post-chorus
+    & \cellcolor{gtr@let@medium-green} & medium & green \\
+    & Break
+    & \cellcolor{gtr@let@medium-yellow-green} & medium & yellow-green \\
+    & Instrumental solo
+    & \cellcolor{gtr@let@medium-orange} & medium & orange \\
+    & Elision
+    & \cellcolor{gtr@let@soft-orange-green} & soft & orange-green \\
+    & Ad lib or coda
+    & \cellcolor{gtr@let@soft-orange-green} & soft & orange-green \\
+    & Outro or conclusion
+    & \cellcolor{gtr@let@medium-turquoise} & medium & turquoise \\
+    \hline \multirow{2}{*}{People}
+    & Owning music        & \cellcolor{gtr@let@heavy-purple} & heavy & purple \\
+    & Owning structure    & \cellcolor{gtr@let@heavy-blue} & heavy & blue \\
+  \end{tabular}
+\end{table}
+
+
+\end{document}