Debian Codegraph @

texmf-dist/source/latex/poemscol/poemscol.dtx

raw
1 % \iffalse meta-comment
2 % !TEX TS-program = dtxmk
3 %
4 % Copyright (C) 2002-2020 by John Burt <[email protected]>
5 % --------------------------------------------------
6 %
7 % This file may be distributed and/or modified under the
8 % conditions of the LaTeX Project Public License, either version 1.3c
9 % of this license or (at your option) any later version.
10 % The latest version of this license is in:
11 %
12 % http://www.latex-project.org/lppl.txt
13 %
14 % This work has the LPPL maintenance status `maintained'.
15 %
16 % The Current Maintainer of this work is John Burt.
17 %
18 % This work consists of the files poemscol.dtx and poemscol.ins
19 % and the derived file poemscol.sty.
20 %
21 % \fi
22 %
23 % \iffalse
24 %<package>\NeedsTeXFormat{LaTeX2e}[1997/12/01]
25 %<package>\ProvidesPackage{poemscol}
26 %<package> [2020/06/12 v3.1415926 poemscol file]
27 %
28 %<*driver>
29 \documentclass{ltxdoc}
30 \usepackage{makeidx,multicol,keyval,ifthen}
31 \setlength\IndexMin{100pt}
32 \EnableCrossrefs
33 \CodelineIndex
34 \RecordChanges
35 \begin{document}
36 \DocInput{poemscol.dtx}
37 \end{document}
38 %</driver>
39 % \fi
40 %
41 % \CheckSum{10704}
42 %
43 % \CharacterTable
44 % {Upper-case \A\B\C\D\E\F\G\H\I\J\K\L\M\N\O\P\Q\R\S\T\U\V\W\X\Y\Z
45 % Lower-case \a\b\c\d\e\f\g\h\i\j\k\l\m\n\o\p\q\r\s\t\u\v\w\x\y\z
46 % Digits \0\1\2\3\4\5\6\7\8\9
47 % Exclamation \! Double quote \" Hash (number) \#
48 % Dollar \$ Percent \% Ampersand \&
49 % Acute accent \' Left paren \( Right paren \)
50 % Asterisk \* Plus \+ Comma \,
51 % Minus \- Point \. Solidus \/
52 % Colon \: Semicolon \; Less than \<
53 % Equals \= Greater than \> Question mark \?
54 % Commercial at \@ Left bracket \[ Backslash \\
55 % Right bracket \] Circumflex \^ Underscore \_
56 % Grave accent \` Left brace \{ Vertical bar \|
57 % Right brace \} Tilde \~}
58 %
59 %
60 % \changes{v1.0}{2002/06/05}{Initial version}
61 % \changes{v1.01}{2002/06/25}{Added commands for titles of poems without
62 % formal titles. Corrected typographical errors in manual.}
63 % \changes{v1.1}{2003/04/18}{Added commands to change mark in cases
64 % where page break fall (or does not fall) on stanza break. Added
65 % command to change the amount of indentation in runover lines in
66 % verse. Removed special geometry to make the program more generic.}
67 % \changes{v1.11}{2005/02/12}{Corrected bugs in headers for
68 % explanatory notes and emendations.}
69 % \changes{v1.2}{2005/2/19}{Accidentals and typescript variants test
70 % to see whether textual notes are being made. Corrected a bug when
71 % quoting verse in note sections. Added a command to change the page
72 % number of the table of contents. Added a command to input the table
73 % of contents file. Added commands to input the external files for
74 % emendations, explanatory notes, textual notes, and the index of
75 % titles and first lines. Added a command to test whether there is an
76 % .aux file from a previous run and to prevent typesetting of the
77 % external files for emendations, explanatory notes, textual notes if
78 % there is not. Added a command to restore the main page style after
79 % the table of contents.} \changes{v1.7}{2005/2/22}{Changed how labels
80 % are made for use in contents and notes sections. Control sequences
81 % in titles (such as for italics and so on) no longer require special
82 % commands, although those commands are retained for backward
83 % compatibility.} \changes{v2.01}{2005/2/22}{Rewrote all of the title
84 % commands in order to make them easier to maintain. Added environment
85 % for flushing runover lines in verse to the right margin. Added
86 % information on how to customize titles.}
87 % \changes{v2.02}{2005/2/28}{Corrected an error in setting poems
88 % without formal titles} \changes{v2.12}{2005/3/19}{Notes sections can
89 % take ranges of lines.} \changes{v2.13}{2005/3/20}{tsentry no longer
90 % needs an unskip if the entry starts with a comma.}
91 % \changes{v2.2}{2005/3/23}{The user can create new kinds of endnote.}
92 % \changes{v2.21}{2005/3/24}{Cross references can refer to line
93 % numbers} \changes{v2.22}{2005/3/25}{Removed dependence upon
94 % marn.sty. Enabled multiple levels of block-formatted footnotes}
95 % \changes{v2.24}{2005/4/02}{commands to aid typesetting parallel
96 % texts.} \changes{v2.25}{2005/5/06}{Bug fix in running headers to
97 % notes sections} \changes{v2.26}{2005/5/09}{Fix no unskip in vertical
98 % mode error} \changes{v2.27}{2005/5/09}{Changed name of linelabel
99 % command, to prepare for making poemscol and lineno compatible}
100 % \changes{v2.30}{2005/5/16}{Prose sections such as Authors'
101 % Introductions are line numbered by lineno.sty. Textnotes,
102 % emendations, and explanatory notes for prose sections may be either
103 % footnotes or endnotes, and the latter are sent to the same place as
104 % their verse equivalents. Good solution to ``missing number''
105 % problem on first runs.} \changes{v2.301}{2005/5/31}{Corrected small
106 % bug in table of contents commands, rewrote manual for clarity}
107 % \changes{v2.31}{2005/6/3}{Ranges of line for notes sections (in
108 % verse or prose sections) need no longer involve counting of lines.
109 % Lemmas may be nested, may overlap, and may cross stanza boundaries.}
110 % \changes{v2.32}{2005/6/29}{Simpler configuration of marginal line
111 % numbers, revision of manual} \changes{v2.33}{2005/7/03}{Fixed a bug
112 % in index generation, compensated for odd interaction between
113 % fancyhdr and reversemarginpar} \changes{v2.34}{2005/7/17}{Easier
114 % modification of format of tables of contents}
115 % \changes{v2.35}{2005/7/18}{poemscol can break the lines for long
116 % titles in the table of contents on its own without making a mess of
117 % it. poemscol can break the lines for long titles on its own without
118 % making a mess of it. Modified commands for volume titles to use the
119 % facilities for poem titles.} \changes{v2.36}{2005/8/16}{Versions of
120 % note commands for typescript variants and accidentals for annotated
121 % prose. Commands for marking up and annotating prose by paragraph and
122 % sentence number. Commands for cross references by sentence and
123 % paragraph number.} \changes{v2.37}{2005/8/30}{In cases of broken
124 % lines or runover lines you can choose whether to set the line number
125 % with the beginning of the line or with the end of the line. Also,
126 % you can choose to have it set the number always at the beginning if
127 % the line number is at the left, and always at the end if it is at
128 % the right.} \changes{v2.38}{2005/9/04}{Checked cases where commands
129 % might introduce extra white space. Made sure that line numbers for
130 % verse, prose, and paragraph-sentence prose line up. Fixed
131 % overlapping of paragraph and line numbers for paragraph-sentence
132 % mode. Up to four sentences can appear on a line in paragraph-line
133 % mode without having their marginal line numbers overlap. Fixed a
134 % bug that added an extra colon in footnotes in paragraph-sentence
135 % format. Changed ``gutter'' and ``outer'' line numbering in verse
136 % and paragraph-sentence prose to use Peter Wilson's sidepars rather
137 % than marginpars.} \changes{v2.39}{2005/9/07}{Left a DeclareOption
138 % hanging in version 2.38. Fixed that.}
139 % \changes{v2.391}{2005/10/06}{Corrections to user's guide.}
140 % \changes{v2.392}{2005/10/13}{More corrections to user's guide.}
141 % \changes{v2.394}{2005/12/10}{More corrections to user's guide.}
142 % \changes{v2.4}{2006/02/25}{Commands to make new kinds of endnotes
143 % also make notes for line numbered prose sections and for prose
144 % sections with paragraph and sentence numbering.}
145 % \changes{v2.41}{2006/03/02}{Fixed a bug in line numbers of new kinds
146 % of prose note.} \changes{v2.42}{2006/03/04}{Fixed error in handling
147 % conditionals when setting prose numbered by sentence and paragraph.}
148 % \changes{v2.43}{2006/03/06}{Notes in prose numbered by sentence and
149 % paragraph number can refer only to the sentence number even when
150 % paragraphs are also being counted.}
151 % \changes{v2.44}{2006/03/07}{Fixed a bug which caused new kinds of
152 % endnotes in prose sections to add unwanted white space to the
153 % output.} \changes{v2.45}{2006/04/08}{Use of sidepar in v2.38
154 % introduced a problem, causing line numbers sometimes to drift up a
155 % point. Changed commands for putting verse line numbers, but not
156 % paragraph and sentence numbers, to use marginpars again.}
157 % \changes{v2.46}{2006/04/10}{Changed definition of sidepar so that it
158 % uses struts to find the depth of the line, restored line number
159 % commands to use sidepar and its variants.}
160 % \changes{v2.47}{2006/04/12}{Changed name of sidepar to pcmclsidepar
161 % to avoid conflicts with the sidepar command from the memoir class,
162 % since they are no longer exactly the same. Added commands to put a
163 % marginal reference to the notes section in the margins of poem
164 % titles.} \changes{v2.48}{2006/04/13}{Added more general form of the
165 % commands to put a marginal reference to the notes section in the
166 % margins of poem titles.} \changes{v2.49}{2006/04/25}{Changed
167 % marginal reference command to use marginpar rather than pmclsidepar
168 % (alas, it still adds vertical white space after the title with
169 % pmclsidepar). Added marginal reference commands for sequences and
170 % sequence sections. Fixed errors in manual. }
171 % \changes{v2.50}{2006/05/13}{Added marginal reference commands for
172 % poem sections, poem subtitles, epigraphs, and dedications. These
173 % commands no longer require an additional label command to set the
174 % label to which they refer. Added commands to make marginal
175 % references to the pages in notes sections where comments on
176 % individual lines may be found, for textual notes, explanatory notes,
177 % emendations, and user-defined notes. Added commands for changing
178 % the names of the Table of Contents, the various endnotes sections,
179 % and the running headers for the contents and endnotes sections, in
180 % order to facilitate editions of works in languages other than
181 % English.} \changes{v2.51}{2006/05/22}{Changed prose section
182 % environment so that it does not always assume that the modulo for
183 % line numbers in prose is the same as the number in verse. Corrected
184 % a problem with alignment of line numbers in the prosesectionnoreset
185 % environment. Added commands to support generation of multiple
186 % indices using the splitindex package. Fixed a variety of small
187 % bugs, including a newly introduced one in the correction to textual
188 % notes for quoted verse.} \changes{v2.52}{2007/07/10}{Changed
189 % dedication to poemdedication to avoid a conflict with a command in
190 % koma-script. dedication command is provided using providecommand
191 % for compatibility} \changes{v2.53}{2007/07/14}{Changed the name of
192 % an internal token register to avoid a conflict with babel}
193 % \changes{v2.531}{2011/08/16}{Fixed a typo in example code.}
194 % \GetFileInfo{poemscol.sty} \changes{v2.6}{2012/08/31}{Added an
195 % optional argument to the poem environment to center the text block
196 % of the poem on the longest line. Added a switch to enable titles to
197 % be centered on the page.} \changes{v2.61}{2013/02/06}{Added a
198 % boolean to switch notes to one note per paragraph form. Boolean to
199 % switch off poem titles in notes. Two column formatting for notes sections.}
200 % \changes{v2.62}{2013/05/22}{You can adjust the margins of
201 % epigraphs, dedications, and similar things. Made the appearance of
202 % entries in the table of contents for endnotes sections
203 % customizable. Fixed a bug which caused user-defined
204 % endnotes to put extra white space in prose passages.}
205 % \changes{v2.63}{2013/06/01}{Revisions to manual.}
206 % \changes{v2.64}{2013/08/02}{Bug fix: remove extra white space in
207 % custom endnotes for prose sections when notes are in single paragraph mode. Fix
208 % appearance of page number in endnote sections.}
209 % \changes{v2.65}{2013/12/20}{Modifications to parallel text commands,
210 % corrections to manual.}
211 % \changes{v2.66}{2015/5/14}{Change to page styles}
212 % \changes{v2.7}{2015/6/18}{Improvements to parallel texts.}
213 % \changes{v2.72}{2015/6/25}{Improvements to parallel texts. Generic note types for parallel texts.
214 % corrections to manual.}
215 % \changes{v2.8}{2017/8/25}{Changes in default values about where line numbers
216 % are placed. verselinenumberstoleft and related commands no longer change
217 % marginparsep. Endnote sections may have normal or hanging paragraphs.
218 % Endnotes may have multiple paragraphs.}
219 % \changes{v2.81}{2017/8/30}{Versemarginadjust to
220 % adjust margins of the verse block. Line numbers automatically move closer to
221 % the text when the text block is centered on the longest line. New boolean to
222 % force line numbers to the margins when the text block is centered. New commands to
223 % control the distance of line numbers from margins of centered text block. New default
224 % values for marginparwidth and marginparsep.}
225 % \changes{v2.85}{2017/9/03}{Boolean to turn centering of verse block on and off.
226 % Subtitles center when centertitles is issued. New boolean to adjust placement of marginal
227 % reference markers in jhtextnote and related commands.}
228 % \changes{v2.87}{2017/10/23}{Notes to appear at the end of individual poems.}
229 % \changes{v2.88}{2017/10/29}{Revisions to manual.}
230 % \changes{v2.89}{2017/11/30}{Append the date to the end of the poem.}
231 % \changes{v2.9}{2017/12/02}{Date aligns with left margin of poem even when poem is centered.}
232 % \changes{v2.95}{2017/12/20}{Long poems can put firstline---lastline in running header.
233 % Revisions to manual. Textual notes, emendation notes, and explanatory notes can also be
234 % placed at the end of the poem rather than at the bottom of the page or in an endnote section.
235 % Commands to set the title only in the contents and only in the notes.}
236 % \changes{v2.96}{2018/01/02}{Epigraphs, headnotes, dedications, and attributions move
237 % towards the center when titles are centered. Easier customization of epigraphs and similar things.}
238 % \changes{v2.97}{2018/01/05}{Correction to JHepigraphs. Epigraphenvironment for
239 % headnotes with more than one stanza or paragraph. Corrections to manual.}
240 % \changes{v2.98}{2018/01/11}{Corrections to manual.}
241 % \changes{v2.99}{2019/08/02}{Hierarchy of indented stanzas}
242 % \changes{v3}{2019/08/03}{With centered verse you can align the title, epigraphs,
243 % attributions, and so on with the left margin of the verse block.}
244 % \changes{v3.01}{2019/08/04}{Corrections to manual}
245 % \changes{v3.04}{2019/08/18}{Appendix sections. New contents entries.}
246 % \changes{v3.08}{2019/09/03}{Indentations of species of titles in text can be independently changed without changing the
247 % definition of the title. Appendix and Foreword section titles can be indented differently from notes section titles. }
248 % \changes{v3.081}{2019/09/05}{Fixed centertitles bug for subsections}
249 % \changes{v3.09}{2019/09/06}{New schemes for titles. Titles can be placed
250 % according the indentation schemes introduced in version 3.08, at the left text margin, at
251 % the left verse margin, centered over the longest line of a verse block at the left verse margin,
252 % at the left margin of a verse block centered on the longest line, and centered over a verse
253 % block centered over the longest line.}
254 % \changes{v3.1}{2019/09/08}{New commands shortpoemepigraph, shortpoemdedication,
255 % shortpoemattribution, JHshortepigraph, JHshortdedication. These
256 % commands are controlled by the same booleans that control placement
257 % of titles.}
258 % \changes{v3.12}{2019/09/05}{Bug fix. Fix command clash with titlesec. Manual revision}
259 % \changes{v3.13}{2019/09/15}{Fixed subtitles in emendations and explanations, Fixed bug in sequencesectiontitlefirstline, changed sequence hierarchy of indentations, subsubsections of sequences no longer appear in contents}
260 % \changes{v3.14}{2019/09/27}{Bug fix: ifpagenumberinnotesfalse, Manual revision}
261 % \changes{v3.141}{2019/10/27}{Manual revisions. Fixed spacing of sentence and
262 % paragraph numbers in
263 % sections numbered by paragraph and sentence. You can suppress the appearance of the
264 % first sentence number, whether in the margin or in the running text. You can suppress
265 % the appearance of the first paragraph number, whether in the margin or in the running text.}
266 % \changes{v3.1415}{2020/05/25}{Changed controlling how to place
267 % marginal marks in JHpoemtitle and its siblings, and in JHtextnote
268 % and its siblings. Marginal marks are now set using their own inserts, rather than using marginpar.}
269 % \changes{v3.14159}{2020/06/02}{Marginal marks set by JHpoemtitle now work with the different
270 % title placement schemes.}
271 % \changes{v3.141592}{2020/06/12}{Special commands for titles with footnotes (where the footnotes
272 % are authorial and part of the title). Title footnotes can be set at the bottom of the page, like
273 % traditional footnotes, at the bottom of the page like ``Layered'' footnotes, or at the
274 % end of the poem. Marginal marks set by JHpoemtitle can be placed
275 % independently of the marginal marks produced by margreftextnote..}
276 % \changes{v3.1415926}{2020/08/08}{Bug fix. Extra white space problem. Thanks to David Carlisle.}
277 % \DoNotIndex{\newcommand,\newenvironment,\def,\edef,\else,\renewcommand,\makeatletter,\makeatother}
278 % \DoNotIndex{\abovedisplayskip,\belowdisplayskip,\abovedisplayshortskip,\belowdisplayshortskip}
279 % \DoNotIndex{\newcommand, \section, \subsection, \subsubsection,
280 % \fileversion,} \DoNotIndex{\filedate, \docdate, \leavevmode,
281 % \vspace, \small, \normalsize, \fontsize,} \DoNotIndex{\newcommand,
282 % \section, \subsection, \subsubsection, \fileversion}
283 % \DoNotIndex{\filedate, \docdate, \leavevmode, \vspace, \small,
284 % \normalsize, \fontsize} \DoNotIndex{\selectfont, \abovedisplayskip,
285 % \belowdisplayskip, \setlength, \item} \DoNotIndex{\global, \input,
286 % \def, \edef, \texttt, \textsf, \setcounter}
287 % \DoNotIndex{\pagenumbering, \oddsidemargin, \evensidemargin,
288 % \newdimen, \renewcommand} \DoNotIndex{\makeatletter, \let, \@listi,
289 % \@listl, \z@, \@xpt, \@xipt, \p@ , \@plus2} \DoNotIndex{\@minus5,
290 % \@minus3, \@plus3, \makeatother, \@minus4, \relax, \pagestyle}
291 % \DoNotIndex{\fancyhead, \fancyfoot, \thepage, \@ixp}
292 % \DoNotIndex{\begin \botmark, \botmark, \catcode, \croppadbot,
293 % \croppadtop} \DoNotIndex{\croppagewidth, \endverse, \equal,
294 % \fancyfoot, \fancyhead, \fancyhf} \DoNotIndex{\fancypagestyle,
295 % \firstmark, \footrulewidth, \hbox, \hbox, \headrulewidth}
296 % \DoNotIndex{\hfil, \hspace, \ifthenelse, \immediate, \itemindent,
297 % \listparindent} \DoNotIndex{\makeatletter, \nolinebreak, \openout,
298 % \raggedbottom, \setcounter, \textrm} \DoNotIndex{\value, \vspace,
299 % \write} \DoNotIndex{\afterpoemtitleskip, \addtocounter, \advance,
300 % \begin, \bf, \bigskip} \DoNotIndex{\bigskipamount, \fi, \@fulltitle,
301 % \label, \large, \leftheader} \DoNotIndex{\leftheadervalue,
302 % \leftmargin, \leftmargini} \DoNotIndex{\medskip, \newcounter,
303 % \nobreak, \par, \textbf}
304 % \DoNotIndex{\closeout,\em,\emph,\expandafter,\Huge,\it,\jobname,\kern,\newif,
305 % \newwrite,\p@,\pageref,\renewenvironment,\rm,\scriptsize,\string,
306 % \textsc, \unskip}
307 % \setcounter{IndexColumns}{2}
308 % \MakeShortVerb{|}
309 % \def\fileversion{3.1415926}
310 % \def\filedate{8 August 2020}
311 % \def\docdate{8 August 2020}
312 % \title{Typesetting Poetry Collections with
313 % \textsf{poemscol}\thanks{This document corresponds to
314 % \textsf{poemscol}~\fileversion, dated \filedate.}}
315 % \author{John Burt
316 % \\ \texttt{[email protected]}}
317 % \date{8 August 2020}
318 % \maketitle
319 % \begin{abstract} \textsf{poemscol} provides commands for \LaTeX\ for
320 % setting collections of poetry. It is especially suited for setting
321 % collections of poetry in which several volumes are combined, such as
322 % in a critical edition of a poet's Collected Poems. It provides the
323 % structures required to produce a critical edition of the kind
324 % specified by the Modern Language Association's Committee on
325 % Scholarly Editions, and it automatically marks every occasion where
326 % a stanza break falls on a page break. \end{abstract}
327 % \tableofcontents \hfuzz=50pt \section{Introduction}
328 %
329 % \textsf{poemscol} provides the structures necessary for editing a
330 % critical edition of a volume of poems (or of a collection of a poet's
331 % works) such as those required by the Modern Language Association's
332 % Committee on Scholarly Editions. \textsf{poemscol} numbers the lines, and produces separate,
333 % formatted endnote sections (or, optionally,
334 %multiple layers of footnotes) for emendations, textual collations, and
335 % explanatory notes, tying
336 % each note to the range of lines upon which it is a comment.
337 %
338 % Producing line numbers for verse is something for which \LaTeX\
339 % would seem to be especially suited. A line of verse, after all, is
340 % not a carriage return but a logical unit, an element of
341 % versification more than of typesetting, perhaps running over several
342 % physical lines, or perhaps split into half-lines as speakers or
343 % subjects change. With \textsf{poemscol} you mark lines, stanzas,
344 % and entire poems up as logical units, and \LaTeX\ does the
345 % formatting and counting. Once you have marked out the logical units
346 % of the poem, \textsf{poemscol} will automatically mark every textual
347 % note, emendation, or explanatory note with the range of line
348 % numbers to which it applies.
349 %
350 % Editions of Collected Poetry might also require special structures
351 % to reflect the fact that they are made up of the contents of several
352 % volumes of poetry. In particular, such editions require
353 % facilities for setting up specially formatted divider pages between
354 % volumes. They also require tables of contents and other front matter, as well
355 % as an index of titles and first lines (or, optionally, several separate indices)
356 % and other sorts of back matter.
357 % \textsf{poemscol} automatically generates a table of contents, an index of titles
358 % and first lines, and divider pages for the sections of the volumes.
359 % It produces running headers of the form ``Emendations to pp.~xx-yy''
360 % for the note sections.
361 %
362 % In poetry which does not have a regular stanzaic form, it is useful
363 % to be able to mark automatically occasions where there is a stanza
364 % break at the bottom of a page which the reader might not notice.
365 % Doing this by hand is not only tedious and easy to get wrong, but
366 % also a process you will have to start over again if anything about
367 % your volume changes --- if you add a poem, say, or even decide to break
368 % a title across two lines. \textsf{poemscol} takes care of this
369 % process, so that the editor need never worry about it, automatically
370 % marking cases where the page break coincides with a stanza break
371 % with a symbol.
372 %
373 % \textsf{poemscol} includes facilities for typesetting parallel text editions
374 % of poems, for instance to compare different versions or translations of the same poem
375 % on the recto and verso pages. \textsf{poemscol} will keep the line
376 % numbering of the two texts separate, will provide separate endnote sections
377 % for textual notes, emendations, and explanatory notes for the different texts,
378 % and will also make marginal markers to tie lines in the verso text to the
379 % equivalent line in the recto text.
380 %
381 % \textsf{poemscol} is also suited for verse drama, and the package
382 % \textsf{dramatist} has been modified to work with \textsf{poemscol}.
383 %
384 % \textsf{poemscol} can provide line numbers and notes for prose
385 % sections such as the author's introduction or prose poetry. (It
386 % can also handle inset prose passages in the midst of verse, pausing and
387 % restarting verse line numbering as the editor desires.)
388 % It also has some limited facilities for typesetting and annotating
389 % line-numbered parallel passages in prose.
390 % \textsf{poemscol} is not, however, designed for typesetting critical editions of large
391 % scale prose works, although very possibly it could be tweaked to
392 % work. For critical editions of prose works, several
393 % other packages are available, including the \texttt{EDMAC} format, a
394 % \TeX\ format analogous to but distinct from \LaTeX, by John
395 % Lavagnino and Dominik Wujastyk, or \textsf{ledmac}, a port of
396 % \texttt{EDMAC} into \LaTeX\ originally by Peter Wilson and
397 % now maintained as \textsf{reledmac} by Ma\"{\i}eul Rouquette, or \textsf{ednotes}, a
398 % completely independent set of commands for critical editions which
399 % builds on \textsf{manypar} and \textsf{lineno}, by Uwe L\"{u}ck.
400 %
401 % \textsf{poemscol} can number and annotate prose marked in
402 % ``paragraph number: sentence number''
403 % format (or bible chapter and verse). The advantage of this method of numbering lines
404 % of prose is that what is numbered is something the author chose to create
405 % (sentences and paragraphs)
406 % rather than an accidental feature of typesetting (line numbers). Paragraph and sentence
407 % numbering will also be stable across multiple editions, and, like line numbers in verse,
408 % provides a common system of reference.
409 %
410 % \textsf{poemscol} provides
411 % the ability to make cross references to verse line numbers, to line numbers in prose sections,
412 % or to paragraph and sentence numbers in sections with ``paragraph and sentence'' annotation.
413 %
414 % \textsf{poemscol} also provides a few bells and whistles, such as the ability
415 % to create new endnote or footnote sections on the fly, the ability
416 % to center a poem on the longest line (or to move the margin of the
417 % verse block wherever you wish), and the ability to place a mark in the margin
418 % indicating where in the apparatus commentary on that line can be found.
419 % For long poems, \textsf{poemscol} can provide a
420 % a special running header which indicates the range of lines to be
421 % found on the page.
422 % It has a special command to place
423 % the publication date under the poem just at the left margin of the verse block even
424 % when the verse block is centered.
425 % \textsf{poemscol} also provides notes
426 % to be placed just after a poem (rather than at the bottom of the page
427 % or in the endnote sections). It gives the user
428 % fine control over the placement of line numbers and the placement and format of titles
429 % including multi-line titles.
430 % The user can choose whether to concatenate the notes for a poem into a single paragraph,
431 % or to give each note a separate paragraph. The user can print the notes
432 % in single or multicolumn format. The names of things like the Contents can
433 % be changed to facilitate editions in languages other than English.
434 % Just about every feature of \textsf{poemscol} can be
435 % easily customized.
436 %
437 % The best features of \textsf{poemscol} are of course simply that it
438 % is \TeX: it uses \TeX's automatic kerning and setting of ligatures,
439 % its algorithm for justifying lines (in prose sections), and \LaTeX's
440 % way of setting verse.
441 %
442 % Using \LaTeX\ to typeset critical editions offers more advantages
443 % than simply the ability to automate tedious and easy to fumble
444 % tasks. \TeX\ compilers have the ability to produce
445 % output in Adobe pdf format. Adobe pdf output can be used as camera
446 % ready copy, saving your publisher time and expense, and perhaps
447 % making a marginally economic critical edition a bit easier to bring
448 % to press. Furthermore, since typesetting the edition yourself in
449 % \LaTeX\ obviates the publisher's own typesetting of your text, it
450 % removes another possible source of new errors. (You should expect
451 % to work with your publisher on the final design of the book, but
452 % \LaTeX\ is a flexible language which will enable you to reproduce
453 % most book designs.)
454 %
455 % Editions made in the formats of proprietary software such as
456 % QuarkXPress\copyright\ or InDesign\copyright\ will become not only obsolete
457 % but unreadable if those programs pass from use. Since your \LaTeX\
458 % sources for your edition are in ASCII, or perhaps Unicode, they provide a permanent
459 % record of your local intentions at every point in your edition,
460 % whether or not those who wish to consult your files have access to a
461 % \LaTeX\ compiler, or indeed (since most of the commands have self-explanatory names)
462 % whether or not they can read \LaTeX\
463 % code.
464 %
465 % Although \LaTeX\ is a typesetting language, not a content
466 % markup language, the ability to create new commands which the
467 % language offers comes very close to enabling one to realize the
468 % ideal of completely separating content markup from formatting. One
469 % advantage of this kind of markup is that even if the appearance of
470 % the poem on the page may be ambiguous, the editor's intentions about
471 % the logical structure of the poem will be preserved in the \LaTeX\
472 % source. Should you wish later to produce an electronic edition of
473 % your work, perhaps using the XML markup approved by the Text
474 % Encoding Initiative, transforming your texts from \LaTeX\ to XML
475 % would largely (although not entirely) be a matter of performing a
476 % series of global search-and-replaces, and could conceivably be done
477 % with XSLT or with perl.
478 %
479 % This is a long manual, but there is no need to study it all before beginning.
480 % In the first place, it includes all the commented-on source code for the
481 % package, which will only matter to you if you are planning to customize
482 % it in some way I didn't anticipate, or if you need to know how the commands
483 % work internally. (The code section begins on page \pageref{implementation}.)
484 % The most important commands are explained in the first 30 pages, and even there
485 % many sections discuss things you may not need to know immediately. Also,
486 % many sections conclude with a subsection which suggests ways of customizing
487 % the output, usually giving suggestions in increasing order of difficulty. You'll
488 % have to be the judge of what to skip the first time through.
489 %
490 % \section{Dependencies and compatibility with other packages}
491 %
492 %\subsection{~General}
493 % \textsf{poemscol} depends upon several other packages, which you
494 % should be sure you have in your preamble and search path:
495 % \textsf{fancyhdr} for managing the running headers, \textsf{makeidx}
496 % and \textsf{multicol} for managing the index, \textsf{geometry}, and
497 % \textsf{ifthen} and \textsf{keyval} to simplify page geometry.
498 %
499 % If you are planning to generate multiple indices, substitute
500 % \textsf{splitindex} for \textsf{makeidx} in your list of packages.
501 %
502 %
503 % \subsection{~Prose sections}
504 % If you plan to number lines in prose contexts, and to make textual
505 % notes, emendations, or explanatory notes in prose contexts, you will
506 % need to add the \textsf{lineno} package to your preamble. I use the
507 % ``right'' and ``modulo'' options with this package, but you can set
508 % the options however you wish to make how you number the lines of
509 % prose sections consistent with how you number the lines of verse
510 % sections.
511 %
512 % \subsection{~Multi-layer footnotes} If you plan to use
513 % paragraph-formatted footnotes rather than endnotes, you should load
514 % \textsf{manyfoot}. You should load it with the ``ruled,'' and
515 % ``para'' options. (\textsf{poemscol's} footnote commands are just a
516 % wrapper around \textsf{manyfoot}.) \textsf{manyfoot} inherited some
517 % of the limitations of \LaTeX\ in dealing with long inserts at the
518 % end of the page, so you may have to do some fiddling. As fixes to
519 % these problems emerge, I will incorporate them into
520 % \textsf{poemscol}. \textsf{manyfoot} does not allow multiple
521 % paragraph footnotes when typesetting in ``para'' mode. This is
522 % probably a feature, not a bug, since one would want such notes to be
523 % set in several paragraphs, rather than running them together into
524 % one, as \textsf{manyfoot} would naturally want to do in para mode.
525 % For that reason, I have defined the two traditional classes of note
526 % in which multiple paragraph notes are likely to appear, ``sources,''
527 % and ``explanatory notes,'' to be typeset in ``plain'' mode, which
528 % opens a new paragraph with each note. If your textual notes or
529 % emendations sections also have multiple paragraph notes, you should
530 % re-define them in order to produce footnotes in plain rather than in
531 % para mode, if you wish to produce footnotes rather than endnotes.
532 %
533 % \textsf{manyfoot} sometimes gets into conflicts with other packages
534 % over the number of |\counts| it uses, causing \LaTeX\ to complain
535 % that there is no room for a |\newcount|. If this happens,
536 % issue |\usepackage{etex}| and |\reserveinserts| in your preamble.
537 %
538 % \subsection{~Special running header for long poems}
539 % For long poems, it is a convenience to have a running header
540 % that includes information about what lines of the poem appear
541 % on that page in the form firstline--lastline. The fancypagestyle |longpoem|
542 % will set that information in the running header. That page style
543 % uses the |\marks| mechanism, and requires more |\marks| than
544 % are available by default. To use it, you will need to add the \textsf{etex} and
545 % \textsf{emarks} packages to your preamble.
546 %
547 % \subsection{~Verse drama and \textsf{dramatist}}
548 % Massimiliano Dominici has made his \textsf{dramatist} package
549 % compatible with \textsf{poemscol}, for which I am very grateful.
550 % Versions 1.2a or later of \textsf{dramatist} are compatible with
551 % versions 2.3 or later of \textsf{poemscol}.
552 %
553 %
554 % \subsection{~Parallel text editions}
555 % \begin{sloppypar}
556 % If you are using the six pre-defined endnote sections
557 % for parallel text editions (|\rectotexnote|, |\versotextnote|, |\rectoemendation|, |\versoemendation|,
558 % |\rectoexplanatory|, |\versoexplanatory| and their prose equivalents |\rectoprosetextnote|
559 % and so on) you won't need to add any new packages. If
560 % you are defining your own endnote sections using |\definenewnotetype| you may need
561 % the |\keeptitlestraight| hack described below at section \ref{parallelhack},
562 % page \pageref{parallelhack}. If you use |\keeptitlesstraight| you should add \textsf{etoolbox}
563 % to your package list.\end{sloppypar}
564 %
565 % \subsection{~Crop marks}
566 % \textsf{poemscol} no longer provides cropmarks, but is compatible with
567 % the style packages that do. I use \textsf{crop}, with the
568 % letter,pdftex,cam, and center options.
569 %
570 %
571 %
572 %
573 % \subsection{~Incompatibility with \textsf{memoir} and \textsf{verse}}
574 % Unfortunately, \textsf{poemscol} is not compatible with the
575 % \textsf{memoir} class and the \textsf{verse} package, because they
576 % share some command names. I will eventually prepare a workaround for this
577 % problem.
578 %
579 % \subsection{~Conflict with \textsf{BibLaTeX} }
580 % \BibTeX\ works with \textsf{poemscol} with no problem. But a bug I haven't
581 % yet tracked down (probably involving |\makeatletter|)
582 % complicates the use of \textsf{BibLaTeX}. To use \textsf{BibLaTeX}
583 % you will need to open up the .bbl file. You will find near the top
584 % the following lines:\\
585 % |\makeatletter|\\
586 % |\@ifundefined{[email protected]}|\\
587 % | {\@latex@error|\\
588 % |{Missing 'biblatex' package}|\\
589 % | {The bibliography requires the 'biblatex' package.}|\\
590 % | \aftergroup\endinput}|\\
591 % |{}|\\
592 % Just comment out these lines and you will be able to use the .bbl file as usual.
593 %
594 %
595 % \subsection{~Compatibility with earlier versions of
596 % \textsf{poemscol}} Making \textsf{poemscol} compatible with
597 % \textsf{lineno} required me also to change the commands for turning
598 % verse line numbering on and off, which means that version 2.3 of
599 % \textsf{poemscol} is incompatible with prior versions. The old
600 % command |\makelinenumbers| has been replaced with
601 % |\makeverselinenumbers| to distinguish it from a command from the
602 % \textsf{lineno} world. (|\makelinenumbers| will still work, but I
603 % have deprecated it.) To turn on verse line numbering, issue
604 % |\makeverselinenumbers|. Because the counter ``linenumber'' has
605 % been changed to ``verselinenumber,'' you must use
606 % |\global\verselinenumbersfalse| to turn off line numbering, rather
607 % than |\global\linenumbersfalse| as before.
608 %
609 % Up to version 2.44 \textsf{poemscol} borrowed the code for
610 % |\sidepar| non-floating marginal paragraphs from the memoir class,
611 % and also made |\leftsidepar| and |\rightsidepar| commands on their
612 % model. Version 2.46 modified Peter Wilson's original code for
613 % |\sidepar|, so therefore I have changed the names of |\sidepar|,
614 % |\leftsidepar|, and |\rightsidepar| to |\pmclsidepar|,
615 % |\pmclleftsidepar| and |\pmclrightsidepar| respectively. If you
616 % used any of these commands in your files, you will need to change
617 % their names.
618 %
619 % Up to version 2.5 the |\definenewnotetype| command took four
620 % arguments, using the third argument for both the running header for
621 % the notes section and for the entry in the table of contents. In
622 % order to make it easier to handle titles in languages other than
623 % English I have found it necessary to separate these two uses, so
624 % |\definenewnotetype| now takes five arguments. You will need to
625 % retrofit files that use the old version of this command. You can
626 % see the details at section \ref{definingnewnotes}, page
627 % \pageref{definingnewnotes}.
628 %
629 %\begin{sloppypar}
630 % Version 3 introduced the boolean |\ifleftaligntitles|, for aligning the title with
631 % the left edge of a verse block centered on the longest line. Version 3.1 introduces
632 % new title placement schemes, including one which
633 % centers the title on the longest line of a verse block at the left margin. This made
634 % the meaning of |\ifleftaligntitles| ambiguous. So I have changed that boolean to
635 % |\iftitlesatleftmarginofcenteredblock.|\end{sloppypar}
636 %
637 % Up to version 3.141 the marginal marks associated with poem titles
638 % set by |\JHpoemtitle| and |\margreftextnote| moved in towards the
639 % verse block when the verse block is centered on the longest line.
640 % These marks could be returned to their normal position in the
641 % margin by setting the boolean |\margrefstomargin| to true. As of
642 % version 3.141 these marks are set in the margin by default even
643 % when verse block centering is in effect. The boolean |\margrefstomargin| controls
644 % nothing, but has been left in case I decide to restore the possibility
645 % of moving the marginal marks in when the lines are centered. You can control
646 % the horizontal placement of these marginal marks by changing the value
647 % of the length |\JHmarginparsep|.
648 %
649 % \section{Marking up individual poems}
650 % First, a word about the command names. The command names may seem
651 % ugly and long. And there are separate commands for many tasks that
652 % seem closely related, such as a command to mark the title of a
653 % section of a poetic sequence, and a separate command to mark a
654 % subsection. But the names do describe pretty much what
655 % each command does, and they do specify exactly what the object they
656 % mark is supposed to be. The markup is designed to look like content
657 % markup, marking objects as a poem title, as a stanza, as a line, and so on.
658 % \textsf{poemscol} gives all of these content terms typographical
659 % meaning.
660 %
661 % There are also many commands for special purposes whose necessity
662 % may not seem clear until the editor finds him or herself in the jam
663 % the command was designed for. For instance, \textsf{poemscol}
664 % normally encourages a page break before the title of a poem, or
665 % before the title of a section of a poetic sequence, to discourage
666 % page breaks between the title and the poem. But for the first
667 % section of a poetic sequence, or the first section of a poem in
668 % sections, one does not want to encourage \LaTeX\ to break the page
669 % before the section title, since that would leave the title of the sequence
670 % or the title of the larger poem as an orphan on the previous page.
671 % |\sequencefirstsectiontitle| and its siblings are designed for this
672 % situation. Although all commands like |\sequencefirstsectiontitle|
673 % discourage page breaks before the title (and all of the commands
674 % discourage page breaks after the title), widowed or orphaned titles,
675 % and orphaned first lines will still sometimes
676 % happen, particularly if you have a multi-line sequence title
677 % followed by a multi-line section title. For these cases, a page
678 % break at some other suitable point will have to be explicitly issued to
679 % move widowed or orphaned lines to better places.
680 %
681 % \subsection{~The title of the poem}
682 %
683 % \DescribeMacro{\poemtitle}|\poemtitle|, as its name implies, sets
684 % its argument as the title of the poem.
685 %The command takes one
686 % argument --- the title, of course. The command typesets the title in
687 % the body of the volume (testing first to see whether there is enough
688 % space at the bottom of the page to get the title and a couple of
689 % lines of the poem in), typesets the title in the table of contents
690 % (with the page number), typesets the title in the textual notes
691 % (adding the page number, and checking to see whether there is room
692 % enough on the page), and prepares similar entries in the lists of
693 % emendations and in the explanatory notes (if you need them)
694 % as well as in the endnote sections for any species of endnote you have defined for yourself.
695 % \textsf{poemscol} gives default values for
696 % such things as the font size, the separation between the top of the
697 % title and the bottom of the previous poem, the separation between
698 % the bottom of the title and the first line, and so on. It also sets
699 % penalties in order to encourage page breaks just before a title, and
700 % to discourage page breaks between a title and a poem.
701 %
702 % You can
703 % change all these values in your preamble by changing the value of
704 % the parameters for the relevant commands, listed below in the implementation section, using
705 % either |\setlength| or |\renewcommand| (depending upon what you are
706 % changing). Some common values you might change are described in section
707 % \ref{titlecustomization}.
708 %
709 % \subsubsection{Title placement schemes}
710 % \begin{sloppypar}
711 % There are a number of places where a title might be set. I have
712 % defined for this purpose five ``title placement schemes.'' For each
713 % one there is a boolean which turns on the choice, and a ``scheme''
714 % command which switches that boolean on and switches off the
715 % booleans for the other schemes. They are
716 %
717 % \begin{itemize}
718 %\item Aligned with the left print margin, or
719 % indented from it according to the scheme of title indentations (whether it is
720 % the title to a poem, to a section, to a subsection, or so on). The
721 % hierarchy of indentations for various kinds of title is described
722 % below at section \ref{customtitleindentations},
723 % page \pageref{customtitleindentations}.
724 % I will call the boolean that describes this
725 % situation |\ifnormaltitleindentation| because it was the default for
726 % \textsf{poemscol}. You invoke this title scheme with the command
727 % |\normaltitleindentationscheme|
728 %
729 % \item Aligned with the left margin of a left-aligned verse block.
730 % The verse block is normally inset from the left print margin by the length
731 % |\leftmargini | (the default distance between the left margin of
732 % a list environment --- I defined titles as lists --- and the surrounding text).
733 % I will call the boolean that describes
734 % title placement at the left verse margin |\iftitlesatleftversemargin|. You invoke this title
735 % scheme with the command |\titlesatleftversemarginscheme|.
736 %
737 % \item Centered over the longest line of a left-aligned verse block.
738 % I will call the boolean that describes this title placement
739 % |\iftitlescenteredonleftverseblock|. The corresponding command is
740 % |\titlescenteredonleftverseblockscheme|.
741 %
742 % \item Aligned with the left margin of a verse block centered on the
743 % page on the longest line. This will be associated with the boolean
744 % |\iftitlesatleftmarginofcenteredblock|. (In version 3.0 this boolean
745 % was called |\ifleftaligntitles|. I have removed that boolean
746 % because its meaning is ambiguous now.) The command to invoke this
747 % title scheme is |\titlesatleftmarginofcenteredblockscheme|.
748 %
749 %
750 % \item Titles centered over a centered verse block. I call this
751 % |\ifcentertitleson|. The corresponding command is
752 % |\centertitlesscheme|. I have retained the command |\centertitles|
753 % from earlier versions of \textsf{poemscol} for compatibility. This
754 % scheme can also be used to center the titles (and epigraphs, headnotes
755 % and other top matter) over a non-centered verseblock too, if you
756 % don't use the optional argument to |\begin{poem}| describe in the next
757 % section, or if you turn off centering of the verse block by issuing the
758 % boolean |\textcenteringturnedonfalse|.
759 %\end{itemize}\end{sloppypar}
760 %
761 % \subsubsection{Using title placement schemes: verse width and title width}
762 % \begin{sloppypar}
763 % |\centertitlesscheme|, |\titlescenteredonleftverseblockscheme|, and \\
764 % |\titlesatleftmarginofcenteredblockscheme| require additional information
765 % about each poem. Here are some details about the uses of these schemes.\end{sloppypar}
766 %
767 % \DescribeMacro{\centertitlesscheme} For each poem you wish to center you will have
768 % to set the length of the length variable |\versewidth| to the
769 % width of the longest line. To do this, use |\settowidth| as
770 % follows:\\ |\settowidth{\versewidth}{text of longest line}|.\\
771 % |\centertitlesscheme| will center the
772 % titles even if you do not center the verse block on the longest
773 % line.
774 % To center the verseblock use the optional argument to |\begin{poem}| as follows:\\
775 % |\begin{poem}[\versewidth].| \\ (For further instructions about
776 % how to center the verse block on the longest line, see section \ref{centeringtextblock}
777 % on page \pageref{centeringtextblock}.)
778 %
779 % |\centertitlesscheme| also moves in epigraphs, headnotes,
780 % attributions, and dedications towards the center. Since an epigraph or a headnote may be
781 % a prose paragraph, or a passage of verse, it would be unwise to set them in a centering
782 % environment, so |\centertitles| just moves the margins of epigraphs and headnotes in
783 % towards the center. To adjust the placement
784 % of epigraphs and similar things, see section \ref{centerepigraphs}, page \pageref{centerepigraphs}.
785 % Single line epigraphs, attributions, and dedications, however,
786 % will be centered if |\centertitlesscheme|
787 % is in effect. There are special commands for single line epigraphs, attributions, or dedications.
788 % To set these, issue
789 % |\shortpoemepigraph|, |\shortpoemdedication|, or |\shortpoemattribution|.
790 %
791 % \DescribeMacro{\titlescenteredonleftverseblockscheme}
792 %
793 % Using |\titlescenteredonleftverseblockscheme|
794 % scheme will require you to make known the width of the longest line
795 % of the poem being set \emph{and} the width of the title. You will need to
796 % use the |\settowidth| command to set the length of |\versewidth| and
797 % |\poemtitlewidth|. For example: \begin{quotation}
798 % \noindent |\settowidth{\poemtitlewidth}{poem title}| \\
799 % |\settowidth{\versewidth}{text of longest line}|. \end{quotation}
800 % Normally
801 % you should not use the optional argument to |\begin{poem}| with this
802 % title scheme. But you may have already marked up all your poems
803 % such a way as to leave open the choice of centering them. You can
804 % turn off centering of the verse block, without erasing all of the optional arguments, by
805 % issuing |\textcenteringturnedonfalse|. You can turn on centering the
806 % text block again by issuing |\textcenteringturnedontrue|.
807 %
808 % \begin{sloppypar}
809 % In this scheme, |\shortpoemepigraph|, |\shortdedication|, and |\shortattribution| will
810 % not center their arguments on the line, but set them flush with the beginning of the title.
811 % \end{sloppypar}
812 %
813 % If you don't set the length of |\poemtitlewidth| this scheme will simply set the
814 % left margin of the title over the center of the poem. (This may be an effect you want.)
815 %
816 % Note: this scheme will only yield proper results if the title is shorter than
817 % the longest line is.
818 %
819 %
820 % \DescribeMacro{\titlesatleftmarginofcenteredblockscheme}
821 %\begin{sloppypar}
822 %Rather than centering the title over
823 % a centered block of verse, one might prefer to align the title with
824 % the left margin of the centered verse block. The length |\versewidth|
825 % is used both to center the verse block and to place the title at the verse block's left margin.
826 % You will need to use |\settowidth| to set the length of |\versewidth| before
827 % issuing |\poemtitle| or the other title-making commands (such as |\sequencesectiontitle|).
828 % Issue |\settowidth{\versewidth}{Text to be used for centering}| just
829 % before you issue the |\poemtitle| or |\epigraph| command.
830 % In addition, you must center to verse block by using the optional argument |\versewidth|
831 % to |\begin{poem}|, for example: |\begin{poem}[\versewidth]|
832 %
833 % For more about how to use |\settowidth| to center the
834 % verse block or to align titles, epigraphs, and so forth with the left margin of the
835 % verse block, see section \ref{centeringtextblock}, page \pageref{centeringtextblock}.
836 %
837 % Consult the table to see when you should issue |\settowidth| and when you should
838 % use the optional argument to |\begin{poem}|.
839 %\begin{table}[h]
840 %\caption{Placement in Title Schemes}
841 %\bigskip
842 %{\scriptsize
843 %\begin{tabular}{l l l}
844 %\hline
845 %Scheme & Lengths to Set & Argument to |\begin{poem}|\\
846 %\hline
847 %|\normalindentationtitlescheme| & None & None\\
848 %|\titlesatversemarginscheme| & None & None\\
849 %|\titlescenteredonleftverseblockscheme| & |\poemtitlewidth| |\versewidth| & None\\
850 %|\titlesatleftmarginofcenteredblockscheme| & |\versewidth| & |\begin{poem}[\versewidth]| \\
851 %|\centertitlesscheme| & |\versewidth| & |\begin{poem}[\versewidth]| \\
852 %\end{tabular}
853 %}
854 %\end{table}
855 % \end{sloppypar}
856 %
857 %\subsubsection{Customization of titles}\label{titlecustomization}
858 %
859 %\begin{sloppypar}
860 % \DescribeMacro{\leftalignepigraphs} You
861 % may also wish to align epigraphs, dedications, attributions, or
862 % headnotes with the left margin of the verse block (even if you
863 % center the titles). To do this, issue |\leftalignepigraphstrue| to
864 % set the boolean |\ifleftalignepigraphs|.
865 % |\leftalignepigraphstrue| will also align attributions,
866 % dedications, and other pre-texts of poems. (It will not affect the
867 % dedications and attributions on volume title pages, which are set
868 % using the |\volumededication|, |\volumeepigraph|, and
869 % |\volumeattribution| commands.) A new group of commands,
870 % |\shortpoemepigraph|, |\shortpoemdedication|, |\shortpoemattribution|,
871 % |\JHshortepigraph| and |\JHshortdedication| will appear at the places
872 % controlled by the new ``title schemes'' listed above. These commands will not
873 % obey |\leftalignepigraphs|.
874 % \end{sloppypar}
875 %
876 % \begin{sloppypar}
877 % \DescribeMacro{\poemtitlefont}
878 % |\poemtitlefont| globally sets the font size (and
879 % leading) for all poem titles in the main text.
880 % For instance, you can change the font parameters for the font for
881 % setting poem titles from 14 points type on 18 points leading to 12 on 14 by issuing
882 % |\renewcommand{\poemtitlefont}{\fontsize{12}{14}\selectfont}| in
883 % your preamble. There are similar commands to set the font size and leading for
884 % the titles of poetic sequences,
885 % sequence sections, titles of volumes, and so on.
886 % You can find a complete list of those font parameters at section \ref{internal font size commands},
887 % page \pageref{internal font size commands}.
888 %
889 % |\poemtitlefont| and its siblings do not change the
890 % default typeface. To change the default typeface to, say, Times Roman, or
891 % Tex Gyre Pagella, use the commands \LaTeX\
892 % or Xe\LaTeX\ provide for that purpose (e.g.\ |\usepackage{tgpagella}|). Changing the default
893 % typeface is probably something you would want
894 % to do globally, not at the level of classes of title, anyway.
895 %\end{sloppypar}
896 %
897 % \DescribeMacro{\contentspoemtitlefont}
898 % |\contentspoemtitlefont| globally sets the font size (and leading)
899 % for poem titles in the table of contents. There are similar commands for each of the
900 % other kinds of titles in the table of contents. They can be changed just as the font
901 % parameters for titles in the main text are changed, using |\renewcommand|.
902 % You can find a complete list of those font parameters at section \ref{internal font size commands},
903 % page \pageref{internal font size commands}.
904 %
905 % \begin{sloppypar}
906 % \DescribeMacro{\afterpoemtitleskip}
907 % |\afterpoemtitleskip|
908 % sets the vertical separation between a poem and its title. To change
909 % its value, for instance, to |\medskip| (the default is |\smallskip|),
910 % issue |\renewcommand{\afterpoemtitleskip}{\medskip}| in your preamble.
911 % |\afterpoemskip| sets the vertical separation between the end of a
912 % poem and the title of the next poem. ``Skips'' for other kinds of title can be
913 % changed the same way. You can find a complete list of these skips at
914 % section \ref{skiplist}, page \pageref{skiplist}.\end{sloppypar}
915 %
916 % \DescribeMacro{\poemtitlepenalty}
917 % |\poemtitlepenalty| encourages
918 % but does not require a page break just before a poem title. To change
919 % the penalty, for instance, from -1000 to -3000,
920 % issue |\renewcommand{\poemtitlepenalty}{\penalty-3000}|
921 % in your preamble. Penalties for other kinds of title can be changed the same way.
922 % A
923 % complete list of all of the special commands for setting font sizes,
924 % skips, and penalties, is in section \ref{changingfontsandleading}, page
925 % \pageref{changingfontsandleading}, below.
926 %
927 % \DescribeMacro{\putpagenumberinnotesfalse}
928 % If you don't want the entry in the notes section for this poem to include
929 % the page number of the poem, issue |\putpagenumberinnotesfalse|.
930 %
931 % \DescribeMacro{\titleindent} |\titleindent| is an internal command for indented parts of titles.
932 % You should change it with caution. In the
933 % commands for setting the sections and subsections of poetic sequences,
934 % \textsf{poemscol} uses |\titleindent| internally to set up a
935 % hierarchy of indentations. (A section of a sequence is indented one
936 % |\titleindent|. A subsection is indented two. And so on.)
937 % |\titleindent| is also used internally in the commands for multiple
938 % line titles. Instructions about changing the value of |\titleindent|
939 % can be found in section \ref{changingfontsandleading}. Each kind of title,
940 % for poems, sections of poems, sequences, and so forth, has its own default
941 % indentation both in the text and in the table of contents. You can see a list of these
942 % default values, and instructions about how to change them, at \ref{customtitleindentations},
943 % page \pageref{customtitleindentations}.
944 %
945 % \subsubsection{Subtitles and special titles}
946 % \DescribeMacro{\poemsubtitle} Subtitles of poems should be issued as
947 % the arguments to the |\poemsubtitle| command.
948 %
949 % Multiple line titles (if it matters how they are broken up on page),
950 % titles of subsections of poems, titles of
951 % sequences of poems, titles of the elements of a sequence of
952 % poems, and ``empty'' titles (for untitled poems)
953 % are all special cases, with special commands, which will be
954 % dealt with below at sections \ref{multilinetitles} and \ref{poeticsequences}.
955 %You can also create new varieties of title. For instructions
956 % on how to do this, see section \ref{customizing titles} below, page \pageref{customizing titles}.
957 %
958 % \subsection{~The body of the poem}
959 %
960 % \subsubsection{The poem environment}
961 % \DescribeEnv{poem} The body of every poem should be placed in a
962 % |poem| environment. Putting the body of the poem between
963 % |\begin{poem}| and |\end{poem}| resets the line counter to 1,
964 % puts the poem in a modified |verse| environment (to handle run over lines
965 % automatically), and turns off automatic hyphenation with the |poem| environment.
966 %
967 % \DescribeEnv{pmclverse} \textsf{poemscol} slightly modifies the |verse|
968 % environment from the standard \LaTeX\ definition, increasing the
969 % indentation used for run over lines, in order to make the difference
970 % between the indented run over portion of a long line, on one hand,
971 % and an explicitly indented second line, on the other, more obvious in the output.
972 % \textsf{poemscol} also adds a little bit
973 % more white space between stanzas than the standard \LaTeX\ |verse|
974 % environment does. (I found that the standard stanza breaks did not
975 % leap out on the page as stanza breaks.)
976 % The verse environment for \textsf{poemscol} is |pmclverse|, defined
977 % below on page \pageref{versedefine}. You don't have to place poems explicitly in
978 % the |pmclverse| environment. The |poem| environment automatically opens (and closes)
979 % |pmclverse|.
980 %
981 % \subsubsection{Customizing the poem environment}
982 % \DescribeMacro{\versewidth}
983 % The |poem| environment uses an optional argument to center the verse block on a
984 % line of a given width. If your poem has
985 % short lines, and you wish to center it on the page, rather than set
986 % it against the left margin of the normal |poem| environment, you can
987 % give the width of the line you want to use to center the poem as the optional
988 % argument. To center a verse block 30 ems wide, for instance, issue
989 % |\begin{poem}[30em]|.
990 %
991 % \label{centeringtextblock}
992 % Rather than specifying the length explicitly, you can use the length
993 % |\versewidth| as the optional
994 % argument to |\begin{poem}|. You can set the length of |\versewidth| to the proper
995 % amount using |\settowidth| as follows:
996 % \begin{center} |\settowidth{\versewidth}{Text of line to use for centering}|. \end{center}
997 % Once you have set |\versewidth|
998 % to center the poem on a sample line, you use it to center the |poem| environment this way:
999 % \begin{center} |\begin{poem}[\versewidth]|.\end{center}
1000 % Notice that the optional argument is in square braces,
1001 % not in curly braces.
1002 %
1003 % If you are planning to align the poem title with the
1004 % left margin of the centered verse block you should use the |\versewidth| method
1005 % to center the verse block, since |\versewidth| is used to place the title in that case.
1006 % (You can just enter a length into the optional argument of |\begin{poem}|, but in that case,
1007 % if you are left-aligning the poem title, you should set |\versewidth| to that value
1008 % by issuing e.g. |\setlength{\versewidth}{30em}|.)
1009 %
1010 % \DescribeMacro{\linenumberscenteredwithverse}
1011 % If you want to center the verse on the page using the optional argument to |\begin{poem}|,
1012 % you probably also want
1013 % to move the line numbers in, so as to be closer to the line.
1014 % \textsf{poemscol} will do this by default. If you wish to leave the line
1015 % numbers at the margin, set the boolean |\linenumberscenteredwithverse| to
1016 % false. For centered verse, the distance between the line numbers and the
1017 % verse can be set by setting the length of |\marginparsepmin| (not
1018 % |\marginparsep|). The default
1019 % value of |\marginparsepmin| is 2 em.
1020 %
1021 % \begin{sloppypar}
1022 % \DescribeMacro{\centertitles}
1023 % \DescribeMacro{\ifcenterepigraphson}
1024 % If you center the poem on a sample
1025 % line, you probably also want to center the title of the poem too,
1026 % which you can do by issuing |\centertitles|.
1027 % (|\centertitles| invokes the title centeringscheme.) If you decide against centering the title,
1028 % you can either just remove or comment out the |\centertitles| command, or
1029 % switch a boolean by issuing |\centertitlesonfalse|. By default, |\centertitles|
1030 % also moves epigraphs, dedications, headnotes, and attributions toward the center.
1031 % To prevent this, issue |\centerepigraphsonfalse|. This boolean applies to the
1032 % regular |\epigraph|, |\headnote| and |\dedication| commands, not to the
1033 %single-line |\shortpoemepigraph|, |\shortpoemdedication| and |\shortpoemattribution| commands,
1034 %whose places are defined by the title scheme that is in force when they are issued.
1035 %\end{sloppypar}
1036 %
1037 % \DescribeMacro{\iftextcenteringturnedon} Suppose you have marked up many poems with
1038 % the optional second argument to |\begin{poem}|, which would cause the text
1039 % block to be centered on the longest line, but change your mind about
1040 % centering all the poems. You can turn off centering, without
1041 % erasing all of the second arguments, by issuing |\textcenteringturnedonfalse|.
1042 % You can turn on centering the text block again by issuing
1043 % |\textcenteringturnedontrue|.
1044 %
1045 % \DescribeMacro{\versemarginadjust}
1046 % If you don't want to center the verse block on the longest line, but do want
1047 % to adjust its horizontal placement, you can adjust the
1048 % placement of the verse block by changing the value of the
1049 % length |\versemarginadjust|. For most commonly used type sizes, setting
1050 % |\versemarginadjust| to 28pts will put the verse block at the left margin, aligned
1051 % with the page number.
1052 %
1053 % \subsubsection{Hyphenation is off in the poem environment}
1054 % \textsf{poemscol} turns off automatic hyphenation in poetry
1055 % environments. The idea here is that every hyphen in the printed
1056 % poem is authorial, obviating the need for you to compile a
1057 % hyphenated-lines list to distinguish between authorial hyphens and
1058 % hyphens you added for lineation purposes. Line-ending hyphens
1059 % should not be a feature of verse anyway, I think.
1060 %
1061 % You may wish to restore automatic hyphenation in poetry environments
1062 % for your own edition.
1063 % If you do so you must keep track of added hyphens yourself. This
1064 % list will be easy to compile, however, because only authorial
1065 % hyphens will appear in your source code. Automatically added
1066 % hyphens will appear only in the output. (You might even modify the
1067 % output routine so that automatically added hyphens have a different
1068 % look. That would be non-trivial, but Donald Knuth has an exercise
1069 % about doing just that in \emph{The \TeX book}.) To
1070 % restore automatic hyphenation, copy the definition of the |poem|
1071 % environment (below at page \pageref{poemdef}) and redefine the
1072 % environment using |\renewenvironment|, commenting out the line that reads
1073 % |\language=255|. Place the renewed definition of the environment in your preamble,
1074 % with |\makeatletter| before the renewed definition and |\makeatother| after it.
1075 % If you are restoring automatic hyphenation for a parallel-text
1076 % edition, be aware that |\startparalleltexts| also (defined below at
1077 % page \pageref{startparalleltexts}) redefines the |poem|
1078 % environment, so you will have to change |\startparalleltexts| using
1079 % |\renewcommand| as well.
1080 %
1081 % \textsf{poemscol}
1082 % turns automatic hyphenation back on in prose contexts, so if you
1083 % wish to keep a hyphenation list for such things as authorial
1084 % prefaces and so on, you must do so yourself manually.
1085 % (Alternatively, you can turn automatic hyphenation off in those
1086 % contexts as well, by setting the |\language| to 255. For an example
1087 % of how to do this, look at the definition of the |poem| environment
1088 % in the implementation section below. If you do turn automatic
1089 % hyphenation off, it would be wise to restrict the change to some
1090 % particular environment, rather than changing the |\language|
1091 % globally. You might wish, for instance, to turn automatic
1092 % hyphenation off in the |prosesection| environment.)
1093 %
1094 % \subsubsection{The stanza environment}
1095 % \DescribeEnv{stanza} Every stanza should be placed in its own stanza
1096 % environment. Every poem should have at least one stanza. Marking
1097 % the beginning and end of every stanza (with |\begin{stanza}| and
1098 % |\end{stanza}|) provides \textsf{poemscol} with a way of detecting
1099 % cases in which a page boundary falls on a stanza break, since in
1100 % those cases a page turn happens when one is \emph{inside} a poem
1101 % environment but \emph{not} inside a stanza environment. Further,
1102 % marking the beginning and end of every stanza makes the logical
1103 % structure of the poem (and the editor's intentions about it) clear
1104 % to readers of your source code. If you want to change the |stanza| environment
1105 % consult its definition below at page \pageref{stanzadefine}.
1106 %
1107 % \DescribeMacro{indentedverse} To indent stanzas (or stretches of verse) relative to the margin
1108 % you can use the |indentedverse| environment.
1109 % You can also
1110 % set different stanzas or passages at a hierarchy of levels of indentation.
1111 % (For how to do this, see section \ref{indentedverse} below, page \pageref{indentedverse}.)
1112 %
1113 % \DescribeMacro{\stanzaatbottom}
1114 % \DescribeMacro{\nostanzaatbottom}
1115 % If you wish to change the symbol used to mark cases in which a
1116 % break falls on a page turn, issue the command |\stanzaatbottom|,
1117 % using as the argument whatever you wish to use to mark such cases.
1118 % The default is |\stanzaatbottom{*}|, which is suitable for a published volume. If you
1119 % are preparing a typescript for submission, you may wish to set
1120 % |\stanzaatbottom| to ``stanza break.''
1121 %
1122 % If you wish also to mark all cases where there is \emph{not} a stanza break
1123 % at the bottom of the page, issue the command |\nostanzaatbottom|,
1124 % using as the argument whatever you wish to mark such cases. The
1125 % default is |\relax| (which is to say, ``don't do anything'').
1126 %
1127 % \subsubsection{Verse lines and line numbering}
1128 % \DescribeMacro{\verseline} |\verseline| should mark the end of every
1129 % line, except the last line of every stanza (which should be marked
1130 % with |\end{stanza}|). |\verseline| marks the end of every line as a
1131 % prosodic unit (since a line of verse is not simply a carriage
1132 % return), and advances the line counter. There are commands below
1133 % for changing the line counter's horizontal placement (how close it
1134 % is to the left or right margin of the line) and appearance. (See
1135 % section \ref{marginalgeometry} for these.)
1136 %
1137 %
1138 % \DescribeMacro{\setverselinemodulo} |\setverselinemodulo| sets how
1139 % often a marginal line number appears. To print a line number every
1140 % five lines, issue |\setverselinemodulo{5}|. The default value is
1141 % 10.
1142 %
1143 %
1144 % \DescribeMacro{\makeverselinenumbers}
1145 % Marginal verse line numbering is on by default. To turn line
1146 % numbering off, issue |\global\verselinenumbersfalse|. To turn it
1147 % back on, issue |\makeverselinenumbers|.
1148 %
1149 % \begin{sloppypar}
1150 % \DescribeMacro{\verselinenumberstoright}
1151 % \DescribeMacro{\verselinenumberstoleft}
1152 % To put all of the line numbers to the left, issue |\verselinenumberstoleft| in
1153 % your preamble. |\verselinenumberstoright| puts the line numbers in the right
1154 % margin. (These two commands use non-floating marginal note commands derived
1155 % from the \textsf{memoir} class, |\pmclleftsidepar| and |\pmclrightsidepar|,
1156 % respectively.)
1157 % \end{sloppypar}
1158 %
1159 % \DescribeMacro{\verselinenumbersouter}
1160 % \DescribeMacro{\verselinenumbersgutter}
1161 % If you wish the line numbers to appear in the outer margins of each two-page spread, issue
1162 % |\verselinenumbersouter| in your preamble. If you want the line numbers to
1163 % appear in the inner margins, issue |\verselinenumbersgutter| in your preamble.
1164 % (These two commands use |\pmclsidepar|, derived from |\sidepar| from the
1165 % \textsf{memoir} class, but modified by Dan Leucking.)
1166 %
1167 % \begin{sloppypar}
1168 % \DescribeMacro{\marginparsep}
1169 % You can adjust the
1170 % distance between the marginal line number and the text with
1171 % |\setlength{\marginparsep}{your length}|. The default value for |\marginparsep| is 18pt,
1172 % and the default value for the width of the box in which the line numbers are
1173 % set, |\marginparwidth|, is 18 pt. If you are setting with the line numbers to
1174 % the right, |\marginparwidth| can be as small as you wish, although your log
1175 % file will be full of complaints if you make it too small. But if you are
1176 % setting with the line numbers to the left, if |\marginparwidth| is narrower
1177 % than the width of the line number, the line number will be moved down a line.
1178 % Setting |\marginparsep| to zero lines the verse line numbers up with the page
1179 % numbers, and puts both at the margin. If you move the verse line numbers by
1180 % changing |\marginparsep|, you can move the page numbers to keep them aligned
1181 % by changing |\headoffsetlength| to the same value.
1182 % \end{sloppypar}
1183 %
1184 % \DescribeMacro{\marginparsepmin}
1185 % If the verse block is centered on the longest line, the distance between the line numbers and the
1186 % verse can be set by setting the length of |\marginparsepmin| (not
1187 % |\marginparsep|). The default
1188 % value of |\marginparsepmin| is 2em.
1189 %
1190 % \DescribeMacro{\pmclsideparvshift}
1191 % The line numbers should print on the baseline. You can adjust them
1192 % to move them up or down by changing the value of a length called
1193 % |\pmclsideparvshift|. The default value is
1194 % |\setlength{\pmclsideparvshift}{0ex}|.
1195 %
1196 % \subsection{~Special line markup}
1197 % \subsubsection{Indentation, line breaks, runover, and broken lines}
1198 % \begin{sloppypar}
1199 % \DescribeMacro{\verseindent} The |\verseindent| command is to be
1200 % used for formally indented lines. It should not be used to indent
1201 % the run over portion of long lines (which \textsf{poemscol} handles
1202 % automatically anyway). |\verseindent| indents the line a bit less
1203 % than the run over portion of long ``bent'' lines are indented, so
1204 % that the two cases can be visually distinguished. By default, the
1205 % length of |\verseindent| is 2 em. To change it, say to 3 em, you should change
1206 % the length |\verseindentamount| by
1207 % issuing |\setlength{\verseindentamount}{3em}|.\end{sloppypar}\goodbreak
1208 %
1209 % You can create a hierarchy of indentations by issuing |\verseindent|
1210 % multiple times. But you can also use an optional argument to |\verseindent|, with
1211 % the number indicating how many levels of indentation to add to this line, like so
1212 % |\verseindent[3]| for the third level of indentation, (with each level being one |\verseindent|
1213 % deep). If you use this option, don't put any white space between the end of the
1214 % |\verseindent| command and the beginning of the poetic text, otherwise
1215 % poemscol will add about 10pt of unwanted extra white space. (The only real
1216 % consequence of forgetting about this will be that |\verseindent[1]| will be about
1217 % 10pts deeper than plain |\verseindent|, which may not really be an issue for you.)
1218 %
1219 % \begin{sloppypar}
1220 % \DescribeMacro{indentedverse} \label{indentedverse} You might want to indent whole stanzas,
1221 % or perhaps extended passages of verse, relative to the rest of the poem (you might,
1222 % for instance, want to indent refrains systematically). This would be tedious to
1223 % do using |\verseindent|. Put stretches of
1224 % verse you wish to indent in the |indentedverse| environment. Whatever is
1225 % in this environment will be indented. The indentation will be of the length
1226 % |\indentedstanzaamount|, which is by default set to |\verseindentamount|,
1227 % which by default is 2 em. You can change |\indentedstanzaamount| to 3em, by issuing
1228 % |\setlength{\indentedstanzaamount}{3em}|.
1229 %
1230 % You can also set a hierarchy of intended stanzas
1231 % or passages by issuing an optional argument to |\begin{indentedverse}|. So, for instance,
1232 % |\begin{indentedverse}[2]| will indent that environment by two |\indentedstanzaamount|s
1233 % (4 em), and |\begin{indentedverse}[3]| will indent that environment by three
1234 % |\indentedstanzaamount|s, or 6 em. Note that if you use the optional argument, you
1235 % must enclose it in square brackets, not curly ones. Note also that (for reasons
1236 % I have not been able to track down) |\indentedverse[1]| indents the stanza
1237 % slightly more deeply than plain |\indentedverse|. To preserve a
1238 % consistent look for a hierarchy of indented stanzas, use |\indentedverse[1]| for the
1239 % lowest level of indentation, not plain |\indentedverse|. \end{sloppypar}
1240 %
1241 % \DescribeMacro{\linebend} \textsf{poemscol} automatically runs over
1242 % long lines, indenting the run over portion on the next physical
1243 % line. If you are unhappy with where \textsf{poemscol} has run over
1244 % a particular line, you can ``bend'' that line by issuing |\linebend|
1245 % at the point where you wish it to run over. The run over portion of
1246 % the line will be indented just as if \textsf{poemscol} had ``bent''
1247 % the line at your selected point. This command only works if you
1248 % have chosen to bend the line at some point earlier than
1249 % \textsf{poemscol} would have chosen on its own.
1250 %
1251 % You may also wish to use |\linebend| to reproduce how your author
1252 % broke up long lines on the page (if you know that your author cared
1253 % about such things and did not leave them up to the typesetter).
1254 %
1255 % |\linebend| should only be used for managing run over lines, not for
1256 % cases in which a line is to be broken into separate half-lines. For
1257 % cases in which a line is to be broken into half-lines, use the
1258 % |\brokenline| command. The two commands do similar (but not identical)
1259 % things. But a ``linebend'' is a feature of typesetting, and a
1260 % ``broken line'' is a feature of versification, and it seems best to
1261 % distinguish them logically. (|\linebend|, like |\brokenline|, issues
1262 % a carriage return without incrementing the line number, but
1263 % |\linebend| adds indentation to the next line.)
1264 %
1265 % If you
1266 % want to extend a line further into the right margin, beyond the normal break point, you can
1267 % probably do so by using a combination of |\nobreak| and |\hbox|,
1268 % or by turning all of the spaces in that line into unbreakable
1269 % spaces, marked with |~| in your source. But \textsf{poemscol} will
1270 % complain if you do this, and rightly so, since the result is likely
1271 % to be ugly. It would probably be wiser to adjust the lengths |\leftmargin|
1272 % and |\rightmargin| in the definition of the |pmclverse| environment,
1273 % allowing all of the lines to be a little bit longer. The |pmclverse| environment
1274 % is defined below, at section \ref{versedefine}, page \pageref{versedefine}.
1275 %
1276 % \DescribeMacro{\runoverindent} To change the indentation for the run
1277 % over portion of verse lines globally, issue the amount of
1278 % indentation you desire as the argument to |\runoverindent|.
1279 % |\runoverindent| is currently set to 6 em, rather more than the
1280 % standard amount in the definition of the \LaTeX\ |verse|
1281 % environment. By default, the runover portion of long lines is
1282 % indented. You may wish to flush the runover portion to the right
1283 % margin instead. For instructions about how to do this, see section
1284 % \ref{rightflushverse}, page \pageref{rightflushverse}.
1285 %
1286 % \DescribeMacro{\brokenline}
1287 % \DescribeMacro{\versephantom}|\brokenline| should be used where you
1288 % wish to break the line without incrementing the line counter.
1289 % Authors often break a line into two half-lines, setting the
1290 % beginning of the second half-line flush with the end of the first
1291 % half-line. (Sometimes these broken lines indicate a change of
1292 % speaker. Sometimes they just indicate a change of subject, usually
1293 % an abrupt one, a change which calls attention to itself by
1294 % interrupting a line rather than waiting for a line break or stanza
1295 % break). |\brokenline| is normally used with |\versephantom|,
1296 % which adds white space exactly as long as its argument would have
1297 % been had it been set in type. |\versephantom| thus provides an easy
1298 % way of setting the beginning of the second half-line flush with the
1299 % end of the first, whatever the font size or special formatting of the
1300 % first line.
1301 %
1302 %
1303 % The sestet of Yeats's sonnet ``Leda and the Swan,'' has such a broken
1304 % line:
1305 % \begin{verse}
1306 % A shudder in the loins engenders there\\
1307 % The broken wall, the burning roof and tower\\
1308 % And Agamemnon dead.\\
1309 % $\phantom{And Agamemnon dead.~}$ Being so caught up,\\
1310 % So mastered by the brute blood of the air,\\
1311 % Did she put on his knowledge with his power\\
1312 % Before the indifferent beak could let her drop?\end{verse}
1313 %
1314 % To set the broken line properly, issue:
1315 % \begin{verse}
1316 % And Agamemnon dead.|\brokenline|\\
1317 % |\versephantom{And Agamemnon dead.}| Being so caught up,|\verseline|
1318 % \end{verse}
1319 %
1320 % \DescribeMacro{\stanzalinestraddle}
1321 % Some poets (such as Robert Penn Warren) occasionally introduce a
1322 % stanza break in the middle of a broken line, considering the line to
1323 % be a single metrical unit despite the fact that it straddles a stanza
1324 % break. To record these cases, mark the end of the first half-line
1325 % with |\end{stanza}| as usual. But instead of opening the next stanza
1326 % with |\begin{stanza}| issue |\stanzalinestraddle| instead. This will
1327 % make sure that the line counter counts the straddling line as only one
1328 % line, despite the stanza break. |\stanzalinestraddle| is usually used
1329 % with |\versephantom|.
1330 %
1331 % \subsubsection{Customizing broken lines}
1332 % \DescribeMacro{\tweakbrokenline}
1333 % By default, \textsf{poemscol} sets the line numbers level with the
1334 % ends of broken lines. If the line numbers are set to the right of
1335 % the text, this seems the obvious choice. Conceivably you might want
1336 % to set the line number level with the beginning of a broken line
1337 % when the line numbers are set to the left. To ensure that the line
1338 % numbers of broken lines are set level with the beginning of a
1339 % broken line when the line number is on the left, issue
1340 % |\tweakbrokenline| in your preamble.
1341 %
1342 % You should issue |\tweakbrokenline| with caution, because although
1343 % it changes how |\brokenline| is handled, it does not change the
1344 % handling of long lines with runover. Runover lines will still set
1345 % the line number level with the end of the line. You can have
1346 % runover lines set their line number level with the beginning of the
1347 % line by issuing |\startverseline| at the beginning of the line.
1348 %
1349 % \DescribeMacro{\brokenlineatbeginning} Conceivably you might want
1350 % |\brokenline| to set the line number level with the beginning of
1351 % the line in every case. To do this, issue |\brokenlineatbeginning|
1352 % in your preamble. If you do this, you should be prepared to mark
1353 % the beginning of runover lines with |\startverseline|.
1354 %
1355 % \DescribeMacro{\startverseline}
1356 % If you begin a verse line with |\startverseline| the line number
1357 % will be set level with the beginning of the line rather than with
1358 % the end. This is useful, for instance, if you want to ensure that
1359 % the line number of a line with runover is set level with the
1360 % beginning of the line. You can, if you don't want to keep track of
1361 % where runover lines are, start every line with |\startverseline|.
1362 %
1363 % \DescribeMacro{\tweakstartverseline}
1364 % Rather than setting the line number of every runover line level with
1365 % the beginning of the line, it may make more sense for you to set the
1366 % line number level with the beginning in cases where the line number
1367 % is to the left, and level with the end in cases where the line
1368 % number is to the right. You might want to do this, for instance, if
1369 % you have decided to set all the verse lines at the outer margin (by
1370 % issuing |\verselinenumbersouter| in your preamble), or have decided to
1371 % set all the verse lines at the inner margin (by issuing
1372 % |\verselinenumbersgutter| in your preamble). To ensure that
1373 % |\startverseline| does this, issue |\tweakstartverseline| in your
1374 % preamble.
1375 %
1376 % \subsubsection{Right-flushed runover lines}
1377 % \DescribeEnv{rightflushverse}
1378 % \DescribeMacro{\rightversebegin}\label{rightflushverse} By default,
1379 % \textsf{poemscol} indents the runover portion of long lines by the
1380 % amount |\runoverindent| (by default 6 em). It is possible to set
1381 % verse so that the runover portion is flushed to the right margin.
1382 % To do this, you should put the |\rightflushverse| environment inside
1383 % the |\poem| environment. And you must mark the beginning of each
1384 % verse line with |\rightversebegin|. Christian Ebert has reminded me
1385 % that the |\rightflushverse| environment must be issued \emph{inside}
1386 % the poem environment. Otherwise it simply flushes every line to the
1387 % right.
1388 %
1389 % It is rather clumsy to need a special environment for verse with
1390 % right flushed runover. I plan to provide a command for switching
1391 % between a verse environment that indents runover lines and a verse
1392 % environment that flushes runover lines to the right. I have seen
1393 % examples of this kind of environment from Markus Kohm and Christian
1394 % Ebert, but so far I haven't been able to persuade them to play well with \textsf{poemscol}
1395 %
1396 % \subsection{Cross references by line number}
1397 % \DescribeMacro{\poemlinelabel} \label{poemlinelabel}
1398 % |\poemlinelabel| enables crossreferences by line number. To make
1399 % a line label, issue |\poemlinelabel{text of label}| right after the
1400 % line to which you wish to refer, where ``text of label'' is some
1401 % distinctive label you can use for a reference elsewhere. (You
1402 % should issue the command \emph{after} the |\verseline| or
1403 % |\end{stanza}| command, to make sure that the line number will be
1404 % correct.) To produce the reference, just issue |\ref{text of label}| as usual.
1405 % (|\poemlinelabel| is just a crudely hacked
1406 % version of |\label| from \LaTeX.) |\pageref{text of label}| will set
1407 % the page number of the page on which the label appears.
1408 %
1409 % \section{Making a table of contents}
1410 % \subsection{~Setup}
1411 % \DescribeMacro{\makepoemcontents}
1412 % I found the normal \LaTeX\ commands for making tables of contents for scholarly works
1413 % unsuited for making tables of contents of poetry, so I have provided my own. To make a table of
1414 % contents for your poems, issue |\makepoemcontents|.
1415 %
1416 % |\makepoemcontents| takes an optional argument, which
1417 % sets the page number for the table of contents. If your publisher
1418 % wishes to add some front matter so that the contents will appear on
1419 % page vii, you should issue |\makepoemcontents[7]|.
1420 %
1421 % It might seem
1422 % as though you would want to issue this command in your preamble. In
1423 % fact it is better to issue it in the body of the document,
1424 % immediately \emph{after} issuing the |\putpoemcontents|, the command which
1425 % inputs and typesets a table of contents from a prior run. If you issue |\makepoemcontents|
1426 % before issuing |\putpoemcontents|, you will simply erase the table of contents
1427 % from the prior run (the one which will have all the contents information you
1428 % are intending to use) and enter an empty table of contents into your document.
1429 %
1430 % \subsection{~Printing the table of contents}
1431 % \DescribeMacro{\putpoemcontents}\label{putpoemcontents}
1432 % Information for your table of contents will be written to an
1433 % external file with the extension .ctn. |\makepoemcontents| creates this file, and
1434 % opens an output channel to send information to it. |\putpoemcontents| closes
1435 % the file and reads it into your document.
1436 %
1437 % You will need to run your
1438 % book through \LaTeX\ twice in order to generate a table of contents,
1439 % the first time to generate the titles and the references for the page numbers, and the second
1440 % time to use the labels to which the references point
1441 % to enter the page numbers. (Under some circumstances --- if
1442 % you have an index, for instance --- you may need three passes rather
1443 % than two.)
1444 %
1445 % \DescribeMacro{\resetpagestyle}
1446 % Because the
1447 % table of contents uses a special page style and special fonts
1448 % |\putpoemcontents| issues |\resetpagestyle|,
1449 % which restores the default fancy page style to ``main'' once it has
1450 % input the contents, and restores the font size to |\normalsize| as well.
1451 %
1452 % \DescribeMacro{\pagenumbering}
1453 % Be sure to
1454 % reset the style of page numbering (from |\pagenumbering{roman}| to
1455 % |\pagenumbering{arabic}|) after issuing |\putpoemcontents|, since
1456 % when you read in the external file created by |\makepoemcontents|
1457 % the page numbering will be set to roman numerals. The command
1458 % |\resetpagestyle| (which is called by |\putpoemcontents|) will reset
1459 % the fancy page style to that used in the main body of the volume,
1460 % but it won't change the page numbering to arabic, in case there is
1461 % some frontmatter between the contents and the main text, so you
1462 % should be sure to do so yourself. (Front matter is normally given page numbers
1463 % in roman numerals.) If you neglect to issue
1464 % |\pagenumbering{arabic}| at the end of your front matter, the
1465 % page numbering will remain in roman numerals. The notes sections
1466 % use the page numbers from the poem to construct running headers of
1467 % the form ``Notes to pp.~xx--yy.'' If those numbers are roman
1468 % numerals rather than arabic ones, \textsf{poemscol} will not
1469 % recognize them as numbers, and you will get the infamous ``Missing
1470 % Number'' error that puzzles so many users of \LaTeX.
1471 %
1472 % \subsection{~Contents entries for notes sections and the index}
1473 %
1474 % \begin{sloppypar}\DescribeMacro{\puttextnotes}
1475 % \DescribeMacro{\putemendations}
1476 % \DescribeMacro{\putexplanatory}
1477 % |\puttextnotes|, and its siblings |\putemendations| and
1478 % |\putexplanatory|, input the formatted endnotes
1479 % sections into your document, and put entries for them into your table of contents.
1480 % You will have to run \LaTeX\ again to set the page numbers of those sections
1481 % in the
1482 % table of contents properly. The first run sets the title of the endnotes section and a label to find the
1483 % page number to add to the table of contents, and the second run
1484 % actually sets page number. (These commands are described
1485 % below, in section \ref{putexternalfiles}.) All of these commands
1486 % also restore normal hyphenation for the endnotes sections. \end{sloppypar}
1487 %
1488 % \DescribeMacro{\putpoemindex}
1489 % |\putpoemindex| inputs the formatted index (after your raw entries have been
1490 % processed by MakeIndex), and adds an entry
1491 % for it into the table of contents.
1492 % Remember that if you are making an index of titles and first lines
1493 % you may need to run your file through \LaTeX\ twice more after running
1494 % MakeIndex, to put the entry for the index and its correct page number into your table of
1495 % contents.
1496 %
1497 % \DescribeMacro{\putmultiplepoemindex}
1498 % Use |\putmultiplepoemindex| instead if
1499 % you are making several indices. For instructions about
1500 % |\putmultiplepoemindex| see section \ref{multipleindex},
1501 % p.~\pageref{multipleindex}.
1502 %
1503 % \subsection{~Customizing contents entries}
1504 % Lines in the table of contents usually include an indent (how
1505 % much of one depends upon what the entry is --- whether it is a
1506 % volume title, a poem title, or something else), then the title
1507 % itself. If the entry is for a poem, for a section of a poem, for a poetic sequence, or for
1508 % a section or subsection of a poetic sequence, a slash follows the title, followed
1509 % by the page number.
1510 % All of the commands that generate lines in the table of contents are
1511 % somewhat messy and somewhat rigid, but you can modify them if you
1512 % wish. Here are some ways of customizing contents
1513 % entries, in increasing order of difficulty.
1514 %
1515 %\DescribeMacro{\setcontentsleaders} By default the title and the page
1516 % are separated by a slash (actually by |~/~|). If you wish to change
1517 % this, say to put dot leaders in instead, issue what you wish to use
1518 % as the argument to |\setcontentsleaders|. For instance
1519 % |\setcontentsleaders{\poemdotfill}| will flush the number to
1520 % the right margin, and insert leading dots up to the number.
1521 % The argument to |\setcontentsleaders| can be whatever you wish
1522 % to use to separate the title from the page number, such as a colon,
1523 % a hard space (|~|), or even |\hfil| to flush the page number to the right margin.
1524 %
1525 % \DescribeMacro{\contentspoemtitlefont}
1526 % You can change the font sizes that are used to set particular classes of title
1527 % in the contents by redefining the commands that are used to set the font size
1528 % for that kind of title. For instance, if you wanted to set the titles of all
1529 % poems in 12 point type on 14.5 point leading, issue \begin{verbatim}
1530 % \renewcommand{\contentspoemtitlefont}{\fontsize{12}{14.5}\selectfont}
1531 % \end{verbatim}
1532 % in your preamble. You can find a list of the various relevant font size commands
1533 % below at section \ref{internal font size commands}, page \pageref{internal font size commands}.
1534 %
1535 % \DescribeMacro{\contentsindentoneamount}
1536 % You can also change the amount of the indentations used in the hierarchy of indentations
1537 % in the table of contents by changing the value of the elements of
1538 % that hierarchy. You can change ``contentsindentoneamount''
1539 % (the amount a poem title is normally indented, by default 24pt) to,
1540 % say, 36pt, by issuing |\contentsindentoneamount=36pt| in your preamble. You
1541 % can find all of the values in the contents indentation hierarchy at section
1542 % \ref{contents indentation hierarchy}, page \pageref{contents indentation hierarchy}.
1543 %
1544 % \DescribeMacro{\pmclcontentsentry} There is a simple way of adding a new contents
1545 % entry using the command |\pmclcontentsentry|. The command creates an entry on the model
1546 % of the entry for the textual notes section. It takes three arguments. The first is the title of
1547 % the section. The second is the indentation of the entry (typically |\contentsindentone|
1548 % |\contentsindenttwo|, or |\contentsindentthree|, but any indentation command will do).
1549 % The third is the page number.
1550 % Remember that |\contentsindentone| is a command, not a length. The length of
1551 % the indentation is |\contentsindentoneamount|.
1552 % The command is defined as |\hspace{contentsindentoneamount}|.
1553 % You can suppress the page number by setting the boolean |\putpagenumbersincontentsfalse|.
1554 %
1555 % A more general way to add a entry in the table
1556 % of contents is to use the command |\pmclecontentsentrydefaults|. This command takes
1557 % four arguments: (1) The title (2) the indentation command (3) the font size (e.g. |\contentendnotesfont| for the
1558 % same font size used in contents entries for the endnotes sections) and (4) the page number. Here
1559 % also you can suppress the page number by setting the boolean |\putpagenumbersincontentsfalse|.
1560 %
1561 % \DescribeMacro{\setlength} To change the amount various kinds of title are indented in the Table
1562 % of Contents, see below at section \ref{contentsindentations}, page \pageref{contentsindentations}.
1563 %
1564 % \DescribeMacro{\renewcommand}
1565 % You can also make global changes to the appearance of a particular kind of contents entry. To
1566 % change the appearance of a kind of entry (for all sections of
1567 % sequences of poems, for instance), go to the definition of the title
1568 % of that kind of entry (e.g.\ |\sequencesectiontitle|) below,
1569 % and copy the definition into a |\renewcommand| for that kind of title;
1570 % find where that command calls the
1571 % |\c@ntentsinfo| command, and change the arguments
1572 % to that command to suit you. (You should consult section \ref{customizing titles}, page
1573 % \pageref{customizing titles}, to see what all of the arguments to |\c@ontentsinfo| do.)
1574 % Put the whole renewed version of the title command into your preamble, being
1575 % sure to issue |\makeatletter| before the |\renewcommand| and to issue
1576 % |\makeatother| after it.
1577 % (You have to put this whole |\renewcommand| between |\makeatletter| and |\makeatother| because
1578 % |\c@ntentsinfo| and several other commands called to set titles include
1579 %the |@| character, which you can't use in command names
1580 % except in the .sty file. Internal commands like |\c@ntentsinfo|, which are used by
1581 % other commands but are under most circumstances not meant to be invoked
1582 % by users directly, have an |@| in their names so that the user won't accidentally
1583 % redefine them.)
1584 % You can find the commands for making titles below at
1585 % section \ref{poemtitlecode}, page \pageref{poemtitlecode}.
1586 %
1587 % Here, for instance, is the code that defines titles for sections of poetic sequences:
1588 % \begin{verbatim}
1589 % \newcommand{\sequencesectiontitle}[1]{%
1590 % \set@p@emtitle{#1}{\poemtitlepenalty}{\poemtitlefont}
1591 % {\titleindent}{\nobreak\par\nobreak\afterpoemtitleskip\nobreak}
1592 % {\titleindentamount}
1593 % \c@ntentsinfo{#1}{\contentsindenttwo}{\contentspoemtitlefont}
1594 % {\contentsindentthreeamount}
1595 % \t@xtnotesinfo{#1}}
1596 % \end{verbatim}
1597 % Notice in the above that entries for sequence sections in the table
1598 % of contents are given the indentation
1599 % |\contentsindenttwo|. To give them the indentation |\contentsindentthree|
1600 % and to set the runover portion of long titles with the indentation |\contentsindentfour| put this in
1601 % your preamble:
1602 % \begin{verbatim}
1603 % \makeatletter
1604 % \renewcommand{\sequencesectiontitle}[1]{%
1605 % \set@p@emtitle{#1}{\poemtitlepenalty}{\poemtitlefont}
1606 % {\titleindent}{\nobreak\par\nobreak\afterpoemtitleskip\nobreak}
1607 % {\titleindentamount}
1608 % \c@ntentsinfo{#1}{\poemsectiontitleindent}{\contentspoemtitlefont}
1609 % {\contentsindentfouramount}
1610 % \t@xtnotesinfo{#1}}
1611 % \makeatother
1612 % \end{verbatim}
1613 %
1614 % \DescribeMacro{\c@ntentsinfo}
1615 % You can make even more sweeping and fundmental changes in the look of your
1616 % table of contents by redefining the |\c@ntentsinfo| command itself, which can be found
1617 % below at section \ref{poemtitlecode}. Think very hard about this before doing it.
1618 %
1619 % \section{Making an index of titles and first lines}
1620 % \subsection{~Setup}
1621 % \DescribeMacro{\indexingontrue} First you must add the \textsf{makeidx} package
1622 % to the list of packages you call in your preamble. (If you are planning to set several
1623 % indices, call \textsf{splitindex} instead.) Then, to set up the Index section of your
1624 % volume, issue |\indexingontrue| in your preamble. This will create
1625 % the external file for your index information and send that file the
1626 % typesetting information for its title. You must process this
1627 % external file (the .idx file) with MakeIndex to create a properly organized and
1628 % formatted index. MakeIndex sorts the various multi-level ``index
1629 % cards'' generated by all of the |\index| commands in your source
1630 % files.
1631 %
1632 % \subsection{~Printing the index}
1633 % \DescribeMacro{\putpoemindex}
1634 %Once you have processed your .idx file with MakeIndex, and
1635 % generated the sorted and formatted .ind file for your book, the
1636 % |\putpoemindex| command will insert the typeset index where you
1637 % issue it, and put an entry for your index in your table of contents.
1638 % You will have to run your file through \LaTeX\ twice again to make the
1639 % page number for that entry correct.
1640 %
1641 % \textsf{poemscol} sets up a two-column index with a simple running
1642 % header. (Setting up a two-column index, however, requires that you
1643 % include the \textsf{multicol} package in your |\usepackage| list.)
1644 % To turn indexing off, issue |\global\indexingonfalse|.
1645 %
1646 % Enter the individual index entries in the poems as you normally
1647 % would for use by MakeIndex (say, after each title and first line). One of
1648 % the nice features of MakeIndex is that every entry has two parts,
1649 % one for specifying the sort key of the entry (or subentry), the other
1650 % for specifying the font and typesetting information of the entry (or
1651 % subentry). This enables you to drop all of the initial uses of
1652 % ``the'' in titles for sorting purposes, while still including the
1653 % ``the'' in the title. It also enables you to distinguish titles
1654 % from first lines (by italicizing them), and to include typesetting
1655 % information (such as italicization) in titles or first lines without
1656 % messing up their sort order.
1657 %
1658 % \subsection{~Making multiple indices}\label{multipleindex}
1659 % \textsf{poemscol} can work with \textsf{splitindex} to generate
1660 % more than one index. You might, for instance, wish a separate index
1661 % of titles and index of first lines, or an index of proper names. To
1662 % do this, call \textsf{splitindex} in your list of packages. Then,
1663 % in your preamble, declare the indices you are planning to use, e.g.:
1664 % \begin{verbatim}
1665 % \newindex[Index of Titles]{idx}
1666 % \newindex[Index of First Lines]{fir}
1667 % \newindex[Onomastic Index]{ono}
1668 % \end{verbatim}The second argument is the
1669 % ``shortcut'' defined by \textsf{splitindex}, and will be used to
1670 % mark index entries in your text (see below), and used also as the extension
1671 % for the external index files used by MakeIndex.
1672 %
1673 % Then mark up individual entries. Some entries (in the example
1674 % above, the ``Index of Titles'' examples) can be marked up with
1675 % |\index| just as if you were using only one index. Entries for
1676 % other indices should be marked using the |\sindex| command from
1677 % \textsf{splitindex}, as follows
1678 % \begin{verbatim}
1679 % \sindex[fir]{Of Man's first disobedience and the fruit}
1680 % \end{verbatim}
1681 % where the
1682 % first argument is the ``shortcut'' and the second is the index
1683 % entry. If you are loading \textsf{splitindex} with the
1684 % \textsf{split} option, the different types of index entry will be
1685 % sent to separate output streams, which each must be processed separately
1686 % with MakeIndex. \TeX\ has only a limited number of such output
1687 % streams, however, so it is probably wiser not to choose that
1688 % option, but to use splitindex.tex, splitindex.pl, or one of the
1689 % other means provided with the \textsf{splitindex} package to break
1690 % up the index into the separate parts, each of which must be
1691 % processed with MakeIndex separately.
1692 %
1693 % To include the indices, and to add entries for them to the table of
1694 % contents, issue |\putmultiplepoemindex| for each one.
1695 % |\putmultiplepoemindex| takes four arguments, which are: 1.\ The
1696 % three letter ``shortcut'' used by |\splitindex|, 2.\ The title of
1697 % the Index on its first page, 3.\ The running header for that index
1698 % section, and 4.\ The name of the section as you wish it to appear in
1699 % the Table of Contents. So, for instance
1700 % \begin{verbatim}
1701 % \putmultiplepoemindex{fir}{INDEX OF FIRST LINES}{Index of First
1702 % Lines}{First Line Index} \end{verbatim}
1703 % includes an index with shortcut ``fir,'' title ``INDEX OF FIRST
1704 % LINES,'' running header ``Index of First Lines,'' and contents
1705 % entry ``First Line Index.''
1706 % \section{Collections with multiple volumes}
1707 % \DescribeEnv{volumetitlepage} \DescribeEnv{maintitlepage}
1708 % The |volumetitlepage| environment is an
1709 % environment for divider pages in collections made up of several
1710 % volumes. Volume title pages will always appear on recto pages with blank verso pages.
1711 % \textsf{poemscol} will also automatically create a blank verso page
1712 % preceding the volume title page if it is necessary. The
1713 % |maintitlepage| environment is for the title page of the whole
1714 % book. The main title page will also automatically always be on a
1715 % recto page. These divider pages have special
1716 % page styles, with no page numbers and no running headers.
1717 %
1718 % \begin{sloppypar}
1719 % \DescribeMacro{\wholebooktitle} \DescribeMacro{\volumetitle}
1720 % |\wholebooktitle| is for the title of the entire collection.
1721 % |\volumetitle| is for the title of an individual volume within a
1722 % Collected Poems. |\wholebooktitle|
1723 % merely sets its argument in a very large font. |\volumetitle| also sets an entry
1724 % in the table of contents (with no page number, but followed by extra
1725 % vertical space) and in the endnotes (with
1726 % no page number).
1727 %
1728 % \DescribeMacro{\volumetitlefirstline}
1729 % \DescribeMacro{\volumetitlemiddleline}
1730 % \DescribeMacro{\volumetitlelastline}
1731 % \DescribeMacro{\volumesubtitle}
1732 % The |\volumetitlefirstline|,
1733 % |\volumetitlemiddleline|, and |\volumetitlelastline| commands are
1734 % for multi-line titles of volumes gathered into the collection. (Use
1735 % these last commands if you want to specify how a long title is
1736 % broken up both in the text and in the table of contents.
1737 % \textsf{poemscol} will break up long titles on its own anyway
1738 % if you don't specify how to break them up, but
1739 % you might not be happy with how it breaks up the lines.)
1740 % |\volumesubtitle| is for setting the subtitle to a volume.
1741 % In addition to setting the text in the body of your
1742 % edition, these commands send the title (and the formatting
1743 % information about it) to the table of contents file and to the
1744 % various endnotes files.\end{sloppypar}
1745 %
1746 % \DescribeMacro{\volumesectiontitle}
1747 % |\volumesectiontitle| is for setting the title of a section of a
1748 % volume. |\volumesectiontitle| merely prints the title in a large font in boldface
1749 % in the text. It always prints at the top of a page, but it does not ensure that that
1750 % page is a recto page, does not reserve the whole
1751 % page for the title, or put a blank verso page following the title. It prints the title
1752 % in the contents without a page number, and prints the title in the textual notes
1753 % (but not in the other endnote sections) in boldface on a separate line.
1754 % Because it is so different from other titles, it does not use the three internal
1755 % commands (|\set@p@emtitle|, |\c@ntentsinfo|, and |\t@xtnotesinfo|) that
1756 % all of the other title commands use, so modifying those internal commands will not
1757 % change |\volumesectiontitle|.
1758 %
1759 % \DescribeMacro{\volumeepigraph} \DescribeMacro{\volumeattribution}
1760 % |\volumeepigraph| and
1761 % |\volumeattribution| are for epigraphs and attributions on the
1762 % divider pages. \goodbreak
1763 %
1764 % \DescribeMacro{\volumeheader} \DescribeMacro{\leftheader} \DescribeMacro{\rightheader}
1765 % |\volumeheader| or |\rightheader| is for setting the right
1766 % running header for that volume (except for divider pages, the table
1767 % of contents, the notes sections, and other special cases). Normally
1768 % that is just the name of the particular volume. |\leftheader| is for setting
1769 % the left running header for the entire book (except for divider
1770 % pages, the table of contents, the notes sections, and other special
1771 % cases). Normally that is the name of the entire book.
1772 %
1773 % \section{Recording textual notes, emendations, and explanatory notes}\label{recordingtextualnotes}
1774 % \subsection{~Setup for endnote sections}
1775 % \DescribeMacro{\maketextnotes} \DescribeMacro{\makeemendations}
1776 % \DescribeMacro{\makeexplanatorynotes}
1777 % To collect textual collations, issue |\maketextnotes| in your
1778 % preamble.
1779 % To collect emendation notes, issue |\makeemendations| in your preamble.
1780 % To collect explanatory notes, issue
1781 % |\makeexplanatorynotes| in your preamble.
1782 % These commands open external files for emendations, textual
1783 % collations, and explanatory notes (with extensions .emd, .ent, and
1784 % .enx respectively). \textsf{poemscol} reads these files back into the main document
1785 % at the place you specify
1786 % with |\puttextnotes|, |\putexplanatory|, or |\putemendations|, or at
1787 % the end (if you use the |\finish| command).
1788 % These commands also send to the external files the commands for typesetting the
1789 % title of each section (e.g. Explanatory Notes), for making an entry in the table
1790 % of contents for each endnote section, and for modifying the
1791 % running headers of the notes sections to xx--yy format (e.g.
1792 % ``Explanatory Notes to pp.~55--7'').
1793 %
1794 % \textsf{poemscol} opens an entry (headed with
1795 % the title, and the page the poem appears on in the body of the
1796 % text, in boldface) in the textual notes
1797 % section for every poem (since, minimally, you want to include
1798 % information about the variants and copy text of the poem).
1799 % In the emendations or explanatory notes sections
1800 % \textsf{poemscol}
1801 % sets this information only if you actually have emendations or explanatory notes on that poem.
1802 % If you have defined a new endnote section using |\definenewnotetype| \textsf{poemscol}
1803 % will also only set the poem heading in the notes if there actually is a note for that poem.
1804 %
1805 % The notes for each poem are set in a block paragraph, with a new
1806 % paragraph for every |\poemtitle| command, and the line counter for
1807 % the notes is reset to 1 with every |\begin{poem}|. (For long poems
1808 % in books or cantos, it you might use |\poemtitle| for the
1809 % canto names or numbers, or perhaps you might want to design a new species
1810 % of title using the commands described below at section \ref{customizing titles},
1811 % page \pageref{customizing titles}.)
1812 %
1813 % By default, there is one paragraph per poem, with a hanging indent to give
1814 % prominence to the page number.
1815 %
1816 % If you wish to use multi-layer footnotes rather than endnotes, you
1817 % do not need to issue |\maketextnotes| or its relatives (but you
1818 % should of course issue |\textnotesatfoot| or its relatives). You can mix
1819 % footnotes or endnotes as you wish. You may, for instance, wish to
1820 % set explanatory notes as footnotes, and textual notes and
1821 % emendations as endnotes. Instructions for setting up
1822 % \textsf{poemscol} to make such footnotes are in section
1823 % \ref{makingfootnotes} below.
1824 %
1825 % \subsection{~Customizing endnotes}
1826 % \begin{sloppypar}
1827 % \DescribeMacro{\iftextnotessinglepar}
1828 % \DescribeMacro{\ifemendationssingplepar}
1829 % \DescribeMacro{\ifexplanationssinglepar}
1830 % You may,
1831 % particularly if you are annotating long poems, wish each
1832 % note to appear in its own paragraph rather than in a block paragraph
1833 % with the other notes to that poem. To do this, you need to set
1834 % the relevant boolean. Issue |\textnotessinglepartrue|
1835 % |\emendationssingplepartrue| or |\explanationssinglepartrue| to give
1836 % each such note a separate paragraph. (Similar booleans will be automatically
1837 % defined for any species of endnote you create.) By default, these notes will have a
1838 % hanging indent, to give prominence to the line number.
1839 % \end{sloppypar}
1840 %
1841 % \begin{sloppypar}
1842 % \DescribeMacro{\noteindentation}
1843 % You may have notes with multiple paragraphs. The default settings for all of
1844 % the forms of endnotes set them with hanging indentation, which probably is not
1845 % a good idea for multiple paragraph notes. There are two ways of approaching
1846 % this problem. The first way is to change all of the paragraphs of the notes to
1847 % normal indentation, which you can do by issuing
1848 % |\literaltextnote{\setlength{\parindent}{\noteindentation}}| just after issuing |\maketextnotes| .
1849 % You can change the amount of indentation by changing the value of the
1850 % length |\noteindentation| (the default value is 1 em).
1851 % You should remember to issue similar
1852 % commands for emendations, explanatory notes, and whatever kinds of notes you
1853 % create using |\definenewnotetype|.
1854 % \end{sloppypar}
1855 %
1856 % \DescribeMacro{\noteparbreak}
1857 % Alternatively, if you want to keep the hanging indent for the page number, but still have paragraph
1858 % breaks in the note, issue |\noteparbreak| whenever you want a paragraph break
1859 % in the midst of a note. The first paragraph will have a hanging indent for the
1860 % page number, but every paragraph that follows a |\noteparbreak| will have normal
1861 % paragraph indentation. By default, |\noteparbreak| indents the new paragraph
1862 % 1em. You can change this by changing the value of the length
1863 % |\noteindentation|.
1864 %
1865 % \DescribeMacro{\iftextnotestwocol}
1866 % \DescribeMacro{\ifemendationstwocol}
1867 % \DescribeMacro{\ifexplanationstwocol}
1868 % By default, notes are set in single columns. To set them in two column mode,
1869 % set the relevant booleans to true, e.g. |\textnotestwocoltrue|. Again, any note type
1870 % you create with |\definenewnotetype| will automatically define the ``twocol'' boolean
1871 % that goes with it.
1872 %
1873 % \DescribeMacro{\putpagenumberinnotesfalse}
1874 % \DescribeMacro{\puttitleinnotesfalse}
1875 % You may not wish to have the poem's page number and title appear in
1876 % the notes. To turn off the appearance of the page number in the
1877 % notes, issue |\putpagenumberinnotesfalse|. You may also not wish to
1878 % put the poem's title in the notes. To turn off the appearance of the
1879 % poem's title in the notes, issue |\puttitleinnotesfalse|. \textsf{poemscol} assumes
1880 % that the notes to a poem will begin with either the poem's title, or its page number, or both,
1881 % so although you can set either boolean to ``false,'' don't set both of them to ``false."
1882 % \textsf{poemscol} will let you do this, but the results will be strange. Also, |\putitleinnotesfalse|
1883 % applies only the textnotes. Emendations, explanatory notes, and any note types you create
1884 % with |\definenewnotetype| will include the title of the poem.
1885 %
1886 % \goodbreak
1887 % \DescribeMacro{\contentsendnotesindent}
1888 % \DescribeMacro{\contentsendnotesfont}
1889 % You can control the appearance of the entry for endnote sections in
1890 % the table of contents by changing the definition of
1891 % |\contentsendnotesindent| (set by default to |\contentsindentone|)
1892 % or |\contentsendnotesfont| (set by default to
1893 % |\contentspoemtitlefont|.)
1894 %
1895 % \subsection{~Textual notes of various kinds}
1896 % \DescribeMacro{\sources} To record information about the copy text,
1897 % editions and publication history of individual poems, or any
1898 % information not tied to specific lines in the poem, you should place
1899 % that information in the argument to the |\sources| command.
1900 % |\sources| sends information to the external file for textual notes, but does not
1901 % tag what it sends with line numbers, hence its use for sending ``sources.''
1902 % Typically, you should issue this command after you have issued
1903 % |\poemtitle| and before you issue |\begin{poem}|. That way the ``sources'' will
1904 % appear in the textual notes section just after the title of the poem, but before the
1905 % notes on particular lines.
1906 % You could conceivably use |\sources|
1907 % send typesetting information to the textual notes file (such as to force a page
1908 % break), but I prefer to do that
1909 % by using |\literaltextnote|, which also sends information to the external
1910 % file for textnotes without sending line numbers. Although they do the same thing, I use |\sources| to
1911 % send editorial information to the texual note section, but use
1912 % |\literaltexnote| to send formatting instructions to the textual note section, so that
1913 % the different purposes of the note are clear at first glance. You can send
1914 % typesetting information to other sections by using
1915 % |\literalemend|, |\literalexplain|, or |\literalcontents|. \textsf{poemscol} also
1916 % creates a similar ``literal'' command for any type of endnote you create on the fly
1917 % using |\definenewnotetype|.
1918 %
1919 % There is one subtle difference between |\sources| and |\literaltextnote|. If you
1920 % issue the commands to set your textual notes as footnotes rather than endnotes,
1921 % notes issued with |\sources| will be set as footnotes, but anything issued using |\literaltextnote|
1922 % will be discarded. To set textual notes as footnotes,
1923 % see section \ref{makingfootnotes}, page \pageref{makingfootnotes}, below.
1924 %
1925 % \DescribeMacro{\textnote}
1926 % \DescribeMacro{\emendation}
1927 % \DescribeMacro{\explanatory}
1928 % |\textnote| is used to capture variants and tie them to the
1929 % correct line number. You don't have to count line numbers;
1930 % \textsf{poemscol} keeps track of them for you. Issue |\textnote|
1931 % immediately after the |\verseline| command which marks the ending of
1932 % the line you wish to comment upon. Put the text of your note (which
1933 % may be simply the recording of a variant in standard notation) into
1934 % the argument of the command. You should put both the lemma and the
1935 % variants or comment in the argument to the |\textnote| command.
1936 % For emendations, use |\emendation|, and for explanatory notes,
1937 % use |\explanatory|. These notes go to their own endnote sections. The
1938 % only difference is that each poem opens a new paragraph (headed with the
1939 % poem's title and page number) for its own
1940 % textual notes, but such paragraphs for explanatory notes or emendations are only
1941 % opened if there actually are explanatory notes or emendations for that poem.
1942 %
1943 % \DescribeMacro{\sameword}
1944 % \DescribeMacro{\missingpunct}
1945 % To
1946 % put the $\sim$ glyph in your note (used for recording places where
1947 % the variant and the copy text have the same word, as for instance
1948 % when recording a variation of punctuation) use |\sameword|. To put
1949 % the ${}_{\wedge}$ glyph into your text (used for recording places
1950 % where a punctuation mark is missing in a variant), use
1951 % |\missingpunct|.
1952 %
1953 % For notes that refer to ranges of lines, |\textnote|, |\emendation|,
1954 % and |\explanatory| have an optional argument, which records how many
1955 % lines the note refers to. There are two ways of using this
1956 % argument. The grubby but simple way is simply to put into the
1957 % argument the number of lines it refers to. If, for instance, you
1958 % issue |\textnote[4]{lemma] rest of note}|, \textsf{poemscol}, rather
1959 % than printing merely the number of the line which closed just before
1960 % you issued |\textnote|, will print a line range, beginning at that
1961 % line, and ending at the fourth line after it. If that |\textnote|
1962 % were issued after line 214, this is to say, the output in the
1963 % textual notes would be: 214--218: lemma] rest of note.
1964 %
1965 % \begin{sloppypar} It seems clumsy to count the lines referred to by
1966 % a note, especially since you don't have to count lines to set where
1967 % the note begins. A more sophisticated way, and one which involves
1968 % no counting, is to make a unique poem line label for the last line
1969 % of the range by issuing |\poemlinelabel{some unique label}| just
1970 % after the |\verseline| or |\end{stanza}| that ends the range. (To
1971 % use |\poemlinelabel| see section \ref{poemlinelabel}.) Then, back
1972 % after the |\verseline| or |\end{stanza}| command that closes the
1973 % first line of the range, put the text of the label into the optional
1974 % argument of |\textnote| as follows: |\textnote[some unique label]{lemma]rest of note}|.
1975 %This is the preferred method. The
1976 % line-counting method is deprecated, but retained for backwards
1977 % compatibility with earlier versions. If you use the label method,
1978 % you will have to run your file through \LaTeX\ twice, once to define
1979 % the labels, and once to set the text.\end{sloppypar}
1980 %
1981 % Here is a complete example:
1982 %\begin{verbatim}
1983 %Yes, then I met the beast. Well, better, indeed,\verseline
1984 %\textnote[had it been the]{better, indeed, / Had it been the] better if
1985 %it / Had been the 1953TS (revised in black pencil
1986 %on 1953TS to 1953)}
1987 %Had it been the manifest beast and the circumstantial\verseline
1988 %\poemlinelabel{had it been the}
1989 %Avatar of destruction. But no beast then: the towering\verseline
1990 %Definition, angelic, arrogant, abstract,\verseline
1991 %Greaved in glory, thewed with light, the bright\verseline
1992 %Brow tall as dawn. I could not see the eyes.\end{stanza}
1993 % \end{verbatim}
1994 %
1995 % Overlapping lemmas, or lemmas that
1996 % include stanza breaks, do not pose any difficulties for |poemscol|.
1997 %
1998 % |\emendation| and |\explanatory| are used exactly as |\textnote|
1999 % is. Issue the emendation or the explanatory note as the argument to
2000 % the command. Place the command immediately after the |\verseline| that
2001 % concludes the line to which it is a comment. These commands also can
2002 % take optional arguments to specify line ranges.
2003 %
2004 % \begin{sloppypar}
2005 % \DescribeMacro{\accidental} |\accidental| behaves exactly like
2006 % |\textnote|. Accidentals
2007 % are included by default, but if you issue |\global\includeaccidentalstrue|
2008 % in your preamble, you will remind yourself of that fact.
2009 % If you wish to distinguish between accidentals and
2010 % substantives, using |\accidental| provides a way of doing so.\end{sloppypar}
2011 %
2012 % If you wish to exclude accidentals from your printed output, but to
2013 % mark them in your source files, so that your published collation in the
2014 % textual notes endnotes section
2015 % consists only of substantives, issue
2016 % |\global\includeaccidentalsfalse| in your preamble. Many publishers
2017 % are reluctant to publish accidentals, believing that they are, well,
2018 % less substantive than substantives. Using the |\accidental|
2019 % command allows you to exclude accidentals from the published version
2020 % should your publisher insist, while preserving the information about
2021 % them in your source files should the publisher's mind change. In the very worst case, if
2022 % you have marked all the accidentals in this way you can still
2023 % produce a list of accidentals for later use, and other scholars can
2024 % search for accidentals in your source files simply by searching for
2025 % the string |\accidental|.
2026 %
2027 % \textsf{poemscol} does not provide for a separate backmatter section
2028 % for accidentals, but it would be trivial to construct one, using
2029 % |\definenewnotetype|, described in section \ref{definingnewnotes}
2030 % below. You may, for instance, use |\definenewnotetype| to create a command called
2031 % |\newaccidental|, then issue| \let\accidental=\newaccidental|.
2032 %
2033 % \DescribeMacro{\tsvariant} \DescribeMacro{\tsentry} Some publishers
2034 % may turn up their noses at typescript or manuscript variants (changes on
2035 % a manuscript or typescript as opposed to differences between published versions) in just
2036 % the way they turn up their noses at accidentals. If you wish to
2037 % distinguish between published variants and typescript,
2038 % man\-u\-script, or galley variants, |\tsvariant| (for a whole note)
2039 % and |\tsentry| (for a typescript entry in a list of variants in a
2040 % textual note that includes other kinds of variant) provide ways of
2041 % doing so. By default, typescript variants are included. To exclude
2042 % typescript variants, issue |\global\includetypescriptsfalse| in your
2043 % preamble. You can issue |\global||\includetypescriptstrue| in your
2044 % preamble, to remind yourself that you are including typescript
2045 % variants. In that (default) case |\tsvariant| will behave exactly
2046 % like |\textnote|, and entries in other notes marked with
2047 % |\tsentry| will be included in your output.
2048 %
2049 % Here is how to use |\tsentry|:
2050 % if you wish to include typescript entries in a single note including
2051 % those entries in a list with variants from other published versions
2052 % (as for instance when a word appears in a typescript but only in
2053 % the second edition of the published poem), simply issue
2054 % |\textnote| as usual, marking the relevant variant in the list of
2055 % variants with the |\tsentry| command. If typescript variants
2056 % are excluded, the typescript entry will also be excluded.
2057 %
2058 % Here is a typical use of the |\tsentry| command:
2059 % \begin{verbatim}
2060 % Of moonlit desert. A stallion, white and flashing, slips,\verseline
2061 % \textnote{Of moonlit] Of the moonlit {\em NY\/}\tsentry{, SP85TS
2062 % (revised in black pen to SP85)}}
2063 % \end{verbatim}
2064 %
2065 % Notice that since the |\tsentry| comes in the middle of the list,
2066 % it begins with a comma. You might expect an |\unskip| command
2067 % before the comma, to prevent
2068 % \LaTeX\ from adding white space before the comma. \textsf{poemscol}
2069 % automatically provides the |\unskip| if the entry starts with a
2070 % comma or a semicolon.
2071 %
2072 % You can
2073 % mark individual variants with |\tsentry| in the arguments to the
2074 % |\explanatory| and |\emendation| commands as well, and
2075 % |\tsentry| will also behave normally in any endnote or footnote section
2076 % you define using |\definenewnotetype|.
2077 %
2078 % \textsf{poemscol} does not provide for a separate backmatter section
2079 % for typescript variants, but it would be trivial to construct one,
2080 % again using |\definenewnotetype|. To do this, you would also have to
2081 % copy all of the emendations, explanatory notes, and textual notes
2082 % which have a |\tsentry| in their arguments, and add
2083 % |\tsvariant| commands in those places. For information about
2084 % |\definenewnotetype| see section \ref{definingnewnotes}.
2085 %
2086 % \DescribeMacro{\margreftextnote}
2087 % \DescribeMacro{\margrefexplanatory}
2088 % \DescribeMacro{\margrefemendation}
2089 % Some editions include a marginal mark in the text showing where in the
2090 % apparatus a textual note on that line can be found. (The edition of William
2091 % Blake's poetry and prose edited by Harold Bloom and David V. Erdman, for instance,
2092 % includes such marks.)
2093 % |\margreftextnote| sets a label in the textual notes section, and
2094 % sets a marginal note with a page reference to that label in the main text. Issue
2095 % |\margreftextnote| \emph{before} issuing the |\verseline| or
2096 % |\end{stanza}| that closes the line to which it refers. (The textual
2097 % note itself can be an ordinary |\textnote|, and should be placed, as
2098 % usual, \emph{after} the |\verseline| or |\end{stanza}|.)
2099 % |\margrefexplanatory| does the same thing for explanatory notes, and
2100 % |\margrefemendation| does the same thing for emendations.
2101 % If you define a new kind of endnote with |\definenewnotetype|, you
2102 % will automatically also define a new |\margref| command for that kind of note. For
2103 % details about how these markers work, see
2104 % section \ref{margreftextnote}, page \pageref{margreftextnote}.
2105 %
2106 % \DescribeMacro{\quotedversecorrectiontextnote}
2107 % If you quote verse \emph{within} a textual note, an explanatory
2108 % note, or an emendation, you may want to use the normal \LaTeX\
2109 % |verse| environment for that quotation, rather than the special markup
2110 % for \textsf{poemscol}. You can also use the special |pmclverse| environment, which
2111 % enlarges the indentation of runover lines and the white space
2112 % between stanzas. But you should not use the |poem| environment within the textual notes.
2113 %
2114 % If a textual note
2115 % \emph{ends} with a quotation in verse, you should
2116 % follow the |\textnote| entry with
2117 % |\quotedversecorrectiontextnote|. I found that if I quoted verse in
2118 % the note sections a dirty trick I used to send the notes to the
2119 % external files would cause the following notes on that poem in the
2120 % notes sections to be set in a new paragraph. (This is of course not
2121 % a problem if the quoted verse is the last thing in the notes to that
2122 % poem, since the next poem will open a new paragraph in the notes
2123 % anyway. It is also not a problem if more of the individual textnote
2124 % follows the verse. It's only a problem if the last thing in the
2125 % note is quoted verse, and the note is not the last one on that
2126 % poem.) The command should set it flush as it is, but I have found
2127 % odd cases I can't understand in which that doesn't work, so the
2128 % command has an optional argument, which should be the additional
2129 % length you need to adjust the next line by to make it flush. The
2130 % default is 0pt. |\quotedversecorrectionexplanatory| and
2131 % |\quotedversecorrectionemendation| should follow explanatory notes
2132 % or emendations that end with snippets of verse. These three
2133 % commands are an embarrassing kludge on my part. They simply send
2134 % commands to the relevant note sections that prohibit opening a new
2135 % paragraph. You should issue this command in the main text right
2136 % after the close of the textnote (not in the text of the textnote
2137 % itself).
2138 %
2139 % \section{Creating new kinds of endnote} \label{definingnewnotes}
2140 % \DescribeMacro{\definenewnotetype} The |\definenewnotetype| command
2141 % can be used to create new kinds of endnote, in case the kinds
2142 % \textsf{poemscol} has predefined do not suffice. |\definenewnotetype|
2143 % takes five arguments. They are (assuming you are creating a new
2144 % kind of note to be called a ``mynote''): \begin{enumerate} \item A base name
2145 % used to construct \begin{itemize} \item some |\if| variables (e.g.\
2146 % |\ifmynoteson| to see whether you are collecting ``mynotes'',
2147 % |\ifnomynoteyet| to see whether you have written a ``mynote'' for a
2148 % particular poem yet, |\ifmynotestwocol| to set the notes in two
2149 % column mode, and |\ifmynotesinglepar| to set the notes in
2150 % one paragraph per note form, rather than in block paragraphs).
2151 % \textsf{poemscol} will only open an entry for a poem in the
2152 % ``mynotes'' section if there actually is a ``mynote'' on that poem.
2153 % Note that every |\if| that refers to a section is plural
2154 % (|\ifmynoteson|, |\ifmynotestwocol|, |\ifmynotessinglepar|) and
2155 % that every |\if| that refers to a singular note
2156 % is singular (|\ifnomynoteyet|). \item The name for the output
2157 % channel for writing the notes to the appropriate external file.
2158 % This name will always be plural (e.g.\ ``mynotes"). \item The name for the ``literal''
2159 % command for writing literal, unexpanded text on the file (as
2160 % |\literaltextnote| does on the textnotes file), and for the note
2161 % command that sends the actual textual note (line number and all) to
2162 % the section (e.g.\ |\literalmynote| and |\mynote|), also the command to write notes in
2163 % line-numbered prose (e.g.\ |\prosemynote|) or prose numbered by
2164 % paragraph and sentence (e.g.\ |\pmmynote|). These commands will
2165 % always be singular. \item The name of the |\put| command (e.g.\
2166 % |\putmynotes|) which closes the external file for the notes section,
2167 % reads it back in to your document, and adds an entry in the table of
2168 % contents for that notes section. This command will always be
2169 % plural. (There won't be a |\makemynotes| command,
2170 % because |\definenewnotetype| takes its place.)
2171 % \item The name of the |\margref| command for putting a
2172 % marginal mark next to a line giving the page number in the apparatus
2173 % where a note is to be found (e.g.\ |\margrefmynote|) \end{itemize}
2174 % \item The extension for the external file which will hold the notes
2175 % as you generate them. ``Emendations'' for instance, are written to
2176 % an external file called |\jobname.emd| The file name will always be
2177 % |\jobname|, and the different species of endnotes will all have
2178 % distinctive extensions. (|\jobname| is a command that always expands
2179 % to the name of your top level source file. If, for instance, I am
2180 % setting running a file called ``myfile.tex'' through \LaTeX\,
2181 % |\jobname.emd| translates to ``myfile.emd.'') \item The title of the
2182 % notes section as you wish it to appear in the running header (e.g.
2183 % ``Mynotes to ''). \item The title of the notes section as you wish
2184 % it to appear on the first page of the notes section (e.g.
2185 % ``MYNOTES''). \item The title of the notes section as you wish
2186 % it to appear in the table of contents (e.g.\ ``Mynotes''). \end{enumerate}
2187 %
2188 % \begin{sloppypar} So, for instance,\begin{verbatim}
2189 % \definenewnotetype{xyznote}{xyz}{Xyznotes to}{XYZNOTES}{Xyznotes}
2190 % \end{verbatim}
2191 % creates the booleans |\ifxyznoteson|, |\ifnoxyznoteyet|, and
2192 % |\ifxyznotessinglepar|, the
2193 % commands |\xyznote|, |\literalxyznote|, |\prosexyznote|,
2194 % |\pmxyznote|, and |\putxyznotes| (and, although you don't ever have
2195 % to use it explicitly, |\firstxyznote|) the output channel xyznotes,
2196 % the external file |\jobname.xyz|, an entry in the contents for
2197 % ``Xyznotes'', and an endnotes section with a running header of the
2198 % form ``Xyznotes to pp.~xx--yy'' and a title XYZNOTES. \end{sloppypar}
2199 %
2200 % |\xyznote|
2201 % takes the same arguments that |\textnote| does (which is to say,
2202 % an optional argument for a label for entering line ranges, and an
2203 % argument for the lemma and the comment). There won't be an entry
2204 % for a poem in the ``Xyznotes'' endnotes section unless there
2205 % actually is an xyznote for the poem.
2206 %
2207 %|\prosexyznote|
2208 % (for ``xyznotes'' on line-numbered prose passages) takes the same
2209 % arguments |\prosetextnote| does (which is to say, an optional
2210 % argument for a label for entering line ranges, an argument for a
2211 % label to capture the line number of the first line, and an argument
2212 % for the lemma and the comment). For notes on passages of line-numbered
2213 % prose, see section \ref{prosesections}, page \pageref{prosesections}.
2214 %
2215 % |\pmxyznote| (for prose passages
2216 % numbered by paragraph and sentence) takes the same arguments as
2217 % |\pmtextnote|. For notes on passages of prose numbered by
2218 % paragraph and sentence, see section \ref{paragraphsentence}, page
2219 % \pageref{paragraphsentence}.
2220 %
2221 % \section{Multi-level footnotes} \label{makingfootnotes}
2222 % \DescribeMacro{\textnotesatfoot} \textsf{poemscol} will set multiple
2223 % levels of footnotes in block paragraphs, separating each level with
2224 % a rule. To enable this feature, call the \textsf{manyfoot} package
2225 % as follows in your preamble: |\usepackage[ruled,para*]{manyfoot}|.
2226 %
2227 % To set your textual notes as footnotes, issue |\textnotesatfoot| in
2228 % your preamble. If you do this, \textsf{poemscol} will actually
2229 % create two sets of footnotes for textnotes, one for those that are
2230 % called with |\textnote|, which will produce an unindented block of
2231 % notes, and one for those that are called with |\sources|, which will
2232 % produce individual indented paragraphs, opening a new paragraph with
2233 % every note. |\sources| notes often have several paragraphs, so they
2234 % are inappropriate for block-paragraph or ``para'' mode, and because
2235 % those paragraphs are often in fact prose paragraphs, rather than
2236 % blocks of notations, they are indented, so that they will be read as
2237 % prose. To set your emendations as footnotes, issue
2238 % |\emendationsatfoot| in your preamble. These notes will be set by
2239 % default as block paragraphs. If you have multiple-paragraph notes
2240 % in your emendations, you should redefine these notes to set plain
2241 % rather than para style notes. (See the next paragraph for how to do
2242 % this.) To set your explanatory notes as
2243 % footnotes, issue |\explanationsatfoot|. These notes will also, by
2244 % default, be plain style notes, with one indented paragraph per note.
2245 % You do not need to issue |\maketextnotes|, |\makeemendations| or
2246 % |\makeexplanatorynotes| if you set those notes as footnotes. If you
2247 % use |\literaltextnote| anywhere in your file, however, you will lose
2248 % the text it would have put in your textnotes, since |\literaltextnote|
2249 % just writes its argument onto the external file for textual notes.
2250 % The arguments to |\literalexplain| and |\literalemendation| will
2251 % be discarded as well if explanatory notes or emendation notes are set as footnotes.
2252 %
2253 % \DescribeMacro{\iftextfootnotespara}
2254 % \DescribeMacro{\ifsourcesfootnotespara}
2255 % \DescribeMacro{\ifemendationfootnotespara}
2256 % \DescribeMacro{\ifexplanfootnotespara}
2257 % To change the style of your footnotes between plain and
2258 % para modes, globally change the values some of the following
2259 % booleans. |\ifsourcesfootnotespara|, obviously, is true if
2260 % footnotes from the |\sources| command are set in ``para'' mode
2261 % (default is false). |\iftextfootnotespara| is true if footnotes
2262 % from |\textnote| are set in ``para'' mode (default is true).
2263 % |\ifemendationfootnotespara|, or |\ifexplanfootnotespara| are the
2264 % booleans which set the style of footnotes from |\emendation| and
2265 % |\explanatory| respectively. By default, footnotes from
2266 % |\emendation| are set in ``para'' mode (|\emendationfootnotesparatrue|), and footnotes from
2267 % |\explanatory| are set in ``plain'' mode (|\explanfootnotesparafalse|). To change explanatory
2268 % footnotes from plain to para mode, for instance, issue
2269 % |\global\explanfootnotesparatrue|. Counterintuitive as it sounds,
2270 % you must issue this \emph{before} issuing |\textnotesatfoot|, |\emendationsatfoot|,
2271 % or |\explanationsatfoot|.
2272 %
2273 % When |\sources| is defined to send endnotes to the textual notes
2274 % section, they usually appear immediately underneath the title of
2275 % the volume or poem they comment upon in the endnotes section. If you are having |\sources|
2276 % output footnotes, it would be a good idea to open the note with the
2277 % title of the volume or poem it is a comment upon, in case there is
2278 % more than one poem on the page.
2279 %
2280 % When note classes are set as footnotes, the symbol which marks
2281 % cases in which a page turn falls on a stanza break will be set
2282 % \emph{beneath} the footnotes. This is a consequence of the way
2283 % \textsf{poemscol} uses the |\mark| mechanism to keep track of these
2284 % cases, so I have not figured out how to change it. But it may well
2285 % be more of an idiosyncrasy than a bug, particularly if the symbol
2286 % is changed from * to something like ``stanza break at page turn.''
2287 %
2288 % \DescribeMacro{\DeclareNewFootnote}
2289 % To create a new level of footnote, you must first declare it to
2290 % make it known to \textsf{manyfoot}, which requires each level of
2291 % footnote to be given a unique suffix (usually a capital letter of
2292 % the alphabet). You can declare a new footnote level called
2293 % |\footnoteE| for instance, by issuing
2294 % |\DeclareNewFootnote[para]{E}|. You will want notes which don't put
2295 % a mark in the body of the text, and begin with the line number or
2296 % range of line numbers of the lemma. To define a footnote called
2297 % |\mynote|, first declare new footnote |\footnoteE| (A, B, C and D
2298 % are reserved for sources, textual notes, emendations, and explanatory notes,
2299 % respectively, and H is reserved for use for titles with
2300 % authorial footnotes). Then issue: \begin{verbatim}
2301 % \newcommand{\mynote}[2][0]{\setlemmarange{#1}\\
2302 % \FootnotetextE{\citerange}{#2}
2303 % \resetlemmacounters} \end{verbatim}
2304 % |\setlemmarange|, |\citerange|, and
2305 % |\resetlemmacounters| are internal commands to enable your footnote to handle line ranges in
2306 % the lemma. They are defined in the implementation section below, at section
2307 % \ref{notetools}. If a |\mynote| refers to a range of lines, you can issue
2308 % the same kinds of optional argument that are used with |\textnote|.
2309 %
2310 % \section{Notes at the end of poems}
2311 % \DescribeMacro{\poemendnote}
2312 % \DescribeMacro{\makepoemendnotes}
2313 % \DescribeMacro{\putpoemendnotes}
2314 % You may wish, rather than using endnotes or footnotes, simply to print your
2315 % notes at the end of each poem. To do this for simple notes, issue |\makepoemendnotes| just
2316 % after |\begin{poem}|. Issue |\poemendnote| where you wish to make a note,
2317 % using the same conventions for line ranges you use for |\textnote|. Where you want to output
2318 % the notes, issue |\putpoemendnotes|. These notes can have multi-line lemmas,
2319 % just like textual notes.
2320 %
2321 % \DescribeMacro{\ifpoemendnotessinglepar}
2322 % By default, each poem end note is given its own paragraph. To concatenate
2323 % them into one big paragraph, issue |\poemendnotessingleparfalse|.
2324 %
2325 % \DescribeMacro{\poemendemendationnote}
2326 % \DescribeMacro{\makepoemendemendationnotes}
2327 % \DescribeMacro{\putpoemendemendationnotes}
2328 % You can also print emendation notes at the end of each poem.
2329 % To do this, issue |\makepoemendemendationnotes| just
2330 % after |\begin{poem}|. Issue |\poemendemendationnote| where you wish to make a note,
2331 % using the same conventions you use for |\textnote|. Where you want to output
2332 % the notes, issue |\putpoemendemendationnotes|. These notes can have multi-line lemmas,
2333 % just like textual notes.
2334 %
2335 % By default, each poem end note is given its own paragraph. To concatenate
2336 % them into one big paragraph, issue |\poemendemendationnotessingleparfalse|.
2337 %
2338 % \begin{sloppypar}
2339 % \DescribeMacro{\poemendexplanatorynote}
2340 % \DescribeMacro{\makepoemendexplanatorynotes}
2341 % \DescribeMacro{\putpoemendexplanatorynotes}
2342 % You can print explanatory notes at the end of each poem.
2343 % To do this, issue |\makepoemendexplanatorynotes| just
2344 % after |\begin{poem}|. Issue |\poemendexplanatorynote| where you wish to make a note,
2345 % using the same conventions you use for |\textnote|. Where you want to output
2346 % the notes, issue |\putpoemendexplanatorynotes|. These notes can have multi-line lemmas,
2347 % just like textual notes.\end{sloppypar}
2348 %
2349 % By default, each poem end note is given its own paragraph. To concatenate
2350 % them into one big paragraph, issue |\poemendexplanatorynotessingleparfalse|.
2351 %
2352 % \DescribeMacro{\poemendtextnote}
2353 % \DescribeMacro{\makepoemendtextnotes}
2354 % \DescribeMacro{\putpoemendtextnotes}
2355 % You can print textual
2356 % notes at the end of each poem. To do this, issue |\makepoemendtextnotes| just
2357 % after |\begin{poem}|. Issue |\poemendtextnote| where you wish to make a note,
2358 % using the same conventions you use for |\textnote|. Where you want to output
2359 % the notes, issue |\putpoemendtextnotes|. These notes can have multi-line lemmas,
2360 % just like textual notes.
2361 %
2362 % \DescribeMacro{\ifpoemendtextnotessinglepar}
2363 % By default, each poem end note is given its own paragraph. To concatenate
2364 % them into one big paragraph, issue |\poemendtextnotessingleparfalse|.
2365 %
2366 % \section{Printing endnotes and index}
2367 % \DescribeMacro{\testforauxonfirstrun} If you don't want to listen to
2368 % \LaTeX\ complain about missing references during your first run,
2369 % issue |\testforauxonfirstrun|, which won't let |\finish|,
2370 % |\putexplanatory|, |\puttextnotes|, or |\putemendations| run unless
2371 % there is an .aux file for a previous run. \emph{Be sure to issue
2372 % this command before issuing} |\begin{document}|, \emph{since that
2373 % reads in the existing .aux file, and overwrites it with a new one.}
2374 %
2375 % \label{putexternalfiles}
2376 % \DescribeMacro{\putemendations} This command closes the external file
2377 % for emendations and reads it in. It also puts an entry for the
2378 % emendations section into your table of contents. After
2379 % |\putemendations| has read in the external file for emendations, you
2380 % will need to run your file through \LaTeX\ again, to put the correct
2381 % page number in the table of contents file.
2382 %
2383 % \DescribeMacro{\puttextnotes}
2384 % \DescribeMacro{\putexplanatory} |\puttextnotes| and
2385 % |\putexplanatory| do the same thing for the textual
2386 % notes and for the explanatory notes.
2387 %
2388 % Each of these last three commands restores normal hyphenation. Since
2389 % all three are printed with the |\small| font size, the hyphen
2390 % character is defined only for that size. This should not create
2391 % other issues, however, because the commands that prohibit
2392 % hyphenation in the |poem| environment (and in the |contentsentry|
2393 % environment) are local to those environments, so the restoration of
2394 % the hyphen character may be redundant.
2395 %
2396 % \DescribeMacro{\putpoemindex} |\putpoemindex| reads in the index at
2397 % this point, and adds an entry for the index to external file for the
2398 % table of contents.
2399 %
2400 % \DescribeMacro{\putmultiplepoemindex} If you are generating
2401 % several indices using \textsf{splitindex} |\putmultiplepoemindex|
2402 % reads in one of them at this point. For instructions about this
2403 % command, see section \ref{multipleindex}, p.~\pageref{multipleindex}.
2404 %
2405 % \DescribeMacro{\finish} The
2406 % |\finish| command is deprecated but still available. It is designed
2407 % to be placed just before |\end{document}| (which, in fact, it
2408 % replaces --- but you should still put an |\end{document}| at the end
2409 % of your document for form's sake). |\finish| closes the external
2410 % files for the three notes sections and reads them back into the
2411 % document (turning the automatic hyphenation back on for these
2412 % sections). It adds entries to the table of contents file for the
2413 % notes sections. It reads in the formatted index file (which you
2414 % have made from your raw .idx file using MakeIndex between \LaTeX\
2415 % runs) and adds an entry for the index to the table of contents.
2416 % Then it closes the external file for the table of contents and reads
2417 % that in (putting it at the end of the document, as I explained
2418 % before). Then it adds a page explaining that the symbol (by default
2419 % *) at the bottom of certain pages marks places where a stanza break
2420 % and a page break coincide. If you have an editor's introduction
2421 % preceding your notes section, or a list of abbreviations, you may
2422 % wish to consult the |\finish| command for suggestions about how to add
2423 % the lines to read those files in and add entries for them in the
2424 % table of contents.
2425 %
2426 % \section{Forewords, Appendices, Contents Entries}
2427 %
2428 % \DescribeMacro{\makeappendix} To make a an Appendix, or any other inserted
2429 % prose section, use |\makeappendix|. |\makeappendix| takes one argument, the title.
2430 % The new section will open on a recto page, and its first page will be in the empty page style.
2431 % The title of the section will appear on the page in the style of the textual notes section.
2432 % The title of the section will appear in the running header of subsequent pages.
2433 % An entry for the new section, with the page number,
2434 % will be added to the table of contents. The entry will
2435 % be formatted the way the entries for textual notes and explanatory notes are formatted.
2436 %
2437 % \DescribeMacro{\appendixtitle} If you wish to add an Appendix which you don't
2438 % want to start on a new page but do want
2439 % to have a contents entry for, use |\appendixtitle| instead of |\makeappendix|.
2440 %
2441 % \DescribeMacro{\makesubappendix} |\makesubappendix| behaves exactly as |makeappendix| does,
2442 % except the contents entry will be indented by the length |\subappendixtitleindentamount|.
2443 %
2444 % \DescribeMacro{\subappendixtitle} If you wish to add an Subappendix which you don't
2445 % want to start on a new page but do want
2446 % to have a contents entry for, use |\subappendixtitle| instead of |\makesubappendix|.
2447 %
2448 % \DescribeMacro{\appendixincontents} If you wish to suppress contents entries for
2449 % appendices, issue the boolean |\appendixincontentsfalse|. Contents entries for
2450 % appendices or subappendices will be suppressed so long as that boolean is set to false.
2451 %
2452 %
2453 % \DescribeMacro{\makeforeword} |\makeforeword| and |\forewordtitle| behave basically the way
2454 % |\makeappendix| and |\appendixtitle|. I provided separate commands because it occurred to
2455 % me that one might want to treat front matter and back matter sections differently in the
2456 % table of contents, so I have allowed for different indentations for their contents entries.
2457 %
2458 % \DescribeMacro{\pmclcontentsentry} \label{pmclcontentsentry} If you want to add a
2459 % line to the table of contents that
2460 % will follow the formatting of other entries in the contents, issue |\pmclcontentsentry|.
2461 % |\pmclcontentsentry| takes three arguments. The first is the title you wish to put in the contents.
2462 % The second is the length of the indentation to appear in the contents (usually |\contentsindentone|,
2463 % |\contentsindenttwo|, or |\contentsindentthree|, but you can use any arbitrary length).
2464 % The third argument is the page number. The argument could be a |\pageref| rather than a number.
2465 % if you define the |\label| for that |\pageref| somewhere else in your file.
2466 %
2467 %
2468 % \section{Special cases}
2469 % \subsection{~Epigraphs, attributions etc.} \label{centerepigraphs}
2470 % \DescribeMacro{\epigraph} \DescribeMacro{\headnote}
2471 % \DescribeMacro{\attribution} \DescribeMacro{\poemdedication}
2472 % |\epigraph|, |\headnote|, |\attribution|, and |\poemdedication| set
2473 % their arguments as epigraphs, headnotes, attributions, or
2474 % dedications for poems or poetic sequences.
2475 % There are in addition the special commands |\JHepigraph| and |\JHdedication|, which place
2476 % a mark in the margin
2477 % showing where in the notes comments on that epigraph or dedication may be found.
2478 %
2479 % \DescribeMacro{\volumeepigraph} If you have dedications, epigraphs, or attributions on
2480 % the divider pages of editions that combine several volumes of
2481 % poetry, use |\volumededication|, |\volumeepigraph|, and
2482 % |\volumeattribution|.
2483 %
2484 % \DescribeMacro{\centertitles}
2485 % If |\centertitles| or |\centeritlescheme| is in effect, epigraphs, headnotes, dedications,
2486 % and attributions will all be centered on the page. (|\volumeepigraph|, |\volumededication|,
2487 % and |\volumeattribution|, however, are unaffected by |\centertitles|.)
2488 % If your epigraph or headnote is a prose passage of more than one line, or
2489 % of more than one paragraph, or a verse
2490 % passage of more than line, or even more than one stanza, the |\epigraph| command will work
2491 % properly if |\centertitles| is in effect, which is to say it will draw the margins in towards the center,
2492 % rather than centering the epigraph line by line.
2493 %
2494 % Issuing |\centertitles| moves the margins in on both sides by the length
2495 % |\centerepigraphindentation| (the default is 6em). The margins for
2496 % uncentered epigraphs and the like are controlled by the length |\normalepigraphindentation|
2497 % (the default is 1.5em). Both values can be adjusted by using |\setlength|.
2498 %
2499 % After issuing |\centertitles| you can move epigraphs and similar things back to the margin
2500 % by issuing |\centerepigraphsonfalse|. After issuing |\centertitles| you can put titles at the margin
2501 % while leaving epigraphs alone by issuing |\centertitlesonfalse|.
2502 %
2503 % If you use the standard \LaTeX\ |verse|
2504 % environment within an epigraph, you may wish to add a |\smallskip| between
2505 % stanzas. (To my eye that environment does not leave enough white space between
2506 % stanzas.) Alternatively, you can use the special |pmclverse| environment.
2507 % You can even use
2508 % the |poem| environment, but if
2509 % you do this, you should so mark line breaks with |\\| and stanza breaks
2510 % with a blank line, as in the standard |verse| environment. If
2511 % you mark up the epigraph with things like |\verseline| and |\end{stanza}| you may wind
2512 % up with marginal line numbers in your epigraph.
2513 %
2514 % \begin{sloppypar}You
2515 % may also wish to align epigraphs, dedications, attributions, or
2516 % headnotes with the left margin of the verse block (even if you
2517 % center the titles). To do this, issue |\leftalignepigraphstrue| to
2518 % set the boolean |\ifleftalignepigraphs|. Remember that for |\leftalignepigraphstrue| to
2519 % work, you will need to use the |\settowidth| command. Issue
2520 % |\settowidth{\versewidth}{Text to be used for centering.}| just
2521 % before you issue the |\poemtitle| command.
2522 % |\leftalignepigraphstrue| will also align attributions,
2523 % dedications, and other pre-texts of poems. \end{sloppypar}
2524 %
2525 % \DescribeMacro{\shortpoemepigraph}
2526 % \DescribeMacro{\shortpoemdedication}
2527 % \DescribeMacro{\shortpoemattribution}
2528 % Because |\centerepigraphs| merely
2529 % draws in the margins on both sides rather than centering each line
2530 % line by line, short epigraphs may not appear
2531 % well centered. |\shortpoemepigraph| |\shortpoemdedication| and
2532 % |\shortpoemattribution|, are better for single line epigraphs,
2533 % since they will center their arguments line by line.
2534 %
2535 % \begin{sloppypar} The commands
2536 % |\shortpoemepigraph| |\shortpoemdedication| and
2537 % |\shortpoemattribution| will all place their texts in
2538 % accordance with the title placement scheme you select in your
2539 % preamble.
2540 % |\normaltitleindentationscheme| will place them near the left text
2541 % margin.
2542 % |\titlesatleftversemarginscheme| will place them at the left verse
2543 % margin.
2544 % |\titlescenteredonleftverseblockscheme| will center them over the
2545 % longest line of a left-flushed verse block.
2546 % |\titlesatleftmarginofcenteredblockscheme| will place them at the
2547 % left margin of a centered verse block.
2548 % |\centertitlesscheme| will center them over a centered verse block.
2549 % You can center epigraphs and similar things on the page over an uncentered verse block
2550 % by issuing the boolean |\centerepigraphson|.
2551 %
2552 % \DescribeMacro{\JHshortepigraph}
2553 % I have also defined
2554 % |\JHshortepigraph| and |\JHshortdedication|, which set marginal
2555 % marks pointing to where notes on the epigraph or dedication in the textual notes section may be
2556 % found, in the manner of |\JHpoemtitle|.
2557 % These commands too obey the title placement scheme that may be in effect. \end{sloppypar}
2558 %
2559 % \subsection{~Appending publication date}
2560 % \DescribeMacro{\poemdate} You can append the date of the poem
2561 % with |\poemdate|. Issue |\poemdate| just after |\end{poem}|. You can
2562 % include both the composition and publication date if you wish simply by
2563 % including both dates in the argument.
2564 % (In fact, you can put anything in the argument, not just dates.) By default |\poemdate| places the
2565 % date one |\bigskip| under the left margin of the verse block of the poem,
2566 % whether the poem is set at the left
2567 % margin or whether the verse block is centered on the longest line.
2568 % You can move the placement of the date left or right
2569 % by changing the value of the length |\dateindent|. If you wish to change
2570 % |\dateindent| you will have to issue |\setlength{\dateindent}{your value}| before
2571 % each instance of |\poemdate|, since \textsf{poemscol} recalculates
2572 % |\dateindent| freshly for every poem.
2573 %
2574 % There is a slight bug in |\poemdate|. If there is a page turn between the last line of the
2575 % poem and the date, and the last line has a runover portion, the date will be set
2576 % flush with the indented runover portion of the line rather than with the beginning
2577 % of the line. This should not in practice
2578 % be a problem, because you should use |\longpage| or several |\shortpage| commands
2579 % to move the widowed date line anyway.
2580 % (For |\longpage| and |\shortpage| see section \ref{longpage},
2581 % page \pageref{longpage}.)
2582 %
2583 % \subsection{~Pausing line numbering}
2584 % \DescribeMacro{\saveverselinenumber}
2585 % \DescribeMacro{\restoreverselinenumber} There are cases in which you
2586 % might want to pause and resume line numbering later at the same number.
2587 % For instance, you may have inset prose
2588 % passages which do not take line numbers, but you wish to resume line numbering the verse
2589 % after the passage. The way to set this is to issue |\end{stanza}|
2590 % at the end of the stanza before the prose insert. Then issue
2591 % |\saveverselinenumber|. Then issue |\end{poem}|. Insert the prose
2592 % quotation (perhaps followed by |\attribution|). Then issue
2593 % |\begin{poem}| followed by |\restoreverselinenumber| and |\begin{stanza}|.
2594 % Then begin entering the rest of the poem as usual. Longer, independent prose
2595 % sections (such as the author's preface or prose poems) require
2596 % different handling. To provide line numbers and notes for such
2597 % prose sections, see section \ref{prosesections}.
2598 %
2599 % \subsection{~Quoted verse}
2600 % Sometimes you wish to quote verse within verse (as when a speaker
2601 % in a verse play quotes a poem). \DescribeMacro{quotedverse} The
2602 % |quotedverse| environment is designed for this contingency. If
2603 % you issue |\verseline| commands or the |stanza| environment, line counting
2604 % and annotation will proceed as usual in quoted verse.
2605 %
2606 % \subsection{~Multiline poem titles}\label{multilinetitles}
2607 % \DescribeMacro{\poemtitlefirstline}
2608 % \DescribeMacro{\poemtitlemiddleline}
2609 % \DescribeMacro{\poemtitlelastline}
2610 % Very long titles present special problems. In the first place, they
2611 % require special provisions to make sure that page breaks don't
2612 % happen in the middle of a title, or immediately after a title. In
2613 % the second place, they raise questions about how the author wished
2614 % to break them up over several lines. If you think it might matter,
2615 % these commands make it possible for you to ensure that long titles are
2616 % broken in exactly the same way in your text and in your table of
2617 % contents. (I didn't pursue this question for titles in notes
2618 % sections, and in notes sections these commands simply concatenate a
2619 % long title.)
2620 %
2621 % There are similar commands for most but not all of the whole series of
2622 % titles for sequences, sequence sections, sequence subsections, and so on.
2623 % If you need commands for a kind of multi-line title that is not already
2624 % defined, see below at section \ref{customizing titles}, page \pageref{customizing titles}.
2625 %
2626 % Alternatively, you can just let \textsf{poemscol} handle the long
2627 % titles by itself. If you are pretty sure that the author did not
2628 % care how long titles were broken up, this would probably be the
2629 % best thing to do. Remember also that if \textsf{poemscol} breaks a
2630 % title across two lines, you can always force it not break the line
2631 % by using enclosing the argument to |\poemtitle| in an |\hbox|. You
2632 % may get a complaint on your log file about an overfull |\hbox| if
2633 % you do this, however.
2634 %
2635 % \subsection{~Poems in sections}
2636 %
2637 % \begin{sloppypar}
2638 % \DescribeMacro{\poemsectiontitle}
2639 % |\poemsectiontitle| and |\poemsubsectiontitle|, as their
2640 % names imply, set their arguments as the titles of sections or subsections of poems.
2641 % |\poemfirstsectiontitle| is for the first section
2642 % of a poem with many sections. (It differs from |\poemsectiontitle|
2643 % in that it tries to make it harder for a page break to separate the
2644 % title of a poem from the title of its first section.)
2645 % |\poemsectiontitlefirstline|, |\poemsectiontitlemiddleline|,
2646 % |\poemsectiontitlelastline|, |\poemsectiontitlenocontents|, and
2647 % |\poemsectiontitlebaretitle|), as their titles imply, are used for
2648 % special cases such as long section titles, if you wish to specify
2649 % explicitly how the title is to be broken up in the text and in the
2650 % table of contents. You can construct variants of these commands for
2651 % dealing with special cases I didn't anticipate by using
2652 % the commands described in section \ref{customizing titles}.
2653 %\end{sloppypar}
2654 %
2655 % \subsection{~Poetic sequences}\label{poeticsequences}
2656 %
2657 % \DescribeMacro{\sequencetitle} \DescribeMacro{\sequencesectiontitle}
2658 % \DescribeMacro{\sequencefirstsectiontitle}
2659 % \DescribeMacro{\sequencesubsectiontitle} Sequences of related
2660 % poems, perhaps with an over-title, demand special handling in the
2661 % text, in the notes sections, and in the table of contents. (A
2662 % moment's thought will show that they are different in some ways from
2663 % poems in sections. For one thing, a sequence manifests a different
2664 % relationship between part and whole than a poem in sections does,
2665 % and often provides stronger experiences of momentary closure between
2666 % sections.) |\sequencetitle| sets its argument as the title of the sequence,
2667 % |\sequencesectiontitle| sets the titles of the sections of the
2668 % sequence, and |\sequencesubsectiontitle| sets the titles of
2669 % subsections of the sequence (there is even a command for the title
2670 % of sub-subsections, |\sequencesubsubsectiontitle|).
2671 % |\sequencefirstsectiontitle| gives a little more
2672 % vertical space between the main title and the first section title
2673 % than |\sequencesectiontitle| gives between adjacent sections later
2674 % on in the sequence (since the over-title for the sequence is in
2675 % larger type) and adjusts the page breaking penalties to reflect the
2676 % fact that such titles should not occur near the bottom of a page,
2677 % since there should be no page break between the sequence title and
2678 % the title of the first section of the sequence (although page breaks
2679 % are permissible, indeed even slightly favored, between later
2680 % sections). There should also never be a page break between a
2681 % section title and the first or second line of the section. The
2682 % penalties \textsf{poemscol} sets should take care of these
2683 % automatically, but you may still have cases which require you to
2684 % specify a page break with |\pagebreak| or |\newpage|. There are a
2685 % host of other commands, all with self-explanatory titles, that deal
2686 % with some special situations that arise in setting the elements of
2687 % poetic sequences, such as cases where you wish to specify how long
2688 % titles will be broken up into lines, or where you wish no entry to
2689 % be made for the section in the table of contents or in the notes
2690 % sections. These commands don't of course exhaust the dizzying
2691 % possibilities, but from them you can construct whatever other commands
2692 % you may need.
2693 %
2694 % Here is a list of all of the defined title commands.
2695 %
2696 % \begin{itemize}
2697 % \item Commands for Poem titles
2698 % \begin{itemize}
2699 % \item |\poemtitle|
2700 % \item |\poemtitlefirstline|
2701 % \item |\poemtitlemiddleline|
2702 % \item |\poemtitlelastline|
2703 % \item |\poemsubtitle|
2704 % \item |\poemtitlenotitle|
2705 % \item |\poemtitlenocontents|
2706 % \item |\poemtitlebaretitle|
2707 % \item |\poemtitleonlycontents|
2708 % \item |\poemtitleonlynotes|
2709 % \end{itemize}
2710 % \item Poems in Sections
2711 % \begin{itemize}
2712 % \item |\poemsectiontitle|
2713 % \item |\poemsectiontitlefirstline|
2714 % \item |\poemsectiontitlemiddleline|
2715 % \item |\poemsectiontitlelastline|
2716 % \item |\poemsectiontitlenocontents|
2717 % \item |\poemsectiontitlebaretitle|
2718 % \item |\poemfirstsectiontitle|
2719 % \item |\poemfirstsectiontitlebaretitle|
2720 % \item |\poemsubsectiontitle|
2721 % \end{itemize}
2722 % \item Sequence Titles
2723 % \begin{itemize}
2724 % \item |\sequencetitle|
2725 % \item |\sequencetitlefirstline|
2726 % \item |\sequencetitlemiddleline|
2727 % \item |\sequencetitlelastline|
2728 % \item |\sequencetitlenonotes|
2729 % \end{itemize} \goodbreak
2730 % \item Sequence Sections
2731 % \begin{itemize}
2732 % \item |\sequencesectiontitle|
2733 % \item |\sequencesectiontitlenocontents|
2734 % \item |\sequencesectiontitlenonotes|
2735 % \item |\sequencesectiontitlebaretitle|
2736 % \item |\sequencesectiontitlefirstline|
2737 % \item |\sequencesectiontitlemiddleline|
2738 % \item |\sequencesectiontitlelastline|
2739 % \item |\sequencefirstsectiontitle|
2740 % \item |\sequencefirstsectiontitlenocontents|
2741 % \item |\sequencefirstsectiontitlenonotes|
2742 % \item |\sequencefirstsectiontitlefirstline|
2743 % \item |\sequencefirstsectiontitlemiddleline|
2744 % \item |\sequencefirstsectiontitlelastline|
2745 % \item |\sequencesectionsubtitle|
2746 % \end{itemize}
2747 % \item Sequence Subsections
2748 % \begin{itemize}
2749 % \item |\sequencesubsectiontitle|
2750 % \item |\sequencesubsectiontitlenocontents|
2751 % \item |\sequencefirstsubsectiontitle|
2752 % \item |\sequencefirstsubsectiontitlenocontents|
2753 % \item |\sequencesubsectiontitlefirstline|
2754 % \item |\sequencesubsectiontitlemiddleline|
2755 % \item |\sequencesubsectiontitlelastline|
2756 % \item |\sequencefirstsubsectiontitlefirstline|
2757 % \item |\sequencefirstsubsectiontitlemiddleline|
2758 % \item |\sequencefirstsubsectiontitlelastline|
2759 %
2760 % \item |\sequencesubsubsectiontitle|
2761 % \item |\sequencesubsubsectiontitlenocontents|
2762 % \item |\sequencefirstsubsubsectiontitlenocontents|
2763 % \end{itemize}
2764 % \end{itemize}
2765 %
2766 % \subsection{~Titles with marginal markers}
2767 % \DescribeMacro{\JHpoemtitle}
2768 % In his edition of the poetry of Jos\'e Maria Heredia, Tilmann
2769 % Altenberg placed a marker in the margin next to poem titles with a
2770 % reference to where in the apparatus notes on that poem could be
2771 % found. To do this, use the |\JHpoemtitle| command. This command
2772 % takes two arguments: first, the title of the poem, second, the label
2773 % used by the |\label| command on the page of the notes section to
2774 % which the title refers. So, you would issue the poem title command
2775 % this way: |\JHpoemtitle{Los desvelados}{EP_LosDesvelados_AC}|.
2776 %
2777 % (Up to
2778 % version 2.49 of \textsf{poemscol} you had to be sure to define the
2779 % label in the notes sections by issuing
2780 % |\literaltextnote{\label{EP_LosDesvelados_AC}}|. This is no longer
2781 % necessary, and |\JHpoemtitle| defines both the |\label| and the
2782 % |\pageref|.)
2783 %
2784 % Instructions are given in section \ref{JHpoemtitle},
2785 % p.~\pageref{JHpoemtitle} for how to construct similar commands for
2786 % sequences, sequence sections, and so on.
2787 % The following related commands are defined already:
2788 % \begin{itemize}
2789 % \item |\JHsequencetitle| \item |\JHsequencefirstsectiontitle|
2790 % \item |\JHsequencesectiontitle| \item |\JHsequencesubsectiontitle|
2791 % \item |\JHpoemsectiontitle| \item |\JHpoemfirstsectiontitle|
2792 % \item |\JHpoemsubtitle| \item |\JHepigraph| \item |\JHprosesectiontitle|
2793 % \item |\JHdedication| \end{itemize}
2794 %
2795 %
2796 % \DescribeMacro{\setmargpoemtitle}
2797 % |\setmargpoemtitle| is a more general version of
2798 % |\JHpoemtitle|, with the second argument being any commands you
2799 % want to be issued just after the title is processed.
2800 %
2801 % \DescribeMacro{\margreftextnote}\label{margreftextnote}
2802 % Another feature of Altenberg's Heredia edition is a marginal mark
2803 % attached to lines to which text notes refer showing where in the
2804 % apparatus a comment upon that line is to be found.
2805 % |\margreftextnote| sets a label in the textual notes section, and
2806 % sets a marginal note with a page reference to that label in the main text. Issue
2807 % |\margreftextnote| \emph{before} issuing the |\verseline| or
2808 % |\end{stanza}| that closes the line to which it refers. (The textual
2809 % note itself can be an ordinary |\textnote|, and should be placed, as
2810 % usual, \emph{after} the |\verseline| or |\end{stanza}|.)
2811 %
2812 % |\margreftextnote| generates its own label, so there is no need to
2813 % make up one yourself.
2814 %
2815 %\begin{sloppy}
2816 % |\margreftextnote| and its siblings use a
2817 % new kind of insert, |\JHmarginpar|, to set the marginal marks.
2818 % This is so that you can control the placement of these marks
2819 % independently of how you place the line numbers (which use
2820 % |\pmclsidepar|) or other marginal marks you may define using
2821 % |\marginpar|.
2822 %
2823 % Horizontal placement of the mark is controlled by the
2824 % length |\JHmarginparsep|, which is set by default to 0 pt. Vertical
2825 % placement of the marginal mark for a textual note, relative to the baseline, is set by
2826 % the length |\JHmarginparvshift|, which is set by default to 0 pt.
2827 % The horizontal placement of the
2828 % marginal mark set by |\JHpoemtitle|, and its siblings, however,
2829 % is controlled by the length |\JHtitlemarginparsep|. |\JHtitlemarginparsep|
2830 % is set by default to value of |\JHmarginparsep|,
2831 % so that the two
2832 % kinds of mark
2833 % should align with each other by default.
2834 % \end{sloppy}
2835 %
2836 % By default these marginal references are placed in the right
2837 % margin. If you wish to set them in the left margin, issue the
2838 % command |\JHmarksleft|. If you wish to place them back into the
2839 % right margin, issue the command |\JHmarksright|.
2840 % If you wish the
2841 % marks to aways be in the outer margin, issue the command
2842 % |\JHmarksouter|. If you wish the marks to always be in the inner
2843 % margin, issue |\JHmarksgutter|. (The marks for titles and the marks for
2844 % notes always appear on the same side of the page, and the different |\JHmarks| commands
2845 % always move both kinds of mark.)
2846 %
2847 % If you are centering the verse block on the longest line, the verse
2848 % line numbers normally move in towards the verse block. (To center
2849 % the verse block on the longest line, see section
2850 % \ref{centeringtextblock}.) The marginal
2851 % marks for |\margeftextnote| do not do this, since they are designed to
2852 % line up with the marginal mark produced by |\JHpoemtitle|. You can change
2853 % the alignment if you wish by changing the value of either the length |\JHmarginparsep|,
2854 % which controls the placement of marginal marks for notes, or changing the value
2855 % of the length |\JHtitlemarginparsep|, which controls the placement of the marginal
2856 % marks for titles.
2857 %
2858 % \begin{sloppypar}
2859 % If you define a new endnote type using |\definenewnotetype|,
2860 % |\definenewnotetype| will also define a new |\margref| command to go
2861 % with it. So, for example, if you define a new note type called
2862 % |\mynote|, you will automatically also define a ``margref'' command
2863 % called |\margrefmynote| which will place a mark in the margin with
2864 % a label showing where in the end notes sections the text of that
2865 % |\mynote| can be found. \end{sloppypar}
2866 %
2867 % \DescribeMacro{\setmargrefmarker} Altenberg's edition used a ding
2868 % from the pifonts collection in the marginal marks made by
2869 % |\margreftextnote| and its siblings. I have set the default to
2870 % |\dag|, so as not to depend upon yet another style package. You can
2871 % choose another mark using |\setmargrefmarker| (e.g.\
2872 % |\setmargrefmarker{\ding{228}}|).
2873 %
2874 % \DescribeMacro{\settitlemargrefmarker} Altenberg's edition also used a
2875 % different marker for marginal marks for the titles of poems from that used
2876 % for marginal marks made by |\margreftextnote|. By default that marker
2877 % is |\dag|, but you can change it by using |\settitlemargrefmarker|,
2878 %
2879 % \DescribeMacro{\margrefemendation} |\margrefemendation| is a
2880 % version of |\margreftextnote| for emendations.
2881 %
2882 % \DescribeMacro{\margrefexplanatory}|\margrefexplanatory| is a
2883 % version of |\margreftextnote| for explanatory notes.
2884 %
2885 % \subsection{~Titles with footnotes}
2886 % In James Benstead's edition of the collected poems of Hugh
2887 % MacDiarmid, many of the titles of the poems have footnotes by the
2888 % author. Under most circumstances, one can put a note about the title
2889 % in the textual notes section simply by, after the |\begin{poem}|
2890 % command, issuing something like this: |\literaltextnote{title] text of note}|.
2891 % (One can make similar notes for the explanatory notes
2892 % section or for the emendations section.) But MacDiarmid's notes are
2893 % authorial, not editorial, and should be considered part of the
2894 % title. At the same time, the notes should not be printed in the Table
2895 % of Contents, nor for that matter in the endnotes sections.
2896 %
2897 % \DescribeMacro{\footnotepoemtitle} |\footnotepoemtitle| is for the default
2898 % case. It takes two arguments. The first argument is the title of
2899 % the poem. The second is the text of the footnote.
2900 %
2901 % \begin{sloppypar}
2902 % \DescribeMacro{\footnotepoemtitlefirstline}
2903 % |\footnotepoemtitlefirstline| |\footnotepoemtitlemiddleline| and
2904 % |\footnotepoemtitlelastline| are for long titles in which how the
2905 % author broke up the title on the page matters, and one or more of
2906 % the lines has a footnote. These commands also take two arguments,
2907 % of which the first is the title line and the second is the text of
2908 % the footnote. You can intersperse these commands with
2909 % |\poemtitlefirstline|
2910 % |\poemtitlemiddleline| or |\poemtitlelastline| (depending on which
2911 % line has the footnote). The lines will be broken in the same way in
2912 % the text and in the table of contents. \end{sloppypar}
2913 %
2914 % \DescribeMacro{\footnotesplitpoemtitle} |\footnotesplitpoemtitle|
2915 % is for the most general case. Use it if there is a footnote in the middle
2916 % of the title, or if you have a long title and don't need to ensure
2917 % that it is broken in the text and in the table of contents in the
2918 % same way. |\footnotesplitpoemtitle| takes three arguments. The first
2919 % argument is the first part of the title, up to the footnote mark,
2920 % the second is the text of the footnote, and the third is the rest
2921 % of the title.
2922 %
2923 % I have not created footnoted titles for sequences, sequence
2924 % sections, and so on. But if you compare how those titles are
2925 % defined in the implementation section below and how footnoted
2926 % titles are defined at \ref{footnotetitles}
2927 % (page \pageref{footnotetitles}), how to write those commands should be clear.
2928 %
2929 % You can control where the footnotes for footnoted titles are placed.
2930 % By default, those footnotes are conventional footnotes (and all
2931 % their parameters are set in the way normal \LaTeX\ footnotes are
2932 % set). You can force the default setting by issuing the command
2933 % |\maketitlefootnotesplain| in your preamble. If you are setting
2934 % your textual notes or other notes at the foot of the page using
2935 % ``layers'' of footnotes, you can treat these footnotes as just
2936 % another layer by issuing the command |\maketitlefootnoteslayered| in
2937 % your preamble. (``Layered'' footnotes are described at section \ref{makingfootnotes},
2938 % page \pageref{makingfootnotes}.) If you wish to place these footnotes at the end of
2939 % the poem, you must issue |\maketitlefootnotesatpoemend| in the
2940 % preamble. Just before you declare a title with a footnote, issue
2941 % |\makepoemendnotes|, and just after issuing |\end{poem}| for that
2942 % poem, issue |\putpoemendnotes|.
2943 %
2944 % \subsection{~Empty poem titles and italicized poem titles}
2945 %
2946 % \DescribeMacro{\poemtitlenotitle}
2947 % |\poemtitlenotitle|, with its paradoxical name, is for poems
2948 % without formal titles. Usually such poems are referred to by their
2949 % first lines. This command does not produce a title in the text, but
2950 % sets its argument in the table of contents and in the notes. Usually
2951 % you use the first line as the moral equivalent of a title.
2952 %
2953 % \DescribeMacro{\poemtitleitalic}
2954 % Titles
2955 % with italics or other special formatting posed special problems in
2956 % earlier versions (before version 1.7) since the typesetting commands
2957 % gummed up how I passed parameters around that I was unable to solve
2958 % using |\protect|. All of these commands are obsolete now, but are
2959 % retained for backward compatibility.
2960 % |\poemtitleitalic| takes
2961 % two arguments. The first is the title of the poem with the italics
2962 % (or small capitals or international characters or what have you),
2963 % for typesetting, and the second is the title without the commands,
2964 % for cross reference purposes. (Actually, now that \textsf{poemscol}
2965 % no longer needs to treat italics in titles in a different way, it can
2966 % be anything you want, since the second argument is discarded.)
2967 %
2968 % \begin{sloppypar}
2969 % \DescribeMacro{\poemtitlenotitleitalic}
2970 % |\poemtitlenotitleitalic|, with its doubly paradoxical name,
2971 % is for poems without formal titles but with italicized words in their
2972 % first lines. |\poemtitlenotitleitalic| takes two arguments. The
2973 % first is the first line with the italics (for typesetting
2974 % purposes), and the second is the
2975 % first line without the italics (for crossreference purposes). This command
2976 % is obsolete now that italics in titles no longer require special
2977 % handing, but is retained for backwards compatibility.\end{sloppypar}
2978 %
2979 % \subsection{~Problem titles}
2980 % \DescribeMacro{\poemtitlebaretitle}
2981 % \DescribeMacro{\poemtitleonlycontents}
2982 % \DescribeMacro{\poemtitleonlynotes}
2983 % If you have a problem title, one for instance
2984 % in which the title in the text might cause problems in the contents or in the notes,
2985 % you can send information
2986 % separately to the places it will be used.
2987 % For example, a user planned to attach a footnote to a poem title,
2988 % but didn't want the mark or the text of the
2989 % note to show up in the contents or in the endnotes. I would usually
2990 % have advised him to use |\sources| to send the text of the note to the endnotes,
2991 % but he really wanted the title to include the footnote mark and to put the footnote
2992 % on the same page. The solution to this problem
2993 % was to set the title in the text separately from setting it in the notes and in the contents.
2994 % |\poemtitlebaretitle|, for instance simply sets the title in the text. Then
2995 % you can use |\poemtitleonlycontents| to send the title to the contents
2996 % and |\poemtitleonlynotes| to send the title to the notes. These commands
2997 % are defined for poem titles, and for some but not all of the whole range of titles including
2998 % sequence titles, sequence section titles, sequence section subtitles, and so on. But
2999 % it would be easy to roll your own versions of these commands by looking below at
3000 % section \ref{customizing titles}, page \pageref{customizing titles}, or at the
3001 % models in the code below at section \ref{poemtitlecode}, page \pageref{poemtitlecode}.
3002 %
3003 % \DescribeMacro{\poemtitlenocontents}
3004 % \DescribeMacro{\poemtitlenonotes}
3005 % \DescribeMacro{\poemtitlenotitle}
3006 % There are also commands to send information to any two of the relevant locations
3007 % but not the third. |\poemtitlenocontents| sends the title to the text and to the notes,
3008 % but not to the contents. |\poemtitlenonotes| sends the title to the text and to the
3009 % contents, but not to the notes. |\poemtitlenotitle| sends the title to the contents and the
3010 % notes, but not to the main text.
3011 %
3012 % Remember that in the last resort, you can send information to the contents section
3013 % with |\literalcontents|. To actually set a contents entry using |\literalcontents| is a tall order,
3014 % however, since you would have to include all the information from the |\c@ntentsinfo| command
3015 % for the relevant type of title. (For what |\c@ntentsinfo| does,
3016 % see section \ref{customizing titles}, below.)
3017 % For instance, for a poem called
3018 % Test Poem, that would be:
3019 %
3020 % \begin{verbatim}
3021 % \literalcontents{\setlength\contentsentryoverrun{\contentsindenttwoamount }
3022 % \begin{contentsentryenvironment}
3023 % \contentsindentone
3024 % {\contentspoemtitlefont
3025 % Test
3026 % Poem}
3027 % \contentsleaders
3028 % \pageref{testpoemlabel} % pick a unique label
3029 % \end{contentsentryenvironment}
3030 % \par}
3031 % \end{verbatim}
3032 %
3033 % Another tricky thing about this method is the |\pageref| line in the above, which is a pageref to find
3034 % and set in the contents the number of the
3035 % page the poem appears on. You should put |\label{testpoemlabel}|, with any unique
3036 % text for the label (so long as it is the same one used in the |\pageref| line),
3037 % on the page of the text where the poem occurs, in order to capture
3038 % the correct page number. (Alternatively, you could just put the actual page number in
3039 % what you send to the contents with |\literalcontents| instead of the pageref line, but you will
3040 % have to remember to change this number if anything changes in your edition.)
3041 %
3042 % Remember also that you can send information to the relevant notes sections using
3043 % |\literaltextnote|, |\literalexplain|, and |\literalemend|.
3044 %
3045 %
3046 % \subsection{~Customizing titles} \label{customizing titles} \textsf{poemscol} provides a large
3047 % number of ways of setting titles, but conceivably you may wish to
3048 % define your own. Here is a template for designing a new kind of
3049 % title. Suppose you wish to create a kind of title called
3050 % |\mytitle|. It would take one argument, which would be the title
3051 % itself. The command defining the |\mytitle| command should call three commands,
3052 % |\set@p@emtitle|, to set the title in the main text and make the
3053 % label for use by the contents and notes sections, |\c@ntentsinfo| to
3054 % set the title in the table of contents, and |\t@xtnotesinfo|, which
3055 % sets the title in the notes sections. (You should enclose the whole thing
3056 % between |\makeatletter| and |\makeatother|.)
3057 %
3058 %\DescribeMacro{\set@p@emtitle}
3059 % |\set@p@emtitle|
3060 % takes six arguments, which are, in order, (1) the title (which, if
3061 % you are calling this command inside of the definition of |\mytitle|
3062 % should just be |#1|), (2) commands to be issued before setting the
3063 % title (minimally, a penalty, such as |\poemtitlepenalty|), (3) the
3064 % font size in which the title is to be set in the text (such as
3065 % |\poemtitlefont| or |\large|), (4) any indentation of the title
3066 % (|\relax| for |\poemtitle|, or |\titleindent| for
3067 % |\sequencesectiontitle|), (5) commands to be issued after the
3068 % title is set (such as |\afterpoemtitleskip|) and (6) the amount
3069 % overrun lines in the title should be indented.
3070 %
3071 %\DescribeMacro{\c@ntentsinfo}
3072 %|\c@ntentsinfo| takes
3073 % four arguments, which are, in order, (1) the title, (2) the
3074 % indentation of the title in the table of contents (such as
3075 % |\contentsindentone|), (3), the font size in which the title
3076 % should be set (such as |\contentspoemtitlefont|) and (4) the amount
3077 % overrun lines in the table of contents should be indented (such as
3078 % |\contentsindenttwoamount|).
3079 %
3080 % \DescribeMacro{\t@xtnotesinfo}
3081 % |\t@xtnotesinfo|
3082 % takes one argument, the title.
3083 %
3084 % So, for example, to create a new kind of title called |\mytitle| which looks
3085 % just like |\poemtitle|, issue
3086 % \begin{verbatim}
3087 % \makeatletter
3088 % \newcommand{\mytitle}[1]{%
3089 % \set@p@emtitle{#1}{\poemtitlepenalty}{\poemtitlefont}%
3090 % {\relax}{\nobreak\par\nobreak\afterpoemtitleskip\nobreak}{\z@}%
3091 % \c@ntentsinfo{#1}{\contentsindentone}{\contentspoemtitlefont}%
3092 % {\contentsindenttwoamount}%
3093 % \t@xtnotesinfo{#1}%
3094 % }
3095 % \makeatother
3096 % \end{verbatim}
3097 %
3098 % (The |\z@| which is the sixth argument to |\set@p@emtitle| above is
3099 % a constant set to zero. You will also notice that I became completely hysterical
3100 % on the subject of preventing a page break after a poem title.)
3101
3102 % By default, \textsf{poemscol}
3103 % does not indent the overrun portion of titles relative to the first
3104 % line of the title, but if that first line is indented will set the
3105 % overrun portions to be indented the same amount. Overrun portions
3106 % of titles in the table of contents will be indented by one
3107 % |\contentsindentamount| more than the first line is indented. Both
3108 % of these behaviors can be changed by changing the arguments to
3109 % |\set@p@emtitle| or |\c@ntentsinfo|.
3110 %
3111 %\DescribeMacro{\firstlinesettings}
3112 %\DescribeMacro{\middlelinesettings}
3113 %\DescribeMacro{\lastlinesettings}
3114 %\DescribeMacro{\restoresinglelinesettings}
3115 % If you wish to design a title which might have multiple lines,
3116 % and you wish to specify how those lines are broken up, you
3117 % will need to write three commands: one for the first line, one for
3118 % middle lines, and one for the last lines.
3119 % (This only matters if you care how the title is broken up. You
3120 % can choose to let \LaTeX\ do the breaking if you wish.) Before issuing
3121 % |\set@p@emtitle| issue |\firstlinesettings|, |\middlelinesettings|,
3122 % or |\lastlinesettings| (as the case may require). And issue
3123 % |\restoresinglelinesettings| last of all in each of your three
3124 % commands. The lines will be broken in the table of contents and in
3125 % the body of the text in the same way, but will be run in in the
3126 % notes sections.
3127 %
3128 % \subsection{~Customizing indentations in titles in the text body}\label{customtitleindentations}
3129 % Titles of poems, subtitles, titles of sequences, sections of sequences (and subsections and so on),
3130 % appear in the text with a hierarchy of indentations. If you want to change anything
3131 % about these indentations, you don't need to modify the various title-setting commands, but only to
3132 % change the length of the relevant indentation command. I
3133 % have given the indentations for each class of title a defined length, which you can change
3134 % by changing the definition of the indentation command. (e.g.
3135 % |\renewcommand{\poemtitleindent}{\hspace{3em}}.)| For many of these
3136 % indentations you can also simply change the applicable length (e.g.
3137 % |\setlength{\sequencesubtitleindentmount}{\titleindenttwoamount}|. )
3138 %
3139 % The ``amount'' part in the command
3140 % is important. |\poemtitleindentamount| is a length. On the other
3141 % hand, |\sequencesectiontitleindentindent| is a command, defined
3142 % defined as\\
3143 % |\hspace{\sequencesectiontitleindenttitleindentamount}|. \\
3144 % The table lists all the commands for these
3145 % indentations. In the table ``Extra Lines'' refers to the indentation for the second and third lines
3146 % (and so on) of multi-line titles. If you wish to change the
3147 % indentation of any of the titles whose default length is listed as
3148 % 0 in the table, you must use the |\renewcommand| method. (I
3149 % found that setting the length of one of the indentations to 0pt
3150 % added a few points of white space I could not figure out how to get
3151 % rid of, so by default those commands are defined not by using a
3152 % length but by, for example, |\newcommand{\poemtitleindent}{\relax}|.)
3153 %
3154 %\begin{table}[t]
3155 %\caption{Indentations in Titles}
3156 %\bigskip
3157 %{\scriptsize
3158 %\begin{tabular}{l l l}
3159 %\hline
3160 %Entity Title & Indentation & Default Length\\
3161 %\hline
3162 %Volume & |\volumetitleindentamount| & |0pt| \\
3163 %Extra Lines & |\volumetitlesecondlineindentamount| & |0pt| \\
3164 %Volume Subtitle & |\volumesubtitleindentamount| & |\titleindentamount| (1pc)\\
3165 %Extra Lines & |\volumesubtitlesecondlineindentamount| & |\titleindentamount| \\
3166 %Volume Section & |\volumesectiontitleindentamount| & |0pt| \\
3167 %Extra Lines & |\volumesectiontitlesecondlineindentamount| & |0pt| \\
3168 %Poem & |\poemtitleindentamount| & |0pt| \\
3169 %Extra Lines & |\poemtitlesecondlineindentamount| & |0pt| \\
3170 %Poem Subtitle & |\poemsubtitleindentamount| & |\titleindentamount| \\
3171 %Poem Section & |\poemsectiontitleindentamount| & |\titleindentamount| \\
3172 %Extra Lines & |\poemsectiontitlesecondlineindentamount| & |\titleindentamount| \\
3173 %Poem Subsection & |\poemsubsectiontitleindentamount| & | \titleindenttwoamount| \\
3174 %Sequence & |\sequencetitleindentamount| & |0pt| \\
3175 %Extra Lines & |\sequencetitlesecondlineindentamount| & |0pt| \\
3176 %Sequence Subtitle & |\sequencesubtitleindent | & |\titleindentamount| \\
3177 %Extra Lines & |\sequencesubtitlesecondlineindentamount| & |\titleindentamount| \\
3178 %Sequence Section & |\sequencesectiontitleindentamount| & |\titleindentamount| \\
3179 %Extra Lines & |\sequencesectiontitlesecondlineindentamount| & |\titleindentamount| \\
3180 %Sequence Section Subtitle & |\sequencesectionsubtitleindentamount| & |\titleindenttwoamount| \\
3181 %Extra Lines & |\sequencesectionsubtitlesecondlineindentamount| & |\titleindenttwoamount| \\
3182 %Sequence Subsection & |\sequencesubsectiontitleindentamount| & |\titleindenttwoamount| \\
3183 %Sequence Subsubsection & |\sequencesubsubsectiontitleindentamount| & |\titleindentathreeamount| \\
3184 %Appendix & |\appendixtitleindentamount| & |0pt| \\
3185 %SubAppendix & |\subappendixtitleindentamount| & |\titleindentamount| \\
3186 %Foreword & |\forewordtitleindentamount| & |0pt| \\
3187 %Notes Sections & |\notestitleindentamount| & |0pt|
3188 %\end{tabular}}
3189 %\end{table}
3190 %
3191 % \subsection{~Customizing indentations in titles in the Contents}\label{contentsindentations}
3192 % There is also a hierarchy of indentations for titles in the Table of Contents. Again,
3193 % to change the indentations in the Contents, you don't need to redefine the title-setting
3194 % commands, only to change the value of the relevant length. The table shows the hierarchy
3195 % of indentations in the Table of Contents:
3196 %
3197 %\begin{table}[t]
3198 %\caption{Indentations in Contents}
3199 %\bigskip
3200 %{\scriptsize
3201 %\begin{tabular}{l l l}
3202 %\hline
3203 %Entity Title & Indentation & Default Length\\
3204 %\hline
3205 %Volume & |\contentsvolumetitleindentamount| & |0pt| \\
3206 %Extra Lines & |\contentsvolumetitlesecondlineindentamount| & |0pt| \\
3207 %Volume Subtitle & |\contentsvolumesubtitleindentamount| & |\contentsindentoneamount| (24pt)\\
3208 %Extra Lines & |\contentsvolumesubtitlesecondlineindentamount| & |\contentsindentoneamount| \\
3209 %Volume Section & |\contentsvolumesectiontitleindentamount| & |0pt| \\
3210 %Extra Lines & |\contentsvolumesectiontitlesecondlineindentamount| & |0pt| \\
3211 %Poem & |\contentspoemtitleindentamount| & |\contentsindentoneamount| \\
3212 %Extra Lines & |\contentspoemtitlesecondlineindentamount| & |\contentsindentoneamount| \\
3213 %Poem Section & |\contentspoemsectiontitleindentamount| & |\contentsindenttwoamount| \\
3214 %Extra Lines & |\poemsectiontitlesecondlineindentamount| & |\contentsindenttwoamount| \\
3215 %Sequence & |\contentssequencetitleindentamount| & |\contentsindentoneamount|\ \\
3216 %Extra Lines & |\contentssequencetitlesecondlineindentamount| & |\contentsindentoneamount| \\
3217 %Sequence Section & |\contentssequencesectiontitleindentamount| & |\contentsindenttwoamount| \\
3218 %Extra Lines & |\contentssequencesectiontitlesecondlineindentamount| & |\contentsindenttwoamount| \\
3219 %Sequence Subsection & |\contentssequencesubsectiontitleindentamount| & |\contentsindentthreeamount| \\
3220 % Sequnce Subsubsection & Does not appear in Contents & \\
3221 %Appendix or Foreword & |\contentsappendixtitleindentamount| & |0pt| \\
3222 %Notes Sections & |\contentsnotestitleindentamount| & |0pt|
3223 %
3224 %\end{tabular}}
3225 %\end{table}
3226 %
3227 % \subsection{~Visual formatting}
3228 % \DescribeMacro{\longpage}
3229 % \DescribeMacro{\shortpage}
3230 % \label{longpage}
3231 % The ideal in \LaTeX\ is to separate
3232 % content markup and formatting as completely as possible. In the text
3233 % itself you simply mark the logical units (a poem, a title, a stanza,
3234 % a textual note), and a header program (like \textsf{poemscol}) interprets the
3235 % meaning of those terms typographically. However, one still winds up
3236 % having to do some visual formatting. Especially in prose sections,
3237 % such as in the textual notes, you will sometimes have to enlarge or
3238 % shrink a page by one line in order to avoid an intractable widow or
3239 % club line, and when one does so one must be careful to do the same to
3240 % the other member of the two-page spread of which that page is a part
3241 % so that the spread will be properly balanced.
3242 % These commands enable one to wiggle pagelength enough to handle these
3243 % problems. Since verse sections should be set with |\raggedbottom|
3244 % in effect, the commands are not necessary in verse sections.
3245 %
3246 % |\longpage| and |\shortpage| are cumulative: issuing |\longpage| twice lengthens the
3247 % page by two lines, and issuing |\shortpage| twice shortens the page by two lines.
3248 %
3249 % \section{Customizing page geometry and page styles}
3250 %
3251 %
3252 % \subsection{~Font sizes, skips, sinks, indents, and penalties}
3253 %
3254 % \label{changingfontsandleading}
3255 % \textsf{poemscol} sets the font sizes, but not the typeface, of
3256 % fonts for many common tasks, in order to create a hierarchy of
3257 % sizes. They can be changed with a |\renewcommand| of the following
3258 % form, where the first number is the font size in points and the
3259 % second is the leading:\\
3260 % |\renewcommand{\volumetitlefont}{\fontsize{18}{23}\selectfont}|
3261 %
3262 %
3263 % The following table gives the default values for the fonts. The titles of
3264 % the fonts give their uses. Backmatterheaderfont is for setting the
3265 % titles of back matter sections. Sequence section titles use
3266 % poemtitlefont. Backmattertext font is |\small|, backmatterintrofont
3267 % is |\normalsize|.
3268 % \bigskip
3269 %
3270 % \begin{tabular}{l l l}
3271 % \textbf{Font} & \textbf{Size} & \textbf{Leading} \\
3272 % volumetitlefont & 18 & 23 \\
3273 % volumesubtitlefont & 14 & 18 \\
3274 % poemtitlefont & 14 & 18 \\
3275 % sequencetitlefont & 16 & 20 \\
3276 % subsectiontitlefont & 12 & 14.5 \\
3277 % backmatterheaderfont & 16 & 20 \\
3278 % backmattervolumefont & 12 & 14.5 \\
3279 % backmattervolumesubtitlefont & 11 & 13 \\
3280 % contentsvolumefont & 13 & 20 \\
3281 % contentsvolumesubtitlefont & 12 & 14.5 \\
3282 % contentssequencetitlefont & 10 & 14 \\
3283 % contentspoemtitlefont & 10 & 14 \\
3284 % \end{tabular}
3285 %
3286 % \bigskip
3287 %
3288 % The following table gives various skips, sinks, penalties, and indentations. The
3289 % titles of these should be self-explanatory. These should be changed
3290 % with |\renewcommand| as follows:\\
3291 % |\renewcommand{\volumetitlesink}{\leavevmode\vspace{23.5pt}}|
3292 % \bigskip
3293 %
3294 % \begin{tabular}{l l l}
3295 % \textbf{Name} & \textbf{Argument} & \textbf{Comment} \\
3296 % backmattersink & 21.5pt & \relax \\
3297 % backmatterafterheadersink & 11pt& \relax \\
3298 % afterpoemtitleskip & |\smallskip| & \relax \\
3299 % afterpoemskip & |\bigskip| & \relax \\
3300 % aftersequencetitleskip & |\medskip| & \relax \\
3301 % stanzaskip & |\medskip| & Extra skip between stanzas \\
3302 % titleindent & |\titleindentamount| (1pc) & use |\setlength| to
3303 % change \\
3304 % parindent & |\titleindentamount| & \relax \\
3305 % volumetitleshift & |\volumetitleshiftamount| (1pc) & use |\setlength| to
3306 % change \\
3307 % contentsindentone & 24pt & \relax \\
3308 % contentsindenttwo & 42pt & \relax \\
3309 % contentsindentthree & 60pt & \relax \\
3310 % contentsindentfour & 72pt & \relax \\
3311 % runoverindentvalue & 6em & for runover lines in verse\\
3312 % verseindent & 2em & for formally indented lines\\
3313 % notesclubpoempenalty & -300 & \relax \\
3314 % notessequenceclubpenalty & -1500 & \relax \\
3315 % notesvolumetitlepenalty & -1500 & \relax \\
3316 % epigraphquoteleftmargin & 1.5em & for epigraphs, attributions, etc.\\
3317 % epigraphquoterightmargin & 1.5em & \relax \\
3318 % \end{tabular}
3319 %
3320 % \subsection{~Customizing page styles}
3321 % \textsf{poemscol} sets several default page styles, defined
3322 % below. The main page style is ``fancy,'' which is used for
3323 %the main body of the poetry,
3324 % prose frontmatter (such as introductions), and the endnotes sections.
3325 % ``Volumefirststyle'' is for the
3326 % first page of a volume of poems. ``Volumetitlestyle'' is for the
3327 % title page of a volume of poems. The external file for the table of
3328 % contents redefines ``fancy,'' so you should issue |\resetpagestyle|
3329 % after issuing |\putpoemcontents|. |\resetpagestyle| resets the page
3330 % style to ``main'' (which is the same as the original ``fancy'').
3331 %
3332 % Because |\putpoemcontents| resets the page style to ``main,'' any page style you defined
3333 % in the preamble becomes forgotten if you include a table of contents. There are two
3334 % possible solutions to this. The first is to define your page style after you have issued
3335 % |\putpoemcontents|. The second is to redefine the fancypage style ``main,'' so that it does
3336 % what you want. In either case, do not forget to issue |\pagenumbering{arabic}|
3337 % after |\putpoemcontents|, else all of your page numbers will be in roman numerals.
3338 % You can find the default
3339 % definitions of those ``fancy'' and ``main'' below at \ref{pagestyledefs}, page \pageref{pagestyledefs}.
3340 %
3341 %\begin{sloppypar}
3342 % You can change the text in the left (verso) running head
3343 % by issuing |\leftheader{your header}| or |\volumeheader{your header}|. (The commands
3344 % are synonyms.) You can change the text in the right (recto) running head by issuing
3345 % |\rightheader{your header}|. \end{sloppypar}
3346 %
3347 % \subsection{~Special page style for long poems} The fancy page style ``longpoem''
3348 % will add information of the form ``firstline--lastline'' to the running header. This
3349 % page style otherwise resembles ``main,'' and ``fancy.''
3350 % Issue |\pagestyle{longpoem}| to use this page style. If you use ``longpoem,'' be sure to
3351 % call \textsf{etex} and \textsf{emarks} in your preamble. Also, when a poem ends, be sure
3352 % to issue |\newpage|, otherwise the running header will list the first line on the page from the
3353 % first poem and the last line on the page from the second poem.
3354 %
3355 % If you use ``longpoem'' and you have a table of contents, you must issue
3356 % |\pagestyle{longpoem}| at some point \emph{after} issuing |\putpoemcontents|.
3357 % Do not forget to issue |\pagenumbering{arabic}|
3358 % after |\putpoemcontents|, else all of your page numbers will be in roman numerals. Also, if you
3359 % have back matter, you must issue |\pagestyle{main}| at the end of your poetry section,
3360 % before the back matter starts, since otherwise your header will include the last line
3361 % number \textsf{poemscol} saw. Issuing |\pagestyle{main}| will restore the normal page
3362 % headers for the backmatter
3363 % sections.
3364 %
3365 % \begin{sloppypar}
3366 % The header will include the abbreviation l.\ (for a single line) or ll.\ (for a range of lines).
3367 % You can change either abbreviation with |\changesinglelineabbrev| or
3368 % |\changemultiplelineabbrev|. So, for instance, to get rid of the abbreviations
3369 % entirely, issue |\changemultiplelineabbrev{\relax}| and |\changesinglelineabbrev{\relax}|.
3370 % \end{sloppypar}
3371 %
3372 % \begin{sloppypar}
3373 % You may need to play with |\leftheader| and |\rightheader| to get the information you
3374 % want into the header. You might, for instance, what to use something like
3375 % |\leftheader{``Your main title'' \hfil ``Your poem title''}| and
3376 % |\rightheader{``Your volume title'' \hfil ``Your poem title''}|. Whatever else you put into
3377 % the header, the last thing should be your poem title, since it will be followed by the line
3378 % numbers.\end{sloppypar}
3379 %
3380 % \subsection{~Page geometry and type leading}
3381 %
3382 % You have to give geometry the values that suit you. I include the
3383 % values I used in my own book, just to give you a starting place.
3384 % The default values for marginparsep and
3385 % marginparwidth are different now (18pt and 18pt respectively). With
3386 % that warning, here is a list of the values I used:
3387 %
3388 % \bigskip
3389 %
3390 % \begin{tabular}{l l}
3391 % textheight&6.75in\\
3392 % marginparsep&18pt\\
3393 % marginparwidth&18pt\\
3394 % headheight& 14pt\\
3395 % paperwidth&6in\\
3396 % paperheight& 9in\\
3397 % inner&4.5pc\\
3398 % outer&4.5pc\\
3399 % footskip&15pt\\
3400 % \end{tabular}
3401 %
3402 %\bigskip
3403 %
3404 %%
3405 % In my own book I also, strictly to save money, and at the price of
3406 % some ugliness, changed the definition of |\normalsize| and |\small|,
3407 % so that the former was 10 pt type on 11 pt leading (rather than 12
3408 % pt), and that the latter was 9 pt type on 10 pt leading. You can
3409 % reproduce this setting by issuing |\tightleading|, although I would
3410 % advise not doing so unless you are under financial constraints.
3411 %
3412 % \section{Prose Sections with line numbers} \label{prosesections}
3413 % \subsection{Setup}
3414 %\textsf{poemscol}
3415 % uses the \textsf{lineno} package to make marginal line numbers for
3416 % prose sections such as the Author's Introduction, Afterword,
3417 % Author's Notes, or such prose interludes or prose poems the volume
3418 % may include. To control the appearance, placement, and frequency of
3419 % marginal line numbers in prose sections, you may wish to consult the
3420 % manual to \textsf{lineno}. I have added a minimal user interface to
3421 % make \textsf{lineno} cohere with poemscol. You may have to fiddle
3422 % with the parameters of both \textsf{poemscol} and \textsf{lineno} to
3423 % persuade them to set marginal line numbers that look the same way in
3424 % prose and verse contexts. The default values should work as is.
3425 %
3426 % Line numbers in prose sections are placed using a different
3427 % |\length| from that used in verse sections. Essentially, verse
3428 % sections, and prose sections which use paragraph and sentence
3429 % numbering --- see below, in section \ref{paragraphsentence} ---
3430 % place the marginal line numbers using |\marginparsep|. Prose
3431 % sections which are numbered by line use |\linenumbersep| instead,
3432 % which is a length defined in the \textsf{lineno} package. I have
3433 % given values for both lengths which seem to place line numbers on
3434 % the left and on the right side in prose sections roughly where they
3435 % are placed in verse sections. You can change these values with
3436 % |\setcounter{countername}{length}|.
3437 %
3438 % |\verselinenumberstoleft| and |\verselinenumberstoright| also place
3439 % the line numbers to the left or to the right, respectively, in prose
3440 % sections. If you wish the numbering to appear on a different side
3441 % in prose contexts you can set the side by issuing |\leftlinenumbers|
3442 % or |\rightlinenumbers|. These last are commands from the
3443 % \textsf{lineno} package. The two forms in which line numbers switch
3444 % sides in prose contexts can't at the moment be used, because of a
3445 % clash between how \textsf{lineno} handles line numbers that switch
3446 % sides and the way I pass the line numbers to notes sections. If you
3447 % have set the verse line numbers to switch sides, prose line numbers
3448 % will appear on the right side. I hope soon to find a workaround for
3449 % this problem.
3450 %
3451 % By default, the line modulo for prose sections is the same as that for
3452 % verse sections; if you have a line number every 5 lines in verse,
3453 % you will have the same in prose. You can set the prose line modulo
3454 % independently with |\setprosemodulo|.
3455 %
3456 % \textsf{poemscol} may deal with rather long stretches of prose, but
3457 % it is not designed to be used for critical editions of extended
3458 % prose texts, as \texttt{EDMAC}, \textsf{reledmac}, or \textsf{ednotes}
3459 % are. The method of entering line ranges into notes in prose
3460 % contexts is something of a hack, and rather a worse one than the one
3461 % employed in verse contexts, since it involves using two labels for
3462 % each note, one to capture the line number of the beginning, the
3463 % other to capture the line number of the end. Other limitations of
3464 % this method may show up with longer prose extracts.
3465 %
3466 % \DescribeMacro{\prosesectiontitle} Prose sections may be titled with
3467 % |\prosesectiontitle| which is essentially just |\poemtitle|, or
3468 % |\prosesectiontitlenotitle|, which is essentially just
3469 % |\poemtitlenotitle|. (Remember that if you use the latter command,
3470 % you must specify a ``dummy'' title to use in the note and contents
3471 % sections.) They will be formatted in the notes and contents
3472 % sections as poems are. Alternatively, you can use
3473 % the commands for defining new kinds of titles, in section
3474 % \ref{customizing titles}, page \pageref{customizing titles},
3475 % to make new kinds of titles for prose sections.
3476 %
3477 %\DescribeMacro{prosesection}
3478 % Prose sections should be enclosed in a |prosesection| environment
3479 % (between |\begin{prosesection}| and |\end{prosesection}|). Entering
3480 % this environment sets the modulo repeat for line numbering to the
3481 % same value that prevails in verse contexts, and resets the prose
3482 % line number to zero. If for some reason you do not wish to reset
3483 % the line number but continue on from where it left off at the end of
3484 % the last prose section, use the |prosesectionnoreset| environment
3485 % instead.
3486 %
3487 % \DescribeMacro{\setprosemodulo}
3488 % If you wish to set the modulo repeat for line numbering in prose to
3489 % some value different for that from verse contexts, issue the new
3490 % modulo as the argument to |\setprosemodulo|.
3491 %
3492 % It is possible, if a prose section is interpolated in the midst of
3493 % verse, to number the prose and verse continuously. To move from a
3494 % verse passage to a prose passage, just before the |\end{poem}| at
3495 % the end of the first verse passage issue |\saveverselinenumber| to
3496 % save the number of the verse passage. After you issue
3497 % |\begin{prosesection}| issue
3498 % |\resetlinenumber[\theverselineumberscratch]| to apply that number
3499 % to the prose section. To number continuously while moving from
3500 % prose to verse is more tricky. One way might be to mark a label at
3501 % the end of the prose passage with |\proselinelabel{prose end label}|
3502 % (or some other suitably unique label). This label will record the
3503 % line number of the last prose line. Pass that value to
3504 % |\restoreverselinenumber| by issuing
3505 % |\setcounterfromref{verselinenumberscratch}{prose end label}|. Then
3506 % issue |\restoreverselinenumber| just after issuing the
3507 % |\begin{poem}| that restarts the verse again. I would recommend
3508 % against numbering verse and prose continuously, however, since a
3509 % verse line and a prose line are different categories of thing, the
3510 % one being an element of prosody, the other being only an element of
3511 % typography.
3512 %
3513 %
3514 % \DescribeMacro{\proselinelabel}
3515 % |\proselinelabel| is simply |\linelabel| from \textsf{lineno}. I
3516 % have provided the new name to make it easy to distinguish from
3517 % |\poemlinelabel|.
3518 %
3519 %
3520 % \subsection{Endnotes for prose sections}
3521 % \begin{sloppypar}
3522 % \DescribeMacro{\prosetextnote}
3523 % \DescribeMacro{\prosemendation}
3524 % \DescribeMacro{\proseexplanatory}
3525 % Special versions of |\textnote|, |\emendation| and |\explanatory|
3526 % are available for use in prose sections. |\prosetextnote|,
3527 % |\proseemendation|, and |\proseexplanatory| differ from the verse
3528 % versions in that they each require an extra argument, a unique label
3529 % to be used in locating the line number for use by the notes
3530 % commands. If |\maketextnotes|, |\makeemendations|, or
3531 % |\makeexplanatorynotes| have been issued, the endnotes will be sent
3532 % to the usual sections, where all the notes from that prose section
3533 % will be grouped into a paragraph, with the entry headed by the title
3534 % given by |\prosesectiontitle|, just as if that were the title of a
3535 % poem. |\textnotesatfoot|, |\emendationsatfoot|, and
3536 % |\explanationsatfoot| will send the notes from prose contexts to the
3537 % usual footnote levels. Notes commands in prose contexts take three
3538 % arguments. As in verse sections, in prose sections textnotes,
3539 % explanatory notes, and emendations have an optional first argument
3540 % for recording line ranges. As in verse sections, you can record
3541 % these line ranges either by simply putting in the argument how many
3542 % lines the lemma will refer to (a deprecated method retained for
3543 % backward compatibility reasons), or the argument of a
3544 % |\proselinelabel| command on the last line of the lemma. (The only
3545 % difference from the verse version here is that you should make the
3546 % label using the |\proselinelabel| command, rather than with the
3547 % |\poemlinelabel| command.) The second argument is a label to
3548 % identify each note uniquely, which is used to find the line number
3549 % at which the note begins. You will need a different label for
3550 % every note. The third argument is the text of the note, which
3551 % should include both the lemma and the rest of the note, as in the
3552 % notes for verse sections.
3553 % |\proseemendation| and
3554 % |\proseexplanatory| are coded the same way. So, if you wished
3555 % to make a textual note on a passage that begins with ``Call me
3556 % Ishmael.'' and ends ``a way of driving away the spleen,'' you would
3557 % issue at the point where the note is to
3558 % occur (at the beginning of the passage):
3559 % \begin{verbatim}
3560 % \prosetextnote[a way of driving away the spleen] {Call me Ishmael}
3561 % {Call me Ishmael \ldots\ a way of driving away the spleen] text of
3562 % textual note} \end{verbatim} On the
3563 % last line of the passage to which the note refers you would
3564 % issue: \\ |\proselinelabel{a way of driving away the spleen}|.\end{sloppypar}
3565 %
3566 % \DescribeMacro{\prosetsvariant}
3567 % \DescribeMacro{\proseaccidental}
3568 % \DescribeMacro{\prosetsaccidental}
3569 % You can issue |\sources| and |\tsentry| in prose contexts as usual.
3570 % For typescript variants and accidental variants you need to issue
3571 % |\prosetsvariant|, |\proseaccidental|, and
3572 % |\prosetsaccidental|. |\prosetsvariant| is entered just as
3573 % |\prosetextnote| is, with an optional argument (for use with
3574 % line ranges, as usual), and two mandatory arguments (the first a
3575 % label to capture the line number, the second the lemma and comment).
3576 %
3577 % |\proseaccidental| and |\prosetsaccidental| take only the two
3578 % mandatory arguments, since by definition an accidental variant is
3579 % confined to one line.
3580 %
3581 % One caveat: because the line numbers for notes in prose contexts
3582 % are generated by a label/ref mechanism, each note will result in a
3583 % complaint about an undefined reference the first time the file is run through
3584 % \LaTeX. Either run the first pass in quiet mode, or be prepared to
3585 % ignore a lot of griping until
3586 % \LaTeX\ has generated the .aux file at the end of the first run.
3587 %
3588 % \section{Paragraph and sentence annotation}\label{paragraphsentence}
3589 % \subsection{~Setup}
3590 % Annotating a prose section by sentence number, or by paragraph number and
3591 % sentence number, has some advantages over annotating it by line
3592 % number. The principal advantage is that the annotation and reference
3593 % system can remain stable over multiple editions, even if they are set
3594 % in different formats. The most familiar of such systems is the
3595 % chapter and verse system in the Bible, introduced by Archbishop
3596 % Stephen Langton in the thirteenth century (who divided the Vulgate
3597 % edition into numbered chapters) and by Robert Estienne in the
3598 % sixteenth century (who added the verse numbers). Such a form of
3599 % annotation might be especially useful for medieval prosimetra, a form
3600 % combining verse and prose. (Hence the commands that follow often
3601 % begin with |pm|.)
3602 %
3603 % \DescribeMacro{pmsection}
3604 % You should put prose marked up for sentence and paragraph
3605 % annotation in a |pmsection| environment.
3606 % You do not need to put prose marked up for sentence and paragraph
3607 % annotation in a |prosesection| environment. That environment is
3608 % only needed if you are line-numbering prose. You also do not need
3609 % to load the \textsf{lineno} package if you are using the sentence
3610 % and paragraph system for annotating prose. You might, however,
3611 % still wish to set the title with |\prosesectiontitle|.
3612 %
3613 % \DescribeMacro{\setprosebysentence}
3614 % |\setprosebysentence| sets \textsf{poemscol} to number prose by
3615 % sentence rather than by line number. This command is mostly a
3616 % placeholder now, used only for setting the value of |\marginparsep|
3617 % to something better for prose. (|\marginparsep| sets how far the
3618 % line numbers are from the text block.) |\verselinenumberstoleft|,
3619 % |\verselinenumberstoright|, and |\verselinenumbersswitch| each pick
3620 % convenient values for |\marginparsep|. By default these values all
3621 % line up on the page, but if you change any of them, you may have to
3622 % use reset |\marginparsep| to some value you will have to find by
3623 % trial and error, since they each use |\marginparsep| in slightly
3624 % different ways. You can change |\marginparsep| either by using
3625 % |\setlength{\marginparsep}{length}| or, better, by using
3626 % |\renewcommand| to change the setting of |\marginparsep| in
3627 % |\verselinenumberstoleft| or whatever else you intend to use. Adjust
3628 % |\headoffsetlength| to make the page numbers line up with the line numbers.
3629 %
3630 %
3631 % \DescribeMacro{\pmsentence} Each sentence must begin with
3632 % |\pmsentence|. |\pmsentence| increments the sentence counter,
3633 % optionally puts the sentence number in the running text, and
3634 % optionally puts the sentence number in the margin.
3635 %
3636 % |\runningsentencenumberstrue|
3637 % sets sentence
3638 % numbers in the running text.
3639 % To set sentence numbers in the margin, issue
3640 % |\marginsentencenumberstrue|. You can issue both, either, or neither of
3641 % these commands.
3642 %
3643 % \DescribeMacro{\setpmmodulo} If you are putting sentence numbers in
3644 % the margin, you need not number every sentence. Indeed, if there is
3645 % more than one sentence on a line, the numbers will overwrite each
3646 % other (unless you use the marn.sty package, and substitute |\marn|
3647 % for |\pmclrightsidepar|, |\pmclleftsidepar| or |\pmclsidepar| in the
3648 % code for |\pmsentence|). You can also avoid overlapping sentence
3649 % numbers by using |\pmsentencetwo| and its siblings, defined below.
3650 % You can set the modulo for sentence marginal numbers by issuing
3651 % |\setpmmodulo|.
3652 %
3653 % \DescribeMacro{\pmsentencetwo}
3654 % \DescribeMacro{\pmsentencethree}
3655 % \DescribeMacro{\pmsentencefour} If you know, from a prior run,
3656 % that there will be a second or third sentence on some particular
3657 % line, marking them with these commmands will ensure that the
3658 % marginal sentence numbers do not overwrite each other. These commands
3659 % are something of a kludge, but they will do until I figure out how
3660 % to do this better.\newpage
3661 %
3662 % \DescribeMacro{\pmnumberstoright}
3663 % \DescribeMacro{\pmnumberstoleft}
3664 % \DescribeMacro{\pmnumbersgutter}
3665 % \DescribeMacro{\pmnumbersouter}
3666 % If you wish to control the
3667 % margin in which sentence and paragraph numbers appear, issue
3668 % |\pmnumbersright|, |\pmnumbersleft|, |\pmnumbersgutter|, or
3669 % |\pmnumbersouter|. By default, these numbers will line up with the
3670 % line numbers in verse sections. If you change the value of
3671 % |\marginparsep| for prose sections from those used by their verse
3672 % equivalents, it is a good idea to issue the verse equivalent command
3673 % (|\versenumberstoright| or whatever) again when you move from a
3674 % prose to a verse environment.
3675 %
3676 % \begin{sloppypar}
3677 % |\runningsentencenumberformat| sets the format of running sentence
3678 % numbers. Currently it is |\textsuperscript| (the numbers are set as superscripts) and |\tiny|.
3679 % The format of marginal sentence
3680 % numbers is set by |\marginsentencenumberformat|. Currently it is
3681 % |\tiny|. Definitions of both commands are found at section \ref{runningsentencenumberformat},
3682 % page \pageref{runningsentencenumberformat}. You can change either with |\renewcommmand|.
3683 %\end{sloppypar}
3684 %
3685 % \DescribeMacro{\pmpara}
3686 % \DescribeMacro{\pmsentencebypara}
3687 % \DescribeMacro{\pmsparainmartrue}
3688 % \DescribeMacro{\pmpararunningtrue}
3689 % You can also number paragraphs. Each paragraph must begin with
3690 % |\pmpara|. |\pmpara| increments the paragraph counter, optionally
3691 % puts the paragraph number in the running text, and optionally puts
3692 % the paragraph number in the margin. To reset the sentence counter
3693 % at the beginning of each paragraph, issue |\pmsentencebyparatrue| in
3694 % your preamble. To set paragraph numbers in the margin, issue
3695 % |\pmparainmartrue|. To set paragraph numbers in the running text,
3696 % issue |\pmpararunningtrue|. You can issue both, either, or neither of
3697 % these last two commands. Which margin these numbers are set in
3698 % is controlled by the same commands that control placement of
3699 % marginal sentence numbers.
3700 %
3701 % If you begin a paragraph with |\pmpara| \textsf{poemscol} will
3702 % assume that you intend to include the paragraph number in your
3703 % notes (in the form \textless \emph{paragraph
3704 % number}\textgreater:\textless \emph{sentence number}\textgreater\ for simple
3705 % references, or \textless \emph{first paragraph
3706 % number}\textgreater:\textless \emph{first sentence number}\textgreater\ --
3707 % \textless \emph{lastparagraph
3708 % number}\textgreater:\textless \emph{last sentence number}\textgreater\
3709 % for ranges of sentences) even if you do not reset
3710 % the sentence number at the beginning of each paragraph. Normally
3711 % you would not issue |\pmpara| if you are not resetting the sentence
3712 % number at the beginning of each paragraph, since under those
3713 % circumstances you don't really need to keep track of the paragraph
3714 % numbers, in which case each note would simply include the sentence
3715 % number (just as in verse it would include the line number). In the
3716 % unusual event in which you wish to put the paragraph number in the
3717 % margin but refer only to sentence numbers in the notes, simply
3718 % follow every use of |\pmpara| with |\pmparasfalse|.
3719 %
3720 % \DescribeMacro{\pmpararunningformat}\DescribeMacro{\pmparmarformat}
3721 % The format of running paragraph numbers is set
3722 % by |\pmpararunningformat|. Currently it is
3723 % |\textbf| and |\small|.
3724 % The format of marginal paragraph numbers is set by
3725 % |\pmparmarformat|. Currently it is
3726 % |\textbf| and |\small|. The definitions of these commands are found at
3727 % section \ref{pmparrunningformat}, page \pageref{pmparrunningformat}, Either can
3728 % be changed with |\renewcommand|.
3729 %
3730 % \DescribeMacro{\ifsupressfirstpara}
3731 % \DescribeMacro{\ifsuppressfirstsentence}
3732 % Some readers find it annoying to have the first sentence or the first paragraph marked.
3733 % To suppress the appearance of the first sentence number, whether in the margin or in the
3734 % running text, issue |\suppressfirstsentencetrue|. To suppress the appearance of the
3735 % first paragraph number, whether in the margin or in the running text, issue |\suppressfirstparatrue|.
3736 % These commands will not affect the appearance of entries in the endnote
3737 % sections or in the footnotes.
3738 %
3739 % \subsection{~Cross references by sentence and paragraph}
3740 % \DescribeMacro{\sentencelabel}
3741 % To make labels that refer to sentences or paragraphs, issue
3742 % |\sentencelabel|. The label will be either both the paragraph
3743 % number and the sentence number (if you are resetting sentence numbers
3744 % by paragraph), or only the sentence number (if you are not resetting
3745 % sentence numbers by paragraph).
3746 %
3747 % \subsection{~End notes by sentence and paragraph}
3748 %
3749 % \begin{sloppypar}
3750 % \DescribeMacro{\pmtextnote}
3751 % \DescribeMacro{\pmexplanatory}
3752 % \DescribeMacro{\pmemendation}
3753 % \DescribeMacro{\pmaccidental}
3754 % \DescribeMacro{\pmtsvariant}
3755 % \DescribeMacro{\pmtsaccidental}
3756 % |\pmtextnote|, |\pmexplanatory|, |\pmemendation|, |\pmaccidental|,
3757 % |\pmtsvariant| and |\pmtsaccidental| are special versions of the
3758 % usual endnote commands for use with annotations by sentence and
3759 % paragraph. If you have not issued |\pmsentencebypara| these
3760 % commands will write the sentence number at the head of each note,
3761 % where the line number would usually go. If you have issued
3762 % |\pmsentencebypara|, these commands will issue both the paragraph
3763 % and sentence number, in the format \textless \emph{paragraph
3764 % number}\textgreater:\textless \emph{sentence number}\textgreater. You can
3765 % refer to ranges of sentences (or paragraphs and sentences) in a way
3766 % very similar to how you do so in verse sections. At the end of the
3767 % range, issue a |\sentencelabel| command, with a unique label. At
3768 % the beginning of the range, issue your |\pmtextnote| command with the
3769 % optional argument in square brackets before the main argument,
3770 % giving your unique label as the value of that argument, e.g.
3771 % |\pmtextnote[some label]{text of lemma] comment}|. At the end of
3772 % your range, issue |\sentencelabel{some label}|, using the same
3773 % label you put in the square brackets for the |\pmtextnote|. If you have not
3774 % issued |\pmsentencebypara|, the range will simply be the range of
3775 % sentence numbers. If you have issued |\pmsentencebypara|, the range
3776 % will include paragraph and sentence numbers, like this:
3777 %\textless \emph{first paragraph
3778 % number}\textgreater:\textless \emph{first sentence number}\textgreater\ --
3779 % \textless \emph{lastparagraph
3780 % number}\textgreater:\textless \emph{last sentence number}\textgreater, for example:
3781 % 4:12--6:13.\end{sloppypar}
3782 %
3783 % |\sources| needs no special handling if you are annotating by
3784 % sentence and paragraph.
3785 %
3786 % \subsection{~Footnotes by sentence and paragraph}
3787 % |\textnoteatfoot| shifts |\pmtextnotes| to the foot, as with
3788 % |\prosetextnote|. |\emendationsatfoot| and |\explanationsatfoot|
3789 % work the same way.
3790 % \subsection{~Bible chapter and verse}
3791 % Since |\pmsentence| and |\pmpara| are the moral equivalents of bible
3792 % verse and chapter, |\biblechapter| and |\bibleverse| are provided
3793 % for convenience.
3794
3795 % \section{Parallel text editions} \label{parallelhack}
3796 % \subsection{~Setup for parallel texts in verse}
3797 % \textsf{poemscol} can make parallel
3798 % text editions in which the contrasting versions are set on facing
3799 % verso and recto pages. \textsf{poemscol} does not automatically provide the page
3800 % breaks for parallel editions, and even if it did, one would still
3801 % probably have to specify page breaks every two or three pages to keep
3802 % the texts in register anyway, so you will have to use |\newpage|
3803 % to mark every page break. If you are willing to set the page breaks
3804 % yourself, however, \textsf{poemscol} does provide commands for keeping the line count
3805 % correct on successive recto or verso pages, and for keeping track of
3806 % whether or not one was in the middle of a stanza when one closed the
3807 % previous verso or recto page (as the case may be). And it provides, in
3808 % the |\synchrolabel| and |\synchroref| commands, a way of marking which
3809 % lines on the recto side correspond to particular lines on the verso
3810 % side. |\synchroref| will even tag the marginal line number it makes
3811 % with a marker to specify the text to which it refers.
3812 %
3813 % \begin{sloppypar}
3814 % \DescribeMacro{\startparalleltexts}
3815 % \DescribeMacro{\finishparalleltexts}
3816 % \DescribeEnv{parallelverse}
3817 % You must begin a region of parallel text on a \emph{verso} page.
3818 % A parallel text region must begin with
3819 % |\startparalleltexts| and end with |\finishparalleltexts|.
3820 % Setting parallel texts requires one to redefine the poem and stanza
3821 % environments, and |\startparalleltexts| redefines those environments.
3822 % You can make those changes local to the parallel text region by using
3823 % |\begin{parallelverse}| and |\end{parallelverse}| rather than |\startparalleltexts|
3824 % and |\finishparalleltexts|.
3825 % |\startparalleltexts| and |\finishparalleltexts| can be issued on their own
3826 % but I have combined them to make the |parallelverse| environment. \end{sloppypar}
3827 %
3828 % Although usually with \textsf{poemscol} it is up to you where to put
3829 % the marginal line numbers, when you issue |\startparalleltexts| the
3830 % positions are fixed as follows: marginal line numbers are in the left
3831 % margin, line cross references (marking which lines in the recto text
3832 % correspond to which lines in the verso text, which
3833 % are made with |\synchroref|) are in the right margin.
3834 %
3835 %\begin{sloppypar}
3836 % \DescribeMacro{\startrectopage}
3837 % \DescribeMacro{\finishrectopage}
3838 % \DescribeMacro{\startversopage}
3839 % \DescribeMacro{\finishversopage}
3840 % Verso pages
3841 % should begin with |\startversopage| and end with |\finishversopage|.
3842 % Recto pages should begin with |\startrectopage| and end with
3843 % |\finishrectopage|. You have to declare the page breaks manually,
3844 % so be sure you are putting the |\finishversopage| or |\finishrectopage| commands
3845 % in places which
3846 % will work. |\finishparalleltexts| just makes certain that stanzas, and poems,
3847 % that you opened in a region of parallel texts are closed when you leave it.\end{sloppypar}
3848 %
3849 % \DescribeMacro{\versopoemtitle}
3850 % \DescribeMacro{\rectopoemtitle}
3851 % \DescribeMacro{\versopoemtitlenocontents}
3852 % \DescribeMacro{\rectopoemtitlenocontents}
3853 % Use |\versopoemtitle| and |\rectopoemtitle|
3854 % rather than |\poemtitle| for the title of the poem (or prose passage)
3855 % on the verso or recto pages.
3856 % if you are making a parallel text of Wordsworth's 1805 and 1850
3857 % versions of \emph{The Prelude}, you might want to use something
3858 % like |\versopoemtitle{The Prelude (1805 Version)}| and
3859 % |\rectopoemtitle{The Prelude (1850 Version)}|.
3860 % I have also made versions of these commands that do not make
3861 % entries in the table of contents, should the need arise for them.
3862 % If you wish to make titles for other things,
3863 % such as poetic sequences or sequence sections, you can use the techniques
3864 % described in section \ref{customizing titles} above, page \pageref{customizing titles},
3865 % except substitute the command |\versoset@p@emtitle|
3866 % or |\rectoset@p@emtitle| for |\set@p@emtitle|, using
3867 % all the same arguments you would have used with |\set@p@emtitle|.
3868 %
3869 %\subsection{~Parallel texts and on the fly note types}
3870 % If you are making a parallel text edition, you may need to
3871 % use |\definenewnotetype| to make the different kinds of endnote
3872 % for the parallel texts. For instance,
3873 % if you are making a parallel text of Wordsworth's 1805 and 1850
3874 % versions of \emph{The Prelude}, you may use something like |\fiveexplanatory|
3875 % and |\fiftyexplanatory| for explanatory notes for the poems on the verso
3876 % and recto pages.
3877 %
3878 %
3879 % \DescribeMacro{\keeptitlestraight}
3880 % Without special care, \textsf{poemscol} may become
3881 % confused about whether it has seen, for example, a |\fiveexplanatory| for
3882 % a particular book of \emph{The Prelude} or not, and, if |\settitleinnotes| is set,
3883 % may neglect to put the
3884 % title of that book of \emph{The Prelude} in the notes
3885 % for the first note for that book. To remedy this, |\versopoemtitle|
3886 % and |\rectopoemtitle| set up a way of keeping track whether each species
3887 % of note has appeared already or not.
3888 % While setting parallel texts \textsf{poemscol} checks at the beginning of every
3889 % verso or recto page whether the the different species of endnote for the poem on
3890 % that page has appeared before. On rare occasions this turns out not to be frequently
3891 % enough in cases
3892 % where you are defining your own kinds of endnote.
3893 % In this case, the following hack, |\keeptitlesstraight|, will check whether the verso or recto
3894 % poem has set that species of note each time it is issued. Suppose, for instance,
3895 % going back to our Wordsworth example,
3896 % that you have defined, using |\definenewnotetype|, the following six
3897 % kinds of endnotes: |\fivetextnote| |\fiveemendation|, |\fiveexplanatory|,
3898 % |\fiftytextnote|, |\fiftyemendation|, and |\fiftyexplanatory|. You should
3899 % define a new command called |\keeptitlesstraight| to keep track of these six
3900 % kinds of note. Here is how it might look:
3901 %
3902 % \medskip
3903 %
3904 % \noindent|\newcommand{\keeptitlesstraight}{|\\
3905 % |\pretocmd{\fivetextnote}{\versotitleinnotescheck}{\relax}{\relax}|\\
3906 % |\pretocmd{\fiveemendation}{\versotitleinnotescheck}{\relax}{\relax}|\\
3907 % |\pretocmd{\fiveexplanatory}{\versotitleinnotescheck}{\relax}{\relax}|\\
3908 % |\pretocmd{\fiftytextnote}{\rectotitleinnotescheck}{\relax}{\relax}|\\
3909 % |\pretocmd{\fiftyemendation}{\rectotitleinnotescheck}{\relax}{\relax}|\\
3910 % |\pretocmd{\fiftyexplanatory}{\rectotitleinnotescheck}{\relax}{\relax}|\\
3911 % |}|
3912 %
3913 % \medskip
3914 %\begin{sloppypar}
3915 % All those fields filled with |\relax| are for reporting the success or failure
3916 % |\pretocmd| has had in appending |\versotitleinnotescheck| (or |\rectotitleinnotescheck|)
3917 % to the different endnotes commands. You may wish to replace
3918 % the |\relax| with something like |\typeout{fiftytextnote modified}| or
3919 % |\typeout{fiftytextnote not modified}|. \end{sloppypar}
3920 %
3921 %If you are using the |\keeptitlestraight|
3922 % hack described here, you should add \textsf{etoolbox}
3923 % to your package list.
3924 %
3925 % \DescribeMacro{\resettitleinnotes}
3926 % If you are defining new kinds of note, and a section of
3927 % non-parallel texts follow a section of parallel texts, you
3928 % will need to issue the following hack after the parallel texts close
3929 % (again I am using the Wordsworth example):\\
3930 % |\newcommand{\resettitleinnotes}{|\\
3931 % |\nofiveemendationyettrue%|\\
3932 % |\nofiveexplanatoryyettrue%|\\
3933 % |\nofivetextnoteyettrue%|\\
3934 % |\nofiftyemendationyettrue%|\\
3935 % |\nofiftyexplanatoryyettrue%|\\
3936 % |\nofiftytextnoteyettrue%|\\
3937 % |}|
3938 %
3939 % \subsection{~Parallel texts and generic note types}
3940 % \begin{sloppypar}
3941 % \DescribeMacro{\rectotexnote}
3942 % \DescribeMacro{\rectoemendation}
3943 % \DescribeMacro{\rectoexplanatory}
3944 % \DescribeMacro{\versotexnote}
3945 % \DescribeMacro{\versoemendation}
3946 % \DescribeMacro{\versoexplanatory}
3947 % In case you find using these hacks a bit burdensome,
3948 % I have defined for your convenience six generic kinds of endnote for use in parallel text
3949 % editions: |\rectotextnote|, |\rectoeemendation|, |\rectoexplanatory|,
3950 % |\versotextnote|, |\versoemendation|, and |\versoexplanatory,| as well as |\rectoprosetexnote|,
3951 % |\versoprosetextnote,| |\rectoproseemendation,| |\versoproseemendation|,
3952 % |\rectoproseexplanatory|, and |\versoproseexplanatory.|
3953 % \end{sloppypar}
3954 %
3955 % \begin{sloppypar}
3956 % I have also defined
3957 % |\literalrectotextnote|, |\literalversotextnote|, |\literalrectoemendation|, |\literalversoemendation|,
3958 % |\literalrectoexplain|, and |\literalversoexplain| for sending material other than formal
3959 % endnotes to these endnote sections.
3960 % \end{sloppypar}
3961 %
3962 % You can use all of these without creating versions of |\keeptitlesstraight| and
3963 % |\resettitleinnotes|.
3964 %
3965 %
3966 % \begin{sloppypar}
3967 % \DescribeMacro{\makerectotexnotes}
3968 % \DescribeMacro{\makerectoemendations}
3969 % \DescribeMacro{\makerectoexplanatorynotes}
3970 %To use these
3971 % kinds of note, issue |\makeversotextnotes|, |\makeversoemendations|,
3972 % |\makeversoexplanatorynotes| or their recto equivalents in your preamble. You can mark
3973 % up your texts with these notes
3974 % just as you would do with |\textnote|, |\emendation| or |\explanatory| (or |\literalversotextnote|
3975 % |\literalversoemendation| and |\literalversoexplain|), without any of the special hacks
3976 % I have just described.
3977 % \end{sloppypar}
3978 %
3979 % \begin{sloppypar}
3980 % \DescribeMacro{\changerectotextnotesname}
3981 % \DescribeMacro{\changerectotextnotesheader}
3982 % \DescribeMacro{\rectotextnotessinglepar}
3983 % \DescribeMacro{\rectotextnotestwocol}
3984 % I have given the endnotes sections generated by these notes rather
3985 % generic names (|\rectotextnote| and |\versotextnote| for instance, both open endnote sections
3986 % with the title TEXTUAL NOTES, with a running header of the form ``Textual Notes to pp.~xx--yy''
3987 % an a contents entry of Textual Notes). You will probably need to change
3988 % those to something more descriptive. You can change any of these with
3989 % |\changeversotextnotesname{Your Title}|, |\changeversotextnotesheader{Your running header}|,
3990 % and |\changeversotextnotescontentsname{Your contents entry}|.
3991 % You can change the appearance of these notes
3992 % by changing the values of the booleans |\versotextnotessinglepar| and |\versotextnotestwocol|.
3993 % Similar sets of commands are available for |\versoemendation| and |\versoexplanatory|
3994 % and their recto equivalents.
3995 % \end{sloppypar}
3996 %
3997 % \begin{sloppypar}
3998 % \DescribeMacro{\putrectotextnotes}
3999 % To include these note sections in your document, issue |\putversotextnotes|, |\putrectotextnotes|,
4000 % |\putversoemendations|, |\putrectoemendations|, |\putversoexplanatorynotes|, or
4001 % |\putrectoexplanatorynotes| at the point where you wish them to appear. These commands
4002 % behave exactly like |\puttextnotes|.
4003 % \end{sloppypar}
4004 %
4005 % \subsection{~Parallel text labels}
4006 % \DescribeMacro{\synchrolabel} \DescribeMacro{\synchroref}
4007 % \DescribeMacro{\setsynchroflag} You may want to mark cross references
4008 % to make it clear to the reader which line of the poem on the recto side
4009 % of the spread corresponds to a particular line on the verso side.
4010 % To mark these cross references, you
4011 % need to make a label on the verso side (using |\syncrolabel|), and a corresponding
4012 % reference on the recto side (using |\synchroref|). You may also wish to add a mark to
4013 % that reference (using |\setsynchroflag|) to specify to the reader what edition it refers to. So, for
4014 % instance, if your verso text is the 1805 version of Wordsworth's
4015 % \emph{The Prelude}, and your recto text is the 1850 version, you may
4016 % wish to specify |\setsynchroflag{1805: }|, which will preface the
4017 % references put out by the |\synchroref| command with~`1805:~'.
4018 % Suppose you wished to tie these corresponding passages from the ``Boy of Winander''
4019 % episode in Book 3. To make the label, issue the
4020 % |\synchrolabel| command on the verso side (the 1805 side) just after the
4021 % |\verseline| or |\end{stanza}| which closes the line you wish to
4022 % label:
4023 %
4024 % \begin{verbatim}
4025 %This boy was taken from his mates, and died \verseline
4026 %In childhood ere he was full ten years old \verseline
4027 % \synchrolabel{full ten years old}
4028 % \end{verbatim}
4029 % You don't have to quote the whole line in the label, but it should be
4030 % long enough to uniquely pick out that line in the poem. (If the line
4031 % is repeated in the poem, you will have to exercise your ingenuity in
4032 % making up a unique label.)
4033 %
4034 % Over on the recto side (the 1850 side), you will want to use |\synchroref| in order
4035 % to print the marginal cross reference. The |\synchroref| command
4036 % should come \emph{before} the |\verseline| that closes the line it is
4037 % tied to, as follows:
4038 %
4039 % \begin{verbatim}
4040 %This Boy was taken from his mates, and died\verseline
4041 %In childhood, ere he was full twelve years old.
4042 % \synchroref{full ten years old}}\verseline
4043 % \end{verbatim}
4044 %
4045 % \subsection{~Parallel prose passages}
4046 % \DescribeMacro{parallelprose}
4047 % \DescribeMacro{\startparalleltextprose}
4048 % \DescribeMacro{\finishparalleltextprose}
4049 % \textsf{poemscol} is not designed to manage long parallel texts in prose,
4050 % but for shorter texts up to a couple of dozen pages, such as
4051 % two versions of an Author's Preface, say, \textsf{poemscol} has the |parallelprose|
4052 % environment. (You can also use |\startparalleltextprose| and |\finishparalleltextprose|.)
4053 % Like passages of parallel text in verse, parallel prose passages must start
4054 % on a verso page.
4055 %
4056 % \begin{sloppypar}
4057 % \DescribeMacro{\startversoprosepage}
4058 % \DescribeMacro{\finishversoprosepage}
4059 % \DescribeMacro{\startrectoprosepage}
4060 % \DescribeMacro{\finishrectoprosepage}
4061 % Each verso page must start with |\startversoprosepage| and finish with
4062 % |\finishversoprosepage|, and each recto page must start with |\startrectoprosepage|
4063 % and finish with |\finishrectoprosepage|. If a page continues a paragraph from the previous
4064 % page, say, from a previous recto page, put the beginning of the
4065 % text on the second page right after the |\startrectopage| command with
4066 % no blank line. (Alternatively, you could just
4067 % begin that page with |\noindent|.)
4068 % \end{sloppypar}
4069 %
4070 % \DescribeMacro{\parastart}
4071 % \DescribeMacro{\paraend}
4072 % You must mark the beginning and end of every paragraph in parallel prose passages
4073 % with |\parastart| and |\paraend|.
4074 %
4075 % You will have to pick the page breaks manually, using |\newpage|, once you find where
4076 % \LaTeX\ would naturally break the page. Because how \LaTeX\ justifies text is a little
4077 % unpredictable, however, you may find that the line before the page break, which filled
4078 % the line before you added the page break, is actually a little shorter, and thus is
4079 % no longer justified, once you add the page break. You may well not be able to exactly
4080 % fill out the line by trial and error, adding a word or even just a syllable, to the line at a time.
4081 % You can kludge around the problem, however, by adding
4082 % an |\hfil| between each word of the last line.
4083 %
4084 % \section{Using \textsf{poemscol} in a multilingual world}
4085 %
4086 % \begin{sloppypar}
4087 % \DescribeMacro{\changecontentsname}
4088 % By default, \textsf{poemscol} uses English language titles for such
4089 % things as the Table of Contents, the Explanatory Notes, and so on,
4090 % and uses English language running headers. As of version 2.5 these
4091 % are easily changed. To change the name of the Table of Contents
4092 % (the default is CONTENTS) to Inhaltsverzeichnis, issue
4093 % |\changecontentsname{Inhaltsverzeichnis}|. To change the running
4094 % header on contents pages, issue
4095 % |\changecontentsheader{your header}|.\end{sloppypar}
4096 %
4097 % \begin{sloppypar}
4098 % \DescribeMacro{\changenotesname} To change the name for the endnote
4099 % section for textual notes (the default is TEXTUAL NOTES), issue
4100 % |\changenotesname{your version}|. To change the running header (by
4101 % default ``Textual Notes to'') issue
4102 % |\changenotesheader{your version}|.
4103 % To change the name for
4104 % the textual notes in the table of contents issue
4105 % |\changetextnotescontentsname{your version}|.
4106 %
4107 % \DescribeMacro{\changesinglepageabbrev}
4108 % \DescribeMacro{\changemultiplepageabbrev}
4109 % Running headers refer to single pages with the English
4110 % abbreviation ``p.'' and to multiple pages with the English
4111 % abbreviation ``pp.'' To change these issue
4112 % |\changesinglepageabbrev{new abbrev}| or
4113 % |\changemultiplepageabbrev{new abbrev}| respectively. The ultimate
4114 % outcome is to translate a header of the form ``Textual Notes to
4115 % pp.~xx-yy'' to the form appropriate for your language.\end{sloppypar}
4116 %
4117 % \begin{sloppypar}
4118 % \DescribeMacro{\changeemendationsname} To change the name for the endnote
4119 % section for emendations (the default is EMENDATIONS), issue
4120 % |\changeemendationsname{your version}|. To change the running header (by
4121 % default ``Emendations to'') issue
4122 % |\changeemendationsheader{your version}|. To change the name for
4123 % the emendations in the table of contents issue
4124 % |\changeemendationscontentsname{your version}.|\end{sloppypar}
4125 %
4126 %\begin{sloppypar}
4127 % \DescribeMacro{\changeexplanationsname} To change the name for the endnote
4128 % section for explanatory notes (the default is EXPLANATORY NOTES), issue
4129 % |\changeexplanationsname{your version}|. To change the running header (by
4130 % default ``Explanatory Notes to'') issue
4131 % |\changeexplanationsheader{your version}|.
4132 % To change the name for
4133 % the explanatory notes in the table of contents issue
4134 % |\changeexplanationscontentsname{your version}|.\end{sloppypar}
4135 %
4136 % \begin{sloppypar} \DescribeMacro{\changepoemindexname} To change the name
4137 % for the index (the default is ``Index of Titles and First Lines'', issue
4138 % |\changepoemindexname{your version}|. To change the running
4139 % header (the default is ``Index of Titles and First Lines'') issue
4140 % |\changepoemindexheader{your version}|. To change the contents
4141 % entry for the index (the default is ``Index of Titles and First Lines'')
4142 % issue
4143 % |\changepoemindexcontentsname{your version}|.\end{sloppypar}
4144 %
4145 %\section{A sample driver file}
4146 %
4147 % If you are compiling a collected poems, you are probably preparing
4148 % your volume from many files. You may (or may not) wish to subdivide
4149 % your edition by the original volumes. Or you may subdivide by year,
4150 % or by the significant phases of the poet's career. One way to keep
4151 % in control of the process is to create a driver file, which calls
4152 % all the appropriate\ .sty files and sets the variables globally, and
4153 % then read in the sections of the edition using |\input|. Here is a
4154 % version of the driver file I used for
4155 % \emph{The Collected Poems of Robert Penn Warren}:
4156 % \begin{verbatim}
4157 % \documentclass[10pt,twoside]{article}
4158 % \usepackage{fancyhdr,kdgreek,makeidx,times,multicol,geometry,}
4159 % \usepackage{keyval,ifthen,mparhack,manyfoot,poemscol}
4160 % \begin{document}
4161 % \leftheader{The Collected Poems of Robert Penn Warren}
4162 % \makeexplanatorynotes
4163 % \makeemendations
4164 % \maketextnotes
4165 % \makepoemcontents
4166 % \makeverselinenumbers
4167 % \global\indexingontrue
4168 % \global\includeaccidentalstrue
4169 % \global\includetypescriptstrue
4170 % \input maintitle.tex
4171 % \input poems1922_1943.tex
4172 % \input thirtysix.tex
4173 % \input eleven.tex
4174 % \input sp43.tex
4175 % \input promises1.tex
4176 % \input promises2.tex
4177 % \input promises3.tex
4178 % \input yeo1.tex
4179 % \input yeo2.tex
4180 % \input yeo3.tex
4181 % \input tale1.tex
4182 % \input tale2.tex
4183 % \input incarnations.tex
4184 % \input audubon.tex
4185 % \input orelse1.tex
4186 % \input orelse2.tex
4187 % \input arcturus.tex
4188 % \input nowthen.tex
4189 % \input beinghere.tex
4190 % \input rumor1.tex
4191 % \input rumor2.tex
4192 % \input cj1.tex
4193 % \input cj2.tex
4194 % \input altitudes.tex
4195 % \input poems1943_1989.tex
4196 % \input introduction.tex
4197 % \finish
4198 % \end{verbatim}
4199 %
4200 % \section{A sample poem markup}
4201 % Here is a poem Robert Penn Warren wrote in his first volume,
4202 % \emph{Thirty-Six Poems} (1935). The poem is the first poem of his
4203 % sequence ``Kentucky Mountain Farm.'' I include the over-title, to
4204 % demonstrate how to mark up such cases.
4205 % \begin{verbatim}
4206 % \sequencetitle{Kentucky Mountain Farm}
4207 % \index{Kentucky Mountain Farm@{\em Kentucky Mountain Farm\/}}
4208 % \sources{Text: TSP. Variants: SP43, SP66 (Deletes ``The Cardinal,'' ``The
4209 % Jay,'' and ``Watershed''), SP75 (Same sections as SP66), SP85 (Restores
4210 % ``Watershed''), {\em Helsinki\/} (includes only ``Rebuke of
4211 % the Rocks'' and
4212 % ``At the Hour of the Breaking of the Rocks'').
4213 % ``The Owl'' (above) was marked as a section of ``Kentucky
4214 % Mountain Farm'' when it first appeared in {\em Poetry,\/} but it was never
4215 % included in any book version of the entire sequence. The sequence in {\em
4216 % Poetry\/} included, in this order, ``The Owl,'' ``The Cardinal,'' and
4217 % ``Watershed.'' TSP uses lower case Roman numerals in the section
4218 % titles. The typescript drafts in the Beinecke Library do not seem to
4219 % be setting copies.}
4220 % \sequencefirstsectiontitle{I. Rebuke of the Rocks}
4221 % \index{Rebuke of the Rocks@{\em Rebuke of the Rocks\/}}
4222 % \sources{Text: TSP. Variants: {\em Nation\/}, 11 Jan.\ 1928,
4223 % p.~47, {\em Literary
4224 % Digest,\/} 28 Jan.\ 1928, p.~32, {\em Vanderbilt Masquerader,\/} 10
4225 % (Dec.\ 1933), p.~16, SP43, SP66, SP75, SP85, {\em Helsinki\/},
4226 % Broadside: The Press at Colorado College, printed on paper handmade by
4227 % Thomas Leech for the American Poetry Society, April~26, 1985. This
4228 % poem was not included in SP85 until the second set of galleys, in
4229 % which a photocopy of the SP75 text is a stapled insert.}
4230 % \begin{poem}
4231 % \begin{stanza}
4232 % Now on you is the hungry equinox,\verseline
4233 % \index{Now on you is the hungry equinox}
4234 % O little stubborn people of the hill,\verseline
4235 % \accidental{hill,] \sameword--- {\em Nation,\/} {\em Literary Digest\/}
4236 % \sameword, {\em Vanderbilt\/} (I include the reading
4237 % from {\em Vanderbilt\/}
4238 % even though it is the same as in TSP, because
4239 % {\em Vanderbilt\/} was published
4240 % after the other magazine versions but before TSP.)}
4241 % The season of the obscene moon whose pull\verseline
4242 % Disturbs the sod, the rabbit, the lank fox,\verseline
4243 % Moving the waters, the boar's dull blood,\verseline
4244 % And the acrid sap of the ironwood.\end{stanza}
4245 %
4246 % \begin{stanza}
4247 % But breed no tender thing among the rocks.\verseline
4248 % Rocks are too old under the mad moon,\verseline
4249 % \accidental{old\missingpunct] \sameword, {\em Vanderbilt\/}}
4250 % Renouncing passion by the strength that locks\verseline
4251 % The eternal agony of fire in stone.\end{stanza}
4252 %
4253 % \begin{stanza}
4254 % Then quit yourselves as stone and cease\verseline
4255 % \accidental{stone\missingpunct] \sameword, {\em Vanderbilt\/}}
4256 % To break the weary stubble-field for seed;\verseline
4257 % Let not the naked cattle bear increase,\verseline
4258 % Let barley wither and the bright milkweed.\verseline
4259 % \accidental{milkweed.] milk-weed. {\em Vanderbilt\/}}
4260 % Instruct the heart, lean men, of a rocky place\verseline
4261 % That even the little flesh and fevered bone\verseline
4262 % May keep the sweet sterility of stone.\end{stanza}
4263 % \end{poem}
4264 % \end{verbatim}
4265
4266 % \goodbreak
4267 % \section{A sample divider page}
4268 % \begin{verbatim}
4269 % \begin{volumetitlepage}
4270 %
4271 % \volumetitle{Being Here}
4272 % \volumeheader{Being Here}
4273 % \volumesubtitle{Poetry 1977--1980}
4274 % \volumededication{To Gabriel Thomas Penn\\
4275 % (1836--1920)}
4276 % \bigskip
4277 %
4278 % \volumeepigraph{OLD MAN: You get old and you can't do anybody
4279 % any good any more.\\
4280 % BOY: You do me some good, Grandpa. You
4281 % tell me things.}
4282 %
4283 %
4284 % \bigskip
4285 %
4286 % \volumeepigraph{There is in short no absolute time standard.}
4287 % \volumeattribution{{\em Van Nostrand's Scientific Encyclopedia,\/}\\
4288 % Fifth Edition, p. 2203}
4289 %
4290 % \bigskip
4291 %
4292 %
4293 % \volumeepigraph{I thirst to know the power and nature of Time\ldots.}
4294 % \volumeattribution{St.\ Augustine: {\em Confessions,\/}\\
4295 % Book {\em XI,\/} Chapter {\em XXIII\/}\\
4296 % Translated by Albert C. Outler}
4297 %
4298 %
4299 % \bigskip
4300 %
4301 % \volumeepigraph{Time is the dimension in which God
4302 % strives to define His own Being.}
4303 %
4304 % \sources{The typescript material in the Beinecke Library
4305 % indicates that this
4306 % book went through many drafts, and some rethinking about what to
4307 % include and how to order the poems. Until a late stage of
4308 % production---very late, since the typescript includes a designed
4309 % mock-up of the proposed title page---the title of this volume was {\em
4310 % Life is a Fable.\/} Indeed, as late as the time the book was set in
4311 % galleys it was called {\em Life is a Fable\/}, although the title was
4312 % corrected on the galleys. Like {\em Now and Then\/}, the typescript
4313 % was assembled from photocopies of re-typed copies of poems made after
4314 % their magazine appearance, with annotations giving the name of the
4315 % magazine in which they occurred. Unlike {\em Now and Then\/}, the
4316 % typescript seems to have been typed in one piece, and the annotations
4317 % added for the convenience of the permissions department at
4318 % Random House. The page numbers have been added---presumably
4319 % later---in blue pen. The copy is marked up in Warren's hand in black
4320 % pencil, and in another hand in red pencil. (Unless marked otherwise,
4321 % all of the mark-up described here is in black pencil.) \tsentry{Like most
4322 % Warren typescripts BHTS is single-spaced. The dedication to Gabriel
4323 % Thomas Penn and the dialogue between the old man and the boy appeared
4324 % on a separate page, and the three epigraphs appeared on another
4325 % separate page. BHTS gives 1838 as the year of Gabriel
4326 % Thomas Penn's
4327 % birth (the error is corrected on the galleys). In the quotation from
4328 % Augustine, the second word is corrected to ``thirst'' from ``yearn,''
4329 % and the translator's name is added in pencil, not in Warren's
4330 % handwriting.} In one of Warren's own
4331 % copies at Western Kentucky University, he has corrected the date of
4332 % Gabriel Thomas Penn's birth to 1837 (copy 310). Some revisions in this book
4333 % may have come very late
4334 % indeed. A letter to Erskine of January 28, 1980, refers to changes
4335 % made in a bound manuscript that Warren kept after returning the
4336 % copy-edited typescripts. There are revisions not only on the galleys,
4337 % but also on the page proofs. There are even some corrections on the
4338 % ``blues'' for this volume, including some new copy on a card referred
4339 % to in a note on the cover of the ``blues'' but now lost. The Secker
4340 % and Warburg London edition is, except for the title page, printed from
4341 % the American plates. There is a copy of this book, marked up by
4342 % Warren with
4343 % proposed revisions for Stuart Wright's use on May 25, 1987, in the
4344 % Special Collections
4345 % Department of the Emory University Library. I quote Warren's
4346 % notes by permission.
4347 % Warren has also marked up, slightly, a copy of this book now in the
4348 % Robert Penn Warren Room of the Library of the Kentucky Museum at
4349 % Western Kentucky University. I quote that volume too by permission.
4350 % The setting typescript for the section of SP85 drawn from this volume
4351 % consisted of taped-in photocopies of passages from BH. Because the
4352 % revisions for SP85 are sometimes a vexed question, I have indicated
4353 % where the SP85 revisions are made on SP85TS.}
4354 %
4355 %
4356 % \sources{Title Page] SP85 omits the dialogue between the old man and
4357 % the young boy. SP85 capitalizes ``time standard'' in the quotation
4358 % from Van Nostrand's Scientific Encyclopedia, and does not capitalize
4359 % ``Time'' in the quotation from Augustine.}
4360 %
4361 %
4362 %
4363 % \end{volumetitlepage}
4364 % \end{verbatim}
4365 %
4366 %
4367 %
4368 %
4369 % \StopEventually{\PrintChanges\PrintIndex}
4370 % \section{Implementation}\label{implementation}
4371 % \subsection{~Page geometry and crop marks}
4372
4373
4374 % \begin{macro}{\tightgeometry} There's no reason why you should use the
4375 % page geometry I used in \emph{The Collected Poems of Robert Penn Warren},
4376 % and there are many reasons not to. But I include it just to show what is possible.
4377 % If you issue |\tightgeometry| in your
4378 % preamble, you will have the geometry I have used. If you issue
4379 % |\tightleading| you will
4380 % redefine |\normalsize| and |\small| to use tighter leading.
4381 % Normal
4382 % 10 point \LaTeX\ uses 12 point leading. Strictly to save money, I
4383 % redefined |\normalsize| to use 11 point leading.
4384 % I use the \textsf{geometry} package,
4385 % since it's simpler to figure out. I give my page geometry here
4386 % chiefly to remind the reader of some important variables that should
4387 % be kept track of, such as marginparsep, which controls the
4388 % separation of the marginal line numbers from the verse line,
4389 % marginparwidth, which controls how wide the block for the marginal
4390 % line numbers will be, headsep, which controls how far the text will
4391 % be from the running headers, and footskip, which controls how far
4392 % the last verse line will be from the marker which tells the reader
4393 % that there is a stanza break at the end of the page (if there is
4394 % one). I've also set the odd side margin and the even side margin
4395 % for two-sided printing. Finally, I have set the default handling
4396 % of page endings to |\raggedbottom|. Verse should always be set with
4397 % a ragged bottom margin, otherwise \LaTeX\ will stretch the spaces
4398 % between stanzas to make the bottom perfectly flush. When you enter
4399 % prose sections, such as the editor's introduction, you should enter
4400 % the command |\flushbottom| to make sure that the prose sections have
4401 % flush page bottoms.
4402 % \begin{macrocode}
4403 \newcommand{\tightgeometry}{\geometry{verbose, tmargin= 33pt,
4404 textwidth=318.21pt,textheight=550pt,
4405 marginparsep=7pt,marginparwidth=10pt,
4406 headheight= 15pt,
4407 headsep=19pt,
4408 footskip=15pt,
4409 lmargin=132pt}
4410 \setlength{\oddsidemargin}{60pt}
4411 \setlength{\evensidemargin}{65.41pt}}
4412 \newcommand{\tightleading}{%
4413 \makeatletter
4414 \renewcommand\normalsize{%
4415 \@setfontsize\normalsize\@xpt\@xipt
4416 \abovedisplayskip 10\p@ \@plus2\p@ \@minus5\p@
4417 \abovedisplayshortskip \z@ \@plus3\p@
4418 \belowdisplayshortskip 6\p@ \@plus3\p@ \@minus3\p@
4419 \belowdisplayskip \abovedisplayskip
4420 \let\@listi\@listI}
4421 \makeatother
4422 \normalsize
4423 \makeatletter
4424 \renewcommand\small{%
4425 \@setfontsize\small\@ixpt{10}%
4426 \abovedisplayskip 8.5\p@ \@plus3\p@ \@minus4\p@
4427 \abovedisplayshortskip \z@ \@plus2\p@
4428 \belowdisplayshortskip 4\p@ \@plus2\p@ \@minus2\p@
4429 \def\@listi{\leftmargin\leftmargini
4430 \topsep 4\p@ \@plus2\p@ \@minus2\p@
4431 \parsep 2\p@ \@plus\p@ \@minus\p@
4432 \itemsep \parsep}%
4433 \belowdisplayskip \abovedisplayskip
4434 }
4435 \makeatother}
4436
4437
4438 % \end{macrocode}
4439 % \end{macro}
4440 %
4441
4442 % \subsubsection{Internal font size commands} You will probably never need
4443 % to use these font commands explicitly. I defined these for internal
4444 % use within \textsf{poemscol}, so that a command will always call the
4445 % same fonts. \label{internal font size commands}
4446 %
4447 % As a way of making global changes to repeated features I have
4448 % defined various special fonts for special purposes. For instance,
4449 % in a Collected Poems in which the poems are arranged by volume, with
4450 % divider pages for the beginning of each volume, the first command
4451 % sets the font for the volume title on the divider page, using the
4452 % default font family, setting it in 18 point type on 23 point
4453 % leading. The second command, as the name of the command indicates,
4454 % sets the font for the subtitle of the volume to be 14 point type on
4455 % 18 point leading. You can change these either by changing the
4456 % values in your (renamed) style file, or by using |\renewcommand|.
4457 % For instance, you can change the font parameters for the font for
4458 % setting poem titles from 14 on 18 to 12 on 14 by issuing
4459 % |\renewcommand{\poemtitlefont}{\fontsize{12}{14}\selectfont}| in
4460 % your preamble. Notice that there are special fonts for titles in
4461 % the back matter and in the table of contents as well.
4462
4463 % \begin{macrocode}
4464 \newcommand{\volumetitlefont}{\fontsize{18}{23}\selectfont}
4465 \newcommand{\volumesubtitlefont}{\fontsize{14}{18}\selectfont}
4466 \newcommand{\poemtitlefont}{\fontsize{14}{18}\selectfont}
4467 \newcommand{\sequencetitlefont}{\fontsize{16}{20}\selectfont}
4468 \newcommand{\subsectiontitlefont}{\fontsize{12}{14.5}\selectfont}
4469 \newcommand{\backmatterheaderfont}{\fontsize{16}{20}\selectfont}
4470 \newcommand{\volumetitlesink}{\leavevmode\vspace{23.5pt}}
4471 \newcommand{\backmattersink}{\leavevmode\vspace{21.5pt}}
4472 \newcommand{\backmatterafterheadersink}{\leavevmode\vspace{11pt}}
4473 \newcommand{\backmattertextfont}{\small}
4474 \newcommand{\backmatterintrofont}{\normalsize}
4475 \newcommand{\backmattervolumefont}{\fontsize{12}{14.5}\selectfont}
4476 \newcommand{\backmattervolumesubtitlefont}{\fontsize{11}{13}\selectfont}
4477 \newcommand{\contentsvolumefont}{\fontsize{14}{20}\selectfont}
4478 \newcommand{\contentsvolumesubtitlefont}{\fontsize{12}{14.5}\selectfont}
4479 \newcommand{\contentssequencetitlefont}{\fontsize{10}{14}\selectfont}
4480 \newcommand{\contentspoemtitlefont}{\fontsize{10}{14}\selectfont}
4481 % \end{macrocode}
4482
4483 % \subsection{~Miscellaneous dimensions and constants}
4484 % \textsf{poemscol} sets relatively large penalties for widows and
4485 % clubs, both in the main text, and in the notes sections. There are
4486 % also special penalties after volume titles in the notes sections,
4487 % since one does not want to leave a volume title in the notes
4488 % sections stranded at the bottom of a page. (Setting penalties may
4489 % not automatically solve all the problems, however. You can fix an
4490 % intractable widow problem in the contents or in the notes sections
4491 % by issuing |\literalcontents{\pagebreak}| or
4492 % |\literalemend{\pagebreak}| just before you issue the
4493 % |\poemtitle| or |\volumetitle| that resulted in the problematic
4494 % title line.) \textsf{poemscol} also manipulates penalties for places like
4495 % the space between a poem's title and its first line. It defines
4496 % special values for the white space before and after poems and for
4497 % the amount of a stanza break. |\contentsindentone|,
4498 % |\contentsindenttwo|, and so on are amounts to indent different
4499 % hierarchical levels, say of poetic sequences and subsequences, in
4500 % the table of contents.
4501 % \begin{macrocode}
4502 \widowpenalty=300
4503 \clubpenalty=300
4504 \newcommand{\notespoemclubpenalty}{\penalty-300}
4505 \newcommand{\notessequenceclubpenalty}{\penalty-1500}
4506 \newcommand{\notesvolumetitlepenalty}{\penalty-1500}
4507 % \end{macrocode}
4508 % Since the right margin of verse is ragged anyway, I allowed some
4509 % flexibility for slightly longer lines.
4510 % \begin{macrocode}
4511 \hfuzz=2pt
4512 % \end{macrocode}
4513 % For explicitly declared indented lines or ranges of lines:
4514 % \begin{macrocode}
4515 \newlength{\verseindentamount}
4516 \setlength{\verseindentamount}{2em}
4517 \newcount\l@@pcounter
4518 \newcommand{\repeatedindent}[1]{\l@@pcounter=#1%
4519 \loop%
4520 \ifnum\l@@pcounter>0%
4521 \hspace{\verseindentamount}%
4522 \advance \l@@pcounter -1
4523 \repeat}
4524 \newcommand{\verseindent}[1][]{%
4525 \ifthenelse{\equal{#1}{}}{\hspace{\verseindentamount}}{\repeatedindent{#1}}}
4526 %\newcommand{\verseindent}{\hspace{\verseindentamount}} %old version
4527 \newlength{\indentedstanzaamount}
4528 \setlength{\indentedstanzaamount}{\verseindentamount}
4529 \newlength{\variablestanzaamount}
4530 \setlength{\variablestanzaamount}{\indentedstanzaamount}
4531 \newcommand{\adjustst@nzaindent}[1]{\l@@pcounter=#1%
4532 \loop%
4533 \addtolength{\variablestanzaamount}{\indentedstanzaamount}%
4534 \advance \l@@pcounter -1%
4535 \ifnum \l@@pcounter>0
4536 \repeat}
4537 \newif\ifinindentedverse
4538 \newenvironment{indentedverse}[1][]{%
4539 \inindentedversetrue%
4540 \ifthenelse{\equal{#1}{}}{\relax}{\adjustst@nzaindent{#1}}%
4541 \let\\=\@centercr%
4542 \list{}{\itemsep\z@ \itemindent -\runoverindentvalue\listparindent \itemindent
4543 \rightmargin 0sp\leftmargin 0sp\advance\leftmargin
4544 \variablestanzaamount}\item[]}
4545 {\endlist\inindentedversefalse\setlength{\variablestanzaamount}{\indentedstanzaamount}}
4546 % \end{macrocode}
4547 % For multicolumn notes:
4548 % \begin{macrocode}
4549 \setlength{\columnsep}{15pt}
4550 % \end{macrocode}
4551 % A hierarchy of indentations for sequence section titles and
4552 % subsection titles.
4553 % \begin{macrocode}
4554 \newlength{\titleindentamount}
4555 \setlength{\titleindentamount}{1pc}
4556 %\newdimen\titleindentamount \titleindentamount=1pc
4557 %\newdimen\titleindenttwoamount \titleindenttwoamount=2pc
4558 \newlength{\titleindenttwoamount}
4559 \setlength{\titleindenttwoamount}{2pc}
4560 \newlength{\titleindentthreeamount}
4561 \setlength{\titleindentthreeamount}{3pc}
4562 %\newdimen\titleindentthreeamount \titleindentthreeamount=3pc
4563 \newcommand{\titleindent}{\hspace{\titleindentamount}}
4564 \setlength{\parindent}{1pc}
4565 \newlength{\volumetitleindentamount}
4566 \setlength{\volumetitleindentamount}{0pt}
4567 %\newcommand{\volumetitleindent}{\hspace{\volumetitleindentamount}}
4568 \newcommand{\volumetitleindent}{\relax}
4569 \newlength{\volumetitlesecondlineindentamount}
4570 \setlength{\volumetitlesecondlineindentamount}{0pt}
4571 %\newcommand{\volumetitlesecondlineindent}{\hspace{\volumetitlesecondlineindentamount}}
4572 \newcommand{\volumetitlesecondlineindent}{\relax}
4573 % \titleindentamount=1pc
4574 \newlength{\volumesubtitleindentamount}
4575 \setlength{\volumesubtitleindentamount}{\titleindentamount}
4576 \newcommand{\volumesubtitleindent}{\hspace{\volumesubtitleindentamount}}
4577 \newlength{\volumesubtitlesecondlineindentamount}
4578 \setlength{\volumesubtitlesecondlineindentamount}{\titleindentamount}
4579 \newcommand{\volumesubtitlesecondlineindent}{\hspace{\volumesubtitlesecondlineindentamount}}
4580 \newlength{\volumesectiontitleindentamount}
4581 \setlength{\volumesectiontitleindentamount}{0pt}
4582 % \newcommand{\volumesectiontitleindent}{\hspace{\volumesectiontitleindentamount}}
4583 \newcommand{\volumesectiontitleindent}{\relax}
4584 \newlength{\volumesectiontitlesecondlineindentamount}
4585 \setlength{\volumesectiontitlesecondlineindentamount}{0pt}
4586 % \newcommand{\volumesectiontitlesecondlineindent}{\hspace{\volumesectiontitlesecondlineindentamount}}
4587 \newcommand{\volumesectiontitlesecondlineindent}{\relax}
4588 \newlength{\poemtitleindentamount}
4589 \setlength{\poemtitleindentamount}{0pt}
4590 % \newcommand{\poemtitleindent}{\hspace{\poemtitleindentamount}}
4591 \newcommand{\poemtitleindent}{\relax}
4592 \newlength{\poemtitlesecondlineindentamount}
4593 \setlength{\poemtitlesecondlineindentamount}{0pt}
4594 % \newcommand{\poemtitlesecondlineindent}{\hspace{\poemtitlesecondlineindentamount}}
4595 \newcommand{\poemtitlesecondlineindent}{\relax}
4596 \newlength{\poemsubtitleindentamount}
4597 \setlength{\poemsubtitleindentamount}{\titleindentamount}
4598 \newcommand{\poemsubtitleindent}{\hspace{\poemsubtitleindentamount}}
4599 \newlength{\poemsectiontitleindentamount}
4600 \setlength{\poemsectiontitleindentamount}{\titleindentamount}
4601 \newcommand{\poemsectiontitleindent}{\hspace{\poemsectiontitleindentamount}}
4602 \newlength{\poemsectiontitlesecondlineindentamount}
4603 \setlength{\poemsectiontitlesecondlineindentamount}{\titleindentamount}
4604 \newcommand{\poemsectiontitlesecondlineindent}{\hspace{\poemsectiontitlesecondlineindentamount}}
4605 \newlength{\poemsubsectiontitleindentamount}
4606 \setlength{\poemsubsectiontitleindentamount}{\titleindenttwoamount}
4607 \newcommand{\poemsubsectiontitleindent}{\hspace{\poemsectiontitleindentamount}}
4608 \newlength{\sequencetitleindentamount}
4609 \setlength{\sequencetitleindentamount}{0pt}
4610 % \newcommand{\sequencetitleindent}{\hspace{\sequencetitleindentamount}}
4611 \newcommand{\sequencetitleindent}{\relax}
4612 \newlength{\sequencetitlesecondlineindentamount}
4613 \setlength{\sequencetitlesecondlineindentamount}{0pt}
4614 % \newcommand{\sequencetitlesecondlineindent}{\hspace{\sequencetitlesecondlineindentamount}}
4615 \newcommand{\sequencetitlesecondlineindent}{\hspace{\relax}}
4616 \newlength{\sequencesubtitleindentamount}
4617 \setlength{\sequencesubtitleindentamount}{\titleindentamount}
4618 \newcommand{\sequencesubtitleindent}{\hspace{\sequencesubtitleindentamount}}
4619 \newlength{\sequencesubtitlesecondlineindentamount}
4620 \setlength{\sequencesubtitlesecondlineindentamount}{\titleindentamount}
4621 \newcommand{\sequencesubtitlesecondlineindent}{\hspace{\sequencesubtitlesecondlineindentamount}}
4622 \newlength{\sequencesectiontitleindentamount}
4623 \setlength{\sequencesectiontitleindentamount}{\titleindentamount}
4624 \newcommand{\sequencesectiontitleindent}{\hspace{\sequencesectiontitleindentamount}}
4625 \newlength{\sequencesectiontitlesecondlineindentamount}
4626 \setlength{\sequencesectiontitlesecondlineindentamount}{\titleindentamount}
4627 \newcommand{\sequencesectiontitlesecondlineindent}{\hspace{\sequencesectiontitlesecondlineindentamount}}
4628 \newlength{\sequencesectionsubtitleindentamount}
4629 \setlength{\sequencesectionsubtitleindentamount}{\titleindenttwoamount}
4630 \newcommand{\sequencesectionsubtitleindent}{\hspace{\sequencesectionsubtitleindentamount}}
4631 \newlength{\sequencesectionsubtitlesecondlineindentamount}
4632 \setlength{\sequencesectionsubtitlesecondlineindentamount}{\titleindenttwoamount}
4633 \newcommand{\sequencesectionsubtitlesecondlineindent}{\hspace{\sequencesectionsubtitlesecondlineindentamount}}
4634 \newlength{\sequencesubsectiontitleindentamount}
4635 \setlength{\sequencesubsectiontitleindentamount}{\titleindenttwoamount}
4636 \newcommand{\sequencesubsectiontitleindent}{\hspace{\sequencesubsectiontitleindentamount}}
4637 \newlength{\sequencesubsubsectiontitleindentamount}
4638 \setlength{\sequencesubsubsectiontitleindentamount}{\titleindentthreeamount}
4639 \newcommand{\sequencesubsubsectiontitleindent}{\hspace{\sequencesubsubsectiontitleindentamount}}
4640 \newlength{\appendixtitleindentamount}
4641 \setlength{\appendixtitleindentamount}{0pt}
4642 % \newcommand{\appendixtitleindent}{\hspace{\appendixtitleindentamount}}
4643 \newcommand{\appendixtitleindent}{\relax}
4644 \newlength{\subappendixtitleindentamount}
4645 \setlength{\subappendixtitleindentamount}{0pt}
4646 % \newcommand{\subappendixtitleindent}{\hspace{\subappendixtitleindentamount}}
4647 \newcommand{\subappendixtitleindent}{\relax}
4648 \newlength{\forewordtitleindentamount}
4649 \setlength{\forewordtitleindentamount}{0pt}
4650 % \newcommand{\forewordtitleindent}{\hspace{\forewordtitleindentamount}}
4651 \newcommand{\forewordtitleindent}{\relax}
4652 \newlength{\notestitleindentamount}
4653 \setlength{\notestitleindentamount}{0pt}
4654 % \newcommand{\notestitleindent}{\hspace{\notestitleindentamount}}
4655 \newcommand{\notestitleindent}{\relax}
4656
4657 % \end{macrocode}
4658 % A hierarchy of indentations for the table of contents: \label{contents indentation hierarchy}
4659 % \begin{macrocode}
4660 \newdimen\volumetitleshiftamount \volumetitleshiftamount=1pc
4661 \newcommand{\volumetitleshift}{\hbox{\hspace{\volumetitleshiftamount}}}
4662 \newdimen\voladditionalamount \voladditionalamount=2pc
4663 \newdimen\contentsindentoneamount \contentsindentoneamount=24pt
4664 \newcommand{\contentsindentone}{\hspace{\contentsindentoneamount}}
4665 \newdimen\contentsindenttwoamount \contentsindenttwoamount=42pt
4666 \newcommand{\contentsindenttwo}{\hspace{\contentsindenttwoamount}}
4667 \newdimen\contentsindentthreeamount \contentsindentthreeamount=60pt
4668 \newcommand{\contentsindentthree}{\hspace{\contentsindentthreeamount}}
4669 \newdimen\contentsindentfouramount \contentsindentfouramount=72pt
4670 \newcommand{\contentsindentfour}{\hspace{\contentsindentfouramount}}
4671 \newdimen\contentsindentfiveamount \contentsindentfiveamount=80pt
4672 \newcommand{\contentsindentfive}{\hspace{\contentsindentfiveamount}}
4673 % \end{macrocode}
4674 % A hierarchy of indentations for sequence section titles and
4675 % subsection titles in the table of contents.
4676 % \begin{macrocode}
4677 \newlength{\contentsvolumetitleindentamount}
4678 \setlength{\contentsvolumetitleindentamount}{0pt}
4679 %\newcommand{\contentsvolumetitleindent}{\hspace{\contentsvolumetitleindentamount}}
4680 \newcommand{\contentsvolumetitleindent}{\relax}
4681 \newlength{\contentsvolumetitlesecondlineindentamount}
4682 \setlength{\contentsvolumetitlesecondlineindentamount}{0pt}
4683 %\newcommand{\contentsvolumetitlesecondlineindent}{\hspace{\contentsvolumetitlesecondlineindentamount}}
4684 \newcommand{\contentsvolumetitlesecondlineindent}{\relax}
4685 \newlength{\contentsvolumesubtitleindentamount}
4686 \setlength{\contentsvolumesubtitleindentamount}{\titleindentamount}
4687 \newcommand{\contentsvolumesubtitleindent}{\hspace{\contentsvolumesubtitleindentamount}}
4688 \newlength{\contentsvolumesubtitlesecondlineindentamount}
4689 \setlength{\contentsvolumesubtitlesecondlineindentamount}{\titleindentamount}
4690 \newcommand{\contentsvolumesubtitlesecondlineindent}{\hspace{\contentsvolumesubtitlesecondlineindentamount}}
4691 \newlength{\contentsvolumesectiontitleindentamount}
4692 \setlength{\contentsvolumesectiontitleindentamount}{0pt}
4693 \newcommand{\contentsvolumesectiontitleindent}{\hspace{\contentsvolumesectiontitleindentamount}}
4694 %\newcommand{\contentsvolumesectiontitleindent}{\relax}
4695 \newlength{\contentsvolumesectiontitlesecondlineindentamount}
4696 \setlength{\contentsvolumesectiontitlesecondlineindentamount}{0pt}
4697 \newcommand{\contentsvolumesectiontitlesecondlineindent}{\hspace{\contentsvolumesectiontitlesecondlineindentamount}}
4698 \newlength{\contentspoemtitleindentamount}
4699 \setlength{\contentspoemtitleindentamount}{\contentsindentoneamount}
4700 %\setlength{\contentspoemtitleindentamount}{0pt}
4701 \newcommand{\contentspoemtitleindent}{\hspace{\contentspoemtitleindentamount}}
4702 %\newcommand{\contentspoemtitleindent}{\relax}
4703 \newlength{\contentspoemtitlesecondlineindentamount}
4704 \setlength{\contentspoemtitlesecondlineindentamount}{\contentspoemtitleindentamount}
4705 \newcommand{\contentspoemtitlesecondlineindent}{\hspace{\contentspoemtitlesecondlineindentamount}}
4706 %\newcommand{\contentspoemtitlesecondlineindent}{\relax}
4707 \newlength{\contentspoemsubtitleindentamount}
4708 \setlength{\contentspoemsubtitleindentamount}{\contentspoemsubtitleindentamount}
4709 \newcommand{\contentspoemsubtitleindent}{\hspace{\contentspoemsubtitleindentamount}}
4710 \newlength{\contentspoemsectiontitleindentamount}
4711 \setlength{\contentspoemsectiontitleindentamount}{\contentsindenttwoamount}
4712 \newcommand{\contentspoemsectiontitleindent}{\hspace{\contentspoemsectiontitleindentamount}}
4713 \newlength{\contentspoemsectiontitlesecondlineindentamount}
4714 \setlength{\contentspoemsectiontitlesecondlineindentamount}{\contentspoemsectiontitleindentamount}
4715 \newcommand{\contentspoemsectiontitlesecondlineindent}{\hspace{\contentspoemsectiontitlesecondlineindentamount}}
4716 \newlength{\contentspoemsubsectiontitleindentamount}
4717 \setlength{\contentspoemsubsectiontitleindentamount}{\contentsindentthreeamount}
4718 \newcommand{\contentspoemsubsectiontitleindent}{\hspace{\contentsindentthreeamount}}
4719 \newlength{\contentssequencetitleindentamount}
4720 \setlength{\contentssequencetitleindentamount}{\contentsindentoneamount} %313
4721 \newcommand{\contentssequencetitleindent}{\hspace{\contentssequencetitleindentamount}}
4722 %\newcommand{\contentssequencetitleindent}{\relax}
4723 \newlength{\contentssequencetitlesecondlineindentamount}
4724 \setlength{\contentssequencetitlesecondlineindentamount}{\contentsindentoneamount} %313
4725 \newcommand{\contentssequencetitlesecondlineindent}{\hspace{\contentssequencetitlesecondlineindentamount}}
4726 %\newcommand{\contentssequencetitlesecondlineindent}{\hspace{\relax}}
4727 \newlength{\contentssequencesubtitleindentamount}
4728 \setlength{\contentssequencesubtitleindentamount}{\contentsindenttwoamount} %313
4729 \newcommand{\contentssequencesubtitleindent}{\hspace{\contentssequencesubtitleindentamount}}
4730 \newlength{\contentssequencesubtitlesecondlineindentamount}
4731 \setlength{\contentssequencesubtitlesecondlineindentamount}{\contentsindenttwoamount} %313
4732 \newcommand{\contentssequencesubtitlesecondlineindent}{\hspace{\contentssequencesubtitlesecondlineindentamount}}
4733 \newlength{\contentssequencesectiontitleindentamount}
4734 \setlength{\contentssequencesectiontitleindentamount}{\contentsindenttwoamount} %313
4735 \newcommand{\contentssequencesectiontitleindent}{\hspace{\contentssequencesectiontitleindentamount}}
4736 \newlength{\contentssequencesectiontitlesecondlineindentamount}
4737 \setlength{\contentssequencesectiontitlesecondlineindentamount}{\contentsindenttwoamount} %313
4738 \newcommand{\contentssequencesectiontitlesecondlineindent}{\hspace{\contentssequencesectiontitlesecondlineindentamount}}
4739 \newlength{\contentssequencesectionsubtitleindentamount}
4740 \setlength{\contentssequencesectionsubtitleindentamount}{\contentsindentthreeamount} %313
4741 \newcommand{\contentssequencesectionsubtitleindent}{\hspace{\contentssequencesectionsubtitleindentamount}}
4742 \newlength{\contentssequencesectionsubtitlesecondlineindentamount}
4743 \setlength{\contentssequencesectionsubtitlesecondlineindentamount}{\contentsindentthreeamount}%313
4744 \newcommand{\contentssequencesectionsubtitlesecondlineindent}{\hspace{\contentssequencesectionsubtitlesecondlineindentamount}}
4745 \newlength{\contentssequencesubsectiontitleindentamount}
4746 \setlength{\contentssequencesubsectiontitleindentamount}{\contentsindentthreeamount}
4747 \newcommand{\contentssequencesubsectiontitleindent}{\hspace{\contentssequencesubsectiontitleindentamount}}
4748 \newlength{\contentssequencesubsubsectiontitleindentamount}
4749 \setlength{\contentssequencesubsubsectiontitleindentamount}{\contentsindentfouramount}
4750 \newcommand{\contentssequencesubsubsectiontitleindent}{\hspace{\contentssequencesubsubsectiontitleindentamount}}
4751
4752
4753 % \end{macrocode}
4754 % White space after poem titles, after poems, and after sequence
4755 % titles. \label{skiplist}
4756 % \begin{macrocode}
4757 \newcommand{\afterpoemtitleskip}{\smallskip}
4758 \newcommand{\afterpoemskip}{\bigskip}
4759 \newcommand{\aftersequencetitleskip}{\medskip}
4760 % \end{macrocode}
4761 % A little extra white space between stanzas.
4762 % \begin{macrocode}
4763 \newcommand{\stanzaskip}{\medskip}
4764 % \end{macrocode}
4765 % Penalties to encourage page breaks before poem titles, before
4766 % multi-line poem titles, and before sequence titles.
4767 % \begin{macrocode}
4768 \newcommand{\poemtitlepenalty}{\penalty-1000}
4769 \newcommand{\multilinetitlepenalty}{\penalty-3000}
4770 \newcommand{\sequencetitlepenalty}{\penalty-3000}
4771 \newcommand{\multilinesequencepenalty}{\penalty-3500}
4772 % \end{macrocode}
4773 % \subsection{~Title Schemes} Ways of controlling the placement of titles.
4774 % \begin{macrocode}
4775 \newlength{\poemtitlewidth}
4776 \newif\iftitlescenteredonleftverseblock
4777 \newif\iftitlesatleftmarginofcenteredblock
4778 \newif\iftitlesatleftversemargin
4779 \newif\ifnormaltitleindentation
4780 %
4781 \newcommand{\normaltitleindentationscheme}{%
4782 \normaltitleindentationtrue%
4783 \titlesatleftversemarginfalse%
4784 \titlescenteredonleftverseblockfalse%
4785 \titlesatleftmarginofcenteredblockfalse%
4786 \centertitlesonfalse%
4787 }
4788 \newcommand{\titlesatleftversemarginscheme}{%
4789 \normaltitleindentationfalse%
4790 \titlesatleftversemargintrue%
4791 \titlescenteredonleftverseblockfalse%
4792 \titlesatleftmarginofcenteredblockfalse%
4793 \centertitlesonfalse%
4794 }
4795 \newcommand{\titlescenteredonleftverseblockscheme}{%
4796 \normaltitleindentationfalse%
4797 \titlesatleftversemarginfalse%
4798 \titlescenteredonleftverseblocktrue%
4799 \titlesatleftmarginofcenteredblockfalse%
4800 \centertitlesonfalse%
4801 }
4802 \newcommand{\titlesatleftmarginofcenteredblockscheme}{%
4803 \normaltitleindentationfalse%
4804 \titlesatleftversemarginfalse%
4805 \titlescenteredonleftverseblockfalse%
4806 \titlesatleftmarginofcenteredblocktrue%
4807 \centertitlesonfalse%
4808 }
4809 \newcommand{\centertitlesscheme}{%
4810 \normaltitleindentationfalse%
4811 \titlesatleftversemarginfalse%
4812 \titlescenteredonleftverseblockfalse%
4813 \titlesatleftmarginofcenteredblockfalse%
4814 \centertitlesontrue%
4815 \centerepigraphsontrue%
4816 }
4817 \newlength{\lefttitleaddition}
4818 \setlength{\lefttitleaddition}{0pt}
4819 \newcommand{\l@ftc@ntertitleblock}{\rightmargin \z@%%
4820 \setlength{\lefttitleaddition}{\versewidth}%
4821 \addtolength{\lefttitleaddition}{-\poemtitlewidth}%
4822 \addtolength{\lefttitleaddition}{-0.5\lefttitleaddition}%
4823 \setlength{\lefttitlemargin}{\lefttitleaddition}%
4824 }
4825
4826 % \end{macrocode}
4827 % \subsection{~Verse} The verse environment here is taken from \LaTeX,
4828 % slightly modified to indent run over lines more. The idea is to
4829 % distinguish the automatic indentation of run over lines from the
4830 % explicitly declared indentation of indented lines. You can change
4831 % the amount of indentation of runover lines with |\runoverindent|.
4832 % \label{versedefine}
4833 % \begin{macrocode}
4834 \def\makeatletter{\catcode`\@=11}
4835 \def\makeatother{\catcode`\@=12 }
4836 \newcommand{\runoverindent}[1]{\global\edef\runoverindentvalue{#1}
4837 }
4838 \runoverindent{6em}
4839 % pmclverse (runover indented more than it is in the normal verse
4840 % environment)
4841 % \newenvironment{pmclverse}{%
4842 % \let\\=\@centercr%
4843 % \list{}{\itemsep\z@ \itemindent -\runoverindentvalue\listparindent \itemindent
4844 % \rightmargin 1sp\leftmargin 1sp\advance\leftmargin
4845 % \runoverindentvalue}\item[]}
4846 % {\endlist}
4847 \newif\iflinenumberscenteredwithverse
4848 \linenumberscenteredwithversetrue
4849 %
4850 \newlength{\marginparsepmin}
4851 \setlength{\marginparsepmin}{2em}
4852 %
4853 \newlength{\versemarginadjust}
4854 \setlength{\versemarginadjust}{0pt}
4855 %
4856 \newif\iftextcenteringturnedon
4857 \textcenteringturnedontrue
4858 %
4859 \newcommand{\v@riablemarginpar}{\setlength{\marginparsep}{-\leftmargin}%
4860 \addtolength{\marginparsep}{\marginparsepmin}}
4861 %
4862 \newcommand{\c@nterverseblock}[1]{\rightmargin \z@%
4863 \setlength{\leftmargin}{\linewidth}%
4864 \addtolength{\leftmargin}{-#1}%
4865 \addtolength{\leftmargin}{-0.5\leftmargin}%
4866 \iflinenumberscenteredwithverse\v@riablemarginpar\fi}
4867 \newif\iflastpoemcentered
4868 \newenvironment{pmclverse}[1][\linewidth]{%
4869 \global\lastpoemcenteredfalse
4870 \let\\=\@centercr%
4871 \list{}{\itemsep\z@
4872 \itemindent -\runoverindentvalue
4873 \listparindent \itemindent
4874 \ifdim #1 < \linewidth
4875 \iftextcenteringturnedon
4876 \c@nterverseblock{#1}%
4877 \global\lastpoemcenteredtrue
4878 \else
4879 \rightmargin \leftmargin
4880 \addtolength{\leftmargin}{-\versemarginadjust}\fi
4881 \else
4882 \rightmargin \leftmargin
4883 \addtolength{\leftmargin}{-\versemarginadjust}
4884 \fi
4885 \advance\leftmargin\runoverindentvalue}
4886 \item[]}
4887 {\endlist}
4888 % next is from 2.88
4889 %\newenvironment{pmclverse}[1][\linewidth]{%
4890 %\let\\=\@centercr%
4891 %\list{}{\itemsep\z@
4892 %\itemindent -\runoverindentvalue
4893 %\listparindent \itemindent
4894 % \ifdim #1 < \linewidth
4895 % \iftextcenteringturnedon
4896 % \c@nterverseblock{#1}%
4897 % \else
4898 % \rightmargin \leftmargin
4899 % \addtolength{\leftmargin}{-\versemarginadjust}\fi
4900 % \else
4901 % \rightmargin \leftmargin
4902 % \addtolength{\leftmargin}{-\versemarginadjust}
4903 % \fi
4904 %\advance\leftmargin\runoverindentvalue}
4905 %\item[]}
4906 %{\endlist}% from 2.72 with additions
4907 % \newenvironment{pmclverse}[1][\linewidth]{%
4908 % \let\\=\@centercr%
4909 % \list{}{\itemsep\z@
4910 % \itemindent -\runoverindentvalue
4911 % \listparindent \itemindent
4912 % \ifdim #1 < \linewidth
4913 % \rightmargin \z@
4914 % \setlength{\leftmargin}{\linewidth}%
4915 % \addtolength{\leftmargin}{-#1}%
4916 % \addtolength{\leftmargin}{-0.5\leftmargin}%
4917 % \iflinenumberscenteredwithverse
4918 % \setlength{\marginparsep}{-\leftmargin+\marginparsepmin}
4919 % \fi
4920 % \else
4921 % \rightmargin \leftmargin
4922 % \addtolength{\leftmargin}{-\versemarginadjust}
4923 % \fi
4924 % \advance\leftmargin\runoverindentvalue}
4925 % \item[]}
4926 % {\endlist\setlength{\marginparsep}{0pt}} % from email
4927
4928 % \newenvironment{pmclverse}[1][\linewidth]{%
4929 % \let\\=\@centercr%
4930 % \list{}{\itemsep\z@
4931 % \itemindent -\runoverindentvalue
4932 % \listparindent \itemindent
4933 % \iftextcenteringturnedon
4934 % \ifdim #1 < \linewidth
4935 % \rightmargin \z@
4936 % \setlength{\leftmargin}{\linewidth}%
4937 % \addtolength{\leftmargin}{-#1}%
4938 % \addtolength{\leftmargin}{-0.5\leftmargin}%
4939 % \iflinenumberscenteredwithverse\setlength{\marginparsep}{-\leftmargin+\marginparsepmin}\fi
4940 % \else
4941 % \rightmargin \leftmargin
4942 % \addtolength{\leftmargin}{-\versemarginadjust}
4943 % \fi % linewidth
4944 % \else
4945 % \rightmargin \leftmargin
4946 % \addtolength{\leftmargin}{-\versemarginadjust}
4947 %
4948 % \fi% textcentering
4949 % \advance\leftmargin\runoverindentvalue}
4950 % \item[]}
4951 % {\endlist\setlength{\marginparsep}{0pt}}% % draft
4952
4953 % \let\\=\@centercr%
4954 % \list{}{\itemsep\z@
4955 % \itemindent -\runoverindentvalue
4956 % \listparindent \itemindent
4957 % \ifdim #1 < \linewidth
4958 % \rightmargin \z@
4959 % \setlength{\leftmargin}{\linewidth}%
4960 % \addtolength{\leftmargin}{-#1}%
4961 % \addtolength{\leftmargin}{-0.5\leftmargin}%
4962 % \else
4963 % \rightmargin \leftmargin
4964 % \addtolength{\leftmargin}{-\versemarginadjust}
4965 % \fi
4966 % \advance\leftmargin\runoverindentvalue}
4967 % \item[]}
4968 % {\endlist} % first version from 2.81
4969 % \newenvironment{pmclverse}[1][\linewidth]{%
4970 % \let\\=\@centercr%
4971 % \list{}{\itemsep\z@
4972 % \itemindent -\runoverindentvalue
4973 % \listparindent \itemindent
4974 % \ifdim #1 < \linewidth
4975 % \rightmargin \z@
4976 % \setlength{\leftmargin}{\linewidth}%
4977 % \addtolength{\leftmargin}{-#1}%
4978 % \addtolength{\leftmargin}{-0.5\leftmargin}%
4979 % \else
4980 % \rightmargin \leftmargin
4981 % \fi
4982 % \advance\leftmargin\runoverindentvalue}
4983 % \item[]}
4984 % {\endlist}% from 2.72
4985 \newif\ifinquotedverse
4986 \newenvironment{quotedverse}{%
4987 \inquotedversetrue
4988 \let\\=\@centercr%
4989 \list{}{\itemsep\z@ \itemindent -\runoverindentvalue\listparindent \itemindent
4990 \rightmargin 0sp\leftmargin 0sp\advance\leftmargin
4991 \runoverindentvalue}\item[]}
4992 {\endlist\inquotedversefalse}
4993 % rfoverse (flushes runover to right) (Just a placeholder now.)
4994 % \newif\ifrfv
4995 % \rfvfalse
4996 % \newcommand{\rightflushrunoververse}{\global\rfvtrue}
4997 % \newcommand{\indentrunoververse}{\global\rfvfalse}
4998 % \newenvironment{rfoverse}{\begin{pmclverse}}{\end{pmclverse}}
4999 % % verse environment with a switch
5000 % \renewenvironment{verse}{\ifrfv\begin{rfoverse}\else\begin{pmclverse}\fi}
5001 % {\ifrfv\end{rfoverse}\else\end{pmclverse}\fi}
5002 % \end{macrocode}
5003
5004 % \subsection{~Miscellaneous internal counters}
5005 % |\verselinenumber| is the line number, obviously. |\printlineindex|
5006 % records how many lines have passed since the last marginal line
5007 % number was output. |\lineindexrepeat| governs how often the marginal
5008 % line numbers appear. |\lemmalines| and |\lemmaend| are for setting
5009 % number ranges for multiline lemmas.
5010 % \begin{macrocode}
5011 \newcounter{verselinenumber}
5012 \newcounter{printlineindex}
5013 \newcounter{verselinenumberscratch}
5014 \newcounter{printlineindexscratch}
5015 \newcounter{lineindexrepeat} \setcounter{lineindexrepeat}{9}
5016 \newcounter{lemmalines}
5017 \setcounter{lemmalines}{0}
5018 \newcounter{lemmaend}
5019 \setcounter{lemmaend}{0}
5020 % \end{macrocode}
5021 % This next counter is used to make labels for each poem for the contents and notes sections.
5022 % \begin{macrocode}
5023 \newcounter{poemnumber}
5024 \setcounter{poemnumber}{1}
5025 % \end{macrocode}
5026 % These next two are used to set the page numbers in the running
5027 % headers of the various notes sections, which are of the form
5028 % ``Textual notes to pp.~xx--yy.''
5029 % \begin{macrocode}
5030 \newcounter{notepageholdertitle} \setcounter{notepageholdertitle}{1}
5031 \newcounter{notepageholdernote} \setcounter{notepageholdernote}{1}
5032 % \end{macrocode}
5033 % \subsection{~Miscellaneous token lists}
5034 % Since the explanatory notes section and the emendations section should
5035 % only open an entry for poems for which there actually are explanatory notes or
5036 % emendations, the current are held in token lists in case they are needed.|\titlesofar|
5037 % and |\titleincrement| are used to concatenate multi-line titles.
5038 % \begin{macrocode}
5039 \newtoks{\fulltitleholder}
5040 \newtoks{\titlesofar}
5041 \newtoks{\titleincrement}
5042 % \end{macrocode}
5043 % \subsection{~Miscellaneous booleans}
5044 % Most of these have self-explanatory names.
5045 % \begin{macrocode}
5046 \newif\ifinstanza
5047 \newif\ifinpoem
5048 \newif\ifpoemcontentson
5049 \newif\iftextnoteson
5050 \newif\ifverselinenumbers
5051 \newif\ifexplanon
5052 \newif\ifemendationson
5053 \global\verselinenumberstrue
5054 \newif\ifindexingon
5055 \global\indexingontrue
5056 \ifindexingon
5057 \makeindex
5058 \fi
5059 \newif\ifincludeaccidentals
5060 \global\includeaccidentalstrue
5061 \newif\ifincludetypescripts
5062 \global\includetypescriptstrue
5063 \newif\ifredundantemendations
5064 \global\redundantemendationsfalse
5065 \newif\ifnoemendyet
5066 \newif\ifnoexplainyet
5067 \global\noemendyettrue
5068 \global\noexplainyettrue
5069 \newif{\ifmiddlecontentsline}
5070 \middlecontentslinefalse
5071 \newif{\iflastcontentsline}
5072 \lastcontentslinefalse
5073 \newif{\ifputpagenumberincontents}
5074 \putpagenumberincontentstrue
5075 \newif{\ifputpagenumberinnotes}
5076 \putpagenumberinnotestrue
5077 \newif{\ifsinglelinetitle}
5078 \singlelinetitletrue
5079 \newif{\iftitlefirstline}
5080 \titlefirstlinefalse
5081 \newif{\iftitlemiddleline}
5082 \titlemiddlelinefalse
5083 \newif{\iftitlelastline}
5084 \titlelastlinefalse
5085 \newif{\ifverserightflush}
5086 \verserightflushfalse
5087 \newif\ifrangelemma
5088 \rangelemmafalse
5089 \newcommand{\makeverselinenumbers}{\global\verselinenumberstrue}
5090 \let\makelinenumbers=\makeverselinenumbers% for compatibility
5091 \newif\iftextnotesatend
5092 \textnotesatendtrue
5093 \newif\ifemendationsatend
5094 \emendationsatendtrue
5095 \newif\ifexplanatend
5096 \explanatendtrue
5097 \newif\iftextfootnotespara
5098 \textfootnotesparatrue
5099 \newif\ifsourcesfootnotespara
5100 \sourcesfootnotesparafalse
5101 \newif\ifemendationfootnotespara
5102 \emendationfootnotesparatrue
5103 \newif\ifexplanfootnotespara
5104 \explanfootnotesparafalse
5105 % \end{macrocode}
5106
5107 % \subsection{~Defining page styles} \label{pagestyledefs} These define several special page styles.
5108 % To use them you must have the \textsf{fancyhdr} package installed.
5109 % First, the default running headers: the right side (|\volumeheader|)
5110 % is the title of the volume in a multivolume edition, and the left
5111 % (|\leftheader|) is the title of the general collection.
5112 % \begin{macro}{\volumeheader}
5113 % \begin{macrocode}
5114 \newcommand{\volumeheader}[1]{\global\edef\volumeheadervalue{#1}
5115 }
5116 % \end{macrocode}
5117 % \end{macro}
5118 % \begin{macro}{\leftheader}
5119 % \begin{macrocode}
5120 \newcommand{\leftheader}[1]{\global\edef\leftheadervalue{#1}
5121 }
5122 \leftheader{\relax}
5123 \volumeheader{\relax}
5124 \newcommand{\rightheader}[1]{\volumeheader{#1}}
5125 % \end{macrocode}
5126 % \end{macro}
5127 % The default page style. Note the use of the mark mechanism to keep
5128 % track of cases where the stanza breaks and page breaks overlap.
5129 % \begin{macro}{\pagestyle{fancy}}
5130 % \begin{macrocode}
5131 \newlength{\headoffsetlength}
5132 \setlength{\headoffsetlength}{-1sp}
5133 %\addtolength{\headoffsetlength}{\parindent}
5134 \raggedbottom
5135 \pagestyle{fancy}
5136 \fancyhead{}
5137 \fancyfoot{}
5138 \fancyhfoffset[RO,LE]{\headoffsetlength}
5139 \fancyhead[RO]{{\small\textrm{\thepage}}}
5140 \fancyhead[LE]{{\small\textrm{\thepage}}}
5141 \fancyhead[CO]{\hfil{\small{\em \volumeheadervalue}}\hfil}
5142 \fancyhead[CE]{\hfil{\small{\em \leftheadervalue}}\hfil}
5143 \fancyfoot[CE]{{\small \botmark}\hfil}
5144 \fancyfoot[CO]{\hfil{\small \botmark}}
5145 \renewcommand{\headrulewidth}{0pt}
5146 \renewcommand{\footrulewidth}{0pt}
5147 % \end{macrocode}
5148 % \end{macro}
5149 % \begin{macro}{\pagestyle{main}}
5150 % \begin{macrocode}
5151 \fancypagestyle{main}{%
5152 \fancyhead{}
5153 \fancyfoot{}
5154 \fancyhfoffset[RO,LE]{\headoffsetlength}
5155 \fancyhead[RO]{{\small\textrm{\thepage}}}
5156 \fancyhead[LE]{{\small\textrm{\thepage}}}
5157 \fancyhead[CO]{\hfil{\small{\em \volumeheadervalue}}\hfil}
5158 \fancyhead[CE]{\hfil{\small{\em \leftheadervalue}}\hfil}
5159 \fancyfoot[CE]{{\small \botmark}\hfil}
5160 \fancyfoot[CO]{\hfil{\small \botmark}}
5161 \renewcommand{\headrulewidth}{0pt}
5162 \renewcommand{\footrulewidth}{0pt}
5163 }
5164 % \end{macrocode}
5165 % \end{macro}
5166 % Style for the first page of every volume in a Collected Poems. You
5167 % don't have to call this style explicitly. It is called by the |\volumetitlepage|
5168 % environment. But of course if you want to change the style of those
5169 % pages, you should do it here.
5170 % \begin{macro}{volumefirststyle}
5171 % \begin{macrocode}
5172 \fancypagestyle{volumefirststyle}{%
5173 \fancyhf{}
5174 \fancyfoot[C]{\hfil{\small \botmark}\hfil}
5175 \renewcommand{\headrulewidth}{0pt}
5176 \renewcommand{\footrulewidth}{0pt}
5177 }
5178 % \end{macrocode}
5179 % \end{macro}
5180 % Style for plain pages.
5181 % \begin{macro}{plain}
5182 % \begin{macrocode}
5183 \fancypagestyle{plain}{%
5184 \fancyhf{}
5185 \fancyhead[RO,LE]{{\small\textrm{\thepage}}}
5186 \renewcommand{\headrulewidth}{0pt}
5187 \renewcommand{\footrulewidth}{0pt}
5188 }
5189 % \end{macrocode}
5190 % \end{macro}
5191 % Style for long poems.
5192 % \begin{macro}{\myversemarks}
5193 % \begin{macrocode}
5194 \newtoks{\singlelineabbrev}
5195 \singlelineabbrev={l.\ }
5196 \newcommand{\changesinglelineabbrev}[1]{\singlelineabbrev={#1}}
5197 \newtoks{\multiplelineabbrev}
5198 \newcommand{\changemultiplelineabbrev}[1]{\multiplelineabbrev={#1}}
5199 \multiplelineabbrev{ll.\ }
5200 \newcommand{\myversemarks}{%
5201 \ifthenelse{\equal{\thefirstmarks{verselinemark}}{\thebotmarks{verselinemark}}}%
5202 {\unskip ~\the\singlelineabbrev~\thefirstmarks{verselinemark}}% if equal
5203 {\unskip ~\the\multiplelineabbrev\thefirstmarks{verselinemark}--\thebotmarks{verselinemark}}} % if not equal
5204 % \end{macrocode}
5205 % \end{macro}
5206 % \begin{macro}{longpoem}
5207 % \begin{macrocode}
5208 \fancypagestyle{longpoem}{%
5209 \fancyhead{}
5210 \fancyfoot{}
5211 \fancyhfoffset[RO,LE]{\headoffsetlength}
5212 \fancyhead[RO]{{\small\textrm{\thepage}}}
5213 \fancyhead[LE]{{\small\textrm{\thepage}}}
5214 \fancyhead[CO]{\hfil{\small{\em \volumeheadervalue ~\myversemarks}}\hfil}
5215 \fancyhead[CE]{\hfil{\small{\em \leftheadervalue~\myversemarks}}\hfil}
5216 \fancyfoot[CE]{{\small \botmark}\hfil}
5217 \fancyfoot[CO]{\hfil{\small \botmark}}
5218 \renewcommand{\headrulewidth}{0pt}
5219 \renewcommand{\footrulewidth}{0pt}
5220 }
5221 % \end{macrocode}
5222 % \end{macro}
5223 % Style for divider pages between volumes
5224 % \begin{macro}{volumetitlestyle}
5225 % \begin{macrocode}
5226 \fancypagestyle{volumetitlestyle}{%
5227 \fancyhf{}
5228 \renewcommand{\headrulewidth}{0pt}
5229 \renewcommand{\footrulewidth}{0pt}
5230 }
5231 % \end{macrocode}
5232 % \end{macro}
5233 % \begin{macro}{\resetpagestyle}
5234 % |\resetpagestyle| restores the fancy page style of the main sections of the
5235 % book. |\putpoemcontents| changes the fancy page style, and |\resetpagestyle|,
5236 % which is called by |\putpoemcontents| as it finishes, restores the original
5237 % style
5238 % \begin{macrocode}
5239 \newcommand{\resetpagestyle}{\pagestyle{main}
5240 % \fancyhead{}
5241 % \fancyfoot{}
5242 % \fancyhead[RO,LE]{{\small\textrm{\thepage}}}
5243 % \fancyhead[CO]{\hfil{\small{\em \volumeheadervalue}}}
5244 % \fancyhead[CE]{{\small{\em \leftheadervalue}\hfil}}
5245 % \fancyfoot[CE]{{\small \botmark}\hfil}
5246 % \fancyfoot[CO]{\hfil{\small \botmark}}
5247 % \renewcommand{\headrulewidth}{0pt}
5248 % \renewcommand{\footrulewidth}{0pt}
5249 }
5250 % \end{macrocode}
5251 % \end{macro}
5252 % \begin{macro}{\clearemptydoublepage}
5253 % This macro is useful for making sure that the verso of a title
5254 % page is blank.
5255 % \begin{macrocode}
5256 \newcommand{\clearemptydoublepage}{\newpage{\pagestyle{empty}\cleardoublepage}}
5257 %
5258 % \end{macrocode}
5259 % \end{macro}
5260 % \begin{macro}{\mymarks}
5261 % Here the marks mechanism keeps track of pages from which notes
5262 % come. Marks are used different in the notes sections and in the body
5263 % of the volume. In the body, they are used to keep track of cases
5264 % where a stanza break falls on a page break. In the notes sections,
5265 % they set the running headers.
5266 % \begin{macrocode}
5267 \newtoks{\singlepageabbrev}
5268 \singlepageabbrev={p.}
5269 \newcommand{\changesinglepageabbrev}[1]{\singlepageabbrev={#1}}
5270 \newtoks{\multiplepageabbrev}
5271 \newcommand{\changemultiplepageabbrev}[1]{\multiplepageabbrev={#1}}
5272 \multiplepageabbrev{pp.}
5273 \newcommand{\mymarks}{%
5274 \ifthenelse{\equal{\firstmark}{\botmark}}%
5275 {\unskip ~\the\singlepageabbrev~\firstmark}% if equal
5276 {\unskip ~\the\multiplepageabbrev~\firstmark--\botmark}}%if not equal
5277 \newcommand{\poemdotfill}{\dotfill}
5278 % \end{macrocode}
5279 % \end{macro}
5280 % \subsection{~Environments: poem, and stanza} Here are definitions
5281 % of the poem and stanza environments, and of the |\verseline| and
5282 % |\stanzalinestraddle| macros.
5283 % \begin{macro}{stanza} \label{stanzadefine}
5284 % Page breaks are slightly encouraged in stanza breaks. Notice that
5285 % entering a stanza sets the mark to |\relax| and leaving it sets the
5286 % mark to * (the default value of |\stanzaatbottom|). If you want to
5287 % use some other symbol for this purpose, use |\stanzaatbottom| or
5288 % |\nostanzaatbottom| (if you also want to mark cases where there
5289 % is \emph{no} stanza break at the bottom of the page) to change it.
5290 % \begin{macrocode}
5291 \newenvironment{stanza}{\penalty-100\instanzatrue\mark{\nostanzaatbottomvalue\ }}
5292 {\nobreak\mark{\stanzaatbottomvalue\ }\nobreak\ifspeciallinelock%
5293 \relax\else%
5294 \nolinebreak\incrementverselinenumber%
5295 \fi%
5296 \speciallinelockfalse%
5297 \nobreak
5298 \instanzafalse
5299
5300 \stanzaskip
5301 }
5302
5303 \newenvironment{marginenvironment}{}{}
5304 \newcommand{\stanzalinestraddle}
5305 {\begin{stanza}\addtocounter{verselinenumber}{-1}%
5306 \addtocounter{printlineindex}{-1}%
5307 }
5308 % \end{macrocode}
5309 % The next two environments are for contents entries and titles. The
5310 % idea is to handle overrun titles the way overrun lines are handled
5311 % in verse. Contents entries indent the overrun slightly. Titles do
5312 % not indent the overrun relative to the first line, but preserve the
5313 % indentation of that line.
5314 % \begin{macrocode}
5315 \newlength{\contentsentryoverrun}
5316 \setlength{\contentsentryoverrun}{\contentsindentoneamount}
5317 \newenvironment{contentsentryenvironment}{%
5318 \language=255%no hyphenation in contents
5319 \let\\=\@centercr%
5320 \list{}{\topsep\z@%
5321 \partopsep\z@%
5322 \itemsep\z@ \itemindent -\contentsentryoverrun\listparindent \itemindent
5323 \rightmargin 1sp\leftmargin 1sp\advance\leftmargin
5324 \contentsentryoverrun}\item[]}{\endlist}
5325 \newlength{\titleentryoverrun}
5326 \setlength{\titleentryoverrun}{\z@}
5327 \newenvironment{titleentryenvironment}{%
5328 \language=255%no hyphenation in poem titles
5329 \let\\=\@centercr%
5330 \list{}{\topsep\z@%
5331 \partopsep\z@%
5332 \itemsep\z@ \itemindent -\titleentryoverrun%
5333 \listparindent \itemindent %
5334 \iftitlesatleftmarginofcenteredblock%
5335 \left@ligntitleblock%
5336 \rightmargin \z@\leftmargin \lefttitlemargin%
5337 \else%
5338 \iftitlescenteredonleftverseblock
5339 \l@ftc@ntertitleblock
5340 \rightmargin \z@\leftmargin \lefttitlemargin
5341 \else
5342 \rightmargin \z@\leftmargin \z@%
5343 \fi\fi%
5344 \advance\leftmargin \titleentryoverrun}\item[]}{\endlist}
5345 % older version:
5346 %\newenvironment{titleentryenvironment}{%
5347 %\language=255%no hyphenation in poem titles
5348 %\let\\=\@centercr%
5349 %\list{}{\topsep\z@%
5350 %\partopsep\z@%
5351 %\itemsep\z@ \itemindent -\titleentryoverrun%
5352 %\listparindent \itemindent %
5353 %\ifleftaligntitles
5354 %\left@ligntitleblock
5355 %\rightmargin 1sp\leftmargin \lefttitlemargin%
5356 %\else
5357 %\rightmargin 1sp\leftmargin 1sp%
5358 %\fi
5359 %\advance\leftmargin \titleentryoverrun}\item[]}{\endlist}
5360 % \end{macrocode}
5361 % \end{macro}
5362 % The poem environment. The little trick about setting the language
5363 % number is designed to suppress automatic hyphenation in the poem
5364 % environment. The booleans tell the |\emendation| and
5365 % |\explanatory| macros that there have not yet been emendations or
5366 % explanatory notes for this poem. The little trick with |\mark| sets
5367 % the value of |\mark| to the current value of |\stanzaatbottom| (by
5368 % default *) if the current location is in a poem but not in a stanza
5369 % (which is to say, in a stanza break). The |\pagestyle| for poetry
5370 % sets the value of |\mark| in the footer, which is * if the page break
5371 % happens at a stanza break, and |\relax| if the page break happens
5372 % anywhere else. \label{poemdef}
5373 % \begin{macro}{poem}
5374 % \begin{macrocode}
5375 \newlength{\versewidth}
5376 \setlength{\versewidth}{\linewidth}% default length for \versewidth
5377 \newenvironment{poem}[1][\linewidth]
5378 {\raggedright%
5379 \language=255%no hyphenation in verse
5380 \noemendyettrue%
5381 \noexplainyettrue%
5382 \setcounter{verselinenumber}{0}\setcounter{printlineindex}{0}%
5383 \nobreak\begin{pmclverse}[#1]%
5384 \inpoemtrue\nobreak\mark{\relax}%
5385 }{\end{pmclverse}%
5386 \inpoemfalse\mark{\relax}%
5387 \goodbreak\afterpoemskip%\bigskip
5388 }
5389 % \end{macrocode}
5390 % \end{macro}
5391 % \begin{macro}{rightflushverse}
5392 % Sets verse with the runover portions of long lines flushed to the right. Each line
5393 % must begin with |\rightversebegin|.This code was suggested to me by Mark Wooding
5394 % on comp.text.tex, who describes the code as ``very unpleasant.''
5395 % \begin{macrocode}
5396 \newenvironment{rightflushverse}{\let\oldleftskip=\leftskip%
5397 \leftskip=1 \leftskip\advance\leftskip by 0pt plus 1fill}%
5398 {\let\leftskip=\oldleftskip}
5399 % \end{macrocode}
5400 % \end{macro}
5401 % \subsection{~Environments: main title page, divider pages}
5402 % Environments for the main title page, and for the divider pages for
5403 % individual volumes in a Collected Poems.
5404 % \begin{macro}{volumetitlepage}
5405 % \begin{macro}{maintitlepage}
5406 % \begin{macro}{booksectionpage}
5407 % \begin{macrocode}
5408 \newenvironment{volumetitlepage}
5409 {\par\clearpage{\pagestyle{volumetitlestyle}\cleardoublepage}
5410 \thispagestyle{volumetitlestyle}}
5411 {\newpage\thispagestyle{volumetitlestyle}
5412 \cleardoublepage\thispagestyle{volumefirststyle}}
5413 \newenvironment{maintitlepage}
5414 {\par\cleardoublepage\thispagestyle{volumetitlestyle}
5415 }{\newpage\thispagestyle{volumetitlestyle}\cleardoublepage}
5416 \newenvironment{booksectionpage}
5417 {\par\newpage\thispagestyle{volumetitlestyle}}{\newpage}
5418 % \end{macrocode}
5419 % \end{macro}
5420 % \end{macro}
5421 % \end{macro}
5422 % \subsection{~Marginal line numbers, verse lines, line cross
5423 % references, etc.}\label{marginalgeometry} The default is that the
5424 % line numbers are on the left side, and that the |\marginparsep| is
5425 % 18pt. If you use |\pmclleftsidepar| the placement of the number is
5426 % controlled by |\marginparsep| and |\marginparwidth|. You should
5427 % experiment with different values until you find a set that suits
5428 % you. A rule of thumb for me is that the |\marginparsep| if the
5429 % numbers is on the right should be the negative of the value if it is
5430 % on the left. First, some lengths and ifs:
5431 % \begin{macrocode}
5432 \setlength{\marginparsep}{18pt}
5433 \setlength{\marginparwidth}{18pt}
5434 \newif\ifnumbersswitch \numbersswitchfalse
5435 \newif\ifnumbersright \numbersrightfalse
5436 % \end{macrocode}
5437 % Next, code for |\pmclsidepar|, taken from the memoir class, by
5438 % Peter Wilson. Modified by Dan Luecking.
5439 % \begin{macro}{\pmclsidepar}
5440 % \begin{macrocode}
5441 \newcommand{\pmclsidepar}{\@dblarg{\@pmclsidepar}}
5442 %\long\def\@pmclsidepar[#1]#2{\@bsphack\leavevmode\vadjust{%
5443 \long\def\@pmclsidepar[#1]#2{\@bsphack\strut\vadjust{% added
5444 \checkoddpage
5445 \ifpmclsideparswitch
5446 \ifpmclreversesidepar
5447 \ifoddpage
5448 \oddpagefalse
5449 \else
5450 \oddpagetrue
5451 \fi
5452 \fi
5453 \else
5454 \oddpagetrue
5455 \ifpmclreversesidepar
5456 \oddpagefalse
5457 \fi
5458 \fi
5459 \rlap{\kern-\parindent
5460 \if@twocolumn
5461 \if@firstcolumn % put at left
5462 \kern -\marginparsep \kern -\marginparwidth % at left
5463 \else % put at right
5464 \kern \columnwidth \kern \marginparsep % at right
5465 \fi
5466 \else
5467 \ifoddpage % put at right
5468 \kern \textwidth \kern \marginparsep % at right
5469 \else % put at left
5470 \kern -\marginparsep \kern -\marginparwidth % at left
5471 \fi
5472 \fi
5473 % \vbox to 0pt{%
5474 % \kern \pmclsideparvshift% % vertical shift to align top text lines
5475 % \begin{minipage}{\marginparwidth}%
5476 \setbox0=\vtop to 0pt{% added
5477 \begin{minipage}[t]{\marginparwidth}% added
5478 \ifoddpage #2\else #1\fi%
5479 \end{minipage}%
5480 % \vss}}}\@esphack}
5481 \vss}% added
5482 \vtop to 0pt{\kern\pmclsideparvshift % default should be 0pt
5483 \kern-\dp\strutbox \kern-\ht0 \box0 \vss}}}\@esphack}% added
5484
5485
5486 % \end{macrocode}
5487 % \end{macro}
5488 % \begin{macro}{\thepmemc@@page}
5489 % The value of the page counter.
5490 % \begin{macrocode}
5491 \gdef\thepmemc@@page{\the\c@page}
5492
5493 % \end{macrocode}
5494 % \end{macro}
5495 % \begin{macro}{\pmemlabel}
5496 % A version of |\label| that uses |\pmemprotected@write|.
5497 % \begin{macrocode}
5498 \providecommand{\pmemlabel}[1]{\@bsphack
5499 \pmemprotected@write\@auxout{}%
5500 {\string\newpmemlabel{#1}{\thepmemc@@page}}%
5501 \@esphack}
5502 % \end{macrocode}
5503 % \end{macro}
5504 % \begin{macro}{\pmemprotected@write}
5505 % |\pmemprotected@write| is a modified version of the kernel's
5506 % |\protected@write|.
5507 %
5508 % \begin{macrocode}
5509 \long\def\pmemprotected@write#1#2#3{%
5510 \begingroup
5511 \let\thepmemc@@page\relax
5512 #2%
5513 \let\protect\@unexpandable@protect
5514 \edef\reserved@a{\write#1{#3}}%
5515 \reserved@a
5516 \endgroup
5517 \if@nobreak\ifvmode\nobreak\fi\fi}
5518
5519 % \end{macrocode}
5520 % \end{macro}
5521 % \begin{macro}{\newpmemlabel}
5522 % \begin{macro}{\pmemlabelref}
5523 % We have to be able to cope with a particular label
5524 % not (yet) being in the the aux file when we come to check
5525 % the page number.
5526 % \begin{macrocode}
5527 \providecommand{\newpmemlabel}[2]{{\global\@namedef{m@#1}{#2}}}
5528 \providecommand{\pmemlabelref}[1]{%
5529 \expandafter\ifx\csname m@#1\endcsname\relax
5530 0%
5531 \else
5532 \csname m@#1\endcsname
5533 \fi}
5534
5535 % \end{macrocode}
5536 % \end{macro}
5537 % \end{macro}
5538 % \begin{macro}{\@memcnta}
5539 % We need a scratch count register.
5540 % \begin{macrocode}
5541 \newcount\@memcnta
5542 % \end{macrocode}
5543 % \end{macro}
5544 % \begin{macro}{\checkoddpage}
5545 % This is the user level command to check for odd/even page. It does
5546 % a robust check for |\strictpagecheck| otherwise the simple minded
5547 % check. It sets |\ifoddpage| to TRUE if the page is odd, otherwise
5548 % it sets it to FALSE.
5549 %
5550 % This is now fixed so that it should work for non-arabic page numbering.
5551 % It uses a new label/pageref variant based on the page counter value, not
5552 % its printed representation. This also gets rid of worrying about hyperref!!
5553 % The problem was discovered by Bastiaan Niels Veelo
5554 %
5555 % \begin{macrocode}
5556 \DeclareRobustCommand{\checkoddpage}{%
5557 \oddpagefalse%
5558 \ifstrictpagecheck%
5559 \stepcounter{cp@cntr}\pmemlabel{\cplabel\thecp@cntr}%
5560 \@memcnta=\pmemlabelref{\cplabel\thecp@cntr}\relax
5561 \ifodd\@memcnta\oddpagetrue\fi
5562 \else
5563 \ifodd\c@page\oddpagetrue\fi
5564 \fi}
5565
5566 % \end{macrocode}
5567 % \end{macro}
5568 % \begin{macro}{\ifpmclreversesidepar}
5569 % \begin{macro}{\ifpmclsideparswitch}
5570 % Analogues of |\marginpar| controls.
5571 % \begin{macrocode}
5572 \newif\ifpmclreversesidepar
5573 % \pmclreversesideparfalse
5574 \pmclreversesidepartrue
5575 \newif\ifpmclsideparswitch
5576 \pmclsideparswitchfalse
5577 \if@twoside \pmclsideparswitchtrue \fi
5578
5579 % \end{macrocode}
5580 % \end{macro}
5581 % \end{macro}
5582 % \begin{macro}{\ifoddpage}
5583 % \begin{macro}{\ifstrictpagecheck}
5584 % \begin{macro}{\c@cp@cntr}
5585 % \begin{macro}{\cplabel}
5586 % The boolean |\ifoddpage| is TRUE if the checked page is odd. The
5587 % boolean |\ifstrictpagecheck| is for turning on (TRUE) and off (FALSE)
5588 % the strictest method of page checking. The counter |cp@cntr| is used
5589 % to make unique labels, which start with |\cplabel|.
5590 % \begin{macrocode}
5591 \newif\ifoddpage
5592 \newif\ifstrictpagecheck
5593 \strictpagecheckfalse
5594 \newcounter{cp@cntr}
5595 \newcommand{\cplabel}{^_}
5596 % \end{macrocode}
5597 % \end{macro}
5598 % \end{macro}
5599 % \end{macro}
5600 % \end{macro}
5601 % Two-column and one-column printing is again realized via a switch
5602 % which is defined in the kernel. The default is single column printing.
5603 %
5604 %
5605 % \begin{macro}{\pmclsideparvshift}
5606 % Vertical shift for sidepar to align with text line
5607 % \begin{macrocode}
5608 \newlength{\pmclsideparvshift}
5609 % \setlength{\pmclsideparvshift}{-2.08ex}% seems to work for all font sizes
5610 %\setlength{\pmclsideparvshift}{-2.58ex}
5611 \setlength{\pmclsideparvshift}{0ex}
5612 % \end{macrocode}
5613 % \end{macro}
5614 % My code resumes here
5615 % \begin{macro}{\verselinenumberstoleft}
5616 % \begin{macro}{\verselinenumberstoright}
5617 % \begin{macrocode}
5618 \newcommand{\verselinenumberstoleft}{%
5619 % \setlength{\marginparsep}{18pt}%
5620 % \setlength{\marginparwidth}{10pt}%
5621 \numbersswitchfalse\numbersrightfalse}
5622 \newcommand{\verselinenumberstoright}{%
5623 % \setlength{\marginparsep}{18pt}%
5624 % \setlength{\marginparwidth}{10pt}%
5625 \numbersswitchfalse\numbersrighttrue}
5626 % \end{macrocode}
5627 % \end{macro}
5628 % \end{macro}
5629 % \begin{macro}{\verselinenumbersswitch}
5630 % \begin{macro}{\verselinenumbersgutter}
5631 % \begin{macro}{\verselinenumbersouter}
5632 % \begin{macrocode}
5633 \newcommand{\verselinenumbersswitch}{%
5634 \strictpagechecktrue%
5635 % \setlength{\marginparsep}{18pt}%
5636 % \setlength{\marginparwidth}{10pt}%
5637 \numbersswitchtrue\numbersrightfalse\pmclsideparswitchtrue}
5638 \newif\ifnumbersgutter \numbersgutterfalse%
5639 \newcommand{\verselinenumbersgutter}{\verselinenumbersswitch%
5640 \pmclreversesideparfalse%
5641 \numbersguttertrue%
5642 }
5643 \newcommand{\verselinenumbersouter}{\verselinenumbersswitch%
5644 \pmclreversesidepartrue%
5645 \numbersgutterfalse}
5646 % \end{macrocode}
5647 % \end{macro}
5648 % \end{macro}
5649 % \end{macro}
5650 % \begin{macro}{\putverselinenumber}
5651 % \begin{macrocode}
5652 \newcommand{\putverselinenumber}{\nolinebreak\begin{marginenvironment}%
5653 \nolinebreak%
5654 % \ifnumbersswitch\marginpar{\hfil\textrm{\scriptsize\theverselinenumber}}%
5655 % \else%
5656 % \ifnumbersright\marginpar{\hfil\textrm{\scriptsize\theverselinenumber}}%
5657 % \else%
5658 % \marginpar{\textrm{\scriptsize\theverselinenumber}\hfil}%
5659 % \fi%
5660 % \fi
5661 \ifnumbersswitch\pmclsidepar{\hfil\textrm{\scriptsize\theverselinenumber}}%
5662 \else%
5663 \ifnumbersright\pmclrightsidepar{\hfil\textrm{\scriptsize\theverselinenumber}}%
5664 \else%
5665 \pmclleftsidepar
5666 {\textrm{\scriptsize\theverselinenumber}\hfil}%
5667 \fi%
5668 \fi%
5669 % \marn{\hfil\textrm{\theverselinenumber}}
5670 % \marginpar{\hfil\textrm{\scriptsize\theverselinenumber}}
5671 % \linenumberside{\textrm{\scriptsize\theverselinenumber}\hfil}
5672 % \pmclrightsidepar{\textrm{\scriptsize\theverselinenumber}}
5673 \nolinebreak%
5674 \end{marginenvironment}%
5675 \nolinebreak%
5676 }
5677 % \end{macrocode}
5678 % \end{macro}
5679 % \begin{macro}{\verseline}
5680 % \begin{macrocode}
5681 \newif\ifspeciallinelock
5682 \speciallinelockfalse
5683 \newcommand{\verseline}{\ifspeciallinelock%
5684 \relax\else%
5685 \nolinebreak\incrementverselinenumber%
5686 \fi%
5687 \speciallinelockfalse%
5688 \nolinebreak\\%
5689 }
5690 % \newif\iflongpoemon
5691 % \longpoemonfalse
5692 \newcommand{\incrementverselinenumber}{%
5693 \nolinebreak\addtocounter{verselinenumber}{1}%
5694 %\iflongpoemon\marksthe{verselinemark}{\theverselinenumber}\fi%
5695 %\makeatletter
5696 \@ifundefined{marksthe}{\relax}{\marksthe{verselinemark}{\theverselinenumber}}%
5697 %\makeatother
5698 \addtocounter{printlineindex}{1}%
5699 \ifnum\theprintlineindex>\thelineindexrepeat%
5700 \ifverselinenumbers\nobreak%
5701 \putverselinenumber\nobreak%
5702 \fi\nobreak%
5703 \setcounter{printlineindex}{0}%
5704 \fi%
5705 }
5706 \newcommand{\setverselinemodulo}[1]{%
5707 \setcounter{lineindexrepeat}{#1}%
5708 \addtocounter{lineindexrepeat}{-1}%
5709 }
5710 % \end{macrocode}
5711 % \end{macro}
5712 % \begin{macro}{\linebend}
5713 % A linebend is a a normal linebreak from \LaTeX, with no incrementing
5714 % of the line number counter, but the indentation makes the line look
5715 % like a run over line. If you change the value of the run over in the
5716 % definition of the |\verse| environment, be sure to change it here
5717 % too. |\linebend| should be used for tweaking how \textsf{poemscol}
5718 % runs over long lines.
5719 %
5720 % \begin{macrocode}
5721 \newcommand{\linebend}{\\
5722 \hspace{\runoverindentvalue}%
5723 }
5724 % \end{macrocode}
5725 % \end{macro}
5726 % |\saveverselinenumber| and |\restoreverselinenumber| are useful for setting
5727 % prose interjections in the midst of poems.
5728 % \begin{macro}{\saveverselinenumber}
5729 % \begin{macro}{\restoreverselinenumber}
5730 % \begin{macrocode}
5731 \newcommand{\saveverselinenumber}{\setcounter{verselinenumberscratch}%
5732 {\value{verselinenumber}}%
5733 \setcounter{printlineindexscratch}{\value{printlineindex}}}
5734 \newcommand{\restoreverselinenumber}{\setcounter{verselinenumber}%
5735 {\value{verselinenumberscratch}}%
5736 \setcounter{printlineindex}{\value{printlineindexscratch}}}
5737 % \end{macrocode}
5738 % \end{macro}
5739 % \end{macro}
5740 % \begin{macro}{\rightversebegin}
5741 % By default, \textsf{poemscol} indents the runover portion of long lines by the
5742 % amount |\runoverindent| (by default 6 em). It is possible to set verse so that
5743 % the runover portion is flushed to the right margin. To do this, you should
5744 % enclose the |\poem| environment in the |\rightflushverse| environment. And you
5745 % must mark the beginning of each verse line with |\rightversebegin|
5746 % \begin{macrocode}
5747 \newcommand{\rightversebegin}
5748 {\leavevmode\nobreak\hskip0pt plus -1fill\ignorespaces}
5749 % \end{macrocode}
5750 % \end{macro}
5751 % \begin{macro}{\hour}
5752 % |\hour| is useful for typesetting the AM and the PM in the time.
5753 % \begin{macrocode}
5754 \newcommand{\hour}[1]{{{\textsc{#1}}\ $\!\!\!$}
5755 }
5756 % \end{macrocode}
5757 % \end{macro}
5758 % \begin{macro}{\brokenline}
5759 % \begin{macro}{\versephantom}
5760 % |\brokenline| and |\versephantom{}| are a pair, useful for setting
5761 % cases where there is a line break in the midst of a single metrical
5762 % line. |\tweakbrokenline| ensures that the line number will mark
5763 % the first partial line if the line numbers are on the left, the
5764 % last partial line if the line numbers are on the right. If you
5765 % have issued |\tweakbrokenline| in your preamble, the setting of
5766 % runover lines may not be consistent with the setting of broken
5767 % lines, because the line number will be set on the level of the end
5768 % of the line. This is not a problem if the line numbers are set on
5769 % the right, but it may look odd if the numbers are set on the left.
5770 % |\startverseline| will ensure that the line number marks the
5771 % beginning of any line it begins. If you put |\startverseline| at
5772 % the beginning of the runover lines, it will ensure that the line
5773 % number marks the beginning, not the end, of the line. If you wish
5774 % |\startverseline| to align the number with the beginning of
5775 % runover lines when the line number is on the left, and with the
5776 % end of runover lines when the line number is on the right, issue
5777 % |\tweakstartverseline| in your preamble.
5778 % \begin{macrocode}
5779 \newcommand{\brokenline}{\\}
5780 \newcommand{\versephantom}[1]{\leavevmode\phantom{#1}}
5781 % \end{macrocode}
5782 % \end{macro}
5783 % \end{macro}
5784 % \begin{macro}{\tweakbrokenline}
5785 % Causes |\brokenline| to set the line number level with the
5786 % beginning of the line if the number is on the left, level with the
5787 % end of the line if the number is on the right. Issue it in the
5788 % preamble.
5789 % \begin{macrocode}
5790 \newcommand{\tweakbrokenline}{%
5791 \renewcommand{\brokenline}{\ifnumbersswitch\relax%
5792 \ifnumbersgutter% shift on odd pages for gutter numbers
5793 \ifodd\c@page \relax \else \speciallinelocktrue\incrementverselinenumber\fi
5794 \else % shift on even pages for outer numbers
5795 \ifodd\c@page \speciallinelocktrue\incrementverselinenumber \fi
5796 \fi
5797 \else \ifnumbersright \relax%
5798 \else \speciallinelocktrue\incrementverselinenumber%
5799 \fi%
5800 \fi%
5801 \\}
5802 }
5803 % \end{macrocode}
5804 % \end{macro}
5805 % \begin{macro}{\brokenlineatbeginning}
5806 % Issue |\brokenlineatbeginning| if you want broken line to set the
5807 % line number level with the beginning of the line, regardless of
5808 % whether the line number is at the right or at the left
5809 % \begin{macrocode}
5810 \newcommand{\brokenlineatbeginning}{%
5811 \renewcommand{\brokenline}{%
5812 \speciallinelocktrue\incrementverselinenumber%
5813 \\
5814 }
5815 }
5816 % \end{macrocode}
5817 % \end{macro}
5818 % \begin{macro}{\startverseline}
5819 % Put |\startverseline| at the beginning of every line where you wish
5820 % to ensure that the line number is level with the beginning of the
5821 % line. This is particularly useful for overrun lines when
5822 % |\tweakbrokenline| or |\brokenlineatbeginning| is in effect.
5823 % \begin{macrocode}
5824 \newcommand{\startverseline}{%
5825 \speciallinelocktrue%
5826 \leavevmode%
5827 %\kern-3pt
5828 \incrementverselinenumber%
5829 }
5830 % \end{macrocode}
5831 % \end{macro}
5832 % \begin{macro}{\tweakstartverseline}
5833 % You may want |\startverseline| to align the line number with the
5834 % beginning of the line if the line number is on the left, and with
5835 % the end of the line if the line number is on the right. To do this,
5836 % issue |\tweakstartline| in your preamble.
5837 % \begin{macrocode}
5838 \newcommand{\tweakstartverseline}{%
5839 \renewcommand{\startverseline}{%
5840 \leavevmode%
5841 \ifnumbersswitch%
5842 % gutter case: shift on odd pages to top of runover line
5843 \ifnumbersgutter%
5844 \ifodd\c@page \relax \else \speciallinelocktrue\incrementverselinenumber\fi
5845 % outer case: shift on even pages to top of runover line
5846 \else
5847 \ifodd\c@page \speciallinelocktrue\incrementverselinenumber \fi
5848 \fi% end of ifnumbersgutter
5849 \else \ifnumbersright \relax% numbers don't switch. Are they to the right?
5850 \else \speciallinelocktrue\incrementverselinenumber% or to the left?
5851 \fi% end of ifnumbersright
5852 \fi% end of ifnumbersswitch
5853 }% end of renewcommand
5854 }% end of tweakverseline
5855 % \end{macrocode}
5856 % \end{macro}
5857 % \begin{macro}{\poemlinelabel}
5858 % |\poemlinelabel| is a hacked version of |\label| for crossreferences by
5859 % line.
5860 % \begin{macrocode}
5861 \def\poemlinelabel#1{\@bsphack
5862 \protected@write\@auxout{}%
5863 {\string\newlabel{#1}{{\theverselinenumber}{\thepage}}}%
5864 \@esphack
5865 }
5866 % \end{macrocode}
5867 % \end{macro}
5868 % \subsection{~Setup for contents, textual notes, emendations, and explanatory notes}
5869 % First, the table of contents:
5870 % \begin{macro}{\makepoemcontents}
5871 % An external file is created with the extension .ctn, and the
5872 % filename of your driver file. The
5873 % channel to that file is called |\poemcontents|. The rest of the
5874 % command is the page style for the contents section. You will notice
5875 % the running head Contents, and the title of the Contents section. I am
5876 % assuming that the table of contents starts on page 5, but it may be
5877 % different in different books.
5878 % If you want to change that page
5879 % number (say, to page 3) without messing with this file, issue
5880 % |\literalcontents{\setcounter{page}{3}}| just after you issue
5881 % |\makepoemcontents| Alternatively, you can issue |\makepoemcontents{}| with its
5882 % optional argument, putting the page number in the argument.
5883 % \begin{macrocode}
5884 \newtoks{\pmclcontentsname}
5885 \pmclcontentsname={CONTENTS}
5886 \newtoks{\pmclcontentsheader}
5887 \pmclcontentsheader={Contents}
5888 \newcommand{\changecontentsname}[1]{%
5889 \pmclcontentsname={#1}}
5890 \newcommand{\changecontentsheader}[1]{%
5891 \pmclcontentsheader={#1}}
5892 \newcommand{\makepoemcontents}[1][5]{\global\poemcontentsontrue
5893 \newwrite\poemcontents
5894 \immediate\openout\poemcontents=\jobname.ctn
5895 \literalcontents{\flushbottom\normalfont
5896 {\par\clearpage{\pagestyle{volumetitlestyle}\cleardoublepage}
5897 \pagestyle{fancy}\thispagestyle{volumetitlestyle}}
5898 \pagenumbering{roman}
5899 \setcounter{page}{#1}
5900 \fancyhead[RO,LE]{{\small\textrm{\thepage}}}
5901 \fancyhead[CO]{{\small{\em \the\pmclcontentsheader}}}
5902 \fancyhead[CE]{{\small{\em \the\pmclcontentsheader}}}
5903 \fancyfoot{}
5904 \backmattersink
5905 \begin{center}{\normalfont \backmatterheaderfont
5906 \the\pmclcontentsname}\end{center}
5907 \lefthyphenmin=2\backmatterafterheadersink\tolerance=500\language=0}
5908 \literalcontents{ \relax}}
5909 % \end{macrocode}
5910 % \end{macro}
5911
5912 % Next, the textual collations:
5913 % \begin{macro}{\maketextnotes} Like the |\makecontents| macro,
5914 % |\maketextnotes| opens an external file using |\jobname|, this time with the extension .ent. It
5915 % makes sure that line numbering is on (since it makes no sense to make
5916 % notes without numbering the lines, particularly since the
5917 % |\textnote{}| macro uses the line number). And it makes sure that the
5918 % notes section is set with a flush bottom line, rather than with the
5919 % ragged bottom line used for the verse sections. Also, it sets a
5920 % label for sending the page number of the textual notes to the table of
5921 % contents.
5922 %
5923 % First, a few commands for use by all of the endnotes
5924 % sections. |\setendnotessectiontitledefaults| sets the title of the endnotes section
5925 % at the top of the first page of that species of note, and takes six arguments,
5926 % which are, in order, (1) the title of the endnote section, (2)
5927 % commands to be issued before setting the
5928 % title (minimally, a penalty, such as |\poemtitlepenalty|), (3) the
5929 % font size in which the title is to be set in the text (such as
5930 % |\poemtitlefont| or |\large|), (4) any indentation of the title
5931 % (|\relax| to put the title where |\poemtitle| puts it, or |\titleindent| to put it where
5932 % |\sequencesectiontitle| puts it), (5) commands to be issued after the
5933 % title is set (such as |\afterpoemtitleskip|) and (6) the label to
5934 % be used for this section, to be used to set the page number in the
5935 % table of contents.
5936 %
5937 % |\setendnotessectiontitle| is a simpler version of |\setendnotessectiontitledefaults|
5938 % with all the defaults filled in, leaving only two arguments, the
5939 % title of the section, and the label for use by the table of
5940 % contents.
5941 %
5942 % |\contentsendnotesdefaults| sets the defaults for the table of
5943 % contents entries for endnotes sections. It takes four arguments
5944 % which are, in order, (1) the title of the endnote section, (2) the
5945 % indentation of the title in the table of contents (such as
5946 % |\contentsindentone|), (3), the font size in which the title
5947 % should be set (such as |\contentspoemtitlefont|) and (4) the amount
5948 % overrun lines in the table of contents should be indented (such as
5949 % |\contentsindenttwoamount|).
5950 %
5951 % |\contentsendnotesindent| sets the default indent for table of
5952 % contents entries for endnotes sections, and |\contentsendnotesfont|
5953 % sets the default font for the.
5954 %
5955 % |\contentsendnotestitle| is a simpler command for sending
5956 % information about endnote sections to the table of contents, taking
5957 % only two arguments, the title and the label used for page reference
5958 % purposes.
5959 % \begin{macrocode}
5960 % Generic command for titles of endnote sections
5961 \newcommand{\setendnotessectiontitledefaults}[6]{%
5962 #2%
5963 #3 \begin{titleentryenvironment}%
5964 {\ifcentertitleson\begin{center}#1\end{center}\else #4 #1\fi}%
5965 \end{titleentryenvironment}%
5966 #5%
5967 \label{#6}
5968 }
5969 % Simpler version with only two parameters, the title and the label
5970 % for page references
5971 \newcommand{\setendnotessectiontitle}[2]{%
5972 \setendnotessectiontitledefaults{#1}{\poemtitlepenalty\backmattersink}{\backmatterheaderfont}
5973 {\notestitleindent}{\lefthyphenmin=2\backmatterafterheadersink}{#2}}
5974 % Generic command for sending info about endnotes sections to table
5975 % of contents
5976 \newcommand{\contentsendnotesdefaults}[4]{\ifpoemcontentson
5977 \immediate\write\poemcontents{\string\begin\string{contentsentryenvironment\string}}%
5978 \literalcontents{#2{#3#1}}%
5979 \ifputpagenumberincontents
5980 \immediate\write\poemcontents{\string\contentsleaders}%
5981 \immediate\write\poemcontents{\string\pageref
5982 \string{#4\string}}%
5983 \else
5984 \literalcontents{\relax}%
5985 \fi
5986 \immediate\write\poemcontents{\string\end\string{contentsentryenvironment\string}}%
5987 \immediate\write\poemcontents{\string\par}%
5988 \fi
5989 }
5990 % default styles for contents entries for endnotes sections
5991 \newcommand{\contentsendnotesindent}{\contentsindentone}
5992 \newcommand{\contentsendnotesfont}{\contentspoemtitlefont}
5993 % simpler command to set up contents entry with only two parameters,
5994 % the title and the label for page references
5995 \newcommand{\contentsendnotestitle}[2]{%
5996 \contentsendnotesdefaults{#1}{\contentsendnotesindent}{\contentsendnotesfont}{#2}%
5997 }
5998 % command for paragraph breaks within notes
5999 \newlength{\noteindentation}
6000 \setlength{\noteindentation}{1em}
6001 \newcommand{\noteparbreak}{\\
6002 \hspace*{\noteindentation}}
6003 % tokens to use to change the names of the sections
6004 \newtoks{\pmclnotesname}
6005 \pmclnotesname={TEXTUAL NOTES}
6006 \newcommand{\changenotesname}[1]{\pmclnotesname={#1}}
6007 \newtoks{\notesheadername}
6008 \notesheadername={Textual Notes to}
6009 \newcommand{\changenotesheader}[1]{\notesheadername={#1}}
6010 \newtoks{\textnotescontentsname}
6011 \textnotescontentsname={Textual Notes}
6012 \newcommand{\changetextnotescontentsname}[1]{\textnotescontentsname={#1}}
6013 % A boolean to change to two column notes.
6014 \newif\iftextnotestwocol
6015 \textnotestwocolfalse
6016 % Setup for textual notes
6017 \newcommand{\maketextnotes}{\global\textnotesontrue
6018 \global\verselinenumberstrue
6019 \newwrite\textnotes
6020 \immediate\openout\textnotes=\jobname.ent
6021 \literaltextnote{\flushbottom{\par\clearpage
6022 {\pagestyle{volumetitlestyle}\cleardoublepage}
6023 \thispagestyle{volumetitlestyle}}
6024 \fancyhead{}
6025 \fancyfoot{}
6026 \fancyhead[RO,LE]{{\small\textrm{\thepage}}}
6027 \fancyhead[CO]{{\small{\em \the\notesheadername~\mymarks}}}
6028 \fancyhead[CE]{{\small{\em \the\notesheadername~\mymarks}}}
6029 \fancyfoot[C]{}
6030 \mark{3}
6031 \setendnotessectiontitle{\the\pmclnotesname}{textualnotes}
6032 \tolerance=500\language=0
6033 \normalfont \backmattertextfont
6034 \iftextnotestwocol
6035 \begin{multicols}{2}
6036 \fi
6037 \setlength{\parindent}{-10pt}
6038 }
6039 }
6040
6041 % \end{macrocode}
6042 % \end{macro}
6043
6044 % \begin{macro}{\makeemendations}
6045 % Next, the emendations section:
6046 % \begin{macrocode}
6047 % tokens for changing the names of these notes
6048 \newtoks{\emendationsname}
6049 \emendationsname={EMENDATIONS}
6050 \newcommand{\changeemendationsname}[1]{\emendationsname={#1}}
6051 \newtoks{\emendationsheadername}
6052 \emendationsheadername={Emendations to}
6053 \newcommand{\changeemendationsheader}[1]{\emendationsheadername={#1}}
6054 \newtoks{\emendationscontentsname}
6055 \emendationscontentsname={Emendations}
6056 \newcommand{\changeemendationscontentsname}[1]{%
6057 \emendationscontentsname={#1}}
6058 % two column notes
6059 \newif\ifemendationstwocol
6060 \emendationstwocolfalse
6061 % Emendations section setup
6062 \newcommand{\makeemendations}{\global\emendationsontrue
6063 \newwrite\emendations
6064 \global\verselinenumberstrue
6065 \immediate\openout\emendations=\jobname.emd
6066 \literalemend{\flushbottom{\par\clearpage
6067 {\pagestyle{volumetitlestyle}\cleardoublepage}
6068 \thispagestyle{volumetitlestyle}}
6069 \fancyhead{}
6070 \fancyhead[RO,LE]{{\small\textrm{\thepage}}}
6071 \fancyhead[CO]{{\small{\em \the\emendationsheadername~\mymarks}}}
6072 \fancyhead[CE]{{\small{\em \the\emendationsheadername~\mymarks}}}
6073 \fancyfoot{}
6074 \mark{3}
6075 \setendnotessectiontitle{\the\emendationsname}{emendationnotes}
6076 \tolerance=500\language=0
6077 \normalfont \backmattertextfont
6078 \ifemendationstwocol
6079 \begin{multicols}{2}
6080 \fi
6081 \setlength{\parindent}{-10pt}
6082 }
6083 }
6084 % \end{macrocode}
6085 % \end{macro}
6086
6087 % \begin{macro}{\makeexplanatorynotes}
6088 % And the explanatory notes:
6089 % \begin{macrocode}
6090 % Tokens to change names of these notes
6091 \newtoks{\explanationsname}
6092 \explanationsname={EXPLANATORY NOTES}
6093 \newcommand{\changeexplanationsname}[1]{\explanationsname={#1}}
6094 \newtoks{\explanationsheadername}
6095 \explanationsheadername={Explanatory Notes to}
6096 \newcommand{\changeexplanationsheader}[1]{\explanationsheadername={#1}}
6097 \newtoks{\explanationscontentsname}
6098 \explanationscontentsname={Explanatory Notes}
6099 \newcommand{\changeexplanationscontentsname}[1]{%
6100 \explanationscontentsname={#1}}
6101 % Two column notes
6102 \newif\ifexplanationstwocol
6103 \explanationstwocolfalse
6104 % Explanatory notes setup
6105 \newcommand{\makeexplanatorynotes}{\global\explanontrue
6106 \global\verselinenumberstrue
6107 \newwrite\explanations
6108 \immediate\openout\explanations=\jobname.enx
6109 \literalexplain{\flushbottom{\par\clearpage
6110 {\pagestyle{volumetitlestyle}\cleardoublepage}
6111 \thispagestyle{volumetitlestyle}}
6112 \fancyhead[RO,LE]{{\small\textrm{\thepage}}}
6113 \fancyhead[CO]{{\small{\em \the\explanationsheadername~\mymarks}}}
6114 \fancyhead[CE]{{\small{\em \the\explanationsheadername~\mymarks}}}
6115 \fancyfoot{}
6116 \mark{3}
6117 \setendnotessectiontitle{\the\explanationsname}{explanatorynotes}
6118 \tolerance=500\language=0
6119 \normalfont \backmattertextfont
6120 \ifexplanationstwocol
6121 \begin{multicols}{2}
6122 \fi
6123 \setlength{\parindent}{-10pt}
6124 }
6125 }
6126
6127 % \end{macrocode}
6128 % \end{macro}
6129 %
6130 % Auxiliary commands for note and title sections
6131 % \begin{macrocode}
6132 %
6133 \newcommand{\@pagemarktotextnotes}[1]{%
6134 \immediate\write\textnotes{\string\setcounterfrompageref\string{notepageholdertitle\string}%
6135 \string{#1\string}\string\unskip}%
6136 \immediate\write\textnotes{\string\mark%
6137 \string{\string\thenotepageholdertitle\string}}%
6138 }
6139 \newcommand{\@poempagetotextnotes}[1]{%
6140 \immediate\write\textnotes{\string\par\string\argpageref\string{#1\string}\string\unskip}%
6141 \@pagemarktotextnotes{#1}}
6142 \newcommand{\@poemtitletotextnotes}[1]{%
6143 \ifputpagenumberinnotes%
6144 \literaltextnote{\textbf{#1}}%
6145 \else%
6146 \literaltextnote{\par}\literaltextnote{\textbf{#1}}%
6147 \fi}
6148 % \end{macrocode}
6149 %
6150 % \subsection{~Appendices, Forewords, Contents Entries}
6151 % \begin{macro}{\makeappendix}
6152 % \begin{macrocode}
6153 \newif\ifappendixincontents
6154 \appendixincontentstrue
6155 \newif\ifforewordincontents
6156 \forewordincontentstrue
6157 %
6158 \newcommand{\appendixdividerpage}[1]{\flushbottom{\par\clearpage
6159 {\pagestyle{volumetitlestyle}\cleardoublepage}
6160 \thispagestyle{volumetitlestyle}}
6161 \fancyhead{}
6162 \fancyfoot{}
6163 \fancyhead[RO,LE]{\small\textrm{\thepage}}
6164 \fancyhead[CO]{\small{\em #1}}
6165 \fancyhead[CE]{#1}
6166 \fancyfoot[C]{}}
6167 %
6168 \newcommand{\appendixtitle}[1]{
6169 \setendnotessectiontitledefaults{#1}{\poemtitlepenalty\backmattersink}{\backmatterheaderfont}
6170 {\appendixtitleindent}{\lefthyphenmin=2\backmatterafterheadersink}{appdx#1}
6171 \tolerance=500\language=0
6172 \normalfont \backmattertextfont
6173 \setlength{\parindent}{\noteindentation}
6174 \ifappendixincontents\contentsendnotestitle{#1}{appdx#1}\fi
6175 }
6176 %
6177 \newcommand{\makeappendix}[1]{%
6178 \appendixdividerpage{#1}
6179 \appendixtitle{#1}
6180 }
6181 %
6182 \newcommand{\contentsendnotessubtitle}[2]{
6183 \contentsendnotesdefaults{#1}{\contentsindenttwo}{\contentsendnotesfont}{#2}
6184 }
6185 %
6186 \newcommand{\subappendixtitle}[1]{%
6187 \setendnotessectiontitledefaults{#1}{\poemtitlepenalty\backmattersink}{\backmatterheaderfont}
6188 {\subappendixtitleindent}{\lefthyphenmin=2\backmatterafterheadersink}{appdx#1}
6189 \tolerance=500\language=0
6190 \normalfont \backmattertextfont
6191 \setlength{\parindent}{\noteindentation}
6192 \ifappendixincontents\contentsendnotessubtitle{#1}{appdx#1}\fi
6193 }
6194 %
6195 \newcommand{\makesubappendix}[1]{%
6196 \appendixdividerpage{#1}
6197 \subappendixtitle{#1}
6198 }
6199 \newcommand{\foreworddividerpage}[1]{\flushbottom{\par\clearpage
6200 {\pagestyle{volumetitlestyle}\cleardoublepage}
6201 \thispagestyle{volumetitlestyle}}
6202 \fancyhead{}
6203 \fancyfoot{}
6204 \fancyhead[RO,LE]{\small\textrm{\thepage}}
6205 \fancyhead[CO]{\small{\em #1}}
6206 \fancyhead[CE]{#1}
6207 \fancyfoot[C]{}}
6208 %
6209 \newcommand{\forewordtitle}[1]{
6210 \setendnotessectiontitledefaults{#1}{\poemtitlepenalty\backmattersink}{\backmatterheaderfont}
6211 {\forewordtitleindent}{\lefthyphenmin=2\backmatterafterheadersink}{foreword#1}
6212 \tolerance=500\language=0
6213 \normalfont \backmattertextfont
6214 \setlength{\parindent}{\noteindentation}
6215 \ifforewordincontents\contentsendnotestitle{#1}{foreword#1}\fi
6216 }
6217 %
6218 \newcommand{\makeforeword}[1]{%
6219 \foreworddividerpage{#1}
6220 \forewordtitle{#1}
6221 }
6222
6223 % \end{macrocode}
6224 % \end{macro}
6225 % \begin{macro}{\pmclcontentsentry}
6226 % \begin{macrocode}
6227 \newcommand{\pmclcontentsentrydefaults}[4]{
6228 \ifpoemcontentson
6229 \immediate\write\poemcontents{\string\begin\string{contentsentryenvironment\string}}%
6230 \literalcontents{#2{#3#1}}%
6231 \ifputpagenumberincontents
6232 \immediate\write\poemcontents{\string\contentsleaders}%
6233 \literalcontents{#4}
6234 \else
6235 \literalcontents{\relax}%
6236 \fi
6237 \immediate\write\poemcontents{\string\end\string{contentsentryenvironment\string}}%
6238 \immediate\write\poemcontents{\string\par}%
6239 \fi
6240 }
6241 %
6242 \newcommand{\pmclcontentsentry}[3]{%
6243 \pmclcontentsentrydefaults{#1}{#2}{\contentsendnotesfont}{#3}%
6244 }
6245 % \end{macrocode}
6246 % \end{macro}
6247 % \subsection{~Book, volume, and volume section titles}
6248 % \begin{macro}{\wholebooktitle}
6249 % \begin{macro}{\booksection}
6250 % \begin{macrocode}
6251 \newcommand{\wholebooktitle}[1]{{\Huge\begin{center}
6252 \hbox{#1}\end{center}}
6253 }
6254 \newcommand{\booksection}[1]{\volumesection{#1}}
6255 % \end{macrocode}
6256 % \end{macro}
6257 % \end{macro}
6258 % \begin{macro}{\volumetitle{}}
6259 % \begin{macrocode}
6260 \newcommand{\volumetitle}[1]{%
6261 \set@p@emtitle{#1}{\volumetitlesink\par}{\volumetitlefont}
6262 {\volumetitleindent}{\nobreak\par\nobreak}{\z@}
6263 \putpagenumberincontentsfalse
6264 \putpagenumberinnotesfalse
6265 \literalcontents{\par\goodbreak\bigskip}
6266 \c@ntentsinfo{#1}{\contentsvolumetitleindent}{\contentsvolumefont}
6267 {\contentsvolumetitleindentamount}
6268 \literalcontents{\par\goodbreak\medskip}
6269 \literaltextnote{\notesvolumetitlepenalty\bigskip\goodbreak\par}
6270 \t@xtnotesinfo{\backmattervolumefont #1 \backmattertextfont\nobreak}
6271 \putpagenumberincontentstrue
6272 \putpagenumberinnotestrue}
6273 % \end{macrocode}
6274 % \end{macro}
6275 % \begin{macro}{\volumetitlefirstline}
6276 % \begin{macro}{\volumetitlelastline}
6277 % \begin{macro}{\volumesubtitle}
6278 % \begin{macro}{\volumesectiontitle}
6279 % \begin{macrocode}
6280 \newcommand{\volumetitlefirstline}[1]{\firstlinesettings%
6281 \set@p@emtitle{#1}{\volumetitlesink\par}
6282 {\volumetitlefont}
6283 {\volumetitleindent}{\nobreak\par\nobreak}{\z@}
6284 \putpagenumberincontentsfalse
6285 \putpagenumberinnotesfalse
6286 \literalcontents{\par\goodbreak\bigskip}
6287 \c@ntentsinfo{#1}{\contentsvolumetitleindent}{\contentsvolumefont}
6288 {\contentsvolumetitleindentamount}
6289 \literalcontents{\medskip\par\nobreak}
6290 % \literaltextnote{\notesvolumetitlepenalty\bigskip\par}
6291 \t@xtnotesinfo{\backmattervolumefont #1 \backmattertextfont\nobreak}
6292 \putpagenumberincontentstrue
6293 \putpagenumberinnotestrue}
6294 \newcommand{\volumetitlemiddleline}[1]{\middlelinesettings%
6295 \set@p@emtitle{#1}{\relax}
6296 {\volumetitlefont}
6297 {\volumetitlesecondlineindent}{\nobreak\par\nobreak}{\z@}
6298 \putpagenumberincontentsfalse
6299 \putpagenumberinnotesfalse
6300 \c@ntentsinfo{#1}{\contentsvolumetitleindent}{\contentsvolumefont}
6301 {\contentsvolumetitleindentamount}
6302 \literalcontents{\medskip\par\nobreak}
6303 \t@xtnotesinfo{\backmattervolumefont #1 \backmattertextfont\nobreak}
6304 \putpagenumberincontentstrue
6305 \putpagenumberinnotestrue}
6306 \newcommand{\volumetitlelastline}[1]{\lastlinesettings%
6307 \set@p@emtitle{#1}{\relax}
6308 {\volumetitlefont}
6309 {\volumetitlesecondlineindent}{\nobreak\par\nobreak}{\z@}
6310 \putpagenumberincontentsfalse
6311 \putpagenumberinnotesfalse
6312 \c@ntentsinfo{#1}{\contentsvolumetitleindent}{\contentsvolumefont}
6313 {\contentsvolumetitleindentamount}
6314 \literalcontents{\medskip\par\nobreak}
6315 \t@xtnotesinfo{\backmattervolumefont #1 \backmattertextfont\nobreak}
6316 \putpagenumberincontentstrue
6317 \putpagenumberinnotestrue}
6318 \newcommand{\volumesubtitle}[1]{{\volumesubtitlefont
6319 \volumetitleshift \volumesubtitleindent #1 \par}
6320 \ifpoemcontentson
6321 \literalcontents{{\contentsvolumesubtitlefont\contentsvolumesubtitleindent
6322 #1\par\medskip\nobreak}}
6323 \fi
6324 \iftextnoteson\iftextnotesatend
6325 \immediate\write\textnotes{\string\backmattervolumesubtitlefont\ #1}
6326 \immediate\write\textnotes{\string\par \string\backmattertextfont}
6327 \immediate\write\textnotes{\string\nobreak}
6328 \fi\fi
6329 }
6330 \newcommand{\volumesubtitlefirstline}[1]{{\firstlinesettings\volumesubtitlefont
6331 \volumetitleshift \volumesubtitlesecondlineindent #1 \par}
6332 \ifpoemcontentson
6333 \literalcontents{{\contentsvolumesubtitlefont\contentsvolumesubtitleindent
6334 #1\par\nobreak}}
6335 \fi
6336 \iftextnoteson\iftextnotesatend
6337 \immediate\write\textnotes{\string\backmattervolumesubtitlefont\ #1}
6338 \immediate\write\textnotes{\string\par \string\backmattertextfont}
6339 \immediate\write\textnotes{\string\nobreak}
6340 \fi\fi
6341 }
6342 \newcommand{\volumesubtitlemiddleline}[1]{{\middlelinesettings\volumesubtitlefont
6343 %\volumetitleshift
6344 \volumesubtitlesecondlineindent #1 \par}
6345 \ifpoemcontentson
6346 \literalcontents{{\contentsvolumesubtitlefont\contentsvolumesubtitleindent
6347 #1\par\nobreak}}
6348 \fi
6349 \iftextnoteson\iftextnotesatend
6350 \immediate\write\textnotes{\string\backmattervolumesubtitlefont\ #1}
6351 \immediate\write\textnotes{\string\par \string\backmattertextfont}
6352 \immediate\write\textnotes{\string\nobreak}
6353 \fi\fi
6354 }
6355 \newcommand{\volumesubtitlelastline}[1]{{\lastlinesettings\volumesubtitlefont
6356 %\volumetitleshift
6357 \volumesubtitlesecondlineindent #1 \par}
6358 \ifpoemcontentson
6359 \literalcontents{{\contentsvolumesubtitlefont\contentsvolumesubtitleindent
6360 #1\par\medskip\nobreak}}
6361 \fi
6362 \iftextnoteson\iftextnotesatend
6363 \immediate\write\textnotes{\string\backmattervolumesubtitlefont\ #1}
6364 \immediate\write\textnotes{\string\par \string\backmattertextfont}
6365 \immediate\write\textnotes{\string\nobreak}
6366 \fi\fi
6367 }
6368 \newcommand{\volumesectiontitle}[1]{\clearpage\thispagestyle{volumefirststyle}
6369 \ifcentertitleson\begin{center} {\volumesubtitlefont\textbf{#1}}
6370 \end{center}
6371 \else \volumesectiontitleindent {\volumesubtitlefont\textbf{#1}}
6372 \fi\bigskip\bigskip
6373 \ifpoemcontentson
6374 \literalcontents{\goodbreak{\ifcentertitleson\contentsvolumesubtitlefont #1\par\nobreak\else
6375 \contentsvolumesectiontitleindent #1 \par\nobreak\fi}}
6376 \fi
6377 \iftextnoteson\iftextnotesatend
6378 \immediate\write\textnotes{\string\notesvolumetitlepenalty}
6379 \immediate\write\textnotes{\string\par \string\begin{bf}}
6380 \immediate\write\textnotes{#1 \string\end{bf}}
6381 \immediate\write\textnotes{\string\par}
6382 \immediate\write\textnotes{\string\nobreak}
6383 \fi\fi
6384 }
6385 \newcommand{\volumesectiontitlefirstline}[1]{\firstlinesettings\clearpage\thispagestyle{volumefirststyle}
6386 \ifcentertitleson\begin{center} {\volumesubtitlefont\textbf{#1}}
6387 \end{center}
6388 \else \volumesectiontitleindent {\volumesubtitlefont\textbf{#1}\par}
6389 \fi% \bigskip\bigskip
6390 \ifpoemcontentson
6391 \literalcontents{\goodbreak{\ifcentertitleson\contentsvolumesubtitlefont #1\par\nobreak\else
6392 \contentsvolumesectiontitleindent #1 \par\nobreak\fi}}
6393 \fi
6394 \iftextnoteson\iftextnotesatend
6395 \immediate\write\textnotes{\string\notesvolumetitlepenalty}
6396 \immediate\write\textnotes{\string\par \string\begin{bf}}
6397 \immediate\write\textnotes{#1 \string\end{bf}}
6398 \immediate\write\textnotes{\string\par}
6399 \immediate\write\textnotes{\string\nobreak}
6400 \fi\fi
6401 }
6402 \newcommand{\volumesectiontitlemiddleline}[1]{\middlelinesettings
6403 %\clearpage\thispagestyle{volumefirststyle}
6404 \ifcentertitleson\begin{center} {\volumesubtitlefont\textbf{#1}}
6405 \end{center}
6406 \else \volumesectiontitleindent {\volumesubtitlefont\textbf{#1}\par}
6407 \fi% \bigskip\bigskip
6408 \ifpoemcontentson
6409 \literalcontents{\goodbreak{\ifcentertitleson\contentsvolumesubtitlefont #1\par\nobreak\else
6410 \contentsvolumesectiontitleindent #1 \par\nobreak\fi}}
6411 \fi
6412 \iftextnoteson\iftextnotesatend
6413 \immediate\write\textnotes{\string\notesvolumetitlepenalty}
6414 \immediate\write\textnotes{\string\par \string\begin{bf}}
6415 \immediate\write\textnotes{#1 \string\end{bf}}
6416 \immediate\write\textnotes{\string\par}
6417 \immediate\write\textnotes{\string\nobreak}
6418 \fi\fi
6419 }
6420 \newcommand{\volumesectiontitlelastline}[1]{\lastlinesettings
6421 %\clearpage\thispagestyle{volumefirststyle}
6422 \ifcentertitleson\begin{center} {\volumesubtitlefont\textbf{#1}}
6423 \end{center}
6424 \else \volumesectiontitleindent {\volumesubtitlefont\textbf{#1}}
6425 \fi\bigskip\bigskip
6426 \ifpoemcontentson
6427 \literalcontents{\goodbreak{\ifcentertitleson\contentsvolumesubtitlefont #1\par\nobreak\else
6428 \contentsvolumesectiontitleindent #1 \par\nobreak\fi}}
6429 \fi
6430 \iftextnoteson\iftextnotesatend
6431 \immediate\write\textnotes{\string\notesvolumetitlepenalty}
6432 \immediate\write\textnotes{\string\par \string\begin{bf}}
6433 \immediate\write\textnotes{#1 \string\end{bf}}
6434 \immediate\write\textnotes{\string\par}
6435 \immediate\write\textnotes{\string\nobreak}
6436 \fi\fi
6437 }
6438 % \end{macrocode}
6439 % \end{macro}
6440 % \end{macro}
6441 % \end{macro}
6442 % \end{macro}
6443
6444 % \subsection{~Commands for setting titles of poems and sequences}
6445 % First, commands for sending labels to the table of contents and to
6446 % the notes sections. Since these are internal commands, not intended
6447 % to be issued in the body of the text, they might have been marked out
6448 % with ``at'' signs to prevent accidental redefinition. But since they
6449 % are repeatedly written out to the external files, it seemed more
6450 % economical to run the risk of redefinition than to write out
6451 % |\makeatletter| and |\makeatother| with every note.
6452 % \begin{macrocode}
6453 \newcommand{\makepoemlabel}[1]{\label{#1}}
6454 \newcommand{\argpageref}[1]{\pageref{#1}}
6455 % \end{macrocode}
6456 % \subsubsection{Poem Titles}
6457 % \begin{macro}{\poemtitle}\label{poemtitlecode}
6458 % All of the other commands in this section are variations on this
6459 % one, changing the penalties, the skips, the indentations, and the
6460 % fonts. The command breaks into three sections. First, the title
6461 % is set in the text. |\poemtitlepenalty| tests whether there is
6462 % room for the title and the first couple of lines. |\poemtitlefont|
6463 % globally sets the fonts for all poem titles. You can put the
6464 % argument in an |\hbox{}| to make sure that the poem title is not
6465 % broken across two lines, and the |\label| records the page for the
6466 % contents and notes sections. |\afterpoemtitleskip| is the amount
6467 % of white space after a poem title. |\fulltitleholder| and
6468 % |\@compoundlabelscratch| record the title for concatenation later.
6469 % All of these commands can manage titles with control sequences in
6470 % them, such as for italics or international characters. In an
6471 % earlier version there were special commands for such titles, using
6472 % two arguments (one with the control sequence, one without it).
6473 % Those commands are no longer necessary, but have been retained for
6474 % backward compatibility with earlier versions.
6475 %
6476 % Second, the poem is entered in the external file for the table of
6477 % contents. |\contentsindentone| sets it in one level in the hierarchy
6478 % of indentations, and |\contentspoemtitlefont| is the type size used
6479 % for poems in the table of contents. The |\pageref{}| holds the page
6480 % number of the poem.
6481 %
6482 % Third, a new paragraph is opened in the textual notes for textual
6483 % collations. |\@poempagetotextnotes{}| sends the page number to the
6484 % textual notes. |\@poemtitletotextnotes{}| sends the title.
6485 % \begin{macrocode}
6486
6487 \newcommand{\m@kep@emlabel}{\ifsinglelinetitle%
6488 \addtocounter{poemnumber}{1}%
6489 \makepoemlabel{poem\thepoemnumber}%
6490 \else\iftitlefirstline%
6491 \addtocounter{poemnumber}{1}%
6492 \makepoemlabel{poem\thepoemnumber}%
6493 \else \relax
6494 \fi
6495 \fi
6496 }
6497
6498 \newcommand{\m@ken@teholder}[1]{%
6499 \ifsinglelinetitle
6500 \fulltitleholder={#1}%
6501 \global\edef\@compoundlabelscratch{poem\thepoemnumber}%
6502 \else\iftitlefirstline
6503 \fulltitleholder={#1}%
6504 \global\edef\@compoundlabelscratch{poem\thepoemnumber}%
6505 \else\iftitlemiddleline
6506 \titlesofar=\fulltitleholder
6507 \titleincrement={~#1}%
6508 \global\edef\titleconcat{\the\titlesofar \the\titleincrement}%
6509 \fulltitleholder=\expandafter{\titleconcat}%
6510 \global\edef\@compoundlabelscratch{poem\thepoemnumber}%
6511 \else
6512 \titlesofar=\fulltitleholder
6513 \titleincrement={~#1}%
6514 \global\edef\titleconcat{\the\titlesofar \the\titleincrement}%
6515 \fulltitleholder=\expandafter{\titleconcat}%
6516 \global\edef\@compoundlabelscratch{poem\thepoemnumber}%
6517 \fi
6518 \fi
6519 \fi
6520 }
6521 \newif\ifcentertitleson
6522 \newcommand{\centertitles}{\centertitlesontrue\centerepigraphsontrue}
6523 \makeatletter
6524 \newcommand{\set@p@emtitle}[6]{\iftitlesatleftversemargin%
6525 {\begin{pmclverse}\addtolength{\leftmargin}{-\leftmargini}{#2 #3 #4 #1 #5} \end{pmclverse}}%
6526 \else%
6527 \setlength{\titleentryoverrun}{#6}%
6528 {#2}%
6529 {#3 \begin{titleentryenvironment}%
6530 {{\ifnormaltitleindentation #4 #1%
6531 \else \ifcentertitleson \begin{center} #1 \end{center} \else #1\fi\fi}}%
6532 \end{titleentryenvironment}}%
6533 {#5}%
6534 \m@kep@emlabel
6535 \m@ken@teholder{#1}%
6536 \setlength{\titleentryoverrun}{\z@}\fi}
6537 %\newcommand{\set@p@emtitle}[6]{\setlength{\titleentryoverrun}{#6}%
6538 %{#2}%
6539 %{#3 \begin{titleentryenvironment}%
6540 %{\ifcentertitleson\begin{center}#1\end{center}\else #4 #1\fi}%
6541 %\end{titleentryenvironment}}%
6542 %{#5}%
6543 %\m@kep@emlabel
6544 %\m@ken@teholder{#1}%
6545 %\setlength{\titleentryoverrun}{\z@}}
6546 %
6547 %%% special version for subtitles
6548 \newcommand{\set@p@emsubtitle}[6]{\iftitlesatleftversemargin%
6549 {\begin{pmclverse}\addtolength{\leftmargin}{-\leftmargini}{#2 #3 #4 #1 #5} \end{pmclverse}}%
6550 \else%
6551 \setlength{\titleentryoverrun}{#6}%
6552 {#2}%
6553 {#3 \begin{titleentryenvironment}%
6554 {{\ifnormaltitleindentation #4 #1%
6555 \else \ifcentertitleson \begin{center} #1 \end{center} \else #1\fi\fi}}%
6556 \end{titleentryenvironment}}%
6557 {#5}%
6558 %\m@kep@emlabel
6559 %\m@ken@teholder{#1}%
6560 \setlength{\titleentryoverrun}{\z@}\fi}
6561 \newcommand{\setcontentsleaders}[1]{%
6562 \def\contentsleaders{#1\nobreak%
6563 }}
6564 \setcontentsleaders{~/~}
6565 \newcommand{\c@ntentsinfo}[4]{\ifpoemcontentson
6566 \immediate\write\poemcontents{\string\setlength\string\contentsentryoverrun\string{#4\string}}%
6567 \immediate\write\poemcontents{\string\begin\string{contentsentryenvironment\string}}%
6568 \literalcontents{#2{#3#1}}%
6569 \ifputpagenumberincontents
6570 \immediate\write\poemcontents{\string\contentsleaders}%
6571 \immediate\write\poemcontents{\string\pageref
6572 \string{poem\thepoemnumber\string}}%
6573 \else
6574 \literalcontents{\relax}%
6575 \fi
6576 \immediate\write\poemcontents{\string\end\string{contentsentryenvironment\string}}%
6577 \immediate\write\poemcontents{\string\par}%
6578 \immediate\write\poemcontents{\string\setlength\string\contentsentryoverrun
6579 \string{\string\contentsindentoneamount\string}}%
6580 \fi
6581 }
6582 \newif\ifputtitleinnotes
6583 \puttitleinnotestrue
6584 \newcommand{\t@xtnotesinfo}[1]{\iftextnoteson
6585 \iftextnotesatend
6586 \immediate\write\textnotes{\string\notespoemclubpenalty}%
6587 \ifputpagenumberinnotes
6588 \@poempagetotextnotes{poem\thepoemnumber}%
6589 \fi
6590 \ifputtitleinnotes
6591 \@poemtitletotextnotes{#1}%
6592 \fi
6593 % \else
6594 % \relax
6595 \fi\fi
6596 }
6597 \newlength{\lefttitlemargin}
6598 \newcommand{\leftaligntitlespace}{\hspace{\lefttitlemargin}}
6599 \newif\ifleftaligntitles % title flush with left margin of centered poem
6600 \leftaligntitlesfalse % default value
6601 \newcommand{\left@ligntitleblock}{\rightmargin \z@%%
6602 \setlength{\lefttitlemargin}{\linewidth}%
6603 \addtolength{\lefttitlemargin}{-\versewidth}%
6604 \addtolength{\lefttitlemargin}{-0.5\lefttitlemargin}
6605 }
6606 %
6607 \newcommand{\poemtitle}[1]{%
6608 \set@p@emtitle{#1}{\poemtitlepenalty}{\poemtitlefont}%
6609 {\poemtitleindent}{\nobreak\par\nobreak\afterpoemtitleskip\nobreak}{\z@}%
6610 \c@ntentsinfo{#1}{\contentspoemtitleindent}{\contentspoemtitlefont}%
6611 {\contentspoemtitleindentamount}%
6612 \t@xtnotesinfo{#1}%
6613 }
6614 \newcommand{\poemtitlenocontents}[1]{%
6615 \set@p@emtitle{#1}{\poemtitlepenalty}{\poemtitlefont}%
6616 {\poemtitleindent}{\nobreak\par\nobreak\afterpoemtitleskip\nobreak}{\z@}%
6617 \t@xtnotesinfo{#1}%
6618 }
6619 \newcommand{\poemtitlebaretitle}[1]{%
6620 \set@p@emsubtitle{#1}{\poemtitlepenalty}{\poemtitlefont}%
6621 {\poemtitleindent}{\nobreak\par\nobreak\afterpoemtitleskip\nobreak}{\z@}%
6622 }
6623 \newcommand{\poemtitleonlycontents}[1]{%
6624 \c@ntentsinfo{#1}{\contentspoemtitleindent}{\contentspoemtitlefont}%
6625 {\contentspoemtitleindentamount}%
6626 }
6627 \newcommand{\poemtitleonlynotes}[1]{%
6628 \m@kep@emlabel
6629 \m@ken@teholder{#1}%
6630 \t@xtnotesinfo{#1}%
6631 }
6632 \newcommand{\poemtitlenonotes}[1]{%
6633 \set@p@emtitle{#1}{\poemtitlepenalty}{\poemtitlefont}%
6634 {\poemtitleindent}{\nobreak\par\nobreak\afterpoemtitleskip\nobreak}{\z@}%
6635 \c@ntentsinfo{#1}{\contentspoemtitleindent}{\contentspoemtitlefont}%
6636 {\contentspoemtitleindentamount}%
6637 }
6638 % \end{macrocode}
6639 % \end{macro}
6640 % \begin{macro}{\poemtitleitalic} Poems with italic titles or other
6641 % formatting (such as |\hour{}|) take two arguments. The second
6642 % argument is discarded. This command is to maintain backward compatibility
6643 % with earlier versions.
6644 % \begin{macrocode}
6645 \newcommand{\poemtitleitalic}[2]{%
6646 \poemtitle{#1}}
6647 % \end{macrocode}
6648 % \end{macro}
6649 % For poem subtitles, see the entry on |\sequencesectionsubtitle{}|.
6650 %
6651 % \begin{macro}{\poemtitlefirstline}
6652 % \begin{macro}{\poemtitlemiddleline}
6653 % \begin{macro}{\poemtitlelastline}
6654 % Next, macros for setting multiline poem titles. Notice the special larger
6655 % penalty for page breaks in the middle of multiple line title.
6656 % \begin{macrocode}
6657 \newcommand{\firstlinesettings}{\singlelinetitlefalse
6658 \titlefirstlinetrue
6659 \putpagenumberincontentsfalse
6660 \putpagenumberinnotestrue}
6661
6662 \newcommand{\middlelinesettings}{\singlelinetitlefalse
6663 \titlemiddlelinetrue
6664 \putpagenumberincontentsfalse
6665 \putpagenumberinnotesfalse}
6666
6667 \newcommand{\lastlinesettings}{\singlelinetitlefalse
6668 \titlelastlinetrue
6669 \putpagenumberincontentstrue
6670 \putpagenumberinnotesfalse}
6671
6672 \newcommand{\restoresinglelinesettings}{\putpagenumberinnotestrue
6673 \putpagenumberincontentstrue
6674 \titlefirstlinefalse
6675 \titlemiddlelinefalse
6676 \titlelastlinefalse
6677 \singlelinetitletrue}
6678
6679
6680 \newcommand{\poemtitlefirstline}[1]{
6681 \firstlinesettings
6682 \set@p@emtitle{#1}{\multilinetitlepenalty}{\poemtitlefont}%
6683 {\poemtitleindent}{\nobreak\par\nobreak}{\z@}%
6684 \c@ntentsinfo{#1}{\contentspoemtitleindent}{\contentspoemtitlefont}%
6685 {\contentspoemtitleindentamount}%
6686 \t@xtnotesinfo{#1}%
6687 \restoresinglelinesettings
6688 }
6689 % \end{macrocode}
6690
6691 % Notice the use of token registers and |\edef| here to concatenate the first and second
6692 % lines.
6693 % \begin{macrocode}
6694 \newcommand{\poemtitlemiddleline}[1]{%
6695 \middlelinesettings
6696 \set@p@emtitle{#1}{\par\nobreak}{\poemtitlefont}%
6697 {\poemtitlesecondlineindent}{\nobreak\par\nobreak}{\z@}%
6698 \c@ntentsinfo{#1}{\contentspoemtitlesecondlineindent}{\contentspoemtitlefont}%
6699 {\contentspoemtitlesecondlineindentamount}%
6700 \t@xtnotesinfo{#1}%
6701 \restoresinglelinesettings
6702 }
6703 \newcommand{\poemtitlelastline}[1]{%
6704 \lastlinesettings
6705 \set@p@emtitle{#1}{\par\nobreak}{\poemtitlefont}%
6706 {\poemtitlesecondlineindent}{\nobreak\par\afterpoemtitleskip\nobreak}{\z@}%
6707 \c@ntentsinfo{#1}{\contentspoemtitlesecondlineindent}{\contentspoemtitlefont}%
6708 {\contentspoemtitlesecondlineindentamount}%
6709 \t@xtnotesinfo{#1}%
6710 \restoresinglelinesettings
6711 }
6712 % \end{macrocode}
6713 % \end{macro}
6714 % \end{macro}
6715 % \end{macro}
6716 % Titles for sections of poems, and multi-line titles of sections
6717 % of poems
6718 % \begin{macro}{\poemsectiontitle}
6719 % \begin{macro}{\poemsectiontitlefirstline}
6720 % \begin{macro}{\poemsectiontitlemiddleline}
6721 % \begin{macro}{\poemsectiontitlelastline}
6722 % \begin{macrocode}
6723 \newcommand{\poemsectiontitle}[1]{%
6724 \set@p@emtitle{#1}{\poemtitlepenalty}{\subsectiontitlefont}%
6725 {\poemsectiontitleindent}{\nobreak\par\nobreak\afterpoemtitleskip\nobreak}%
6726 {\titleindentamount}%
6727 \c@ntentsinfo{#1}{\contentspoemsectiontitleindent}{\contentspoemtitlefont}%
6728 {\contentspoemsectiontitleindentamount}%
6729 \t@xtnotesinfo{#1}%
6730 }
6731 \newcommand{\poemsectiontitlefirstline}[1]{%
6732 \firstlinesettings
6733 \set@p@emtitle{#1}{\multilinetitlepenalty}{\subsectiontitlefont}%
6734 {\poemsectiontitleindent}{\nobreak\par\nobreak}{\poemsectiontitleindentamount}%
6735 \c@ntentsinfo{#1}{\contentspoemsectiontitleindent}{\contentspoemtitlefont}%
6736 {\contentspoemsectiontitleindentamount}%
6737 \t@xtnotesinfo{#1}%
6738 \restoresinglelinesettings
6739 }
6740 \newcommand{\poemsectiontitlemiddleline}[1]{%
6741 \middlelinesettings
6742 \set@p@emtitle{#1}{\relax}{\subsectiontitlefont}%
6743 {\poemsectiontitlesecondlineindent}{\nobreak\par\nobreak}{\poemsectiontitlesecondlineindentamount}%
6744 \c@ntentsinfo{#1}{\contentspoemsectiontitlesecondlineindent}{\contentspoemtitlefont}%
6745 {\contentspoemsectiontitlesecondlineindentamount}%
6746 \t@xtnotesinfo{#1}%
6747 \restoresinglelinesettings
6748 }
6749 \newcommand{\poemsectiontitlelastline}[1]{%
6750 \lastlinesettings
6751 \set@p@emtitle{#1}{\par\nobreak}{\subsectiontitlefont}%
6752 {\poemsectiontitlesecondlineindent}{\nobreak\par\afterpoemtitleskip\nobreak}%
6753 {\poemsectiontitlesecondlineindentamount}%
6754 \c@ntentsinfo{#1}{\contentspoemsectiontitlesecondlineindent}{\contentspoemtitlefont}%
6755 {\contentspoemsectiontitlesecondlineindentamount}%
6756 \t@xtnotesinfo{#1}%
6757 \restoresinglelinesettings
6758 }
6759 % \end{macrocode}
6760 % \end{macro}
6761 % \end{macro}
6762 % \end{macro}
6763 % \end{macro}
6764 % \begin{macro}{\poemsectiontitlenocontents}
6765 % \begin{macro}{\poemsectionbaretitle}
6766 % \begin{macro}{\poemsubsectiontitle}
6767 % \begin{macro}{\poemtitlenotitle}
6768 % \begin{macro}{\poemtitlenotitleitalic}
6769 % \begin{macrocode}
6770 \newcommand{\poemsectiontitlenocontents}[1]{%
6771 \sequencesubsectiontitlenocontents{#1}}%
6772 \newcommand{\poemfirstsectiontitle}[1]{%
6773 \set@p@emtitle{#1}{\par\nobreak}{\subsectiontitlefont}%
6774 {\poemsectiontitleindent}{\nobreak\par\nobreak\afterpoemtitleskip\nobreak}%
6775 {\poemsectiontitleindentamount}%
6776 \c@ntentsinfo{#1}{\contentspoemsectiontitleindent}{\contentspoemtitlefont}%
6777 {\contentspoemsectiontitleindentamount}%
6778 \t@xtnotesinfo{#1}%
6779 }
6780 \newcommand{\poemfirstsectiontitlebaretitle}[1]{%
6781 \set@p@emtitle{#1}{\par\nobreak}{\subsectiontitlefont}%
6782 {\poemsectiontitleindent}{\nobreak\par\nobreak\afterpoemtitleskip\nobreak}%
6783 {\poemsectiontitleindentamount}}
6784 \newcommand{\poemsectiontitlebaretitle}[1]{%
6785 \set@p@emtitle{#1}{\poemtitlepenalty}{\subsectiontitlefont}%
6786 {\titleindent}{\nobreak\par\nobreak\afterpoemtitleskip\nobreak}%
6787 {\titleindentamount}%
6788 }
6789 \newcommand{\poemsubsectiontitle}[1]{%
6790 \set@p@emtitle{#1}{\poemtitlepenalty}{\subsectiontitlefont}%
6791 {\poemsubsectiontitleindent}{\nobreak\par\nobreak\afterpoemtitleskip\nobreak}%
6792 {\poemsubsectiontitleindentamount}%
6793 \c@ntentsinfo{#1}{\contentspoemsubsectiontitleindent}{\contentspoemtitlefont}%
6794 {\contentspoemsubsectiontitleindentamount}%
6795 \t@xtnotesinfo{#1}%
6796 }
6797 \newcommand{\poemtitlenotitle}[1]{%
6798 \m@kep@emlabel
6799 \m@ken@teholder{#1}%
6800 \c@ntentsinfo{#1}{\contentspoemtitleindent}{\contentspoemtitlefont}%
6801 {\contentsindenttwoamount}%
6802 \t@xtnotesinfo{#1}%
6803 }
6804 \newcommand{\poemtitlenotitleitalic}[2]{%
6805 \poemtitlenotitle{1}}
6806 % \end{macrocode}
6807 % \end{macro}
6808 % \end{macro}
6809 % \end{macro}
6810 % \end{macro}
6811 % \end{macro}
6812 %
6813 % \subsubsection{Poetic Sequences: Setting the Main Title}
6814 % \begin{macro}{\sequencetitle}
6815 % Variants here for multiple line titles and titles with font
6816 % commands. Also some all-purpose kludges to work around other problems.
6817 % \begin{macrocode}
6818 \newcommand{\sequencetitle}[1]{
6819 \set@p@emtitle{#1}{\sequencetitlepenalty}{\sequencetitlefont}
6820 {\sequencetitleindent}{\nobreak\par\nobreak\aftersequencetitleskip\nobreak}{\z@}
6821 \putpagenumberincontentsfalse
6822 \c@ntentsinfo{#1}{\contentssequencetitleindent}{\contentssequencetitlefont}
6823 {\contentssequencetitleindentamount}
6824 \putpagenumberincontentstrue
6825 \t@xtnotesinfo{#1}
6826 }
6827 % \end{macrocode}
6828 % \end{macro}
6829
6830 % \begin{macro}{\sequencetitlefirstline}
6831 % \begin{macro}{\sequencetitlemiddleline}
6832 % \begin{macro}{\sequencetitlelastline}
6833 % To set the title of a poetic sequence if it requires several lines
6834 % to do so.
6835 % \begin{macrocode}
6836 \newcommand{\sequencetitlefirstline}[1]{
6837 \firstlinesettings
6838 \set@p@emtitle{#1}{\multilinesequencepenalty}{\sequencetitlefont}
6839 {\sequencetitleindent}{\nobreak\par\nobreak}{\z@}
6840 \c@ntentsinfo{#1}{\contentssequencetitleindent}{\contentssequencetitlefont}
6841 {\contentssequencetitleindentamount}
6842 \t@xtnotesinfo{#1}
6843 \restoresinglelinesettings
6844 }
6845 \newcommand{\sequencetitlemiddleline}[1]{
6846 \middlelinesettings
6847 \set@p@emtitle{#1}{\par\nobreak}{\sequencetitlefont}
6848 {\sequencetitleindent}{\nobreak\par\nobreak}{\z@}
6849 \c@ntentsinfo{#1}{\contentssequencetitlesecondlineindent}{\contentssequencetitlefont}
6850 {\contentssequencetitlesecondlineindentamount}
6851 \t@xtnotesinfo{#1}
6852 \restoresinglelinesettings
6853 }
6854 \newcommand{\sequencetitlelastline}[1]{
6855 \lastlinesettings
6856 \set@p@emtitle{#1}{\par\nobreak}{\sequencetitlefont}
6857 {\sequencetitleindent}{\nobreak\par\aftersequencetitleskip\nobreak}{\z@}
6858 \c@ntentsinfo{#1}{\contentssequencetitlesecondlineindent}{\contentssequencetitlefont}
6859 {\contentssequencetitlesecondlineindent}
6860 \t@xtnotesinfo{#1}
6861 \restoresinglelinesettings
6862 }
6863 \newcommand{\sequencesubtitle}[1]{
6864 \set@p@emsubtitle{#1}{\par\nobreak}{\sequencetitlefont}
6865 {\sequencesubtitleindent}{\nobreak\par\aftersequencetitleskip\nobreak}{\z@}
6866 \c@ntentsinfo{#1}{\contentssequencesubtitleindent}{\contentssequencetitlefont}
6867 {\contentssequencesubtitleindentamount}
6868 %\t@xtnotesinfo{#1}
6869 }
6870 \newcommand{\sequencesubtitlefirstline}[1]{\firstlinesettings
6871 \set@p@emsubtitle{#1}{\par\nobreak}{\sequencetitlefont}
6872 {\sequencesubtitleindent}{\nobreak\par\aftersequencetitleskip\nobreak}{\z@}
6873 \c@ntentsinfo{#1}{\contentsindenttwo}{\contentssequencetitlefont}
6874 {\contentsindentthreeamount}
6875 %\t@xtnotesinfo{#1}
6876 \restoresinglelinesettings
6877 }
6878 \newcommand{\sequencesubtitlemiddleline}[1]{\middlelinesettings
6879 \set@p@emsubtitle{#1}{\par\nobreak}{\sequencetitlefont}
6880 {\sequencesubtitlesecondlineindent}{\nobreak\par\aftersequencetitleskip\nobreak}{\z@}
6881 \c@ntentsinfo{#1}{\contentssequencesubtitlesecondlineindent}{\contentssequencetitlefont}
6882 {\contentssequencesubtitlesecondlineindentamount}
6883 %\t@xtnotesinfo{#1}
6884 \restoresinglelinesettings
6885 }
6886 \newcommand{\sequencesubtitlelastline}[1]{\lastlinesettings
6887 \set@p@emsubtitle{#1}{\par\nobreak}{\sequencetitlefont}
6888 {\sequencesubtitlesecondlineindent}{\nobreak\par\aftersequencetitleskip\nobreak}{\z@}
6889 \c@ntentsinfo{#1}{\contentssequencesubtitlesecondlineindent}{\contentssequencetitlefont}
6890 {\contentssequencesubtitlesecondlineindentamount}
6891 %\t@xtnotesinfo{#1}
6892 \restoresinglelinesettings
6893 }
6894 % \end{macrocode}
6895 % \end{macro}
6896 % \end{macro}
6897 % \end{macro}
6898 % \subsubsection{Sections of poetic sequences}
6899 % \begin{macro}{\sequencesectiontitle}
6900 % First, the easy case: a simple section of a poetic sequence.
6901 % \begin{macrocode}
6902 \newcommand{\sequencesectiontitle}[1]{
6903 \set@p@emtitle{#1}{\poemtitlepenalty}{\poemtitlefont}
6904 {\sequencesectiontitleindent}{\nobreak\par\nobreak\afterpoemtitleskip\nobreak}
6905 {\sequencesectiontitleindentamount}
6906 \c@ntentsinfo{#1}{\contentssequencesectiontitleindent}{\contentspoemtitlefont}
6907 {\contentssequencesectiontitleindentamount}
6908 \t@xtnotesinfo{#1}
6909 }
6910 % \end{macrocode}
6911 % \end{macro}
6912
6913 % \begin{macro}{\sequencefirstsectiontitle}
6914 % The first poem in a sequence is a special case.
6915 % \begin{macrocode}
6916 \newcommand{\sequencefirstsectiontitle}[1]{
6917 \set@p@emtitle{#1}{\par\nobreak\afterpoemtitleskip}{\poemtitlefont}
6918 {\sequencesectiontitleindent}{\nobreak\par\nobreak\afterpoemtitleskip\nobreak}
6919 {\sequencesectiontitleindentamount}
6920 \c@ntentsinfo{#1}{\contentssequencesectiontitleindent}{\contentspoemtitlefont}
6921 {\contentssequencesectiontitleindentamount}
6922 \t@xtnotesinfo{#1}
6923 }
6924 % \end{macrocode}
6925 % \end{macro}
6926 % \begin{macro}{\sequencesectiontitlenonotes}
6927 % If you don't have any notes on a sequence section, it seems a shame
6928 % to open an entry in the textual notes for that section:
6929 % \begin{macrocode}
6930 \newcommand{\sequencetitlenonotes}[1]{
6931 \set@p@emtitle{#1}{\par\nobreak}{\sequencetitlefont}
6932 {\sequencetitleindent}{\nobreak\par\aftersequencetitleskip\nobreak}{\sequencetitleindentamount}
6933 \c@ntentsinfo{#1}{\contentssequencetitleindent}{\contentssequencetitlefont}
6934 {\contentssequencetitleindentamount}
6935 %\t@xtnotesinfo{#1}
6936 }
6937 \newcommand{\sequencesectiontitlenonotes}[1]{
6938 \set@p@emtitle{#1}{\poemtitlepenalty}{\poemtitlefont}
6939 {\sequencesectiontitleindent}{\nobreak\par\nobreak\afterpoemtitleskip\nobreak}
6940 {\sequencesectiontitleindentamount}
6941 \c@ntentsinfo{#1}{\contentssequencesectiontitleindent}{\contentspoemtitlefont}
6942 {\contentssequencesectiontitleindentamount}
6943 %\t@xtnotesinfo{#1}
6944 }
6945 % \end{macrocode}
6946 % \end{macro}
6947 % For multiple line titles of sequence sections
6948 % \begin{macrocode}
6949 \newcommand{\sequencesectiontitlefirstline}[1]{
6950 \firstlinesettings
6951 \set@p@emtitle{#1}{\multilinetitlepenalty}{\poemtitlefont}
6952 {\sequencesectiontitleindent}{\nobreak\par\nobreak}{\sequencesectiontitleindentamount}
6953 \c@ntentsinfo{#1}{\contentssequencesectiontitleindent}{\contentspoemtitlefont}
6954 {\contentssequencesectiontitleindentamount}
6955 \t@xtnotesinfo{#1}
6956 \restoresinglelinesettings
6957 }
6958 \newcommand{\sequencesectiontitlemiddleline}[1]{
6959 \middlelinesettings
6960 \set@p@emtitle{#1}{\par\nobreak}{\poemtitlefont}
6961 {\sequencesectiontitleindent}{\nobreak\par\nobreak}{\sequencesectiontitleindentamount}
6962 \c@ntentsinfo{#1}{\contentssequencesectiontitlesecondlineindent}{\contentspoemtitlefont}
6963 {\contentssequencesectiontitlesecondlineindentamount}
6964 \t@xtnotesinfo{#1}
6965 \restoresinglelinesettings
6966 }
6967 \newcommand{\sequencesectiontitlelastline}[1]{
6968 \lastlinesettings
6969 \set@p@emtitle{#1}{\par\nobreak}{\poemtitlefont}
6970 {\sequencesectiontitleindent}{\nobreak\par\afterpoemtitleskip\nobreak}{\sequencesectiontitleindentamount}
6971 \c@ntentsinfo{#1}{\contentssequencesectiontitlesecondlineindent}{\contentspoemtitlefont}
6972 {\contentssequencesectiontitlesecondlineindentamount}
6973 \t@xtnotesinfo{#1}
6974 \restoresinglelinesettings
6975 }
6976 % \end{macrocode}
6977 % The following macros are
6978 % to kludge around situations where the section title is just a number. This
6979 % macro has two arguments. Originally, the first was the title of the section.
6980 % The second is the title of the sequence as a whole. I've retained
6981 % the second argument for backward compatibility with earlier versions, but
6982 % you can set it to anything, since it's discarded now.
6983 % \begin{macrocode}
6984 \newcommand{\sequencefirstsectiontitlenocontents}[2]{
6985 \set@p@emtitle{#1}{\par\nobreak\afterpoemtitleskip}{\poemtitlefont}
6986 {\sequencesectiontitleindent}{\nobreak\par\nobreak\afterpoemtitleskip\nobreak}
6987 {\sequencesectiontitleindentamount}
6988 %\c@ntentsinfo{#1}{\contentsindenttwo}{\contentspoemtitlefont}
6989 \t@xtnotesinfo{#1}
6990 }
6991 \newcommand{\sequencesectiontitlenocontents}[2]{
6992 \set@p@emtitle{#1}{\poemtitlepenalty}{\poemtitlefont}
6993 {\sequencesectiontitleindent}{\nobreak\par\nobreak\afterpoemtitleskip\nobreak}
6994 {\sequencesectiontitleindentamount}
6995 %\c@ntentsinfo{#1}{\contentsindenttwo}{\contentspoemtitlefont}
6996 \t@xtnotesinfo{#1}
6997 }
6998 % \end{macrocode}
6999 % If the first section of a sequence is a multiple line title, the
7000 % following macros can handle the special problems that situation poses.
7001 % \begin{macrocode}
7002 \newcommand{\sequencefirstsectiontitlefirstline}[1]{
7003 \firstlinesettings
7004 \set@p@emtitle{#1}{\par\nobreak\afterpoemtitleskip}{\poemtitlefont}
7005 {\sequencesectiontitleindent}{\nobreak\par\nobreak\afterpoemtitleskip\nobreak}
7006 {\sequencesectiontitleindentamount}
7007 \c@ntentsinfo{#1}{\contentssequencesectiontitleindent}{\contentspoemtitlefont}
7008 {\contentssequencesectiontitleindentamount}
7009 \t@xtnotesinfo{#1}
7010 \restoresinglelinesettings
7011 }
7012 \newcommand{\sequencefirstsectiontitlemiddleline}[1]{
7013 \sequencesectiontitlemiddleline{#1}}
7014
7015 \newcommand{\sequencefirstsectiontitlelastline}[1]
7016 {\sequencesectiontitlelastline{#1}}
7017
7018 \newcommand{\sequencefirstsectiontitlenonotes}[1]{
7019 \set@p@emtitle{#1}{\par\nobreak\afterpoemtitleskip}{\poemtitlefont}
7020 {\sequencesectiontitleindent}{\nobreak\par\nobreak\afterpoemtitleskip\nobreak}
7021 {\sequencesectiontitleindentamount}
7022 \c@ntentsinfo{#1}{\contentssequencesectiontitleindent}{\contentspoemtitlefont}
7023 {\contentssequencesectiontitleindentamount}
7024 %\t@xtnotesinfo{#1}
7025 }
7026 % \end{macrocode}
7027
7028 % \begin{macro}{\sequencesectionsubtitle}
7029 % \begin{macro}{\poemsubtitle}
7030 % \begin{macrocode}
7031 % \newcommand{\sequencesectionsubtitle}[1]{{\subsectiontitlefont \hbox{\titleindent #1}}
7032 % \nobreak\par\nobreak\afterpoemtitleskip\nobreak
7033 % }
7034 \newcommand{\sequencesectionsubtitle}[1]{\set@p@emsubtitle{#1}{\par\nobreak\afterpoemtitleskip}
7035 {\subsectiontitlefont}{\sequencesectionsubtitleindent}{\nobreak\par\nobreak\afterpoemtitleskip\nobreak}{\sequencesectionsubtitleindentamount}
7036 }
7037 \newcommand{\sequencesectionsubtitlefirstline}[1]{\firstlinesettings
7038 \set@p@emsubtitle{#1}{\par\nobreak\afterpoemtitleskip}
7039 {\subsectiontitlefont}{\sequencesectionsubtitleindent}{\nobreak\par\nobreak\afterpoemtitleskip\nobreak}{\sequencesectionsubtitleindentamount}
7040 \restoresinglelinesettings
7041 }
7042 \newcommand{\sequencesectionsubtitlemiddleline}[1]{\middlelinesettings
7043 \set@p@emsubtitle{#1}{\par\nobreak\afterpoemtitleskip}
7044 {\subsectiontitlefont}{\sequencesectionsubtitleindent}{\nobreak\par\nobreak\afterpoemtitleskip\nobreak}{\sequencesectionsubtitleindentamount}
7045 \restoresinglelinesettings
7046 }
7047 \newcommand{\sequencesectionsubtitlelastline}[1]{\lastlinesettings
7048 \set@p@emsubtitle{#1}{\par\nobreak\afterpoemtitleskip}
7049 {\subsectiontitlefont}{\sequencesectionsubtitleindent}{\nobreak\par\nobreak\afterpoemtitleskip\nobreak}{\sequencesectionsubtitleindentamount}
7050 \restoresinglelinesettings
7051 }
7052 \newcommand{\poemsubtitle}[1]{\set@p@emsubtitle{#1}{\par\nobreak\afterpoemtitleskip}
7053 {\subsectiontitlefont}{\poemsubtitleindent}{\nobreak\par\nobreak\afterpoemtitleskip\nobreak}{\titleindentamount}
7054 }
7055 % \end{macrocode}
7056 % \end{macro}
7057 % \end{macro}
7058 % Another (former) kludge for special situations:
7059 % \begin{macrocode}
7060 \newcommand{\sequencesectiontitleitalicnonotes}[2]
7061 {\sequencesectiontitlenonotes{#1}
7062 }
7063 % \end{macrocode}
7064 % Italic titles used to require two arguments. These commands
7065 % are retained only for backward compatibility.
7066 %
7067 % \begin{macro}{\sequencesectiontitleitalic}
7068 % \begin{macrocode}
7069 \newcommand{\sequencesectiontitleitalic}[2]{
7070 \sequencesectiontitle{#1}}
7071 \newcommand{\sequencesectiontitlefirstlineitalic}[2]
7072 {\sequencesectiontitlefirstline{#1}}
7073 \newcommand{\sequencesectiontitlebaretitle}[1]{
7074 \set@p@emtitle{#1}{\poemtitlepenalty}{\poemtitlefont}
7075 {\titleindent}{\nobreak\par\nobreak\afterpoemtitleskip\nobreak}{\titleindentamount}
7076 }
7077 % \end{macrocode}
7078 % \end{macro}
7079
7080
7081
7082 % \subsubsection{Subsections of sequences}
7083 % \begin{macro}{\sequencesubsectiontitle}
7084
7085 % Continuing several levels down: macros for setting subsections and
7086 % subsubsections of sequences.
7087 % \begin{macrocode}
7088 \newcommand{\sequencesubsectiontitle}[1]{
7089 \set@p@emtitle{#1}{\poemtitlepenalty}{\subsectiontitlefont}
7090 {\sequencesubsectiontitleindent}{\nobreak\par\nobreak\afterpoemtitleskip\nobreak}
7091 {\sequencesubsectiontitleindentamount}
7092 \c@ntentsinfo{#1}{\contentssequencesubsectiontitleindent}{\contentspoemtitlefont}
7093 {\contentssequencesubsectiontitleindentamount}
7094 \t@xtnotesinfo{#1}
7095 }
7096 \newcommand{\sequencesubsectiontitlenocontents}[1]{
7097 \set@p@emtitle{#1}{\poemtitlepenalty}{\subsectiontitlefont}
7098 {\sequencesubsectiontitleindent}{\nobreak\par\nobreak\afterpoemtitleskip\nobreak}
7099 {\sequencesubsectiontitleindentamount}
7100 %\c@ntentsinfo{#1}{\contentsindentthree}{\contentspoemtitlefont}{\contentsindentfouramount}
7101 \t@xtnotesinfo{#1}
7102 }
7103 \newcommand{\sequencefirstsubsectiontitle}[1]
7104 {\set@p@emtitle{#1}{\par\nobreak}{\subsectiontitlefont}
7105 {\sequencesubsectiontitleindent}{\nobreak\par\nobreak\afterpoemtitleskip\nobreak}
7106 {\sequencesubsectiontitleindentamount}
7107 \c@ntentsinfo{#1}{\contentssequencesubsectiontitleindent}{\contentspoemtitlefont}
7108 {\contentssequencesubsectiontitleindentamount}
7109 \t@xtnotesinfo{#1}
7110 }
7111 \newcommand{\sequencefirstsubsectiontitlenocontents}[1]
7112 {\set@p@emtitle{#1}{\par\nobreak}{\subsectiontitlefont}
7113 {\sequencesubsectiontitleindent}{\nobreak\par\nobreak\afterpoemtitleskip\nobreak}
7114 {\sequencesubsectiontitleindentamount}
7115 %\c@ntentsinfo{#1}{\contentsindentthree}{\contentspoemtitlefont}
7116 %{\contentsindentfouramount}
7117 \t@xtnotesinfo{#1}
7118 }
7119 \newcommand{\sequencesubsectiontitlefirstline}[1]{
7120 \firstlinesettings
7121 \set@p@emtitle{#1}{\multilinetitlepenalty}{\subsectiontitlefont}
7122 {\sequencesubsectiontitleindent}{\nobreak\par\nobreak}{\sequencesubsectiontitleindentamount}
7123 \c@ntentsinfo{#1}{\contentssequencesubsectiontitleindent}{\contentspoemtitlefont}
7124 {\contentssequencesubsectiontitleindentamount}
7125 \t@xtnotesinfo{#1}
7126 \restoresinglelinesettings
7127 }
7128 \newcommand{\sequencesubsectiontitlemiddleline}[1]{
7129 \middlelinesettings
7130 \set@p@emtitle{#1}{\nobreak}{\subsectiontitlefont}
7131 {\sequencesubsectiontitlesecondlineindent}{\nobreak\par\nobreak}{\sequencesubsectiontitlesecondlineindentamount}
7132 \c@ntentsinfo{#1}{\contentssequencesubsectiontitlesecondlineindent}{\contentspoemtitlefont}
7133 {\contentssequencesubsectiontitlesecondlineindentamount}
7134 \t@xtnotesinfo{#1}
7135 \restoresinglelinesettings
7136 }
7137 \newcommand{\sequencesubsectiontitlelastline}[1]{
7138 \lastlinesettings
7139 \set@p@emtitle{#1}{\nobreak}{\subsectiontitlefont}
7140 {\sequencesubsectiontitleindent}{\nobreak\par\afterpoemtitleskip\nobreak}
7141 {\sequencesubsectiontitleindentamount}
7142 \c@ntentsinfo{#1}{\contentssequencesubsectiontitlesecondlineindent}{\contentspoemtitlefont}
7143 {\contentssequencesubsectiontitlesecondlineindentamount}
7144 \t@xtnotesinfo{#1}
7145 \restoresinglelinesettings
7146 }
7147 \newcommand{\sequencesubsubsectiontitle}[1]{
7148 \set@p@emtitle{#1}{\poemtitlepenalty}{\subsectiontitlefont}
7149 {\sequencesubsubsectiontitleindent}
7150 {\nobreak\par\nobreak\afterpoemtitleskip\nobreak}
7151 {\sequencesubsubsectiontitleindentamount}
7152 %\c@ntentsinfo{#1}{\contentssequencesubsubsectiontitleindent}{\contentspoemtitlefont}
7153 %{\contentssequencesubsectiontitleindentmount} % 313
7154 \t@xtnotesinfo{#1}
7155 }
7156 \newcommand{\sequencesubsubsectiontitlenocontents}[1]{
7157 \set@p@emtitle{#1}{\poemtitlepenalty}{\subsectiontitlefont}
7158 {\sequencesubsubsectiontitleindent}{\nobreak\par\nobreak\afterpoemtitleskip\nobreak}
7159 {\sequencesubsubsectiontitleindentamount}
7160 %\c@ntentsinfo{#1}{\contentsindentfour}{\contentspoemtitlefont}
7161 %{\contentsindentfiveamount}
7162 \t@xtnotesinfo{#1}
7163 }
7164 \newcommand{\sequencefirstsubsubsectiontitlenocontents}[1]{
7165 \set@p@emtitle{#1}{\nobreak\par\nobreak}{\subsectiontitlefont}
7166 {\sequencesubsubsectiontitleindent}{\nobreak\par\nobreak\afterpoemtitleskip\nobreak}
7167 {\sequencesubsubsectiontitleindentamount}
7168 %\c@ntentsinfo{#1}{\contentsindentfour}{\contentspoemtitlefont}{\contentsindentfiveamount}
7169 \t@xtnotesinfo{#1}
7170 }
7171
7172
7173 \newcommand{\sequencefirstsubsectiontitlefirstline}[1]{
7174 \firstlinesettings
7175 \set@p@emtitle{#1}{\par\nobreak}{\subsectiontitlefont}
7176 {\sequencesubsectiontitleindent}{\nobreak\par\nobreak}{\sequencesubsectiontitleindentamount}
7177 \c@ntentsinfo{#1}{\contentssequencesubsectiontitleindent}{\contentspoemtitlefont}
7178 {\contentssequencesubsectiontitleindent}
7179 \t@xtnotesinfo{#1}
7180 \restoresinglelinesettings
7181 }
7182 \newcommand{\sequencefirstsubsectiontitlemiddleline}[1]{
7183 \sequencesubsectiontitlemiddleline{#1}}
7184 \newcommand{\sequencefirstsubsectiontitlelastline}[1]{
7185 \sequencesubsectiontitlelastline{#1}}
7186 % \end{macrocode}
7187 % \end{macro}
7188
7189 % Interjections in sequences, as in Robert Penn Warren's \emph{Or Else}.
7190 % \begin{macrocode}
7191 \newcommand{\interjectiontitlefirstline}[1]{
7192 \sequencefirstsubsectiontitlefirstline{#1}}
7193 \newcommand{\interjectiontitlelastline}[1]{
7194 \sequencefirstsubsectiontitlelastline{#1}
7195 }
7196 \newcommand{\interjectiontitlemiddleline}[1]{
7197 \sequencefirstsubsectionmiddleline{#1}
7198 }
7199 % \subsubsection{Titles and Notes with marginal marks}
7200 % \end{macrocode}
7201 % \begin{macro}{\setmargpoemtitle}
7202 % Titles with a marginal reference to the notes giving the page in
7203 % the notes where a comment on the poem appears, as in Altenberg's
7204 % Heredia edition.\label{JHpoemtitle} |\setmargpoemtitle| takes as
7205 % its second argument anything you want to add to the line while the
7206 % title is being processed. |\JHpoemtitle| is just
7207 % |\setmargpoemtitle| with the second argument passed to |\JHlabel|,
7208 % which actually makes the marginal mark.
7209 % \begin{macrocode}
7210 \newlength{\JHtextwidth}
7211 \setlength{\JHtextwidth}{\textwidth}
7212 \newlength{\JHmarginparsep}
7213 \setlength{\JHmarginparsep}{0pt}
7214 \newlength{\JHmarginparvshift}
7215 \setlength{\JHmarginparvshift}{0pt}
7216 \newlength{\JHmarginparwidth}
7217 \setlength{\JHmarginparwidth}{\marginparwidth}
7218 \newlength{\JHmarginparsepmin}
7219 \setlength{\JHmarginparsepmin}{\marginparsepmin}
7220 \newlength{\JHtitlemarginparsep}%
7221 \setlength{\JHtitlemarginparsep}{\JHmarginparsep}%
7222 \newif{\ifJHmarkstoleft}
7223 \JHmarkstolefttrue
7224 \newif{\ifJHmarkstoright}
7225 \JHmarkstorightfalse
7226 \newif{\ifJHmarkstoouter}
7227 \JHmarkstoouterfalse
7228 \newif{\ifJHmarkstogutter}
7229 \JHmarkstogutterfalse
7230 \newif{\ifJHmarginparswitch}
7231 \JHmarginparswitchfalse
7232 \newif{\ifJHreversemarginpar}
7233 \JHreversemarginparfalse
7234 \newcommand{\JHmarksleft}{%
7235 \JHmarkstolefttrue%
7236 \JHmarkstorightfalse%
7237 \JHmarkstoouterfalse%
7238 \JHmarkstogutterfalse%
7239 \JHmarginparswitchfalse%
7240 \JHreversemarginparfalse%
7241 \reversemarginpar
7242 }
7243 \newcommand{\JHmarksright}{%
7244 \JHmarkstoleftfalse%
7245 \JHmarkstorighttrue%
7246 \JHmarkstoouterfalse%
7247 \JHmarkstogutterfalse%
7248 \JHmarginparswitchfalse%
7249 \JHreversemarginparfalse%
7250 \normalmarginpar
7251 }
7252 % JHmarksright is the default
7253 \JHmarksright
7254 \newcommand{\JHmarksouter}{%
7255 \JHmarkstoleftfalse%
7256 \JHmarkstorightfalse%
7257 \JHmarkstooutertrue%
7258 \JHmarkstogutterfalse%
7259 \JHmarginparswitchtrue%
7260 \JHreversemarginparfalse%
7261 \@mparswitchtrue
7262 }
7263 \newcommand{\JHmarksgutter}{%
7264 \JHmarkstoleftfalse%
7265 \JHmarkstorightfalse%
7266 \JHmarkstoouterfalse%
7267 \JHmarkstoguttertrue%
7268 \JHmarginparswitchtrue%
7269 \JHreversemarginpartrue%
7270 \@mparswitchtrue
7271 \reversemarginpar
7272 }
7273 % jhrightmarginpar command for notes % right side
7274 \newcommand{\JHrightmarginpar}[1]{%
7275 \pmclbsphack\strut\vadjust{%
7276 \rlap{\kern-\parindent%
7277 \kern\JHtextwidth\kern\JHmarginparsep% at right
7278 \setbox0=\vtop to 0pt{% added
7279 \begin{minipage}[t]{\JHmarginparwidth}% added
7280 #1%
7281 \end{minipage}%
7282 \vss}%
7283 \vtop to 0pt{\kern\JHmarginparvshift% default should be 0pt
7284 \kern-\dp\strutbox \kern-\ht0 \box0 \vss}}}\pmclesphack}%
7285 % jhleftmarginpar command for notes % left side
7286 \newcommand{\JHleftmarginpar}[1]{%
7287 \pmclbsphack\strut\vadjust{% changed
7288 \rlap{\kern-\parindent%
7289 \kern -\JHmarginparsep \kern -\JHmarginparwidth% at left
7290 \setbox0=\vtop to 0pt{
7291 \begin{minipage}[t]{\JHmarginparwidth}% added
7292 #1%
7293 \end{minipage}%
7294 \vss}% changed
7295 \vtop to 0pt{\kern\JHmarginparvshift % default should be 0pt
7296 \kern-\dp\strutbox \kern-\ht0 \box0 \vss}}}\pmclesphack}% changed
7297 %
7298 %\newcommand{\JHoutermarginpar}{%
7299 %%\marginpar{\scriptsize {\the\margrefmarker~p.~\pageref{margref\themargrefnumber}}}
7300 %\checkoddpage%
7301 %\ifoddpage%
7302 %\JHrightmarginpar{\scriptsize {\the\margrefmarker~p.~\pageref{margref\themargrefnumber}}}%
7303 %\else% below is for even pages
7304 %\JHleftmarginpar{\scriptsize {\the\margrefmarker~p.~\pageref{margref\themargrefnumber}}}%
7305 %\fi%
7306 %}
7307 \newcommand{\JHoutermarginpar}{%
7308 %\marginpar{\scriptsize {\the\margrefmarker~p.~\pageref{margref\themargrefnumber}}}
7309 \strictpagechecktrue%
7310 \checkoddpage%
7311 \ifoddpage%
7312 \JHswitchmarginpar{\scriptsize {\the\margrefmarker~p.~\pageref{margref\themargrefnumber}}}%
7313 \else% below is for even pages
7314 \JHswitchmarginpar{\scriptsize {\the\margrefmarker~p.~\pageref{margref\themargrefnumber}}}%
7315 \fi%
7316 }
7317 %
7318 %\newcommand{\JHguttermarginpar}{%
7319 %%\marginpar{\scriptsize {\the\margrefmarker~p.~\pageref{margref\themargrefnumber}}}
7320 %\checkoddpage%
7321 %\ifoddpage%
7322 % \JHleftmarginpar{\scriptsize {\the\margrefmarker~p.~\pageref{margref\themargrefnumber}}}%
7323 %\else% below is for even pages
7324 % \JHrightmarginpar{\scriptsize {\the\margrefmarker~p.~\pageref{margref\themargrefnumber}}}%
7325 %\fi%
7326 %}
7327 %
7328 \newcommand{\JHguttermarginpar}{%
7329 \strictpagechecktrue
7330 \checkoddpage%
7331 \ifoddpage%
7332 \JHswitchmarginpar{\scriptsize {\the\margrefmarker~p.~\pageref{margref\themargrefnumber}}}%
7333 \else% below is for even pages
7334 \JHswitchmarginpar{\scriptsize {\the\margrefmarker~p.~\pageref{margref\themargrefnumber}}}%
7335 \fi%
7336 }
7337 %
7338 % jhswitchmarginpar command for notes in gutter and outer
7339 %
7340 \newcommand{\JHswitchmarginpar}{\@dblarg{\@JHswitchmarginpar}}
7341 %\long\def\@pmclsidepar[#1]#2{\@bsphack\leavevmode\vadjust{%
7342 \long\def\@JHswitchmarginpar[#1]#2{\@bsphack\strut\vadjust{% added
7343 \checkoddpage
7344 \ifJHmarginparswitch
7345 \ifJHreversemarginpar
7346 \ifoddpage
7347 \oddpagefalse
7348 \else
7349 \oddpagetrue
7350 \fi
7351 \fi
7352 \else
7353 \oddpagetrue
7354 \ifJHreversemarginpar
7355 \oddpagefalse
7356 \fi
7357 \fi
7358 \rlap{\kern-\parindent
7359 \if@twocolumn
7360 \if@firstcolumn % put at left
7361 \kern -\JHmarginparsep \kern -\JHmarginparwidth % at left
7362 \else % put at right
7363 \kern \columnwidth \kern \JHmarginparsep % at right
7364 \fi
7365 \else
7366 \ifoddpage % put at right
7367 \kern \textwidth \kern \JHmarginparsep % at right
7368 \else % put at left
7369 \kern -\JHmarginparsep \kern -\JHmarginparwidth % at left
7370 \fi
7371 \fi
7372 % \vbox to 0pt{%
7373 % \kern \JHmarginparvshift% % vertical shift to align top text lines
7374 % \begin{minipage}{\JHmarginparwidth}%
7375 \setbox0=\vtop to 0pt{% added
7376 \begin{minipage}[t]{\JHmarginparwidth}% added
7377 \ifoddpage #2\else #1\fi%
7378 \end{minipage}%
7379 % \vss}}}\@esphack}
7380 \vss}% added
7381 \vtop to 0pt{\kern\JHmarginparvshift % default should be 0pt
7382 \kern-\dp\strutbox \kern-\ht0 \box0 \vss}}}\@esphack}% added
7383 %
7384 % commands for placing the marginal marks for titles
7385 % right side
7386 \newcommand{\JHrighttitlemarginpar}[1]{%
7387 \pmclbsphack\strut\vadjust{%
7388 \rlap{\kern-\parindent%
7389 \kern\textwidth\kern\JHtitlemarginparsep% at right
7390 \ifcentertitleson%
7391 \kern-.5\JHtextwidth\kern\marginparsepmin%
7392 \fi%
7393 \setbox0=\vtop to 0pt{% added
7394 \begin{minipage}[t]{\JHmarginparwidth}% added
7395 #1%
7396 \end{minipage}%
7397 \vss}%
7398 \vtop to 0pt{\kern\JHmarginparvshift% default should be 0pt
7399 \kern-\dp\strutbox \kern-\ht0 \box0 \vss}}}\pmclesphack}%
7400 %
7401 % commands for placing the marginal marks for titles
7402 % left side
7403 \newcommand{\JHlefttitlemarginpar}[1]{%
7404 \pmclbsphack\strut\vadjust{% changed
7405 \rlap{\kern-\parindent%
7406 \kern -\JHtitlemarginparsep \kern -\JHmarginparwidth% at left
7407 \ifcentertitleson%
7408 \kern-.5\JHtextwidth\kern\marginparsepmin%
7409 \fi%
7410 \setbox0=\vtop to 0pt{%
7411 \begin{minipage}[t]{\JHmarginparwidth}% added
7412 #1%
7413 \end{minipage}%
7414 \vss}% changed
7415 \vtop to 0pt{\kern\JHmarginparvshift % default should be 0pt
7416 \kern-\dp\strutbox \kern-\ht0 \box0 \vss}}}\pmclesphack}% changed
7417 %
7418 % command for JHtitlemarks in title in outer margin or in gutter
7419 \newcommand{\JHswitchtitlemarginpar}{\@dblarg{\@JHswitchtitlemarginpar}}
7420 %\long\def\@pmclsidepar[#1]#2{\@bsphack\leavevmode\vadjust{%
7421 \long\def\@JHswitchtitlemarginpar[#1]#2{\@bsphack\strut\vadjust{% added
7422 \checkoddpage%
7423 \ifJHmarginparswitch%
7424 \ifJHreversemarginpar%
7425 \ifoddpage%
7426 \oddpagefalse%
7427 \else%
7428 \oddpagetrue%
7429 \fi%
7430 \fi%
7431 \else%
7432 \oddpagetrue%
7433 \ifJHreversemarginpar%
7434 \oddpagefalse%
7435 \fi%
7436 \fi%
7437 \rlap{\kern-\parindent%
7438 \if@twocolumn%
7439 \if@firstcolumn % put at left
7440 \kern -\JHtitlemarginparsep \kern -\marginparwidth % at left
7441 \kern-.5\JHtextwidth\kern\marginparsepmin%
7442 \else % put at right
7443 \kern \columnwidth \kern \JHtitlemarginparsep % at right
7444 \fi%
7445 \else%
7446 \ifoddpage % put at right
7447 \kern \textwidth \kern \JHtitlemarginparsep % at right
7448 \ifcentertitleson%
7449 \kern-.5\JHtextwidth\kern\marginparsepmin%
7450 \fi%
7451 \else % put at left
7452 \kern -\JHtitlemarginparsep \kern -\marginparwidth % at left
7453 \ifcentertitleson%
7454 \kern-.5\JHtextwidth\kern\marginparsepmin%
7455 \fi%
7456 \fi%
7457 \fi%
7458 % \vbox to 0pt{%
7459 % \kern \pmclsideparvshift% % vertical shift to align top text lines
7460 % \begin{minipage}{\marginparwidth}%
7461 \setbox0=\vtop to 0pt{% added
7462 \begin{minipage}[t]{\marginparwidth}% added
7463 \ifoddpage #2\else #1\fi%
7464 \end{minipage}%
7465 % \vss}}}\@esphack}
7466 \vss}% added
7467 \vtop to 0pt{\kern\JHmarginparvshift % default should be 0pt
7468 \kern-\dp\strutbox \kern-\ht0 \box0 \vss}}}\@esphack}% added
7469 %
7470 \newcommand{\set@margp@emtitle}[7]{\setlength{\titleentryoverrun}{#6}%
7471 {#2}%
7472 {#3 \begin{titleentryenvironment}%
7473 {\ifcentertitleson\begin{center}#4 #1 #7\end{center}\else #4 #1
7474 #7\fi}\end{titleentryenvironment}}%
7475 {#5}%
7476 \m@kep@emlabel%
7477 \m@ken@teholder{#1}%
7478 \setlength{\titleentryoverrun}{\z@}}
7479 %% subtitle version
7480 \newcommand{\set@margp@emsubtitle}[7]{\setlength{\titleentryoverrun}{#6}%
7481 {#2}%
7482 {#3 \begin{titleentryenvironment}%
7483 {\ifcentertitleson\begin{center}#4 #1 #7\end{center}\else #4 #1
7484 #7\fi}\end{titleentryenvironment}}%
7485 {#5}%
7486 %\m@kep@emlabel%
7487 %\m@ken@teholder{#1}%
7488 \setlength{\titleentryoverrun}{\z@}}
7489 % user version
7490 \newcommand{\setmargpoemtitle}[2]{%
7491 \set@margp@emtitle{#1}{\poemtitlepenalty}{\poemtitlefont}%
7492 {\sequencetitleindent}{\nobreak\par\nobreak\afterpoemtitleskip\nobreak}{\z@}{#2}%
7493 \c@ntentsinfo{#1}{\contentsindentone}{\contentspoemtitlefont}%
7494 {\contentsindenttwoamount}%
7495 \t@xtnotesinfo{#1}%
7496 \sources{\label{#2}}%
7497 }
7498 %\newcommand{\set@margp@emtitle}[7]{\setlength{\titleentryoverrun}{#6}%
7499 %{#2}%
7500 %{#3 \begin{titleentryenvironment}%
7501 %{#4 #1 #7}\end{titleentryenvironment}}%
7502 %{#5}%
7503 %\m@kep@emlabel%
7504 %\m@ken@teholder{#1}%
7505 %\setlength{\titleentryoverrun}{\z@}}
7506 % \end{macrocode}
7507 % \end{macro}
7508 % \begin{macro}{\JHpoemtitle} Macros to set marginal line
7509 % references.
7510 % \begin{macrocode}
7511 % \newcommand{\JHpoemtitle}[2]{%
7512 % \setmargpoemtitle{#1}{\JHlabel{#2}}%
7513 % }
7514 \@mparswitchfalse % so the title marker won't switch sides on alternate pages
7515 \newcommand{\JHpoemtitle}[2]{%
7516 \set@margp@emtitle{#1}{\poemtitlepenalty}{\poemtitlefont}%
7517 {\sequencetitleindent}{\nobreak\par\nobreak\afterpoemtitleskip\nobreak}{\z@}%
7518 {\JHlabel{#2}}%
7519 \c@ntentsinfo{#1}{\contentssequencetitleindent}{\contentspoemtitlefont}%
7520 {\contentssequencetitleindentamount}%
7521 \t@xtnotesinfo{#1}%
7522 \sources{\label{#2}}%
7523 }
7524 \newcommand{\JHprosesectiontitle}[2]{%
7525 \set@margp@emtitle{#1}{\poemtitlepenalty}{\poemtitlefont}%
7526 {\sequencetitleindent}{\nobreak\par\nobreak\afterpoemtitleskip\nobreak}{\z@}%
7527 {\JHlabel{#2}}%
7528 \c@ntentsinfo{#1}{\contentssequencetitleindent}{\contentspoemtitlefont}%
7529 {\contentssequencetitleindentamount}%
7530 \t@xtnotesinfo{#1}%
7531 \sources{\label{#2}}%
7532 }
7533 %\newcommand{\JHlabel}[1]{%
7534 %\marginpar{{\scriptsize{\the\titlemargrefmarker~p.~\pageref{#1}}}}}
7535 \newcommand{\JHlabel}[1]{%
7536 \ifJHmarkstoright\JHrighttitlemarginpar
7537 {{\scriptsize{\the\margrefmarker~p.~\pageref{#1}}}}
7538 \fi
7539 \ifJHmarkstoleft
7540 \JHlefttitlemarginpar{{\scriptsize{\the\margrefmarker~p.~\pageref{#1}}}}
7541 \fi
7542 \ifJHmarkstoouter
7543 \JHswitchtitlemarginpar{{\scriptsize{\the\margrefmarker~p.~\pageref{#1}}}}
7544 \fi
7545 \ifJHmarkstogutter
7546 \JHswitchtitlemarginpar{{\scriptsize{\the\margrefmarker~p.~\pageref{#1}}}}
7547 \fi
7548 }
7549
7550 % \end{macrocode}
7551 % \end{macro}
7552 % \begin{macro}{\JHsequencetitle} Macros to set marginal page
7553 % references for sequences, sequence sections, poem sections, poem
7554 % subtitles, dedications, and epigraphs.
7555 % \begin{macrocode}
7556 \newcommand{\JHsequencetitle}[2]{%
7557 \set@margp@emtitle{#1}{\sequencetitlepenalty}{\sequencetitlefont}%
7558 {\sequencetitleindent}{\nobreak\par\nobreak\aftersequencetitleskip\nobreak}{\z@}%
7559 {\JHlabel{#2}}%
7560 \putpagenumberincontentsfalse%
7561 \c@ntentsinfo{#1}{\contentsindentone}{\contentssequencetitlefont}%
7562 {\contentsindenttwoamount}%
7563 \putpagenumberincontentstrue%
7564 \t@xtnotesinfo{#1}%
7565 \sources{\label{#2}}%
7566 }
7567 \newcommand{\JHsequencesectiontitle}[2]{%
7568 \set@margp@emtitle{#1}{\poemtitlepenalty}{\poemtitlefont}%
7569 {\sequencesectiontitleindent}{\nobreak\par\nobreak\afterpoemtitleskip\nobreak}%
7570 {\sequencesectiontitleindentamount}{\JHlabel{#2}}%
7571 \c@ntentsinfo{#1}{\contentssequencesectiontitleindent}{\contentspoemtitlefont}%
7572 {\contentsindentthreeamount}%
7573 \t@xtnotesinfo{#1}%
7574 \sources{\label{#2}}%
7575 }
7576 \newcommand{\JHsequencefirstsectiontitle}[2]{%
7577 \set@margp@emtitle{#1}{\par\nobreak\afterpoemtitleskip}{\poemtitlefont}%
7578 {\sequencesectiontitleindent}{\nobreak\par\nobreak\afterpoemtitleskip\nobreak}%
7579 {\titleindentamount}{\JHlabel{#2}}%
7580 \c@ntentsinfo{#1}{\contentssequencesectiontitleindent}{\contentspoemtitlefont}%
7581 {\contentssequencesectiontitleindentamount}%
7582 \t@xtnotesinfo{#1}%
7583 \sources{\label{#2}}%
7584 }
7585 \newcommand{\JHpoemsectiontitle}[2]{%
7586 \set@margp@emtitle{#1}{\poemtitlepenalty}{\subsectiontitlefont}%
7587 {\poemsectiontitleindent}{\nobreak\par\nobreak\afterpoemtitleskip\nobreak}%
7588 {\poemsectiontitleindentamount}{\JHlabel{#2}}%
7589 \c@ntentsinfo{#1}{\contentspoemsectiontitleindent}{\contentspoemtitlefont}%
7590 {\contentspoemsectiontitleindentamount}%
7591 \t@xtnotesinfo{#1}%
7592 \sources{\label{#2}}%
7593 }
7594 \newcommand{\JHpoemfirstsectiontitle}[2]{%
7595 \set@margp@emtitle{#1}{\par\nobreak}{\subsectiontitlefont}%
7596 {\poemsectiontitleindent}{\nobreak\par\nobreak\afterpoemtitleskip\nobreak}%
7597 {\\poemsectiontitleindentamount}{\JHlabel{#2}}%
7598 \c@ntentsinfo{#1}{\contentsi\poemsectiontitleindent}{\contentspoemtitlefont}%
7599 {\contents\poemsectiontitleindentamount}%
7600 \t@xtnotesinfo{#1}%
7601 \sources{\label{#2}}%
7602 }
7603 \newcommand{\JHsequencesectionsubtitle}[2]{%
7604 \set@margp@emsubtitle{#1}{\par\nobreak}{\subsectiontitlefont}%
7605 {\titleindent}{\nobreak\par\nobreak\afterpoemtitleskip\nobreak}%
7606 {\titleindentamount}{\JHlabel{#2}}%
7607 \sources{\label{#2}}%
7608 }
7609 \newcommand{\JHpoemsubtitle}[2]{\JHsequencesectionsubtitle{#1}{#2}
7610 }
7611 \newcommand{\JHdedication}[2]{\nopagebreak\afterpoemtitleskip\testforcenterepigraph%
7612 \begin{epigraphquote}%
7613 \emph{#1}\JHlabel{#2}\end{epigraphquote}%
7614 \sources{\label{#2}}\afterpoemtitleskip\nopagebreak}
7615 \newcommand{\JHepigraph}[2]{\nopagebreak\afterpoemtitleskip\testforcenterepigraph%
7616 \begin{epigraphquote}%
7617 \emph{#1}\JHlabel{#2}\end{epigraphquote}%
7618 \sources{\label{#2}}\afterpoemtitleskip\nopagebreak}
7619 % \end{macrocode}
7620 % \end{macro}
7621 % \begin{macro}{\backmattersectiontitle} Macros to set the titles of back matter sections
7622 % such as textual notes.
7623 %
7624 % \begin{macrocode}
7625 \newcommand{\backmattersectiontitle}[1]{%
7626 \set@p@emtitle{#1}{\poemtitlepenalty}{\volumetitlefont}%
7627 {\relax}{\backmattersink}{\z@}%
7628 \c@ntentsinfo{#1}{contentsindentone}{\contentspoemtitlefont}%
7629 {\contentsindenttwoamount}%
7630 \t@xtnotesinfo{#1}
7631 }
7632 % \end{macrocode}
7633 % \end{macro}
7634 % \begin{macro}{\margreftextnote} Macros to set marginal page
7635 % references showing where in the apparatus a comment upon the
7636 % marked line is to be found. |\margrefspecial{}| is for occasions
7637 % when you might need to set the label by hand. For instance, suppose
7638 % you have several textnotes on a line, and the note you wish to draw
7639 % attention to is on a different page from the other notes.
7640 % |\margreftextnote| under those circumstances will point only to the
7641 % first note. Use |\margrefspecial| to point to the other note,
7642 % giving |\margrefspecial| a unique argument, and opening that note
7643 % with a \label{} command using the same argument.
7644 %
7645 % \begin{macrocode}
7646 \newcounter{margrefnumber}
7647 \setcounter{margrefnumber}{1}
7648 \newtoks{\margrefmarker}
7649 \margrefmarker={\dag}
7650 \newcommand{\setmargrefmarker}[1]{\margrefmarker={#1}}
7651 \providecommand{\settitlemargrefmarker}[1]{\titlemargrefmarker={#1}}
7652 \newtoks{\titlemargrefmarker}
7653 \titlemargrefmarker={\dag}
7654 \newcommand{\makemargreflabel}{\string\label\string{margref\themargrefnumber\string}}
7655 \newif{\ifmargrefstomargin}
7656 \margrefstomargintrue
7657 \newcommand{\setmargref}{\nolinebreak\begin{marginenvironment}%
7658 \nolinebreak%
7659 \ifJHmarkstoright%
7660 \JHrightmarginpar{\scriptsize {\the\margrefmarker~p.~\pageref{margref\themargrefnumber}}}%
7661 \fi%
7662 \ifJHmarkstoleft%
7663 \JHleftmarginpar{\scriptsize {\the\margrefmarker~p.~\pageref{margref\themargrefnumber}}}%
7664 \fi%
7665 \ifJHmarkstoouter%
7666 \JHoutermarginpar%
7667 \fi%
7668 \ifJHmarkstogutter%
7669 \JHguttermarginpar%
7670 \fi%
7671 \end{marginenvironment}%
7672 \nolinebreak%
7673 }
7674
7675 %\newcommand{\setmargref}
7676 %{\marginpar{\ifmargrefstomargin\hspace*{.5\leftmargin}\fi%
7677 %\scriptsize {\the\margrefmarker~p.~\pageref{margref\themargrefnumber}}}
7678 %}
7679 % \newcommand{\setmargref}
7680 % {\marginpar{\scriptsize {\the\margrefmarker~p.~\pageref{margref\themargrefnumber}}}
7681 % }
7682 \newcommand{\margreftextnote}{%
7683 \iftextnoteson\addtocounter{margrefnumber}{1}%
7684 \immediate\write\textnotes{\makemargreflabel}%
7685 \setmargref\else\relax\fi%
7686 }
7687 \newcommand{\margrefexplanatory}{%
7688 \ifexplanon\addtocounter{margrefnumber}{1}%
7689 \immediate\write\explanations{\makemargreflabel}%
7690 \setmargref\else\relax\fi%
7691 }
7692 \newcommand{\margrefemendation}{%
7693 \ifemendationson\addtocounter{margrefnumber}{1}%
7694 \immediate\write\emendations{\makemargreflabel}%
7695 \setmargref\else\relax\fi%
7696 }
7697 \newcommand{\margrefspecial}[1]{%
7698 \marginpar{\scriptsize {\the\margrefmarker~p.~\pageref{#1}}}
7699 }
7700 % \end{macrocode}
7701 % \end{macro}
7702 % To change other title making commands to produce titles which add
7703 % something while processing the title, you should: 1. add one to
7704 % the number of arguments it uses 2. replace the use of
7705 % |\set@p@emtitle| with |\set@margp@emtitle| 3. add |{#2}| or
7706 % |\JHlabel{#2}| or whatever as the
7707 % last (seventh) argument to |\set@margp@emtitle|. So, to change
7708 % |\sequencetitle{}| to |\JHsequencetitle{}{}| start with:
7709 % \begin{verbatim}
7710 % \newcommand{\sequencetitle}[1]{
7711 % \set@p@emtitle{#1}{\sequencetitlepenalty}{\sequencetitlefont}
7712 % {\sequencetitleindent}{\nobreak\par\nobreak\aftersequencetitleskip\nobreak}{\z@}
7713 % \putpagenumberincontentsfalse
7714 % \c@ntentsinfo{#1}{\contentsindentone}{\contentssequencetitlefont}
7715 % {\contentsindenttwoamount}
7716 % \putpagenumberincontentstrue
7717 % \t@xtnotesinfo{#1}
7718 % }
7719 % \end{verbatim}
7720 % and change it to
7721 % \begin{verbatim}
7722 % \catcode`\@=11
7723 % \newcommand{\JHsequencetitle}[2]{
7724 % \set@margp@emtitle{#1}{\sequencetitlepenalty}{\sequencetitlefont}
7725 % {\relax}{\nobreak\par\nobreak\aftersequencetitleskip\nobreak}{\z@}
7726 % {\JHlabel{#2}}\putpagenumberincontentsfalse
7727 % \c@ntentsinfo{#1}{\contentsindentone}{\contentssequencetitlefont}
7728 % {\contentsindenttwoamount}
7729 % \putpagenumberincontentstrue
7730 % \t@xtnotesinfo{#1}
7731 % }
7732 % \catcode`\@=12
7733 % \end{verbatim}
7734 % \subsection{~Titles with footnotes}
7735 % \label{footnotetitles}
7736 % \begin{macro}{\footnotepoemtitle}
7737 % \begin{macrocode}
7738 \newif\iftitlefootnotesatpoemend%
7739 \titlefootnotesatpoemendfalse%
7740 \newif\iftitlefootnotesplain%
7741 \titlefootnotesplaintrue%
7742 \newif\iftitlefootnoteslayered%
7743 \titlefootnoteslayeredfalse%
7744 %
7745 \newcommand{\maketitlefootnoteslayered}{%
7746 \DeclareNewFootnote[plain]{H}%
7747 \titlefootnoteslayeredtrue%
7748 \titlefootnotesplainfalse%
7749 \titlefootnotesatpoemendfalse%
7750 }
7751 %
7752 \newcommand{\maketitlefootnotesatpoemend}{
7753 \titlefootnoteslayeredfalse%
7754 \titlefootnotesplainfalse%
7755 \titlefootnotesatpoemendtrue%
7756 }
7757 %
7758 \newcommand{\maketitlefootnotesplain}{
7759 \titlefootnoteslayeredfalse%
7760 \titlefootnotesplaintrue%
7761 \titlefootnotesatpoemendfalse%
7762 }
7763 %
7764 \newcommand{\placetitlefootnote}[1]{\iftitlefootnoteslayered%
7765 \footnoteH{#1}%
7766 \fi%
7767 \iftitlefootnotesatpoemend%
7768 \footnotemark%
7769 \immediate\write\poemendnotes{\string\makeatletter}%
7770 \immediate\write\poemendnotes{\string\footnotemark\string[\the\c@footnote \string]}%
7771 \immediate\write\poemendnotes{\string\makeatother}%
7772 \literalpoemendnote{#1}%
7773 \fi%
7774 \iftitlefootnotesplain%
7775 \footnote{#1}%
7776 \fi%
7777 }
7778 %
7779 \newcommand{\footnotepoemtitle}[2]{%
7780 \set@p@emtitle{#1\placetitlefootnote{#2}}{\poemtitlepenalty}{\poemtitlefont}%
7781 {\poemtitleindent}{\nobreak\par\nobreak\afterpoemtitleskip\nobreak}{\z@}%
7782 \c@ntentsinfo{#1}{\contentspoemtitleindent}{\contentspoemtitlefont}%
7783 {\contentspoemtitleindentamount}%
7784 \t@xtnotesinfo{#1}%
7785 }
7786 %
7787 % \end{macrocode}
7788 % \end{macro}
7789 % \begin{macro}{\footnotepoemtitlefirstline}
7790 % \begin{macrocode}
7791 \newcommand{\footnotepoemtitlefirstline}[2]{%
7792 \firstlinesettings%
7793 \set@p@emtitle{#1\placetitlefootnote{#2}}{\multilinetitlepenalty}{\poemtitlefont}%
7794 {\poemtitleindent}{\nobreak\par\nobreak}{\z@}%
7795 \c@ntentsinfo{#1}{\contentspoemtitleindent}{\contentspoemtitlefont}%
7796 {\contentspoemtitleindentamount}%
7797 \t@xtnotesinfo{#1}%
7798 \restoresinglelinesettings%
7799 }
7800 %
7801 \newcommand{\footnotepoemtitlemiddleline}[2]{%
7802 \middlelinesettings%
7803 \set@p@emtitle{#1\placetitlefootnote{#2}}{\par\nobreak}{\poemtitlefont}%
7804 {\poemtitlesecondlineindent}{\nobreak\par\nobreak}{\z@}%
7805 \c@ntentsinfo{#1}{\contentspoemtitlesecondlineindent}{\contentspoemtitlefont}%
7806 {\contentspoemtitlesecondlineindentamount}%
7807 \t@xtnotesinfo{#1}%
7808 \restoresinglelinesettings%
7809 }
7810 %
7811 \newcommand{\footnotepoemtitlelastline}[2]{%
7812 \lastlinesettings%
7813 \set@p@emtitle{#1\placetitlefootnote{#2}}{\par\nobreak}{\poemtitlefont}%
7814 {\poemtitlesecondlineindent}{\nobreak\par\afterpoemtitleskip\nobreak}{\z@}%
7815 \c@ntentsinfo{#1}{\contentspoemtitlesecondlineindent}{\contentspoemtitlefont}%
7816 {\contentspoemtitlesecondlineindentamount}%
7817 \t@xtnotesinfo{#1}%
7818 \restoresinglelinesettings%
7819 }
7820 % \end{macrocode}
7821 % \end{macro}
7822 % \begin{macro}{\footnotesplitpoemtitle}
7823 % \begin{macrocode}
7824 \newcommand{\footnotesplitpoemtitle}[3]{%
7825 \set@p@emtitle{#1\placetitlefootnote{#2} #3}{\poemtitlepenalty}{\poemtitlefont}%
7826 {\poemtitleindent}{\nobreak\par\nobreak\afterpoemtitleskip\nobreak}{\z@}%
7827 \c@ntentsinfo{#1 #3}{\contentspoemtitleindent}{\contentspoemtitlefont}%
7828 {\contentspoemtitleindentamount}%
7829 \t@xtnotesinfo{#1 #3}%
7830 }
7831 % \end{macrocode}
7832 % \end{macro}
7833 % \subsection{~Epigraphs, headnotes, attributions, dedications}
7834 % Notice that epigraphs to volumes are handled differently from
7835 % epigraphs to poems. Notice also the ``short'' commands, which
7836 % are placed on the page according to the same booleans
7837 % that control how titles are placed.
7838 % \begin{macro}{\epigraph}
7839 % \begin{macro}{\headnote}
7840 % \begin{macro}{\attribution}
7841 % \begin{macro}{\poemdedication}
7842 % \begin{macro}{\volumededication}
7843 % \begin{macro}{\volumeepigraph}
7844 % \begin{macro}{\volumeattribution}
7845 % \begin{macrocode}
7846 \newif\ifcenterepigraphson
7847 \centerepigraphsonfalse
7848 \newlength{\centerepigraphindentation}
7849 \setlength{\centerepigraphindentation}{6em}
7850 \newlength{\normalepigraphindentation}
7851 \setlength{\normalepigraphindentation}{1.5em}
7852 \newcommand{\centerepigraphquote}{%
7853 \setlength{\epigraphquoteleftmargin}{\centerepigraphindentation}
7854 \setlength{\epigraphquoterightmargin}{\centerepigraphindentation}
7855 }
7856 \newcommand{\normalepigraphquote}{%
7857 \setlength{\epigraphquoteleftmargin}{\normalepigraphindentation}
7858 \setlength{\epigraphquoterightmargin}{\normalepigraphindentation}
7859 }
7860 \newcommand{\testforcenterepigraph}{\ifcenterepigraphson%
7861 \centerepigraphquote
7862 \else
7863 \normalepigraphquote
7864 \fi}
7865 \newcommand{\epigraph}[1]{\nopagebreak\afterpoemtitleskip\testforcenterepigraph%
7866 \begin{epigraphquote}%
7867 \emph{#1}\end{epigraphquote}\afterpoemtitleskip\nopagebreak}
7868 \newcommand{\headnote}[1]{\epigraph{#1}}
7869 \newcommand{\attribution}[1]{\nopagebreak\afterpoemtitleskip\testforcenterepigraph%
7870 \begin{epigraphquote}%
7871 {\small\emph{#1}}\end{epigraphquote}\afterpoemtitleskip\nopagebreak}
7872 \newcommand{\poemdedication}[1]{\nopagebreak\afterpoemtitleskip\testforcenterepigraph%
7873 \begin{epigraphquote}%
7874 \emph{#1}\end{epigraphquote}\afterpoemtitleskip\nopagebreak}
7875 \providecommand{\dedication}[1]{\poemdedication{#1}}
7876 \newcommand{\volumededication}[1]{\par\bigskip\begin{volumetitlepagequote}
7877 \emph{#1}\end{volumetitlepagequote}}
7878 \newcommand{\volumeepigraph}[1]{\par\bigskip\begin{volumetitlepagequote}
7879 \emph{#1}\end{volumetitlepagequote}}
7880 \newcommand{\volumeattribution}[1]{\par\smallskip\begin{volumetitlepagequote}
7881 {\small \emph{#1}}\end{volumetitlepagequote}}
7882 \newenvironment{epigraphenvironment}{\nopagebreak\afterpoemtitleskip\testforcenterepigraph%
7883 \begin{epigraphquote}\em}{\end{epigraphquote}\afterpoemtitleskip\nopagebreak}
7884 \newcommand{\set@short@pigraph}[1]{\iftitlesatleftversemargin%
7885 {\begin{pmclverse}\addtolength{\leftmargin}{-\leftmargini}{\nobreak \emph{#1} \afterpoemtitleskip} \end{pmclverse}}%
7886 \else%\iftitlesatleftversemargin
7887 {\nobreak}%
7888 \begin{titleentryenvironment}%
7889 \ifnormaltitleindentation
7890 \hspace{\normalepigraphindentation}\emph{#1}%
7891 \else % for the \ifnormaltitleindentation
7892 \ifcenterepigraphson
7893 \begin{center} \emph{#1}\end{center}
7894 \else \emph{#1}\fi % for ifcenterepigraphson
7895 \fi %\ifnormaltitleindentation
7896 \end{titleentryenvironment}
7897 {\afterpoemtitleskip}%
7898 \fi}% for the \iftitlesatleftversemargin
7899 \newcommand{\shortpoemepigraph}[1]{\nopagebreak\afterpoemtitleskip%
7900 \set@short@pigraph{#1}
7901 }
7902 \newcommand{\shortpoemdedication}[1]{\nopagebreak\afterpoemtitleskip%
7903 \set@short@pigraph{#1}
7904 }
7905 \newcommand{\shortpoemattribution}[1]{\nopagebreak\afterpoemtitleskip%
7906 \set@short@pigraph{{\small #1}}
7907 }
7908 \newcommand{\JHshortepigraph}[2]{\nopagebreak\afterpoemtitleskip%
7909 \set@short@pigraph{#1}\marginpar{{\scriptsize{\the\margrefmarker~p.~\pageref{#2}}}}
7910 \sources{\label{#2}}
7911 }
7912 \newcommand{\JHshortdedication}[2]{\JHshortepigraph{#1}{#2}}
7913
7914
7915 \newlength{\dateindent}%
7916 \setlength{\dateindent}{\leftmargin}%
7917 \newcommand{\variabledateindent}{%
7918 \setlength{\dateindent}{\linewidth}%
7919 \addtolength{\dateindent}{-\versewidth}%
7920 \addtolength{\dateindent}{-.5\dateindent}}
7921 %\newcommand{\poemdate}[1]{\bigskip\begin{raggedleft}\hspace{\dateindent}#1\end{raggedleft}\bigskip}%
7922 \newcommand{\poemdate}[1]{\iflastpoemcentered\variabledateindent%
7923 \else\setlength{\dateindent}{\leftmargin}%
7924 \fi%
7925 \bigskip\begin{raggedleft}\hspace{\dateindent}#1\end{raggedleft}\bigskip}%
7926 %
7927 \newlength{\poemattributionindent}%
7928 \setlength{\poemattributionindent}{\leftmargin}%
7929 \newcommand{\variablepoemattributionindent}{%
7930 \setlength{\poemattributionindent}{\linewidth}%
7931 \addtolength{\poemattributionindent}{-\versewidth}%
7932 \addtolength{\poemattributionindent}{-.5\poemattributionindent}}%
7933 \newcommand{\poemattribution}[1]{\iflastpoemcentered\variablepoemattributionindent%
7934 \else\setlength{\poemattributionindent}{\leftmargin}%
7935 \fi%
7936 \bigskip\begin{raggedleft}\hspace{\poemattributionindent}#1\end{raggedleft}\bigskip}%
7937 % \end{macrocode}
7938 % \end{macro}
7939 % \end{macro}
7940 % \end{macro}
7941 % \end{macro}
7942 % \end{macro}
7943 % \end{macro}
7944 % \end{macro}
7945 % \subsection{~Tools used for making note sections} \label{notetools} The main tool is
7946 % a dirty trick borrowed from John Lavagnino's package for endnotes,
7947 % \textsf{endnotes}, which allows for writing out literal characters to an
7948 % external file. The trick involves redefining the space character as
7949 % the newline character and treating the text of the note as the body of
7950 % a macro that |\meaning| specifies. The result is that the text is
7951 % written to the external file in a long ribbon one word wide.
7952 % \begin{macrocode}
7953 \def\strip#1>{}
7954 \newcommand{\literaltextnote}[1]{\iftextnotesatend
7955 \begingroup
7956 \def\next{#1}%
7957 \newlinechar='40
7958 \immediate\write\textnotes{\expandafter\strip\meaning\next}%
7959 \endgroup\fi
7960 }
7961 \newcommand{\literalemend}[1]{\ifemendationsatend
7962 \begingroup
7963 \def\next{#1}%
7964 \newlinechar='40
7965 \immediate\write\emendations{\expandafter\strip\meaning\next}%
7966 \endgroup\fi
7967 }
7968 \newcommand{\literalexplain}[1]{\ifexplanatend
7969 \begingroup
7970 \def\next{#1}%
7971 \newlinechar='40
7972 \immediate\write\explanations{\expandafter\strip\meaning\next}%
7973 \endgroup\fi
7974 }
7975 \newcommand{\literalcontents}[1]{\ifpoemcontentson
7976 \begingroup
7977 \def\next{#1}%
7978 \newlinechar='40
7979 \immediate\write\poemcontents{\expandafter\strip\meaning\next}%
7980 \endgroup\fi
7981 }
7982 \newcommand{\literaltextnoteshort}[1]{
7983 \iftextnotesatend
7984 \begingroup
7985 \def\next{#1}%
7986 \immediate\write\textnotes{\expandafter\strip\meaning\next}%
7987 \endgroup\fi}
7988 \newcommand{\literalemendshort}[1]{\ifemendationsatend
7989 \begingroup
7990 \def\next{#1}%
7991 \immediate\write\emendations{\expandafter\strip\meaning\next}%
7992 \endgroup\fi}
7993 \newcommand{\literalexplainshort}[1]{\ifexplanatend
7994 \begingroup
7995 \def\next{#1}%
7996 \immediate\write\explanations{\expandafter\strip\meaning\next}%
7997 \endgroup\fi}
7998 \newcommand{\literalcontentsshort}[1]{\ifpoemcontentson
7999 \begingroup
8000 \immediate\write\poemcontents{\expandafter\strip\meaning\next}%
8001 \endgroup\fi}
8002 \newcommand{\sameword}{$\sim$}
8003 \newcommand{\missingpunct}{${}_{\wedge}$}
8004 % \end{macrocode}
8005 % \begin{macro}{\pmccheckifinteger}
8006 % |\pmccheckifinteger{|\meta{num}|}| checks if \meta{num} is an integer.
8007 % If it is, then |\ifinteger| is set TRUE, otherwise it is set FALSE.
8008 % (Code taken from memoir class, and based on Donald Arseneau's
8009 % |\Lpack{cite}| package).
8010 % \begin{macrocode}
8011 \newcommand{\pmccheckifinteger}[1]{%
8012 \protected@edef\@vsa{#1}%
8013 \ifcat _\ifnum9<1\pmcgobm{#1} _\else A\fi
8014 \integertrue%
8015 \else
8016 \integerfalse%
8017 \fi%
8018 }
8019 \newif\ifinteger
8020 % \begin{macro}{\pmcgobm}
8021 % |\pmcgobm{|\meta{num}|}| is defined as \meta{num}. It could be defined as: \\
8022 % |\newcommand{\pmcgobm}[1]{\ifx-#1\expandafter\gobm\else#1\fi}| \\
8023 % which would remove a leading minus sign (hyphen) from its argument
8024 % (|gobm| = gobble minus sign).
8025 % (Code from memoir class and a posting to comp.text.tex by Donald Arseneau on 1997/07/21).
8026 % \begin{macrocode}
8027 \newcommand{\pmcgobm}[1]{#1}
8028 % \end{macrocode}
8029 % \end{macro}
8030 % \subsection{~Commands to make notes and send info to contents}
8031 % \begin{macro}{\setlemmarange}
8032 % |\setlemmarange| calculates the range of line numbers for multi-line
8033 % lemmas.
8034 % \begin{macrocode}
8035 % \newcommand{\setlemmarange}[1]{
8036 % \setcounter{lemmalines}{#1}
8037 % \ifthenelse{\equal{\value{lemmalines}}{0}}{\rangelemmafalse}{\rangelemmatrue}
8038 % \setcounter{lemmaend}{\theverselinenumber}
8039 % \addtocounter{lemmaend}{\thelemmalines}
8040 % }
8041 \newcommand{\setlemmarange}[1]{%
8042 \pmccheckifinteger{#1}%
8043 \ifinteger
8044 \setcounter{lemmalines}{#1}%
8045 \ifthenelse{\equal{\value{lemmalines}}{0}}{\rangelemmafalse}{\rangelemmatrue}%
8046 \setcounter{lemmaend}{\theverselinenumber}%
8047 \addtocounter{lemmaend}{\thelemmalines}%
8048 \else
8049 \setcounterfromref{lemmaend}{#1}\rangelemmatrue
8050 \fi
8051 \makeatother}
8052 % \end{macrocode}
8053 % \end{macro}
8054 % \begin{macro}{\citerange}
8055 % |\citerange| sets the range of line numbers for multi-line lemmas
8056 % \begin{macrocode}
8057 \newcommand{\citerange}{%
8058 \ifrangelemma
8059 \theverselinenumber --\thelemmaend
8060 \else
8061 \theverselinenumber
8062 \fi}
8063 % \end{macrocode}
8064 % \end{macro}
8065 % \begin{macro}{\resetlemmacounters}
8066 % |\resetlemmacounters| resets the counts for multiline lemmas.
8067 % \begin{macrocode}
8068 \newcommand{\resetlemmacounters}{\rangelemmafalse
8069 \setcounter{lemmalines}{0}%
8070 \setcounter{lemmaend}{0}%
8071 }
8072 % \end{macrocode}
8073 % \end{macro}
8074 % \begin{macro}{\checknoteheaders}
8075 % |\checknoteheaders| Checks and corrects the values in the running
8076 % headers of notes sections. The running headers are of the form
8077 % ``Notes to pages xx--yy.'' Every title and every note checks
8078 % whether the values in the running header should be changed. This
8079 % command essentially gives a list of strings to be written on the
8080 % external file for the note section. When these strings are read
8081 % back in when the file is set, they make a little program that
8082 % recalculates the values in the headers during the processing of
8083 % every note. Also typesets the line number or line number range in
8084 % notes sections.
8085 % \begin{macrocode}
8086 \newcommand{\checknoteheaders}{\string\setcounter\string{notepageholdernote\string}%
8087 \string{\thepage\string}\string\ifhmode\string\unskip\string\fi%
8088 \string\ifthenelse\string{\string\value\string{notepageholdernote\string}>%
8089 \string\value\string{notepageholdertitle\string}\string}%
8090 \string{\string\mark\string{\string\thenotepageholdernote\string}\string}%
8091 \string{\string\mark\string{\string\thenotepageholdertitle\string}\string}\string\unskip
8092 \string\unskip\string\relax\ \citerange :\string~\string\nolinebreak}%
8093
8094 % \end{macrocode}
8095 % \end{macro}
8096 % \begin{macro}{\textnote}
8097 % The
8098 % basic |\textnote{}| command, on which everything else is based, has
8099 % several parts. First, it writes out a little program
8100 % on the external endnotes file which, when it is read back in when
8101 % the endnotes are typeset, sets a variable with the value of
8102 % the page of the line the note is commenting upon and checks to see
8103 % whether that value is equal to or greater than that of previous notes
8104 % on that page of notes. Depending upon the outcome of that test, it
8105 % sets the value of |\mark| with the correct numbers to print the proper
8106 % running header of the form ``Textual Notes to pp.xx--yy.'' Second, it
8107 % sends the line number of the line it is a comment upon and the text of
8108 % the note to the notes section. The optional first argument is the
8109 % number of lines covered by a multiline lemma. If there is no
8110 % optional first argument specified, the default is 0. The second
8111 % argument is the text of the note, which includes the rest of the
8112 % lemma, other than the line number. It is up to you to suitably
8113 % abbreviate long lemmas.
8114 %
8115 %
8116 %
8117 % \begin{macrocode}
8118 \newif\iftextnotessinglepar
8119 \newcommand{\textnote}[2][0]{%
8120 \iftextnoteson
8121 \setlemmarange{#1}%
8122 \immediate\write\textnotes{\checknoteheaders}%
8123 \literaltextnote{#2}%
8124 \iftextnotessinglepar%
8125 \literaltextnote{\par}%
8126 \fi%
8127 \fi
8128 \resetlemmacounters
8129 }
8130 % \end{macrocode}
8131 % \end{macro}
8132 % \begin{macro}{\accidental}
8133 % Accidentals: As it is, the command just tests to see whether
8134 % accidentals are being included or not, and sets the accidental as a
8135 % textnote if accidentals are being included. It would not be hard to
8136 % divert accidentals to another external file in order to compile a
8137 % separate list of accidentals. Accidentals, by their nature, cannot have multiline
8138 % lemmas.
8139 % \begin{macrocode}
8140 \newcommand{\accidental}[1]{%
8141 \iftextnoteson%
8142 \ifincludeaccidentals%
8143 \iftextnotesatend\immediate\write\textnotes{\string\nobreak}\fi%
8144 \textnote{#1}%
8145 \iftextnotesatend\immediate\write\textnotes{\string\nobreak}\fi%
8146 \iftextnotessinglepar%
8147 \literaltextnote{\par}%
8148 \fi%
8149 \fi\fi
8150 }
8151 % \end{macrocode}
8152 % \end{macro}
8153 % \begin{macro}{\tsvariant}
8154 % \begin{macro}{\tsaccidental}
8155 % Typescript variants. Treated like accidentals. If they are being
8156 % collected, they are sent to the textual notes. Again, it would not be
8157 % hard to collect them separately. Typescript variants can have
8158 % multiline lemmas.
8159 % \begin{macrocode}
8160 \newcommand{\tsvariant}[2][0]{%
8161 \iftextnoteson
8162 \ifincludetypescripts%
8163 \iftextnotesatend\immediate\write\textnotes{\string\nobreak}\fi%
8164 \textnote[#1]{#2}%
8165 \iftextnotesatend\immediate\write\textnotes{\string\nobreak}\fi%
8166 \fi\fi
8167 }
8168 \newcommand{\tsaccidental}[1]{\iftextnoteson\ifincludetypescripts\accidental{#1}\fi\fi}
8169 % \end{macrocode}
8170 % \end{macro}
8171 % \end{macro}
8172 % \begin{macro}{\tsentry}
8173 % Typescript entries. Allows one to to selectively include or exclude
8174 % typescript entries from lists of variants. If an entry begins with
8175 % a comma (as it commonly will, since it will typically be a member
8176 % of a list of entries, you need not put |\unskip| before the comma,
8177 % since \textsf{poemscol} will do it for you. Thanks to Donald
8178 % Arseneau for suggesting how to do this.
8179 % \begin{macrocode}
8180 \newcommand{\tsentry}[1]{\iftextnoteson\ifincludetypescripts{\@ifnextchar,{\unskip}{%
8181 Ê\@ifnextchar;{\unskip}{}%
8182 }#1}\fi\fi\unskip}
8183 % \end{macrocode}
8184 % \end{macro}
8185 % \begin{macro}{\sources}
8186 % |\sources{}| is essentially a |\textnote{}| with no line number
8187 % and no page checking. Useful for typesetting the sources of the text
8188 % (hence the name) and for sending literal characters to the endnotes
8189 % file for other purposes.
8190 % \begin{macrocode}
8191 \newcommand{\sources}[1]{%
8192 \iftextnoteson
8193 \begingroup
8194 \newlinechar='40
8195 \def\next{#1}%
8196 \immediate\write\textnotes{\expandafter\strip\meaning\next}%
8197 \endgroup
8198 \iftextnotessinglepar%
8199 \literaltextnote{\par}%
8200 \fi%
8201 \fi
8202 }
8203 % \end{macrocode}
8204 % \end{macro}
8205 %
8206 % \subsection{~Emendations and explanatory notes}
8207 % The difference between these kinds of notes and ordinary
8208 % |\textnotes{}| is that they must first test to see whether there have
8209 % been any emendations or explanatory notes for the poem in question.
8210 % If there have not been prior notes, then a new paragraph must be
8211 % opened and the page number and title of the poem set in the note
8212 % section.
8213 % \begin{macro}{\titletoothernotes}
8214 % |\titletoothernotes| sends the page and title information to the
8215 % Emendations or Explanatory Notes sections. It is called only for
8216 % the first emendation or explanatory note for a poem. It is designed
8217 % so that if the user wishes to define another category of notes in
8218 % which might not apply to all of the poems to be set --- not all
8219 % poems, for instance, have emendations --- this command can be used
8220 % for those notes as well.
8221 % \begin{macrocode}
8222 \newcommand{\titletoothernotes}{\string\par
8223 \ifputpagenumberinnotes%
8224 \string\argpageref\string{\@compoundlabelscratch\string}%
8225 \string\setcounterfrompageref\string{notepageholdertitle\string}%
8226 \string{\@compoundlabelscratch\string}%
8227 \fi%
8228 \string\textbf\string{\ \the\fulltitleholder\string}}%
8229 % \end{macrocode}
8230 % \end{macro}
8231 % \begin{macro}{\emendation}
8232 % \begin{macrocode}
8233 \newif\ifemendationssinglepar
8234 \newcommand{\emendation}[2][0]{
8235 \ifemendationson
8236 \setlemmarange{#1}%
8237 \ifredundantemendations
8238 \iftextnoteson
8239 \ifrangelemma
8240 \textnote[#1]{#2}%
8241 \else
8242 \textnote{#2}%
8243 \fi % ifrangelemma}
8244 \iftextnotessinglepar%
8245 \literaltextnote{\par}%
8246 \fi% iftextnotesinglepar
8247 \fi %iftextnoteson
8248 \fi % ifredundantemendations
8249 \ifnoemendyet % firstemendation
8250 \firstemendation
8251 \fi %noemendyet
8252 \global\noemendyetfalse
8253 \immediate\write\emendations{\checknoteheaders}%
8254 \literalemend{#2}%
8255 \ifemendationssinglepar%
8256 \literalemend{\par}%
8257 \fi% ifemendationssinglepar
8258 \fi % ifemendationson
8259 \resetlemmacounters
8260 }
8261 % \end{macrocode}
8262 % \end{macro}
8263 % This next is an internal command,
8264 % called by |\emendation|. There's no need to use it explicitly.
8265 % \begin{macrocode}
8266 \newcommand{\firstemendation}{\ifemendationsatend
8267 \immediate\write\emendations{\titletoothernotes}\fi
8268 }
8269 % \end{macrocode}
8270 % \begin{macro}{\explanatory}
8271 % Again, |\firstexplanatory| is internal, called by |\explanatory|.
8272 % \begin{macrocode}
8273 \newif\ifexplanationssinglepar
8274 \newcommand{\explanatory}[2][0]{%
8275 \ifexplanon
8276 \setlemmarange{#1}%
8277 \ifnoexplainyet % first explanation
8278 \firstexplanatory
8279 \fi %noexplainyet
8280 \global\noexplainyetfalse
8281 \immediate\write\explanations{\checknoteheaders}%
8282 \literalexplain{#2}%
8283 \ifexplanationssinglepar%
8284 \literalexplain{\par}%
8285 \fi%
8286 \fi % ifexplanon
8287 \resetlemmacounters
8288 }
8289
8290 \newcommand{\firstexplanatory}{\ifexplanatend
8291 \immediate\write\explanations{\titletoothernotes}\fi
8292 }
8293
8294 % \end{macrocode}
8295 % \end{macro}
8296 %
8297 % \subsection{~Making new notes sections}
8298 %
8299 % \begin{macro}{\definenewnotetype} This monster macro has nine
8300 % sections, and does all of the things required to set up a new end
8301 % notes section. If you decide to mark a new kind of note in your
8302 % text with, say |\mynote|, but decide at the last moment against
8303 % including those notes in your edition, simply don't issue |\putmynotes| at
8304 % the point it might have appeared, and neither the notes section nor
8305 % the contents entry for it will be included.
8306 %
8307 % \begin{macrocode}
8308 \makeatletter
8309 \long\def\appendtomacro#1#2{%
8310 \begingroup
8311 \toks@\expandafter{#1#2}%
8312 \xdef#1{\the\toks@}%
8313 \endgroup}
8314 \makeatother
8315 \newcommand{\definenewnotetype}[5]{%
8316 % 1. make an if for this kind of note and set it to true by default;
8317 % make an if for the first instance of the command per poem and set it
8318 % to false; make an if for setting the notes in single note
8319 % paragraphs and set it to false; make an if for setting
8320 % these notes in two column mode and set it to false
8321 %
8322 % Thanks to Igor Pechtchanski and Ulrich Schwarz.
8323 \expandafter\newif\csname if#1son\endcsname
8324 \global\csname #1sontrue\endcsname
8325 \expandafter\newif\csname ifno#1yet\endcsname
8326 \csname no#1yettrue\endcsname
8327 \expandafter\newif\csname if#1ssinglepar\endcsname
8328 \csname #1singleparfalse\endcsname
8329 \expandafter\newif\csname if#1stwocol\endcsname
8330 \csname #1stwocolfalse\endcsname
8331 % 2. open a new output stream
8332 \expandafter\newwrite\csname #1s\endcsname
8333 % 3. open a file to associate with the stream
8334 \immediate\expandafter\openout\csname #1s\endcsname=\expandafter\jobname .#2
8335 % 4. set up a literalwrite command
8336 \expandafter\newcommand\csname literal#1\endcsname[1]{
8337 \begingroup
8338 \def\next{##1}%
8339 \newlinechar='40
8340 \immediate\write\expandafter\csname #1s\endcsname{\expandafter\strip\meaning\next}%
8341 \endgroup}
8342 % 5. send heading information to output file
8343 % first, use literaltext to send commands without parameters
8344 \csname literal#1\endcsname{\flushbottom{\par\clearpage
8345 {\pagestyle{volumetitlestyle}\cleardoublepage}
8346 \thispagestyle{volumetitlestyle}}
8347 \fancyhead{}
8348 \fancyfoot{}
8349 \fancyhead[RO,LE]{{\small\textrm{\thepage}}}}
8350 % then immediate write to send the parameter for the marks in the
8351 % headers
8352 \immediate\write\csname #1s\endcsname{\string\fancyhead[CO]\string{\string{\string\small
8353 \string{\string\em\ #3\string~\string\mymarks\string}\string}\string}}
8354 \immediate\write\csname #1s\endcsname{\string\fancyhead[CE]\string{\string{\string\small
8355 \string{\string\em\ #3\string~\string\mymarks\string}\string}\string}}
8356 % then literal to finish the headers
8357 \csname literal#1\endcsname{\fancyfoot[C]{}
8358 \mark{3}
8359 \backmattersink}
8360 % then immediate write to send the title of the section to print at
8361 % the top of the page
8362 \immediate\write\csname #1s\endcsname{
8363 \string\setendnotessectiontitle\string{#4\string}\string{#1notes\string}}
8364 % literal write to turn hyphenation on, set the font for the note
8365 % section, and turn on two column mode (if the boolean is set)
8366 \csname literal#1\endcsname{\lefthyphenmin=2\backmatterafterheadersink
8367 \tolerance=500\language=0
8368 \normalfont \backmattertextfont}
8369 \immediate\write\csname #1s\endcsname{\string\if#1stwocol}
8370 \csname
8371 literal#1\endcsname{\begin{multicols}{2}\fi\setlength{\parindent}{-10pt}}%
8372 % \csname literal#1\endcsname{\setlength}{\parindent}{2}}% problem here
8373 % 6. set up a command to write the page and title of the poem for the first
8374 % instance of this kind of note in a poem
8375 \expandafter\newcommand\csname first#1\endcsname{%
8376 \immediate\write\expandafter\csname #1s\endcsname{\titletoothernotes}%
8377 \immediate\write\csname #1s\endcsname{\string\if#1ssinglepar}%
8378 \immediate\write\csname #1s\endcsname{\string\par}%
8379 \immediate\write\csname #1s\endcsname{\string\fi}%
8380 }
8381 % 7. set up a command to write a note, complete with line numbers
8382 \expandafter\newcommand\csname #1\endcsname[2][0]{%
8383 \setlemmarange{##1}%
8384 \csname ifno#1yet\endcsname%
8385 \csname first#1\endcsname%
8386 \fi%
8387 \global\csname no#1yetfalse\endcsname%
8388 \immediate\write\expandafter\csname
8389 #1s\endcsname{\string\nobreak\string\nobreak\checknoteheaders}%
8390 \csname literal#1\endcsname{##2}%
8391 \csname if#1ssinglepar\endcsname%
8392 \csname literal#1\endcsname{\par}%
8393 \fi%
8394 \resetlemmacounters%
8395 }
8396 % prose version
8397 \expandafter\newcommand\csname prose#1\endcsname[3][0]{%
8398 \unskip\proselinelabel{##2}%
8399 \setproselemmarange{##2}{##1}%
8400 \csname ifno#1yet\endcsname%
8401 \csname first#1\endcsname%
8402 \fi%
8403 \global\csname no#1yetfalse\endcsname%
8404 \immediate\write\expandafter\csname #1s\endcsname{\checkprosenoteheaders}%
8405 \csname literal#1\endcsname{##3}%
8406 \csname if#1ssinglepar\endcsname%
8407 \csname literal#1\endcsname{\par}%
8408 \unskip%
8409 \fi%
8410 \resetlemmacounters\unskip%
8411 }
8412 % pm version
8413 \expandafter\newcommand\csname pm#1\endcsname[2][0]{%
8414 \setpmlemmarange{##1}%
8415 \csname ifno#1yet\endcsname%
8416 \csname first#1\endcsname%
8417 \fi%
8418 \global\csname no#1yetfalse\endcsname%
8419 \immediate\write\expandafter\csname #1s\endcsname{\pmchecknoteheaders\string~}%
8420 \immediate\write\expandafter\csname #1s\endcsname{\pmciterange}%
8421 \csname literal#1\endcsname{##2}%
8422 \csname if#1ssinglepar\endcsname%
8423 \csname literal#1\endcsname{\par}%
8424 \fi%
8425 \pmresetlemmacounters\unskip%
8426 }
8427 % 8. modify the end of the poem environment to reset the first
8428 % command per poem boolean (so that the page and title will be set in
8429 % the notes section when the first note is called for a poem)
8430 % thanks to Heiko Oberdiek
8431 \makeatletter
8432 \appendtomacro{\endpoem}{\global\expandafter\csname no#1yettrue\endcsname}
8433 \makeatother
8434 \makeatletter
8435 \appendtomacro{\endprosesection}{\global\expandafter\csname no#1yettrue\endcsname}
8436 \makeatother
8437 \makeatletter
8438 \appendtomacro{\endpmsection}{\global\expandafter\csname no#1yettrue\endcsname}
8439 \makeatother
8440
8441 % 9. command for closing the output file
8442 % command for reading in and printing the output file
8443 \expandafter\newcommand\csname put#1s\endcsname{
8444 \newpage\hyphenationforsmall
8445 \csname if#1stwocol\endcsname%
8446 \csname literal#1\endcsname{\end{multicols}}%
8447 \fi %\iftwocol
8448 \immediate\expandafter\closeout\csname #1s\endcsname
8449 \expandafter\input \jobname.#2
8450 \ifpoemcontentson
8451 \contentsendnotestitle{#5}{#1notes}
8452 \fi
8453 }
8454 % 10. command for making a marginal mark at a line, giving the page
8455 % number in the apparatus where a note is to be found
8456 \expandafter\newcommand\csname margref#1\endcsname{%
8457 \addtocounter{margrefnumber}{1}
8458 \immediate\write\expandafter\csname #1s\endcsname{\makemargreflabel}%
8459 \setmargref
8460 }
8461 }
8462 % \end{macrocode}
8463 % \end{macro}
8464 % \subsection{~Prose sections}\textsf{poemscol} calls on
8465 % \textsf{lineno} to do all the heavy lifting for making line numbers
8466 % in prose sections and for making endnotes of various kinds for prose
8467 % sections. First, set up a counter for the line number and for the
8468 % modulo line number for prose sections, and set it to equal that used
8469 % in verse sections. Then set the font for marginal line numbers to
8470 % the size used in marginal line numbers in verse sections.
8471 % \begin{macrocode}
8472 \newcounter{proselinenumber}
8473 \setcounter{proselinenumber}{1}
8474 \newcounter{prosemodulo}
8475 \setcounter{prosemodulo}{\value{lineindexrepeat}}
8476 \addtocounter{prosemodulo}{1}
8477 \newcommand{\setprosemodulo}[1]{\modulolinenumbers[#1]}
8478 % \end{macrocode}
8479 % Then commands for setting titles of prose sections. These are just
8480 % versions of |\poemtitle|. Fancier versions will follow if there is
8481 % need.
8482 % \begin{macrocode}
8483 \newcommand{\prosesectiontitle}[1]{\poemtitle{#1}}
8484 \newcommand{\prosesectiontitlenotitle}[1]{\poemtitlenotitle{#1}}
8485 % \end{macrocode}
8486 % Next, environments for prose sections. The environment resets (or
8487 % doesn't, in the second case) the marginal line number. The
8488 % default modulo line number is that prevailing in verse sections,
8489 % but you can change it at will.
8490 % \begin{macrocode}
8491 \setcounter{prosemodulo}{\value{lineindexrepeat}}%
8492 \addtocounter{prosemodulo}{1}%
8493 \ifx\modulolinenumbers\undefined%
8494 \relax\else
8495 \modulolinenumbers[\value{prosemodulo}]% if lineno is called
8496 \fi
8497 \newif\ifinprosesection
8498 \newenvironment{prosesection}
8499 {\inprosesectiontrue\resetlinenumber\begin{linenumbers}%
8500 \renewcommand{\linenumberfont}{\scriptsize}%
8501 \ifnumbersright\rightlinenumbers*\setlength{\linenumbersep}{-\marginparsep}%
8502 %\else\ifnumbersswitch\switchlinenumbers\setlength{\linenumbersep}{\marginparsep}%
8503 \else\ifnumbersswitch\rightlinenumbers*\setlength{\linenumbersep}{-\marginparsep}%
8504 \else\leftlinenumbers*\setlength{\linenumbersep}{\marginparsep}%
8505 \addtolength{\linenumbersep}{5pt}% seems about right
8506 \fi\fi
8507 \noemendyettrue%
8508 \noexplainyettrue%
8509 }
8510 {\end{linenumbers}\inprosesectionfalse}
8511 \newenvironment{prosesectionnoreset}
8512 {\begin{linenumbers}%
8513 \renewcommand{\linenumberfont}{\scriptsize}
8514 \ifnumbersright\rightlinenumbers*\setlength{\linenumbersep}{-\marginparsep}%
8515 %\else\ifnumbersswitch\switchlinenumbers\setlength{\linenumbersep}{\marginparsep}%
8516 \else\ifnumbersswitch\rightlinenumbers*\setlength{\linenumbersep}{-\marginparsep}%
8517 \else\leftlinenumbers*\setlength{\linenumbersep}{\marginparsep}%
8518 \addtolength{\linenumbersep}{5pt}% seems about right
8519 \fi\fi
8520 % \noemendyettrue%
8521 % \noexplainyettrue%
8522 }{\end{linenumbers}}
8523 % \end{macrocode}
8524 %
8525 % Set up commands for notes sections.
8526 % \begin{macro}{\setproselemmastart}
8527 % Finds the line number at the beginning of a lemma. Thanks to Robin
8528 % Fairbairns and Heiko Oberdiek for |\ifrefundefined|.
8529 % Fairbairns version
8530 % \begin{macrocode}
8531 % \newcommand*\ifrefundefined[1] {%
8532 % Ê Ê\expandafter\ifx\csname r@#1\endcsname\relax
8533 % }
8534 % Oberdiek version
8535 \makeatletter
8536 \newcommand*{\ifrefundefined}[1]{%
8537 \expandafter\ifx\csname r@#1\endcsname\relax
8538 \expandafter\@firstoftwo
8539 \else
8540 \expandafter\@secondoftwo
8541 \fi
8542 }
8543 \newcommand*{\@extract@ref}[2]{%
8544 \expandafter\expandafter\expandafter#1\csname
8545 r@#2\endcsname{}{}\@nil
8546 }
8547
8548 \newcommand*{\@extractref}{%
8549 \@extract@ref\@car
8550 }
8551
8552 \newcommand*{\@extractpageref}{%
8553 \@extract@ref\@secondcar
8554 }
8555
8556 \long\def\@secondcar#1#2#3\@nil{#2}
8557
8558 \newcommand*{\setcounterfromref}[2]{%
8559 \ifrefundefined{#2}{%
8560 \protect\G@refundefinedtrue
8561 \@latex@warning{Reference `#2' on page \thepage \space
8562 undefined}%
8563 \setcounter{#1}{0}%
8564 }{%
8565 \setcounter{#1}{\@extractref{#2}}%
8566 }%
8567 }
8568 \newcommand*{\setcounterfrompageref}[2]{%
8569 \ifrefundefined{#2}{%
8570 \protect\G@refundefinedtrue
8571 \@latex@warning{Reference `#2' on page \thepage \space
8572 undefined}%
8573 \setcounter{#1}{0}%
8574 }{%
8575 \setcounter{#1}{\@extractpageref{#2}}%
8576 }%
8577 }
8578 %
8579 \makeatother
8580 \newcommand{\setproselemmastart}[1]{%
8581 \unskip
8582 \setcounterfromref{proselinenumber}{#1}}
8583 % \end{macrocode}
8584 % \end{macro}
8585 % \begin{macro}{\setproselemmarange}
8586 % Finds the end of a multi-line lemma.
8587 % \begin{macrocode}
8588 % \newcommand{\setproselemmarange}[2]{%
8589 % \setproselemmastart{#1}%
8590 % \setcounter{lemmalines}{#2}%
8591 % \ifthenelse{\equal{\value{lemmalines}}{0}}{\rangelemmafalse}{\rangelemmatrue}%
8592 % \setcounter{lemmaend}{\theproselinenumber}%
8593 % \addtocounter{lemmaend}{\thelemmalines}\unskip%
8594 % }
8595 \newcommand{\setproselemmarange}[2]{%
8596 \setproselemmastart{#1}%
8597 \pmccheckifinteger{#2}%
8598 \ifinteger
8599 \setcounter{lemmalines}{#2}%
8600 \ifthenelse{\equal{\value{lemmalines}}{0}}{\rangelemmafalse}{\rangelemmatrue}%
8601 \setcounter{lemmaend}{\theproselinenumber}%
8602 \addtocounter{lemmaend}{\thelemmalines}\unskip%
8603 \else
8604 % \ref{#2}
8605 \setcounterfromref{lemmaend}{#2}\rangelemmatrue
8606 \fi\unskip
8607 }
8608 % \end{macrocode}
8609 % \end{macro}
8610 % \begin{macro}{\proseciterange}
8611 % Sets the range note for in a multi-line lemma.
8612 % \begin{macrocode}
8613 \newcommand{\proseciterange}{%
8614 \ifrangelemma%
8615 \theproselinenumber --\thelemmaend%
8616 \else%
8617 \theproselinenumber%
8618 \fi}
8619 % \end{macrocode}
8620 % \end{macro}
8621 % \begin{macro}{\checkprosenoteheaders}
8622 % Updates running header for note sections. Typesets line number in
8623 % notes.
8624 % \begin{macrocode}
8625 \newcommand{\checkprosenoteheaders}{\string\setcounter\string{notepageholdernote\string}%
8626 \string{\thepage\string}\string\ifhmode\string\unskip\string\fi
8627 \string\ifthenelse\string{\string\value\string{notepageholdernote\string}>
8628 \string\value\string{notepageholdertitle\string}\string}%
8629 \string{\string\mark\string{\string\thenotepageholdernote\string}\string}%
8630 \string{\string\mark\string{\string\thenotepageholdertitle\string}\string}\string\unskip
8631 \string\unskip\string\relax\ \proseciterange :\string~\string\nolinebreak}%
8632 % \end{macrocode}
8633 % \end{macro}
8634 % \begin{macro}{\prosetextnote}
8635 % \begin{macrocode}
8636 \newcommand{\proselinelabel}[1]{\ifhmode\unskip\fi\linelabel{#1}}
8637 \newcommand{\prosetextnote}[3][0]{%
8638 \iftextnoteson%
8639 \unskip\proselinelabel{#2}%
8640 \setproselemmarange{#2}{#1}%
8641 \immediate\write\textnotes{\checkprosenoteheaders}%
8642 \literaltextnote{#3}%
8643 \iftextnotessinglepar%
8644 \literaltextnote{\par}%
8645 \fi%
8646 \resetlemmacounters%
8647 \fi\unskip%
8648 }
8649 % \end{macrocode}
8650 % \end{macro}
8651 % \begin{macro}{\proseemendation}
8652 % Notice that it calls |\firstemendation| as usual.
8653 % \begin{macrocode}
8654 \newcommand{\proseemendation}[3][0]{%
8655 \ifemendationson%
8656 \unskip\proselinelabel{#2}%
8657 \setproselemmarange{#2}{#1}%
8658 \ifredundantemendations
8659 \iftextnoteson
8660 \ifrangelemma
8661 \prosetextnote[#1]{#2}{#3}%
8662 \else
8663 \prosetextnote{#2}{#3}%
8664 \fi % ifrangelemma}
8665 \fi %iftextnoteson
8666 \iftextnotessinglepar%
8667 \literaltextnote{\par}%
8668 \fi% iftextnotessinglepar
8669 \fi % ifredundantemendations
8670 \ifnoemendyet % firstemendation
8671 \firstemendation
8672 \fi%noemendyet
8673 \global\noemendyetfalse
8674 \immediate\write\emendations{\checkprosenoteheaders}%
8675 \literalemend{#3}%
8676 \ifemendationssinglepar%
8677 \literalemend{\par}%
8678 \fi% ifemendationssinglep
8679 \resetlemmacounters%
8680 \fi\unskip%
8681 }
8682 % \end{macrocode}
8683 % \end{macro}
8684 % \begin{macro}{\proseexplanatory}
8685 % \begin{macrocode}
8686 \newcommand{\proseexplanatory}[3][0]{%
8687 \ifexplanon%
8688 \unskip\proselinelabel{#2}%
8689 \setproselemmarange{#2}{#1}%
8690 \ifnoexplainyet% firstexplanation
8691 \firstexplanatory%
8692 \fi%noexplainyet
8693 \global\noexplainyetfalse%
8694 \immediate\write\explanations{\checkprosenoteheaders}%
8695 \literalexplain{#3}%
8696 \ifexplanationssinglepar%
8697 \literalexplain{\par}%
8698 \fi% ifexplanationssinglepar
8699 \resetlemmacounters%
8700 \fi\unskip%
8701 }
8702 % \end{macrocode}
8703 % \end{macro}
8704 % \begin{macro}{\proseaccidental}
8705 % \begin{macrocode}
8706 \newcommand{\proseaccidental}[2]{
8707 \iftextnoteson
8708 \ifincludeaccidentals
8709 \immediate\write\textnotes{\string\nobreak}%
8710 \prosetextnote{#1}{#2}%
8711 \immediate\write\textnotes{\string\nobreak}%
8712 \iftextnotessinglepar%
8713 \literaltextnote{\par}%
8714 \fi%
8715 \fi\fi
8716 }
8717 \newcommand{\prosetsvariant}[3][0]{\iftextnoteson
8718 \ifincludetypescripts
8719 \immediate\write
8720 \textnotes{\string\nobreak}%
8721 \prosetextnote[#1]{#2}{#3}%
8722 \immediate\write\textnotes{\string\nobreak}%
8723 \iftextnotessinglepar%
8724 \literaltextnote{\par}%
8725 \fi%
8726 \fi\fi
8727 }
8728 \newcommand{\prosetsaccidental}[2]{\iftextnoteson
8729 \ifincludetypescripts\proseaccidental{#1}{#2}\fi\fi}
8730 % \end{macrocode}
8731 % \end{macro}
8732 % \subsection{~Annotation by Sentence and Paragraph Number}
8733 % Marking sentences. First, some |\if|s, token lists, and counters.
8734 % \begin{macrocode}
8735 \newif{\ifprosebysentence}
8736 \newif{\ifrunningsentencenumbers}\runningsentencenumberstrue
8737 \newif{\ifmarginsentencenumbers}\marginsentencenumberstrue
8738 \newif{\ifsuppressfirstpara}\suppressfirstparafalse
8739 \newif{\ifsuppressfirstsentence}\suppressfirstsentencefalse
8740
8741 \newtoks{\pmnoteheader}
8742
8743 \newcounter{pmsentencenumber}\setcounter{pmsentencenumber}{0}
8744 \newcounter{pmmodulo}\setcounter{pmmodulo}{3}
8745 \newcounter{pmindexcount}\setcounter{pmindexcount}{0}
8746 % \end{macrocode}
8747 % A starter. Mostly a placeholder. For changes to a whole section.
8748 % \begin{macrocode}
8749 \newcommand{\setprosebysentence}{\prosebysentencetrue%
8750 }
8751 \newenvironment{pmsection}{
8752 \noemendyettrue%
8753 \noexplainyettrue%
8754 }{}
8755 % \end{macrocode}
8756 % Formatting for sentence numbers in the running text and in the
8757 % margin. \label{runningsentencenumberformat}
8758 % \begin{macrocode}
8759 \newcommand{\runningsentencenumberformat}[1]{\nobreak%
8760 \ifsuppressfirstsentence%
8761 \ifthenelse{\thepmsentencenumber=1}{\relax}{%
8762 \unskip\textsuperscript{\scriptsize{#1}}}%
8763 \unskip\nobreak%
8764 \else%
8765 \textsuperscript{\scriptsize{#1}}%\fi
8766 \unskip\nobreak}
8767 \newcommand{\marginsentencenumberformat}[1]{\scriptsize{#1}}
8768 \newcommand{\setpmmodulo}[1]{\setcounter{pmmodulo}{#1}%
8769 \addtocounter{pmmodulo}{-1}%
8770 }
8771 \newcommand{\pmnumberstoleft}{%\catcode`\@=11%
8772 \numbersswitchfalse\numbersrightfalse%
8773 \setlength{\marginparsep}{18pt}%
8774 }
8775 \newcommand{\pmnumberstoright}{%\catcode`\@=11%
8776 \numbersswitchfalse\numbersrighttrue%
8777 \setlength{\marginparsep}{-18pt}
8778 % \setlength{\marginparsep}{18pt}
8779 }
8780 \newcommand{\pmnumbersswitch}{\strictpagechecktrue\numbersswitchtrue\numbersrightfalse%
8781 \setlength{\marginparsep}{18pt}%
8782 }
8783 \newcommand{\pmnumbersgutter}{%\catcode`\@=11%
8784 \pmnumbersswitch%
8785 \pmclreversesideparfalse\numbersguttertrue%
8786 \setlength{\marginparsep}{18pt}%
8787 }
8788 \newcommand{\pmnumbersouter}{%\catcode`\@=11%
8789 \pmnumbersswitch%
8790 \pmclreversesidepartrue\numbersgutterfalse%
8791 \setlength{\marginparsep}{18pt}%
8792 }
8793 % \end{macrocode}
8794 % Macros for actually writing the numbers in the margin.
8795 % \begin{macrocode}
8796 \newcommand{\putpmsentencenumber}{%
8797 \ifsuppressfirstsentence%
8798 \ifthenelse{\thepmsentencenumber=1}{\relax}{\putpmmarginnumber{\thepmsentencenumber}%
8799 {\marginsentencenumberformat}}%
8800 \else%
8801 \putpmmarginnumber{\thepmsentencenumber}%
8802 {\marginsentencenumberformat}%
8803 \fi}
8804 \newcommand{\putpmmarginnumber}[2]{%
8805 \nolinebreak\begin{marginenvironment}%
8806 \nolinebreak%
8807 \ifnumbersswitch%\marginpar{\hfil #2{#1}}
8808 \pmclsidepar{\hfil #2{#1}}%
8809 \else%
8810 \ifnumbersright%\marginpar{\hfil #2{#1}}
8811 \pmclrightsidepar{\hfil #2{#1}}%
8812 \else% \marginpar{#2{#1}\hfil}
8813 \pmclleftsidepar
8814 {#2{#1}\hfil}%
8815 \fi%
8816 \fi%
8817 \nolinebreak%
8818 \end{marginenvironment}\nolinebreak%
8819 }
8820 % \end{macrocode}
8821 % \begin{macro}{\pmsentence}
8822 % Put this before every sentence. (This is the opposite of the
8823 % convention in verse sections, where |\verseline| is at the end of
8824 % each line.
8825 % \begin{macrocode}
8826 \newcommand{\pmsentence}{%
8827 % increment sentence number at beginning of sentence
8828 \addtocounter{pmsentencenumber}{1}%
8829 \ifrunningsentencenumbers% add running number
8830 \runningsentencenumberformat{\thepmsentencenumber}%
8831 \fi%
8832 \ifmarginsentencenumbers% add marginal number
8833 \addtocounter{pmindexcount}{1}%
8834 \leavevmode%
8835 \ifthenelse{\value{pmindexcount}>\value{pmmodulo}}%
8836 {\putpmsentencenumber\nobreak%
8837 \setcounter{pmindexcount}{0}%
8838 }{\relax}%
8839 \fi%
8840 % create header for notes if any are to occur
8841 \ifpmparas%
8842 \global\edef\noteheaderconcat{\thepmparagraph:\thepmsentencenumber}%
8843 \pmnoteheader=\expandafter{\noteheaderconcat}%
8844 \else%
8845 %\global\edef\noteheaderconcat{\thepmsentencenumber:}%
8846 \global\edef\noteheaderconcat{\thepmsentencenumber}
8847 \pmnoteheader=\expandafter{\noteheaderconcat}%
8848 \fi%
8849 }
8850 % \end{macrocode}
8851 % \end{macro}
8852 % \begin{macro}{\pmsentencetwo}
8853 % Kludge for the second sentence in a line.
8854 % \begin{macrocode}
8855 \newcommand{\pmsentencetwo}{%
8856 % increment sentence number at beginning of sentence
8857 \addtocounter{pmsentencenumber}{1}%
8858 \ifrunningsentencenumbers% add running number
8859 \runningsentencenumberformat{\thepmsentencenumber}%
8860 \fi%
8861 \ifmarginsentencenumbers% add marginal number
8862 \addtocounter{pmindexcount}{1}%
8863 \leavevmode%
8864 \ifthenelse{\value{pmindexcount}>\value{pmmodulo}}%
8865 { \putpmsentencenumbertwo\nobreak%
8866 \setcounter{pmindexcount}{0}%
8867 }{\relax}%
8868 % \ifnum\thepmindexcount>\thepmmodulo%
8869 % \putpmsentencenumbertwo\nobreak%
8870 % \setcounter{pmindexcount}{0}%
8871 % \fi%
8872 \fi%
8873 % create header for notes if any are to occur
8874 \ifpmparas%
8875 \global\edef\noteheaderconcat{\thepmparagraph:\thepmsentencenumber}%
8876 \pmnoteheader=\expandafter{\noteheaderconcat}%
8877 \else%
8878 \global\edef\noteheaderconcat{\thepmsentencenumber}%
8879 \pmnoteheader=\expandafter{\noteheaderconcat}%
8880 \fi%
8881 }
8882
8883 \newcommand{\putpmsentencenumbertwo}{%
8884 \putpmmarginnumber{\rlap{\phantom{1},~\thepmsentencenumber}}%
8885 {\marginsentencenumberformat}}
8886 % \end{macrocode}
8887 % \end{macro}
8888 % \begin{macro}{\pmsentencethree}
8889 % Kludge for the third sentence in a line.
8890 % \begin{macrocode}
8891 \newcommand{\pmsentencethree}{%
8892 % increment sentence number at beginning of sentence
8893 \addtocounter{pmsentencenumber}{1}%
8894 \ifrunningsentencenumbers% add running number
8895 \runningsentencenumberformat{\thepmsentencenumber}%
8896 \fi%
8897 \ifmarginsentencenumbers% add marginal number
8898 \addtocounter{pmindexcount}{1}%
8899 \leavevmode%
8900 \ifthenelse{\value{pmindexcount}>\value{pmmodulo}}%
8901 { \putpmsentencenumberthree\nobreak%
8902 \setcounter{pmindexcount}{0}%
8903 }{\relax}%
8904 % \ifnum\thepmindexcount>\thepmmodulo%
8905 % \putpmsentencenumberthree\nobreak%
8906 % \setcounter{pmindexcount}{0}%
8907 % \fi%
8908 \fi%
8909 % create header for notes if any are to occur
8910 \ifpmparas%
8911 \global\edef\noteheaderconcat{\thepmparagraph:\thepmsentencenumber}%
8912 \pmnoteheader=\expandafter{\noteheaderconcat}%
8913 \else%
8914 \global\edef\noteheaderconcat{\thepmsentencenumber}%
8915 \pmnoteheader=\expandafter{\noteheaderconcat}%
8916 \fi%
8917 }
8918
8919 \newcommand{\putpmsentencenumberthree}{%
8920 \putpmmarginnumber{\rlap{\phantom{1,~2},~\thepmsentencenumber}}%
8921 {\marginsentencenumberformat}}
8922 % \end{macrocode}
8923 % \end{macro}
8924 % \begin{macro}{\pmsentencefour}
8925 % \begin{macrocode}
8926 \newcommand{\pmsentencefour}{%
8927 % increment sentence number at beginning of sentence
8928 \addtocounter{pmsentencenumber}{1}%
8929 \ifrunningsentencenumbers% add running number
8930 \runningsentencenumberformat{\thepmsentencenumber}%
8931 \fi%
8932 \ifmarginsentencenumbers% add marginal number
8933 \addtocounter{pmindexcount}{1}%
8934 \leavevmode%
8935 \ifthenelse{\value{pmindexcount}>\value{pmmodulo}}%
8936 { \putpmsentencenumberfour\nobreak%
8937 \setcounter{pmindexcount}{0}%
8938 }{\relax}%
8939 \fi%
8940 % create header for notes if any are to occur
8941 \ifpmparas%
8942 \global\edef\noteheaderconcat{\thepmparagraph:\thepmsentencenumber}%
8943 \pmnoteheader=\expandafter{\noteheaderconcat}%
8944 \else%
8945 \global\edef\noteheaderconcat{\thepmsentencenumber}%
8946 \pmnoteheader=\expandafter{\noteheaderconcat}%
8947 \fi%
8948 }
8949
8950 \newcommand{\putpmsentencenumberfour}{%
8951 \putpmmarginnumber{\rlap{\phantom{1,~2,~3},~\thepmsentencenumber}}%
8952 {\marginsentencenumberformat}}
8953
8954 % \end{macrocode}
8955 % \end{macro}
8956 % Macros for numbering paragraphs
8957 % \begin{macrocode}
8958 \newcounter{pmparagraph}
8959 \setcounter{pmparagraph}{0}
8960 \newif{\ifpmparas}\pmparasfalse
8961 \newif{\ifpmparainmar}\pmparainmartrue
8962 \newif{\ifpmpararunning}\pmpararunningfalse
8963 \newif{\ifpmsentencebypara}% reset sentence counter every paragraph
8964 \pmsentencebyparatrue
8965 % \end{macrocode}
8966 % Formatting marginal and running paragraph numbers, printing them. \label{pmparrunningformat}
8967 % \begin{macrocode}
8968 \newcommand{\pmparmarformat}[1]{\textbf{{\small #1}}}
8969 \newcommand{\pmpararunningformat}[1]{%
8970 \ifsuppressfirstpara%
8971 \ifthenelse{\thepmparagraph=1}{\relax}{\textbf{\small #1}~}%
8972 \else%
8973 \textbf{\small #1}~%
8974 \fi}
8975 \newcommand{\putpmmarparanumber}{%
8976 \ifsuppressfirstpara%
8977 \ifthenelse{\thepmparagraph=1}{\relax}{\putpmmarginnumber{\llap{\thepmparagraph~~}}
8978 {\pmparmarformat}}%
8979 \else%
8980 \putpmmarginnumber{\llap{\thepmparagraph~~}}{\pmparmarformat}%
8981 \fi}
8982
8983 % \end{macrocode}
8984 % \begin{macro}{\pmpara}
8985 % Mark the beginning of each paragraph with |\pmpara|
8986 % \begin{macrocode}
8987 \newcommand{\pmpara}{\leavevmode%
8988 \pmparastrue\addtocounter{pmparagraph}{1}%
8989 \ifpmparainmar% put in marginal paragraph number
8990 \putpmmarparanumber
8991 \fi
8992 \ifpmpararunning% put in running number
8993 \pmpararunningformat{\thepmparagraph}%
8994 \fi
8995 \ifpmsentencebypara% reset sentence counter
8996 \setcounter{pmsentencenumber}{0}%
8997 \setcounter{pmindexcount}{0}%
8998 \fi}
8999 % \end{macrocode}
9000 % \end{macro}
9001 % \begin{macro}{\sentencelabel}
9002 % Makes a label either by sentence number or by paragraph and
9003 % sentence number, for use by |\ref| and by the various notes commands.
9004 % \begin{macrocode}
9005 \makeatletter
9006 \def\sentencelabel#1{\@bsphack%
9007 \ifpmparas%
9008 \protected@write\@auxout{}%
9009 {\string\newlabel{#1}{{\thepmparagraph :\thepmsentencenumber}{\thepage}}}%
9010 \else%
9011 \protected@write\@auxout{}%
9012 {\string\newlabel{#1}{{\thepmsentencenumber}{\thepage}}}%
9013 \fi%
9014 \@esphack%
9015 }
9016 \makeatother
9017 % \end{macrocode}
9018 % \end{macro}
9019 % Macros to set up endnote commands for paragraph and sentence
9020 % annotation.
9021 % \begin{macrocode}
9022 \newtoks{\pmrangeend} % for notes that refer to ranges
9023 % setting the range for the lemma:
9024 \newcommand{\setpmlemmarange}[1]{%
9025 \pmccheckifinteger{#1}%
9026 \ifinteger%
9027 \setcounter{lemmalines}{#1}%
9028 \ifthenelse{\equal{\value{lemmalines}}{0}}{\rangelemmafalse}{\rangelemmatrue}%
9029 \setcounter{lemmaend}{\thepmsentencenumber}%
9030 \addtocounter{lemmaend}{\thelemmalines}%
9031 \pmrangeend={\thelemmaend}%
9032 \else%
9033 \pmrangeend={\ref{#1}}\rangelemmatrue%
9034 \fi%
9035 }
9036 % Setting the string to include ranges in notes:
9037 \newcommand{\pmciterange}{%
9038 \ifrangelemma{\the\pmnoteheader --\the\pmrangeend:}%
9039 \else%
9040 \the\pmnoteheader:%
9041 \fi}
9042 % For running headers
9043 \newcommand{\pmchecknoteheaders}{\string\setcounter\string{notepageholdernote\string}%
9044 \string{\thepage\string}\string\ifhmode\string\unskip\string\fi
9045 \string\ifthenelse\string{\string\value\string{notepageholdernote\string}>
9046 \string\value\string{notepageholdertitle\string}\string}%
9047 \string{\string\mark\string{\string\thenotepageholdernote\string}\string}%
9048 \string{\string\mark\string{\string\thenotepageholdertitle\string}\string}\string\unskip}
9049 % to reset lemma counters at end of note
9050 \newcommand{\pmresetlemmacounters}{\rangelemmafalse%
9051 \setcounter{lemmalines}{0}%
9052 \setcounter{lemmaend}{0}%
9053 \pmrangeend={\relax}%
9054 }
9055 % \end{macrocode}
9056 % \begin{macro}{\pmtextnote}
9057 % \begin{macrocode}
9058 \newcommand{\pmtextnote}[2][0]{%
9059 \iftextnoteson%
9060 \setpmlemmarange{#1}%
9061 \immediate\write\textnotes{\pmchecknoteheaders\string~}%
9062 \immediate\write\textnotes{\pmciterange}%
9063 \literaltextnote{#2}%
9064 \iftextnotessinglepar%
9065 \literaltextnote{\par}%
9066 \fi%
9067 \fi%
9068 \pmresetlemmacounters%
9069 \unskip}
9070 % \end{macrocode}
9071 % \end{macro}
9072 % \begin{macro}{\pmexplanatory}
9073 % \begin{macrocode}
9074 \newcommand{\pmexplanatory}[2][0]{%
9075 \ifexplanon%
9076 \setpmlemmarange{#1}%
9077 \ifnoexplainyet % first explanation
9078 \firstexplanatory%
9079 \fi %noexplainyet
9080 \global\noexplainyetfalse%
9081 \immediate\write\explanations{\pmchecknoteheaders\string~}%
9082 \immediate\write\explanations{\pmciterange}%
9083 \literalexplain{#2}%
9084 \ifexplanationssinglepar%
9085 \literalexplain{\par}%
9086 \fi %ifexplanationssinglepar
9087 \fi % ifexplanon
9088 \pmresetlemmacounters%
9089 \unskip%
9090 }
9091 % \end{macrocode}
9092 % \end{macro}
9093 % \begin{macro}{\pmemendation}
9094 % \begin{macrocode}
9095 \newcommand{\pmemendation}[2][0]{%
9096 \ifemendationson%
9097 \setpmlemmarange{#1}%
9098 \ifredundantemendations%
9099 \iftextnoteson%
9100 \ifrangelemma%
9101 \pmtextnote[#1]{#2}%
9102 \else%
9103 \pmtextnote{#2}%
9104 \fi % ifrangelemma}
9105 \fi %iftextnoteson
9106 \fi % ifredundantemendations
9107 \ifnoemendyet % firstemendation
9108 \firstemendation%
9109 \fi %noemendyet
9110 \global\noemendyetfalse%
9111 \immediate\write\emendations{\pmchecknoteheaders\string~}%
9112 \immediate\write\emendations{\pmciterange}%
9113 \literalemend{#2}%
9114 \ifemendationssinglepar%
9115 \literalemend{\par}%
9116 \fi% ifemendationssinglepar
9117 \fi % ifemendationson
9118 \pmresetlemmacounters%
9119 }
9120 % \end{macrocode}
9121 % \end{macro}
9122 % \begin{macro}{\pmaccidental}
9123 % \begin{macrocode}
9124 \newcommand{\pmaccidental}[1]{%
9125 \iftextnoteson%
9126 \ifincludeaccidentals%
9127 \immediate\write\textnotes{\string\nobreak}%
9128 \pmtextnote{#1}%
9129 \immediate\write\textnotes{\string\nobreak}%
9130 \iftextnotessinglepar%
9131 \literaltextnote{\par}%
9132 \fi%
9133 \fi\fi%
9134 }
9135 % \end{macrocode}
9136 % \end{macro}
9137 % \begin{macro}{\pmtsvariant}
9138 % \begin{macrocode}
9139 \newcommand{\pmtsvariant}[2][0]{\iftextnoteson%
9140 \ifincludetypescripts%
9141 \immediate\write\textnotes{\string\nobreak}%
9142 \pmtextnote[#1]{#2}%
9143 \immediate\write\textnotes{\string\nobreak}%
9144 \iftextnotessinglepar%
9145 \literaltextnote{\par}%
9146 \fi%
9147 \fi\fi%
9148 }
9149 \newcommand{\pmtsaccidental}[1]{\iftextnoteson\ifincludetypescripts\pmaccidental{#1}\fi\fi}
9150 % \end{macrocode}
9151 % \end{macro}
9152 %\subsection{~Using Footnotes} |\texnotesatfoot| has to redefine
9153 % |\sources| and a few others as well.
9154 % \begin{macro}{\textnotesatfoot}
9155 % \begin{macrocode}
9156 \newcommand{\textnotesatfoot}{% first redefine textnotes
9157 \global\textnotesontrue%
9158 \global\textnotesatendfalse%
9159 \ifsourcesfootnotespara%
9160 \DeclareNewFootnote[para]{A}%
9161 \else%
9162 \DeclareNewFootnote[plain]{A}%
9163 \fi%
9164 \iftextfootnotespara%
9165 \DeclareNewFootnote[para]{B}%
9166 \else%
9167 \DeclareNewFootnote[plain]{B}%
9168 \fi%
9169 \renewcommand{\textnote}[2][0]{\setlemmarange{##1}%
9170 \FootnotetextB{\relax}{\citerange:~##2}%
9171 \resetlemmacounters}%
9172 % then redefine sources
9173 \renewcommand{\sources}[1]{\FootnotetextA{\relax}{##1}}%
9174 % then prose textnote
9175 \renewcommand{\prosetextnote}[3][0]{%
9176 \unskip\proselinelabel{##2}%
9177 \setproselemmarange{##2}{##1}%
9178 \FootnotetextB{\relax}{\proseciterange:~##3}\resetlemmacounters}%
9179 % then pmtextnote
9180 \renewcommand{\pmtextnote}[2][0]{\setpmlemmarange{##1}%
9181 \FootnotetextB{\relax}{\pmciterange~##2}\pmresetlemmacounters}
9182 }
9183 % \end{macrocode}
9184 % \end{macro}
9185 % \begin{macro}{\emendationsatfoot}
9186 % \begin{macrocode}
9187 \newcommand{\emendationsatfoot}{%
9188 \global\emendationsontrue%
9189 \global\emendationsatendfalse%
9190 \ifemendationfootnotespara%
9191 \DeclareNewFootnote[para]{C}%
9192 \else%
9193 \DeclareNewFootnote[plain]{C}%
9194 \fi%
9195 \renewcommand{\emendation}[2][0]{\setlemmarange{##1}%
9196 \FootnotetextC{\relax}{\citerange:~##2}%
9197 \resetlemmacounters}%
9198 \renewcommand{\proseemendation}[3][0]{\unskip\proselinelabel{##2}%
9199 \setproselemmarange{##2}{##1}%
9200 \FootnotetextC{\relax}{\proseciterange:~##3}\resetlemmacounters}%
9201 \renewcommand{\pmemendation}[2][0]{\setpmlemmarange{##1}%
9202 \FootnotetextC{\relax}{\pmciterange~##2}\pmresetlemmacounters}
9203 }
9204 % \end{macrocode}
9205 % \end{macro}
9206 % \begin{macro}{\explanationsatfoot}
9207 % \begin{macrocode}
9208 \newcommand{\explanationsatfoot}{%
9209 \global\explanontrue%
9210 \global\explanatendfalse%
9211 \ifexplanfootnotespara%
9212 \DeclareNewFootnote[para]{D}%
9213 \else%
9214 \DeclareNewFootnote[plain]{D}%
9215 \fi%
9216 \renewcommand{\explanatory}[2][0]{\setlemmarange{##1}%
9217 \FootnotetextD{\relax}{\citerange:~##2}%
9218 \resetlemmacounters}%
9219 \renewcommand{\proseexplanatory}[3][0]{\unskip\proselinelabel{##2}%
9220 \setproselemmarange{##2}{##1}%
9221 \FootnotetextD{\relax}{\proseciterange:~##3}}
9222 \renewcommand{\pmexplanatory}[2][0]{\setpmlemmarange{##1}%
9223 \FootnotetextD{\relax}{\pmciterange~##2}\pmresetlemmacounters}%
9224 }
9225 % \end{macrocode}
9226 % \end{macro}
9227 % \begin{macro}{\bibleverse}
9228 % \begin{macrocode}
9229 \newcommand{\bibleverse}{\pmsentence}
9230 \newcommand{\biblechapter}{\pmpara}
9231 % \end{macrocode}
9232 % \end{macro}
9233 %
9234 % \subsection{~Notes at the foot of individual poems}
9235 %
9236 % \begin{macro}{\poemendnote}
9237 % \begin{macrocode}
9238 \newif\ifpoemendnoteson
9239 \poemendnotesontrue
9240 \newif\ifpoemendnotessinglepar
9241 \poemendnotessinglepartrue
9242 \newcommand{\makepoemendnotes}{
9243 \global\verselinenumberstrue
9244 \newwrite\poemendnotes
9245 \immediate\openout\poemendnotes=\jobname.pnd
9246 \literalpoemendnote{\bigskip}
9247 }
9248 \newcommand{\poemendnote}[2][0]{%
9249 \ifpoemendnoteson
9250 \setlemmarange{#1}%
9251 \immediate\write\poemendnotes{\checknoteheaders}
9252 \literalpoemendnote{#2}%
9253 \ifpoemendnotessinglepar%
9254 \literalpoemendnote{\par}%
9255 \fi%
9256 \fi
9257 \resetlemmacounters
9258 }
9259 \newcommand{\literalpoemendnote}[1]{%
9260 \begingroup
9261 \def\next{#1}%
9262 \newlinechar='40
9263 \immediate\write\poemendnotes{\expandafter\strip\meaning\next}%
9264 \endgroup
9265 }
9266 \newcommand{\putpoemendnotes}{
9267 \ifpoemendnoteson
9268 \immediate\closeout\poemendnotes
9269 \input \jobname.pnd
9270 \else
9271 \relax
9272 \fi}
9273 % \begin{macro}{\poemendemendationnote}
9274 % \begin{macrocode}
9275 \newif\ifpoemendemendationnoteson
9276 \poemendemendationnotesontrue
9277 \newif\ifpoemendemendationnotessinglepar
9278 \poemendemendationnotessinglepartrue
9279 \newcommand{\makepoemendemendationnotes}{
9280 \global\verselinenumberstrue
9281 \newwrite\poemendemendationnotes
9282 \immediate\openout\poemendemendationnotes=\jobname.pmd
9283 \literalpoemendemendationnote{\bigskip}
9284 }
9285 \newcommand{\poemendemendationnote}[2][0]{%
9286 \ifpoemendemendationnoteson
9287 \setlemmarange{#1}%
9288 \immediate\write\poemendemendationnotes{\checknoteheaders}
9289 \literalpoemendemendationnote{#2}%
9290 \ifpoemendemendationnotessinglepar%
9291 \literalpoemendemendationnote{\par}%
9292 \fi%
9293 \fi
9294 \resetlemmacounters
9295 }
9296 \newcommand{\literalpoemendemendationnote}[1]{%
9297 \begingroup
9298 \def\next{#1}%
9299 \newlinechar='40
9300 \immediate\write\poemendemendationnotes{\expandafter\strip\meaning\next}%
9301 \endgroup
9302 }
9303 \newcommand{\putpoemendemendationnotes}{
9304 \ifpoemendemendationnoteson
9305 \immediate\closeout\poemendemendationnotes
9306 \input \jobname.pmd
9307 \else
9308 \relax
9309 \fi}
9310 % \end{macrocode}
9311 % \end{macro}
9312 % \begin{macro}{\poemendexplanatorynote}
9313 % \begin{macrocode}
9314 \newif\ifpoemendexplanatorynoteson
9315 \poemendexplanatorynotesontrue
9316 \newif\ifpoemendexplanatorynotessinglepar
9317 \poemendexplanatorynotessinglepartrue
9318 \newcommand{\makepoemendexplanatorynotes}{
9319 \global\verselinenumberstrue
9320 \newwrite\poemendexplanatorynotes
9321 \immediate\openout\poemendexplanatorynotes=\jobname.pxd
9322 \literalpoemendexplanatorynote{\bigskip}
9323 }
9324 \newcommand{\poemendexplanatorynote}[2][0]{%
9325 \ifpoemendexplanatorynoteson
9326 \setlemmarange{#1}%
9327 \immediate\write\poemendexplanatorynotes{\checknoteheaders}
9328 \literalpoemendexplanatorynote{#2}%
9329 \ifpoemendexplanatorynotessinglepar%
9330 \literalpoemendexplanatorynote{\par}%
9331 \fi%
9332 \fi
9333 \resetlemmacounters
9334 }
9335 \newcommand{\literalpoemendexplanatorynote}[1]{%
9336 \begingroup
9337 \def\next{#1}%
9338 \newlinechar='40
9339 \immediate\write\poemendexplanatorynotes{\expandafter\strip\meaning\next}%
9340 \endgroup
9341 }
9342 \newcommand{\putpoemendexplanatorynotes}{
9343 \ifpoemendexplanatorynoteson
9344 \immediate\closeout\poemendexplanatorynotes
9345 \input \jobname.pxd
9346 \else
9347 \relax
9348 \fi}
9349 % \end{macrocode}
9350 % \end{macro}
9351 % \begin{macro}{\poemendtextnote}
9352 % \begin{macrocode}
9353 \newif\ifpoemendtextnoteson
9354 \poemendtextnotesontrue
9355 \newif\ifpoemendtextnotessinglepar
9356 \poemendtextnotessinglepartrue
9357 \newcommand{\makepoemendtextnotes}{
9358 \global\verselinenumberstrue
9359 \newwrite\poemendtextnotes
9360 \immediate\openout\poemendtextnotes=\jobname.pmd
9361 \literalpoemendtextnote{\bigskip}
9362 }
9363 \newcommand{\poemendtextnote}[2][0]{%
9364 \ifpoemendtextnoteson
9365 \setlemmarange{#1}%
9366 \immediate\write\poemendtextnotes{\checknoteheaders}
9367 \literalpoemendtextnote{#2}%
9368 \ifpoemendtextnotessinglepar%
9369 \literalpoemendtextnote{\par}%
9370 \fi%
9371 \fi
9372 \resetlemmacounters
9373 }
9374 \newcommand{\literalpoemendtextnote}[1]{%
9375 \begingroup
9376 \def\next{#1}%
9377 \newlinechar='40
9378 \immediate\write\poemendtextnotes{\expandafter\strip\meaning\next}%
9379 \endgroup
9380 }
9381 \newcommand{\putpoemendtextnotes}{
9382 \ifpoemendtextnoteson
9383 \immediate\closeout\poemendtextnotes
9384 \input \jobname.pmd
9385 \else
9386 \relax
9387 \fi}
9388 % \end{macrocode}
9389 % \end{macro}
9390 % \subsection{~Embarrassing kludges} Because the dirty trick
9391 % mentioned above writes out textnotes as a ribbon one word wide,
9392 % quoted poetry in the notes sections will leave a blank line at the
9393 % end, which will be interpreted as a paragraph break when the file is
9394 % read back in by \LaTeX. These kludges correct that problem.
9395 % \begin{macrocode}
9396 \newcommand{\quotedversecorrectiontextnote}[1][0pt]
9397 {\iftextnoteson%
9398 \immediate\write\textnotes{\string\noindent\string\kern-#1}%
9399 \fi}
9400 \newcommand{\quotedversecorrectionemendation}[1][0pt]
9401 {\ifemendationson%
9402 \immediate\write\emendations{\string\noindent\string\kern-#1}%
9403 \fi}
9404 \newcommand{\quotedversecorrectionexplanatory}[1][0pt]
9405 {\ifexplanon%
9406 \immediate\write\explanations{\string\noindent\string\kern-#1}%
9407 \fi}
9408 % \end{macrocode}
9409 % \subsection{~Marking stanza breaks on page turns} Use the macro
9410 % below to change the symbol used to mark cases in which there is or is
9411 % not a stanza break at a page turn.
9412 % \begin{macrocode}
9413 \newcommand{\stanzaatbottom}[1]{\global\edef\stanzaatbottomvalue{#1}}
9414 \stanzaatbottom{*}
9415 \newcommand{\nostanzaatbottom}[1]{\global\edef\nostanzaatbottomvalue{#1}}
9416 \nostanzaatbottom{\relax}
9417 % \end{macrocode}
9418 % \subsection{~Parallel Texts}
9419 % First, three utility macros from the memoir class:
9420 % \begin{macro}{\cleartorecto}
9421 % A repeat of |\cleardoublepage|; clears to a recto (odd-numbered) page.
9422 % \begin{macrocode}
9423 \def\cleartorecto{\clearpage\if@twoside \ifodd\c@page\else
9424 \hbox{}\thispagestyle{empty}%
9425 \newpage\if@twocolumn\hbox{}\newpage\fi\fi\fi}
9426 % \end{macrocode}
9427 % \end{macro}
9428 %
9429 % \begin{macro}{\cleartoverso}
9430 % Clears to a verso (even-numbered) page.
9431 % \begin{macrocode}
9432 \def\cleartoverso{\clearpage\if@twoside
9433 \ifodd\c@page\hbox{}\thispagestyle{empty}%
9434 \newpage\if@twocolumn\hbox{}\newpage\fi\fi\fi}
9435 % \end{macrocode}
9436 % \end{macro}
9437 %
9438 %
9439 % \begin{macro}{\ifenv}
9440 % Macro for testing whether one is in a particular environment.
9441 % \begin{macrocode}
9442 \makeatletter
9443 \def\ifenv#1{%
9444 \def\reserved@a{#1}%
9445 \ifx\reserved@a\@currenvir
9446 \expandafter\@firstoftwo
9447 \else
9448 \expandafter\@secondoftwo
9449 \fi
9450 }
9451 \makeatother
9452 % \end{macrocode}
9453 % \end{macro}
9454 % Macros for forcing the marginal line numbers to the left side or
9455 % the right side. These marginal line numbers, unlike those made with
9456 % |\marginpar|, do not float. This code is modeled after code from
9457 % the memoir class, by Peter Wilson.
9458 %
9459 % \begin{macro}{\pmclleftsidepar}
9460 % As in the memoir class, these sidepars do not float.
9461 % \begin{macrocode}
9462 \newdimen\pmclsavsk
9463 \newcount\pmclsavsf
9464 \def\pmclbsphack{%
9465 \relax
9466 \ifhmode
9467 \pmclsavsk\lastskip
9468 \pmclsavsf\spacefactor
9469 \fi}
9470 \def\pmclesphack{%
9471 \relax
9472 \ifhmode
9473 \spacefactor\pmclsavsf
9474 \ifdim\pmclsavsk>0pt
9475 \ignorespaces
9476 \fi
9477 \fi}
9478 % \newcommand{\pmclleftsidepar}[1]{%
9479 % \pmclbsphack\leavevmode\vadjust{%
9480 % \rlap{\kern-\parindent%
9481 % \kern -\marginparsep \kern -\marginparwidth % at left
9482 % \vbox to 0pt{%
9483 % \kern \pmclsideparvshift% % vertical shift to align top text lines
9484 % \begin{minipage}{\marginparwidth}%
9485 % #1%
9486 % \end{minipage}%
9487 % \vss}}}\pmclesphack%
9488 % } % version 2.44
9489 \newcommand{\pmclleftsidepar}[1]{%
9490 \pmclbsphack\strut\vadjust{% changed
9491 \rlap{\kern-\parindent%
9492 \kern -\marginparsep \kern -\marginparwidth% at left
9493 % \vbox to 0pt{%
9494 % \kern \pmclsideparvshift% % vertical shift to align top text lines
9495 % \begin{minipage}{\marginparwidth}%
9496 \setbox0=\vtop to 0pt{% added
9497 \begin{minipage}[t]{\marginparwidth}% added
9498 #1%
9499 \end{minipage}%
9500 % \vss}}}\pmclesphack%
9501 \vss}% changed
9502 \vtop to 0pt{\kern\pmclsideparvshift % default should be 0pt
9503 \kern-\dp\strutbox \kern-\ht0 \box0 \vss}}}\pmclesphack}% changed
9504
9505 \newcommand{\pmclrightsidepar}[1]{%
9506 % \pmclbsphack\leavevmode\vadjust{%
9507 \pmclbsphack\strut\vadjust{%
9508 \rlap{\kern-\parindent%
9509 % \kern \textwidth \kern -\marginparsep % at right
9510 \kern\textwidth\kern\marginparsep% at right
9511 % \vbox to 0pt{%
9512 % \kern \pmclsideparvshift% % vertical shift to align top text lines
9513 % \begin{minipage}{\marginparwidth}%
9514 \setbox0=\vtop to 0pt{% added
9515 \begin{minipage}[t]{\marginparwidth}% added
9516 #1%
9517 \end{minipage}%
9518 % \vss}}}\pmclesphack%
9519 \vss}% changed
9520 \vtop to 0pt{\kern\pmclsideparvshift% default should be 0pt
9521 \kern-\dp\strutbox \kern-\ht0 \box0 \vss}}}\pmclesphack}% changed
9522
9523 % \end{macrocode}
9524 % \end{macro}
9525
9526 % Booleans for parallel texts
9527 % \begin{macrocode}
9528 \newif\ifparalleltexts
9529 \paralleltextsfalse
9530 \newif\ifrecto
9531 \rectofalse
9532 \newif\ifverso
9533 \versofalse
9534 % \end{macrocode}
9535 % Booleans are needed to describe situations in which poems and stanzas
9536 % are left open at the page break. |\finishrectopage| and
9537 % |\finishversopage| will close poems and stanzas (so as not to
9538 % generate errors because of environments left open), although as far
9539 % as the poem is concerned the stanza or poem may still be open. (I
9540 % will say that the stanza or poem in such a case is ``artificially
9541 % closed.'') There are two of them for each case of artificial closure.
9542 % The first boolean (for each stanza or poem artificially closed)
9543 % must reflect whether the stanza or poem has been (artificially)
9544 % closed, to reopen on the next page of the same kind (recto or verso).
9545 % If a poem or stanza has been (artificially) closed, the |\mark| will
9546 % not be changed (so that it will still reflect whether the reader
9547 % should understand there to be a stanza break at the bottom of the
9548 % page or not). The second boolean for each case of artificial closure
9549 % reflects whether the |\mark| has been changed or not.
9550 % \begin{macrocode}
9551 \newif\ifrectopoempending
9552 \rectopoempendingfalse
9553 \newif\ifversopoempending
9554 \versopoempendingfalse
9555 \newif\ifrectostanzapending
9556 \rectostanzapendingfalse
9557 \newif\ifversostanzapending
9558 \versostanzapendingfalse
9559 \newif\ifrectostanzastillopen
9560 \rectostanzastillopenfalse
9561 \newif\ifversostanzastillopen
9562 \versostanzastillopenfalse
9563 \newif\ifrectopoemstillopen
9564 \rectopoemstillopenfalse
9565 \newif\ifversopoemstillopen
9566 \versopoemstillopenfalse
9567 % the same for prose sections
9568 \newif\ifrectoprosesectionpending
9569 \rectoprosesectionpendingfalse
9570 \newif\ifversoprosesectionpending
9571 \versoprosesectionpendingfalse
9572 \newif\ifrectoprosesectionstillopen
9573 \rectoprosesectionstillopenfalse
9574 \newif\ifversoprosesectionstillopen
9575 \versoprosesectionstillopenfalse
9576 % the same for quoted verse
9577 \newif\ifrectoquotedversepending
9578 \rectoquotedversependingfalse
9579 \newif\ifversoquotedversepending
9580 \versoquotedversependingfalse
9581 \newif\ifrectoquotedversestillopen
9582 \rectoquotedversestillopenfalse
9583 \newif\ifversoquotedversestillopen
9584 \versoquotedversestillopenfalse
9585 % \end{macrocode}
9586 % A further set of booleans is required for emendations and
9587 % explanatory notes. Again the idea is that if a poem is artificially
9588 % closed, but has already had its first emendation or explanatory note
9589 % written to the external notes files, \textsf{poemscol} will remember that
9590 % the next emendation or explanatory note it sees is not the first one
9591 % for that poem and thus won't set the heading information for that
9592 % poem in the notes section all over again.
9593 % \begin{macrocode}
9594 \newif\ifrectoemendationspending
9595 \rectoemendationspendingfalse
9596 \newif\ifversoemendationspending
9597 \versoemendationspendingfalse
9598 \newif\ifrectoexplanationspending
9599 \rectoexplanationspendingfalse
9600 \newif\ifversoexplanationspending
9601 \versoexplanationspendingfalse
9602 % \end{macrocode}
9603 % Counters for parallel texts: New counters are needed, not only for the recto and verso lines, but
9604 % also for the scratch value which determines whether or not it is time to
9605 % output a marginal line number. These are saved at the end of every
9606 % page, and restored at the beginning of every page of the same kind.
9607 % \begin{macrocode}
9608 \newcounter{rectolinecounter}
9609 \setcounter{rectolinecounter}{1}
9610 \newcounter{rectoindexscratch}
9611 \setcounter{rectoindexscratch}{1}
9612 \newcounter{versolinecounter}
9613 \setcounter{versolinecounter}{1}
9614 \newcounter{versoindexscratch}
9615 \setcounter{versoindexscratch}{1}
9616 % \end{macrocode}
9617 % \begin{macro}{\startparalleltexts}
9618 % Clears to a verso (even-numbered) page, fixes where to put line
9619 % numbers, modifies poem and stanza environments, changes where
9620 % marginal line numbers are set, sets the booleans. \label{startparalleltexts}
9621 % \begin{macrocode}
9622 \newcommand{\startparalleltexts}{%
9623 \leavevmode
9624 \cleartoverso
9625 \paralleltextstrue
9626 \renewenvironment{poem}{\raggedright
9627 \language=255%no hyphenation in verse
9628 \noemendyettrue
9629 \noexplainyettrue
9630 \setcounter{verselinenumber}{0}\setcounter{printlineindex}{0}
9631 \nobreak\begin{pmclverse}
9632 \inpoemtrue\nobreak\mark{\relax}}
9633 % must end poem if parallel text. Don't worry,
9634 % begin recto page and begin verso page will
9635 % reopen the poem and reset the line counter to the right value
9636 % if it was finish recto page or finish verso page
9637 % that closed the poem rather than your own declaration.
9638 {\ifversopoemstillopen
9639 \end{pmclverse}
9640 \inpoemfalse\mark{\relax}
9641 \else
9642 \ifrectopoemstillopen
9643 \end{pmclverse}
9644 \inpoemfalse\mark{\relax}
9645 \else
9646 \end{pmclverse}
9647 \inpoemfalse\mark{\relax}
9648 \goodbreak\afterpoemskip%\bigskip
9649 \fi\fi }
9650 \renewenvironment{stanza}{\penalty-100\instanzatrue\mark{\nostanzaatbottomvalue\ }}
9651 % must end stanza if parallel text. Don't worry,
9652 % begin recto page and begin verso page will
9653 % reopen the stanza and reset the line counter to the right value
9654 % if it was finish recto page or finish verso page
9655 % that closed the stanza rather than your own declaration.
9656 {\ifversostanzastillopen
9657 \relax
9658 \else
9659 \ifrectostanzastillopen
9660 \relax
9661 \else
9662 \nobreak\mark{\stanzaatbottomvalue\ }\nobreak
9663 \ifspeciallinelock%
9664 \relax\else%
9665 \nolinebreak\incrementverselinenumber%
9666 \fi%
9667 \speciallinelockfalse%
9668 \nobreak
9669 \instanzafalse
9670
9671 \stanzaskip
9672 \fi\fi
9673 }
9674 \renewcommand{\putverselinenumber}{\nolinebreak\begin{marginenvironment}%
9675 \nolinebreak
9676 % \marn{\hfil\textrm{\theverselinenumber}}
9677 % \marginpar{\hfil\textrm{\scriptsize\theverselinenumber}}
9678 \pmclleftsidepar{\textrm{\scriptsize\theverselinenumber}}%
9679 \nolinebreak
9680 \end{marginenvironment}%
9681 \nolinebreak
9682 }
9683 }
9684 \newenvironment{parallelverse}{\startparalleltexts}
9685 {\finishparalleltexts}
9686 \newtoks{\versotitleholder}
9687 \newtoks{\rectotitleholder}
9688 \newcommand{\makeversotitleholder}[1]{%
9689 \versotitleholder={#1}%
9690 }
9691 \newcommand{\makerectotitleholder}[1]{%
9692 \rectotitleholder={#1}%
9693 }
9694 % \end{macrocode}
9695 % \end{macro}
9696 % \begin{macro}{\versopoemtitle}
9697 % \begin{macrocode}
9698 \makeatletter
9699 \newcommand{\versopoemtitle}[1]{%
9700 \versoset@p@emtitle{#1}{\poemtitlepenalty}{\poemtitlefont}%
9701 {\poemtitleindent}{\nobreak\par\nobreak\afterpoemtitleskip\nobreak}{\z@}%
9702 \c@ntentsinfo{#1}{\contentsindentone}{\contentspoemtitlefont}%
9703 {\contentsindenttwoamount}%
9704 }
9705 \newcommand{\versoset@p@emtitle}[6]{\pmclversoresetsettitleinnotes%
9706 \setlength{\titleentryoverrun}{#6}%
9707 {#2}%
9708 {#3 \begin{titleentryenvironment}%
9709 {\ifcentertitleson\begin{center}#1\end{center}\else #4 #1\fi}%
9710 \end{titleentryenvironment}}%
9711 {#5}%
9712 \m@kep@emlabel
9713 \versom@ken@teholder{#1}%
9714 \setlength{\titleentryoverrun}{\z@}}
9715 \newcommand{\versom@ken@teholder}[1]{%
9716 \ifsinglelinetitle
9717 \versotitleholder={#1}%
9718 \global\edef\@compoundlabelscratch{poem\thepoemnumber}%
9719 \else\iftitlefirstline
9720 \versotitleholder={#1}%
9721 \global\edef\@compoundlabelscratch{poem\thepoemnumber}%
9722 \else\iftitlemiddleline
9723 \titlesofar=\versotitleholder
9724 \titleincrement={~#1}%
9725 \global\edef\titleconcat{\the\titlesofar \the\titleincrement}%
9726 \versotitleholder=\expandafter{\titleconcat}%
9727 \global\edef\@compoundlabelscratch{poem\thepoemnumber}%
9728 \else
9729 \titlesofar=\versotitleholder
9730 \titleincrement={~#1}%
9731 \global\edef\titleconcat{\the\titlesofar \the\titleincrement}%
9732 \versotitleholder=\expandafter{\titleconcat}%
9733 \global\edef\@compoundlabelscratch{poem\thepoemnumber}%
9734 \fi
9735 \fi
9736 \fi
9737 }
9738 \newcommand{\versotitletoothernotes}{\string\par
9739 \ifputpagenumberinnotes%
9740 \string\argpageref\string{\@compoundlabelscratch\string}%
9741 \string\setcounterfrompageref\string{notepageholdertitle\string}%
9742 \string{\@compoundlabelscratch\string}%
9743 \fi%
9744 \string\textbf\string{\ \the\versotitleholder\string}
9745 }%
9746 \newcommand{\versopoemtitlenocontents}[1]{%
9747 \versoset@p@emtitle{#1}{\poemtitlepenalty}{\poemtitlefont}%
9748 {\poemtitleindent}{\nobreak\par\nobreak\afterpoemtitleskip\nobreak}{\z@}%
9749 }
9750 \newcommand{\versotitleinnotescheck}{\ifparalleltexts\let\titletoothernotes=\versotitletoothernotes\fi}
9751 \makeatother
9752 % \end{macrocode}
9753 % \end{macro}
9754 % \begin{macro}{\rectopoemtitle}
9755 % \begin{macrocode}
9756 \makeatletter
9757 \newcommand{\rectopoemtitle}[1]{%
9758 \rectoset@p@emtitle{#1}{\poemtitlepenalty}{\poemtitlefont}%
9759 {\poemtitleindent}{\nobreak\par\nobreak\afterpoemtitleskip\nobreak}{\z@}%
9760 \c@ntentsinfo{#1}{\contentsindentone}{\contentspoemtitlefont}%
9761 {\contentsindenttwoamount}%
9762 }
9763 \newcommand{\rectoset@p@emtitle}[6]{\pmclrectoresetsettitleinnotes
9764 \setlength{\titleentryoverrun}{#6}%
9765 {#2}%
9766 {#3 \begin{titleentryenvironment}%
9767 {\ifcentertitleson\begin{center}#1\end{center}\else #4 #1\fi}%
9768 \end{titleentryenvironment}}%
9769 {#5}%
9770 \m@kep@emlabel
9771 \rectom@ken@teholder{#1}%
9772 \setlength{\titleentryoverrun}{\z@}}
9773 \newcommand{\rectom@ken@teholder}[1]{%
9774 \ifsinglelinetitle
9775 \rectotitleholder={#1}%
9776 \global\edef\@compoundlabelscratch{poem\thepoemnumber}%
9777 \else\iftitlefirstline
9778 \rectotitleholder={#1}%
9779 \global\edef\@compoundlabelscratch{poem\thepoemnumber}%
9780 \else\iftitlemiddleline
9781 \titlesofar=\rectotitleholder
9782 \titleincrement={~#1}%
9783 \global\edef\titleconcat{\the\titlesofar \the\titleincrement}%
9784 \rectotitleholder=\expandafter{\titleconcat}%
9785 \global\edef\@compoundlabelscratch{poem\thepoemnumber}%
9786 \else
9787 \titlesofar=\rectotitleholder
9788 \titleincrement={~#1}%
9789 \global\edef\titleconcat{\the\titlesofar \the\titleincrement}%
9790 \rectotitleholder=\expandafter{\titleconcat}%
9791 \global\edef\@compoundlabelscratch{poem\thepoemnumber}%
9792 \fi
9793 \fi
9794 \fi
9795 }
9796 \newcommand{\rectotitletoothernotes}{\string\par
9797 \ifputpagenumberinnotes%
9798 \string\argpageref\string{\@compoundlabelscratch\string}%
9799 \string\setcounterfrompageref\string{notepageholdertitle\string}%
9800 \string{\@compoundlabelscratch\string}%
9801 \fi%
9802 \string\textbf\string{\ \the\rectotitleholder\string}
9803 }%
9804 \newcommand{\rectopoemtitlenocontents}[1]{%
9805 \rectoset@p@emtitle{#1}{\poemtitlepenalty}{\poemtitlefont}%
9806 {\poemtitleindent}{\nobreak\par\nobreak\afterpoemtitleskip\nobreak}{\z@}%
9807 %\c@ntentsinfo{#1}{\contentsindentone}{\contentspoemtitlefont}%
9808 %{\contentsindenttwoamount}%
9809 %\t@xtnotesinfo{#1}%
9810 }
9811 \newcommand{\rectotitleinnotescheck}{\ifparalleltexts\let\titletoothernotes=\rectotitletoothernotes\fi}
9812 \makeatother
9813 % \end{macrocode}
9814 % \end{macro}
9815 % \begin{macro}{\saveversoline}
9816 % Macros for saving and restoring line numbers:
9817 % \begin{macrocode}
9818 \newcommand{\saveversoline}{\setcounter{versolinecounter}%
9819 {\value{verselinenumber}}%
9820 \setcounter{versoindexscratch}{\value{printlineindex}}}
9821 % \end{macrocode}
9822 % \end{macro}
9823 % \begin{macro}{\restoreversoline}
9824 % \begin{macrocode}
9825 \newcommand{\restoreversoline}{\setcounter{verselinenumber}%
9826 {\value{versolinecounter}}%
9827 \setcounter{printlineindex}{\value{versoindexscratch}}}
9828 % \end{macrocode}
9829 % \end{macro}
9830 % \begin{macro}{\saverectoline}
9831 % \begin{macrocode}
9832 \newcommand{\saverectoline}{\setcounter{rectolinecounter}%
9833 {\value{verselinenumber}}%
9834 \setcounter{rectoindexscratch}{\value{printlineindex}}}
9835 % \end{macrocode}
9836 % \end{macro}
9837 % \begin{macro}{\restorerectoline}
9838 % \begin{macrocode}
9839 \newcommand{\restorerectoline}{\setcounter{verselinenumber}%
9840 {\value{rectolinecounter}}%
9841 \setcounter{printlineindex}{\value{rectoindexscratch}}}
9842 % \end{macrocode}
9843 % \end{macro}
9844 % Macros for line cross references:
9845 %
9846 % You will probably want to use line cross references to show which
9847 % lines on the recto page correspond to which lines on the verso page.
9848 % When you do this, you will set, in the margin of a line on the recto
9849 % page, the line number of the corresponding line on the verso side, in
9850 % square brackets. You may mark that line number with a distinctive
9851 % identifier. |\synchroflag| is a token register to hold that
9852 % identifier, and |\setsynchroflag| is a command to put the identifier
9853 % in the register. For instance, if you are setting the 1805 version of
9854 % Wordsworth's \emph{The Prelude} on the verso, and the 1850 version on
9855 % the recto, you might wish to set the ``synchroflag'' to ``1805'' so
9856 % that the line cross reference will look something like ``[1805:
9857 % 147]''.
9858 % \begin{macro}{\setsynchroflag}
9859 % \begin{macrocode}
9860 \newtoks{\synchroflag}
9861 \newcommand{\setsynchroflag}[1]{\synchroflag={#1}}
9862 \setsynchroflag{\relax}
9863 % \end{macrocode}
9864 % \end{macro}
9865 % Here are commands for defining and calling ``synchrolabels'', line
9866 % cross references that tie verso and recto pages:
9867 % \begin{macro}{\synchrolabel}
9868 % \begin{macrocode}
9869 \newcommand{\synchrolabel}[1]{\poemlinelabel{#1}}
9870 \newcommand{\hfilll}{\hskip 0pt plus 1 filll}
9871 \newcommand{\synchroref}[1]{%
9872 \pmclrightsidepar{{\textrm{\scriptsize[\the\synchroflag\ref{#1}]}}}%
9873 % \hfill\rlap{{\textrm{\scriptsize[\the\synchroflag\ref{#1}]}}}
9874 % \ifnum\theprintlineindex=\thelineindexrepeat
9875 % \hspace{-7pt}
9876 % \fi
9877 }
9878 % \end{macrocode}
9879 % \end{macro}
9880 % Finally, the |\startversopage|, |\finishversopage|, |\startrectopage|
9881 % |\finishrectopage| and |\finishparalleltexts| macros:
9882 % \begin{macro}{\startversopage}
9883 % \begin{macrocode}
9884 \newcommand{\startversopage}{
9885 \ifrectostanzastillopen
9886 \end{stanza}
9887 \rectostanzastillopenfalse
9888 \end{poem}
9889 \rectopoemstillopenfalse
9890 \fi
9891 \ifrectopoemstillopen % from previous page
9892 \end{poem}
9893 \rectopoemstillopenfalse
9894 \fi
9895 \ifversopoempending % from previous verso
9896 \begin{poem}
9897 \global\versopoempendingfalse
9898 \fi
9899 \ifversostanzapending % from previous verso
9900 \begin{stanza}
9901 \global\versostanzapendingfalse
9902 \fi
9903 \ifversoemendationspending
9904 \noemendyetfalse
9905 \global\versoemendationspendingfalse
9906 \fi
9907 \ifversoexplanationspending
9908 \noexplainyetfalse
9909 \global\versoexplanationspendingfalse
9910 \fi
9911 \rectofalse\versotrue\restoreversoline
9912 \let\titletoothernotes=\versotitletoothernotes}
9913 % \end{macrocode}
9914 % \end{macro}
9915 % \begin{macro}{\finishversopage}
9916 % \begin{macrocode}
9917 \newcommand{\finishversopage}{
9918 \saveversoline\versofalse\
9919 \ifinpoem
9920 \global\versopoempendingtrue
9921 \versopoemstillopentrue
9922 \fi
9923 \ifinstanza
9924 \global\versostanzapendingtrue
9925 \versostanzastillopentrue
9926 \global\versopoempendingtrue
9927 \versopoemstillopentrue
9928 \fi
9929 \ifnoemendyet
9930 \relax
9931 \else
9932 \global\versoemendationspendingtrue
9933 \noemendyetfalse
9934 \fi
9935 \ifnoexplainyet
9936 \relax
9937 \else
9938 \global\versoexplanationspendingtrue
9939 \noexplainyetfalse
9940 \fi
9941 % \clearpage % keep in comment until footnotes problems are worked out
9942 }
9943 % \end{macrocode}
9944 % \end{macro}
9945 % \begin{macro}{\startrectopage}
9946 % \begin{macrocode}
9947 \newcommand{\startrectopage}{
9948 \ifversostanzastillopen
9949 \end{stanza}
9950 \versostanzastillopenfalse
9951 \end{poem}
9952 \versopoemstillopenfalse
9953 \fi
9954 \ifversopoemstillopen
9955 \end{poem}
9956 \versopoemstillopenfalse
9957 \fi
9958 \ifrectopoempending
9959 \begin{poem}
9960 \global\rectopoempendingfalse
9961 \fi
9962 \ifrectostanzapending
9963 \begin{stanza}
9964 \global\rectostanzapendingfalse
9965 \fi
9966 \ifrectoemendationspending
9967 \noemendyetfalse
9968 \global\rectoemendationspendingfalse
9969 \fi
9970 \ifrectoexplanationspending
9971 \noexplainyetfalse
9972 \global\rectoexplanationspendingfalse
9973 \fi
9974 \versofalse\rectotrue\restorerectoline
9975 \let\titletoothernotes=\rectotitletoothernotes}
9976 % \end{macrocode}
9977 % \end{macro}
9978 % \begin{macro}{\finishrectopage}
9979 % \begin{macrocode}
9980 \newcommand{\finishrectopage}{\saverectoline\rectofalse
9981 \ifinpoem
9982 \global\rectopoempendingtrue
9983 \rectopoemstillopentrue
9984 \fi
9985 \ifinstanza
9986 \global\rectostanzapendingtrue
9987 \rectostanzastillopentrue
9988 \global\rectopoempendingtrue
9989 \rectopoemstillopentrue
9990 \fi
9991 \ifnoemendyet
9992 \relax
9993 \else
9994 \global\rectoemendationspendingtrue
9995 \noemendyetfalse
9996 \fi
9997 \ifnoexplainyet
9998 \relax
9999 \else
10000 \global\versoexplanationspendingtrue
10001 \noexplainyetfalse
10002 \fi
10003 % \clearpage % until footnote problem is solved
10004 }
10005 % \end{macrocode}
10006 % \end{macro}
10007 % \begin{macro}{\finishparalleltexts}
10008 % \begin{macrocode}
10009 \newcommand{\finishparalleltexts}{
10010 \ifinstanza
10011 \end{stanza}
10012 \fi
10013 \ifinpoem
10014 \end{poem}
10015 \fi
10016 \ifinprosesection
10017 \end{prosesection}
10018 \fi
10019 \ifinquotedverse
10020 \end{quotedverse}
10021 \fi
10022 \rectofalse\versofalse\paralleltextsfalse
10023 \makeatletter\pmclresetsettitleinnotes\makeatother
10024 }
10025 % \end{macrocode}
10026 % \end{macro}
10027 % \begin{macro}{\makeversotextnotes}
10028 % Next, the versotextnotes section:
10029 % \begin{macrocode}
10030 % tokens for changing the names of these notes
10031 \newtoks{\versotextnotesname}
10032 \versotextnotesname={TEXTUAL NOTES}
10033 \newcommand{\changeversotextnotesname}[1]{\versotextnotesname={#1}}
10034 \newtoks{\versotextnotesheadername}
10035 \versotextnotesheadername={Textual Notes to}
10036 \newcommand{\changeversotextnotesheader}[1]{\versotextnotesheadername={#1}}
10037 \newtoks{\versotextnotescontentsname}
10038 \versotextnotescontentsname={Textual Notes}
10039 \newcommand{\changeversotextnotescontentsname}[1]{%
10040 \versotextnotescontentsname={#1}}
10041 % two column notes
10042 \newif\ifversotextnotestwocol
10043 \versotextnotestwocolfalse
10044 % versotextnotes section setup
10045 \newcommand{\makeversotextnotes}{\global\textnotesontrue
10046 \newwrite\versotextnotes
10047 \global\verselinenumberstrue
10048 \immediate\openout\versotextnotes=\jobname.vtn
10049 \literalversotextnote{\flushbottom{\par\clearpage
10050 {\pagestyle{volumetitlestyle}\cleardoublepage}
10051 \thispagestyle{volumetitlestyle}}
10052 \fancyhead{}
10053 \fancyhead[RO,LE]{{\small\textrm{\thepage}}}
10054 \fancyhead[CO]{{\small{\em \the\versotextnotesheadername~\mymarks}}}
10055 \fancyhead[CE]{{\small{\em \the\versotextnotesheadername~\mymarks}}}
10056 \fancyfoot{}
10057 \mark{3}
10058 \setendnotessectiontitle{\the\versotextnotesname}{versotextnotes}
10059 \tolerance=500\language=0
10060 \normalfont \backmattertextfont
10061 \ifversotextnotestwocol
10062 \begin{multicols}{2}
10063 \fi
10064 \setlength{\parindent}{-10pt}
10065 }
10066 }
10067 % \end{macrocode}
10068 % \end{macro}
10069 % \begin{macro}{\versotextnote}
10070 % \begin{macrocode}
10071 \newif\ifversotextnotessinglepar
10072 \newif\ifnoversotextnoteyet
10073 \newcommand{\literalversotextnote}[1]{\begingroup
10074 \def\next{#1}%
10075 \newlinechar='40
10076 \immediate\write\versotextnotes{\expandafter\strip\meaning\next}%
10077 \endgroup
10078 }
10079 \newcommand{\firstversotextnote}{\immediate\write\versotextnotes{\versotitletoothernotes}
10080 \ifversotextnotessinglepar%
10081 \literalversotextnote{\par}%
10082 \fi% ifversotextnotessinglepa
10083 }
10084 \newcommand{\versotextnote}[2][0]{\versotitleinnotescheck
10085 \setlemmarange{#1}%
10086 \ifnoversotextnoteyet % firstversotextnote
10087 \firstversotextnote
10088 \fi %noversotextnoteyet
10089 \global\noversotextnoteyetfalse
10090 \immediate\write\versotextnotes{\checknoteheaders}%
10091 \literalversotextnote{#2}%
10092 \ifversotextnotessinglepar%
10093 \literalversotextnote{\par}%
10094 \fi% ifversotextnotessinglepar
10095 \resetlemmacounters
10096 }
10097 % \end{macrocode}
10098 % \end{macro}
10099 % \begin{macro}{\makerectotextnotes}
10100 % Next, the rectotextnotes section:
10101 % \begin{macrocode}
10102 % tokens for changing the names of these notes
10103 \newtoks{\rectotextnotesname}
10104 \rectotextnotesname={TEXTUAL NOTES}
10105 \newcommand{\changerectotextnotesname}[1]{\rectotextnotesname={#1}}
10106 \newtoks{\rectotextnotesheadername}
10107 \rectotextnotesheadername={Textual Notes to}
10108 \newcommand{\changerectotextnotesheader}[1]{\rectotextnotesheadername={#1}}
10109 \newtoks{\rectotextnotescontentsname}
10110 \rectotextnotescontentsname={Textual Notes}
10111 \newcommand{\changerectotextnotescontentsname}[1]{%
10112 \rectotextnotescontentsname={#1}}
10113 % two column notes
10114 \newif\ifrectotextnotestwocol
10115 \rectotextnotestwocolfalse
10116 % rectotextnotes section setup
10117 \newcommand{\makerectotextnotes}{\global\textnotesontrue
10118 \newwrite\rectotextnotes
10119 \global\verselinenumberstrue
10120 \immediate\openout\rectotextnotes=\jobname.rtn
10121 \literalrectotextnote{\flushbottom{\par\clearpage
10122 {\pagestyle{volumetitlestyle}\cleardoublepage}
10123 \thispagestyle{volumetitlestyle}}
10124 \fancyhead{}
10125 \fancyhead[RO,LE]{{\small\textrm{\thepage}}}
10126 \fancyhead[CO]{{\small{\em \the\rectotextnotesheadername~\mymarks}}}
10127 \fancyhead[CE]{{\small{\em \the\rectotextnotesheadername~\mymarks}}}
10128 \fancyfoot{}
10129 \mark{3}
10130 \setendnotessectiontitle{\the\rectotextnotesname}{rectotextnotes}
10131 \tolerance=500\language=0
10132 \normalfont \backmattertextfont
10133 \ifrectotextnotestwocol
10134 \begin{multicols}{2}
10135 \fi
10136 \setlength{\parindent}{-10pt}
10137 }
10138 }
10139 % \end{macrocode}
10140 % \end{macro}
10141 % \begin{macro}{\rectotextnote}
10142 % \begin{macrocode}
10143 \newif\ifrectotextnotessinglepar
10144 \newif\ifnorectotextnoteyet
10145 \newcommand{\literalrectotextnote}[1]{\begingroup
10146 \def\next{#1}%
10147 \newlinechar='40
10148 \immediate\write\rectotextnotes{\expandafter\strip\meaning\next}%
10149 \endgroup
10150 }
10151 \newcommand{\firstrectotextnote}{\immediate\write\rectotextnotes{\rectotitletoothernotes}
10152 \ifrectotextnotessinglepar%
10153 \literalrectotextnote{\par}%
10154 \fi% ifrectotextnotessinglepar
10155 }
10156 \newcommand{\rectotextnote}[2][0]{\rectotitleinnotescheck
10157 \setlemmarange{#1}%
10158 \ifnorectotextnoteyet % firstrectotextnote
10159 \firstrectotextnote
10160 \fi %norectotextnoteyet
10161 \global\norectotextnoteyetfalse
10162 \immediate\write\rectotextnotes{\checknoteheaders}%
10163 \literalrectotextnote{#2}%
10164 \ifrectotextnotessinglepar%
10165 \literalrectotextnote{\par}%
10166 \fi% ifrectotextnotessinglepar
10167 \resetlemmacounters
10168 }
10169 % \end{macrocode}
10170 % \end{macro}
10171 % \begin{macro}{\makeversoemendations}
10172 % Next, the versoemendations section:
10173 % \begin{macrocode}
10174 % tokens for changing the names of these notes
10175 \newtoks{\versoemendationsname}
10176 \versoemendationsname={EMENDATIONS}
10177 \newcommand{\changeversoemendationsname}[1]{\versoemendationsname={#1}}
10178 \newtoks{\versoemendationsheadername}
10179 \versoemendationsheadername={Emendations to}
10180 \newcommand{\changeversoemendationsheader}[1]{\versoemendationsheadername={#1}}
10181 \newtoks{\versoemendationscontentsname}
10182 \versoemendationscontentsname={Emendations}
10183 \newcommand{\changeversoemendationscontentsname}[1]{%
10184 \versoemendationscontentsname={#1}}
10185 % two column notes
10186 \newif\ifversoemendationstwocol
10187 \versoemendationstwocolfalse
10188 % versoemendations section setup
10189 \newcommand{\makeversoemendations}{\global\emendationsontrue
10190 \newwrite\versoemendations
10191 \global\verselinenumberstrue
10192 \immediate\openout\versoemendations=\jobname.vem
10193 \literalversoemendation{\flushbottom{\par\clearpage
10194 {\pagestyle{volumetitlestyle}\cleardoublepage}
10195 \thispagestyle{volumetitlestyle}}
10196 \fancyhead{}
10197 \fancyhead[RO,LE]{{\small\textrm{\thepage}}}
10198 \fancyhead[CO]{{\small{\em \the\versoemendationsheadername~\mymarks}}}
10199 \fancyhead[CE]{{\small{\em \the\versoemendationsheadername~\mymarks}}}
10200 \fancyfoot{}
10201 \mark{3}
10202 \setendnotessectiontitle{\the\versoemendationsname}{versoemendations}
10203 \tolerance=500\language=0
10204 \normalfont \backmattertextfont
10205 \ifversoemendationstwocol
10206 \begin{multicols}{2}
10207 \fi
10208 \setlength{\parindent}{-10pt}
10209 }
10210 }
10211 % \end{macrocode}
10212 % \end{macro}
10213 % \begin{macro}{\versoemendation}
10214 % \begin{macrocode}
10215 \newif\ifversoemendationssinglepar
10216 \newif\ifnoversoemendationyet
10217 \newcommand{\literalversoemendation}[1]{\begingroup
10218 \def\next{#1}%
10219 \newlinechar='40
10220 \immediate\write\versoemendations{\expandafter\strip\meaning\next}%
10221 \endgroup
10222 }
10223 \newcommand{\firstversoemendation}{\immediate\write\versoemendations{\versotitletoothernotes}
10224 \ifversoemendationssinglepar%
10225 \literalversoemendation{\par}%
10226 \fi% ifversoemendationssinglepar
10227 }
10228 \newcommand{\versoemendation}[2][0]{\versotitleinnotescheck%
10229 \setlemmarange{#1}%
10230 \ifnoversoemendationyet % firstversoemendation
10231 \firstversoemendation
10232 \fi %noversoemendationyet
10233 \global\noversoemendationyetfalse
10234 \immediate\write\versoemendations{\checknoteheaders}%
10235 \literalversoemendation{#2}%
10236 \ifversoemendationssinglepar%
10237 \literalversoemendation{\par}%
10238 \fi% ifversoemendationssinglepar
10239 \resetlemmacounters
10240 }
10241 % \end{macrocode}
10242 % \end{macro}
10243 % \begin{macro}{\makerectoemendations}
10244 % Next, the rectoemendations section:
10245 % \begin{macrocode}
10246 % tokens for changing the names of these notes
10247 \newtoks{\rectoemendationsname}
10248 \rectoemendationsname={EMENDATIONS}
10249 \newcommand{\changerectoemendationsname}[1]{\rectoemendationsname={#1}}
10250 \newtoks{\rectoemendationsheadername}
10251 \rectoemendationsheadername={Emendations to}
10252 \newcommand{\changerectoemendationsheader}[1]{\rectoemendationsheadername={#1}}
10253 \newtoks{\rectoemendationscontentsname}
10254 \rectoemendationscontentsname={Emendations}
10255 \newcommand{\changerectoemendationscontentsname}[1]{%
10256 \rectoemendationscontentsname={#1}}
10257 % two column notes
10258 \newif\ifrectoemendationstwocol
10259 \rectoemendationstwocolfalse
10260 % rectoemendations section setup
10261 \newcommand{\makerectoemendations}{\global\emendationsontrue
10262 \newwrite\rectoemendations
10263 \global\verselinenumberstrue
10264 \immediate\openout\rectoemendations=\jobname.rem
10265 \literalrectoemendation{\flushbottom{\par\clearpage
10266 {\pagestyle{volumetitlestyle}\cleardoublepage}
10267 \thispagestyle{volumetitlestyle}}
10268 \fancyhead{}
10269 \fancyhead[RO,LE]{{\small\textrm{\thepage}}}
10270 \fancyhead[CO]{{\small{\em \the\rectoemendationsheadername~\mymarks}}}
10271 \fancyhead[CE]{{\small{\em \the\rectoemendationsheadername~\mymarks}}}
10272 \fancyfoot{}
10273 \mark{3}
10274 \setendnotessectiontitle{\the\rectoemendationsname}{rectoemendations}
10275 \tolerance=500\language=0
10276 \normalfont \backmattertextfont
10277 \ifrectoemendationstwocol
10278 \begin{multicols}{2}
10279 \fi
10280 \setlength{\parindent}{-10pt}
10281 }
10282 }
10283 % \end{macrocode}
10284 % \end{macro}
10285 % \begin{macro}{\rectoemendation}
10286 % \begin{macrocode}
10287 \newif\ifrectoemendationssinglepar
10288 \newif\ifnorectoemendationyet
10289 \newcommand{\literalrectoemendation}[1]{\begingroup
10290 \def\next{#1}%
10291 \newlinechar='40
10292 \immediate\write\rectoemendations{\expandafter\strip\meaning\next}%
10293 \endgroup
10294 }
10295 \newcommand{\firstrectoemendation}{\immediate\write\rectoemendations{\rectotitletoothernotes}
10296 \ifrectoemendationssinglepar%
10297 \literalrectoemendation{\par}%
10298 \fi% ifrectoemendationssinglepar
10299 }
10300 \newcommand{\rectoemendation}[2][0]{\rectotitleinnotescheck
10301 \setlemmarange{#1}%
10302 \ifnorectoemendationyet % firstrectoemendation
10303 \firstrectoemendation
10304 \fi %norectoemendationyet
10305 \global\norectoemendationyetfalse
10306 \immediate\write\rectoemendations{\checknoteheaders}%
10307 \literalrectoemendation{#2}%
10308 \ifrectoemendationssinglepar%
10309 \literalrectoemendation{\par}%
10310 \fi% ifrectoemendationssinglepar
10311 \resetlemmacounters
10312 }
10313 % \end{macrocode}
10314 % \end{macro}
10315 % \begin{macro}{\makeversoexplanatorynotes}
10316 % And the verso explanatory notes:
10317 % \begin{macrocode}
10318 % Tokens to change names of these notes
10319 \newtoks{\versoexplanationsname}
10320 \versoexplanationsname={EXPLANATORY NOTES}
10321 \newcommand{\changeversoexplanationsname}[1]{\versoexplanationsname={#1}}
10322 \newtoks{\versoexplanationsheadername}
10323 \versoexplanationsheadername={Explanatory Notes to}
10324 \newcommand{\changeversoexplanationsheader}[1]{\versoexplanationsheadername={#1}}
10325 \newtoks{\versoexplanationscontentsname}
10326 \versoexplanationscontentsname={Explanatory Notes}
10327 \newcommand{\changeversoexplanationscontentsname}[1]{%
10328 \versoexplanationscontentsname={#1}}
10329 % Two column notes
10330 \newif\ifversoexplanationstwocol
10331 \versoexplanationstwocolfalse
10332 % versoexplanatory notes setup
10333 \newcommand{\makeversoexplanatorynotes}{\global\explanontrue
10334 \global\verselinenumberstrue
10335 \newwrite\versoexplanations
10336 \immediate\openout\versoexplanations=\jobname.vex
10337 \literalversoexplain{\flushbottom{\par\clearpage
10338 {\pagestyle{volumetitlestyle}\cleardoublepage}
10339 \thispagestyle{volumetitlestyle}}
10340 \fancyhead[RO,LE]{{\small\textrm{\thepage}}}
10341 \fancyhead[CO]{{\small{\em \the\versoexplanationsheadername~\mymarks}}}
10342 \fancyhead[CE]{{\small{\em \the\versoexplanationsheadername~\mymarks}}}
10343 \fancyfoot{}
10344 \mark{3}
10345 \setendnotessectiontitle{\the\versoexplanationsname}{versoexplanatorynotes}
10346 \tolerance=500\language=0
10347 \normalfont \backmattertextfont
10348 \ifversoexplanationstwocol
10349 \begin{multicols}{2}
10350 \fi
10351 \setlength{\parindent}{-10pt}
10352 }
10353 }
10354 % \begin{macro}{\versoexplanatory}
10355 % Again, |\firstversoexplanatory| is internal, called by |\versoexplanatory|.
10356 % \begin{macrocode}
10357 \newcommand{\literalversoexplain}[1]{
10358 \begingroup
10359 \def\next{#1}%
10360 \newlinechar='40
10361 \immediate\write\versoexplanations{\expandafter\strip\meaning\next}%
10362 \endgroup
10363 }
10364 \newif\ifversoexplanationssinglepar
10365 \newcommand{\firstversoexplanatory}{\immediate\write\versoexplanations{\versotitletoothernotes}
10366 \ifversoexplanationssinglepar%
10367 \literalversoexplain{\par}%
10368 \fi}
10369 \newif\ifnoversoexplainyet
10370 \newcommand{\versoexplanatory}[2][0]{\versotitleinnotescheck%
10371 \ifexplanon
10372 \setlemmarange{#1}%
10373 \ifnoversoexplainyet % first versoexplanation
10374 \firstversoexplanatory
10375 \fi %noversoexplainyet
10376 \global\noversoexplainyetfalse
10377 \immediate\write\versoexplanations{\checknoteheaders}%
10378 \literalversoexplain{#2}%
10379 \ifversoexplanationssinglepar%
10380 \literalversoexplain{\par}%
10381 \fi%
10382 \fi % ifexplanon
10383 \resetlemmacounters
10384 }
10385 % \end{macrocode}
10386 % \end{macro}
10387 % \begin{macro}{\makerectoexplanatorynotes}
10388 % And the recto explanatory notes:
10389 % \begin{macrocode}
10390 % Tokens to change names of these notes
10391 \newtoks{\rectoexplanationsname}
10392 \rectoexplanationsname={EXPLANATORY NOTES}
10393 \newcommand{\changerectoexplanationsname}[1]{\rectoexplanationsname={#1}}
10394 \newtoks{\rectoexplanationsheadername}
10395 \rectoexplanationsheadername={Explanatory Notes to}
10396 \newcommand{\changerectoexplanationsheader}[1]{\rectoexplanationsheadername={#1}}
10397 \newtoks{\rectoexplanationscontentsname}
10398 \rectoexplanationscontentsname={Explanatory Notes}
10399 \newcommand{\changerectoexplanationscontentsname}[1]{%
10400 \rectoexplanationscontentsname={#1}}
10401 % Two column notes
10402 \newif\ifrectoexplanationstwocol
10403 \rectoexplanationstwocolfalse
10404 % rectoexplanatory notes setup
10405 \newcommand{\makerectoexplanatorynotes}{\global\explanontrue
10406 \global\verselinenumberstrue
10407 \newwrite\rectoexplanations
10408 \immediate\openout\rectoexplanations=\jobname.rex
10409 \literalrectoexplain{\flushbottom{\par\clearpage
10410 {\pagestyle{volumetitlestyle}\cleardoublepage}
10411 \thispagestyle{volumetitlestyle}}
10412 \fancyhead[RO,LE]{{\small\textrm{\thepage}}}
10413 \fancyhead[CO]{{\small{\em \the\rectoexplanationsheadername~\mymarks}}}
10414 \fancyhead[CE]{{\small{\em \the\rectoexplanationsheadername~\mymarks}}}
10415 \fancyfoot{}
10416 \mark{3}
10417 \setendnotessectiontitle{\the\rectoexplanationsname}{rectoexplanatorynotes}
10418 \tolerance=500\language=0
10419 \normalfont \backmattertextfont
10420 \ifrectoexplanationstwocol
10421 \begin{multicols}{2}
10422 \fi
10423 \setlength{\parindent}{-10pt}
10424 }
10425 }
10426 % \begin{macro}{\rectoexplanatory}
10427 % Again, |\firstrectoexplanatory| is internal, called by |\rectoexplanatory|.
10428 % \begin{macrocode}
10429 \newcommand{\literalrectoexplain}[1]{
10430 \begingroup
10431 \def\next{#1}%
10432 \newlinechar='40
10433 \immediate\write\rectoexplanations{\expandafter\strip\meaning\next}%
10434 \endgroup
10435 }
10436 \newif\ifrectoexplanationssinglepar
10437 \newcommand{\firstrectoexplanatory}{\immediate\write\rectoexplanations{\rectotitletoothernotes}
10438 \ifrectoexplanationssinglepar%
10439 \literalrectoexplain{\par}%
10440 \fi%
10441 }
10442 \newif\ifnorectoexplainyet
10443 \newcommand{\rectoexplanatory}[2][0]{\rectotitleinnotescheck%
10444 \ifexplanon
10445 \setlemmarange{#1}%
10446 \ifnorectoexplainyet % first rectoexplanation
10447 \firstrectoexplanatory
10448 \fi %norectoexplainyet
10449 \global\norectoexplainyetfalse
10450 \immediate\write\rectoexplanations{\checknoteheaders}%
10451 \literalrectoexplain{#2}%
10452 \ifrectoexplanationssinglepar%
10453 \literalrectoexplain{\par}%
10454 \fi%
10455 \fi % ifexplanon
10456 \resetlemmacounters
10457 }
10458 % \end{macrocode}
10459 % \end{macro}
10460 % \begin{macro}{\versoprosetextnote}
10461 % \begin{macrocode}
10462 \newcommand{\versoprosetextnote}[3][0]{%
10463 \iftextnoteson%
10464 \versotitleinnotescheck
10465 \unskip\proselinelabel{#2}%
10466 \setproselemmarange{#2}{#1}%
10467 \ifnoversotextnoteyet % firstversotextnote
10468 \firstversotextnote
10469 \fi %noversotextnoteyet
10470 \global\noversotextnoteyetfalse
10471 \immediate\write\versotextnotes{\checkprosenoteheaders}%
10472 \literalversotextnote{#3}%
10473 \ifversotextnotessinglepar%
10474 \literalversotextnote{\par}%
10475 \fi%
10476 \resetlemmacounters%
10477 \fi\unskip%
10478 }
10479 % \end{macrocode}
10480 % \end{macro}
10481 % \begin{macro}{\versoproseemendation}
10482 % Notice that it calls |\firstemendation| as usual.
10483 % \begin{macrocode}
10484 \newcommand{\versoproseemendation}[3][0]{%
10485 \ifemendationson%
10486 \versotitleinnotescheck
10487 \unskip\proselinelabel{#2}%
10488 \setproselemmarange{#2}{#1}%
10489 \ifredundantemendations
10490 \iftextnoteson
10491 \ifrangelemma
10492 \versoprosetextnote[#1]{#2}{#3}%
10493 \else
10494 \versoprosetextnote{#2}{#3}%
10495 \fi % ifrangelemma}
10496 \fi %iftextnoteson
10497 \ifversotextnotessinglepar%
10498 \literalversotextnote{\par}%
10499 \fi% iftextnotessinglepar
10500 \fi % ifredundantemendations
10501 \ifnoversoemendationyet % firstemendation
10502 \firstversoemendation
10503 \fi%noemendyet
10504 \global\noversoemendationyetfalse
10505 \immediate\write\versoemendations{\checkprosenoteheaders}%
10506 \literalversoemendation{#3}%
10507 \ifversoemendationssinglepar%
10508 \literalversoemendation{\par}%
10509 \fi% ifemendationssinglep
10510 \resetlemmacounters%
10511 \fi\unskip%
10512 }
10513 % \end{macrocode}
10514 % \end{macro}
10515 % \begin{macro}{\versoproseexplanatory}
10516 % \begin{macrocode}
10517 \newcommand{\versoproseexplanatory}[3][0]{%
10518 \ifexplanon%
10519 \versotitleinnotescheck
10520 \unskip\proselinelabel{#2}%
10521 \setproselemmarange{#2}{#1}%
10522 \ifnoversoexplainyet% firstexplanation
10523 \firstversoexplanatory%
10524 \fi%noexplainyet
10525 \global\noversoexplainyetfalse%
10526 \immediate\write\versoexplanations{\checkprosenoteheaders}%
10527 \literalversoexplain{#3}%
10528 \ifversoexplanationssinglepar%
10529 \literalversoexplain{\par}%
10530 \fi% ifexplanationssinglepar
10531 \resetlemmacounters%
10532 \fi\unskip%
10533 }
10534 % \end{macrocode}
10535 % \end{macro}
10536 % \begin{macro}{\rectoprosetextnote}
10537 % \begin{macrocode}
10538 \newcommand{\rectoprosetextnote}[3][0]{%
10539 \iftextnoteson%
10540 \rectotitleinnotescheck
10541 \unskip\proselinelabel{#2}%
10542 \setproselemmarange{#2}{#1}%
10543 \ifnorectotextnoteyet % firstrectotextnote
10544 \firstrectotextnote
10545 \fi %norectotextnoteyet
10546 \global\norectotextnoteyetfalse
10547 \immediate\write\rectotextnotes{\checkprosenoteheaders}%
10548 \literalrectotextnote{#3}%
10549 \ifrectotextnotessinglepar%
10550 \literalrectotextnote{\par}%
10551 \fi%
10552 \resetlemmacounters%
10553 \fi\unskip%
10554 }
10555 % \end{macrocode}
10556 % \end{macro}
10557 % \begin{macro}{\rectoproseemendation}
10558 % Notice that it calls |\firstemendation| as usual.
10559 % \begin{macrocode}
10560 \newcommand{\rectoproseemendation}[3][0]{%
10561 \ifemendationson%
10562 \rectotitleinnotescheck
10563 \unskip\proselinelabel{#2}%
10564 \setproselemmarange{#2}{#1}%
10565 \ifredundantemendations
10566 \iftextnoteson
10567 \ifrangelemma
10568 \rectoprosetextnote[#1]{#2}{#3}%
10569 \else
10570 \rectoprosetextnote{#2}{#3}%
10571 \fi % ifrangelemma}
10572 \fi %iftextnoteson
10573 \ifrectotextnotessinglepar%
10574 \literalrectotextnote{\par}%
10575 \fi% iftextnotessinglepar
10576 \fi % ifredundantemendations
10577 \ifnorectoemendationyet % firstemendation
10578 \firstrectoemendation
10579 \fi%noemendyet
10580 \global\norectoemendationyetfalse
10581 \immediate\write\rectoemendations{\checkprosenoteheaders}%
10582 \literalrectoemendation{#3}%
10583 \ifrectoemendationssinglepar%
10584 \literalrectoemendation{\par}%
10585 \fi% ifemendationssinglep
10586 \resetlemmacounters%
10587 \fi\unskip%
10588 }
10589 % \end{macrocode}
10590 % \end{macro}
10591 % \begin{macro}{\rectoproseexplanatory}
10592 % \begin{macrocode}
10593 \newcommand{\rectoproseexplanatory}[3][0]{%
10594 \ifexplanon%
10595 \rectotitleinnotescheck
10596 \unskip\proselinelabel{#2}%
10597 \setproselemmarange{#2}{#1}%
10598 \ifnorectoexplainyet% firstexplanation
10599 \firstrectoexplanatory%
10600 \fi%noexplainyet
10601 \global\norectoexplainyetfalse%
10602 \immediate\write\rectoexplanations{\checkprosenoteheaders}%
10603 \literalrectoexplain{#3}%
10604 \ifrectoexplanationssinglepar%
10605 \literalrectoexplain{\par}%
10606 \fi% ifexplanationssinglepar
10607 \resetlemmacounters%
10608 \fi\unskip%
10609 }
10610 % \end{macrocode}
10611 % \end{macro}
10612 % \begin{macro}{\pmclresetsettitleinnotes}
10613 % \begin{macrocode}
10614 \newcommand{\pmclresetsettitleinnotes}{%
10615 \noversoemendationyettrue%
10616 \noversoexplainyettrue%
10617 \noversotextnoteyettrue%
10618 \norectoemendationyettrue%
10619 \norectoexplainyettrue%
10620 \norectotextnoteyettrue%
10621 }
10622 % \end{macrocode}
10623 % \end{macro}
10624 % \begin{macro}{\pmclversoresetsettitleinnotes}
10625 % \begin{macrocode}
10626 \newcommand{\pmclversoresetsettitleinnotes}{%
10627 \noversoemendationyettrue%
10628 \noversoexplainyettrue%
10629 \noversotextnoteyettrue%
10630 }
10631 % \end{macrocode}
10632 % \end{macro}
10633 % \begin{macro}{\pmclrectoresetsettitleinnotes}
10634 % \begin{macrocode}
10635 \newcommand{\pmclrectoresetsettitleinnotes}{%
10636 \norectoemendationyettrue%
10637 \norectoexplainyettrue%
10638 \norectotextnoteyettrue%
10639 }
10640 % \end{macrocode}
10641 % \end{macro}
10642 % \begin{macro}{\literalexplain}
10643 % \begin{macrocode}
10644 \let\literalexplanatory=\literalexplain
10645 \let\literalversoexplanatory=\literalversoexplain
10646 \let\literalrectoexplanatory=\literalrectoexplain
10647 % \end{macrocode}
10648 % \end{macro}
10649 % \begin{macro}{\putversotextnotes} Does the same for textual notes.
10650 %
10651 % \begin{macrocode}
10652 \newcommand{\putversotextnotes}{
10653 \iftextnoteson
10654 \ifversotextnotestwocol
10655 \literalversotextnote{\end{multicols}}
10656 \fi %\iftextnotetwocol
10657 \newpage
10658 \hyphenationforsmall
10659 \immediate\closeout\versotextnotes
10660 \input \jobname.vtn
10661 \contentsendnotestitle{\the\versotextnotescontentsname}{versotextnotes}
10662 \else
10663 \relax
10664 \fi}
10665 % \end{macrocode}
10666 % \end{macro}
10667 % \begin{macro}{\putrectotextnotes} Does the same for recto textual notes.
10668 %
10669 % \begin{macrocode}
10670 \newcommand{\putrectotextnotes}{
10671 \iftextnoteson
10672 \ifrectotextnotestwocol
10673 \literalrectotextnote{\end{multicols}}
10674 \fi %\iftextnotetwocol
10675 \newpage
10676 \hyphenationforsmall
10677 \immediate\closeout\rectotextnotes
10678 \input \jobname.rtn
10679 \contentsendnotestitle{\the\rectotextnotescontentsname}{rectotextnotes}
10680 \else
10681 \relax
10682 \fi}
10683 % \end{macrocode}
10684 % \end{macro}
10685 % \begin{macro}{\putversoemendations} This macro closes external file
10686 % for verso emendations,
10687 % reads it in, and puts an entry for the emendations into the table of contents
10688 % file. The macro tests to see whether there is an .aux file from a previous run
10689 % before doing this, and complains in the .log file if the .aux file does not
10690 % exist.
10691 %
10692 % \begin{macrocode}
10693 \newcommand{\putversoemendations}{
10694 \ifemendationson
10695 \ifversoemendationstwocol
10696 \literalversoemendation{\end{multicols}}
10697 \fi %\iftextnotetwocol
10698 \newpage
10699 \hyphenationforsmall
10700 \immediate\closeout\versoemendations
10701 \input \jobname.vem
10702 \contentsendnotestitle{\the\versoemendationscontentsname}{versoemendations}
10703 \else
10704 \relax
10705 \fi}
10706 % \end{macrocode}
10707 % \end{macro}
10708 % \begin{macro}{\putrectoemendations} This macro closes external file
10709 % for recto emendations,
10710 % reads it in, and puts an entry for the emendations into the table of contents
10711 % file. The macro tests to see whether there is an .aux file from a previous run
10712 % before doing this, and complains in the .log file if the .aux file does not
10713 % exist.
10714 %
10715 % \begin{macrocode}
10716 \newcommand{\putrectoemendations}{
10717 \ifemendationson
10718 \ifrectoemendationstwocol
10719 \literalrectoemendation{\end{multicols}}
10720 \fi %\iftextnotetwocol
10721 \newpage
10722 \hyphenationforsmall
10723 \immediate\closeout\rectoemendations
10724 \input \jobname.rem
10725 \contentsendnotestitle{\the\rectoemendationscontentsname}{rectoemendations}
10726 \else
10727 \relax
10728 \fi}
10729 % \end{macrocode}
10730 % \end{macro}
10731 % \begin{macro}{\putversoexplanatorynotes} Does the same for verso explanatory notes.
10732 % \begin{macrocode}
10733 \newcommand{\putversoexplanatorynotes}{
10734 \ifexplanon
10735 \ifversoexplanationstwocol
10736 \literalversoexplain{\end{multicols}}
10737 \fi %\iftextnotetwocol
10738 \newpage
10739 \hyphenationforsmall
10740 \immediate\closeout\versoexplanations
10741 \input \jobname.vex
10742 \ifpoemcontentson
10743 \ifexplanon
10744 \contentsendnotestitle{\the\versoexplanationscontentsname}{versoexplanatorynotes}
10745 \fi
10746 \fi
10747 \else
10748 \relax
10749 \fi}% \end{macrocode}
10750 % \end{macro}
10751 % \begin{macro}{\putrectoexplanatorynotes} Does the same for recto explanatory notes.
10752 % \begin{macrocode}
10753 \newcommand{\putrectoexplanatorynotes}{
10754 \ifexplanon
10755 \ifrectoexplanationstwocol
10756 \literalrectoexplain{\end{multicols}}
10757 \fi %\iftextnotetwocol
10758 \newpage
10759 \hyphenationforsmall
10760 \immediate\closeout\rectoexplanations
10761 \input \jobname.rex
10762 \ifpoemcontentson
10763 \ifexplanon
10764 \contentsendnotestitle{\the\rectoexplanationscontentsname}{rectoexplanatorynotes}
10765 \fi
10766 \fi
10767 \else
10768 \relax
10769 \fi}
10770 % \end{macrocode}
10771 % \end{macro}
10772 % \subsection{~Parallel Texts in Prose}
10773 % First, some booleans.
10774 % \begin{macro}{\ifversopassagestillopen}
10775 % \begin{macrocode}
10776 \newif\ifversopassagestillopen
10777 \versopassagestillopenfalse
10778 \newif\ifrectopassagestillopen
10779 \rectopassagestillopenfalse
10780 % \end{macrocode}
10781 % \end{macro}
10782 % When the last recto page ended, was the last paragraph finished?
10783 % True means the next recto should continue the paragraph from the last recto
10784 % \begin{macro}{\ifinpara}
10785 % \begin{macrocode}
10786 \newif\ifinpara
10787 \inparafalse
10788 \newif\ifrectoparapending
10789 \rectoparapendingfalse
10790 \newif\ifrectoparaopen
10791 \rectoparaopenfalse
10792 \newif\ifversoparapending
10793 \versoparapendingfalse
10794 \newif\ifversoparaopen
10795 \versoparaopenfalse
10796 % \end{macrocode}
10797 % \end{macro}
10798 % Counters: prosepage versoproselinecounter, etc., and commands to set them.
10799 % \begin{macro}{\makeprosepagelabel}
10800 % \begin{macrocode}
10801 \newcounter{prosepage}
10802 \setcounter{prosepage}{1}
10803 \newcommand{\makeprosepagelabel}{\proselinelabel{prosepageno\theprosepage}}
10804 \newcounter{versoproselinecounter}
10805 \newcommand{\saveversoproseline}{%
10806 \refstepcounter{prosepage}%
10807 \makeprosepagelabel
10808 \setcounterfromref{versoproselinecounter}{prosepageno\theprosepage}
10809 }
10810 \newcommand{\restoreversoproseline}{\setcounter{linenumber}{\value{versoproselinecounter}}}%
10811 \newcounter{rectoproselinecounter}
10812 \newcommand{\saverectoproseline}{%
10813 \refstepcounter{prosepage}%
10814 \makeprosepagelabel
10815 \setcounterfromref{rectoproselinecounter}{prosepageno\theprosepage}
10816 }
10817 \newcommand{\restorerectoproseline}{\setcounter{linenumber}%
10818 {\value{rectoproselinecounter}}}%
10819 % \end{macrocode}
10820 % \end{macro}
10821 % The |\parastart| and |\paraend| macros, to mark the beginning and end
10822 % of paragraphs
10823 % \begin{macro}{\parastart}
10824 % \begin{macrocode}
10825 \newcommand{\parastart}{\inparatrue}
10826 % \end{macrocode}
10827 % \end{macro}
10828 % \begin{macro}{\paraend}
10829 % \begin{macrocode}
10830 \newcommand{\paraend}{\inparafalse}
10831 % \end{macrocode}
10832 % \end{macro}
10833 % |\startparalleltextsprose| and |\finishparalleltextsprose|
10834 % \begin{macro}{\startparalleltextsprose}
10835 % \begin{macrocode}
10836 \newcommand{\startparalleltextsprose}{%
10837 \leavevmode
10838 \cleartoverso
10839 \paralleltextstrue
10840 \inparafalse
10841 }
10842 % \end{macrocode}
10843 % \end{macro}
10844 % \begin{macro}{\finishparalleltextsprose}
10845 % \begin{macrocode}
10846 \newcommand{\finishparalleltextsprose}{%
10847 \paralleltextsfalse}
10848 % \end{macrocode}
10849 % \end{macro}
10850 % \begin{macro}{parallelprose}
10851 % \begin{macrocode}
10852 \newenvironment{parallelprose}{\startparalleltextprose} {\finishparalleltextsprose}
10853 % \end{macrocode}
10854 % \end{macro}
10855 % |\startversoprosepage|
10856 % \begin{macro}{\startversoprosepage}
10857 % \begin{macrocode}
10858 \newcommand{\startversoprosepage}{%
10859 \let\titletoothernotes=\versotitletoothernotes
10860 \restoreversoproseline%
10861 \ifversoparapending{\inparatrue}\else{\inparafalse}\fi%
10862 \ifinpara{\noindent}\else{\relax}\fi%
10863 }
10864 % \end{macrocode}
10865 % \end{macro}
10866 % |\finishversoprosepage|
10867 % \begin{macro}{\finishversoprosepage}
10868 % \begin{macrocode}
10869 \newcommand{\finishversoprosepage}{%
10870 \ifinpara{\versoparapendingtrue}\else{\versoparapendingfalse}\fi%
10871 \saveversoproseline%
10872 }
10873 % \end{macrocode}
10874 % \end{macro}
10875 % |\startrectoprosepage|
10876 % \begin{macro}{\startrectoprosepage}
10877 % \begin{macrocode}
10878 \newcommand{\startrectoprosepage}{%
10879 \let\titletoothernotes=\rectotitletoothernotes
10880 \restorerectoproseline%
10881 \ifrectoparapending{\inparatrue}\else{\inparafalse}\fi%
10882 \ifinpara{\noindent}\else{\relax}\fi%
10883 }
10884 % \end{macrocode}
10885 % \end{macro}
10886 % \begin{macro}{\finishrectoprosepage}
10887 % \begin{macrocode}
10888 \newcommand{\finishrectoprosepage}{%
10889 \ifinpara{\rectoparapendingtrue}\else{\rectoparapendingfalse}\fi%
10890 \saverectoproseline
10891 }
10892 % \end{macrocode}
10893 % \end{macro}
10894 % \subsection{~Finishing up}
10895 % \begin{macro}{\finish}
10896 % The |\finish| macro reads in the notes,
10897 % the index (previously created from your .aux file by MakeIndex), and
10898 % the contents sections and sets them. The notes sections send page
10899 % information to the contents file as they are set. Then the page
10900 % information for the index is sent to the contents file. Finally the
10901 % contents file is closed and read in. If you have an editor's
10902 % introduction or a list of abbreviations, copy this macro, uncomment out the commented out lines,
10903 % and issue it all as a |\renewcommand| for |\finish|. Be sure to
10904 % have the command |\label{editorsintroduction}| on the first page of
10905 % your introduction.
10906
10907 % It usually takes three
10908 % passes to get the table of contents and the index files correct.
10909 %
10910 % The consequence of doing using |\finish| is that the table of
10911 % contents comes last. There are ways around this that are described
10912 % earlier. The notes sections are all typeset in the |\small| size.
10913 %
10914 % \begin{macrocode}
10915 \newcommand{\finish}{
10916 \small\bf \hyphenchar\font=45
10917 \small\it \hyphenchar\font=45
10918 \small\rm \hyphenchar\font=45
10919
10920 \ifemendationson
10921 \newpage
10922 \immediate\closeout\emendations
10923 \input \jobname.emd
10924 \fi
10925 \iftextnoteson
10926 \newpage
10927 \immediate\closeout\textnotes
10928 \input \jobname.ent
10929 \newpage
10930 \fi
10931 \ifexplanon
10932 \immediate\closeout\explanations
10933 \input \jobname.enx
10934 \newpage
10935 \fi
10936 \ifindexingon
10937 \printindex
10938 \fi
10939 \ifpoemcontentson
10940 % \immediate\write\poemcontents{\string\vspace{10pt}\string\par}
10941 % \immediate\write
10942 % \poemcontents{\string\contentspoemtitlefont\ Introduction to the Notes}
10943 % \immediate\write
10944 % \poemcontents{\string~ / \string~\ \string\pageref{editorsintroduction} \string\par}
10945 % \immediate\write\poemcontents{\string\par \string\smallskip}
10946 % \immediate\write\poemcontents{\string\contentspoemtitlefont\ Abbreviations}
10947 % \immediate\write
10948 % \poemcontents{\string~ / \string~\ \string\pageref{abbreviations} \string\par}
10949 % \immediate\write\poemcontents{\string\par \string\smallskip}
10950 \ifemendationson
10951 \immediate\write\poemcontents{\string\contentspoemtitlefont\
10952 \the\emendationscontentsname}
10953 \immediate\write
10954 \poemcontents{\string~ / \string~\ \string\pageref{emendationnotes} \string\par}
10955 \immediate\write\poemcontents{\string\par \string\smallskip}
10956 \fi
10957 \iftextnoteson
10958 \immediate\write\poemcontents{\string\contentspoemtitlefont\
10959 \the\textnotescontentsname}
10960 \immediate\write
10961 \poemcontents{\string~ / \string~\ \string\pageref{textualnotes} \string\par}
10962 \immediate\write\poemcontents{\string\par \string\smallskip}
10963 \fi
10964 \ifexplanon
10965 \immediate\write
10966 \poemcontents{\string\contentspoemtitlefont\ \the\explanationscontentsname}
10967 \immediate\write
10968 \poemcontents{\string~ / \string~\ \string\pageref{explanatorynotes}}
10969 \fi
10970 \ifindexingon
10971 \immediate\write\poemcontents{\string\par \string\smallskip}
10972 \immediate\write
10973 \poemcontents{\string\contentspoemtitlefont\ \the\poemindexcontentsname}
10974 \immediate\write
10975 \poemcontents{\string~ / \string~\ \string\pageref{indexpage}\string\par}
10976 \fi
10977 \immediate\closeout\poemcontents
10978 \input \jobname.ctn
10979 \fi
10980 \clearpage
10981 \thispagestyle{volumetitlestyle}
10982 \vspace{106pt}
10983 \begin{center}
10984 {\poemtitlefont Note}
10985 \end{center}
10986
10987 \noindent The symbol \stanzaatbottomvalue\ is used to indicate
10988 a space between sections of a poem
10989 wherever such spaces are lost in pagination.
10990 \cleardoublepage
10991 }
10992 % \end{macrocode}
10993 % \end{macro}
10994 % \begin{macro}{\testforauxonfirstrun} Put this in the preamble. It suppresses
10995 % |\finish|, |\puttextnotes|, |\putemendations|, and |\putexplanatory| unless
10996 % there is an .aux file from a previous run, this avoiding some error messages.
10997 %
10998 % \begin{macrocode}
10999 \newcommand{\testforauxonfirstrun}{\IfFileExists{\jobname.aux}{\relax}
11000 {\let\finish=\relax
11001 \let\puttextnotes=\relax
11002 \let\putexplanatory=\relax
11003 \let\putemendations=\relax
11004 \typeout{Run again to read in endnotes files}}}
11005 % \end{macrocode}
11006 % \end{macro}
11007 % \begin{macro}{\putpoemcontents}
11008 % You may wish to do the tasks done by |\finish| separately. This will give you
11009 % more flexibility. |\putpoemcontents| inserts the table of contents file from a
11010 % prior run. Be sure to issue it \emph{before} you issue |\makepoemcontents.|
11011
11012 % \begin{macrocode}
11013 \newcommand{\putpoemcontents}{
11014 \IfFileExists{\jobname.ctn}{\input \jobname.ctn
11015 \clearpage \resetpagestyle\normalsize}
11016 {\typeout{Run again to input contents file here}}
11017 }
11018 % \end{macrocode}
11019 % \end{macro}
11020 % \begin{macro}{\hyphenationforsmall} This command restores hyphenation for the
11021 % backmatter sections of the book. Hyphenation is turned off in the main body of
11022 % the book, because verse should not be hyphenated. This macro turns hyphenation
11023 % on, but only for small roman, italic, and bold fonts. Backmatter sections are
11024 % all set in |\small|. |\putemendations|, |\puttextnotes|, and
11025 % |\putexplanatory| all call |\hyphenationforsmall|.
11026 %
11027 % \begin{macrocode}
11028 \newcommand{\hyphenationforsmall}{\small\bf \hyphenchar\font=45
11029 \small\it \hyphenchar\font=45
11030 \small\rm \hyphenchar\font=45
11031 }
11032 % \end{macrocode}
11033 % \end{macro}
11034 % \begin{macro}{\putemendations} This macro closes external file for emendations,
11035 % reads it in, and puts an entry for the emendations into the table of contents
11036 % file. The macro tests to see whether there is an .aux file from a previous run
11037 % before doing this, and complains in the .log file if the .aux file does not
11038 % exist.
11039 %
11040 % \begin{macrocode}
11041 \newcommand{\putemendations}{
11042 \ifemendationson
11043 \ifemendationstwocol
11044 \literalemend{\end{multicols}}
11045 \fi %\iftextnotetwocol
11046 \newpage
11047 \hyphenationforsmall
11048 \immediate\closeout\emendations
11049 \input \jobname.emd
11050 \contentsendnotestitle{\the\emendationscontentsname}{emendationnotes}
11051 \else
11052 \relax
11053 \fi}
11054 % \end{macrocode}
11055 % \end{macro}
11056 % \begin{macro}{\putexplanatory} Does the same for explanatory notes.
11057 %
11058 % \begin{macrocode}
11059 \newcommand{\putexplanatory}{
11060 \ifexplanon
11061 \ifexplanationstwocol
11062 \literalexplain{\end{multicols}}
11063 \fi %\iftextnotetwocol
11064 \newpage
11065 \hyphenationforsmall
11066 \immediate\closeout\explanations
11067 \input \jobname.enx
11068 \ifpoemcontentson
11069 \ifexplanon
11070 \contentsendnotestitle{\the\explanationscontentsname}{explanatorynotes}
11071 \fi
11072 \fi
11073 \else
11074 \relax
11075 \fi}
11076 % \end{macrocode}
11077 % \end{macro}
11078 % \begin{macro}{\puttextnotes} Does the same for textual notes.
11079 %
11080 % \begin{macrocode}
11081 \newcommand{\puttextnotes}{
11082 \iftextnoteson
11083 \iftextnotestwocol
11084 \literaltextnote{\end{multicols}}
11085 \fi %\iftextnotetwocol
11086 \newpage
11087 \hyphenationforsmall
11088 \immediate\closeout\textnotes
11089 \input \jobname.ent
11090 \contentsendnotestitle{\the\textnotescontentsname}{textualnotes}
11091 \else
11092 \relax
11093 \fi}
11094 % \end{macrocode}
11095 % \end{macro}
11096 % \begin{macro}{\putpoemindex} Reads in the index of titles and first lines
11097 % and adds an entry for the index
11098 % into the table of contents.
11099 %
11100 % \begin{macrocode}
11101 \newtoks{\poemindexname}
11102 \poemindexname={Index of Titles and First Lines}
11103 \newcommand{\changepoemindexname}[1]{\poemindexname={#1}}
11104 \newtoks{\poemindexheadername}
11105 \poemindexheadername={Index of Titles and First Lines}
11106 \newcommand{\changepoemindexheader}[1]{\poemindexheadername={#1}}
11107 \newtoks{\poemindexcontentsname}
11108 \poemindexcontentsname={Index of Titles and First Lines}
11109 \newcommand{\changepoemindexcontentsname}[1]{\poemindexcontentsname={#1}}
11110 \newcommand{\putpoemindex}{\ifindexingon
11111 \printindex
11112 \fi
11113 \ifpoemcontentson\ifindexingon
11114 \immediate\write\poemcontents{\string\par \string\smallskip}
11115 \immediate\write
11116 \poemcontents{\string\contentspoemtitlefont\ \the\poemindexcontentsname}
11117 \immediate\write
11118 \poemcontents{\string~\string\contentsleaders \string~\ \string\pageref{indexpage}\string\par}
11119 \fi\fi}
11120 \newcommand{\putmultiplepoemindex}[4]{%
11121 \ifindexingon
11122 \poemindexname={#2}
11123 \poemindexheadername={#3}
11124 \poemindexcontentsname={#4}
11125 \poemindexlabelname={#4}
11126 \printindex[#1][#2]
11127 \fi
11128 \ifpoemcontentson\ifindexingon
11129 \immediate\write\poemcontents{\string\par \string\smallskip}
11130 \immediate\write
11131 \poemcontents{\string\contentspoemtitlefont\ \the\poemindexcontentsname}
11132 \immediate\write
11133 \poemcontents{\string~ \string\contentsleaders \string~\
11134 \string\pageref{\the\poemindexlabelname}\string\par}
11135 \fi\fi
11136 }
11137 \newcommand{\noteaboutstanzamarkpage}{\begin{volumetitlepage}
11138 %\thispagestyle{volumetitlestyle}
11139 \vspace{106pt}
11140 \begin{center}
11141 {\poemtitlefont Note}
11142 \end{center}
11143
11144 \noindent The symbol \stanzaatbottomvalue\ is used to indicate
11145 a space between sections of a poem
11146 wherever such spaces are lost in pagination.
11147 \end{volumetitlepage}}
11148 % \end{macrocode}
11149 % \end{macro}
11150 % \subsection{~Visual formatting} The ideal in \LaTeX\ is to separate
11151 % content markup and formatting as completely as possible. In the text
11152 % itself you simply mark the logical units (a poem, a title, a stanza,
11153 % a textual note), and a header program like this interprets the
11154 % meaning of those terms typographically. However, one still winds up
11155 % having to do some visual formatting. Sometimes you have to enlarge or
11156 % shrink a page by one line in order to avoid an intractable widow or
11157 % club line, and when one does so one must be careful to do the same to
11158 % the other member of the two-page spread of which that page is a part.
11159 % These commands enable one to wiggle pagelength enough to handle these
11160 % problems.
11161 % \begin{macrocode}
11162 \newcommand{\longpage}{\enlargethispage{\baselineskip}}
11163 \newcommand{\shortpage}{\enlargethispage{-\baselineskip}}
11164 % \end{macrocode}
11165 %
11166
11167 % \subsection{~Special environments: cjquotation and theindex}
11168 % An environment for special prose quotations within verse
11169 % as in ``Chief Joseph of the Nez Perce''
11170 %
11171 % \goodbreak
11172 %
11173 % \begin{macro}{cjquotation}
11174 % \begin{macrocode}
11175 \newenvironment{cjquotation}
11176 {\tolerance=2000%
11177 \vspace{-\bigskipamount}
11178 \restoreverselinenumber
11179 \language=255
11180 \noindent\relax
11181 \list{}{\listparindent 0em%
11182 \itemindent 0em%
11183 \rightmargin 2em%
11184 \leftmargin 2em%
11185 \topsep 0em%
11186 \parskip 0em%
11187 \itemindent \listparindent
11188 \rightmargin \leftmargin
11189 \parsep \z@ \@plus\p@}%
11190 \item[]
11191 }
11192 {\endlist}
11193 % \end{macrocode}
11194 % \end{macro}
11195 % \begin{macro}{theindex}
11196 % And the environment for the index:
11197 % \begin{macrocode}
11198 \newtoks{\poemindexlabelname}
11199 \poemindexlabelname={indexpage}
11200 \newcommand{\changepoemindexlabelname}[1]{\poemindexlabelname={#1}}
11201 \renewenvironment{theindex}
11202 {{\par\clearpage{\pagestyle{volumetitlestyle}\cleardoublepage}
11203 \thispagestyle{volumetitlestyle}}
11204 \makeatletter
11205 \def\pmclidxitem{\par\hangindent 1em}
11206 \fancyhead[RO,LE]{{\small\textrm{\thepage}}}
11207 \fancyhead[CO]{{\small{\em \the\poemindexheadername}}}
11208 \fancyhead[CE]{{\small{\em \the\poemindexheadername}}}
11209 \fancyfoot{}
11210 \label{\the\poemindexlabelname}
11211 \lefthyphenmin=2\tolerance=500\language=0
11212 \normalfont \backmattertextfont
11213 \raggedright
11214 \begin{multicols}
11215 {2}[\backmattersink\begin{center}{\normalfont
11216 \backmatterheaderfont \the\poemindexname}\end{center}
11217 \backmatterafterheadersink]%
11218 \let\item\pmclidxitem}
11219 {\end{multicols}\clearpage}
11220 \makeatother
11221 % \end{macrocode}
11222 % \end{macro}
11223 % Finally, some other miscellaneous environments.
11224 % \begin{macrocode}
11225 \newlength{\epigraphquoteleftmargin}
11226 \newlength{\epigraphquoterightmargin}
11227 \setlength{\epigraphquoteleftmargin}{1.5em}
11228 \setlength{\epigraphquoterightmargin}{1.5em}
11229 \newif\ifleftalignepigraphs
11230 \leftalignepigraphsfalse
11231 \makeatletter
11232 \newenvironment{epigraphquote}{\list{}{%
11233 \ifleftalignepigraphs\left@ligntitleblock%
11234 \rightmargin 1sp\leftmargin \lefttitlemargin%
11235 \else
11236 \rightmargin\epigraphquoterightmargin%
11237 \leftmargin\epigraphquoteleftmargin%
11238 \fi
11239 \topsep 0pt%
11240 \partopsep 0pt%
11241 \listparindent 0pt%
11242 }%
11243 \item\relax}
11244 {\endlist}\makeatother
11245 \newenvironment{volumetitlepagequote}{\list{}{\rightmargin \voladditionalamount%
11246 \leftmargin \voladditionalamount%
11247 \topsep 0pt%
11248 \partopsep 0pt%
11249 \listparindent 0pt
11250 }%
11251 \item\relax}
11252 {\endlist}
11253 % \end{macrocode}
11254 % \clearpage
11255 % \Finale
11256 \endinput
11257 --------------060108090809060900030409--