Restore the ability to build the thesis, and commit the corrected build - #41
Merged
Conversation
Neither Thesis/ nor ThesisPublished/ held the master document, so the thesis
could not be rebuilt from either -- the README recorded that and nobody drew the
consequence: 104 .tex files across two trees had no automated check of any kind,
which is how a malformed nested subscript and an unbalanced parenthesis have sat
in Thesis/ unnoticed.
Thesis/thesis.tex is that master, reconstructed. Builds clean: 0 errors, 0
undefined references, 0 undefined citations, 271 pages. And it works as a gate --
deleting one \end{align*} fails loudly with "Paragraph ended before \align* was
complete".
Thesis/thesis.pdf is what it builds, and it is a different document from the
published PDF at the repository root. It is the corrected thesis, so it is the
only place the errata are visible rendered rather than as source. Verified
directly: the post-C4 Degree-3 doubling row "74 3 89 19" is present and the
superseded "73 3 101 19" is absent, so E-T10 really is in there.
HOW MUCH OF THIS IS INFERRED, because the answer is "the preamble, all of it".
The include order is exact, read off the committed thesis.aux of the original
build. The preamble was lost with the original file: about forty macro
definitions recovered from usage. The pattern that unlocked most of it is that
\be/\ee are example environments, not equation delimiters, matching \bd/\ed,
\bl/\el, \bt/\et and \br/\er for definition, lemma, theorem and remark -- that
one correction took the error count from 247 to 47.
Evidence the inference is close: 271 pages against the published 267, 104,013
extracted words against 106,780, and prose probes agreeing within 1-2% (NUCOMP
265 vs 268, Mumford 103 vs 105, balancing 116 vs 116 exactly).
Three things remain guesses and are named in Thesis/README.md so the next reader
does not have to rediscover them: \s is \quad on about 1,200 sites, inferred from
context alone; the title page's degree, year, month and department fields are
plausible rather than sourced; and utopia is the only one of the class's five
font options that builds, which is suggestive rather than confirmed.
Two of those were settled by measurement rather than taste. singlespaced gives
268 pages where doublespaced gives 368, against a published 267. utopia brings
the count from 276 to 271 and the word gap from 11% to 2.6%.
thesis.pdf is a committed build artifact and will go stale; Thesis/README.md says
to rebuild it in the same commit as any .tex correction, and nothing enforces it.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Neither
Thesis/norThesisPublished/held the master document, so the thesis could not be rebuilt from either tree. The README recorded that fact; nobody drew the consequence — 104.texfiles across two trees had no automated check of any kind, which is how a malformed nested subscript and an unbalanced parenthesis have sat inThesis/unnoticed.This adds
Thesis/thesis.tex, reconstructed, andThesis/thesis.pdf, what it builds.Two results
The thesis builds. Zero errors, zero undefined references, zero undefined citations, 271 pages.
It works as a gate. Deleting a single
\end{align*}fails loudly:Paragraph ended before \align* was complete.The corrected thesis is now readable as a document
Thesis/thesis.pdfis not the PDF at the repository root, and the distinction is the point. The root PDF is as submitted in 2020. This one is the corrected thesis, so it is the only place the errata are visible rendered rather than as.texsource.Verified rather than asserted: the post-C4 Degree-3 doubling row
74 3 89 19is present and the superseded73 3 101 19is absent, soE-T10really is in there.How much is inferred: the preamble, all of it
The include order is exact, read off the committed
thesis.auxof the original build — titlepage, frontmatter, chapters 1 to 7, no appendix.The preamble was lost with the original file. About forty macro definitions were recovered from usage. The pattern that unlocked most of it:
\be/\eeareexampleenvironments, not equation delimiters, matching\bd/\ed,\bl/\el,\bt/\etand\br/\erfor definition, lemma, theorem and remark. That one correction took the error count from 247 to 47.subroutinethen turned out to be a float rather than a theorem — it takes[htbp]and contains\caption— and\texorpdfstringrevealed hyperref.Evidence the inference is close:
NUCOMPMumfordbalancingTwo options settled by measurement, not taste
singlespaced: 268 pages at the time of testing against a published 267, where my initialdoublespacedguess gave 368. The page-count comparison caught a wrong assumption, which is the whole reason for having it.utopia: the only one of the class's five font options that builds, aftercarlislesupplied the missingscalefntand droppingamssymbresolved a\circledSclash withmathdesign. It takes the page count from 276 to 271 and the word gap from 11% to 2.6% — which also explains the earlier discrepancy, since this thesis is mostly formulas and math extracts differently under different font encodings.Three guesses, named rather than left to be discovered
All three are in
Thesis/README.md:\sis\quad, inferred from context alone, on about 1,200 sites. Nothing else in the reconstruction has that reach.utopiais suggestive, not confirmed.A hypothesis was also disproved on the way: the appendix is not the missing content. Including it adds one page and 114 words, because those three stubs really are empty.
What this unlocks
PR22 was planned around a gate that did not exist. Its stated acceptance test is "LaTeX builds", which was never runnable; the plan had grown a syntax checker as a substitute. With a working build that drops to a nice-to-have and PR22 gets the real thing.
PR31 becomes possible at all — you cannot fill three appendix stubs you cannot compile. The
% \appendixline is left commented inthesis.texwith a note pointing there.Requirements and one caveat
TinyTeX plus
tlmgr installformemoir xpatch algorithms algorithmicx multirow grfext hyperref float url carlisle ly1 mathdesignand the Utopia fonts. No full TeX Live needed.thesis.pdfis a committed build artifact and will go stale.Thesis/README.mdsays to rebuild it in the same commit as any.texcorrection, and nothing enforces that. A candidate for a future gate rather than something this PR solves.Gates
readme-paths98/98 ·check_paths --strict259/259 · no.magfile touched, so the formula gates are not applicable ·ThesisPublished/untouched.