Changeset 9c12dd0 for doc/theses/mike_brooks_MMath/background.tex

Timestamp:

Apr 27, 2026, 7:17:34 PM (30 hours ago)

Author:

Michael Brooks <mlbrooks@…>

Branches:

master

Children:

f1ffc47

Parents:

602cec4

Message:

Apply document-level formatting and rearrange the array-in-struct discussion.

Formatting:

• add visual separation of figures from text
• prevent "formula"-style code fragments from page breaking
• (thereby prevent code formula broken at end of page from mistakenly restarting the reader in a code figure at the top of the next page)
• give short+long figure captions
• assure descriptive captions
• remove Title-Like Captialization in Captions
• turn a couple figures into tables where the figure visual separator looks bad

Array-in-struct

• remove lingering use of "accordion"
• call it Dynamic Array Member
• oranize discussion as, first explain example, then argue feature is good

File:

• doc/theses/mike_brooks_MMath/background.tex (modified) (8 diffs)

doc/theses/mike_brooks_MMath/background.tex

@@ -491 +491 @@
 \end{cfa}
 \end{tabular}
-\caption{Pre-VLA Fixed \vs Variable Contiguous Matrix Styles}
+\caption{Pre-VLA contiguous matrix styles, fixed \vs variable}
 \label{f:FixedVariable}
 \end{figure}
@@ -580 +580 @@
 \end{cfa}
 \end{tabular}
-\caption{C99 Contiguous \vs Non-contiguous Matrix Styles}
+\caption{C99 matrix styles, contiguous \vs non-contiguous }
 \label{f:ContiguousNon-contiguous}
 \end{figure}
@@ -672 +672 @@
 \end{cfa}
 \end{tabular}
-\caption{Multiple ways to declare an array parameter.
+\caption[Multiple ways to declare an array parameter]{
+Multiple ways to declare an array parameter.
 Across a valid row, every declaration is equivalent.
 Each column gives a declaration style, where the style for that column is read from the first row.
@@ -955 +956 @@
 \subfloat[Wrapped value]{\label{f:WrappedValue}\usebox\myboxC}
 
-\caption{
-                Three styles of link attachment:
+\caption[Three styles of link attachment]{
+                Three styles of link attachment.
                 % \protect\subref*{f:Intrusive}~intrusive, \protect\subref*{f:WrappedRef}~wrapped reference, and \protect\subref*{f:WrappedValue}~wrapped value.
                 The diagrams show the memory layouts that result after the code runs, eliding the head object \lstinline{reqs};
@@ -1012 +1013 @@
         \lstinput[language=C++]{100-117}{lst-issues-attach-reduction.hpp}
         \lstinput[language=C++]{150-150}{lst-issues-attach-reduction.hpp}
-        \caption{
+        \caption[Simulation of wrapped using intrusive]{
                 Simulation of wrapped using intrusive.
                 Illustrated by pseudocode implementation of an STL-compatible API fragment using LQ as the underlying implementation.
@@ -1048 +1049 @@
                 \hspace*{1.5in}\includegraphics[page=2]{lst-issues-direct.pdf}
         }
-        \caption{
+        \caption[Example of simultaneity using LQ lists]{
                 Example of simultaneity using LQ lists.
                 The zoomed-out diagram (right/top) shows the complete multi-linked data structure.
@@ -1214 +1215 @@
         \centering
         \includegraphics[width=\textwidth]{lst-issues-ident.pdf}
-        \caption{
+        \caption[Comparison of headed and ad-hoc list identities]{
                 Comparison of headed and ad-hoc list identities, for various list lengths.
                 Pointers are logical, meaning that no claim is intended about which part of an object is being targeted.
@@ -1256 +1257 @@
         \centering
         \includegraphics[width=0.55\textwidth]{lst-issues-end.pdf}
-        \caption{
-                LQ sub-object-level representation of links and ends.
+        \caption[LQ field-level representation of links and ends]{
+                LQ field-level representation of links and ends.
                 Each object's memory is pictured as a vertical strip.
                 The location, within a strip, at which an arrow points, is significant.