Debian Codegraph @

texmf-dist/tex/latex-dev/tools/multicol-2024-05-23.sty

raw
1 %%
2 %% This is file `multicol.sty',
3 %% generated with the docstrip utility.
4 %%
5 %% The original source files were:
6 %%
7 %% multicol.dtx (with options: `package,badness,check,marktrace,nobalance')
8 %%
9 %% This is a generated file.
10 %%
11 %% The source is maintained by the LaTeX Project team and bug
12 %% reports for it can be opened at https://latex-project.org/bugs/
13 %% (but please observe conditions on bug reports sent to that address!)
14 %%
15 %% Copyright (C) 1993-2024
16 %% The LaTeX Project and any individual authors listed elsewhere
17 %% in this file.
18 %%
19 %% This file was generated from file(s) of the Standard LaTeX `Tools Bundle'.
20 %% --------------------------------------------------------------------------
21 %%
22 %% It may be distributed and/or modified under the
23 %% conditions of the LaTeX Project Public License, either version 1.3c
24 %% of this license or (at your option) any later version.
25 %% The latest version of this license is in
26 %% https://www.latex-project.org/lppl.txt
27 %% and version 1.3c or later is part of all distributions of LaTeX
28 %% version 2005/12/01 or later.
29 %%
30 %% This file may only be distributed together with a copy of the LaTeX
31 %% `Tools Bundle'. You may however distribute the LaTeX `Tools Bundle'
32 %% without such generated files.
33 %%
34 %% The list of all files belonging to the LaTeX `Tools Bundle' is
35 %% given in the file `manifest.txt'.
36 %%
37 %% Package `multicol' to use with LaTeX2e
38 %% Copyright 1989-2023 Frank Mittelbach
39 %%
40 %% In addition to the terms of LPPL any distributed version
41 %% (unchanged or modified) of multicol has to keep the statement
42 %% about the moral obligation for using multicol. In case of major
43 %% changes where this would not be appropriate the author of the
44 %% changed version should contact the copyright holder.
45 %%
46 %%
47 %% Moral obligation for using multicol:
48 %% ------------------------------------
49 %%
50 %% Users of multicol who wish to include or use multicol or a modified
51 %% version in a proprietary and commercially market product are asked
52 %% under certain conditions (see below) for the payment of a license
53 %% fee. The size of this fee is to be determined, in each instance,
54 %% by the commercial user, depending on his/her judgment of the value of
55 %% multicol for his/her product.
56 %%
57 %%
58 %% The conditions for this are as follows:
59 %%
60 %% The producer of a proprietary and commercially market product
61 %% that involves typesetting using multicol is asked to determine
62 %% the value of a license fee for using multicol if
63 %%
64 %% - the product is a document and the producer has decided to
65 %% include multicol to typeset (parts of) the document or has
66 %% directed the author of the document to include multicol (for
67 %% example, by providing a class file to be used by the author)
68 %%
69 %% - the product is a LaTeX class or package that includes multicol
70 %%
71 %%
72 %% There is no moral obligation in case
73 %%
74 %% - the product is a document but producer has not directed
75 %% the author to include multicol (in that case the moral obligation
76 %% lies with the author of the document)
77 %%
78 %% - the product does not involve typesetting, e.g., consists, for
79 %% example, of distributing multicol and its documentation.
80 %%
81 %% - the product is not proprietary, i.e., is made available as free
82 %% software itself (which doesn't prohibit its commercial marketing)
83 %%
84 %% - multicol is used for non-commercial purposes
85 %%
86 %%
87 %% Determining a license fee might result in a license fee of zero
88 %% (i.e., no payment) in case a producer has determined that the use
89 %% of multicol has no enhancing effect on the product. This is a
90 %% plausible scenario, i.e., in the above two cases the producer is
91 %% only asked to evaluate the value of multicol for the product
92 %% not for the payment of a license fee per se (which might or might
93 %% not follow from this evaluation).
94 %%
95 %% The license fee, if any, can be payed either to the LaTeX fund
96 %% (see ltx3info.txt in the base LaTeX distribution) or to the author of
97 %% the program who can be contacted at
98 %%
99 %% [email protected]
100 %%
101
102 \DeclareRelease{}{1994-06-01}{multicol-2017-04-11.sty}
103 \DeclareRelease{}{2017-04-11}{multicol-2017-04-11.sty}
104 \DeclareRelease{v1.8}{2019-10-01}{multicol-2019-10-01.sty}
105 \DeclareCurrentRelease{}{2021-11-15}
106
107 \ProvidesPackage{multicol}
108 [2024/05/23 v1.9h multicolumn formatting (FMi)]
109 \DeclareOption{twocolumn}
110 {\PackageWarning{multicol}{May not work
111 with the twocolumn option}}
112 \newcount\c@tracingmulticols
113 \DeclareOption{errorshow}
114 {\c@tracingmulticols\z@}
115 \DeclareOption{infoshow}
116 {\c@tracingmulticols\@ne}
117 \DeclareOption{balancingshow}
118 {\c@tracingmulticols\tw@}
119 \DeclareOption{markshow}
120 {\c@tracingmulticols\thr@@}
121 \DeclareOption{debugshow}
122 {\c@tracingmulticols5\relax}
123 \let\mc@gridwarn\maxdimen
124 \DeclareOption{grid}
125 {\def\mc@gridwarn{\@maxdepth}}
126 \DeclareOption{colaction}{%
127 \def\mc@col@status@write{%
128 \protected@write\@auxout{}%
129 {\string\mc@col@status
130 {\ifmc@firstcol 1\else 2\fi}}%
131 \mc@firstcolfalse}%
132 \def\mc@lastcol@status@write{%
133 \protected@write\@auxout{}%
134 {\string\mc@col@status{3}}}%
135 }
136 \let\mc@col@status@write\relax
137 \let\mc@lastcol@status@write\relax
138 \ProcessOptions
139 \def\multicols#1{\col@number#1\relax
140 \ifnum\col@number<\tw@
141 \PackageWarning{multicol}%
142 {Using `\number\col@number'
143 columns doesn't seem a good idea.^^J
144 I therefore use two columns instead}%
145 \col@number\tw@ \fi
146 \ifnum\col@number>20
147 \PackageError{multicol}%
148 {Too many columns}%
149 {Current implementation doesn't
150 support more than 20 columns.%
151 \MessageBreak
152 I therefore use 20 columns instead}%
153 \col@number20 \fi
154 \ifx\@footnotetext\mult@footnotetext
155 \else
156 \let\orig@footnotetext\@footnotetext
157 \let\@footnotetext\mult@footnotetext
158 \fi
159 \@ifnextchar[\mult@cols{\mult@cols[]}}
160 \long\def\mult@footnotetext#1{\begingroup
161 \columnwidth\textwidth
162 \orig@footnotetext{#1}\endgroup}
163 \def\mult@cols[#1]{\@ifnextchar[%
164 {\mult@@cols{#1}}%
165 {\mult@@cols{#1}[\premulticols]}}
166 \def\mult@@cols#1[#2]{%
167 \par
168 \ifinner \@boxedmulticolstrue
169 \else
170 \ifnum \doublecol@number>\z@
171 \@boxedmulticolstrue
172 \fi
173 \fi
174 \mult@info\z@
175 {Starting environment with
176 \the\col@number\space columns%
177 \if@boxedmulticols\MessageBreak
178 (boxed mode)\fi
179 }%
180 \enough@room{#2}%
181 #1\par\addvspace\multicolsep
182 \ifdim \prevdepth = -\@m\p@
183 \else
184 \@tempcnta\prevdepth
185 \@tempcntb\baselineskip
186 \divide\@tempcnta\@tempcntb
187 \advance\@tempcnta\@ne
188 \dimen@\prevdepth
189 \advance\dimen@ -\@tempcnta\baselineskip
190 \advance\dimen@ \topskip
191 \kern-\dimen@
192 \fi
193 \begingroup
194 \prepare@multicols
195 \if@boxedmulticols
196 \setbox\mult@box\vbox\bgroup
197 \color@setgroup
198 \fi
199 \ignorespaces}
200 \newif\if@boxedmulticols
201 \@boxedmulticolsfalse
202 \newbox\mult@box
203 \def\enough@room#1{%
204 \if@boxedmulticols\else
205 \par
206 \bgroup\@nobreakfalse\addpenalty\z@\egroup
207 \page@free \pagegoal
208 \advance \page@free -\pagetotal
209 \@tempskipa#1\relax
210 \mult@info\z@
211 {Current page:\MessageBreak
212 height=%
213 \the\pagegoal: used \the\pagetotal
214 \space -> free=\the\page@free
215 \MessageBreak
216 needed \the\@tempskipa
217 \space(for #1)}%
218 \ifdim \page@free <#1\newpage \fi
219 \fi}
220 \def\prepare@multicols{%
221 \multicol@leftmargin\@totalleftmargin
222 \@totalleftmargin\z@
223 \parshape\z@
224 \doublecol@number\col@number
225 \multiply\doublecol@number\tw@
226 \advance\doublecol@number\mult@rightbox
227 \if@boxedmulticols
228 \let\l@kept@firstmark\kept@firstmark
229 \let\l@kept@botmark\kept@botmark
230 \global\let\kept@firstmark\@empty
231 \global\let\kept@botmark\@empty
232 \else
233 \nointerlineskip {\topskip\z@\null}%
234 \output{%
235 \global\setbox\partial@page\vbox
236 {%
237 \ifvoid\partial@page\else
238 \PackageError{multicol}%
239 {Error saving partial page}%
240 {The part of the page before
241 the multicols environment was
242 nearly full with^^Jthe result
243 that starting the environment
244 will produce an overfull
245 page. Some^^Jtext may be lost!
246 Please increase \premulticols
247 either generally or for this%
248 ^^Jenvironment by specifying a
249 suitable value in the second
250 optional argument to^^Jthe
251 multicols environment.}
252 \unvbox\partial@page
253 \box\last@line
254 \fi
255 \unvbox\@cclv
256 \global\setbox\last@line\lastbox
257 }%
258 \prep@keptmarks
259 \global\let\kept@topmark\firstmark
260 }\eject
261 \advance\@colroom-\ht\partial@page
262 \set@mult@vsize\relax
263 \output{\multi@column@out}%
264 \init@mult@footins
265 \reinsert@footnotes
266 \def\clearpage{%
267 \ifx\@deferlist\@empty\else
268 \PackageError{multicol}%
269 {Deferred floats not cleared}%
270 {A \string\clearpage\space inside
271 multicols acts like
272 \string\newpage\space and doesn't
273 clear floats.\MessageBreak
274 Move it before the multicols
275 environment if you need it.}%
276 \fi
277 \newpage}%
278 \fi
279 \vbadness\@Mi \hbadness5000
280 \tolerance\multicoltolerance
281 \pretolerance\multicolpretolerance
282 \setemergencystretch\col@number\hsize
283 \set@floatcmds
284 \advance\baselineskip\multicolbaselineskip
285 \hsize\linewidth \advance\hsize\columnsep
286 \advance\hsize-\col@number\columnsep
287 \divide\hsize\col@number
288 \full@width\linewidth
289 \linewidth\hsize
290 \columnwidth\hsize
291 }
292 \def\init@mult@footins{%
293 \multiply\count\footins\col@number
294 \multiply\skip \footins\col@number
295 }
296 \def\set@mult@vsize#1{%
297 \vsize\@colroom
298 \@tempdima\baselineskip
299 \advance\@tempdima-\topskip
300 \advance\vsize\@tempdima
301 \vsize\col@number\vsize
302 \advance\vsize-\@tempdima
303 \advance\vsize\col@number\baselineskip
304 #1\advance\vsize
305 \c@collectmore\baselineskip}
306 \newdimen\multicol@leftmargin
307 \mathchardef\@Mvi=10006 % 10005 is
308 % \columnbreak
309 \def\endmulticols{\par
310 \if@boxedmulticols
311 \remove@discardable@items
312 \color@endgroup\egroup
313 \balance@columns
314 \return@nonemptymark{first}%
315 \kept@firstmark
316 \return@nonemptymark{bot}%
317 \kept@botmark
318 \global\setbox\mc@boxedresult\vbox{%
319 \page@sofar
320 \global\let\kept@firstmark
321 \l@kept@firstmark
322 \global\let\kept@botmark
323 \l@kept@botmark
324 }%
325 \mult@info\tw@
326 {Restore kept marks to\MessageBreak
327 first: \meaning\kept@firstmark
328 \MessageBreak bot\space\space:
329 \meaning\kept@botmark }%
330 \else
331 \ifdim\pagegoal=\maxdimen
332 \ifvoid\colbreak@box\else
333 \mult@info\@ne{Re-adding forced
334 break(s) for splitting}%
335 \unvbox\colbreak@box\fi
336 \fi
337 \penalty\z@
338 \penalty-\@Mvi
339 \ifvbox\partial@page
340 \unvbox\partial@page\fi
341 \global\let\kept@firstmark\@empty
342 \global\let\kept@botmark\@empty
343 \mult@info\tw@
344 {Make kept marks empty}%
345 \fi
346 \@checkend{multicols}%
347 \endgroup
348 \global\c@unbalance\z@
349 \if@boxedmulticols
350 \unvbox\mc@boxedresult
351 \mc@col@status@write
352 \else
353 \reinsert@footnotes
354 \ifdim \pagegoal=\maxdimen
355 \global\vsize\@colroom
356 \else
357 \enough@room\postmulticols
358 \fi
359 \fi
360 \addvspace\multicolsep
361 \prevdepth\z@
362 \mult@info\z@
363 {Ending environment
364 \if@boxedmulticols
365 \space(boxed mode)\fi
366 }}
367 \newcount\c@unbalance
368 \newcount\c@collectmore
369 \newcount\doublecol@number
370 \newcount\multicoltolerance
371 \newcount\multicolpretolerance
372 \newdimen\full@width
373 \newdimen\page@free
374 \newdimen\premulticols
375 \newdimen\postmulticols
376 \newskip\multicolsep
377 \newskip\multicolbaselineskip
378 \newbox\partial@page
379 \newbox\last@line
380 \newbox\mc@boxedresult
381 \c@unbalance = 0
382 \c@collectmore = 0
383 \multicoltolerance = 9999
384 \multicolpretolerance = -1
385 \premulticols = 50pt
386 \postmulticols= 20pt
387 \multicolsep = 12pt plus 4pt minus 3pt
388 \multicolbaselineskip=0pt
389 \def\process@cols#1#2{\count@#1\relax
390 \loop
391 #2%
392 \advance\count@\tw@
393 \ifnum\count@<\doublecol@number
394 \repeat}
395 \def\page@sofar{%
396 \process@cols\mult@rightbox
397 {\ifvoid\count@
398 \setbox\count@\hbox to\hsize{}%
399 \else
400 \wd\count@\hsize
401 \fi}%
402 \count@\col@number \advance\count@\m@ne
403 \mult@info\z@
404 {Column spec: \the\full@width\space = indent
405 + columns + sep =\MessageBreak
406 \the\multicol@leftmargin\space
407 + \the\col@number\space
408 x \the\hsize\space
409 + \the\count@\space
410 x \the\columnsep
411 }%
412 \ifvmode\else\errmessage{Multicol Error}\fi
413 \nointerlineskip
414 \setbox\z@\hbox{\multicolmindepthstring}\global\dimen\tw@\dp\z@
415 \moveright\multicol@leftmargin
416 \hbox to\full@width{%
417 \mc@align@columns
418 \rlap{\phantom \multicolmindepthstring}%
419 }%
420 \prevdepth\z@
421 \kern-\dimen\tw@
422 \ifdim\dimen\tw@ > \mc@gridwarn
423 \PackageWarning{multicol}%
424 {Very deep columns!\MessageBreak
425 Grid alignment might be broken}%
426 \fi
427 }
428 \def\multicolmindepthstring{p}
429 \def\columnseprulecolor{\normalcolor}
430 \def\reinsert@footnotes{\ifvoid\footins\else
431 \insert\footins{}\fi}
432 \def\vfilmaxdepth{\vskip \z@ \@plus .0001fil
433 \@minus \@maxdepth}
434 \def\multi@column@out{%
435 \ifnum\outputpenalty <-\@M
436 \speci@ls \else
437 \ifvoid\colbreak@box\else
438 \mult@info\@ne{Re-adding forced
439 break(s) for splitting}%
440 \setbox\@cclv\vbox{%
441 \unvbox\colbreak@box
442 \penalty-\@Mv
443 \unvbox\@cclv}%
444 \fi
445 \splittopskip\topskip
446 \splitmaxdepth\@maxdepth
447 \boxmaxdepth\@maxdepth
448 \dimen@\@colroom
449 \divide\skip\footins\col@number
450 \ifvoid\footins \else
451 \leave@mult@footins
452 \fi
453 \ifvbox \@kludgeins
454 \advance \dimen@ -\ht\@kludgeins
455 \ifdim \wd\@kludgeins>\z@
456 \shr@nkingtrue
457 \fi
458 \fi
459 \process@cols\mult@firstbox{%
460 \setbox\count@
461 \vsplit\@cclv to\dimen@
462 \set@keptmarks
463 \setbox\count@
464 \vbox to\dimen@
465 {\unvbox\count@
466 \ifshr@nking
467 \vfilmaxdepth\fi}%
468 }%
469 \setbox\mult@rightbox
470 \vsplit\@cclv to\dimen@
471 \set@keptmarks
472 \setbox\mult@rightbox\vbox to\dimen@
473 {\unvbox\mult@rightbox
474 \ifshr@nking\vfilmaxdepth\fi}%
475 \ifvoid\@cclv \else
476 \unvbox\@cclv
477 \ifnum\outputpenalty=\@M
478 \else
479 \penalty\outputpenalty
480 \fi
481 \ifvoid\footins\else
482 \PackageWarning{multicol}%
483 {I moved some lines to
484 the next page.\MessageBreak
485 Footnotes on page
486 \thepage\space might be wrong}%
487 \fi
488 \ifnum \c@tracingmulticols>\thr@@
489 \hrule\allowbreak \fi
490 \fi
491 \ifx\@empty\kept@firstmark
492 \let\firstmark\kept@topmark
493 \let\botmark\kept@topmark
494 \else
495 \let\firstmark\kept@firstmark
496 \let\botmark\kept@botmark
497 \fi
498 \let\topmark\kept@topmark
499 \mult@info\tw@
500 {Use kept top mark:\MessageBreak
501 \meaning\kept@topmark
502 \MessageBreak
503 Use kept first mark:\MessageBreak
504 \meaning\kept@firstmark
505 \MessageBreak
506 Use kept bot mark:\MessageBreak
507 \meaning\kept@botmark
508 \MessageBreak
509 Produce first mark:\MessageBreak
510 \meaning\firstmark
511 \MessageBreak
512 Produce bot mark:\MessageBreak
513 \meaning\botmark
514 \@gobbletwo}%
515 \boxmaxdepth\maxdimen
516 \setbox\@cclv\vbox{\unvbox\partial@page
517 \page@sofar}%
518 \@makecol\@outputpage
519 \global\let\kept@topmark\botmark
520 \global\let\kept@firstmark\@empty
521 \global\let\kept@botmark\@empty
522 \mult@info\tw@
523 {(Re)Init top mark:\MessageBreak
524 \meaning\kept@topmark
525 \@gobbletwo}%
526 \global\@colroom\@colht
527 \global \@mparbottom \z@
528 \global \@textfloatsheight \z@
529 \process@deferreds
530 \@whilesw\if@fcolmade\fi{\@outputpage
531 \global\@colroom\@colht
532 \process@deferreds}%
533 \mult@info\@ne
534 {Colroom:\MessageBreak
535 \the\@colht\space
536 after float space removed
537 = \the\@colroom \@gobble}%
538 \set@mult@vsize \global
539 \fi}
540 \def\leave@mult@footins{%
541 \advance\dimen@-\skip\footins
542 \advance\dimen@-\ht\footins
543 }
544 \def\speci@ls{%
545 \ifnum\outputpenalty <-\@Mi
546 \ifnum \outputpenalty<-\@MM
547 \PackageError{multicol}{Document end
548 inside multicols environment}\@ehd
549 \@specialoutput
550 \else
551 \ifnum\outputpenalty = -\@Mv
552 \mult@info\@ne{Forced column
553 break seen}%
554 \global\advance\vsize-\pagetotal
555 \global\setbox\colbreak@box
556 \vbox{%
557 \ifvoid\colbreak@box
558 \else
559 \unvbox\colbreak@box
560 \penalty-\@Mv
561 \fi
562 \boxmaxdepth\@maxdepth
563 \setbox\@cclv\vbox{%
564 \unvbox\@cclv
565 \remove@discardable@items}%
566 \dimen@\dp\@cclv
567 \unvbox\@cclv
568 \kern-\dimen@
569 }%
570 \reinsert@footnotes
571 \else
572 \ifnum\outputpenalty = -\@Mvi
573 \mult@info\@ne{End penalty of
574 multicols seen}%
575 \outputpenalty\@M % pretend we had
576 % a natural
577 % forced break
578 \balance@columns@out
579 \else
580 \PackageWarningNoLine{multicol}%
581 {Floats and marginpars not
582 allowed inside `multicols'
583 environment!}%
584 \unvbox\@cclv\reinsert@footnotes
585 \xdef\@freelist{\@freelist
586 \@currlist}%
587 \gdef\@currlist{}%
588 \fi
589 \fi
590 \fi
591 \else \@doclearpage \fi
592 }
593 \def\process@deferreds{%
594 \@floatplacement
595 \@tryfcolumn\@deferlist
596 \if@fcolmade\else
597 \begingroup
598 \let\@tempb\@deferlist
599 \gdef\@deferlist{}%
600 \let\@elt\@scolelt
601 \@tempb \endgroup
602 \fi}
603 \newif\ifshr@nking
604 \def\raggedcolumns{%
605 \@bsphack\shr@nkingtrue\@esphack}
606 \def\flushcolumns{%
607 \@bsphack\shr@nkingfalse\@esphack}
608 \def\balance@columns@out{%
609 \setbox\mult@box\vbox{%
610 \ifvoid\colbreak@box\else
611 \unvbox\colbreak@box
612 \penalty-\@Mv
613 \mult@info\@ne{Re-adding
614 forced break(s) in balancing}%
615 \fi
616 \unvbox\@cclv
617 \remove@discardable@items
618 }%
619 \balance@columns
620 \iftoo@bad
621 \mult@info\@ne
622 {Balancing failed ...
623 cut a normal page}%
624 \setbox\@cclv\vbox
625 {\vskip\topskip
626 \vskip-\splittopskip
627 \unvbox\mult@box
628 \penalty-\@Mvi
629 }%
630 \multi@column@out
631 \else
632 \global\vsize\@colroom
633 \global\advance\vsize\ht\partial@page
634 \ifvbox\@kludgeins
635 \insert\@kludgeins
636 {\unvbox\@kludgeins}\fi
637 \unvbox\partial@page
638 \return@nonemptymark{first}%
639 \kept@firstmark
640 \return@nonemptymark{bot}\kept@botmark
641 \page@sofar
642 \penalty\z@
643 \fi
644 }
645 \def\balance@columns{%
646 \get@keptmarks\mult@box
647 \setbox\mult@box\vbox{%
648 \penalty-\@M
649 \unvbox\mult@box
650 }%
651 \@tempdima\topskip
652 \splittopskip\@tempdima
653 \@plus\multicolundershoot
654 \@minus\multicolovershoot
655 \splitmaxdepth\@maxdepth
656 \boxmaxdepth\@maxdepth
657 \setbox\@tempboxa\vsplit\mult@box to\z@
658 \@tempdima\ht\mult@box
659 \advance\@tempdima\dp\mult@box
660 \divide\@tempdima\col@number
661 \count@\@tempdima
662 \divide\count@\baselineskip
663 \dimen@\count@\baselineskip
664 \advance\dimen@\topskip
665 \ifdim \dimen@ >\@tempdima
666 \advance\dimen@-\baselineskip
667 \fi
668 \@tempdima\dimexpr
669 \topskip +\c@minrows\baselineskip
670 -\baselineskip\relax
671 \ifnum\dimen@<\@tempdima
672 \mult@info\@ne
673 {Start value
674 \the\dimen@ \space ->
675 \the\@tempdima \space
676 (corrected for minrows)}%
677 \dimen@\@tempdima
678 \fi
679 \advance\dimen@\c@unbalance\baselineskip
680 \mult@info\@ne
681 {Balance columns\on@line:
682 \ifnum\c@unbalance=\z@\else
683 (off balance=\number\c@unbalance)\fi
684 \@gobbletwo}%
685 \ifnum\dimen@<\topskip
686 \mult@info\@ne
687 {Start value
688 \the\dimen@ \space ->
689 \the\topskip \space (corrected)}%
690 \dimen@\topskip
691 \fi
692 \vbadness\@M
693 \vfuzz \maxdimen
694 \last@try-\p@
695 \loop
696 {\process@cols\mult@grightbox
697 {\global\setbox\count@
698 \box\voidb@x}}%
699 \global\setbox\mult@grightbox
700 \copy\mult@box
701 \too@badfalse
702 \forcedbreak@leftoverfalse
703 {\process@cols\mult@gfirstbox{%
704 \global\setbox\count@
705 \vsplit\mult@grightbox to\dimen@
706 \global\setbox\count@
707 \vbox to\dimen@
708 {\unvbox\count@}%
709 \ifnum\c@tracingmulticols>\@ne
710 \@tempcnta\count@
711 \advance\@tempcnta-\mult@grightbox
712 \divide\@tempcnta \tw@
713 \message{^^JColumn
714 \number\@tempcnta\space
715 badness: \the\badness\space}%
716 \fi
717 \ifnum\badness>\c@columnbadness
718 \ifnum\c@tracingmulticols>\@ne
719 \message{too bad
720 (>\the\c@columnbadness)}%
721 \fi
722 \too@badtrue
723 \fi
724 }}%
725 \global\setbox\mult@grightbox
726 \vbox{\unvbox\mult@grightbox}%
727 \setbox\mult@nat@firstbox
728 \vbox{\unvcopy\mult@gfirstbox}%
729 \ifnum\c@tracingmulticols>\@ne
730 \message{^^JFirst column
731 = \the\dimen@\space
732 (\the\ht\mult@nat@firstbox)}\fi
733 \ifnum\c@tracingmulticols>\@ne
734 \message{<> last column =
735 \the\ht\mult@grightbox^^J}%
736 \fi
737 \ifdim\ht\mult@grightbox >\dimen@
738 \too@badtrue
739 \ifnum\c@tracingmulticols>\@ne
740 \typeout{Rejected: last
741 column too large!}%
742 \fi
743 \else
744 \setbox\@tempboxa
745 \copy\mult@grightbox
746 \setbox\z@\vsplit\@tempboxa to\maxdimen
747 \ifvoid\@tempboxa
748 \global\setbox\mult@grightbox
749 \vbox to\dimen@
750 {\unvbox\mult@grightbox}%
751 \ifnum\c@tracingmulticols>\@ne
752 \message{Final badness:
753 \the\badness}%
754 \fi
755 \ifnum\badness>\c@finalcolumnbadness
756 \global\setbox\mult@grightbox
757 \vbox to\dimen@
758 {\unvbox\mult@grightbox\vfil}%
759 \ifnum\c@tracingmulticols>\@ne
760 \message{ setting natural
761 (> \the\c@finalcolumnbadness)}%
762 \fi
763 \fi
764 \else
765 \@tempdima\@colroom
766 \advance\@tempdima \maxbalancingoverflow
767 \ifdim \dimen@ < \@tempdima
768 \too@badtrue
769 \ifnum\c@tracingmulticols>\@ne
770 \typeout{Rejected: unprocessed
771 forced break(s) in last column!}%
772 \fi
773 \else
774 \forcedbreak@leftovertrue
775 \ifnum\c@tracingmulticols>\@ne
776 \typeout{Failed: columns too large
777 with unprocessed forced break(s)!}%
778 \fi
779 \fi
780 \fi
781 \fi
782 \ifdim\ht\mult@nat@firstbox<\dimen@
783 \ifdim\ht\mult@nat@firstbox>\last@try
784 \too@badtrue
785 \ifnum\c@tracingmulticols>\@ne
786 \typeout{Retry: using natural
787 height of first column!}%
788 \fi
789 \dimen@\ht\mult@nat@firstbox
790 \last@try\dimen@
791 \advance\dimen@-\p@
792 \fi
793 \fi
794 \iftoo@bad
795 \advance\dimen@\p@
796 \repeat
797 \ifforcedbreak@leftover
798 \too@badtrue
799 \else
800 \if@boxedmulticols\else
801 \ifdim\dimen@>\@colroom
802 \dimen@\@colroom
803 \fi
804 \fi
805 \process@cols\mult@rightbox
806 {\@tempcnta\count@
807 \advance\@tempcnta\@ne
808 \vfuzz\z@
809 \setbox\count@\vbox to\dimen@
810 {%
811 \vskip \z@
812 \@plus-\multicolundershoot
813 \@minus-\multicolovershoot
814 \unvbox\@tempcnta
815 \ifshr@nking\vfilmaxdepth\fi
816 }%
817 \ifnum\badness>\@M
818 \vfuzz\maxdimen % no overfull warning
819 \setbox\@tempboxa \vbox to\dimen@
820 {\vskip-\maxbalancingoverflow
821 \unvcopy\count@}%
822 \ifnum\badness>\@M
823 \mult@info\@ne
824 {Balanced column more than
825 \the\maxbalancingoverflow\space
826 too large}%
827 \too@badtrue
828 \else
829 \mult@info\@ne
830 {Balanced column
831 too large, but less than
832 \the\maxbalancingoverflow}%
833 \fi
834 \fi
835 }%
836 \fi
837 }
838 \newdimen\maxbalancingoverflow
839 \maxbalancingoverflow=12pt
840
841 \ifnum\numexpr
842 \count20-\count14-1<40
843 % this is = 2 * 20
844 \count14=\@cclv
845 \fi
846 \newbox\mult@rightbox
847 \newbox\mult@grightbox
848 \newbox\mult@firstbox
849 \newbox\mult@gfirstbox
850 \newbox\@tempa\newbox\@tempa
851 \newbox\@tempa\newbox\@tempa
852 \newbox\@tempa\newbox\@tempa
853 \newbox\@tempa\newbox\@tempa
854 \newbox\@tempa\newbox\@tempa
855 \newbox\@tempa\newbox\@tempa
856 \newbox\@tempa\newbox\@tempa
857 \newbox\@tempa\newbox\@tempa
858 \newbox\@tempa\newbox\@tempa
859 \newbox\@tempa\newbox\@tempa
860 \newbox\@tempa\newbox\@tempa
861 \newbox\@tempa\newbox\@tempa
862 \newbox\@tempa\newbox\@tempa
863 \newbox\@tempa\newbox\@tempa
864 \newbox\@tempa\newbox\@tempa
865 \newbox\@tempa\newbox\@tempa
866 \newbox\@tempa\newbox\@tempa
867 \newbox\@tempa\newbox\@tempa
868 \let\@tempa\relax
869 \@ifundefined{emergencystretch}
870 {\newdimen\emergencystretch}{}
871 \def\setemergencystretch#1#2{%
872 \emergencystretch 4pt
873 \multiply\emergencystretch#1}
874
875 \def\set@floatcmds{%
876 \let\@dblfloat\@dbflt
877 \def\end@dblfloat{\@endfloatbox
878 \@largefloatcheck
879 \outer@nobreak
880 \ifnum\@floatpenalty<\z@
881 \@cons\@deferlist\@currbox
882 \fi
883 \ifnum\@floatpenalty=-\@Mii
884 \@Esphack
885 \fi}}
886 \def\kept@topmark{{}{}}
887 \let\kept@firstmark\@empty
888 \let\kept@botmark\@empty
889 \def\return@nonemptymark#1#2{%
890 \ifx#2\@empty
891 \else
892 \mult@info\tw@
893 {Returned #1 mark:\MessageBreak
894 \meaning#2}%
895 \toks@\expandafter{#2}%
896 \mark{\the\toks@}%
897 \nobreak
898 \fi}
899 \def\get@keptmarks#1{%
900 \begingroup
901 \vbadness\@M
902 \setbox#1\copy#1%
903 \mc@get@all@box@marks #1%
904 \set@keptmarks
905 \endgroup
906 }
907 \def\mc@get@all@box@marks #1{%
908 \setbox\@tempboxa\vsplit#1to\maxdimen
909 \ifvoid#1\else
910 \setbox#1\vbox{\unvbox\@tempboxa \unvbox#1}%
911 \mc@get@all@box@marks #1%
912 \fi
913 }
914 \def\set@keptmarks{%
915 \ifx\kept@firstmark\@empty
916 \expandafter\gdef\expandafter
917 \kept@firstmark
918 \expandafter{\splitfirstmark}%
919 \ifx\kept@firstmark\@empty\else
920 \mult@info\tw@
921 {Set kept first mark:\MessageBreak
922 \meaning\kept@firstmark%
923 \@gobbletwo}%
924 \fi
925 \fi
926 \expandafter\def\expandafter\@tempa
927 \expandafter{\splitbotmark}%
928 \ifx\@tempa\@empty\else
929 \global\let\kept@botmark\@tempa
930 \mult@info\tw@
931 {Set kept bot mark:\MessageBreak
932 \meaning\kept@botmark%
933 \@gobbletwo}%
934 \fi}%
935 \def\prep@keptmarks{%
936 \if@boxedmulticols \else
937 \get@keptmarks\partial@page
938 \fi}
939 \skip0=0pt
940 \edef\the@zero@skip{\the\skip0}
941 \def\remove@discardable@items{%
942 \unpenalty
943 \edef\@tempa{\the\lastskip}%
944 \unskip
945 \ifx\@tempa\the@zero@skip
946 \edef\@tempb{\the\lastskip}%
947 \ifx\@tempb\the@zero@skip
948 \else
949 \unskip
950 \ifnum \lastpenalty=\@M
951 \vskip\@tempb\vskip\@tempa\relax
952 \else
953 \remove@discardable@items
954 \fi
955 \fi
956 \else
957 \remove@discardable@items
958 \fi
959 }
960 \newif\iftoo@bad
961 \def\too@badtrue{\global\let\iftoo@bad\iftrue}
962 \def\too@badfalse{\global\let\iftoo@bad\iffalse}
963 \newif\ifforcedbreak@leftover
964 \newcount\c@minrows
965 \c@minrows=1
966 \newcount\c@columnbadness
967 \c@columnbadness=10000
968 \newcount\c@finalcolumnbadness
969 \c@finalcolumnbadness=9999
970
971 \newdimen\last@try
972
973 \newdimen\multicolovershoot
974 \newdimen\multicolundershoot
975 \multicolovershoot=0pt
976 \multicolundershoot=2pt
977 \newbox\mult@nat@firstbox
978 \def\mult@info#1#2{%
979 \ifnum\c@tracingmulticols>#1%
980 \GenericWarning
981 {(multicol)\@spaces\@spaces}%
982 {Package multicol: #2}%
983 \fi
984 }
985 \@namedef{multicols*}{%
986 \ifinner
987 \PackageWarning{multicol}%
988 {multicols* inside a box does
989 not make sense.\MessageBreak
990 Going to balance anyway}%
991 \else
992 \def\balance@columns@out
993 {\multi@column@out \penalty-\@Mvi }%
994 \fi
995 \begin{multicols}
996 }
997 \@namedef{endmulticols*}{%
998 \par
999 \ifdim\lastskip>\z@ \vskip-\lastskip \fi
1000 \ifdim \prevdepth>\z@
1001 \vskip-\ifdim\prevdepth>\boxmaxdepth
1002 \boxmaxdepth
1003 \else \prevdepth \fi
1004 \fi
1005 \ifshr@nking\else
1006 \vfil
1007 \fi
1008 \end{multicols}}
1009 \mathchardef\@Mv=10005
1010 \newcommand\columnbreak[1][4]{%
1011 \ifnum\col@number<\tw@
1012 \PackageError{multicol}%
1013 {\noexpand\columnbreak outside multicols}%
1014 {This command can only be used within
1015 a multicols or multicols* environment.}%
1016 \else
1017 \edef\mc@break@pen
1018 {-\ifcase#1\@m\or 3333\or 6666\or 9999\else\@Mv\fi\relax}%
1019 \ifvmode
1020 \penalty \mc@break@pen
1021 \else
1022 \@bsphack
1023 \vadjust{\penalty \mc@break@pen}%
1024 \@esphack
1025 \fi
1026 \fi}
1027 \newcommand\newcolumn{%
1028 \ifnum\col@number<\tw@
1029 \PackageError{multicol}%
1030 {\noexpand\newcolumn outside multicols}%
1031 {This command can only be used within
1032 a multicols or multicols* environment.}%
1033 \else
1034 \ifvmode
1035 \nobreak\vfill\kern\z@\penalty -\@Mv\relax
1036 \else
1037 \@bsphack
1038 \vadjust{\nobreak\vfill\kern\z@\penalty -\@Mv\relax}%
1039 \@esphack
1040 \fi
1041 \fi}
1042 \newbox\colbreak@box
1043 \def\LR@column@boxes{%
1044 \process@cols\mult@firstbox{%
1045 \ifdim\dp\count@>\dimen\tw@
1046 \global\dimen\tw@\dp\count@ \fi
1047 \mc@col@status@write
1048 \box\count@
1049 \hss{\columnseprulecolor\vrule
1050 \@width\columnseprule}\hss}%
1051 \ifdim\dp\mult@rightbox>\dimen\tw@
1052 \global\dimen\tw@\dp\mult@rightbox \fi
1053 \mc@lastcol@status@write
1054 \box\mult@rightbox
1055 }
1056
1057 \def\RL@column@boxes{%
1058 \process@cols\mult@firstbox{%
1059 \hskip\hsize
1060 \hss{\columnseprulecolor\vrule
1061 \@width\columnseprule}\hss
1062 }%
1063 \hskip\hsize
1064 \process@cols\mult@firstbox{%
1065 \ifdim\dp\count@>\dimen\tw@
1066 \global\dimen\tw@\dp\count@ \fi
1067 \hskip-\hsize
1068 \mc@col@status@write
1069 \box\count@
1070 \hskip-\hsize
1071 \hskip-\columnsep
1072 }%
1073 \ifdim\dp\mult@rightbox>\dimen\tw@
1074 \global\dimen\tw@\dp\mult@rightbox \fi
1075 \hskip-\hsize
1076 \mc@lastcol@status@write
1077 \box\mult@rightbox
1078 \hskip-\hsize
1079 \hskip\full@width
1080 }
1081 \newcommand\RLmulticolcolumns
1082 {\let\mc@align@columns
1083 \RL@column@boxes}
1084 \newcommand\LRmulticolcolumns
1085 {\let\mc@align@columns
1086 \LR@column@boxes}
1087 \LRmulticolcolumns
1088 \newcount\mc@col@check@num
1089
1090 \newcommand\docolaction{%
1091 \ifx\mc@col@status@write\relax
1092 \PackageError{multicol}%
1093 {Option 'colaction' not selected}%
1094 {\string\docolaction\space
1095 requires the use of the 'colaction'
1096 option on the package}%
1097 \fi
1098 \global\advance\mc@col@check@num\@ne
1099 \edef\mc@col@type{\expandafter\ifx
1100 \csname mc@col-\the\mc@col@check@num
1101 \endcsname\relax
1102 0\else
1103 \csname mc@col-\the\mc@col@check@num
1104 \endcsname
1105 \fi}%
1106 \@ifstar
1107 {\@docolactionstartrue \@docolaction}%
1108 {\@docolactionstarfalse\@docolaction}%
1109 }
1110 \newcommand\@docolaction[4][1]{%
1111 \edef\@docolactioncheck{\write\@auxout
1112 {\string\mc@set@col@status
1113 {mc@col-\the\mc@col@check@num}%
1114 {\mc@col@type}}}%
1115 \if@docolactionstar \@docolactioncheck \fi
1116 \ifcase \mc@col@type\relax
1117 \ifcase #1\or #2\or#3\or#4\fi
1118 \or
1119 #2% % 1 First col
1120 \or
1121 #3% % 2 any middle col
1122 \or
1123 #4% % 3 last col
1124 \else
1125 \ERRORwrongdefaultgiven
1126 \fi
1127 \if@docolactionstar \else \@docolactioncheck \fi
1128 }
1129 \newif\if@docolactionstar
1130 \def\mc@col@status#1{%
1131 \gdef\mc@curr@col@status{#1}}
1132 \def\mc@set@col@status#1#2{%
1133 \global\expandafter\let\csname #1\endcsname
1134 \mc@curr@col@status}
1135 \AtEndDocument{\def\mc@set@col@status#1#2{%
1136 \ifnum #2=\mc@curr@col@status\else
1137 \@tempswatrue
1138 \fi}%
1139 }
1140 \newif\ifmc@firstcol
1141 \mc@firstcoltrue
1142 \endinput
1143 %%
1144 %% End of file `multicol.sty'.