From 40513ea7a30fb961e930cac7388c4fb9d4c0f222 Mon Sep 17 00:00:00 2001
From: Gustav Eek <gustav.eek@fripost.org>
Date: Wed, 21 Aug 2024 20:17:39 +0200
Subject: [PATCH] [doc] Adopt introductory text for compilation

---
 doc/guitarsections.tex | 70 +++++++++++++++++++++++-------------------
 1 file changed, 38 insertions(+), 32 deletions(-)

diff --git a/doc/guitarsections.tex b/doc/guitarsections.tex
index 27f0496..82d748a 100644
--- a/doc/guitarsections.tex
+++ b/doc/guitarsections.tex
@@ -1,7 +1,9 @@
-\documentclass[a4paper, 11pt]{article}
+\documentclass[a4paper, 11pt]{ltxdoc}
+\usepackage{a4wide}
+\usepackage{parskip}
+\usepackage{creatdtx}
 \PassOptionsToPackage{table}{xcolor}
 \usepackage{guitarsections}
-\usepackage{parskip}
 \usepackage{array}
 \usepackage{multirow}
 \usepackage{rotating}
@@ -12,16 +14,14 @@
 \begin{document}
 \maketitle
 
-Overview of colour schema for musical annotations in the package {\em guitarsections}:
+Figure \ref{t:model} provides an 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]
+\begin{figure}[htb]
   \label{t:model}
   \centering
-  \caption{Abstract model of a colour schema for musical annotation}\vspace{\baselineskip}
-
   \begin{tabular}{c c c}
     \hlines
     \(r\) &
@@ -43,39 +43,45 @@ Overview of colour schema for musical annotations in the package {\em guitarsect
     & People and division of responsibility &
     \begin{tabular}{c}  Blue \\ Purple \end{tabular} \\\hlines
   \end{tabular}
-\end{table}
+  \caption{Abstract model of a colour schema for musical annotation}
+\end{figure}
 
 
-The colour wheel (within {\em xcolor} base set of colors and some additions) goes as follows:
+The colour wheel (within {\em xcolor} base set of colors and some additions) goes as described in Table \ref{t:xcolors}.
 
-\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}[htbp]
+  \label{t:xcolors}
+  \centering
+  \caption{Reference for the {\em xcolor} colour names}
+  \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}}
+\end{table}
 
 \begin{table}[htb]
   \centering
   \label{t:inter}
-  \caption{The concrete interpretations from Table \ref{t:model}}\vspace{\baselineskip}
+  \caption{The concrete interpretations from Figure \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 \\
-- 
2.39.2