summaryrefslogtreecommitdiff
path: root/macros/latex/contrib/paracol/ref.dtx
blob: 4025a65d0843e60cbc2e5cc44f967d3fb843cf2e (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838
839
840
841
842
843
844
845
846
847
848
849
850
851
852
853
854
855
856
857
858
859
860
861
862
863
864
865
866
867
868
869
870
871
872
873
874
875
876
877
878
879
880
881
882
883
884
885
886
887
888
889
890
891
892
893
894
895
896
897
898
899
900
901
902
903
904
905
906
907
908
909
910
911
912
913
914
915
916
917
918
919
920
921
922
923
924
925
926
927
928
929
930
931
932
933
934
935
936
937
938
939
940
941
942
943
944
945
946
947
948
949
950
951
952
953
954
955
956
957
958
959
960
961
962
963
964
965
966
967
968
969
970
971
972
973
974
975
976
977
978
979
980
981
982
983
984
985
986
987
988
989
990
991
992
993
994
995
996
997
998
999
1000
1001
1002
1003
1004
1005
1006
1007
1008
1009
1010
1011
1012
1013
1014
1015
1016
1017
1018
1019
1020
1021
1022
1023
1024
1025
1026
1027
1028
1029
1030
1031
1032
1033
1034
1035
1036
1037
1038
1039
1040
1041
1042
1043
1044
1045
1046
1047
1048
1049
1050
1051
1052
1053
1054
1055
1056
1057
1058
1059
1060
1061
1062
1063
1064
1065
1066
1067
1068
1069
1070
1071
1072
1073
1074
1075
1076
1077
1078
1079
1080
1081
1082
1083
1084
1085
1086
1087
1088
1089
1090
1091
1092
1093
1094
1095
1096
1097
1098
1099
1100
1101
1102
1103
1104
1105
1106
1107
1108
1109
1110
1111
1112
1113
1114
1115
1116
1117
1118
1119
1120
1121
1122
1123
1124
1125
1126
1127
1128
1129
1130
1131
1132
1133
1134
1135
1136
1137
1138
1139
1140
1141
1142
1143
1144
1145
1146
1147
1148
1149
1150
1151
1152
1153
1154
1155
1156
1157
1158
1159
1160
1161
1162
1163
1164
1165
1166
1167
1168
1169
1170
1171
1172
1173
1174
1175
1176
1177
1178
1179
1180
1181
1182
1183
1184
1185
1186
1187
1188
1189
1190
1191
1192
1193
1194
1195
1196
1197
1198
1199
1200
1201
1202
1203
1204
1205
1206
1207
1208
1209
1210
1211
1212
1213
1214
1215
1216
1217
1218
1219
1220
1221
1222
1223
1224
1225
1226
1227
1228
1229
1230
1231
1232
1233
1234
1235
1236
1237
1238
1239
1240
1241
1242
1243
1244
1245
1246
1247
1248
1249
1250
1251
1252
1253
1254
1255
1256
1257
1258
1259
1260
1261
1262
1263
1264
1265
1266
1267
1268
1269
1270
1271
1272
1273
1274
1275
1276
1277
1278
1279
1280
1281
1282
1283
1284
1285
1286
1287
1288
1289
1290
1291
1292
1293
1294
1295
1296
1297
1298
1299
1300
1301
1302
1303
1304
1305
1306
1307
1308
1309
1310
1311
1312
1313
1314
1315
1316
1317
1318
1319
1320
1321
1322
1323
1324
1325
1326
1327
1328
1329
1330
1331
1332
1333
1334
1335
1336
1337
1338
1339
1340
1341
1342
1343
1344
1345
1346
1347
1348
1349
1350
1351
1352
1353
1354
1355
1356
1357
1358
1359
1360
1361
1362
1363
1364
1365
1366
1367
1368
1369
1370
1371
1372
1373
1374
1375
1376
1377
1378
1379
1380
1381
1382
1383
1384
1385
1386
1387
1388
1389
1390
1391
1392
1393
1394
1395
1396
1397
1398
1399
1400
1401
1402
1403
1404
1405
1406
1407
1408
1409
1410
1411
1412
1413
1414
1415
1416
1417
1418
1419
1420
1421
1422
1423
1424
1425
1426
1427
1428
1429
1430
1431
1432
1433
1434
1435
1436
1437
1438
1439
1440
1441
1442
1443
1444
1445
1446
1447
1448
1449
1450
1451
1452
1453
1454
1455
1456
1457
1458
1459
1460
1461
1462
1463
1464
1465
1466
1467
1468
1469
1470
1471
1472
1473
1474
1475
1476
1477
1478
1479
1480
1481
1482
1483
1484
1485
1486
1487
1488
1489
1490
1491
1492
1493
1494
1495
1496
1497
1498
1499
1500
1501
1502
1503
1504
1505
1506
1507
1508
1509
1510
1511
1512
1513
1514
1515
1516
1517
1518
1519
1520
1521
1522
1523
1524
1525
1526
1527
1528
1529
1530
1531
1532
1533
1534
1535
% \footnotelayout{m}
% \columnratio{}
% \section{Reference Manual}
% \label{sec:ref}
% \subsection{Environment \texttt{paracol}}
% \label{sec:ref-paracol}
% 
% \begin{description}
% \item[\ENV{paracol}{\marg{num}\oarg{text}}]\mbox{}\par
% The environment \env{paracol} contains \meta{body} typeset in \meta{num}
% columns in parallel.  The optional \meta{text} is put spanning all columns
% prior to the multi-columned \meta{body}.
% 
% \begin{itemize}
% \item
% \changes{v1.2-2}{2013/05/11}
% 	{Add a footnote mentioning page-wise footnotes merged with
%	 pre-environment staff.}
% \changes{v1.35-4}{2018/12/31}
% 	{Add description of \cs{belowfootnoteskip}.}
% 
% The environment may start from \emph{any} vertical position in a page,
% i.e., not necessary at the top of a page.  The single-column
% {\em\Uidx\preenv} of the {\em\Uidx\spage} in which \beginparacol{} lies
% are naturally connected to the beginning part of \meta{body} in each
% column, unless the page has footnotes\footnote{
% 
% With \Mgfnote{} layout shown in Section~\ref{sec:ref-scfnote}, the
% footnotes in the single-column contents are merged with those in
% \env{paracol} environment and are put at the bottom of the \spage{}
% together as shown in this page.}
% 
% or bottom floats.  If these kinds of bottom stuff exist, they are
% put above the multi-columned \meta{body}, or the spanning \meta{text}
% 
% \UsageIndex{spanning text}
% 
% if provided, with a vertical skip of \!\textfloatsep! separating them if
% bottom floats exist, or of \!\belowfootnoteskip! described in
% Section~\ref{sec:ref-scfnote} if only footnotes exist.  The
% \emph{deferred} floats which have not yet appeared in the starting page
% and thus will appear in the next or succeeding pages are considered as
% \pwise{} floats given in the environment.
% 
% \item
% \changes{v1.2-5}{2013/05/11}
% 	{Add an item to show that \string\texttt{paracol} can be enclosed in
%	 a \string\texttt{list}-like environment.}
% 
% The environment can be enclosed in a \env{list}{\em-like environment} such
% as \env{enumerate}, \env{itemize} and \env{description}.  If so, \!\item!s
% in each column are typeset using the parameters of the surrounding
% environment such as \!\leftmargin! and \!\rightmargin!.  For example, the
% following short \env{paracol} environment is included in an \env{itemize}
% for this and other \!\item!s in this page.
% 
% \begin{paracol}{2}
% \item
% This is the first \!\item! in the left column.
% 
% \item
% This is the second \!\item! in the left column followed by a
% \!\switchcolumn!\footnote{.
% 
% This footnote is to show the footnotes in this page are merged.}.
% \switchcolumn
% 
% \item
% This is the first \!\item! in the right column.
% 
% \item
% This is the second \!\item! in the right column.
% 
% \item
% This is the third and last \!\item! in the right column.
% \end{paracol}
% You are now seeing the switching to/from multi-columned and \env{itemize}d
% texts are naturally connected with the last and this single-columned
% sentences.  You may feel the space between two columns above is too large
% but it simply results from the large total \!\leftmargin!s of the outer
% \env{description} and this \env{itemize}, which make the right column
% shifted right.  A simple remedy for this large space is to make
% \!\columnsep! narrower, for example 0\,pt as shown below.
% 
% \columnsep0pt
% \begin{paracol}{2}
% \item
% This \!\item! is wider than the last \!\item! above because
% \!\columnsep! is 0\,pt.
% \switchcolumn
% 
% \item
% Therefore, this \!\item! is shifted left a little bit to make
% inter-column spece narrower.
% \end{paracol}
% 
% \item
% All \Uidx\lcounter{}s in all columns are initialized to have the values at
% \beginparacol{} on its first occurrence.  On the second and succeeding
% occurrences of \beginparacol, the \lcounter{}s in each column have the
% value at the last \Endparacol, unless they are modified after the
% \Endparacol.  If a counter is modified (or declared by \!\newcounter!)
% after the \Endparacol, the local versions of the counter in all columns
% commonly have the value at \beginparacol.
% 
% \item
% \changes{v1.2-2}{2013/05/11}
% 	{Add a footnote mentioning page-wise footnotes merged with
%	 post-environment staff.}
% 
% The environment may end at \emph{any} vertical position in a page, i.e.,
% the {\em\Uidx\postenv} being the single-column texts and others
% following \Endparacol{} in the {\em\Uidx\lpage} of the environment may not
% start from the top of a page.  If any columns don't have deferred
% \cwise{} floats and the most advanced {\em\Uidx\lcolumn} at
% \Endparacol{} has neither of footnotes\footnote{
% 
% With \Mgfnote{} layout shown in Section~\ref{sec:ref-scfnote}, the
% footnotes in the closing \env{paracol} environment are merged with those
% in \postenv{} and are put at the bottom of the page{} together as shown in
% this page.}
% 
% nor bottom floats, its bottom is naturally connected to the \postenv{}.
% If the \lcolumn{} has these kinds of bottom stuff, they are put above the
% \postenv{}, with a vertical skip of \!\textfloatsep! separating them if
% bottom floats exist.  All deferred \cwise{} floats given in the
% environment are flushed before the \postenv{} appears, possibly creating
% {\em\Uidx\fcolumn{}s} only with floats.  On the other hand, deferred
% \pwise{} floats given in the environment are considered as deferred
% (single-) \cwise{} floats given just after \Endparacol.
% 
% \item
% The values of all \lcounter{}s in the leftmost column are used as the
% initial values of them in the \postenv.
% 
% \item
% The \env{paracol} environment cannot be nested, or you will have an error
% message of illegal nesting.
% 
% \item
% The commands \!\switchcolumn!, \!\synccounter!, \!\syncallcounters! and
% \!\flushpage!, and environments \env{column}(|*|), \env{nthcolumn}(|*|),
% \env{leftcolumn}(|*|) and \env{rightcolumn}(|*|) are {\em local} to
% \env{paracol} environment and thus undefined outside the
% environment\footnote{
% 
% Unless you dare to define them.}.
% 
% The command \!\clearpage! is of course usable outside and inside the
% environment but its function inside is a little bit different from outside.
% \end{itemize}
% 
% 
% 
% \item[\ENV{paracol}{\oarg{numleft}\marg{num}\oarg{text}}]\mbox{}
% \Item[\ENV{paracol}{\oarg{numleft}\texttt{*}\marg{num}\oarg{text}}]
%   \mbox{}\par
% \changes{v1.3-2}{2013/09/17}
%	{Add description of parallel-paging.}
% 
% If a \beginparacol{} has the optional \meta{numleft} argument to specify
% the number of leading columns $n_l$ together with the total $n$ given by
% \meta{num}, columns in the environment are laid out across two adjacent
% pages.  In this {\em\Uidx\parapag{}e} typesetting, the first $n_l$ columns
% are placed in the {\em left} page while remaining $n_r=n-n_l$ columns go to
% the next {\em right} page.  The pair of left and right pages is
% considered as comprising a virtual {\em\Uidx\paired} page and thus shares
% a common page number, unless {\em\Uidx\npaired} typesetting is specified
% by the optional `|*|' following the optional \meta{numleft} argument.  In
% the \npaired{} \parapag{}ing, when the leading $n_l$ columns are put in a
% page $p$, the trailing $n_r$ columns are in the page $p+1$.
% 
% \begin{itemize}
% \item
% All {\em\Uidx\pwstuff}, i.e., \Preenv{} and \postenv, \pwise{} floats,
% \mctext{} and (\mgfnote{} or non-merged) \Scfnote{}s, are placed only in
% left \parapag{}es leaving corresponding regions in right \parapag{}es
% blank\footnote{
% 
% Someday the author could devise an advanced mechanism to exploit the space
% in right \parapag{}es.}.
% 
% \item
% A \npaired{} left \parapag{}e is not necessary to be even-numbered, though
% the printing tradition requires so if you naturally want to have a
% \parapag{}e pair in a double spread.  The page number given to the first
% left \parapag{}e is simply the number of the page $p_1$ in which
% \beginparacol{} reside, and that for the $k$-th left \parapag{}e is
% $p_1+2(k-1)$\footnote{
% 
% Unless you make some change to \counter{page} counter.}.
% 
% Therefore, to make it sure $p_1$ is even, you might need to have an
% ordinary page of blank, a title, etc., or to let \counter{page} counter have
% an even number by \!\setcounter!, etc., before starting a \env{paracol}
% environment.
%
% \item
% Section~\ref{sec:ppts} shows examples of \parapag{}ing together with
% related issues on two-sided typesetting.
% \end{itemize}
% \end{description}
% 
% 
% 
% \subsection{Column-Switching Command and Environments}
% \label{sec:ref-switchcolumn}
% 
% \begin{description}
% \item[\Midx{\!\switchcolumn!}\oarg{col}]\mbox{}
% \Item[\Midx{\!\switchcolumn!}\oarg{col}\texttt{*}\oarg{text}]\mbox{}\par
% The command switches columns from $i$ to $j$ where $i$ and $j$ is the
% zero-origin ordinals of the columns from/to which we are leaving\slash
% visiting respectively.  Without the optional \meta{col}, $j=i+1\bmod n$
% where $n$ is the number of columns given to \beginparacol, while
% $j=\meta{col}$ with the optional argument.  If the command (or
% \oarg{col} if specified) is followed by a |*|, the \cswitch{} takes
% place after \sync{}ation and, if specified, the optional spanning
% \meta{text} is put.
% 
% \Index{spanning text}
% 
% \begin{itemize}
% \item
% Using \!\switchcolumn! in a \env{list}-like environment \emph{included} in
% a \env{paracol} environment causes an ugly result without any error\slash
% warning messages.  This caution is effectual for all \csenv{}s too.
% 
% \item
% If $\meta{col}\notin\LBRP0n$, an error is reported and, if you dare to
% continue, you will switch to the leftmost column 0.
% 
% \item
% The \sync{}ation point is set just below the last line of the \lcolumn{}
% in a page $p$, partly taking deferred floats into account.  That is, all
% deferred floats are put in the pages up to $p-1$ and at the top of $p$ if
% possible.  Then, if a non-\lcolumn{} has footnotes and/or bottom floats
% and they cannot be pushed down below the \sync{}ation point, the point is
% moved to the next page top\footnote{
% 
% Or below top floats deferred to the page.}.
% 
% \item
% In a page having one or more \sync{}ation points, stretch and shrink
% factors of all vertical spaces, such as those surrounding sectionning
% commands, are ignored.  Therefore, even if you specify \!\flushbottom!,
% the page is typeset as if \!\raggedbottom! were specified.
% 
% \item
% After a \sync{}ation point is set, no top floats will be inserted in the page
% having the point, thus they will be deferred to the next page or further one.
% \end{itemize}
% 
% 
% 
% \item[\ENV{column}{}]\mbox{}
% \Item[\ENV{column*}{\oarg{text}}]\mbox{}\par
% The environment \env{column} contains \meta{body} for the column next to
% what we are in just before \!\begin!|{|\env{column}|}|.  The starred
% version \env{column*} does the same after \sync{}ation and, if specified,
% the optional spanning \meta{text} is put.
% 
% \Index{spanning text}
% 
% \begin{itemize}
% \item
% The environments are almost equivalent to;
% \begin{quote}
% |{|\!\switchcolumn!\quad\meta{body}\quad\CSIndex{par}|}|\\
% |{|\!\switchcolumn!|*|\oarg{text}\quad\meta{body}\quad\CSIndex{par}|}|
% \end{quote}
% except for their first occurrences which don't switch to the column 1
% (i.e., right column if two-columned) but stay in the leftmost column 0.
% More precisely, \!\begin!|{|\env{column}(|*|)|}| does not make \cswitch{}
% if it is not preceded by \!\switchcolumn! nor other \csenv{}s.
% 
% \item
% The \meta{body} of the environments cannot have \!\switchcolumn! nor
% \csenv{}s including \env{column}(|*|) themselves, or you will have an
% error message of illegal use of command\slash environment.
% 
% \item
% Column-switching\index{column-switching} does not take place at
% \!\end!|{|\env{column}(|*|)|}|.  Therefore, texts following the
% environments are put in the column in which \meta{body} resides until a
% \cswitch{} command\slash environment is given.
% \end{itemize}
% 
% 
% 
% \item[\ENV{nthcolumn}{\marg{col}}]\mbox{}
% \Item[\ENV{nthcolumn*}{\marg{col}\oarg{text}}]\mbox{}\par
% The environment \env{nthcolumn} contains \meta{body} for the column
% \meta{col}.  The starred version \env{nthcolumn*} does the same after
% \sync{}ation and, if specified, the optional spanning \meta{text} is put.
% 
% \Index{spanning text}
% 
% \begin{itemize}
% \item
% The environments are equivalent to;
% 
% \begin{quote}
% |{|\!\switchcolumn!\oarg{col}\quad\meta{body}\quad\CSIndex{par}|}|\\
% |{|\!\switchcolumn!\oarg{col}|*|\oarg{text}\quad
%     \meta{body}\quad\CSIndex{par}|}|
% \end{quote}
% 
% \item
% The \meta{body} of the environments cannot have \!\switchcolumn! nor
% \csenv{}s including \env{nthcolumn}(|*|) themselves, or you will have an
% error message of illegal use of command\slash environment.
% 
% \item
% Column-switching\index{column-switching} does not take place at
% \!\end!|{|\env{nthcolumn}(|*|)|}|.  Therefore, texts following the
% environments are put in the column in which \meta{body} resides until a
% \cswitch{} command\slash environment is given.
% \end{itemize}
% 
% 
% 
% \KeepSpace{4}
% \item[\ENV{leftcolumn}{}]\mbox{}
% \Item[\ENV{leftcolumn*}{\oarg{text}}]\mbox{}
% \Item[\ENV{rightcolumn}{}]\mbox{}
% \Item[\ENV{rightcolumn*}{\oarg{text}}]\mbox{}\par\nobreak
% The environment \env{leftcolumn} contains \meta{body} for the leftmost
% column 0, while \env{rightcolumn} for the column 1 being the right column
% in two-column typesetting.  The starred versions \env{leftcolumn*} and
% \env{rightcolumn*} do the same after \sync{}ation and, if specified, the
% optional spanning \meta{text} is put.
% 
% \Index{spanning text}
% 
% \begin{itemize}
% \item
% The environments \env{leftcolumn}(|*|) are equivalent to;
% 
% \begin{quote}
% \Env{nthcolumn}{\Arg{\texttt{0}}}\\
% \Env{nthcolumn*}{\Arg{\texttt{0}}\oarg{text}}
% \end{quote}
% 
% while \env{rightcolumn}(|*|) are equivalent to;
% 
% \begin{quote}
% \Env{nthcolumn}{\Arg{\texttt{1}}}\\
% \Env{nthcolumn*}{\Arg{\texttt{1}}\oarg{text}}
% \end{quote}
% 
% \end{itemize}
% 
% 
% 
% \item[\Midx{\!\thecolumn!}]\mbox{}\par
% \changes{v1.3-5}{2013/09/17}
%	{Add description of \cs{thecolumn}.}
% The command gives you the zero-origin ordinal of the column in which this
% command appears.  Therefore, the following code snip;
% 
% \begin{itemize}\item[]
% |\begin{paracol}{3}|\\
% |Column-\thecolumn.\switchcolumn|
% |Column-\thecolumn.\switchcolumn|
% |Column-\thecolumn.|\\
% |\end{paracol}|
% \end{itemize}
% 
% gives us the followings.
% 
% \par\medskip
% \begin{paracol}{3}
% Column-\thecolumn.\switchcolumn
% Column-\thecolumn.\switchcolumn
% Column-\thecolumn.
% \end{paracol}
% 
% \begin{itemize}
% \item
% The command is {\em neither} a \LaTeX's counter nor \!\count! register of
% native \TeX{}, and thus the value it keeps cannot be modified.  However,
% it can be used wherever an integer number is required or appropriate.
% Therefore for example, \!\setcounter!|{mycounter}{|\!\thecolumn!|}| works
% well to give the column ordinal to the counter |mycounter|.
% \end{itemize}
% 
% 
% 
% \item[\Midx{\!\definecolumnpreamble!}\marg{col}\marg{pream}]\mbox{}\par
% \changes{v1.35-5}{2018/12/31}
% 	{Add description of \cs{definecolumnpreamble}.}
% The command is to define the {\Uidx\colpream} \meta{pream} for the column
% \meta{col}, which is inserted at every \cswitch{} to the column.  More
% specifically, the command let \!\switchcolumn! to \meta{col} act as if you
% sepcify;
% 
% \begin{itemize}\item[]
% \!\switchcolumn! $\arg{pream\ for\ col}$
% \end{itemize}
% 
% and \csenv{}s such as \env{nthcolumn} act as if you specify;
% 
% \begin{itemize}\item[]
% |\begin{nthcolumn}{|\meta{col}|}| $\arg{pream\ for\ col}$
% 
% \end{itemize}
% 
% \begin{itemize}
% \item
% \begingroup\hfuzz1.5pt
% The optional \sptext{} of \!\switchcolumn!, \csenv{}s and \beginparacol{}
% is considered to be in a virtual column $-1$, and thus if you need a
% \Colpream{} for \sptext{}s do \!\definecolumnpreamble!|{-1}|\marg{pream}.
% \par\endgroup
% 
% \item
% The command may appear in a \env{paracol} environment and, if so,
% \meta{pream} is effective from the succeeding \cswitch{} to \meta{col}.
% 
% \item
% The definition of \meta{pream} is made globally.
% \end{itemize}
% 
% 
% 
% \item[\Midx{\!\ensurevspace!}\marg{len}]\mbox{}\par
% \changes{v1.3-5}{2013/09/17}
%	{Add description of \cs{ensurevspace}.}
% 
% The command tells the first \sync{}ing \cswitch{} command (i.e.,
% \!\switchcolumn!\oarg{col}|*|) or environment (i.e., \env{column*}, etc.\@)
% following this command that the page must be broken before \sync{}ation
% unless the \sync{}ation point has the space of \meta{len} or more below it
% in the page.  If a \sync{}ation does not have the command after the
% previous \sync{}ation, it is assumed that
% \!\ensurevspace!|{|\!\baselineskip!|}| is given.
% 
% \begin{itemize}
% \item
% This command is to be used when a \sync{}ation point would be placed near
% the bottom of a page $p$ and the space below it is not sufficient for a column
% $c$ to put anything in the page, while another column $c'$ can have a few
% lines in the page.  If this happens, the first line after the \sync{}ation
% should start at the top of the page $p+1$ in the column $c$, while that of
% $c'$ is still in the page $p$, giving you an impression that the
% \sync{}ation fails to align the top of all columns below it.  The fact is,
% however, the \sync{}ation point is properly established near at the bottom
% of the page but the first line of $c$ needs some large space due to, for
% example, the followings.
% 
% \begin{itemize}
% \item
% The line has unusually tall stuff including larger font letters.
% 
% \item
% The line has a footnote reference which is hardly apart from the
% footnote, and thus the line and the footnote go to the next page together.
% 
% \item
% The parameter \!\clubpenalty! is too large (e.g., 10000) to break the
% first and second lines into separate pages.
% 
% \item
% The first line follows a vertical space.
% \end{itemize}
% 
% \item
% This manual itself has some instances of \!\ensurevspace! command in the
% page \pageref{page:bfreude} and \pageref{page:efreude} in which each German
% stanza is enclosed in \env{verse} and then \env{leftcolumn*} environments
% and has \!\ensurevspace!|{2|\!\baselineskip!|}| before the \!\begin!ing of
% the outer \env{leftcolumn*} because the first line of the stanza is
% preceded by a vertical space inserted by \!\begin!|{|\env{verse}|}|.  In
% fact without \!\ensurevspace!, the first two lines of the sixth English
% stanza would be in the page \pageref{page:bfreude}, while corresponding
% German stanza go to the next page \pageref{page:efreude} as a whole, due
% to the difference of the height of footnotes in each column, i.e., German
% ones are taller than English ones to narrow the space for the German
% column.
% 
% \item
% As the author does in the ``An die Freude/To Joy'' example, it is a good
% tactics to have an \!\ensurevspace! with some vertical space larger than the
% default \!\baselineskip! if it is sure that a column has a feature shown
% above regardless of the position of the \sync{}ation point in question,
% because the point goes up or down with revisions of your document and
% using an \!\ensurevspace! for a \sync{}ation far above the page bottom is
% perfectly harmless.  Similarly, if you find a problem in a \sync{}ation
% and add an \!\ensurevspace! to solve it, keeping the command attached is
% recommended even when the \sync{}ation point moves up or down to make the
% command unnecessary.
% \end{itemize}
% \end{description}
% 
% 
% 
% \subsection{Commands for Column and Gap Width}
% \label{sec:ref-colwidth}
% 
% \begin{description}
% \item[\Midx{\!\columnratio!}\Arg{$r_0,r_1,\cdots,r_k$}
%                              {|[|$r'_0,r'_1,\cdots,r'_{k'}$|]|}]\mbox{}\par
% \changes{v1.1}{2012/05/11}
% 	{Add description of \cs{columnratio}.}
% \changes{v1.3-2}{2013/09/17}
%	{Add descriptino of the optional argument of \cs{columnratio} for
%	 parallel-paging.}
% 
% The command defines the width of each column by the fraction $r_i$ to
% specify the portion which $i$-th ($i=0$ for the leftmost) column
% occupies.  More specifically, the width $\Midx{\w}_i$ of the $i$-th column
% is defined as follows, where $W$ is \!\textwidth!, $S$ is \!\columnsep!,
% and $n$ is the number of columns given to \beginparacol.
% 
% \begin{eqnarray*}
% W'&=&W-(n-1)S\\
% w_i&=&\cases{
%   r_iW'
%     \vrule height1.5\ht\strutbox depth1.5\dp\strutbox width0pt&$i\leq k$\cr
%   \displaystyle{(1-\sum_{j=0}^k r_j)W'\over n-(k+1)}&$i>k$}
% \end{eqnarray*}
% 
% For a \env{paracol} environment with \parapag{}ing, $n$ is replaced with
% $n_l$ for the columns in left \parapag{}es, while $n$ and $w_i$ are
% replaced with $n_r$ and $w_{n_r+i}$ for those in right \parapag{}es.
% Moreover, if the optional argument having $r'_0,r'_1,\cdots,r'_{k'}$ is
% provided, $w_{n_r+i}$ for a column in right \parapag{}es is determined
% by $r'_i$ and $k'$ instead of $r_i$ and $k$.
% 
% \begin{itemize}
% \item
% The equations above imply that $k<n-1$, $r_i>0$ and $\sum_{j=0}^k
% r_j<1$.  If $k\geq n-1$, $k$ is assumed to be $n-2$ and all $r_i$ such
% that $i\geq n-1$ are ignored.  If $r_i$ or its sum does not satisfy the
% conditions, you will have an ugly result with ``Overfull'' messages.
% 
% \item
% The argument $r_0,r_1,\cdots,r_k$ can be empty to mean $k=-1$ to let all
% column widths be $W'/n$ as default.
% 
% \item
% The setting of column width by the command takes effect in the |paracol|
% environments following the command\footnote{
% 
% If the command is in a \texttt{paracol} environment, the command does not
% affect the column widths of the environment but does the next ones, though
% such usage is very unusual.}.
% 
% Therefore, though placing the command in the preamble is the most natural
% way\footnote{
% 
% Or second most to not using it at all, of course.},
% 
% you may place this command between two |paracol| environments to change
% the column layout for the second one even when they appear in a page as
% shown in Section~\ref{sec:man-close}.
% 
% \item
% \changes{v1.2-5}{2013/05/11}
% 	{Modify the description about \cs{linewidth} reflecting the fact
%	 that \string\texttt{paracol} may be included in a
%	 \string\texttt{list}-like environment.}
% 
% In the $i$-th column, \!\columnwidth! has $w_i$ and, for outermost
% paragraphs in the column, \!\hsize! has $w_i$ as well.  As for
% \!\linewidth!, it has $w_i-(\!\textwidth!-l)$ where $l$ is what
% \!\linewidth! had at \beginparacol{}, i.e., the \!\linewidth! for the
% \env{list}-like environment surrounding \env{paracol} if any, or
% \!\textwidth! otherwise.
% 
% \item
% You can specify width of each column and that of each {\em gap} between
% two columns more detailedly by \!\setcolumnwidth! shown below.  If your
% document has both of \!\columnratio! and \!\setcolumnwidth! prior to a
% \env{paracol} environment, the command given later is effective for the
% environment.
% \end{itemize}
% 
% 
% 
% \item[\Midx{\!\setcolumnwidth!}\Arg{$s_0,s_1,\cdots,s_k$}
%                              {|[|$s'_0,s'_1,\cdots,s'_{k'}$|]|}]\mbox{}\par
% \changes{v1.3-2}{2013/09/17}
%	{Add descriptino of \cs{setcolumnwidth}.}
% 
% The command defines the width of each column and that of each {\em gap}
% between two columns by the column/gap specification $s_i$ for the $i$-th
% column and the gap between it and the $(i{+}1)$-th column.  More
% specifically, $s_i$ has the form of $\hat w_i$ or $\hat w_i\,|/|\,\hat g_i$
% where each of $\hat w_i$ and $\hat g_i$ is a proper glue including a
% proper dimension, or an empty string to mean $\hat w_i=\!\fill!$ and $\hat
% g_i=\!\columnsep!$, to determine the width of $i$-th column $\w_i$ and that
% of $i$-th gap $\Midx{\gap}_i$ as follows, where $\mathit{nat}(x)$ is the
% natural width of the glue $x$, $\mathit{str}(x)$ is the infinite stretch
% factor of $x$, $W$ is \!\textwidth!, and $n$ is the number of columns
% given to \beginparacol.
% 
% \begin{eqnarray*}
% W'&=&\sum_{i=0}^{n-2}\big(\mathit{nat}(\hat w_i)+\mathit{nat}(\hat g_i)\big)+
%      \mathit{nat}(\hat w_{n-1})\\
% F&=&\sum_{i=0}^{n-2}\big(\mathit{str}(\hat g_i)+\mathit{str}(\hat g_i)\big)+
%      \mathit{str}(\hat w_{n-1})\\
% x_i&=&\cases{(W/W')\mathit{nat}(\hat x_i)&$W'\geq W\;\lor\;F\leq0$\cr
%              \mathit{nat}(\hat x_i)+(\mathit{str}(\hat x_i)/F)(W-W')&
%                                           $W'< W\;\land\;F>0$}
%     \qquad(x\in\{w,g\})
% \end{eqnarray*}
% That is, if the total of natural widths $W'$ is larger than \!\textwidth!
% $W$ or there are no infinite stretch factors in the specification, given
% widths are scaled down or up so that the scaled total is equal to $W$.
% Otherwise, each width with an infinite stretch factor is extended
% according to its ratio in the total stretch so that the stretched total is
% equal to $W$.
% 
% For a \env{paracol} environment with \parapag{}ing, $n$ is replaced with
% $n_l$ for the columns in left \parapag{}es, while $n$, $w_i$ and $g_i$ are
% replaced with $n_r$, $w_{n_r+i}$ and $g_{n_r+i}$ for those in right
% \parapag{}es.  Moreover, if the optional argument having
% $s'_0,s'_1,\cdots,s'_{k'}$ is provided, $w_{n_r+i}$ and $g_{n_r+i}$ for a
% column in right \parapag{}es are determined by $s'_i$ instead of $s_i$.
% 
% \begin{itemize}
% \item
% In \env{paracol} environments having $n$ columns, $s_i$ s.t.\ $i\geq n$
% and $\hat g_{n-1}$ are ignored.  On the other hand if $k<n-1$, it is
% assumed $s_i$ is an empty string for all $i>k$.
% 
% \item
% Finite stretch factors and finite or infinite shrink factors in $\hat w_i$
% and $\hat g_i$ are ignored.
% 
% \item
% Unlike \TeX's genuine glue addition, all infinite unit |fil|, |fill| and
% |filll| are not distinguished in the summation for $F$.  Also unlike
% \TeX's genuine scaling of a glue primitive, 
% $f\!\fill!$ means $0\,|pt|\ |plus|\ f\,|fill|$ for convenience\footnote{
% 
% In \TeX's grammar, $f\!\fill!$ means a dimension rather than a glue and is
% $0\,|pt|$ because the natural component of \!\fill! is 0.}.
% 
% \item
% The division $W/W'$ and $\mathit{str}(\hat x_i)/F$ can have some
% arithmetic errors and thus the total of $w_i$ and $g_i$ may not be equal to
% $W$ exactly but can be a little bit less than $W$.  This small error is,
% however, equally distributed to $g_i$ in typesetting of a page to make the
% total width of columns and gaps is exactly $W$\footnote{
% 
% If we may ignore the arithmetic error inherent in \TeX.}.
% 
% \item
% All the specifications shown in the table below give us same results for a
% \env{paracol} environment having three columns, providing
% $\!\textwidth!=360\,|pt|$ and $\!\columnsep!=S=20\,|pt|$.
% 
% \par\hbox to\textwidth\bgroup\hfil
% \nosv \def\|{\verb|}\small\arraycolsep0pt\def\arraystretch{1.1}
% $\begin{array}[b]{l|ccccc}
% s_0,s_1,s_2&w_0&g_0&w_1&g_1&w_2\rlap{ (in \texttt{pt})}\\\hline
% \|50pt/20pt,100pt/40pt,150pt|&50&20&100&40&150\\
% \|50pt,100pt/2\columnsep,150pt|&50&S&
%                                100&2S&150\\
% \|50pt/\fill,100pt/2\fill,150pt|&50&(1/3)\cdot60&100&(2/3)\cdot60&150\\
% \|,2\fill/2\columnsep,3\fill|&\ (1/6)\cdot300&S&
%                              (2/6)\cdot300&2S&
%                              (3/6)\cdot300\\
% \|50pt/20,50pt plus 1fil/40pt,50pt plus 2fil |&
%                              50&20&50+(1/3)\cdot150&40&
%                              50+(2/3)\cdot150\\
% \|5pt/2pt,10pt/4pt,15pt|&10\cdot5&10\cdot2&10\cdot10&10\cdot4&
%                         10\cdot15\\
% \|100pt/40pt,200pt/80pt,300pt|&0.5\cdot100&0.5\cdot40&
%                               0.5\cdot200&0.5\cdot80&
%                               0.5\cdot300
% \end{array}$\hfil\egroup
% 
% \item
% If your document has both of \!\columnratio! and \!\setcolumnwidth! prior
% to a \env{paracol} environment, the command given later is effective for
% the environment.
% \end{itemize}
% \end{description}
% 
% 
% 
% \subsection{Commands for Two-Sided Typesetting and Marginal Note Placement}
% \label{sec:ref-twoside}
% \changes{v1.3-3}{2013/09/17}
%	{Add the sub-section ``Commands for Two-Sided Typesetting and Marginal
%	 Note Placement''.}
% \changes{v1.3-4}{2013/09/17}
%	{Add the sub-section ``Commands for Two-Sided Typesetting and Marginal
%	 Note Placement''.}
% \changes{v1.3-5}{2013/09/17}
%	{Add the sub-section ``Commands for Two-Sided Typesetting and Marginal
%	 Note Placement''.}
% 
% \begin{description}
% \item[\Midx{\!\twosided!}{$|[|t_1t_2\cdots t_k|]|$}]\mbox{}\par
% \changes{v1.3-3}{2013/09/17}
%	{Add description of \cs{twosided}.}
% \changes{v1.3-4}{2013/09/17}
%	{Add description of \cs{twosided}.}
% \changes{v1.3-5}{2013/09/17}
%	{Add description of \cs{twosided}.}
% 
% The command enables a set of two-sided typesetting features
% $\Set{t_i}{t_i\in\{|p|,|c|,|m|,|b|\},\ 1\leq i\leq k}$ explicitly by the
% optional argument, or all of the following four features as a whole
% without the argument, in even-numbered pages.
% 
% \begin{description}
% \item[|p|\rm(\textit{age})]
% for ordinary two-sided paging, letting the left side margin be
% \!\evensidemargin!, page headers be different from those in odd-numbered
% pages with |headings| or |myheadings| page style, and \!\cleardoublepage!
% leave an even-numbered page blank if it is used in an odd-numbered page.
% 
% \item[|c|\rm(\textit{olumn})]
% for {\em\Uidx\cswap} to \emph{print} columns in even-numbered pages in
% reverse order.  This feature is sometimes preferable in typesetting
% especially with unbalanced parallel columns to make, for example, a wider
% columns are always \emph{inside} while narrower ones are \emph{outside}.
% 
% \item[|m|\rm(\textit{arginal text})]
% to place marginal notes in the side margin opposite to that specified by
% the command \!\marginparthreshold! discussed shortly.
% 
% \item[|b|\rm(\textit{ackground painting})]
% to make \bgpaint, shown in Section~\ref{sec:ref-bgpaint},
% \emph{\mirror{}ed} so that, for example, a color specified for the left
% margin is used to paint the right margin instead.
% \end{description}
% 
% \begin{itemize}
% \item
% The feature |p| is also enabled by the |twoside| option of
% \!\documentclass! with almost all classes including |article|, |book|,
% |report|, etc.  Though it is strongly recommended to make both settings by
% \!\documentclass! and this command consistent, they can be inconsistent
% resulting in lack of some expected functions.  For example, enabling |p|
% feature by \!\twosided! without |twoside| option in \!\documentclass!
% makes the format of headers and footers in all pages same even with
% \!\pagestyle!|{headings}|.
% 
% \item
% The \cswap{} enabled by the feature |c| is ineffective in \npaired{}
% \parapag{}ing because it is meaningless\footnote{
% 
% Unless somebody tells the author it is meaningful.},
% 
% and thus silently ignored.
% 
% \item
% In ordinary single-column typesetting, marginal note swapping in
% even-numbered pages is enabled by the |twoside| option, while it never takes
% place in ordinary two-column typesetting.  For marginal notes given in
% \env{paracol} environments, however, swapping of them in
% even-numbered pages is enabled by giving the feature |m| to \!\twosided!.
% 
% \item\label{page:cswap}
% The command has to be outside of \env{paracol} environments to decide the
% action in the environments following them.  If it appears in a
% \env{paracol} environment, you will have a warning message saying it is
% ignored.
% 
% \twosided[c]\columnratio{0.6}\columnsep0pt
% \begin{paracol}{2}
% \hfuzz2pt
% \item
% Here is an example of column swapping.  Since this page
% \pageref{page:cswap} is odd, this wider column-0 with roman font is placed
% in left side and thus inside at the begining, but now we are in an even
% page in which this column is in right side.
% 
% \switchcolumn
% \item\it
% This narrower, outside and italicized column-1 is at first in right
% side but the page break has changed the position to the left.
% \end{paracol}
% 
% \item
% \changes{v1.2-4}{2013/05/11}
% 	{Add description of \cs{[no]swapcolumninevenpages}.}
% \changes{v1.3-5}{2013/09/17}
% 	{Remove description of \cs{[no]swapcolumninevenpages} but mention
%	 they are still available.}
% 
% In old versions of \Paracol, namely 1.2 and its minor revisions 1.2x,
% \cswap{} was controlled by lengthy commmands
% \Midx{\!\swapcolumninevenpages!} and \Midx{\!\noswapcolumninevenpages!}.
% Though they are still available and will be so forever for backward
% compatibility, it is recommended to use \!\twosided! with or without the
% feature |c|.  The old versions also have a problem that \spanning{}
% crossing a page boundary is placed incorrectly after the page break in it,
% but this problem is solved by a fix incorporated in version 1.3.
% 
% \item
% It must be $t_i\in\{|p|,|c|,|m|,|b|\}$, or you will have an error message
% of illegal two-siding feature.
% 
% \item
% Section~\ref{sec:ppts} shows examples of two-sided typesetting together
% with related issues on \parapag{}ing.
% \end{itemize}
% 
% 
% 
% \item[\Midx{\!\marginparthreshold!}$\Arg{k}{|[|k'|]|}$]\mbox{}\par
% \changes{v1.3-4}{2013/09/17}
%	{Add description of \cs{marginparthreshold}.}
% 
% The command specifies the minimum ordinal $k$ of columns whose marginal
% notes are placed in right margin.  That is, marginal notes given in a
% column-$i$ go to left margin if $i<k$, while they go to right if $i\geq
% k$.  The optional argument $k'$, if given, is for columns in right
% \parapag{}es to decide the margin where their marginal notes are placed.
% In default, $k=1$ is assumed to let marginal notes from the leftmost
% column-0 go to left margin while those from other columns go to right.
% 
% \begin{itemize}
% \item
% You may specify $k=0$ to let all marginal notes go to right margin, or may
% give the command a large number, say 100, to place all of them in left
% margin.
% 
% \item
% The setting $k=0$ or $k=100$ above makes a side margin \emph{shared} by
% marginal notes from different columns, and sharing is inevitable when a
% (parallel-) page has three or more columns.  When a margin is shared by
% marginal notes from two or more columns, it can happen that two marginal
% notes from different columns conflict over the space to be occupied by each
% of them.  This conflict is solved by \Paracol{} to push down the note
% given later in your source |.tex| until an available space for it is
% found.  Note that the marginal note to be pushed down is determined by the
% position in the source rather than that in the printed result.  Also note
% that \Paracol{} exploits space between two marginal notes having been
% already placed in the placement of other note coming later to place it at
% the natural position if possible or to minimize the amount of pushing down
% otherwise.
% 
% \item
% In the decision of the real margin in which a marginal note is placed,
% other two factors are involved;  |m| feature of \!\twosided! command and
% the parity of the page; and \LaTeX's genuine command \!\reversemarginpar!.
% More specifically, after the first preliminary decision is made according
% to the threshold given to \!\marginparthreshold!, we have the following
% two steps to modify the decision;  if |m| feature has been specified in
% \!\twosided! command and the marginal note belongs to an even-numbered
% page, the decision is reversed to have the second preliminary result;  and
% then if \!\reversemarginpar! has been specified, the second result is
% reversed (again) to have the final result.
% 
% \item
% In old versions of \Paracol, namely older than 1.3, marginal note
% placement was not only uncontrollable but also gave ugly results when your
% document has three or more columns because the marginal notes from a column
% not being leftmost or rightmost were placed in the gap following the
% column rather than a margin.  This miserable {\em gap note} placement does
% not happen any more, or in other words this is no more available because
% the author believes nobody loves it.
% 
% \item
% Section~\ref{sec:ppts} shows examples of marginal note placement together
% with related issues on \parapag{}ing and two-sided typesetting.
% \end{itemize}
% 
% 
% 
% \item[\Midx{\!\marginnote!}\oarg{left}\marg{right}\oarg{voffset}]\mbox{}\par
% \changes{v1.35-3}{2018/12/31}
% 	{Add description of \cs{marginnote}.}
% You may use the package \textsf{marginnote} and its command \!\marginnote!
% in \env{paracol} environments as a replacement of \!\marginpar!.  However,
% the command is \emph{emulated} with \!\marginpar! and \textsf{paracol}'s
% own mechanism of marginal note placement.  Therefore, some of
% \textsf{marginnote}'s functionality are not effective in \env{paracol}
% environment except for the following features.
% 
% \begin{itemize}
% \item
% Shifting up/down a marginal note by the optional \meta{voffset}.
%
% \item
% Defining fonts (and others) for marginal notes by \!\marginfont!.
% 
% \item
% Controlling the holizontal paragraph alignment by \!\raggedleftmarginnote!
% and |\raggedright|\~|marginnote|\SpecialIndex{\raggedrightmarginnote}.
% \end{itemize}
% 
% Note that you will see a warning message ``|\margninnote| is emulated by
% |\marginpar|'' at the first in-\env{paracol} occurrence of the command to
% let you know the imperfection.
% \end{description}
% 
% 
% 
% \subsection{Commands for Counters}
% \label{sec:ref-counter}
% 
% \begin{description}
% \item[\Midx{\!\globalcounter!}\marg{ctr}]\mbox{}
% \Item[\Midx{\!\globalcounter!}\texttt{*}]\mbox{}\par
% \changes{v1.32-1}{2015/10/10}
% 	{Add descriptions of \cs{globalcounter*}.}
% 
% The command \!\globalcounter!\marg{ctr} declares that the counter
% \meta{ctr} is global to all columns, while \!\globalcounter!|*| does so
% for all counters.  An update of a \Uidx\gcounter{} in a column is seen by
% any other columns.
% 
% \begin{itemize}
% \item
% All column-local values of a descendant \lcounter{} of a \gcounter{} are
% zero-cleared when the \gcounter{} is explicitly stepped by \!\stepcounter!
% or \!\refstepcounter!, or implicitly by a sectioning command and so on.
% 
% \item
% The counter \counter{page} is always global but an explicit update of it
% by e.g., \!\setcounter! in a non-leftmost column is not seen by other
% columns and is canceled even for the column itself after a \cswitch{} or a
% page break in the column.  Therefore, if you want to make a \emph{jump} of
% \counter{page}, it must be done in the leftmost column 0.  Note that a
% jump from a page $p$ to $q$ can be seen in other columns even if they have
% gone beyond $p$ \emph{before} the column 0 makes the jump, as far as
% \counter{page} having $q$ (or its successor) is referred to by \!\pageref!
% or through \emph{contents} files such as |.toc|\footnote{
% 
% Direct reference to \counter{page} may give an inconsistent result, as you
% might have in ordinary \LaTeX{} documents.}.
% 
% \item
% All counters except for \counter{page} are local by default.  This feature
% may cause a problem with some packages including \textsf{marginnote} and
% \textsf{(auto-)pst-pdf} having their own counters which must be global.
% Since it is tough to find the name of such counters from package sources,
% if you have something wrong with these (or other) packages, try to put
% \!\globalcounter!|*| in your preamble and use \!\localcounter! shown below
% to localize specific counters which you need to be local.
% 
% \item
% Globalizing a \meta{ctr} being already global is just ignored without any
% complaints.
% \end{itemize}
% 
% 
% 
% \item[\Midx{\!\localcounter!}\marg{ctr}]\mbox{}\par
% The command declares that the counter \meta{ctr} is local for each column.
% 
% \begin{itemize}
% \item
% Though this command is intended for localizing a \meta{ctr} which is once
% globalized, localizing a local counter does not causes any error but is
% just ignored.  Localizing the permanently global \counter{page} is also
% just ignored without any complaints.
% \end{itemize}
% 
% 
% 
% \item[\Midx{\!\definethecounter!}\marg{ctr}\marg{col}\marg{rep}]\mbox{}\par
% The command defines |\the|\meta{ctr} being \marg{rep} for the local use in
% the column \meta{col}.  That is, |\the|\meta{ctr} in the column \meta{col}
% acts as if it is defined by
% \!\renewcommand!\Arg{\cs{the}\meta{ctr}}\Arg{\meta{rep}}.
% 
% 
% 
% \item[\Midx{\!\synccounter!}\marg{ctr}]\mbox{}\par
% The command \emph{broadcasts} the value of the \lcounter{} \meta{ctr} in
% the column in which the command appears to the values in all other columns.
% 
% \item[\Midx{\!\syncallcounters!}]\mbox{}\par
% The command broadcasts the values of all \lcounter{}s in the column in
% which the command appears to the values in all other columns.
% \end{description}
% 
% 
% 
% \subsection{Page-Wise Footnotes}
% \label{sec:ref-scfnote}
% \changes{v1.2-2}{2013/05/11}
% 	{Add the sub-section ``Single-Columned Footnotes'' to describe newly
%	 introducerd commands for page-wise footnotes.}
% \changes{v1.3-5}{2013/09/17}
%	{Rename the sub-section title from ``Single-Columned Footnotes'' to
% 	``Page-Wise Footnotes'' following new naming.}
% 
% \begin{description}
% \item[\Midx{\!\footnotelayout!}\marg{layout}]\mbox{}\par
% The command specifies the \meta{layout}${}\in\{|c|,|p|,|m|\}$ of footnotes
% in \env{paracol} environments as follows.
% 
% \begin{description}
% \item[|c|\rm(\textit{olumn})] makes footnotes {\em\Uidx\mcfnote} (aka
% multi-columned) being default to place footnotes in each column at the
% bottom of the column and separating them from \Preenv{} and \Postenv{}
% footnotes.
% 
% \item[|p|\rm(\textit{age})] makes footnotes {\em\Uidx\scfnote} (aka
% single-columned) so that footnotes in all columns are gathered, typeset
% spanning all columns, and placed at the bottom of the page in which they
% appear or at the end of the \env{paracol} environment they belong to, so
% that they are separated from \Preenv{} and \Postenv{} footnotes.
% 
% \item[|m|\rm(\textit{erge})] makes \Scfnote{}s {\em\Uidx\mgfnote} with
% footnotes in outside of the environment but in the same page, i.e., those
% in \Preenv{} and \postenv.
% \end{description}
% 
% 
% \begin{itemize}
% \item
% An example of \Mgfnote{} is found in p.~\pageref{sec:ref-paracol} while
% you will see many of them in Section~\ref{sec:fnnp}\footnote{
% 
% The left-column footnote \ref{fn:flush} in p.~\pageref{fn:flush} looks like
% a merged footnote because it is at the bottom of the page and the marked
% text is above the single-column text.  However, it is an ordinary
% \mcfnote{} one produced by a trick with \cs{footnotemark} and
% \cs{footnotetext} in different \env{paracol} environments.}.
% 
% \item
% In any layouts, a footnote cannot have page breaks in it, i.e., a footnote
% is always put in a page as a whole.  This makes it impossible to have a
% footnote taller than \!\textheight! and thus you will see a warning
% message if you give a very long footnote which will be printed intruding
% into the area for page footer (or out of the paper bound).
% 
% \item
% Choosing the layout |p|age-wise or |m|erged makes \counter{footnote}
% counter global and \!\fncounteradjustment!  shown below performed inside
% \!\footnotelayout!.  Choosing |c|olumn-wise let the command do the
% operations oppositely, i.e., localizes \counter{footnote} and does
% \!\nofncounteradjustment!.  Though these settings are usually appropriate
% for each footnote layout but you can override them by explicitly using
% commands like \!\localcounter!|{footnote}|.
% 
% \item
% The command has to be outside of \env{paracol} environments to decide the
% action in the environments following them.  If it appears in a
% \env{paracol} environment, you will have a warning message saying it is
% ignored.
% 
% \item
% \changes{v1.3-5}{2013/09/17}
% 	{Remove description of \cs{multicolumnfootnotes},
%	 \cs{singlecolumnfootnotes}, \cs{mergedfootnotes} but mention they
%	 are still available.}
% 
% In old versions of \Paracol, namely 1.2 and its minor revisions 1.2x,
% footnote layout was controlled by a set of lengthy commands
% \Midx{\!\multicolumnfootnotes!} for |c|, \Midx{\!\singlecolumnfootnotes!}
% for |p|, and \Midx{\!\mergedfootnotes!} for |m|.
% Though they are still available and will be so forever for backward
% compatibility, it is recommended to use \!\footnotelayout!\footnote{
% 
% Not only for type saving but also for being familiar with this command
% which could have some advanced feature, for example to put gathered
% footnotes into a specific column, someday.}.
% 
% % \item
% It must be $\meta{layout}\in\{|c|,|p|,|m|\}$, or you will have an error
% message of illegal layout specifier.
% \end{itemize}
% 
% 
% 
% \KeepSpace{5}
% \item[\Midx{\!\footnote!}\texttt{*}\oarg{num}\marg{text}]\mbox{}
% \Item[\Midx{\!\footnotemark!}\texttt{*}\oarg{num}]\mbox{}
% \Item[\Midx{\!\footnotetext!}\texttt{*}\oarg{num}\marg{text}]\mbox{}\par
% The starred version of \!\footnote!, \!\footnotemark! and \!\footnotetext!
% are for the adjustment of the footnote numbering, the order of footnote
% marks in main texts, and the stacking order of footnotes at page
% bottom.  Their usages with various examples are given in
% Section~\ref{sec:fnnp}.
% 
% 
% 
% \KeepSpace{3}
% \item[\Midx{\!\fncounteradjustment!}]\mbox{}
% \Item[\Midx{\!\nofncounteradjustment!}]\mbox{}\par
% The maintenance of \counter{footnote} with the starred footnote commands
% such as \!\footnote!|*| shown above causes out-of-order progress of the
% counter to make it hard to have a consistent counter value at
% \Endparacol.  The command \!\fncounteradjustment! is to let \Endparacol{}
% adjust the value of the counter based on its value at
% \beginparacol{} and the number of footnote commands in the environment.
% The command \!\nofncounteradjustment! is to tell \Endparacol{} to do
% nothing as in default.
% 
% \begin{itemize}
% \item
% Though \!\footnotelayout! with |p|(age-wise) or |m|(erged) argument does
% \!\fncounteradjustment! while that with |c|(olumn) does
% \!\nofncounteradjustment! inside of it, you can override these settings by
% explicitly putting a counter adjustment command after \!\footnotelayout!.
% 
% \item
% The effect of \!\fncounteradjustment! is shown in Section~\ref{sec:fnnp}.
% \end{itemize}
% 
% 
% \item[\Midx{\!\belowfootnoteskip!}]\mbox{}\par
% \changes{v1.35-4}{2018/12/31}
% 	{Add description of \cs{belowfootnoteskip}.}
% The typesetting parameter specifies the amount of the space inserted below
% footnotes of single-column \preenv{} if it does not have bottom floats.  The
% default amount is 0\,pt, i.e., no space is added.
% 
% \end{description}
% 
% 
% \KeepSpace{6}
% \subsection{Commands for Coloring Texts and Column-Separating Rules}
% \label{sec:ref-tcolor}
% \changes{v1.3-3}{2013/09/17}
%	{Rename the sub-sectoin title from ``Commands for Text Coloring'' to
%	 ``Commands for Coloring Texts and Column-Separating Rules'' to
%	 add description of the rule coloring together with the rule
%	 drawing itself.}
% 
% \begin{description}
% \item[\Midx{\!\columncolor!}\oarg{mode}\marg{color}\oarg{col}]\mbox{}
% \Item[\Midx{\!\normalcolumncolor!}\oarg{col}]\mbox{}\par
% \changes{v1.2-1}{2013/05/11}
%	{Add description of \cs{columncolor} and \cs{normlcolumncolor}.}
% 
% The command \!\columncolor! declares that the \emph{default color} of a
% column is \meta{color} or what it specifies by the combination with the
% optional \meta{mode}.  The command \!\normalcolumncolor! declares the
% default color is what \!\normalcolor! specifies, i.e., black usually.  The
% target column of these commands is that in which the commands reside, or
% \meta{col} if it specified.
% 
% \begin{itemize}
% \item
% The command may be outside of \env{paracol} environment.  If so and
% \meta{col} is not provided, the target column is the leftmost 0.
% 
% \item
% The default color declaration is \emph{global}.  Therefore, even if the
% command appears in a \env{paracol} environment (and even in some grouping
% structure in it), the declaration will be kept effective after
% \Endparacol{} to determine the default color of the specified column in
% succeeding \env{paracol} environments.
% 
% \item
% To give a color to texts (and maybe other stuff) in a column correctly,
% you need to load \textsf{color} package or its relative (e.g.,
% \textsf{xcolor}) which the implementation of coloring in \textsf{paracol}
% relies on.
% 
% \item
% Coloring with \!\color!\oarg{mode}\marg{color} and other coloring commands
% in \env{paracol} environments is of course allowed.  One caution is that
% the \!\color! decides the color for following texts until other
% specification is given or the group surrounding the command is closed.
% Therefore, \!\switchcolumn! does not affect the coloring but a color given
% to the texts in a column is also applied to the texts in the column to be
% switched to.  This irrelativeness of coloring and \cswitch{} is shown in
% the example below.
% 
% \twosided[]\columnratio{0.5}\columnsep0pt
% \tolerance5000\hbadness5000
% \begin{paracol}{2}
% \columncolor{blue}
% This column is colored blue because\\
% \mbox{}\qquad \!\columncolor!|{blue}|\\
% is specfied.  Here we have a \!\switchcolumn!.
% \switchcolumn
% \columncolor{red}
% This column is colored red because\\
% \mbox{}\qquad\!\columncolor!|{red}|\\
% is specified.
% 
% \begin{color}{green}
% Now the color of the right column is changed to green because\\
% \mbox{}\qquad\!\begin!|{color}{green}|\\
% is given prior to this paragraph.  Now we have another \!\switchcolumn! to
% go back to the left.
% \switchcolumn
% The color of this paragraph is green because we are still in the
% environment of green coloring, which we are now closing.\par
% \end{color}%
% 
% Since the coloring environment has been closed, the color of this
% paragraph is the default blue.  Now we have yet another and the last
% \!\switchcolumn! to the right.
% \switchcolumn
% Since this paragraph is outside of the coloring environment, its color is
% the default red.
% \end{paracol}
% 
% \normalcolumncolor[0]\normalcolumncolor[1]
% The default coloring of columns does not affect anything outside of
% \env{paracol} environment of course, and thus this sentence is not
% colored\footnote{
% 
% Or colored black as \cs{normalcolor} specifies.}.
% \end{itemize}
% 
% 
% 
% \KeepSpace{4}
% \item[\Midx{\!\coloredwordhyphenated!}]\mbox{}
% \Item[\Midx{\!\nocoloredwordhyphenated!}]\mbox{}\par
% \changes{v1.3-3}{2013/09/17}
%	{Add description of \cs{coloredwordhyphenated} and
%	 \cs{nocoloredwordhyphenated}.}
% 
% The command \!\coloredwordhyphenated! allows the first word following a
% coloring command such as \!\color! to be hyphenated, but at the same time
% make it possible that a line is broken before the word.  The command
% \!\nocoloredwordhyphenated! acts oppositely and thus line breaking before
% the first word and hyphenating it are inhibited.  By default,
% \!\coloredwordhyphenated! is effective.
% 
% \begin{itemize}
% \item
% The implementation of \textsf{color} package and its relatives makes it
% impossible that \meta{word} is hyphenated when it appears like
% |{|\!\color!|{red}|\meta{word} \ldots|}| or
% \!\textcolor!|{|\meta{word} \ldots|}|.  This inhibition of the hyphenation
% is sometimes annoying especially when the document is multi-columned and
% thus a line is narrow and a column is written in a language having long
% words such as German.  Therefore in \Paracol{} package, a trick is used to
% allow the \meta{word} is hyphenated.  However this trick being insertion
% of a null horizontal space has a side effect that the word can have a line
% break before it.  Though this line break is usually unharmful, in a
% special occasion the break is undesirable and
% in\textcolor{red}{appropriate} by making it possible that the
% \emph{half-colored} word `inappropriate' is broken between `in' and
% `appropriate' without hyphenation.  Therefore, if you find such a
% inappropriate break, use \!\nocoloredwordhyphenated! as follows, for example.
% \begin{quote}
% |{\nocoloredwordhyphenated in\textcolor{red}{appropriate}}|
% \end{quote}
% \end{itemize}
% 
% 
% \KeepSpace{4}
% \item[\Midx{\!\colseprulecolor!}\oarg{mode}\marg{color}\oarg{col}]\mbox{}
% \Item[\Midx{\!\normalcolseprulecolor!}\oarg{col}]\mbox{}\par
% \changes{v1.3-3}{2013/09/17}
%	{Add description of \cs{colseprulecolor} and
%	 \cs{normalcolseprulecolor}.}
% 
% The command \!\colseprulecolor! declares the color for
% {\em\Uidx\cseprule{}s}, being the vertical rules drawn at the center of
% gaps between columns, is \meta{color} or what it specifies by the
% combination with the optional \meta{mode}.  The command
% \!\normalcolseprulecolor! declares the color of rules is what
% \!\normalcolor! specifies, i.e., black usually.  If the optional argument
% \meta{col} is given, these commands specifies the color of the rule in the
% gap following the column whose ordinal is \meta{col}, rather than all rules.
% 
% \begin{itemize}
% \item
% The rules are drawn if \LaTeX's typesetting parameter \!\columnseprule!
% for the rule width has non-zero value, e.g., 0.4\,|pt| to obey the
% standard rule thickness.  The rules are \emph{not} drawn on \pwstuff{},
% i.e., \Preenv{} and \postenv, \pwise{} floats or (\mgfnote{} or
% non-merged) \Scfnote{}s of course but also \mctext{}s.  Therefore, if a
% page has \mctext{}s, the rules are {\em broken} by them as shown in the
% red rule example below.
% \global\unitlength\@totalleftmargin
% \end{itemize}
% \end{description}
% 
% \columnseprule0.4pt\colseprulecolor{red}[1]\colseprulecolor{white}[0]
% \setcolumnwidth{\unitlength/0pt}
% \begin{paracol}{3}\switchcolumn\noindent 
% This is a left column paragraph preceding a \mctext.  Of cource the rule
% separating this and the next column starts from the top of this paragraph.
% \switchcolumn\noindent
% This is a right column paragraph preceding a \mctext{} given by the
% \!\switchcolumn!|*| at its end.
% \switchcolumn[1]*[\subsubsection*{\hbox to\unitlength{}
% An Example of Spanning Text Given by \cs{subsubsection}|*| Command}]
% Since we have a \mctext{} above, the red rule separating this and the next
% column is broken by the text.
% \switchcolumn
% It is also natural that the rule separating this and the previous column is
% terminated at the end of this \env{paracol} environment.
% \end{paracol}
% \columnseprule0pt\columnratio{}
% 
% \begin{description}
% \Item[]\mbox{}
% \begin{itemize}
% \Item
% To give a color to rules correctly, you need to load \textsf{color}
% package or its relative (e.g., \textsf{xcolor}) which the implementation
% of coloring in \textsf{paracol} relies on.
% 
% \item
% Once you give a color to rules in a specific gap with the optional
% \meta{col}, another \!\colseprulecolor! or \!\normalcolseprulecolor!
% without \meta{col} does \emph{not} change the color of the rule in the
% gap.
% \end{itemize}
% \end{description}
% 
% 
% 
% \KeepSpace{7}
% \subsection{Commands for Background Painting}
% \label{sec:ref-bgpaint}
% \changes{v1.3-3}{2013/09/17}
%	{Add the sub-section ``Commands for Background Painting.}
% 
% \begin{description}
% \item[\Midx{\!\backgroundcolor!}\marg{region}\oarg{mode}\marg{color}]
%     \mbox{}\par
% \Item[\Midx{\!\backgroundcolor!}
%     \Arg{\meta{region}$|(|x_0|,|y_0|)|$}\oarg{mode}\marg{color}]
%     \mbox{}\par
% \Item[\Midx{\!\backgroundcolor!}
%     \Arg{\meta{region}$|(|x_0|,|y_0|)||(|x_1|,|y_1|)|$}
%     \oarg{mode}\marg{color}]
%     \mbox{}\par
% \changes{v1.3-3}{2013/09/17}
%	{Add description of \cs{backgroundcolor}.}
% 
% The command declares that {\em\Uidx\bgpaint} of \meta{region} is performed
% with \meta{color} or what it specifies by the combination of the optional
% \meta{mode}.  The \meta{region} whose \bground{} is painted is one of the
% following.
% 
% \begin{description}
% \item[|c|\rm(\textit{olumn})] for all columns, or particular one if
% \meta{region} is |c|\oarg{col} to specify its ordinal \meta{col}.
% 
% \item[|g|\rm(\textit{ap})] for all gaps between columns, or particular one
% if \meta{region} is |g|\oarg{col} to specify the ordinal \meta{col} of the
% column preceding the gap.
% 
% \item[|s|\rm(\textit{panning})] for \mctext{}s.
% 
% \item[|f|\rm(\textit{loat})] for \pwise{} floats.
% 
% \item[|n|\rm(\textit{ote})] for (\mgfnote{} or non-merged) \Scfnote{}s.
% 
% \item[|p|\rm(\textit{re/post})] for \Preenv{} and \postenv.
% 
% \item[|t|\rm(\textit{op})] for top margin.
% 
% \item[|b|\rm(\textit{ottom})] for bottom margin.
% 
% \item[|l|\rm(\textit{eft})] for left margin.
% 
% \item[|r|\rm(\textit{ight})] for right margin.
% \end{description}
% 
% In addition, capitals of the keys above, i.e., |C|, |G|, \ldots, |L|, are
% also legitimate for {\em under painting}.  For example, you may specify to
% paint the \bground{} of a region, say top margin, by two
% \!\backgroundcolor! with |t| and |T| and with different color arranging the
% size of the region of either |t| or |T| (or both of them) by the
% \emph{\bgext} option shown below.
% 
% The optional $|(|x_0|,|y_0|)|$ is to enlarge the region to be painted
% shifting its left-top and right-bottom corner outside by
% the dimension $x_0$ horizontally and $y_0$ vertically, or to shrink it
% with negative dimensions.  This {\em\Uidx\bgext} can be asymmetric giving
% another optional $|(|x_1|,|y_1|)|$ so that it acts on the right-bottom
% corner while let $|(|x_0|,|y_0|)|$ shift only the left-top corner.
% Moreover, you may make each \bgext{} {\em infinite} by giving 10000\,|pt|
% (about 3.5\,m) to $x_0$, $y_0$, $x_1$ and/or $y_1$ so that the
% corresponding region edge is shifted to the paper edge.  Furthermore, this
% {\em\Uidx\bginfext{}} can be terminated at the point $\alpha$ inside the
% corresponding paper edge by giving $10000\,|pt|-\alpha$
% ($\alpha\leq1000\,|pt|$) to an extension parameter $x_0$, etc.
% 
% \begin{itemize}
% \item
% A region whose color is not specified is not painted and thus left blank
% (or kept as painted by \!\pagecolor! if you specify it).
% 
% \item
% Under-painting of columns and gaps by |C| and |G| is made for regions
% different from those over-painting |c| and |g|.  That is, under-painting
% is done ignoring all \pwstuff{} and thus the height of the regions is
% always $\!\textheight!+\!\maxdepth!$.  On the other hand, over-painting is
% only for chunks shrunk or separated by \pwstuff.
% 
% \item
% You may exploit the following painting order, where $x_i$
% is the $i$-th \mctext{} ($x\in\{|s|,|S|\}$) or $i$-th chunk followed by
% the $i$-th \mctext, $m$ and $n$ is the number of \mctext{}s and columns in
% a page respectively, to overlay a preceding region with a succeeding
% region, if your \emph{printer} allows overlaid color painting.
% 
% \begin{eqnarray*}
% |T|&\to&|B|\to|L|\to|R|
%     \to|G[|0|]|\to\cdots\to|G[|n{-}1|]|\to|C[|0|]|\to\cdots\to|C[|n{-}1|]|\\
% &\to&|t|\to|b|\to|l|\to|r|\to|N|\to|n|\to\{|F|,|P|\}\to\{|f|,|p|\}
%  \to|S|_1\to\cdots\to|S|_m\\
% &\to&|g|_1|[|0|]|\to\cdots|g|_1|[|n{-}2|]|\to
%      |c|_1|[|0|]|\to\cdots|c|_1|[|n{-}1|]|\to|s|_1\\
% &\to&\cdots\\
% &\to&|g|_m|[|0|]|\to\cdots|g|_m|[|n{-}2|]|\to
%      |c|_m|[|0|]|\to\cdots|c|_m|[|n{-}1|]|\to|s|_m\\
% &\to&|g|_{m+1}|[|0|]|\to\cdots|g|_{m+1}|[|n{-}2|]|\to
%      |c|_{m+1}|[|0|]|\to\cdots|c|_m|[|n{-}1|]|
% \end{eqnarray*}
% 
% \item
% If you specify |b| feature by \!\twosided!, \bgpaint{} is
% {\em\Uidx\mirror{}ed} in even-numbered pages so that |l| and |L| mean
% right margin, |r| and |R| mean left margin, and asymmetric extensions are
% applied to right-top and left-bottom corners.
% 
% \item
% To give a color for \bgpaint{} correctly, you need to load \textsf{color}
% package or its relative (e.g., \textsf{xcolor}) which the implementation
% of coloring in \textsf{paracol} relies on.
% 
% \item
% To paint margins and regions having infinite extension correctly, the
% parameters \!\paperwidth! and \!\paperheight! should be set properly by,
% for example, a paper selection option of \!\documentclass!.
% 
% \item
% Section~\ref{sec:bgpaint} shows examples of \bgpaint{} to give you more
% intutive explanations of \!\backgroundcolor! and its region specifications.
% \end{itemize}
% 
% 
% 
% \item[\Midx{\!\nobackgroundcolor!}\marg{region}]\mbox{}
% \Item[\Midx{\!\resetbackgroundcolor!}]\mbox{}\par
% \changes{v1.3-3}{2013/09/17}
%	{Add description of \cs{nobackgroundcolor} and
%	 \cs{resetbackgroundcolor}.}
% 
% The command \!\nobackgroundcolor! declares that the \bground{} of
% \meta{region} is not painted, where \meta{region} is one of legitimate
% region specifiers of \!\backgroundcolor!.  The command
% \!\resetbackgroundcolor! declares no regions are painted and thus gives
% you the default state.
% 
% \begin{itemize}
% \item
% If you specified the \bgpaint{} of |c|\oarg{col} or |g|\oarg{col} by
% \!\backgroundcolor!, the painting is \emph{not} canceled by
% \!\nobackgroundcolor! with |c| or |g| but without \oarg{col}.  Similarly,
% once you made declarations of \bgpaint{} of both |c| and |c|\oarg{col}
% (resp.\ |g| and |g|\oarg{col}), \!\nobackgroundcolor! with |c|\oarg{col}
% (resp.\ |g|\oarg{col}) cancels the painting of |c|\oarg{col} (resp.\
% |g|\oarg{col}) but the region will still be painted by the color you gave
% to |c| (resp.\ |g|).
% \end{itemize}
% 
% 
% 
% \item[\Midx{\!\pagerim!}]\mbox{}\par
% \changes{v1.3-3}{2013/09/17}
%	{Add description of \cs{pagerim}.}
% 
% This is a (kind of) \emph{length command}\footnote{
% 
% In reality, it is a \cs{dimen} register rather than a \cs{skip} register.}
% 
% to have the width of the \emph{rim} area placed at each paper edge to 
% inhibit \bgpaint{} in the area.  That is, the inner edges of the area are
% considered as virtual paper edges to block painting of all margins and
% regions having \bginfext{} to the edges, for example in order to
% avoid printing troubles caused by painting the rim area too close to the
% real paper edges.  The default value of \!\pagerim! is 0 to allow paint
% anywhere in a paper.
% \end{description}
% 
% 
% 
% \subsection{Control of Contents Output}
% \label{sec:ref-contents}
% 
% \begin{description}
% \item[\Midx{\!\addcontentsonly!}\marg{file}\marg{col}]\mbox{}\par
% The command inhibits the output of contents information to
% $\meta{file}\in\{|toc|,|lof|,|lot|\}$ from columns other than \meta{col}.
% 
% \begin{itemize}
% \item
% For example, this manual has \!\addcontentsonly!|{toc}{0}| to
% inhibit the contents information output from \!\subsection! commands
% in the right column in Section~\ref{sec:env} and~\ref{sec:float},
% or the table should have duplicated entries of sub-sections.
% 
% \item
% It must be $\meta{file}\in\{|toc|,|lof|,|lot|\}$, or you will have an
% error message of illegal type of contents file.
% \end{itemize}
% \end{description}
% 
% 
% 
% \subsection{Page Flushing Commands}
% \label{sec:ref-flush}
% 
% \begin{description}
% \item[\Midx{\!\flushpage!}]\mbox{}\par
% The command flushes pages up to the {\em\Uidx\tpage} in which the \lcolumn{}
% resides.  Deferred floats which can be put in the pages up to the \tpage{}
% are also flushed.
% 
% \item[\Midx{\!\clearpage!}]\mbox{}\par
% The command does what \!\flushpage! does and then flushes all floats still
% deferred if any.  The deferred float flushing beyond the \tpage{} takes
% place at first for \cwise{} ones creating \fcolumn{}s for them, and
% then for \pwise{} ones creating {\em\Uidx\fpage{}s} only with
% \pwise{} floats, as \LaTeX's \!\clearpage! does outside \env{paracol}
% environment.
% 
% \item[\Midx{\!\cleardoublepage!}]\mbox{}\par
% \changes{v1.3-5}{2013/09/17}
%	{Add description of \cs{cleardoublepage}.}
% The command does what \LaTeX's \!\cleardoublepage! does outside
% \env{paracol}.  That is, it does \!\clearpage! always and then leaves a
% blank page if it is even-numbered and two-sided |p|(age) feature is
% enabled by |twoside| option of \!\documentclass! or \Paracol's own
% \!\twosided! command shown in Section~\ref{sec:ref-twoside}.
% 
% \begin{itemize}
% \item
% This command is equivalent to \!\clearpage! in \env{paracol} environments
% for \npaired{} \parapag{}ing because \!\clearpage! flushes \emph{both}
% left and right \parapag{}es.
% \end{itemize}
% \end{description}
\endinput