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
|
<!DOCTYPE html>
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<meta name="generator" content="TeX Parser Library">
<title>mfirstuc.sty v2.08:
sentence and title casing</title>
<style type="text/css">
#main {margin-left: 5%; margin-right: 15%}
div.tomain {position: absolute; left: 0pt; width: 5%; text-align: right; font-size: x-small;}
div.tomain a {text-decoration: none;}
div.labellink {display: inline; font-size: x-small; margin-left: 1em; margin-right: 1em;}
div.marginleft {position: absolute; left: 0pt; width: 5%;}
div.marginright {position: absolute; right: 0pt; width: 15%;}
div.displaymath { display: block; text-align: center; }
span.eqno { float: right; }
div.table { display: block; text-align: center; }
table.tabular-cm
{
display: inline-table;
border-collapse: collapse;
align: center;
vertical-align: middle;
}
table.tabular-cb
{
display: inline-table;
border-collapse: collapse;
align: center;
vertical-align: bottom;
}
table.tabular-ct
{
display: inline-table;
border-collapse: collapse;
align: center;
vertical-align: top;
}
table.tabular-lm
{
display: inline-table;
border-collapse: collapse;
align: left;
vertical-align: middle;
}
table.tabular-lb
{
display: inline-table;
border-collapse: collapse;
align: left;
vertical-align: bottom;
}
table.tabular-lt
{
display: inline-table;
border-collapse: collapse;
align: left;
vertical-align: top;
}
table.tabular-rm
{
display: inline-table;
border-collapse: collapse;
align: right;
vertical-align: middle;
}
table.tabular-rb
{
display: inline-table;
border-collapse: collapse;
align: right;
vertical-align: bottom;
}
table.tabular-rt
{
display: inline-table;
border-collapse: collapse;
align: right;
vertical-align: top;
}
table.tabular-m
{
display: inline-table;
border-collapse: collapse;
vertical-align: middle;
}
table.tabular-b
{
display: inline-table;
border-collapse: collapse;
vertical-align: bottom;
}
table.tabular-t
{
display: inline-table;
border-collapse: collapse;
vertical-align: top;
}
table.tabular-l
{
display: inline-table;
border-collapse: collapse;
align: left;
}
table.tabular-c
{
display: inline-table;
border-collapse: collapse;
align: center;
}
table.tabular-r
{
display: inline-table;
border-collapse: collapse;
align: right;
}
pre { white-space: pre-wrap; }
div.figure { display: block; text-align: center; }
div.caption { display: block; text-align: center; }
div.marginpar { float: right; }
div.abstract { display: block; margin-right: 4em; margin-left: 4em;}
div.title { display: block; text-align: center; font-size: x-large;}
div.author { display: block; text-align: center; font-size: large;}
div.date { display: block; text-align: center; font-size: medium;}
div.bibliography { display: block; margin-left: 4em; }
div.bibitem { display: inline; float: left; text-indent: -3em; }
span.numberline { display: inline-block; width: 3em; }
.toc-subsection span.numberline { display: inline-block; width: 3em; }
.toc-subsubsection span.numberline { display: inline-block; width: 4em; }
.toc-paragraph span.numberline { display: inline-block; width: 5em; }
.toc-subparagraph span.numberline { display: inline-block; width: 6em; }
nav ul { list-style-type: none; }
.toc-part { padding-left: 0em; padding-bottom: 1ex; padding-top: 1ex; font-weight: bold; font-size: large;}
.toc-chapter { padding-left: 0em; padding-bottom: .25ex; padding-top: .25ex; font-weight: bold; }
.toc-section { padding-left: .5em; }
.toc-subsection { padding-left: 1.5em; }
.toc-subsubsection { padding-left: 2em; }
.toc-paragraph { padding-left: 2.5em; }
.toc-subparagraph { padding-left: 3em; }
.part { font-size: x-large; font-weight: bold; }
div.bigskip { padding-left: 0pt; padding-right: 0pt; padding-top: 0pt; padding-bottom: 2ex;}
div.medskip { padding-left: 0pt; padding-right: 0pt; padding-top: 0pt; padding-bottom: 1ex;}
div.smallskip { padding-left: 0pt; padding-right: 0pt; padding-top: 0pt; padding-bottom: .5ex;}
span.quad { padding-left: 0pt; padding-right: 1em; padding-top: 0pt; padding-bottom: 0pt;}
span.qquad { padding-left: 0pt; padding-right: 2em; padding-top: 0pt; padding-bottom: 0pt;}
.displaylist { display: block; list-style-type: none; }
.inlinelist { display: inline; }
dl.inlinetitle dt { display: inline-block; margin-left: 0; margin-right: 1em;}
dl.inlinetitle dd { display: inline; margin: 0; }
dl.inlinetitle dd::after { display: block; content: ''; }
dl.inlineblock dt { display: inline-block; margin-left: 0; margin-right: 1em;}
dl.inlineblock dd { display: inline; margin: 0; }
dl.inlineblock dd::after { display: block; content: ''; }
.clearfix::after { content: ""; clear: both; display: table; }
span.inlineitem { margin-right: .5em; margin-left: .5em; }
span.numitem { float: left; margin-left: -3em; text-align: right; min-width: 2.5em; }
span.bulletitem { float: left; margin-left: -1em; }
span.descitem { font: normal; font-weight: bold; }
div.indexspace { min-height: 2ex; }
.cell-noborder-nosep-r {border-top: none; border-right: none; border-left: none; padding-left: 0px; padding-right: 0px; text-align: right; }
.cell-noborder-bothsep-l {border-top: none; border-right: none; border-left: none; padding-left: 6.000000pt; padding-right: 6.000000pt; text-align: left; }
.cell-noborder-bothsep-r {border-top: none; border-right: none; border-left: none; padding-left: 6.000000pt; padding-right: 6.000000pt; text-align: right; }
.cell-noborder-bothsep-halfwidth {border-top: none; border-right: none; border-left: none; padding-left: 6.000000pt; width: 50.000000%; padding-right: 6.000000pt; text-align: left; }
.cell-noborder-nosep-l {border-top: none; border-right: none; border-left: none; padding-left: 0px; padding-right: 0px; text-align: left; }
.cell-noborder-rightsep-l {border-top: none; border-right: none; border-left: none; padding-left: 6.000000pt; padding-right: 0px; text-align: left; }
.cell-noborder-leftsep-r {border-top: none; border-right: none; border-left: none; padding-left: 6.000000pt; padding-right: 0px; text-align: right; }
.cell-noborder-bothsep-c {border-top: none; border-right: none; border-left: none; padding-left: 6.000000pt; padding-right: 6.000000pt; text-align: center; }
.cell-noborder-bothsep-eightypc {border-top: none; border-right: none; border-left: none; padding-left: 6.000000pt; width: 80.000000%; padding-right: 6.000000pt; text-align: left; }
.cell-noborder-rightsep-c {border-top: none; border-right: none; border-left: none; padding-left: 0px; padding-right: 6.000000pt; text-align: center; }
.cell-noborder-bothsep-threequarterwidth {border-top: none; border-right: none; border-left: none; padding-left: 6.000000pt; width: 75.000000%; padding-right: 6.000000pt; text-align: left; }
.cell-noborder-rightsep-r {border-top: none; border-right: none; border-left: none; padding-left: 0px; padding-right: 6.000000pt; text-align: right; }
.cell-noborder-bothsep-quarterwidth {border-top: none; border-right: none; border-left: none; padding-left: 6.000000pt; width: 25.000000%; padding-right: 6.000000pt; text-align: left; }
.cell-noborder-rightsep-c {border-top: none; border-right: none; border-left: none; padding-left: 6.000000pt; padding-right: 0px; text-align: center; }
.cell-noborder-rightsep-l {border-top: none; border-right: none; border-left: none; padding-left: 0px; padding-right: 6.000000pt; text-align: left; }
.cell-noborder-nosep-c {border-top: none; border-right: none; border-left: none; padding-left: 0px; padding-right: 0px; text-align: center; }
span.mbox {border-style: none; }
span.frame {border-style: solid; border-width: 1.000000pt; padding: 0.000000pt; }
span.boxed {text-align: center; vertical-align: middle; border-style: solid; border-width: 2.000000pt; padding: 0.000000pt; width: 1.000000em; height: 1.000000em; display: inline-block; }
span.circled {text-align: center; vertical-align: middle; border-style: solid; border-width: 2.000000pt; padding: 1.000000pt; border-radius: 5000.000000%;width: 1.000000em; height: 1.000000em; display: inline-block; }
span.overlapped {text-align: center; border-style: none; padding: 0.000000pt; width: 1.000000em; height: 1.000000em; display: inline-block; }
span.overlapper {text-align: center; border-style: none; padding: 0.000000pt; margin-left: -1.000000em; width: 1.000000em; height: 1.000000em; display: inline-block; }
span.overlappertop {text-align: center; vertical-align: top; border-style: none; padding: 0.000000pt; margin-left: -1.000000em; width: 1.000000em; height: 1.000000em; display: inline-block; }
span.partialoverlapper {text-align: center; border-style: none; padding: 0.000000pt; margin-left: -0.750000em; width: 1.000000em; height: 1.000000em; display: inline-block; }
span.quarterleft {text-align: center; vertical-align: middle; border-style: none; padding: 0.000000pt; transform: rotate(-90.000000deg); -ms-transform: rotate(-90.000000deg); -webkit-transform: rotate(-90.000000deg); display: inline-block; }
span.quarterright {text-align: center; vertical-align: middle; border-style: none; padding: 0.000000pt; transform: rotate(90.000000deg); -ms-transform: rotate(90.000000deg); -webkit-transform: rotate(90.000000deg); display: inline-block; }
span.eighthleft {text-align: center; vertical-align: middle; border-style: none; padding: 0.000000pt; transform: rotate(-45.000000deg); -ms-transform: rotate(-45.000000deg); -webkit-transform: rotate(-45.000000deg); display: inline-block; }
span.eighthright {text-align: center; vertical-align: middle; border-style: none; padding: 0.000000pt; transform: rotate(45.000000deg); -ms-transform: rotate(45.000000deg); -webkit-transform: rotate(45.000000deg); display: inline-block; }
span.halfturn {text-align: center; vertical-align: middle; border-style: none; padding: 0.000000pt; transform: rotate(180.000000deg); -ms-transform: rotate(180.000000deg); -webkit-transform: rotate(180.000000deg); display: inline-block; }
span.fwsdisabledicon {border-style: none; color: gray; }
span.fwsactiveicon {border-style: none; color: green; }
span.glsshowtargetfonttext {font-family: monospace; font-size: x-small; border-style: none; }
dfn { font-style: normal; font-weight: bold; } a { text-decoration: none; } a:hover { text-decoration: underline; } div.tablefns { border-top: solid; } div.example { border-bottom: solid silver; padding: 20px; } div.example div.title { font-weight: bold; font-size: large; }
div.sidenote {font-size: x-small; float: right; border-style: none; }
span.advantage {border-style: none; color: green; }
span.disadvantage {border-style: none; color: red; }
strong.strong {font-weight: bold; border-style: none; }
em.booktitle {font-style: italic; font-variant: normal; border-style: none; }
code.code {font-family: monospace; border-style: none; }
code.cmd {font-family: monospace; border-style: none; }
span.cmdfmt {font-family: monospace; border-style: none; }
span.comment {border-style: none; color: rgb(94,94,94); }
code.csfmt {font-family: monospace; border-style: none; color: rgb(84,111,26); }
span.csfmtfont {font-family: monospace; border-style: none; }
span.csfmtcolourfont {font-family: monospace; border-style: none; color: rgb(84,111,26); }
span.appfmt {font-family: monospace; border-style: none; }
span.styfmt {font-family: monospace; border-style: none; }
span.clsfmt {font-family: monospace; border-style: none; }
span.envfmt {font-family: monospace; border-style: none; }
span.optfmt {font-family: monospace; border-style: none; }
span.csoptfmt {font-family: monospace; border-style: none; color: rgb(104,34,139); }
span.styoptfmt {font-family: monospace; border-style: none; color: rgb(104,34,139); }
span.clsoptfmt {font-family: monospace; border-style: none; }
span.ctrfmt {font-family: monospace; border-style: none; }
span.filefmt {font-family: monospace; border-style: none; }
span.extfmt {font-family: monospace; border-style: none; }
span.deprecatedorbannedfmt {border-style: none; color: rgb(204,0,0); }
span.summarylocfmt {font-style: italic; font-variant: normal; border-style: none; }
span.menufmt {font-family: monospace; border-style: none; }
code.cbeg {font-family: monospace; border-style: none; }
code.cend {font-family: monospace; border-style: none; }
span.termslocfmt {font-style: italic; font-variant: normal; border-style: none; }
span.crossreftag {font-style: italic; font-variant: normal; border-style: none; }
div.crossref {border-style: none; margin-left: 1.000000em; }
span.longargfmt {font-family: monospace; border-style: none; }
span.shortargfmt {font-family: monospace; border-style: none; }
span.qt {border-style: none; }
code.qtt {font-family: monospace; border-style: none; }
em.metainner {font-style: italic; font-variant: normal; border-style: none; }
span.meta {font-family: serif; border-style: none; color: black; }
em.initvalnotefmtinner {font-style: italic; font-variant: normal; border-style: none; }
span.initvalnotefmt {font-family: serif; border-style: none; color: black; }
span.summarytag {font-style: italic; font-variant: normal; border-style: none; }
div.importanttitle {text-align: right; border-style: none; color: red; }
div.important {border-style: solid; border-color: red; border-width: 2.000000pt; padding: 2.000000pt; background-color: rgb(255,235,235); }
div.warningtitle {text-align: right; border-style: none; color: red; }
div.warning {border-style: solid; border-color: red; border-width: 2.000000pt; padding: 2.000000pt; background-color: rgb(255,235,235); }
div.informationtitle {text-align: right; border-style: none; color: rgb(0,128,128); }
div.information {border-style: solid; border-color: rgb(0,128,128); border-width: 2.000000pt; padding: 2.000000pt; background-color: rgb(240,255,255); }
div.pinnedboxtitle {text-align: right; border-style: none; color: black; }
div.pinnedbox {border-style: solid; border-color: black; border-width: 2.000000pt; padding: 2.000000pt; background-color: rgb(255,255,191); }
div.terminaltitle {text-align: right; border-style: none; color: black; }
pre.terminal {font-family: monospace; border-style: solid; border-color: black; border-width: 2.000000pt; padding: 2.000000pt; background-color: rgb(250,250,250); }
div.transcripttitle {text-align: right; border-style: none; color: black; }
pre.transcript {font-family: monospace; border-style: solid; border-color: black; border-width: 2.000000pt; padding: 2.000000pt; background-color: rgb(250,250,250); }
div.ctrboxtitle {text-align: right; border-style: none; color: black; }
div.ctrbox {border-style: solid; border-color: black; border-width: 2.000000pt; padding: 2.000000pt; background-color: rgb(255,255,191); }
div.codeboxtitle {text-align: right; border-style: none; color: black; }
pre.codebox {font-family: monospace; border-style: solid; border-color: black; border-width: 2.000000pt; padding: 2.000000pt; background-color: rgb(250,250,250); }
div.resultboxtitle {text-align: right; border-style: none; color: black; }
div.resultbox {border-style: solid; border-color: black; border-width: 2.000000pt; padding: 2.000000pt; }
div.badcodeboxtitle {text-align: right; border-style: none; color: black; }
pre.badcodebox {font-family: monospace; border-style: solid; border-color: black; border-width: 2.000000pt; padding: 2.000000pt; background-color: rgb(250,250,250); }
div.unicodeboxtitle {text-align: right; border-style: none; color: black; }
pre.unicodebox {font-family: monospace; border-style: solid; border-color: black; border-width: 2.000000pt; padding: 2.000000pt; background-color: rgb(250,250,250); }
pre.compactcodebox {font-family: monospace; border-style: solid; border-color: black; border-width: 1.000000pt; padding: 2.000000pt; background-color: rgb(250,250,250); }
pre.sidebysidecode {font-family: monospace; font-size: small; vertical-align: top; border-style: solid; border-color: black; border-width: 1.000000pt; padding: 2.000000pt; margin-right: 3.000000%; margin-top: 0.000000pt; background-color: rgb(250,250,250); width: 47.000000%; display: inline-block; }
div.sidebysideresult {vertical-align: top; border-style: solid; border-color: black; border-width: 1.000000pt; padding: 2.000000pt; margin-top: 0.000000pt; width: 47.000000%; display: inline-block; }
div.defnbox {border-style: solid; border-color: black; border-width: 1.000000pt; padding: 2.000000pt; background-color: rgb(255,255,191); }
div.optionsummarybox {border-style: solid; border-color: black; border-width: 1.000000pt; padding: 2.000000pt; background-color: rgb(255,255,191); }
div.optionvaluesummarybox {border-style: none; margin-left: 40.000000pt; }
span.floatrightbox {float: right; border-style: none; }
div.noteBox {border-style: none; }
div.settingsboxtitle {text-align: right; border-style: none; color: black; }
div.settingsbox {border-style: solid; border-color: black; border-width: 2.000000pt; padding: 2.000000pt; background-color: rgb(255,255,227); }
div.optionvalueboxtitle {text-align: right; border-style: none; color: black; }
div.optionvaluebox {border-style: solid; border-color: black; border-width: 2.000000pt; padding: 2.000000pt; background-color: rgb(255,255,245); }
div.nlctuserguideidx0 {border-style: none; margin-left: 0.000000pt; }
div.nlctuserguideidx1 {border-style: none; margin-left: 20.000000pt; }
div.nlctuserguideidx2 {border-style: none; margin-left: 40.000000pt; }
div.nlctusernavbox {border-style: none; }
div.abstractheader {font-weight: bold; text-align: center; border-style: none; }
div.filedef {font-family: monospace; text-align: left; border-style: none; }
div.tablefn {font-size: x-small; border-style: none; }
div.tablefns {text-align: left; border-style: none; width: 80.000000%; }
</style>
</head>
<body>
<div id="main">
<header><div class="title">mfirstuc.sty v2.08: sentence and title casing</div><!-- end of title --><div class="author">Nicola L.C. Talbot<br>
Dickimaw Books<br>
<a href="https://www.dickimaw-books.com/">dickimaw-books.com</a></div><!-- end of author --><div class="date">2022-10-14 </div><!-- end of date --></header><p>
<p>
<div class="information"><div class="informationtitle"><a id="wrglossary.1"></a><a href="#glo:sym.information"><span title="Information" class="icon">🛈</span></a></div><!-- end of informationtitle -->
The <a id="wrglossary.2"></a><a href="#glo:pkg.mfirstuc"><span class="styfmt">mfirstuc</span></a> package was originally part of the <a id="wrglossary.3"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> bundle (added to <a id="wrglossary.4"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v1.12 in 2008) for use with commands like <a id="wrglossary.5"></a><a href="#glo:Gls"><code class="csfmt">\Gls</code></a>, which need to have the first letter converted to uppercase (<a id="wrglossary.6"></a><a href="#glo:dual.sentence-case">sentence-case</a>), but as the commands provided by <a id="wrglossary.7"></a><a href="#glo:pkg.mfirstuc"><span class="styfmt">mfirstuc</span></a> may be used without <a id="wrglossary.8"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a>, the two were split into separately maintained packages in 2015 (<a id="wrglossary.9"></a><a href="#glo:pkg.mfirstuc"><span class="styfmt">mfirstuc</span></a> v2.0 and <a id="wrglossary.10"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v4.18). </div><!-- end of information -->
<p>
Version 2.08 has reimplemented <a id="wrglossary.11"></a><a href="#glo:makefirstuc"><code class="csfmt">\makefirstuc</code></a> using LaTeX3 commands. If there are any compatibility issues, you can rollback to v2.07: <pre class="codebox"><div class="codeboxtitle"><a id="wrglossary.12"></a><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\usepackage</code>{mfirstuc}[=2.07]
</pre><p>
<nav class="toc">
<section id="toc"><!-- start of section toc --><div class="tomain"><a href="#main">[top]</a></div>
<h1><!-- start of chapter header -->Contents<div class="labellink"><a href="#toc">[link]</a></div></h1><!-- end of chapter header -->
<ul>
<li class="toc-chapter"><a href="#sec:sentencecase"><span class="numberline">1</span>Sentence-Case</a></li><!-- end of toc-chapter -->
<ul>
<li class="toc-section"><a href="#sec:sentencecaseex"><span class="numberline">1.1</span>Examples</a></li><!-- end of toc-section -->
<li class="toc-section"><a href="#sec:sentencecasecmds"><span class="numberline">1.2</span>Sentence Case Commands</a></li><!-- end of toc-section -->
<li class="toc-section"><a href="#sec:exclusions"><span class="numberline">1.3</span>Exclusions</a></li><!-- end of toc-section -->
<li class="toc-section"><a href="#sec:blockers"><span class="numberline">1.4</span>Blockers</a></li><!-- end of toc-section -->
<li class="toc-section"><a href="#sec:mappings"><span class="numberline">1.5</span>Mappings</a></li><!-- end of toc-section -->
<li class="toc-section"><a href="#sec:pkgoptions"><span class="numberline">1.6</span>Package Options</a></li><!-- end of toc-section -->
</ul>
<li class="toc-chapter"><a href="#sec:capitalisewords"><span class="numberline">2</span>Title-Case</a></li><!-- end of toc-chapter -->
<ul>
<li class="toc-section"><a href="#sec:nocap"><span class="numberline">2.1</span>Excluding Words From Case-Changing</a></li><!-- end of toc-section -->
<li class="toc-section"><a href="#sec:pdfbookmarks"><span class="numberline">2.2</span>PDF Bookmarks</a></li><!-- end of toc-section -->
<li class="toc-section"><a href="#sec:titlecaseexamples"><span class="numberline">2.3</span>Examples</a></li><!-- end of toc-section -->
</ul>
<li class="toc-chapter"><a href="#sec:misc"><span class="numberline">3</span>Miscellaneous</a></li><!-- end of toc-chapter -->
<ul>
<li class="toc-section"><a href="#sec:savetoaux"><span class="numberline">3.1</span>Saving exclusions, blockers and mappings in the <span class="extfmt">aux</span> File</a></li><!-- end of toc-section -->
<li class="toc-section"><a href="#sec:allcaps"><span class="numberline">3.2</span>All-Caps</a></li><!-- end of toc-section -->
<li class="toc-section"><a href="#sec:utf8"><span class="numberline">3.3</span>UTF-8</a></li><!-- end of toc-section -->
</ul>
<li class="toc-chapter"><a href="#symbols">Symbols</a></li><!-- end of toc-chapter -->
<li class="toc-chapter"><a href="#glossary">Glossary</a></li><!-- end of toc-chapter -->
<li class="toc-chapter"><a href="#cmdsummary">Command Summary</a></li><!-- end of toc-chapter -->
<ul>
<li class="toc-section"><a href="#summary.index@">Command Summary: @</a></li><!-- end of toc-section -->
<li class="toc-section"><a href="#summary.index6684672">Command Summary: C</a></li><!-- end of toc-section -->
<li class="toc-section"><a href="#summary.index6815744">Command Summary: E</a></li><!-- end of toc-section -->
<li class="toc-section"><a href="#summary.index6946816">Command Summary: G</a></li><!-- end of toc-section -->
<li class="toc-section"><a href="#summary.index7077888">Command Summary: I</a></li><!-- end of toc-section -->
<li class="toc-section"><a href="#summary.index7340032">Command Summary: M</a></li><!-- end of toc-section -->
<li class="toc-section"><a href="#summary.index8060928">Command Summary: X</a></li><!-- end of toc-section -->
</ul>
<li class="toc-chapter"><a href="#index">Index</a></li><!-- end of toc-chapter -->
</ul></nav><!-- end of toc --><p>
</section><!-- end of section toc -->
<section id="sec:sentencecase"><!-- start of section sec:sentencecase --><div class="tomain"><a href="#main">[top]</a></div>
<h1><!-- start of chapter header -->1. Sentence-Case<div class="labellink"><a href="#sec:sentencecase">[link]</a></div></h1><!-- end of chapter header -->
<p>
There are two <a id="wrglossary.13"></a><a href="#glo:dual.sentence-case">sentence-case</a> commands provided: <a id="wrglossary.14"></a><a href="#glo:MFUsentencecase"><code class="csfmt">\MFUsentencecase</code></a> and <a id="wrglossary.15"></a><a href="#glo:makefirstuc"><code class="csfmt">\makefirstuc</code></a>. A summary of the principle features of the two commands is given in Table <a href="#tab:sentencecasesummary">1.1</a>.<p>
<div class="table"> <table class="tabular-c">
<caption id="tab:sentencecasesummary">Table 1: Principle features of <code class="csfmt">\MFUsentencecase</code> and <code class="csfmt">\makefirstuc</code></caption><tr style=""><th class="cell-noborder-bothsep-l">Feature </th>
<td class="cell-noborder-bothsep-c"> <span style="font-weight: bold; "><a href="#glo:MFUsentencecase"><code class="csfmt">\MFUsentencecase</code></a> </span></td>
<td class="cell-noborder-bothsep-c"> <span style="font-weight: bold; "><a href="#glo:makefirstuc"><code class="csfmt">\makefirstuc</code></a></span></td>
</tr><tr style=""><td class="cell-noborder-bothsep-l">Can expand? </td>
<td class="cell-noborder-bothsep-c"> <span class="advantage"><span title="yes" class="icon">✔</span></span></td>
<td class="cell-noborder-bothsep-c"> <span class="disadvantage"><span title="no" class="icon">✖</span></span></td>
</tr><tr style=""><td class="cell-noborder-bothsep-l">Supports <a href="#glo:dual.exclusion">exclusions</a>? </td>
<td class="cell-noborder-bothsep-c"> <span class="advantage"><span title="yes" class="icon">✔</span></span></td>
<td class="cell-noborder-bothsep-c"> <span class="advantage"><span title="yes" class="icon">✔</span></span></td>
</tr><tr style=""><td class="cell-noborder-bothsep-l">Supports <a href="#glo:dual.blocker">blockers</a>? </td>
<td class="cell-noborder-bothsep-c"> <span class="disadvantage"><span title="no" class="icon">✖</span></span></td>
<td class="cell-noborder-bothsep-c"> <span class="advantage"><span title="yes" class="icon">✔</span></span></td>
</tr><tr style=""><td class="cell-noborder-bothsep-l">Supports <a href="#glo:dual.mapping">mappings</a>? </td>
<td class="cell-noborder-bothsep-c"> <span class="disadvantage"><span title="no" class="icon">✖</span></span></td>
<td class="cell-noborder-bothsep-c"> <span class="advantage"><span title="yes" class="icon">✔</span></span></td>
</tr><tr style=""><td class="cell-noborder-bothsep-l">Semantic commands must be robust? </td>
<td class="cell-noborder-bothsep-c"> <span class="disadvantage"><span title="yes" class="icon">✔</span></span></td>
<td class="cell-noborder-bothsep-c"> <span class="advantage"><span title="no" class="icon">✖</span></span></td>
</tr></table>
</div><p>
</section><!-- end of section sec:sentencecase -->
<section id="sec:sentencecaseex"><!-- start of section sec:sentencecaseex --><div class="tomain"><a href="#main">[top]</a></div>
<h2><!-- start of section header -->1.1. Examples<div class="labellink"><a href="#sec:sentencecaseex">[link]</a></div></h2><!-- end of section header -->
<p>
Text only (leading <a id="wrglossary.16"></a><a href="#glo:dual.utf8">UTF-8</a> now supported): <div style="text-align: center; border-style: none; "><a id="wrglossary.17"></a><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a><a id="wrglossary.18"></a><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of frame@coderesult@title -->
<p>
<pre class="sidebysidecode">
<a id="wrglossary.19"></a><a href="#glo:makefirstuc"><code class="csfmt">\makefirstuc</code></a>{élite} /
<a id="wrglossary.20"></a><a href="#glo:MFUsentencecase"><code class="csfmt">\MFUsentencecase</code></a>{élite}
</pre><div class="sidebysideresult">Élite / Élite </div><p>
<p>
Leading <a id="wrglossary.21"></a><a href="#glo:idx.punctuation">punctuation</a> is ignored: <div style="text-align: center; border-style: none; "><a id="wrglossary.22"></a><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a><a id="wrglossary.23"></a><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of frame@coderesult@title -->
<p>
<pre class="sidebysidecode">
<a id="wrglossary.24"></a><a href="#glo:makefirstuc"><code class="csfmt">\makefirstuc</code></a>{`word'} /
<a id="wrglossary.25"></a><a href="#glo:MFUsentencecase"><code class="csfmt">\MFUsentencecase</code></a>{`word'}
</pre><div class="sidebysideresult">‘Word’ / ‘Word’ </div><p>
However, if the <a id="wrglossary.26"></a><a href="#glo:idx.punctuation">punctuation</a> character is followed by a <a id="wrglossary.27"></a><a href="#glo:dual.blocker">blocker</a> or <a id="wrglossary.28"></a><a href="#glo:dual.mapping">mapping</a> command, the <a id="wrglossary.29"></a><a href="#glo:idx.punctuation">punctuation</a> will need to be excluded otherwise the command will be treated as an <a id="wrglossary.30"></a><a href="#glo:dual.exclusion">exclusion</a>. If possible, use <a id="wrglossary.31"></a><a href="#glo:@@glslabel@semanticcommand">semantic markup</a> instead of directly including the <a id="wrglossary.32"></a><a href="#glo:idx.punctuation">punctuation</a>.<p>
Fragile commands need to be protected with <a id="wrglossary.33"></a><a href="#glo:MFUsentencecase"><code class="csfmt">\MFUsentencecase</code></a>: <pre class="codebox"><div class="codeboxtitle"><a id="wrglossary.34"></a><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\newcommand</code>{<code class="cmd">\alert</code>}[1]{<code class="cmd">\textcolor</code>{red}{<code class="cmd">\textbf</code>{#1}}}
<a id="wrglossary.35"></a><a href="#glo:makefirstuc"><code class="csfmt">\makefirstuc</code></a>{<code class="cmd">\alert</code>{élite}} /
<a id="wrglossary.36"></a><a href="#glo:MFUsentencecase"><code class="csfmt">\MFUsentencecase</code></a>{<strong class="strong"><code class="cmd">\protect</code></strong><code class="cmd">\alert</code>{élite}}
</pre> <div class="resultbox"><div class="resultboxtitle"><a id="wrglossary.37"></a><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of resultboxtitle -->
<span style="color: rgb(255,0,0)"><span style="font-weight: bold; ">Élite</span></span> / <span style="color: rgb(255,0,0)"><span style="font-weight: bold; ">Élite</span></span> </div><!-- end of resultbox -->
<p>
<a id="wrglossary.38"></a><a href="#glo:dual.exclusion">Exclusions</a> are supported by both <a id="wrglossary.39"></a><a href="#glo:makefirstuc"><code class="csfmt">\makefirstuc</code></a> and <a id="wrglossary.40"></a><a href="#glo:MFUsentencecase"><code class="csfmt">\MFUsentencecase</code></a>: <pre class="codebox"><div class="codeboxtitle"><a id="wrglossary.41"></a><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.42"></a><a href="#glo:MFUexcl"><code class="csfmt">\MFUexcl</code></a>{<a id="wrglossary.43"></a><a href="#glo:index"><code class="csfmt">\index</code></a>}
<a id="wrglossary.44"></a><a href="#glo:makefirstuc"><code class="csfmt">\makefirstuc</code></a>{<a id="wrglossary.45"></a><a href="#glo:index"><code class="csfmt">\index</code></a>{word}example} /
<a id="wrglossary.46"></a><a href="#glo:MFUsentencecase"><code class="csfmt">\MFUsentencecase</code></a>{<a id="wrglossary.47"></a><a href="#glo:index"><code class="csfmt">\index</code></a>{word}example}
</pre> <div class="resultbox"><div class="resultboxtitle"><a id="wrglossary.48"></a><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of resultboxtitle -->
Example / Example </div><!-- end of resultbox -->
<p>
<a id="wrglossary.49"></a><a href="#glo:dual.blocker">Blockers</a> are only supported by <a id="wrglossary.50"></a><a href="#glo:makefirstuc"><code class="csfmt">\makefirstuc</code></a>. They are treated as <a id="wrglossary.51"></a><a href="#glo:dual.exclusion">exclusions</a> with <a id="wrglossary.52"></a><a href="#glo:MFUsentencecase"><code class="csfmt">\MFUsentencecase</code></a>, which produces a different result: <pre class="codebox"><div class="codeboxtitle"><a id="wrglossary.53"></a><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.54"></a><a href="#glo:MFUblocker"><code class="csfmt">\MFUblocker</code></a>{<a id="wrglossary.55"></a><a href="#glo:nameref"><code class="csfmt">\nameref</code></a>}
<a id="wrglossary.56"></a><a href="#glo:makefirstuc"><code class="csfmt">\makefirstuc</code></a>{<a id="wrglossary.57"></a><a href="#glo:nameref"><code class="csfmt">\nameref</code></a>{sec:sentencecase} section} /
<a id="wrglossary.58"></a><a href="#glo:MFUsentencecase"><code class="csfmt">\MFUsentencecase</code></a>{<a id="wrglossary.59"></a><a href="#glo:nameref"><code class="csfmt">\nameref</code></a>{sec:sentencecase} section}
</pre> <div class="resultbox"><div class="resultboxtitle"><a id="wrglossary.60"></a><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of resultboxtitle -->
<a href="#sec:sentencecase">Sentence-Case</a> section / <a href="#sec:sentencecase">Sentence-Case</a> Section </div><!-- end of resultbox -->
<p>
<a id="wrglossary.61"></a><a href="#glo:dual.mapping">Mappings</a> are only supported by <a id="wrglossary.62"></a><a href="#glo:makefirstuc"><code class="csfmt">\makefirstuc</code></a>. They are treated as <a id="wrglossary.63"></a><a href="#glo:dual.exclusion">exclusions</a> with <a id="wrglossary.64"></a><a href="#glo:MFUsentencecase"><code class="csfmt">\MFUsentencecase</code></a>, which produces a different result: <pre class="codebox"><div class="codeboxtitle"><a id="wrglossary.65"></a><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\newrobustcmd</code>{<code class="cmd">\secref</code>}[1]{section~<code class="cmd">\ref</code>{#1}}
<code class="cmd">\newrobustcmd</code>{<code class="cmd">\Secref</code>}[1]{Section~<code class="cmd">\ref</code>{#1}}
<a id="wrglossary.66"></a><a href="#glo:MFUaddmap"><code class="csfmt">\MFUaddmap</code></a>{<code class="cmd">\secref</code>}{<code class="cmd">\Secref</code>}
<a id="wrglossary.67"></a><a href="#glo:makefirstuc"><code class="csfmt">\makefirstuc</code></a>{<code class="cmd">\secref</code>{sec:sentencecase} example} /
<a id="wrglossary.68"></a><a href="#glo:MFUsentencecase"><code class="csfmt">\MFUsentencecase</code></a>{<code class="cmd">\secref</code>{sec:sentencecase} example}
</pre> <div class="resultbox"><div class="resultboxtitle"><a id="wrglossary.69"></a><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of resultboxtitle -->
Section <a href="#sec:sentencecase">1</a> example / section <a href="#sec:sentencecase">1</a> Example </div><!-- end of resultbox -->
<p>
Argument expansion: <a id="wrglossary.70"></a><a href="#glo:MFUsentencecase"><code class="csfmt">\MFUsentencecase</code></a> expands its argument and then skips exclusions whereas <a id="wrglossary.71"></a><a href="#glo:makefirstuc"><code class="csfmt">\makefirstuc</code></a> parses its argument without expansion and then passes the relevant content to <a id="wrglossary.72"></a><a href="#glo:glsmakefirstuc"><code class="csfmt">\glsmakefirstuc</code></a>. Note that different results will occur with the <a id="wrglossary.73"></a><a href="#glo:opt.expanded"><span class="optfmt">expanded</span></a> and <a id="wrglossary.74"></a><a href="#glo:opt.unexpanded"><span class="optfmt">unexpanded</span></a> package options. For example: <pre class="codebox"><div class="codeboxtitle"><a id="wrglossary.75"></a><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\usepackage</code>[<a id="wrglossary.76"></a><a href="#glo:opt.expanded"><span class="optfmt">expanded</span></a>]{mfirstuc}
<code class="cmd">\newcommand</code>{<code class="cmd">\testa</code>}{sample}
<code class="cmd">\newcommand</code>{<code class="cmd">\testb</code>}{<code class="cmd">\testa</code><code class="cmd">\ </code>test}
<code class="cbeg">\begin{document}</code>
<a id="wrglossary.77"></a><a href="#glo:makefirstuc"><code class="csfmt">\makefirstuc</code></a>{<code class="cmd">\testb</code>} / <a id="wrglossary.78"></a><a href="#glo:xmakefirstuc"><code class="csfmt">\xmakefirstuc</code></a>{<code class="cmd">\testb</code>} /
<a id="wrglossary.79"></a><a href="#glo:emakefirstuc"><code class="csfmt">\emakefirstuc</code></a>{<code class="cmd">\testb</code>} / <a id="wrglossary.80"></a><a href="#glo:MFUsentencecase"><code class="csfmt">\MFUsentencecase</code></a>{<code class="cmd">\testb</code>}
<code class="cend">\end{document}</code>
</pre> <div class="resultbox"><div class="resultboxtitle"><a id="wrglossary.81"></a><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of resultboxtitle -->
Sample test / Sample test / Sample test / Sample test </div><!-- end of resultbox -->
With the default <a id="wrglossary.82"></a><a href="#glo:opt.unexpanded"><span class="optfmt">unexpanded</span></a> option the result is: <div class="resultbox"><div class="resultboxtitle"><a id="wrglossary.83"></a><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of resultboxtitle -->
sample test / sample Test / Sample test / Sample test </div><!-- end of resultbox -->
Note that this is different from the result in earlier versions of <a id="wrglossary.84"></a><a href="#glo:pkg.mfirstuc"><span class="styfmt">mfirstuc</span></a>. <pre class="codebox"><div class="codeboxtitle"><a id="wrglossary.85"></a><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\usepackage</code>{mfirstuc}[=v2.07]
<code class="cmd">\newcommand</code>{<code class="cmd">\testa</code>}{sample}
<code class="cmd">\newcommand</code>{<code class="cmd">\testb</code>}{<code class="cmd">\testa</code><code class="cmd">\ </code>test}
<code class="cbeg">\begin{document}</code>
<a id="wrglossary.86"></a><a href="#glo:makefirstuc"><code class="csfmt">\makefirstuc</code></a>{<code class="cmd">\testb</code>} / <a id="wrglossary.87"></a><a href="#glo:xmakefirstuc"><code class="csfmt">\xmakefirstuc</code></a>{<code class="cmd">\testb</code>} /
<a id="wrglossary.88"></a><a href="#glo:emakefirstuc"><code class="csfmt">\emakefirstuc</code></a>{<code class="cmd">\testb</code>}
<code class="cend">\end{document}</code>
</pre> This produces: <div class="resultbox"><div class="resultboxtitle"><a id="wrglossary.89"></a><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of resultboxtitle -->
SAMPLE TEST / SAMPLE test / Sample test </div><!-- end of resultbox -->
If this old result is required, either use rollback or try the <a id="wrglossary.90"></a><a href="#glo:opt.grabfirst"><span class="optfmt">grabfirst</span></a> option.<p>
Argument expansion with <a id="wrglossary.91"></a><a href="#glo:dual.mapping">mappings</a> (and the default <a id="wrglossary.92"></a><a href="#glo:opt.unexpanded"><span class="optfmt">unexpanded</span></a> option): <pre class="codebox"><div class="codeboxtitle"><a id="wrglossary.93"></a><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\newrobustcmd</code>{<code class="cmd">\secref</code>}[1]{section~<code class="cmd">\ref</code>{#1}}
<code class="cmd">\newrobustcmd</code>{<code class="cmd">\Secref</code>}[1]{Section~<code class="cmd">\ref</code>{#1}}
<a id="wrglossary.94"></a><a href="#glo:MFUaddmap"><code class="csfmt">\MFUaddmap</code></a>{<code class="cmd">\secref</code>}{<code class="cmd">\Secref</code>}
<code class="cmd">\newcommand</code>{<code class="cmd">\testa</code>}{<code class="cmd">\secref</code>{sec:sentencecase}}
<code class="cmd">\newcommand</code>{<code class="cmd">\testb</code>}{<code class="cmd">\testa</code><code class="cmd">\ </code>example}
<a id="wrglossary.95"></a><a href="#glo:makefirstuc"><code class="csfmt">\makefirstuc</code></a>{<code class="cmd">\testb</code>} / <a id="wrglossary.96"></a><a href="#glo:xmakefirstuc"><code class="csfmt">\xmakefirstuc</code></a>{<code class="cmd">\testb</code>} /
<a id="wrglossary.97"></a><a href="#glo:emakefirstuc"><code class="csfmt">\emakefirstuc</code></a>{<code class="cmd">\testb</code>} / <a id="wrglossary.98"></a><a href="#glo:MFUsentencecase"><code class="csfmt">\MFUsentencecase</code></a>{<code class="cmd">\testb</code>}
</pre> <div class="resultbox"><div class="resultboxtitle"><a id="wrglossary.99"></a><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of resultboxtitle -->
section <a href="#sec:sentencecase">1</a> example / section <a href="#sec:sentencecase">1</a> Example / Section <a href="#sec:sentencecase">1</a> example / section <a href="#sec:sentencecase">1</a> Example </div><!-- end of resultbox -->
<p>
</section><!-- end of section sec:sentencecaseex -->
<section id="sec:sentencecasecmds"><!-- start of section sec:sentencecasecmds --><div class="tomain"><a href="#main">[top]</a></div>
<h2><!-- start of section header -->1.2. Sentence Case Commands<div class="labellink"><a href="#sec:sentencecasecmds">[link]</a></div></h2><!-- end of section header -->
<p>
<div class="pinnedbox"><div class="pinnedboxtitle"><a id="wrglossary.100"></a><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
<a id="wrglossary.101"></a><code class="code"><dfn id="glo:MFUsentencecase"><code class="csfmt">\MFUsentencecase</code></dfn>{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code></div><!-- end of pinnedbox -->
This simply uses <a id="wrglossary.102"></a><a href="#glo:texttitlecasefirst:n"><code class="csfmt">\text_titlecase_first:n</code></a>, which is provided by the LaTeX3 kernel. Note that this fully expands the argument. If you use this command, ensure that your <a id="wrglossary.103"></a><a href="#glo:dual.semanticcommand">semantic commands</a> are robust. For example: <pre class="codebox"><div class="codeboxtitle"><a id="wrglossary.104"></a><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\newrobustcmd</code>{<code class="cmd">\alert</code>}[1]{<code class="cmd">\textcolor</code>{red}{<code class="cmd">\textbf</code>{#1}}}
<a id="wrglossary.105"></a><a href="#glo:MFUsentencecase"><code class="csfmt">\MFUsentencecase</code></a>{<code class="cmd">\alert</code>{sample} text}
</pre> <div class="resultbox"><div class="resultboxtitle"><a id="wrglossary.106"></a><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of resultboxtitle -->
<span style="color: rgb(255,0,0)"><span style="font-weight: bold; ">Sample</span></span> text </div><!-- end of resultbox -->
Note that the following will fail: <pre class="badcodebox"><div class="badcodeboxtitle"><a id="wrglossary.107"></a><a href="#glo:sym.badcode"><span title="Problematic Input" class="icon"><span class="overlapped">🖹</span><span class="overlapper"><span class="deprecatedorbannedfmt">🛇</span></span></span></a></div><code class="cmd">\newcommand</code>{<code class="cmd">\alert</code>}[1]{<code class="cmd">\textcolor</code>{red}{<code class="cmd">\textbf</code>{#1}}}
<a id="wrglossary.108"></a><a href="#glo:MFUsentencecase"><code class="csfmt">\MFUsentencecase</code></a>{<code class="cmd">\alert</code>{sample} text}
</pre> This is because the expansion that’s performed before the case-change will result in: <pre class="badcodebox"><div class="badcodeboxtitle"><a id="wrglossary.109"></a><a href="#glo:sym.badcode"><span title="Problematic Input" class="icon"><span class="overlapped">🖹</span><span class="overlapper"><span class="deprecatedorbannedfmt">🛇</span></span></span></a></div><code class="cmd">\textcolor</code>{Red}{<code class="cmd">\textbf</code>{sample}} text
</pre> This triggers an error since <code class="code">Red</code> isn’t a recognised colour name.<p>
<div class="pinnedbox"><div class="pinnedboxtitle"><a id="wrglossary.110"></a><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
<a id="wrglossary.111"></a><code class="code"><dfn id="glo:makefirstuc"><code class="csfmt">\makefirstuc</code></dfn>{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code></div><!-- end of pinnedbox -->
This is the original command provided by <a id="wrglossary.112"></a><a href="#glo:pkg.mfirstuc"><span class="styfmt">mfirstuc</span></a>, which was written to assist sentence-casing in the <a id="wrglossary.113"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package and had to take markup into account. It parses its argument to try to determine which part needs the case-change. The actual case-change is performed by <a id="wrglossary.114"></a><a href="#glo:glsmakefirstuc"><code class="csfmt">\glsmakefirstuc</code></a>.<p>
As from v2.08, the definition of <a id="wrglossary.115"></a><a href="#glo:makefirstuc"><code class="csfmt">\makefirstuc</code></a> has been updated to use LaTeX3 code, but the argument is still parsed, which allows for non-robust <a id="wrglossary.116"></a><a href="#glo:dual.semanticcommand">semantic commands</a>, and now also takes <a id="wrglossary.117"></a><a href="#glo:dual.blocker">blockers</a> and <a id="wrglossary.118"></a><a href="#glo:dual.mapping">mappings</a> into account. For example: <pre class="codebox"><div class="codeboxtitle"><a id="wrglossary.119"></a><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\newcommand</code>{<code class="cmd">\alert</code>}[1]{<code class="cmd">\textcolor</code>{red}{<code class="cmd">\textbf</code>{#1}}}
<a id="wrglossary.120"></a><a href="#glo:makefirstuc"><code class="csfmt">\makefirstuc</code></a>{<code class="cmd">\alert</code>{sample} text}
</pre> <div class="resultbox"><div class="resultboxtitle"><a id="wrglossary.121"></a><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of resultboxtitle -->
<span style="color: rgb(255,0,0)"><span style="font-weight: bold; ">Sample</span></span> text </div><!-- end of resultbox -->
<p>
The rules used when parsing <code class="code"><a id="wrglossary.122"></a><a href="#glo:makefirstuc"><code class="csfmt">\makefirstuc</code></a>{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code> are as follows:
<ol class="displaylist">
<li><span class="numitem">1.</span>if <span class="meta">〈<em class="metainner">text</em>〉</span> is empty do nothing;<p>
<li><span class="numitem">2.</span>if <span class="meta">〈<em class="metainner">text</em>〉</span> consists of a single item or starts with a group do <code class="code"><a id="wrglossary.123"></a><a href="#glo:glsmakefirstuc"><code class="csfmt">\glsmakefirstuc</code></a>{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code>;<p>
<li><span class="numitem">3.</span>if <span class="meta">〈<em class="metainner">text</em>〉</span> starts with a command <span class="meta">〈<em class="metainner">cs</em>〉</span>:<p>
<ol class="displaylist">
<li><span class="numitem">(a)</span>if <span class="meta">〈<em class="metainner">cs</em>〉</span> is <a id="wrglossary.124"></a><a href="#glo:protect"><code class="csfmt">\protect</code></a>, skip it and continue to the next step where the command <span class="meta">〈<em class="metainner">cs</em>〉</span> under inspection is now the one that follows <a id="wrglossary.125"></a><a href="#glo:protect"><code class="csfmt">\protect</code></a>:<p>
<li><span class="numitem">(b)</span>if <span class="meta">〈<em class="metainner">cs</em>〉</span> has been identified as a <a id="wrglossary.126"></a><a href="#glo:dual.blocker">blocker</a>, just do <span class="meta">〈<em class="metainner">text</em>〉</span> (that is, no case-change is applied);<p>
<li><span class="numitem">(c)</span>if <span class="meta">〈<em class="metainner">cs</em>〉</span> isn’t followed by a group then do <code class="code"><a id="wrglossary.127"></a><a href="#glo:glsmakefirstuc"><code class="csfmt">\glsmakefirstuc</code></a>{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code>;<p>
<li><span class="numitem">(d)</span>otherwise assume the format is <code class="code"><span class="meta">〈<em class="metainner">cs</em>〉</span>{<span class="meta">〈<em class="metainner">arg</em>〉</span>}<span class="meta">〈<em class="metainner">following</em>〉</span></code> (where <span class="meta">〈<em class="metainner">following</em>〉</span> may be empty) and then:<p>
<ol class="displaylist">
<li><span class="numitem">i.</span>if <span class="meta">〈<em class="metainner">cs</em>〉</span> has been <a id="wrglossary.128"></a><a href="#glo:@@glslabel@mapping">mapped</a> to <span class="meta">〈<em class="metainner">Cs</em>〉</span> then do <code class="code"><span class="meta">〈<em class="metainner">Cs</em>〉</span>{<span class="meta">〈<em class="metainner">arg</em>〉</span>}<span class="meta">〈<em class="metainner">following</em>〉</span></code>;<p>
<li><span class="numitem">ii.</span>if <span class="meta">〈<em class="metainner">cs</em>〉</span> has been identified as an <a id="wrglossary.129"></a><a href="#glo:dual.exclusion">exclusion</a>, do <code class="code"><span class="meta">〈<em class="metainner">cs</em>〉</span>{<span class="meta">〈<em class="metainner">arg</em>〉</span>}<a id="wrglossary.130"></a><a href="#glo:makefirstuc"><code class="csfmt">\makefirstuc</code></a>{<span class="meta">〈<em class="metainner">following</em>〉</span>}</code>;<p>
<li><span class="numitem">iii.</span>otherwise do <code class="code"><span class="meta">〈<em class="metainner">cs</em>〉</span>{<a id="wrglossary.131"></a><a href="#glo:makefirstuc"><code class="csfmt">\makefirstuc</code></a>{<span class="meta">〈<em class="metainner">arg</em>〉</span>}}<span class="meta">〈<em class="metainner">following</em>〉</span></code>.
</ol>
<p>
</ol>
<p>
<li><span class="numitem">4.</span>otherwise do <code class="code"><a id="wrglossary.132"></a><a href="#glo:glsmakefirstuc"><code class="csfmt">\glsmakefirstuc</code></a>{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code>.
</ol>
<p>
Note that the above algorithm uses recursion. The termination points are: don’t implement a change, replace a command with another command, or apply the case-change via <a id="wrglossary.133"></a><a href="#glo:glsmakefirstuc"><code class="csfmt">\glsmakefirstuc</code></a>.<p>
For convenience, the following commands are also provided: <div class="pinnedbox"><div class="pinnedboxtitle"><a id="wrglossary.134"></a><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
<a id="wrglossary.135"></a><code class="code"><dfn id="glo:xmakefirstuc"><code class="csfmt">\xmakefirstuc</code></dfn>{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code></div><!-- end of pinnedbox -->
This is simply a shortcut for: <pre class="compactcodebox"><code class="cmd">\expandafter</code><a id="wrglossary.136"></a><a href="#glo:makefirstuc"><code class="csfmt">\makefirstuc</code></a><code class="cmd">\expandafter</code>{<span class="meta">〈<em class="metainner">text</em>〉</span>}
</pre> This ensures the first token in <span class="meta">〈<em class="metainner">text</em>〉</span> is expanded before being passed to <a id="wrglossary.137"></a><a href="#glo:makefirstuc"><code class="csfmt">\makefirstuc</code></a>.<p>
<div class="pinnedbox"><div class="pinnedboxtitle"><a id="wrglossary.138"></a><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
<a id="wrglossary.139"></a><code class="code"><dfn id="glo:emakefirstuc"><code class="csfmt">\emakefirstuc</code></dfn>{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code></div><!-- end of pinnedbox -->
This fully expands its argument before passing it to <a id="wrglossary.140"></a><a href="#glo:makefirstuc"><code class="csfmt">\makefirstuc</code></a>. For example: <pre class="codebox"><div class="codeboxtitle"><a id="wrglossary.141"></a><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\newcommand</code>{<code class="cmd">\test</code>}[1]{sample #1}
<code class="cmd">\newcommand</code>{<code class="cmd">\tmp</code>}{<code class="cmd">\test</code>{text}}
<a id="wrglossary.142"></a><a href="#glo:makefirstuc"><code class="csfmt">\makefirstuc</code></a>{<code class="cmd">\tmp</code>} /
<a id="wrglossary.143"></a><a href="#glo:xmakefirstuc"><code class="csfmt">\xmakefirstuc</code></a>{<code class="cmd">\tmp</code>} /
<a id="wrglossary.144"></a><a href="#glo:emakefirstuc"><code class="csfmt">\emakefirstuc</code></a>{<code class="cmd">\tmp</code>}
</pre> <div class="resultbox"><div class="resultboxtitle"><a id="wrglossary.145"></a><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of resultboxtitle -->
sample text / sample Text / Sample text </div><!-- end of resultbox -->
If you don’t have any mappings or blockers set up, it’s simpler to use <a id="wrglossary.146"></a><a href="#glo:MFUsentencecase"><code class="csfmt">\MFUsentencecase</code></a> instead of <a id="wrglossary.147"></a><a href="#glo:emakefirstuc"><code class="csfmt">\emakefirstuc</code></a>.<p>
<div class="important"><div class="importanttitle"><a id="wrglossary.148"></a><a href="#glo:sym.important"><span title="Important" class="icon">ℹ</span></a></div><!-- end of importanttitle -->
With <a id="wrglossary.149"></a><a href="#glo:emakefirstuc"><code class="csfmt">\emakefirstuc</code></a>, mappings and blockers will only be detected if they are robust or protected, otherwise they will expand too soon to be detected. </div><!-- end of important -->
<p>
<div class="pinnedbox"><div class="pinnedboxtitle"><a id="wrglossary.150"></a><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
<a id="wrglossary.151"></a><code class="code"><dfn id="glo:glsmakefirstuc"><code class="csfmt">\glsmakefirstuc</code></dfn>{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code></div><!-- end of pinnedbox -->
This command is used by <a id="wrglossary.152"></a><a href="#glo:makefirstuc"><code class="csfmt">\makefirstuc</code></a> to perform the case-change. The <span class="qt">“gls”</span> prefix is for historical reasons as the original code was part of the <a id="wrglossary.153"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package. With the default <a id="wrglossary.154"></a><a href="#glo:opt.unexpanded"><span class="optfmt">unexpanded</span></a> option, this command is defined as: <pre class="compactcodebox"><a id="wrglossary.155"></a><a href="#glo:MFUsentencecase"><code class="csfmt">\MFUsentencecase</code></a>{<a id="wrglossary.156"></a><a href="#glo:unexpanded"><code class="csfmt">\unexpanded</code></a>{<span class="meta">〈<em class="metainner">text</em>〉</span>}}
</pre> The use of <a id="wrglossary.157"></a><a href="#glo:unexpanded"><code class="csfmt">\unexpanded</code></a> inhibits the expansion of <span class="meta">〈<em class="metainner">text</em>〉</span> that would otherwise occur. This allows <a id="wrglossary.158"></a><a href="#glo:makefirstuc"><code class="csfmt">\makefirstuc</code></a> to maintain as much backward-compatibility with version 2.07 as possible. This is particularly important when using the <a id="wrglossary.159"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package with a style that automatically converts the description to <a id="wrglossary.160"></a><a href="#glo:dual.sentence-case">sentence-case</a>, as there may well be documents with complex descriptions that contain fragile commands.<p>
The <a id="wrglossary.161"></a><a href="#glo:opt.expanded"><span class="optfmt">expanded</span></a> package option will redefine <a id="wrglossary.162"></a><a href="#glo:glsmakefirstuc"><code class="csfmt">\glsmakefirstuc</code></a> to use <a id="wrglossary.163"></a><a href="#glo:MFUsentencecase"><code class="csfmt">\MFUsentencecase</code></a> without <a id="wrglossary.164"></a><a href="#glo:unexpanded"><code class="csfmt">\unexpanded</code></a>. The <a id="wrglossary.165"></a><a href="#glo:opt.grabfirst"><span class="optfmt">grabfirst</span></a> package option will redefine <a id="wrglossary.166"></a><a href="#glo:glsmakefirstuc"><code class="csfmt">\glsmakefirstuc</code></a> to use <a id="wrglossary.167"></a><a href="#glo:mfugrabfirstuc"><code class="csfmt">\mfugrabfirstuc</code></a> to emulates the behaviour of <a id="wrglossary.168"></a><a href="#glo:glsmakefirstuc"><code class="csfmt">\glsmakefirstuc</code></a> in v2.07 and below without using rollback.<p>
<div class="pinnedbox"><div class="pinnedboxtitle"><a id="wrglossary.169"></a><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
<a id="wrglossary.170"></a><code class="code"><dfn id="glo:mfugrabfirstuc"><code class="csfmt">\mfugrabfirstuc</code></dfn>{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code><p>
<div class="noteBox">avoid where possible</div><!-- end of noteBox -->
</div><!-- end of pinnedbox -->
This robust command is provided to emulate v2.07 and its use is discouraged. Note that you may still have different results compared to v2.07, so you may need to use rollback instead. (Note that the <a id="wrglossary.171"></a><a href="#glo:opt.grabfirst"><span class="optfmt">grabfirst</span></a> option additionally redefines <a id="wrglossary.172"></a><a href="#glo:mfirstucMakeUppercase"><code class="csfmt">\mfirstucMakeUppercase</code></a> to <a id="wrglossary.173"></a><a href="#glo:MakeUppercase"><code class="csfmt">\MakeUppercase</code></a>, which you will also need.)<p>
This applies <a id="wrglossary.174"></a><a href="#glo:mfirstucMakeUppercase"><code class="csfmt">\mfirstucMakeUppercase</code></a> to the first token in <span class="meta">〈<em class="metainner">text</em>〉</span> and leaves the remainder unchanged. This won’t work if <span class="meta">〈<em class="metainner">text</em>〉</span> starts with a <a id="wrglossary.175"></a><a href="#glo:utf8">UTF-8</a> character unless you use XeLaTeX or LuaLaTeX, so avoid using this method where possible. For example: <pre class="codebox"><div class="codeboxtitle"><a id="wrglossary.176"></a><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\renewcommand</code>{<a id="wrglossary.177"></a><a href="#glo:mfirstucMakeUppercase"><code class="csfmt">\mfirstucMakeUppercase</code></a>}[1]{<span class="comment">% </span>
<a id="wrglossary.178"></a><a href="#glo:MakeUppercase"><code class="csfmt">\MakeUppercase</code></a>{#1}<span class="comment">% </span>
}
<a id="wrglossary.179"></a><a href="#glo:mfugrabfirstuc"><code class="csfmt">\mfugrabfirstuc</code></a>{sample}
</pre> This is equivalent to: <pre class="codebox"><div class="codeboxtitle"><a id="wrglossary.180"></a><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.181"></a><a href="#glo:mfirstucMakeUppercase"><code class="csfmt">\mfirstucMakeUppercase</code></a>{s}ample
</pre> Whereas <pre class="unicodebox"><div class="unicodeboxtitle"><a id="wrglossary.182"></a><a href="#glo:sym.unicode"><span title="Unicode Input" class="icon"><span class="overlapped">🗋</span><span class="overlapper">U</span></span></a></div><code class="cmd">\renewcommand</code>{<a id="wrglossary.183"></a><a href="#glo:mfirstucMakeUppercase"><code class="csfmt">\mfirstucMakeUppercase</code></a>}[1]{<span class="comment">% </span>
<a id="wrglossary.184"></a><a href="#glo:MakeUppercase"><code class="csfmt">\MakeUppercase</code></a>{#1}<span class="comment">% </span>
}
<a id="wrglossary.185"></a><a href="#glo:mfugrabfirstuc"><code class="csfmt">\mfugrabfirstuc</code></a>{élite}
</pre> only works with XeLaTeX or LuaLaTeX.<p>
<div class="warning"><div class="warningtitle"><a id="wrglossary.186"></a><a href="#glo:sym.warning"><span title="Warning" class="icon">⚠</span></a></div><!-- end of warningtitle -->
As with earlier implementations of <a id="wrglossary.187"></a><a href="#glo:makefirstuc"><code class="csfmt">\makefirstuc</code></a> that tried to only apply the case-change to the first token, this won’t produce the desired result if the argument starts with a punctuation character. </div><!-- end of warning -->
<p>
For example: <pre class="codebox"><div class="codeboxtitle"><a id="wrglossary.188"></a><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.189"></a><a href="#glo:mfugrabfirstuc"><code class="csfmt">\mfugrabfirstuc</code></a>{`sample'}
</pre> This is equivalent to: <pre class="compactcodebox"><a id="wrglossary.190"></a><a href="#glo:mfirstucMakeUppercase"><code class="csfmt">\mfirstucMakeUppercase</code></a>{`}sample'
</pre> so no case-change is applied.<p>
</section><!-- end of section sec:sentencecasecmds -->
<section id="sec:exclusions"><!-- start of section sec:exclusions --><div class="tomain"><a href="#main">[top]</a></div>
<h2><!-- start of section header -->1.3. Exclusions<div class="labellink"><a href="#sec:exclusions">[link]</a></div></h2><!-- end of section header -->
<p>
<div class="information"><div class="informationtitle"><a id="wrglossary.191"></a><a href="#glo:sym.information"><span title="Information" class="icon">🛈</span></a></div><!-- end of informationtitle -->
Exclusions will apply to all LaTeX3 case-changing commands, so will also affect <a id="wrglossary.192"></a><a href="#glo:mfirstucMakeUppercase"><code class="csfmt">\mfirstucMakeUppercase</code></a>, but this is generally desirable. </div><!-- end of information -->
<p>
<div class="pinnedbox"><div class="pinnedboxtitle"><a id="wrglossary.193"></a><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
<a id="wrglossary.194"></a><code class="code"><dfn id="glo:MFUexcl"><code class="csfmt">\MFUexcl</code></dfn>{<span class="meta">〈<em class="metainner">cs</em>〉</span>}</code></div><!-- end of pinnedbox -->
Identifies the text-block command <code class="code"><span class="meta">〈<em class="metainner">cs</em>〉</span>{<span class="meta">〈<em class="metainner">arg</em>〉</span>}</code> as an <a id="wrglossary.195"></a><a href="#glo:dual.exclusion">exclusion</a>. That is, one that should have its argument excluded from a case-change.<p>
Internally, <a id="wrglossary.196"></a><a href="#glo:MFUexcl"><code class="csfmt">\MFUexcl</code></a> adds <span class="meta">〈<em class="metainner">cs</em>〉</span> to LaTeX3’s exclusion list <a id="wrglossary.197"></a><a href="#glo:ltextcaseexcludeargtl"><code class="csfmt">\l_text_case_exclude_arg_tl</code></a>, which means that <a id="wrglossary.198"></a><a href="#glo:MFUsentencecase"><code class="csfmt">\MFUsentencecase</code></a> will skip the command and its argument and apply the case-change to the following content. Some common commands (<a id="wrglossary.199"></a><a href="#glo:begin"><code class="csfmt">\begin</code></a> <a id="wrglossary.200"></a><a href="#glo:cite"><code class="csfmt">\cite</code></a> <a id="wrglossary.201"></a><a href="#glo:end"><code class="csfmt">\end</code></a> <a id="wrglossary.202"></a><a href="#glo:label"><code class="csfmt">\label</code></a> and <a id="wrglossary.203"></a><a href="#glo:ref"><code class="csfmt">\ref</code></a>) are automatically added by the LaTeX3 kernel. The exclusions are also recognised by <a id="wrglossary.204"></a><a href="#glo:makefirstuc"><code class="csfmt">\makefirstuc</code></a> when it parses its argument.<p>
<div class="information"><div class="informationtitle"><a id="wrglossary.205"></a><a href="#glo:sym.information"><span title="Information" class="icon">🛈</span></a></div><!-- end of informationtitle -->
The command <a id="wrglossary.206"></a><a href="#glo:NoCaseChange"><code class="csfmt">\NoCaseChange</code></a> is automatically treated as an exclusion by the LaTeX3 case-changing commands with recent LaTeX kernels. You may want to add it as a blocker for <a id="wrglossary.207"></a><a href="#glo:makefirstuc"><code class="csfmt">\makefirstuc</code></a> and keep <a id="wrglossary.208"></a><a href="#glo:MFUskippunc"><code class="csfmt">\MFUskippunc</code></a> for exclusions.<p>
Note that <a id="wrglossary.209"></a><a href="#glo:ensuremath"><code class="csfmt">\ensuremath</code></a> is added as an exclusion by <a id="wrglossary.210"></a><a href="#glo:pkg.mfirstuc"><span class="styfmt">mfirstuc</span></a> otherwise <a id="wrglossary.211"></a><a href="#glo:makefirstuc"><code class="csfmt">\makefirstuc</code></a> will pass its argument to <a id="wrglossary.212"></a><a href="#glo:MFUsentencecase"><code class="csfmt">\MFUsentencecase</code></a>, which will cause a problem. </div><!-- end of information -->
<p>
Another way of identifying content that should be excluded with <a id="wrglossary.213"></a><a href="#glo:makefirstuc"><code class="csfmt">\makefirstuc</code></a> is to encapsulate it with: <div class="pinnedbox"><div class="pinnedboxtitle"><a id="wrglossary.214"></a><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
<a id="wrglossary.215"></a><code class="code"><dfn id="glo:MFUskippunc"><code class="csfmt">\MFUskippunc</code></dfn>{<span class="meta">〈<em class="metainner">content</em>〉</span>}</code></div><!-- end of pinnedbox -->
This is a robust command that simply does its argument and is automatically added to the exclusion list. This may be used for cases where the excluded command isn’t a simple text-block command that only has one mandatory argument or where leading punctuation is followed by a <a id="wrglossary.216"></a><a href="#glo:dual.blocker">blocker</a> or <a id="wrglossary.217"></a><a href="#glo:dual.mapping">mapping</a>.<p>
The command name stems from earlier versions where leading <a id="wrglossary.218"></a><a href="#glo:idx.punctuation">punctuation</a> needed to be skipped. This is no longer necessary, but the command remains as a general purpose robust exclusion command.<p>
For example, <a id="wrglossary.219"></a><a href="#glo:glsadd"><code class="csfmt">\glsadd</code></a> (provided by <a id="wrglossary.220"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a>) should have its argument skipped, since its argument is a label, so the following will ensure that <code class="code"><a id="wrglossary.221"></a><a href="#glo:glsadd"><code class="csfmt">\glsadd</code></a>{<span class="meta">〈<em class="metainner">label</em>〉</span>}</code> will be skipped, and the case-change will be applied to the following text for both <a id="wrglossary.222"></a><a href="#glo:MFUsentencecase"><code class="csfmt">\MFUsentencecase</code></a> and <a id="wrglossary.223"></a><a href="#glo:makefirstuc"><code class="csfmt">\makefirstuc</code></a>. <pre class="codebox"><div class="codeboxtitle"><a id="wrglossary.224"></a><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.225"></a><a href="#glo:MFUexcl"><code class="csfmt">\MFUexcl</code></a>{<a id="wrglossary.226"></a><a href="#glo:glsadd"><code class="csfmt">\glsadd</code></a>}
<a id="wrglossary.227"></a><a href="#glo:makefirstuc"><code class="csfmt">\makefirstuc</code></a>{<a id="wrglossary.228"></a><a href="#glo:glsadd"><code class="csfmt">\glsadd</code></a>{ex}some text}
<a id="wrglossary.229"></a><a href="#glo:MFUsentencecase"><code class="csfmt">\MFUsentencecase</code></a>{<a id="wrglossary.230"></a><a href="#glo:glsadd"><code class="csfmt">\glsadd</code></a>{ex}some text}
</pre> This will be equivalent to: <pre class="compactcodebox"><a id="wrglossary.231"></a><a href="#glo:glsadd"><code class="csfmt">\glsadd</code></a>{ex}Some text
</pre> However, <a id="wrglossary.232"></a><a href="#glo:glsadd"><code class="csfmt">\glsadd</code></a> can take an optional argument which, if present, will cause a problem. For example: <pre class="badcodebox"><div class="badcodeboxtitle"><a id="wrglossary.233"></a><a href="#glo:sym.badcode"><span title="Problematic Input" class="icon"><span class="overlapped">🖹</span><span class="overlapper"><span class="deprecatedorbannedfmt">🛇</span></span></span></a></div><a id="wrglossary.234"></a><a href="#glo:MFUexcl"><code class="csfmt">\MFUexcl</code></a>{<a id="wrglossary.235"></a><a href="#glo:glsadd"><code class="csfmt">\glsadd</code></a>}
<a id="wrglossary.236"></a><a href="#glo:makefirstuc"><code class="csfmt">\makefirstuc</code></a>{<a id="wrglossary.237"></a><a href="#glo:glsadd"><code class="csfmt">\glsadd</code></a>[counter=section]{ex}some text}
<a id="wrglossary.238"></a><a href="#glo:MFUsentencecase"><code class="csfmt">\MFUsentencecase</code></a>{<a id="wrglossary.239"></a><a href="#glo:glsadd"><code class="csfmt">\glsadd</code></a>[counter=section]{ex}some text}
</pre> Both commands will cause the following error: <pre class="transcript"><div class="transcripttitle"><a id="wrglossary.240"></a><a href="#glo:sym.transcript"><span title="Transcript" class="icon">🔎</span></a></div>! Package glossaries Error: Glossary entry `[' has not been defined.
</pre> This is because the open square bracket is assumed to be the argument of <a id="wrglossary.241"></a><a href="#glo:glsadd"><code class="csfmt">\glsadd</code></a>, so this effectively becomes: <pre class="compactcodebox"><a id="wrglossary.242"></a><a href="#glo:glsadd"><code class="csfmt">\glsadd</code></a>{[}Counter=section] exsome text
<a id="wrglossary.243"></a><a href="#glo:glsadd"><code class="csfmt">\glsadd</code></a>{[}Counter=section] exsome text
</pre> which means that now <code class="code">[</code> is considered the label and everything that follows is just text.<p>
For this situation to work, you need to encapsulate the problematic content with an exclusion command, such as <a id="wrglossary.244"></a><a href="#glo:NoCaseChange"><code class="csfmt">\NoCaseChange</code></a> or <a id="wrglossary.245"></a><a href="#glo:MFUskippunc"><code class="csfmt">\MFUskippunc</code></a>: <pre class="codebox"><div class="codeboxtitle"><a id="wrglossary.246"></a><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.247"></a><a href="#glo:makefirstuc"><code class="csfmt">\makefirstuc</code></a>{<a id="wrglossary.248"></a><a href="#glo:MFUskippunc"><code class="csfmt">\MFUskippunc</code></a>{<a id="wrglossary.249"></a><a href="#glo:glsadd"><code class="csfmt">\glsadd</code></a>[counter=section]{ex}}some text}
</pre> This will also work with <a id="wrglossary.250"></a><a href="#glo:MFUsentencecase"><code class="csfmt">\MFUsentencecase</code></a> because <a id="wrglossary.251"></a><a href="#glo:pkg.mfirstuc"><span class="styfmt">mfirstuc</span></a> automatically adds <a id="wrglossary.252"></a><a href="#glo:MFUskippunc"><code class="csfmt">\MFUskippunc</code></a> to the exclusion list.<p>
<div class="information"><div class="informationtitle"><a id="wrglossary.253"></a><a href="#glo:sym.information"><span title="Information" class="icon">🛈</span></a></div><!-- end of informationtitle -->
As from <a id="wrglossary.254"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v4.50, <a id="wrglossary.255"></a><a href="#glo:glsadd"><code class="csfmt">\glsadd</code></a> is automatically added as an exclusion, but be aware of the problem with using the optional argument, as described above. </div><!-- end of information -->
<p>
<a id="wrglossary.256"></a><a href="#glo:idx.punctuation">Punctuation</a> characters are skipped by <a id="wrglossary.257"></a><a href="#glo:MFUsentencecase"><code class="csfmt">\MFUsentencecase</code></a>. For example: <div style="text-align: center; border-style: none; "><a id="wrglossary.258"></a><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a><a id="wrglossary.259"></a><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of frame@coderesult@title -->
<p>
<pre class="sidebysidecode">
<a id="wrglossary.260"></a><a href="#glo:MFUsentencecase"><code class="csfmt">\MFUsentencecase</code></a>{`word'}
</pre><div class="sidebysideresult">‘Word’ </div><p>
However, leading <a id="wrglossary.261"></a><a href="#glo:idx.punctuation">punctuation</a> will result in <a id="wrglossary.262"></a><a href="#glo:makefirstuc"><code class="csfmt">\makefirstuc</code></a> passing its entire argument to <a id="wrglossary.263"></a><a href="#glo:MFUsentencecase"><code class="csfmt">\MFUsentencecase</code></a> (since the argument doesn’t start with <code class="code"><span class="meta">〈<em class="metainner">cs</em>〉</span>{<span class="meta">〈<em class="metainner">arg</em>〉</span>}</code>), which means that <a id="wrglossary.264"></a><a href="#glo:makefirstuc"><code class="csfmt">\makefirstuc</code></a> won’t detect any <a id="wrglossary.265"></a><a href="#glo:dual.blocker">blocker</a> or <a id="wrglossary.266"></a><a href="#glo:dual.mapping">mapping</a>.<p>
For example: <pre class="codebox"><div class="codeboxtitle"><a id="wrglossary.267"></a><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.268"></a><a href="#glo:MFUblocker"><code class="csfmt">\MFUblocker</code></a>{<a id="wrglossary.269"></a><a href="#glo:nameref"><code class="csfmt">\nameref</code></a>}
<code class="cmd">\newcommand</code>*{<code class="cmd">\qt</code>}[1]{``#1''}
<a id="wrglossary.270"></a><a href="#glo:makefirstuc"><code class="csfmt">\makefirstuc</code></a>{``<a id="wrglossary.271"></a><a href="#glo:nameref"><code class="csfmt">\nameref</code></a>{sec:sentencecase} section''} /
<a id="wrglossary.272"></a><a href="#glo:makefirstuc"><code class="csfmt">\makefirstuc</code></a>{<a id="wrglossary.273"></a><a href="#glo:MFUskippunc"><code class="csfmt">\MFUskippunc</code></a>{``}<a id="wrglossary.274"></a><a href="#glo:nameref"><code class="csfmt">\nameref</code></a>{sec:sentencecase} section''} /
<a id="wrglossary.275"></a><a href="#glo:makefirstuc"><code class="csfmt">\makefirstuc</code></a>{<code class="cmd">\qt</code>{<a id="wrglossary.276"></a><a href="#glo:nameref"><code class="csfmt">\nameref</code></a>{sec:sentencecase} section}}
</pre> <div class="resultbox"><div class="resultboxtitle"><a id="wrglossary.277"></a><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of resultboxtitle -->
“<a href="#sec:sentencecase">Sentence-Case</a> Section’’ / “<a href="#sec:sentencecase">Sentence-Case</a> section’’ / <span class="qt">“<a href="#sec:sentencecase">Sentence-Case</a> section”</span> </div><!-- end of resultbox -->
If you are using a package such as <a id="wrglossary.278"></a><a href="#glo:pkg.csquotes"><span class="styfmt">csquotes</span></a>, bear in mind that if the command is followed by an asterisk (a <span class="qt">“starred command”</span>) or an optional argument then it won’t fit the expected <code class="code"><span class="meta">〈<em class="metainner">cs</em>〉</span>{<span class="meta">〈<em class="metainner">arg</em>〉</span>}</code> format and unexpected results will occur.<p>
</section><!-- end of section sec:exclusions -->
<section id="sec:blockers"><!-- start of section sec:blockers --><div class="tomain"><a href="#main">[top]</a></div>
<h2><!-- start of section header -->1.4. Blockers<div class="labellink"><a href="#sec:blockers">[link]</a></div></h2><!-- end of section header -->
<p>
A <a id="wrglossary.279"></a><a href="#glo:dual.blocker">blocker</a> is a command that prevents any case-change if it occurs at the start of <a id="wrglossary.280"></a><a href="#glo:makefirstuc"><code class="csfmt">\makefirstuc</code></a> or after the argument of an <a id="wrglossary.281"></a><a href="#glo:dual.exclusion">exclusion</a>. Blockers are not supported by <a id="wrglossary.282"></a><a href="#glo:MFUsentencecase"><code class="csfmt">\MFUsentencecase</code></a> but are instead treated as exclusions. <p>
<div class="pinnedbox"><div class="pinnedboxtitle"><a id="wrglossary.283"></a><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
<a id="wrglossary.284"></a><code class="code"><dfn id="glo:MFUblocker"><code class="csfmt">\MFUblocker</code></dfn>{<span class="meta">〈<em class="metainner">cs</em>〉</span>}</code></div><!-- end of pinnedbox -->
Identifies <span class="meta">〈<em class="metainner">cs</em>〉</span> as a <a id="wrglossary.285"></a><a href="#glo:dual.blocker">blocker</a>. Since <a id="wrglossary.286"></a><a href="#glo:dual.blocker">blockers</a> aren’t supported by <a id="wrglossary.287"></a><a href="#glo:MFUsentencecase"><code class="csfmt">\MFUsentencecase</code></a>, this automatically implements <code class="code"><a id="wrglossary.288"></a><a href="#glo:MFUexcl"><code class="csfmt">\MFUexcl</code></a>{<span class="meta">〈<em class="metainner">cs</em>〉</span>}</code> to protect its argument from <a id="wrglossary.289"></a><a href="#glo:MFUsentencecase"><code class="csfmt">\MFUsentencecase</code></a>, but it won’t prevent subsequent content from being changed.<p>
For example: <pre class="codebox"><div class="codeboxtitle"><a id="wrglossary.290"></a><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.291"></a><a href="#glo:MFUblocker"><code class="csfmt">\MFUblocker</code></a>{<a id="wrglossary.292"></a><a href="#glo:nameref"><code class="csfmt">\nameref</code></a>}
<a id="wrglossary.293"></a><a href="#glo:makefirstuc"><code class="csfmt">\makefirstuc</code></a>{<a id="wrglossary.294"></a><a href="#glo:nameref"><code class="csfmt">\nameref</code></a>{sec:sentencecase} section}
</pre> <div class="resultbox"><div class="resultboxtitle"><a id="wrglossary.295"></a><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of resultboxtitle -->
<a href="#sec:sentencecase">Sentence-Case</a> section </div><!-- end of resultbox -->
<p>
In the following, the <a id="wrglossary.296"></a><a href="#glo:dual.blocker">blocker</a> isn’t detected by <a id="wrglossary.297"></a><a href="#glo:makefirstuc"><code class="csfmt">\makefirstuc</code></a> because the content doesn’t start with <code class="code"><span class="meta">〈<em class="metainner">cs</em>〉</span>{<span class="meta">〈<em class="metainner">arg</em>〉</span>}</code> or <code class="code"><span class="cmdfmt">\protect</span><span class="meta">〈<em class="metainner">cs</em>〉</span>{<span class="meta">〈<em class="metainner">arg</em>〉</span>}</code>. This means that the entire content is passed to <a id="wrglossary.298"></a><a href="#glo:MFUsentencecase"><code class="csfmt">\MFUsentencecase</code></a> which treats <a id="wrglossary.299"></a><a href="#glo:nameref"><code class="csfmt">\nameref</code></a> as an <a id="wrglossary.300"></a><a href="#glo:dual.exclusion">exclusion</a>: <pre class="codebox"><div class="codeboxtitle"><a id="wrglossary.301"></a><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.302"></a><a href="#glo:MFUblocker"><code class="csfmt">\MFUblocker</code></a>{<a id="wrglossary.303"></a><a href="#glo:nameref"><code class="csfmt">\nameref</code></a>}
<a id="wrglossary.304"></a><a href="#glo:makefirstuc"><code class="csfmt">\makefirstuc</code></a>{<code class="cmd">\relax</code><a id="wrglossary.305"></a><a href="#glo:nameref"><code class="csfmt">\nameref</code></a>{sec:sentencecase} section}
</pre> <div class="resultbox"><div class="resultboxtitle"><a id="wrglossary.306"></a><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of resultboxtitle -->
<a href="#sec:sentencecase">Sentence-Case</a> Section </div><!-- end of resultbox -->
<p>
<div class="important"><div class="importanttitle"><a id="wrglossary.307"></a><a href="#glo:sym.important"><span title="Important" class="icon">ℹ</span></a></div><!-- end of importanttitle -->
If a <a id="wrglossary.308"></a><a href="#glo:@@glslabel@blocker">blocking command</a> is inside the definition of another command, it won’t be visible to <a id="wrglossary.309"></a><a href="#glo:makefirstuc"><code class="csfmt">\makefirstuc</code></a> unless the other command is expanded before applying <a id="wrglossary.310"></a><a href="#glo:makefirstuc"><code class="csfmt">\makefirstuc</code></a>. For example, by using <a id="wrglossary.311"></a><a href="#glo:xmakefirstuc"><code class="csfmt">\xmakefirstuc</code></a> or <a id="wrglossary.312"></a><a href="#glo:emakefirstuc"><code class="csfmt">\emakefirstuc</code></a>. If it doesn’t get expanded until after it has been passed to <a id="wrglossary.313"></a><a href="#glo:MFUsentencecase"><code class="csfmt">\MFUsentencecase</code></a>, then it will be treated as an <a id="wrglossary.314"></a><a href="#glo:dual.exclusion">exclusion</a> instead. </div><!-- end of important -->
<p>
Recent LaTeX kernels provide <a id="wrglossary.315"></a><a href="#glo:NoCaseChange"><code class="csfmt">\NoCaseChange</code></a> and automatically add it as an <a id="wrglossary.316"></a><a href="#glo:dual.exclusion">exclusion</a>. You may want to add it as a <a id="wrglossary.317"></a><a href="#glo:dual.blocker">blocker</a> for <a id="wrglossary.318"></a><a href="#glo:makefirstuc"><code class="csfmt">\makefirstuc</code></a>. For example: <pre class="codebox"><div class="codeboxtitle"><a id="wrglossary.319"></a><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.320"></a><a href="#glo:makefirstuc"><code class="csfmt">\makefirstuc</code></a>{<a id="wrglossary.321"></a><a href="#glo:ensuremath"><code class="csfmt">\ensuremath</code></a>{<code class="cmd">\alpha</code>}-particle} /
<a id="wrglossary.322"></a><a href="#glo:makefirstuc"><code class="csfmt">\makefirstuc</code></a>{<a id="wrglossary.323"></a><a href="#glo:idx.sym.dollar"><code class="code">$</code></a><code class="cmd">\alpha</code><a id="wrglossary.324"></a><a href="#glo:idx.sym.dollar"><code class="code">$</code></a>-particle} /
<a id="wrglossary.325"></a><a href="#glo:MFUsentencecase"><code class="csfmt">\MFUsentencecase</code></a>{<a id="wrglossary.326"></a><a href="#glo:ensuremath"><code class="csfmt">\ensuremath</code></a>{<code class="cmd">\alpha</code>}-particle} /
<a id="wrglossary.327"></a><a href="#glo:MFUsentencecase"><code class="csfmt">\MFUsentencecase</code></a>{<a id="wrglossary.328"></a><a href="#glo:idx.sym.dollar"><code class="code">$</code></a><code class="cmd">\alpha</code><a id="wrglossary.329"></a><a href="#glo:idx.sym.dollar"><code class="code">$</code></a>-particle}
<a id="wrglossary.330"></a><a href="#glo:MFUblocker"><code class="csfmt">\MFUblocker</code></a>{<a id="wrglossary.331"></a><a href="#glo:NoCaseChange"><code class="csfmt">\NoCaseChange</code></a>}<span class="comment">% </span>
<a id="wrglossary.332"></a><a href="#glo:makefirstuc"><code class="csfmt">\makefirstuc</code></a>{<a id="wrglossary.333"></a><a href="#glo:ensuremath"><code class="csfmt">\ensuremath</code></a>{<code class="cmd">\alpha</code>}-particle} /
<a id="wrglossary.334"></a><a href="#glo:makefirstuc"><code class="csfmt">\makefirstuc</code></a>{<a id="wrglossary.335"></a><a href="#glo:NoCaseChange"><code class="csfmt">\NoCaseChange</code></a>{<a id="wrglossary.336"></a><a href="#glo:idx.sym.dollar"><code class="code">$</code></a><code class="cmd">\alpha</code><a id="wrglossary.337"></a><a href="#glo:idx.sym.dollar"><code class="code">$</code></a>}-particle} /
<a id="wrglossary.338"></a><a href="#glo:MFUsentencecase"><code class="csfmt">\MFUsentencecase</code></a>{<a id="wrglossary.339"></a><a href="#glo:ensuremath"><code class="csfmt">\ensuremath</code></a>{<code class="cmd">\alpha</code>}-particle} /
<a id="wrglossary.340"></a><a href="#glo:MFUsentencecase"><code class="csfmt">\MFUsentencecase</code></a>{<a id="wrglossary.341"></a><a href="#glo:NoCaseChange"><code class="csfmt">\NoCaseChange</code></a>{<a id="wrglossary.342"></a><a href="#glo:idx.sym.dollar"><code class="code">$</code></a><code class="cmd">\alpha</code><a id="wrglossary.343"></a><a href="#glo:idx.sym.dollar"><code class="code">$</code></a>}-particle}
</pre> Note that <a id="wrglossary.344"></a><a href="#glo:pkg.mfirstuc"><span class="styfmt">mfirstuc</span></a> adds <a id="wrglossary.345"></a><a href="#glo:ensuremath"><code class="csfmt">\ensuremath</code></a> as an exclusion so <a id="wrglossary.346"></a><a href="#glo:makefirstuc"><code class="csfmt">\makefirstuc</code></a> will skip it. Whereas the example above that starts with <a id="wrglossary.347"></a><a href="#glo:idx.sym.dollar"><code class="code">$</code></a> will have the entire argument passed to <a id="wrglossary.348"></a><a href="#glo:MFUsentencecase"><code class="csfmt">\MFUsentencecase</code></a>, which skips the maths content. In the first paragraph, <a id="wrglossary.349"></a><a href="#glo:NoCaseChange"><code class="csfmt">\NoCaseChange</code></a> is only an <a id="wrglossary.350"></a><a href="#glo:dual.exclusion">exclusion</a>, but in the second paragraph it’s also a <a id="wrglossary.351"></a><a href="#glo:dual.blocker">blocker</a>. <div class="resultbox"><div class="resultboxtitle"><a id="wrglossary.352"></a><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of resultboxtitle -->
Exclusion: 𝛼-Particle / 𝛼-Particle / 𝛼-Particle / 𝛼-Particle<p>
Blocker: 𝛼-Particle / 𝛼-particle / 𝛼-Particle / 𝛼-Particle </div><!-- end of resultbox -->
<p>
</section><!-- end of section sec:blockers -->
<section id="sec:mappings"><!-- start of section sec:mappings --><div class="tomain"><a href="#main">[top]</a></div>
<h2><!-- start of section header -->1.5. Mappings<div class="labellink"><a href="#sec:mappings">[link]</a></div></h2><!-- end of section header -->
<p>
A <a id="wrglossary.353"></a><a href="#glo:dual.mapping">mapping</a> indicates that one command should be substituted for another, instead of applying a case-change. The assumption is that the substituted command should perform the case-change instead. <a id="wrglossary.354"></a><a href="#glo:dual.mapping">Mappings</a> are not supported by <a id="wrglossary.355"></a><a href="#glo:MFUsentencecase"><code class="csfmt">\MFUsentencecase</code></a> but are instead treated as exclusions.<p>
<div class="pinnedbox"><div class="pinnedboxtitle"><a id="wrglossary.356"></a><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
<a id="wrglossary.357"></a><code class="code"><dfn id="glo:MFUaddmap"><code class="csfmt">\MFUaddmap</code></dfn>{<span class="meta">〈<em class="metainner">cs1</em>〉</span>}{<span class="meta">〈<em class="metainner">cs2</em>〉</span>}</code></div><!-- end of pinnedbox -->
Identifies a mapping which indicates that <a id="wrglossary.358"></a><a href="#glo:makefirstuc"><code class="csfmt">\makefirstuc</code></a> should replace <span class="meta">〈<em class="metainner">cs1</em>〉</span> with <span class="meta">〈<em class="metainner">cs2</em>〉</span> and not apply a case-change. This automatically implements: <pre class="compactcodebox"><a id="wrglossary.359"></a><a href="#glo:MFUexcl"><code class="csfmt">\MFUexcl</code></a>{<span class="meta">〈<em class="metainner">cs1</em>〉</span>}<a id="wrglossary.360"></a><a href="#glo:MFUblocker"><code class="csfmt">\MFUblocker</code></a>{<span class="meta">〈<em class="metainner">cs2</em>〉</span>}
</pre> This means that <span class="meta">〈<em class="metainner">cs2</em>〉</span> is identified as a <a id="wrglossary.361"></a><a href="#glo:dual.blocker">blocker</a> (since it’s assumed to already be a <a id="wrglossary.362"></a><a href="#glo:dual.sentence-case">sentence-case</a> command) and <span class="meta">〈<em class="metainner">cs1</em>〉</span> is identified as an <a id="wrglossary.363"></a><a href="#glo:dual.exclusion">exclusion</a> to protect its argument from <a id="wrglossary.364"></a><a href="#glo:MFUsentencecase"><code class="csfmt">\MFUsentencecase</code></a>, which doesn’t support <a id="wrglossary.365"></a><a href="#glo:dual.mapping">mappings</a>.<p>
<div class="information"><div class="informationtitle"><a id="wrglossary.366"></a><a href="#glo:sym.information"><span title="Information" class="icon">🛈</span></a></div><!-- end of informationtitle -->
If either <span class="meta">〈<em class="metainner">cs1</em>〉</span> or <span class="meta">〈<em class="metainner">cs2</em>〉</span> is empty, no mapping is established, but an <a id="wrglossary.367"></a><a href="#glo:dual.exclusion">exclusion</a> or <a id="wrglossary.368"></a><a href="#glo:dual.blocker">blocker</a> will be set for the non-empty argument. </div><!-- end of information -->
<p>
For example (with <a id="wrglossary.369"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a>): <pre class="codebox"><div class="codeboxtitle"><a id="wrglossary.370"></a><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.371"></a><a href="#glo:MFUaddmap"><code class="csfmt">\MFUaddmap</code></a>{<a id="wrglossary.372"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>}{<a id="wrglossary.373"></a><a href="#glo:Gls"><code class="csfmt">\Gls</code></a>}
<a id="wrglossary.374"></a><a href="#glo:makefirstuc"><code class="csfmt">\makefirstuc</code></a>{<a id="wrglossary.375"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{ex} some text}
</pre> This will be converted to: <pre class="compactcodebox"><a id="wrglossary.376"></a><a href="#glo:Gls"><code class="csfmt">\Gls</code></a>{ex} some text
</pre> Note that this and similar <a id="wrglossary.377"></a><a href="#glo:dual.mapping">mappings</a> are automatically added in <a id="wrglossary.378"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v4.50+ and <a id="wrglossary.379"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+.<p>
<div class="important"><div class="importanttitle"><a id="wrglossary.380"></a><a href="#glo:sym.important"><span title="Important" class="icon">ℹ</span></a></div><!-- end of importanttitle -->
If a <a id="wrglossary.381"></a><a href="#glo:@@glslabel@mapping">mapped command</a> is inside the definition of another command, it won’t be visible to <a id="wrglossary.382"></a><a href="#glo:makefirstuc"><code class="csfmt">\makefirstuc</code></a> unless the other command is expanded before applying <a id="wrglossary.383"></a><a href="#glo:makefirstuc"><code class="csfmt">\makefirstuc</code></a>. For example, by using <a id="wrglossary.384"></a><a href="#glo:xmakefirstuc"><code class="csfmt">\xmakefirstuc</code></a> or <a id="wrglossary.385"></a><a href="#glo:emakefirstuc"><code class="csfmt">\emakefirstuc</code></a>. If it doesn’t get expanded until after it has been passed to <a id="wrglossary.386"></a><a href="#glo:MFUsentencecase"><code class="csfmt">\MFUsentencecase</code></a>, then it will be treated as an <a id="wrglossary.387"></a><a href="#glo:dual.exclusion">exclusion</a> instead. </div><!-- end of important -->
<p>
</section><!-- end of section sec:mappings -->
<section id="sec:pkgoptions"><!-- start of section sec:pkgoptions --><div class="tomain"><a href="#main">[top]</a></div>
<h2><!-- start of section header -->1.6. Package Options<div class="labellink"><a href="#sec:pkgoptions">[link]</a></div></h2><!-- end of section header -->
<p>
<div class="settingsbox"><div class="settingsboxtitle"><a id="wrglossary.388"></a><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
<a id="wrglossary.389"></a><code class="code"><dfn id="glo:opt.expanded"><span class="optfmt">expanded</span></dfn></code></div><!-- end of settingsbox -->
Redefines <a id="wrglossary.390"></a><a href="#glo:glsmakefirstuc"><code class="csfmt">\glsmakefirstuc</code></a> to simply use <a id="wrglossary.391"></a><a href="#glo:MFUsentencecase"><code class="csfmt">\MFUsentencecase</code></a>.<p>
<div class="settingsbox"><div class="settingsboxtitle"><a id="wrglossary.392"></a><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
<a id="wrglossary.393"></a><code class="code"><dfn id="glo:opt.unexpanded"><span class="optfmt">unexpanded</span></dfn></code></div><!-- end of settingsbox -->
Redefines <a id="wrglossary.394"></a><a href="#glo:glsmakefirstuc"><code class="csfmt">\glsmakefirstuc</code></a> to use <a id="wrglossary.395"></a><a href="#glo:MFUsentencecase"><code class="csfmt">\MFUsentencecase</code></a> without expanding its argument.<p>
<div class="settingsbox"><div class="settingsboxtitle"><a id="wrglossary.396"></a><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
<a id="wrglossary.397"></a><code class="code"><dfn id="glo:opt.grabfirst"><span class="optfmt">grabfirst</span></dfn></code><p>
<div class="noteBox">avoid where possible</div><!-- end of noteBox -->
</div><!-- end of settingsbox -->
Redefines <a id="wrglossary.398"></a><a href="#glo:glsmakefirstuc"><code class="csfmt">\glsmakefirstuc</code></a> to use <a id="wrglossary.399"></a><a href="#glo:mfugrabfirstuc"><code class="csfmt">\mfugrabfirstuc</code></a> and also redefines <a id="wrglossary.400"></a><a href="#glo:mfirstucMakeUppercase"><code class="csfmt">\mfirstucMakeUppercase</code></a> to use <a id="wrglossary.401"></a><a href="#glo:MakeUppercase"><code class="csfmt">\MakeUppercase</code></a>.<p>
This option is best avoided and is only provided to emulate the v2.07 behaviour of <a id="wrglossary.402"></a><a href="#glo:glsmakefirstuc"><code class="csfmt">\glsmakefirstuc</code></a>. However, you may still have different results compared to v2.07, so you may need to use rollback instead.<p>
</section><!-- end of section sec:pkgoptions -->
<section id="sec:capitalisewords"><!-- start of section sec:capitalisewords --><div class="tomain"><a href="#main">[top]</a></div>
<h1><!-- start of chapter header -->2. Title-Case<div class="labellink"><a href="#sec:capitalisewords">[link]</a></div></h1><!-- end of chapter header -->
<p>
The <a id="wrglossary.403"></a><a href="#glo:dual.title-case">title-case</a> commands are designed to convert the first letter of each word in a phrase to uppercase. These commands are robust. <div class="pinnedbox"><div class="pinnedboxtitle"><a id="wrglossary.404"></a><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
<a id="wrglossary.405"></a><code class="code"><dfn id="glo:capitalisewords"><code class="csfmt">\capitalisewords</code></dfn>{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code></div><!-- end of pinnedbox -->
This command applies a <a id="wrglossary.406"></a><a href="#glo:dual.sentence-case">sentence-case</a> command to each word in <span class="meta">〈<em class="metainner">text</em>〉</span> where the space character is used as the word separator. Note that it has to be an ordinary space character, not another form of space, such as <a id="wrglossary.407"></a><a href="#glo:idx.nbsp"><code class="code">~</code></a> or <a id="wrglossary.408"></a><a href="#glo:space"><code class="csfmt">\space</code></a>. Note that no expansion is performed on <span class="meta">〈<em class="metainner">text</em>〉</span>. For example: <div style="text-align: center; border-style: none; "><a id="wrglossary.409"></a><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a><a id="wrglossary.410"></a><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of frame@coderesult@title -->
<p>
<pre class="sidebysidecode">
<a id="wrglossary.411"></a><a href="#glo:capitalisewords"><code class="csfmt">\capitalisewords</code></a>{a sample phrase}
</pre><div class="sidebysideresult">A Sample Phrase </div><p>
See §<a href="#sec:nocap">2.1</a> for excluding words (such as <span class="qt">“of”</span>) from the case-changing.<p>
<div class="information"><div class="informationtitle"><a id="wrglossary.412"></a><a href="#glo:sym.information"><span title="Information" class="icon">🛈</span></a></div><!-- end of informationtitle -->
This isn’t the same as the LaTeX3 command <a id="wrglossary.413"></a><a href="#glo:texttitlecase:n"><code class="csfmt">\text_titlecase:n</code></a>, which converts the first letter to <a id="wrglossary.414"></a><a href="#glo:idx.uppercase">uppercase</a> and all other letters to <a id="wrglossary.415"></a><a href="#glo:idx.lowercase">lowercase</a>. </div><!-- end of information -->
<p>
For convenience, there are shortcut commands if expansion is required before parsing the argument: <div class="pinnedbox"><div class="pinnedboxtitle"><a id="wrglossary.416"></a><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
<a id="wrglossary.417"></a><code class="code"><dfn id="glo:xcapitalisewords"><code class="csfmt">\xcapitalisewords</code></dfn>{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code></div><!-- end of pinnedbox -->
This is a shortcut for: <pre class="compactcodebox"><code class="cmd">\expandafter</code><a id="wrglossary.418"></a><a href="#glo:capitalisewords"><code class="csfmt">\capitalisewords</code></a><code class="cmd">\expandafter</code>{<span class="meta">〈<em class="metainner">text</em>〉</span>}
</pre> <div class="pinnedbox"><div class="pinnedboxtitle"><a id="wrglossary.419"></a><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
<a id="wrglossary.420"></a><code class="code"><dfn id="glo:ecapitalisewords"><code class="csfmt">\ecapitalisewords</code></dfn>{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code></div><!-- end of pinnedbox -->
This fully expands <span class="meta">〈<em class="metainner">text</em>〉</span> before passing it to <a id="wrglossary.421"></a><a href="#glo:capitalisewords"><code class="csfmt">\capitalisewords</code></a>.<p>
The parser used by <a id="wrglossary.422"></a><a href="#glo:capitalisewords"><code class="csfmt">\capitalisewords</code></a> first splits up the text on each space character. Each of these space-separated words may actually be a compound, so further parsing is performed on each <span class="qt">“word”</span>. The divisions within the compound word should be marked up with: <div class="pinnedbox"><div class="pinnedboxtitle"><a id="wrglossary.423"></a><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
<a id="wrglossary.424"></a><code class="code"><dfn id="glo:MFUwordbreak"><code class="csfmt">\MFUwordbreak</code></dfn>{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code></div><!-- end of pinnedbox -->
For example: <div style="text-align: center; border-style: none; "><a id="wrglossary.425"></a><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a><a id="wrglossary.426"></a><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of frame@coderesult@title -->
<p>
<pre class="sidebysidecode">
<a id="wrglossary.427"></a><a href="#glo:capitalisewords"><code class="csfmt">\capitalisewords</code></a>{a
big<a id="wrglossary.428"></a><a href="#glo:MFUwordbreak"><code class="csfmt">\MFUwordbreak</code></a>{/}small idea}
</pre><div class="sidebysideresult">A Big/Small Idea </div><p>
Each sub-word within the compound word is encapsulated with: <div class="pinnedbox"><div class="pinnedboxtitle"><a id="wrglossary.429"></a><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
<a id="wrglossary.430"></a><code class="code"><dfn id="glo:MFUcapword"><code class="csfmt">\MFUcapword</code></dfn>{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code></div><!-- end of pinnedbox -->
Since it’s inconvenient to have to markup every hyphen, <a id="wrglossary.431"></a><a href="#glo:MFUcapword"><code class="csfmt">\MFUcapword</code></a> can be enabled to check for hyphens. <div class="pinnedbox"><div class="pinnedboxtitle"><a id="wrglossary.432"></a><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
<a id="wrglossary.433"></a><code class="code"><dfn id="glo:ifMFUhyphen"><code class="csfmt">\ifMFUhyphen</code></dfn> <span class="meta">〈<em class="metainner">true</em>〉</span><code class="csfmt">\else</code> <span class="meta">〈<em class="metainner">false</em>〉</span><code class="csfmt">\fi</code></code><span class="floatrightbox"><span class="summarytag">initial: </span><code class="cmd">\iffalse</code></span><span class="clearfix"></span></div><!-- end of pinnedbox -->
This conditional determines whether or not <a id="wrglossary.434"></a><a href="#glo:MFUcapword"><code class="csfmt">\MFUcapword</code></a> should consider a hyphen a word break. If this conditional is true, then <a id="wrglossary.435"></a><a href="#glo:MFUcapword"><code class="csfmt">\MFUcapword</code></a> will encapsulate its argument with: <div class="pinnedbox"><div class="pinnedboxtitle"><a id="wrglossary.436"></a><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
<a id="wrglossary.437"></a><code class="code"><dfn id="glo:MFUhyphencapword"><code class="csfmt">\MFUhyphencapword</code></dfn>{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code></div><!-- end of pinnedbox -->
This will parse <span class="meta">〈<em class="metainner">text</em>〉</span> for hyphen characters and apply the case change to each hyphen-separated word. Otherwise <a id="wrglossary.438"></a><a href="#glo:MFUcapword"><code class="csfmt">\MFUcapword</code></a> will treat its argument as a single word.<p>
The conditional can be set to true with: <div class="pinnedbox"><div class="pinnedboxtitle"><a id="wrglossary.439"></a><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
<a id="wrglossary.440"></a><code class="code"><dfn id="glo:MFUhyphentrue"><code class="csfmt">\MFUhyphentrue</code></dfn></code></div><!-- end of pinnedbox -->
and switched back off with: <div class="pinnedbox"><div class="pinnedboxtitle"><a id="wrglossary.441"></a><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
<a id="wrglossary.442"></a><code class="code"><dfn id="glo:MFUhyphenfalse"><code class="csfmt">\MFUhyphenfalse</code></dfn></code></div><!-- end of pinnedbox -->
<p>
For example: <pre class="codebox"><div class="codeboxtitle"><a id="wrglossary.443"></a><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.444"></a><a href="#glo:capitalisewords"><code class="csfmt">\capitalisewords</code></a>{server-side includes} /
<a id="wrglossary.445"></a><a href="#glo:MFUhyphentrue"><code class="csfmt">\MFUhyphentrue</code></a>
<a id="wrglossary.446"></a><a href="#glo:capitalisewords"><code class="csfmt">\capitalisewords</code></a>{server-side includes}
</pre> <div class="resultbox"><div class="resultboxtitle"><a id="wrglossary.447"></a><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of resultboxtitle -->
Server-side Includes / Server-Side Includes </div><!-- end of resultbox -->
<p>
The actual case-change of each word is performed with: <div class="pinnedbox"><div class="pinnedboxtitle"><a id="wrglossary.448"></a><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
<a id="wrglossary.449"></a><code class="code"><dfn id="glo:MFUcapwordfirstuc"><code class="csfmt">\MFUcapwordfirstuc</code></dfn>{<span class="meta">〈<em class="metainner">word</em>〉</span>}</code></div><!-- end of pinnedbox -->
This defaults to <code class="code"><a id="wrglossary.450"></a><a href="#glo:makefirstuc"><code class="csfmt">\makefirstuc</code></a>{<span class="meta">〈<em class="metainner">word</em>〉</span>}</code> but may be redefined to use <a id="wrglossary.451"></a><a href="#glo:MFUsentencecase"><code class="csfmt">\MFUsentencecase</code></a>, if preferred.<p>
<div class="important"><div class="importanttitle"><a id="wrglossary.452"></a><a href="#glo:sym.important"><span title="Important" class="icon">ℹ</span></a></div><!-- end of importanttitle -->
Hyphens and <a id="wrglossary.453"></a><a href="#glo:MFUwordbreak"><code class="csfmt">\MFUwordbreak</code></a> must be visible to the parser that searches for word breaks. This means they won’t be detected if they are within a group or in the definition of a command. </div><!-- end of important -->
<p>
Formatting for the entire phrase must go outside <a id="wrglossary.454"></a><a href="#glo:capitalisewords"><code class="csfmt">\capitalisewords</code></a> (unlike <a id="wrglossary.455"></a><a href="#glo:makefirstuc"><code class="csfmt">\makefirstuc</code></a>). For example: <pre class="codebox"><div class="codeboxtitle"><a id="wrglossary.456"></a><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.457"></a><a href="#glo:capitalisewords"><code class="csfmt">\capitalisewords</code></a>{<code class="cmd">\emph</code>{a sample phrase}} /
<code class="cmd">\emph</code>{<a id="wrglossary.458"></a><a href="#glo:capitalisewords"><code class="csfmt">\capitalisewords</code></a>{a sample phrase}}
</pre> <div class="resultbox"><div class="resultboxtitle"><a id="wrglossary.459"></a><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of resultboxtitle -->
<span style="font-style: italic; font-variant: normal; ">A sample phrase</span> / <span style="font-style: italic; font-variant: normal; ">A Sample Phrase</span> </div><!-- end of resultbox -->
<p>
If your phrase is likely to contain formatting commands, you can instead use: <div class="pinnedbox"><div class="pinnedboxtitle"><a id="wrglossary.460"></a><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
<a id="wrglossary.461"></a><code class="code"><dfn id="glo:capitalisefmtwords"><code class="csfmt">\capitalisefmtwords</code></dfn>{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code><span class="floatrightbox"><span class="summarytag">modifier: </span>* </span><span class="clearfix"></span></div><!-- end of pinnedbox -->
where <span class="meta">〈<em class="metainner">text</em>〉</span> may be just words (as with <a id="wrglossary.462"></a><a href="#glo:capitalisewords"><code class="csfmt">\capitalisewords</code></a>): <pre class="compactcodebox"><a id="wrglossary.463"></a><a href="#glo:capitalisefmtwords"><code class="csfmt">\capitalisefmtwords</code></a>{<span class="meta">〈<em class="metainner">words</em>〉</span>}
</pre> or may be entirely enclosed in a formatting command in the form: <pre class="compactcodebox"><a id="wrglossary.464"></a><a href="#glo:capitalisefmtwords"><code class="csfmt">\capitalisefmtwords</code></a>{<span class="meta">〈<em class="metainner">cs</em>〉</span>{<span class="meta">〈<em class="metainner">words</em>〉</span>}}
</pre> or contain formatted sub-phrases: <pre class="compactcodebox"><a id="wrglossary.465"></a><a href="#glo:capitalisefmtwords"><code class="csfmt">\capitalisefmtwords</code></a>{<span class="meta">〈<em class="metainner">words</em>〉</span> <span class="meta">〈<em class="metainner">cs</em>〉</span>{<span class="meta">〈<em class="metainner">sub-phrase</em>〉</span>} <span class="meta">〈<em class="metainner">words</em>〉</span>}
</pre> The starred form only permits a text-block command at the start of the phrase. See §<a href="#sec:titlecaseexamples">2.3</a> for examples.<p>
<div class="warning"><div class="warningtitle"><a id="wrglossary.466"></a><a href="#glo:sym.warning"><span title="Warning" class="icon">⚠</span></a></div><!-- end of warningtitle -->
Avoid declarations, such as <code class="cmd">\bfseries</code> or <code class="cmd">\em</code>. </div><!-- end of warning -->
<p>
If expansion is required, you can use: <div class="pinnedbox"><div class="pinnedboxtitle"><a id="wrglossary.467"></a><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
<a id="wrglossary.468"></a><code class="code"><dfn id="glo:xcapitalisefmtwords"><code class="csfmt">\xcapitalisefmtwords</code></dfn>{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code><span class="floatrightbox"><span class="summarytag">modifier: </span>* </span><span class="clearfix"></span></div><!-- end of pinnedbox -->
which is a shortcut for: <pre class="compactcodebox"><code class="cmd">\expandafter</code><a id="wrglossary.469"></a><a href="#glo:capitalisefmtwords"><code class="csfmt">\capitalisefmtwords</code></a><code class="cmd">\expandafter</code>{<span class="meta">〈<em class="metainner">text</em>〉</span>}
</pre> (The star modifier will be applied with <code class="code"><a id="wrglossary.470"></a><a href="#glo:xcapitalisefmtwords"><code class="csfmt">\xcapitalisefmtwords</code></a>*</code> in an appropriate manner.)<p>
<div class="pinnedbox"><div class="pinnedboxtitle"><a id="wrglossary.471"></a><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
<a id="wrglossary.472"></a><code class="code"><dfn id="glo:ecapitalisefmtwords"><code class="csfmt">\ecapitalisefmtwords</code></dfn>{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code><span class="floatrightbox"><span class="summarytag">modifier: </span>* </span><span class="clearfix"></span></div><!-- end of pinnedbox -->
This will fully expand its argument before passing it to <a id="wrglossary.473"></a><a href="#glo:capitalisefmtwords"><code class="csfmt">\capitalisefmtwords</code></a>. Again, the star modifier may be used.<p>
<div class="important"><div class="importanttitle"><a id="wrglossary.474"></a><a href="#glo:sym.important"><span title="Important" class="icon">ℹ</span></a></div><!-- end of importanttitle -->
The unstarred <a id="wrglossary.475"></a><a href="#glo:capitalisefmtwords"><code class="csfmt">\capitalisefmtwords</code></a> is only designed for phrases that contain text-block commands with a single argument, which should be a word or sub-phrase. Anything more complicated is likely to break. Instead, use the starred form or <a id="wrglossary.476"></a><a href="#glo:capitalisewords"><code class="csfmt">\capitalisewords</code></a>. </div><!-- end of important -->
<p>
</section><!-- end of section sec:capitalisewords -->
<section id="sec:nocap"><!-- start of section sec:nocap --><div class="tomain"><a href="#main">[top]</a></div>
<h2><!-- start of section header -->2.1. Excluding Words From Case-Changing<div class="labellink"><a href="#sec:nocap">[link]</a></div></h2><!-- end of section header -->
<p>
<a id="wrglossary.477"></a>Some words typically shouldn’t have their case changed unless they occur at the start. These words can be identified with: <div class="pinnedbox"><div class="pinnedboxtitle"><a id="wrglossary.478"></a><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
<a id="wrglossary.479"></a><code class="code"><dfn id="glo:MFUnocap"><code class="csfmt">\MFUnocap</code></dfn>{<span class="meta">〈<em class="metainner">word</em>〉</span>}</code></div><!-- end of pinnedbox -->
This only has a local effect. The global version is: <div class="pinnedbox"><div class="pinnedboxtitle"><a id="wrglossary.480"></a><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
<a id="wrglossary.481"></a><code class="code"><dfn id="glo:gMFUnocap"><code class="csfmt">\gMFUnocap</code></dfn>{<span class="meta">〈<em class="metainner">word</em>〉</span>}</code></div><!-- end of pinnedbox -->
The list of words that shouldn’t be capitalised can be cleared using: <div class="pinnedbox"><div class="pinnedboxtitle"><a id="wrglossary.482"></a><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
<a id="wrglossary.483"></a><code class="code"><dfn id="glo:MFUclear"><code class="csfmt">\MFUclear</code></dfn></code></div><!-- end of pinnedbox -->
<p>
For example: <pre class="codebox"><div class="codeboxtitle"><a id="wrglossary.484"></a><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.485"></a><a href="#glo:capitalisewords"><code class="csfmt">\capitalisewords</code></a>{the wind in the willows}
<a id="wrglossary.486"></a><a href="#glo:MFUnocap"><code class="csfmt">\MFUnocap</code></a>{in}<span class="comment">% </span>
<a id="wrglossary.487"></a><a href="#glo:MFUnocap"><code class="csfmt">\MFUnocap</code></a>{the}<span class="comment">% </span>
<a id="wrglossary.488"></a><a href="#glo:capitalisewords"><code class="csfmt">\capitalisewords</code></a>{the wind in the willows}
</pre> <div class="resultbox"><div class="resultboxtitle"><a id="wrglossary.489"></a><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of resultboxtitle -->
The Wind In The Willows<p>
<p>
The Wind in the Willows </div><!-- end of resultbox -->
<p>
Since the case-change is ultimately performed by <a id="wrglossary.490"></a><a href="#glo:makefirstuc"><code class="csfmt">\makefirstuc</code></a>, you can also use an <a id="wrglossary.491"></a><a href="#glo:dual.exclusion">exclusion</a> to prevent an individual word from being changed. For example: <pre class="codebox"><div class="codeboxtitle"><a id="wrglossary.492"></a><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\newcommand</code>{<code class="cmd">\NoChange</code>}[1]{#1}
<a id="wrglossary.493"></a><a href="#glo:MFUexcl"><code class="csfmt">\MFUexcl</code></a>{<code class="cmd">\NoChange</code>}
<a id="wrglossary.494"></a><a href="#glo:MFUclear"><code class="csfmt">\MFUclear</code></a>
<a id="wrglossary.495"></a><a href="#glo:capitalisewords"><code class="csfmt">\capitalisewords</code></a>{the <code class="cmd">\NoChange</code>{wind} in the willows}
</pre> <div class="resultbox"><div class="resultboxtitle"><a id="wrglossary.496"></a><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of resultboxtitle -->
The wind In The Willows </div><!-- end of resultbox -->
This can also work if you redefine <a id="wrglossary.497"></a><a href="#glo:MFUcapwordfirstuc"><code class="csfmt">\MFUcapwordfirstuc</code></a> to use <a id="wrglossary.498"></a><a href="#glo:MFUsentencecase"><code class="csfmt">\MFUsentencecase</code></a> provided the exclusion command doesn’t expand (so <code class="cmd">\NoChange</code> would need to be protected or made robust in the above example). <p>
<div class="important"><div class="importanttitle"><a id="wrglossary.499"></a><a href="#glo:sym.important"><span title="Important" class="icon">ℹ</span></a></div><!-- end of importanttitle -->
Exceptions only apply to (non-leading) whole words or words separated with <a id="wrglossary.500"></a><a href="#glo:MFUwordbreak"><code class="csfmt">\MFUwordbreak</code></a> but not to parts of a hyphenated word that are split by <a id="wrglossary.501"></a><a href="#glo:MFUhyphencapword"><code class="csfmt">\MFUhyphencapword</code></a>. </div><!-- end of important -->
<p>
Examples:
<ol class="displaylist">
<li><span class="numitem">1.</span>Exceptions aren’t applied if <a id="wrglossary.502"></a><a href="#glo:MFUwordbreak"><code class="csfmt">\MFUwordbreak</code></a> occurs before the first space. <pre class="codebox"><div class="codeboxtitle"><a id="wrglossary.503"></a><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.504"></a><a href="#glo:MFUnocap"><code class="csfmt">\MFUnocap</code></a>{a}<a id="wrglossary.505"></a><a href="#glo:MFUnocap"><code class="csfmt">\MFUnocap</code></a>{the}<span class="comment">% </span>
<a id="wrglossary.506"></a><a href="#glo:capitalisewords"><code class="csfmt">\capitalisewords</code></a>{a<a id="wrglossary.507"></a><a href="#glo:MFUwordbreak"><code class="csfmt">\MFUwordbreak</code></a>{/}the something}
</pre> <div class="resultbox"><div class="resultboxtitle"><a id="wrglossary.508"></a><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of resultboxtitle -->
A/The Something </div><!-- end of resultbox -->
<p>
<li><span class="numitem">2.</span>Exceptions are applied for non-leading words: <pre class="codebox"><div class="codeboxtitle"><a id="wrglossary.509"></a><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.510"></a><a href="#glo:MFUnocap"><code class="csfmt">\MFUnocap</code></a>{and}<a id="wrglossary.511"></a><a href="#glo:MFUnocap"><code class="csfmt">\MFUnocap</code></a>{or}<span class="comment">% </span>
<a id="wrglossary.512"></a><a href="#glo:capitalisewords"><code class="csfmt">\capitalisewords</code></a>{one and<a id="wrglossary.513"></a><a href="#glo:MFUwordbreak"><code class="csfmt">\MFUwordbreak</code></a>{/}or another}
</pre> <div class="resultbox"><div class="resultboxtitle"><a id="wrglossary.514"></a><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of resultboxtitle -->
One and/or Another </div><!-- end of resultbox -->
<p>
<li><span class="numitem">3.</span>Exceptions aren’t applied for hyphenated parts: <pre class="codebox"><div class="codeboxtitle"><a id="wrglossary.515"></a><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.516"></a><a href="#glo:MFUhyphentrue"><code class="csfmt">\MFUhyphentrue</code></a>
<a id="wrglossary.517"></a><a href="#glo:MFUnocap"><code class="csfmt">\MFUnocap</code></a>{and}<a id="wrglossary.518"></a><a href="#glo:MFUnocap"><code class="csfmt">\MFUnocap</code></a>{or}<span class="comment">% </span>
<a id="wrglossary.519"></a><a href="#glo:capitalisewords"><code class="csfmt">\capitalisewords</code></a>{one and-or another}
</pre> <div class="resultbox"><div class="resultboxtitle"><a id="wrglossary.520"></a><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of resultboxtitle -->
One And-Or Another </div><!-- end of resultbox -->
</ol>
<p>
<div class="pinnedbox"><div class="pinnedboxtitle"><a id="wrglossary.521"></a><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
<a id="wrglossary.522"></a><code class="code"><code class="cmd">\usepackage</code>{<dfn id="glo:pkg.mfirstuc-english"><span class="styfmt">mfirstuc-english</span></dfn>}</code></div><!-- end of pinnedbox -->
The supplementary package <a id="wrglossary.523"></a><a href="#glo:pkg.mfirstuc-english"><span class="styfmt">mfirstuc-english</span></a> loads <a id="wrglossary.524"></a><a href="#glo:pkg.mfirstuc"><span class="styfmt">mfirstuc</span></a> and uses <a id="wrglossary.525"></a><a href="#glo:MFUnocap"><code class="csfmt">\MFUnocap</code></a> to add common English articles and conjunctions, such as <span class="qt">“a”</span>, <span class="qt">“an”</span>, <span class="qt">“and”</span>, <span class="qt">“but”</span>. You may want to add other words to this list, such as prepositions but, as there’s some dispute over whether prepositions should be capitalised, I don’t intend to add them to this package. Note that you need to explicitly load <a id="wrglossary.526"></a><a href="#glo:pkg.mfirstuc-english"><span class="styfmt">mfirstuc-english</span></a> if you require it. There’s no automatic language detection performed by <a id="wrglossary.527"></a><a href="#glo:pkg.mfirstuc"><span class="styfmt">mfirstuc</span></a>.<p>
If you want to write a similar package for another language, all you need to do is create a file with the extension <span class="filefmt">.sty</span> that starts with: <pre class="compactcodebox"><code class="cmd">\NeedsTeXFormat</code>{LaTeX2e}
</pre> The next line should identify the package. For example, if you have called the file <span class="filefmt">mfirstuc-french.sty</span> then you need: <pre class="compactcodebox"><code class="cmd">\ProvidesPackage</code>{mfirstuc-french}
</pre> It’s a good idea to also add a version in the final optional argument, for example: <pre class="compactcodebox"><code class="cmd">\ProvidesPackage</code>{mfirstuc-french}[2014/07/30 v1.0]
</pre> Next load <a id="wrglossary.528"></a><a href="#glo:pkg.mfirstuc"><span class="styfmt">mfirstuc</span></a>: <pre class="compactcodebox"><code class="cmd">\RequirePackage</code>{mfirstuc}
</pre> Now add all your <a id="wrglossary.529"></a><a href="#glo:MFUnocap"><code class="csfmt">\MFUnocap</code></a> commands. For example: <pre class="compactcodebox"><a id="wrglossary.530"></a><a href="#glo:MFUnocap"><code class="csfmt">\MFUnocap</code></a>{de}
</pre> At the end of the file add: <pre class="compactcodebox"><code class="cmd">\endinput</code>
</pre><p>
Put the file somewhere on TeX’s path, and now you can use this package in your document. You might also consider <a href="http://ctan.org/upload">uploading it to CTAN</a> in case other users find it useful.<p>
</section><!-- end of section sec:nocap -->
<section id="sec:pdfbookmarks"><!-- start of section sec:pdfbookmarks --><div class="tomain"><a href="#main">[top]</a></div>
<h2><!-- start of section header -->2.2. PDF Bookmarks<div class="labellink"><a href="#sec:pdfbookmarks">[link]</a></div></h2><!-- end of section header -->
<p>
If you are using <a id="wrglossary.531"></a><a href="#glo:pkg.hyperref"><span class="styfmt">hyperref</span></a> and want to use <a id="wrglossary.532"></a><a href="#glo:capitalisewords"><code class="csfmt">\capitalisewords</code></a> or <a id="wrglossary.533"></a><a href="#glo:capitalisefmtwords"><code class="csfmt">\capitalisefmtwords</code></a> (or the expanded variants) in a section heading, the PDF bookmarks won’t be able to use the command as it’s not expandable, so you will get a warning that looks like: <pre class="transcript"><div class="transcripttitle"><a id="wrglossary.534"></a><a href="#glo:sym.transcript"><span title="Transcript" class="icon">🔎</span></a></div>Package hyperref Warning: Token not allowed in a PDF string
(PDFDocEncoding):
(hyperref) removing `<a id="wrglossary.535"></a><a href="#glo:capitalisewords"><code class="csfmt">\capitalisewords</code></a>'
</pre><p>
If you want to provide an alternative for the PDF bookmark, you can use <a id="wrglossary.536"></a><a href="#glo:pkg.hyperref"><span class="styfmt">hyperref</span></a>’s <a id="wrglossary.537"></a><a href="#glo:texorpdfstring"><code class="csfmt">\texorpdfstring</code></a> command. For example: <pre class="codebox"><div class="codeboxtitle"><a id="wrglossary.538"></a><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\chapter</code>{<a id="wrglossary.539"></a><a href="#glo:texorpdfstring"><code class="csfmt">\texorpdfstring</code></a>
{<a id="wrglossary.540"></a><a href="#glo:capitalisewords"><code class="csfmt">\capitalisewords</code></a>{a book of rhyme}}<span class="comment">% TeX</span>
{A Book of Rhyme}<span class="comment">% PDF</span>
}
</pre> Alternatively, you can use <a id="wrglossary.541"></a><a href="#glo:pkg.hyperref"><span class="styfmt">hyperref</span></a>’s mechanism for disabling commands within the bookmarks. For example: <pre class="codebox"><div class="codeboxtitle"><a id="wrglossary.542"></a><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.543"></a><a href="#glo:pdfstringdefDisableCommands"><code class="csfmt">\pdfstringdefDisableCommands</code></a>{<span class="comment">% </span>
<code class="cmd">\let</code><a id="wrglossary.544"></a><a href="#glo:capitalisewords"><code class="csfmt">\capitalisewords</code></a><code class="cmd">\@firstofone</code>
}
</pre> The same applies to <a id="wrglossary.545"></a><a href="#glo:makefirstuc"><code class="csfmt">\makefirstuc</code></a>. You can, however, use the expandable <a id="wrglossary.546"></a><a href="#glo:MFUsentencecase"><code class="csfmt">\MFUsentencecase</code></a>. So you may prefer: <pre class="codebox"><div class="codeboxtitle"><a id="wrglossary.547"></a><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.548"></a><a href="#glo:pdfstringdefDisableCommands"><code class="csfmt">\pdfstringdefDisableCommands</code></a>{<span class="comment">% </span>
<code class="cmd">\let</code><a id="wrglossary.549"></a><a href="#glo:capitalisewords"><code class="csfmt">\capitalisewords</code></a><code class="cmd">\MFUsentencecase</code>
<code class="cmd">\let</code><a id="wrglossary.550"></a><a href="#glo:makefirstuc"><code class="csfmt">\makefirstuc</code></a><code class="cmd">\MFUsentencecase</code>
}
</pre><p>
See the <a id="wrglossary.551"></a><a href="#glo:pkg.hyperref"><span class="styfmt">hyperref</span></a> manual for further details.<p>
</section><!-- end of section sec:pdfbookmarks -->
<section id="sec:titlecaseexamples"><!-- start of section sec:titlecaseexamples --><div class="tomain"><a href="#main">[top]</a></div>
<h2><!-- start of section header -->2.3. Examples<div class="labellink"><a href="#sec:titlecaseexamples">[link]</a></div></h2><!-- end of section header -->
<p>
<ol class="displaylist">
<li><span class="numitem">1.</span>Text only: <div style="text-align: center; border-style: none; "><a id="wrglossary.552"></a><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a><a id="wrglossary.553"></a><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of frame@coderesult@title -->
<p>
<pre class="sidebysidecode">
<a id="wrglossary.554"></a><a href="#glo:capitalisewords"><code class="csfmt">\capitalisewords</code></a>{a little book of rhyme}
</pre><div class="sidebysideresult">A Little Book Of Rhyme </div><p>
<p>
<li><span class="numitem">2.</span>Excluding words (see §<a href="#sec:nocap">2.1</a>): <div style="text-align: center; border-style: none; "><a id="wrglossary.555"></a><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a><a id="wrglossary.556"></a><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of frame@coderesult@title -->
<p>
<pre class="sidebysidecode">
<a id="wrglossary.557"></a><a href="#glo:MFUnocap"><code class="csfmt">\MFUnocap</code></a>{of}
<a id="wrglossary.558"></a><a href="#glo:capitalisewords"><code class="csfmt">\capitalisewords</code></a>{a little book of rhyme}
</pre><div class="sidebysideresult"> A Little Book of Rhyme </div><p>
<p>
<li><span class="numitem">3.</span><a id="wrglossary.559"></a><a href="#glo:space"><code class="csfmt">\space</code></a> isn’t recognised as a word boundary: <pre class="codebox"><div class="codeboxtitle"><a id="wrglossary.560"></a><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.561"></a><a href="#glo:capitalisewords"><code class="csfmt">\capitalisewords</code></a>{a book of rhyme.}
<a id="wrglossary.562"></a><a href="#glo:capitalisewords"><code class="csfmt">\capitalisewords</code></a>{a book<a id="wrglossary.563"></a><a href="#glo:space"><code class="csfmt">\space</code></a> of rhyme.}
</pre> <div class="resultbox"><div class="resultboxtitle"><a id="wrglossary.564"></a><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of resultboxtitle -->
A Book Of Rhyme.<p>
A Book of Rhyme. </div><!-- end of resultbox -->
<p>
<li><span class="numitem">4.</span>Phrase entirely enclosed in a formatting command: <pre class="codebox"><div class="codeboxtitle"><a id="wrglossary.565"></a><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.566"></a><a href="#glo:capitalisefmtwords"><code class="csfmt">\capitalisefmtwords</code></a>{<code class="cmd">\emph</code>{a small book of rhyme}}
</pre> <div class="resultbox"><div class="resultboxtitle"><a id="wrglossary.567"></a><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of resultboxtitle -->
<span style="font-style: italic; font-variant: normal; ">A Small Book Of Rhyme</span> </div><!-- end of resultbox -->
<p>
<li><span class="numitem">5.</span>Sub-phrase enclosed in a formatting command: <pre class="codebox"><div class="codeboxtitle"><a id="wrglossary.568"></a><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.569"></a><a href="#glo:capitalisefmtwords"><code class="csfmt">\capitalisefmtwords</code></a>{a <code class="cmd">\emph</code>{small book} of rhyme}
</pre> <div class="resultbox"><div class="resultboxtitle"><a id="wrglossary.570"></a><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of resultboxtitle -->
A <span style="font-style: italic; font-variant: normal; ">Small Book</span> Of Rhyme </div><!-- end of resultbox -->
<p>
<li><span class="numitem">6.</span>Nested text-block commands: <pre class="codebox"><div class="codeboxtitle"><a id="wrglossary.571"></a><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.572"></a><a href="#glo:capitalisefmtwords"><code class="csfmt">\capitalisefmtwords</code></a>{<code class="cmd">\textbf</code>{a <code class="cmd">\emph</code>{small book}} of rhyme}
</pre> <div class="resultbox"><div class="resultboxtitle"><a id="wrglossary.573"></a><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of resultboxtitle -->
<span style="font-weight: bold; ">A <span style="font-style: italic; font-variant: normal; ">Small Book</span></span> Of Rhyme </div><!-- end of resultbox -->
<p>
<li><span class="numitem">7.</span>Formatting and case-change exception (see §<a href="#sec:nocap">2.1</a>): <pre class="codebox"><div class="codeboxtitle"><a id="wrglossary.574"></a><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.575"></a><a href="#glo:MFUnocap"><code class="csfmt">\MFUnocap</code></a>{of}
<a id="wrglossary.576"></a><a href="#glo:capitalisefmtwords"><code class="csfmt">\capitalisefmtwords</code></a>{<code class="cmd">\textbf</code>{a <code class="cmd">\emph</code>{small book}} of rhyme}
</pre> <div class="resultbox"><div class="resultboxtitle"><a id="wrglossary.577"></a><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of resultboxtitle -->
<span style="font-weight: bold; ">A <span style="font-style: italic; font-variant: normal; ">Small Book</span></span> of Rhyme </div><!-- end of resultbox -->
<p>
<li><span class="numitem">8.</span>Starred form: <pre class="codebox"><div class="codeboxtitle"><a id="wrglossary.578"></a><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.579"></a><a href="#glo:MFUnocap"><code class="csfmt">\MFUnocap</code></a>{of}
<a id="wrglossary.580"></a><a href="#glo:capitalisefmtwords"><code class="csfmt">\capitalisefmtwords</code></a>*{<code class="cmd">\emph</code>{a small book of rhyme}}
</pre> <div class="resultbox"><div class="resultboxtitle"><a id="wrglossary.581"></a><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of resultboxtitle -->
<span style="font-style: italic; font-variant: normal; ">A Small Book of Rhyme</span> </div><!-- end of resultbox -->
<p>
<li><span class="numitem">9.</span>The starred form also works with just text (no text-block command): <pre class="codebox"><div class="codeboxtitle"><a id="wrglossary.582"></a><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.583"></a><a href="#glo:MFUnocap"><code class="csfmt">\MFUnocap</code></a>{of}
<a id="wrglossary.584"></a><a href="#glo:capitalisefmtwords"><code class="csfmt">\capitalisefmtwords</code></a>*{a small book of rhyme}
</pre> <div class="resultbox"><div class="resultboxtitle"><a id="wrglossary.585"></a><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of resultboxtitle -->
A Small Book of Rhyme </div><!-- end of resultbox -->
<p>
<li><span class="numitem">10.</span>Expansion: <pre class="codebox"><div class="codeboxtitle"><a id="wrglossary.586"></a><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\newcommand</code>{<code class="cmd">\abc</code>}{<code class="cmd">\xyz</code><a id="wrglossary.587"></a><a href="#glo:space"><code class="csfmt">\space</code></a> four five}
<code class="cmd">\newcommand</code>{<code class="cmd">\xyz</code>}{one two three}
No expansion: <a id="wrglossary.588"></a><a href="#glo:capitalisewords"><code class="csfmt">\capitalisewords</code></a>{<code class="cmd">\abc</code>}.
First object one-level expansion: <a id="wrglossary.589"></a><a href="#glo:xcapitalisewords"><code class="csfmt">\xcapitalisewords</code></a>{<code class="cmd">\abc</code>}.
Fully expanded: <a id="wrglossary.590"></a><a href="#glo:ecapitalisewords"><code class="csfmt">\ecapitalisewords</code></a>{<code class="cmd">\abc</code>}.
</pre> <div class="resultbox"><div class="resultboxtitle"><a id="wrglossary.591"></a><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of resultboxtitle -->
No expansion: one two three four five.<p>
First object one-level expansion: one two three Four Five.<p>
Fully expanded: One Two Three Four Five. </div><!-- end of resultbox -->
<p>
Remember that the spaces need to be explicit. In the second case above, using <a id="wrglossary.592"></a><a href="#glo:xcapitalisewords"><code class="csfmt">\xcapitalisewords</code></a>, the space before <span class="qt">“four”</span> has been hidden within <a id="wrglossary.593"></a><a href="#glo:space"><code class="csfmt">\space</code></a> so it’s not recognised as a word boundary, but in the third case, <a id="wrglossary.594"></a><a href="#glo:space"><code class="csfmt">\space</code></a> has been expanded to an actual space character.<p>
</ol>
<p>
If there is a text-block command within the argument of the starred form, it’s assumed to be at the start of the argument. Unexpected results can occur if there are other commands. For example: <pre class="badcodebox"><div class="badcodeboxtitle"><a id="wrglossary.595"></a><a href="#glo:sym.badcode"><span title="Problematic Input" class="icon"><span class="overlapped">🖹</span><span class="overlapper"><span class="deprecatedorbannedfmt">🛇</span></span></span></a></div><a id="wrglossary.596"></a><a href="#glo:MFUnocap"><code class="csfmt">\MFUnocap</code></a>{of}
<a id="wrglossary.597"></a><a href="#glo:capitalisefmtwords"><code class="csfmt">\capitalisefmtwords</code></a>*{<code class="cmd">\emph</code>{a small} book <code class="cmd">\textbf</code>{of rhyme}}
</pre> <div class="resultbox"><div class="resultboxtitle"><a id="wrglossary.598"></a><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of resultboxtitle -->
<span style="font-style: italic; font-variant: normal; ">A Small</span> Book <span style="font-weight: bold; ">Of rhyme</span> </div><!-- end of resultbox -->
In this case <code class="code"><span class="cmdfmt">\textbf</span>{of rhyme}</code> is considered a single word. Similarly if the text-block command occurs in the middle of the argument: <pre class="badcodebox"><div class="badcodeboxtitle"><a id="wrglossary.599"></a><a href="#glo:sym.badcode"><span title="Problematic Input" class="icon"><span class="overlapped">🖹</span><span class="overlapper"><span class="deprecatedorbannedfmt">🛇</span></span></span></a></div><a id="wrglossary.600"></a><a href="#glo:MFUnocap"><code class="csfmt">\MFUnocap</code></a>{of}
<a id="wrglossary.601"></a><a href="#glo:capitalisefmtwords"><code class="csfmt">\capitalisefmtwords</code></a>*{a <code class="cmd">\emph</code>{very small} book of rhyme}
</pre> <div class="resultbox"><div class="resultboxtitle"><a id="wrglossary.602"></a><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of resultboxtitle -->
A <span style="font-style: italic; font-variant: normal; ">Very small</span> Book of Rhyme </div><!-- end of resultbox -->
In this case <code class="code"><span class="cmdfmt">\emph</span>{very small}</code> is considered a single word.<p>
Grouping causes interference. As with all the commands described here, avoid declarations. <pre class="badcodebox"><div class="badcodeboxtitle"><a id="wrglossary.603"></a><a href="#glo:sym.badcode"><span title="Problematic Input" class="icon"><span class="overlapped">🖹</span><span class="overlapper"><span class="deprecatedorbannedfmt">🛇</span></span></span></a></div><a id="wrglossary.604"></a><a href="#glo:capitalisefmtwords"><code class="csfmt">\capitalisefmtwords</code></a>{{<code class="cmd">\bfseries</code> a <code class="cmd">\emph</code>{small book}} of rhyme}
</pre><p>
<div class="information"><div class="informationtitle"><a id="wrglossary.605"></a><a href="#glo:sym.information"><span title="Information" class="icon">🛈</span></a></div><!-- end of informationtitle -->
As a general rule, it’s better to define <a id="wrglossary.606"></a><a href="#glo:dual.semanticcommand">semantic commands</a> rather than directly using font commands and declarations within the document. </div><!-- end of information -->
<p>
Avoid complicated commands in the unstarred version. For example, the following breaks: <pre class="badcodebox"><div class="badcodeboxtitle"><a id="wrglossary.607"></a><a href="#glo:sym.badcode"><span title="Problematic Input" class="icon"><span class="overlapped">🖹</span><span class="overlapper"><span class="deprecatedorbannedfmt">🛇</span></span></span></a></div><code class="cmd">\newcommand</code>*{<code class="cmd">\swap</code>}[2]{{#2}{#1}}
<a id="wrglossary.608"></a><a href="#glo:capitalisefmtwords"><code class="csfmt">\capitalisefmtwords</code></a>{a <code class="cmd">\swap</code>{bo}{ok} of rhyme}
</pre> However it can work with the starred form and the simpler <a id="wrglossary.609"></a><a href="#glo:capitalisewords"><code class="csfmt">\capitalisewords</code></a>: <pre class="codebox"><div class="codeboxtitle"><a id="wrglossary.610"></a><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\newcommand</code>*{<code class="cmd">\swap</code>}[2]{{#2}{#1}}
<a id="wrglossary.611"></a><a href="#glo:capitalisefmtwords"><code class="csfmt">\capitalisefmtwords</code></a>*{a <code class="cmd">\swap</code>{bo}{ok} of rhyme}
<a id="wrglossary.612"></a><a href="#glo:capitalisewords"><code class="csfmt">\capitalisewords</code></a>{a <code class="cmd">\swap</code>{bo}{ok} of rhyme}
</pre> <div class="resultbox"><div class="resultboxtitle"><a id="wrglossary.613"></a><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of resultboxtitle -->
A okBo Of Rhyme<p>
A okBo Of Rhyme </div><!-- end of resultbox -->
Note that the case change is applied to the first argument.<p>
</section><!-- end of section sec:titlecaseexamples -->
<section id="sec:misc"><!-- start of section sec:misc --><div class="tomain"><a href="#main">[top]</a></div>
<h1><!-- start of chapter header -->3. Miscellaneous<div class="labellink"><a href="#sec:misc">[link]</a></div></h1><!-- end of chapter header -->
<p>
</section><!-- end of section sec:misc -->
<section id="sec:savetoaux"><!-- start of section sec:savetoaux --><div class="tomain"><a href="#main">[top]</a></div>
<h2><!-- start of section header -->3.1. Saving exclusions, blockers and mappings in the <span class="extfmt">aux</span> File<div class="labellink"><a href="#sec:savetoaux">[link]</a></div></h2><!-- end of section header -->
<p>
If the <a id="wrglossary.614"></a><a href="#glo:dual.exclusion">exclusions</a>, <a id="wrglossary.615"></a><a href="#glo:dual.mapping">mappings</a> and <a id="wrglossary.616"></a><a href="#glo:dual.blocker">blockers</a> are required by some external tool, the information can be saved in the <a id="wrglossary.617"></a><a href="#glo:ext.aux"><span class="extfmt">aux</span></a> file.<p>
<div class="pinnedbox"><div class="pinnedboxtitle"><a id="wrglossary.618"></a><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
<a id="wrglossary.619"></a><code class="code"><dfn id="glo:MFUsaveatend"><code class="csfmt">\MFUsaveatend</code></dfn></code></div><!-- end of pinnedbox -->
This saves the information at the end of the document using a delayed write. This means that it can register all information identified throughout the document, but there’s a chance the document may end before the write takes place (for example, if the last page only contains floats). This command may be counteracted by: <div class="pinnedbox"><div class="pinnedboxtitle"><a id="wrglossary.620"></a><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
<a id="wrglossary.621"></a><code class="code"><dfn id="glo:MFUsave"><code class="csfmt">\MFUsave</code></dfn></code></div><!-- end of pinnedbox -->
This saves the information using a protected write at the point where this command occurs, which may be too soon if additional <a id="wrglossary.622"></a><a href="#glo:dual.exclusion">exclusions</a>, <a id="wrglossary.623"></a><a href="#glo:dual.mapping">mappings</a> or <a id="wrglossary.624"></a><a href="#glo:dual.blocker">blockers</a> are identified later. This command will counteract any instance of <a id="wrglossary.625"></a><a href="#glo:MFUsaveatend"><code class="csfmt">\MFUsaveatend</code></a>, regardless of whether or not <a id="wrglossary.626"></a><a href="#glo:MFUsaveatend"><code class="csfmt">\MFUsaveatend</code></a> comes before or after <a id="wrglossary.627"></a><a href="#glo:MFUsave"><code class="csfmt">\MFUsave</code></a>.<p>
The associated <a id="wrglossary.628"></a><a href="#glo:ext.aux"><span class="extfmt">aux</span></a> commands are listed below. In each case, a definition is provided in the <a id="wrglossary.629"></a><a href="#glo:ext.aux"><span class="extfmt">aux</span></a> file that does nothing. <div class="pinnedbox"><div class="pinnedboxtitle"><a id="wrglossary.630"></a><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
<a id="wrglossary.631"></a><code class="code"><dfn id="glo:@mfu@excls"><code class="csfmt">\@mfu@excls</code></dfn>{<span class="meta">〈<em class="metainner">exclusions</em>〉</span>}</code></div><!-- end of pinnedbox -->
Lists all <a id="wrglossary.632"></a><a href="#glo:dual.exclusion">exclusions</a>. For example: <pre class="compactcodebox"><a id="wrglossary.633"></a><a href="#glo:@mfu@excls"><code class="csfmt">\@mfu@excls</code></a>{<a id="wrglossary.634"></a><a href="#glo:begin"><code class="csfmt">\begin</code></a> <a id="wrglossary.635"></a><a href="#glo:cite"><code class="csfmt">\cite</code></a> <a id="wrglossary.636"></a><a href="#glo:end"><code class="csfmt">\end</code></a> <a id="wrglossary.637"></a><a href="#glo:label"><code class="csfmt">\label</code></a>
<a id="wrglossary.638"></a><a href="#glo:ref"><code class="csfmt">\ref</code></a> <a id="wrglossary.639"></a><a href="#glo:cite"><code class="csfmt">\cite</code></a> <a id="wrglossary.640"></a><a href="#glo:NoCaseChange"><code class="csfmt">\NoCaseChange</code></a> <a id="wrglossary.641"></a><a href="#glo:ensuremath"><code class="csfmt">\ensuremath</code></a>
<a id="wrglossary.642"></a><a href="#glo:MFUskippunc"><code class="csfmt">\MFUskippunc</code></a> <a id="wrglossary.643"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a> <a id="wrglossary.644"></a><a href="#glo:glspl"><code class="csfmt">\glspl</code></a>}
</pre><p>
<div class="pinnedbox"><div class="pinnedboxtitle"><a id="wrglossary.645"></a><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
<a id="wrglossary.646"></a><code class="code"><dfn id="glo:@mfu@blockers"><code class="csfmt">\@mfu@blockers</code></dfn>{<span class="meta">〈<em class="metainner">blockers</em>〉</span>}</code></div><!-- end of pinnedbox -->
Lists all <a id="wrglossary.647"></a><a href="#glo:dual.blocker">blockers</a>. For example: <pre class="compactcodebox"><a id="wrglossary.648"></a><a href="#glo:@mfu@blockers"><code class="csfmt">\@mfu@blockers</code></a>{<a id="wrglossary.649"></a><a href="#glo:Gls"><code class="csfmt">\Gls</code></a> <a id="wrglossary.650"></a><a href="#glo:Glspl"><code class="csfmt">\Glspl</code></a> }
</pre><p>
<div class="pinnedbox"><div class="pinnedboxtitle"><a id="wrglossary.651"></a><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
<a id="wrglossary.652"></a><code class="code"><dfn id="glo:@mfu@mappings"><code class="csfmt">\@mfu@mappings</code></dfn>{<span class="meta">〈<em class="metainner">mappings</em>〉</span>}</code></div><!-- end of pinnedbox -->
Lists all <a id="wrglossary.653"></a><a href="#glo:dual.mapping">mappings</a> as a <span class="meta">〈<em class="metainner">key</em>〉</span>=<span class="meta">〈<em class="metainner">value</em>〉</span> list. For example: <pre class="compactcodebox"><a id="wrglossary.654"></a><a href="#glo:@mfu@mappings"><code class="csfmt">\@mfu@mappings</code></a>{ {<a id="wrglossary.655"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a> }= {<a id="wrglossary.656"></a><a href="#glo:Gls"><code class="csfmt">\Gls</code></a> }, {<a id="wrglossary.657"></a><a href="#glo:glspl"><code class="csfmt">\glspl</code></a> }= {<a id="wrglossary.658"></a><a href="#glo:Glspl"><code class="csfmt">\Glspl</code></a> }}
</pre><p>
</section><!-- end of section sec:savetoaux -->
<section id="sec:allcaps"><!-- start of section sec:allcaps --><div class="tomain"><a href="#main">[top]</a></div>
<h2><!-- start of section header -->3.2. All-Caps<div class="labellink"><a href="#sec:allcaps">[link]</a></div></h2><!-- end of section header -->
<p>
<div class="pinnedbox"><div class="pinnedboxtitle"><a id="wrglossary.659"></a><a href="#glo:sym.definition"><span title="Definition" class="icon">📌</span></a></div><!-- end of pinnedboxtitle -->
<a id="wrglossary.660"></a><code class="code"><dfn id="glo:mfirstucMakeUppercase"><code class="csfmt">\mfirstucMakeUppercase</code></dfn>{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code></div><!-- end of pinnedbox -->
This command was originally used to perform the actual conversion to <a id="wrglossary.661"></a><a href="#glo:idx.uppercase">uppercase</a> and was defined to use command <a id="wrglossary.662"></a><a href="#glo:MakeUppercase"><code class="csfmt">\MakeUppercase</code></a>. The <a id="wrglossary.663"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package (before v4.50) formerly loaded the <a id="wrglossary.664"></a><a href="#glo:pkg.textcase"><span class="styfmt">textcase</span></a> package and redefined <a id="wrglossary.665"></a><a href="#glo:mfirstucMakeUppercase"><code class="csfmt">\mfirstucMakeUppercase</code></a> to use <a id="wrglossary.666"></a><a href="#glo:MakeTextUppercase"><code class="csfmt">\MakeTextUppercase</code></a>, which was better than <a id="wrglossary.667"></a><a href="#glo:MakeUppercase"><code class="csfmt">\MakeUppercase</code></a>.<p>
The <a id="wrglossary.668"></a><a href="#glo:pkg.textcase"><span class="styfmt">textcase</span></a> package has been deprecated as from 2022 and it now simply sets <a id="wrglossary.669"></a><a href="#glo:MakeTextUppercase"><code class="csfmt">\MakeTextUppercase</code></a> to <a id="wrglossary.670"></a><a href="#glo:MakeUppercase"><code class="csfmt">\MakeUppercase</code></a> because the new kernel now defines <a id="wrglossary.671"></a><a href="#glo:MakeUppercase"><code class="csfmt">\MakeUppercase</code></a> to use the newer LaTeX3 command <a id="wrglossary.672"></a><a href="#glo:textuppercase:n"><code class="csfmt">\text_uppercase:n</code></a>. Although that command is expandable, <a id="wrglossary.673"></a><a href="#glo:MakeUppercase"><code class="csfmt">\MakeUppercase</code></a> is robust.<p>
As from v2.08, <a id="wrglossary.674"></a><a href="#glo:pkg.mfirstuc"><span class="styfmt">mfirstuc</span></a> now defines <a id="wrglossary.675"></a><a href="#glo:mfirstucMakeUppercase"><code class="csfmt">\mfirstucMakeUppercase</code></a> so that it uses <a id="wrglossary.676"></a><a href="#glo:texttitlecasefirst:n"><code class="csfmt">\text_titlecase_first:n</code></a> directly, rather than indirectly through <a id="wrglossary.677"></a><a href="#glo:MakeUppercase"><code class="csfmt">\MakeUppercase</code></a>, which means that it’s now expandable. However, <a id="wrglossary.678"></a><a href="#glo:mfirstucMakeUppercase"><code class="csfmt">\mfirstucMakeUppercase</code></a> is no longer used by <a id="wrglossary.679"></a><a href="#glo:pkg.mfirstuc"><span class="styfmt">mfirstuc</span></a> except in <a id="wrglossary.680"></a><a href="#glo:mfugrabfirstuc"><code class="csfmt">\mfugrabfirstuc</code></a>, which is provided to emulate v2.07. Note that the <a id="wrglossary.681"></a><a href="#glo:opt.grabfirst"><span class="optfmt">grabfirst</span></a> option will also redefine <a id="wrglossary.682"></a><a href="#glo:mfirstucMakeUppercase"><code class="csfmt">\mfirstucMakeUppercase</code></a> to use <a id="wrglossary.683"></a><a href="#glo:MakeUppercase"><code class="csfmt">\MakeUppercase</code></a>.<p>
</section><!-- end of section sec:allcaps -->
<section id="sec:utf8"><!-- start of section sec:utf8 --><div class="tomain"><a href="#main">[top]</a></div>
<h2><!-- start of section header -->3.3. UTF-8<div class="labellink"><a href="#sec:utf8">[link]</a></div></h2><!-- end of section header -->
<p>
<div class="information"><div class="informationtitle"><a id="wrglossary.684"></a><a href="#glo:sym.information"><span title="Information" class="icon">🛈</span></a></div><!-- end of informationtitle -->
See <a href="https://www.dickimaw-books.com/blog/binary-files-text-files-and-file-encodings/">Binary Files, Text Files and File Encodings</a> if you are confused about how file encodings, such as <a id="wrglossary.685"></a><a href="#glo:utf8">UTF-8</a>, relate to text files. </div><!-- end of information -->
<p>
This section only applies to rollback or the use of <a id="wrglossary.686"></a><a href="#glo:mfugrabfirstuc"><code class="csfmt">\mfugrabfirstuc</code></a> (implemented via the <a id="wrglossary.687"></a><a href="#glo:opt.grabfirst"><span class="optfmt">grabfirst</span></a> option).<p>
Prior to version 2.08, the case-change applied by the <a id="wrglossary.688"></a><a href="#glo:glsmakefirstuc"><code class="csfmt">\glsmakefirstuc</code></a> command worked by utilizing the fact that, in most cases, TeX doesn’t require a regular argument to be enclosed in braces if it only consists of a single token. (This is why you can do, say, <code class="code"><span class="cmdfmt">\frac</span>12</code> instead of <code class="code"><span class="cmdfmt">\frac</span>{1}{2}</code> or <code class="code">x^2</code> instead of <code class="code">x^{2}</code>, although this practice is discouraged by some.)<p>
A simplistic version of the original <a id="wrglossary.689"></a><a href="#glo:glsmakefirstuc"><code class="csfmt">\glsmakefirstuc</code></a> command is: <pre class="codebox"><div class="codeboxtitle"><a id="wrglossary.690"></a><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\newcommand</code>*{<code class="cmd">\FirstUC</code>}[1]{<a id="wrglossary.691"></a><a href="#glo:MakeUppercase"><code class="csfmt">\MakeUppercase</code></a> #1}
</pre> Here <pre class="codebox"><div class="codeboxtitle"><a id="wrglossary.692"></a><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\FirstUC</code>{abc}
</pre> is equivalent to <pre class="codebox"><div class="codeboxtitle"><a id="wrglossary.693"></a><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.694"></a><a href="#glo:MakeUppercase"><code class="csfmt">\MakeUppercase</code></a> abc
</pre> and since <a id="wrglossary.695"></a><a href="#glo:MakeUppercase"><code class="csfmt">\MakeUppercase</code></a> requires an argument, it grabs the first token (the character <span class="qt">“a”</span> in this case) and uses that as the argument so that the result is <span class="qt">“Abc”</span>. This behaviour can be achieved with <a id="wrglossary.696"></a><a href="#glo:mfugrabfirstuc"><code class="csfmt">\mfugrabfirstuc</code></a>.<p>
Unfortunately, this will fail if the content starts with a <a id="wrglossary.697"></a><a href="#glo:utf8">UTF-8</a> character and you are using pdfLaTeX, where each octet of the <a id="wrglossary.698"></a><a href="#glo:utf8">UTF-8</a> character is a separate token. This isn’t a problem with XeLaTeX and LuaLaTeX which both treat the entire multibyte character as a single token.<p>
LaTeX3 now provides <a id="wrglossary.699"></a><a href="#glo:texttitlecasefirst:n"><code class="csfmt">\text_titlecase_first:n</code></a> to convert the first character to uppercase, so now the case-change can be applied with: <pre class="codebox"><div class="codeboxtitle"><a id="wrglossary.700"></a><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\ExplSyntaxOn</code>
<a id="wrglossary.701"></a><a href="#glo:texttitlecasefirst:n"><code class="csfmt">\text_titlecase_first:n</code></a>{élite}
<code class="cmd">\ExplSyntaxOff</code>
</pre> This is exactly what <a id="wrglossary.702"></a><a href="#glo:MFUsentencecase"><code class="csfmt">\MFUsentencecase</code></a> does without the need to switch on LaTeX3 syntax. The difference with the default definition of <a id="wrglossary.703"></a><a href="#glo:glsmakefirstuc"><code class="csfmt">\glsmakefirstuc</code></a> is that it prevents its argument from being expanded.<p>
</section><!-- end of section sec:utf8 -->
<section id="symbols"><!-- start of section symbols --><div class="tomain"><a href="#main">[top]</a></div>
<h1><!-- start of chapter header -->Symbols<div class="labellink"><a href="#symbols">[link]</a></div></h1><!-- end of chapter header -->
<dl class="inlineblock">
<dt><dfn id="glo:sym.definition">📌</dfn></dt>
<dd>The syntax and usage of a command, environment or option etc.</dd>
<dt><dfn id="glo:sym.important">ℹ</dfn></dt>
<dd>An important message.</dd>
<dt><dfn id="glo:sym.information">🛈</dfn></dt>
<dd>Prominent information.</dd>
<dt><dfn id="glo:sym.code">🖹</dfn></dt>
<dd>LaTeX code to insert into your document.</dd>
<dt><dfn id="glo:sym.badcode"><span class="overlapped">🖹</span><span class="overlapper"><span class="deprecatedorbannedfmt">🛇</span></span></dfn></dt>
<dd>Problematic code which should be avoided.</dd>
<dt><dfn id="glo:sym.result">🖺</dfn></dt>
<dd>How the example code should appear in the PDF.</dd>
<dt><dfn id="glo:sym.transcript">🔎</dfn></dt>
<dd>Text in a transcript or log file or written to STDOUT or STDERR.</dd>
<dt><dfn id="glo:sym.unicode"><span class="overlapped">🗋</span><span class="overlapper">U</span></dfn></dt>
<dd>Code that requires a native Unicode engine (XeLaTeX or LuaLaTeX).</dd>
<dt><dfn id="glo:sym.novaluesetting">𝍢</dfn></dt>
<dd>An option that doesn’t take a value.</dd>
<dt><dfn id="glo:sym.warning">⚠</dfn></dt>
<dd>A warning.</dd>
</dl>
</section><!-- end of section symbols -->
<section id="glossary"><!-- start of section glossary --><div class="tomain"><a href="#main">[top]</a></div>
<h1><!-- start of chapter header -->Glossary<div class="labellink"><a href="#glossary">[link]</a></div></h1><!-- end of chapter header -->
<dl>
<dt><a id="wrglossary.704"></a><dfn id="glo:dual.blocker">Blocker</dfn></dt>
<dd>A command that prohibits case-changing. If encountered by <a id="wrglossary.705"></a><a href="#glo:makefirstuc"><code class="csfmt">\makefirstuc</code></a>, it won’t attempt to apply any case-changing. See §<a href="#sec:blockers">1.4</a>.</dd>
<dt><a id="wrglossary.706"></a><dfn id="glo:dual.exclusion">Exclusion command</dfn></dt>
<dd>A command whose argument should be skipped by the case-changer. The content that follows the command should have its case-changed instead. See §<a href="#sec:exclusions">1.3</a>.</dd>
<dt><a id="wrglossary.707"></a><dfn id="glo:dual.exclusion-word">Exclusion word</dfn></dt>
<dd>A word that shouldn’t have its case changed by <a id="wrglossary.708"></a><a href="#glo:dual.title-case">title-case</a> commands, unless the word occurs at the start.</dd>
<dt><a id="wrglossary.709"></a><dfn id="glo:dual.mapping">Mapping</dfn></dt>
<dd>A command that should be substituted by another, if encountered by <a id="wrglossary.710"></a><a href="#glo:makefirstuc"><code class="csfmt">\makefirstuc</code></a>, instead of applying a case-change. See §<a href="#sec:mappings">1.5</a>.</dd>
<dt><a id="wrglossary.711"></a><dfn id="glo:dual.semanticcommand">Semantic command</dfn></dt>
<dd>Essentially, this is a command associated with a particular element, idea or topic that hides the font and other stylistic formatting inside its definition. For example, Latin taxonomy is usually displayed in italic. Explicitly using font commands, for example <pre class="compactcodebox"><code class="cmd">\textit</code>{Clostridium}</pre> is syntactic markup. Whereas defining a command called, say, <code class="cmd">\bacteria</code> that displays its argument in italics is a semantic command. The actual styling is hidden and the command relates specifically to a particular concept. <pre class="codebox"><div class="codeboxtitle"><a id="wrglossary.712"></a><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div>Syntactic: <code class="cmd">\textit</code>{Clostridium}
<code class="cmd">\newrobustcmd</code>*{<code class="cmd">\bacteria</code>}[1]<code class="cmd">\emph</code>{#1}%<br>Semantic: <code class="cmd">\bacteria</code>{Clostridium} </pre> The end result is the same: <div class="resultbox"><div class="resultboxtitle"><a id="wrglossary.713"></a><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of resultboxtitle -->
Syntactic: <span style="font-style: italic; font-variant: normal; ">Clostridium</span><p>
Semantic: <span style="font-style: italic; font-variant: normal; ">Clostridium</span> </div><!-- end of resultbox -->
The advantage with semantic commands is that it’s much easier to change the style, simply by adjusting the command definition. Note that I’ve used <code class="cmd">\newrobustcmd</code> to make the semantic command robust as the style commands can cause a problem if they expand too soon.</dd>
<dt><a id="wrglossary.714"></a><dfn id="glo:dual.sentence-case">Sentence-case</dfn></dt>
<dd>Content that should appear at the start of a sentence that needs to have its first significant character converted to <a id="wrglossary.715"></a><a href="#glo:idx.uppercase">uppercase</a>. See §<a href="#sec:sentencecase">1</a>.</dd>
<dt><a id="wrglossary.716"></a><dfn id="glo:dual.title-case">Title-case</dfn></dt>
<dd>Content that needs to appear in a title that should have each significant word converted to <a id="wrglossary.717"></a><a href="#glo:dual.sentence-case">sentence-case</a>. See §<a href="#sec:capitalisewords">2</a>.</dd>
<dt><a id="wrglossary.718"></a><dfn id="glo:dual.utf8">Unicode Transformation Format (8-bit) (UTF-8)</dfn></dt>
<dd>A variable-width encoding that uses 8-bit code units. This means that some characters are represented by more that one byte. XeLaTeX and LuaLaTeX treat the multi-byte sequence as a single token, but the older LaTeX formats have single-byte tokens, which can cause complications, although these have mostly been addressed with the newer kernels introduced over the past few years. Related blog article: <a href="https://www.dickimaw-books.com/blog/binary-files-text-files-and-file-encodings/">Binary Files, Text Files and File Encodings</a>.</dd>
</dl>
</section><!-- end of section glossary -->
<section id="cmdsummary"><!-- start of section cmdsummary --><div class="tomain"><a href="#main">[top]</a></div>
<h1><!-- start of chapter header -->Command Summary<div class="labellink"><a href="#cmdsummary">[link]</a></div></h1><!-- end of chapter header -->
</section><!-- end of section cmdsummary -->
<section id="summary.index@"><!-- start of section summary.index@ --><div class="tomain"><a href="#main">[top]</a></div>
<h2><!-- start of section header -->@<div class="labellink"><a href="#summary.index@">[link]</a></div></h2><!-- end of section header -->
<div class="defnbox"><a id="wrglossary.719"></a><a href="#glo:@mfu@blockers"><code class="csfmt">\@mfu@blockers</code></a><code class="code">{<span class="meta">〈<em class="metainner">blockers</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.720"></a><a href="#glo:pkg.mfirstuc"><span class="styfmt">mfirstuc</span></a> v2.08+</span><span class="clearfix"></span></div><!-- end of defnbox -->
<p>
An <a id="wrglossary.721"></a><a href="#glo:ext.aux"><span class="extfmt">aux</span></a> file command that lists all the identified <a id="wrglossary.722"></a><a href="#glo:dual.blocker">blockers</a>. <a href="#sec:savetoaux">§3.1</a>; <a href="#wrglossary.646">27</a><p>
<div class="defnbox"><a id="wrglossary.723"></a><a href="#glo:@mfu@excls"><code class="csfmt">\@mfu@excls</code></a><code class="code">{<span class="meta">〈<em class="metainner">exclusions</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.724"></a><a href="#glo:pkg.mfirstuc"><span class="styfmt">mfirstuc</span></a> v2.08+</span><span class="clearfix"></span></div><!-- end of defnbox -->
<p>
An <a id="wrglossary.725"></a><a href="#glo:ext.aux"><span class="extfmt">aux</span></a> file command that lists all the identified <a id="wrglossary.726"></a><a href="#glo:dual.exclusion">exclusions</a>. <a href="#sec:savetoaux">§3.1</a>; <a href="#wrglossary.631">26</a><p>
<div class="defnbox"><a id="wrglossary.727"></a><a href="#glo:@mfu@mappings"><code class="csfmt">\@mfu@mappings</code></a><code class="code">{<span class="meta">〈<em class="metainner">mappings</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.728"></a><a href="#glo:pkg.mfirstuc"><span class="styfmt">mfirstuc</span></a> v2.08+</span><span class="clearfix"></span></div><!-- end of defnbox -->
<p>
An <a id="wrglossary.729"></a><a href="#glo:ext.aux"><span class="extfmt">aux</span></a> file command that lists all the identified <a id="wrglossary.730"></a><a href="#glo:dual.mapping">mappings</a> as a <span class="meta">〈<em class="metainner">key</em>〉</span>=<span class="meta">〈<em class="metainner">value</em>〉</span> list. <a href="#sec:savetoaux">§3.1</a>; <a href="#wrglossary.652">27</a><p>
</section><!-- end of section summary.index@ -->
<section id="summary.index6684672"><!-- start of section summary.index6684672 --><div class="tomain"><a href="#main">[top]</a></div>
<h2><!-- start of section header -->C<div class="labellink"><a href="#summary.index6684672">[link]</a></div></h2><!-- end of section header -->
<div class="defnbox"><a id="wrglossary.731"></a><a href="#glo:capitalisefmtwords"><code class="csfmt">\capitalisefmtwords</code></a><code class="code">{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code><span class="floatrightbox"><span class="summarytag">modifier: </span>* <a id="wrglossary.732"></a><a href="#glo:pkg.mfirstuc"><span class="styfmt">mfirstuc</span></a> v2.03+</span><span class="clearfix"></span></div><!-- end of defnbox -->
<p>
Similar to <a id="wrglossary.733"></a><a href="#glo:capitalisewords"><code class="csfmt">\capitalisewords</code></a> but for content that may contain formatting commands. <a href="#sec:capitalisewords">§2</a>; <a href="#wrglossary.461">16</a><p>
<div class="defnbox"><a id="wrglossary.734"></a><a href="#glo:capitalisewords"><code class="csfmt">\capitalisewords</code></a><code class="code">{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.735"></a><a href="#glo:pkg.mfirstuc"><span class="styfmt">mfirstuc</span></a> v1.06+</span><span class="clearfix"></span></div><!-- end of defnbox -->
<p>
Applies <a id="wrglossary.736"></a><a href="#glo:dual.title-case">title-case</a> to <span class="meta">〈<em class="metainner">text</em>〉</span>. This will apply <a id="wrglossary.737"></a><a href="#glo:MFUcapword"><code class="csfmt">\MFUcapword</code></a> to each word in <span class="meta">〈<em class="metainner">text</em>〉</span> (unless the word has been identified as an <a id="wrglossary.738"></a><a href="#glo:dual.exclusion-word">exclusion word</a> and doesn’t occur at the start of <span class="meta">〈<em class="metainner">text</em>〉</span>). <a href="#sec:capitalisewords">§2</a>; <a href="#wrglossary.405">14</a><p>
</section><!-- end of section summary.index6684672 -->
<section id="summary.index6815744"><!-- start of section summary.index6815744 --><div class="tomain"><a href="#main">[top]</a></div>
<h2><!-- start of section header -->E<div class="labellink"><a href="#summary.index6815744">[link]</a></div></h2><!-- end of section header -->
<div class="defnbox"><a id="wrglossary.739"></a><a href="#glo:ecapitalisefmtwords"><code class="csfmt">\ecapitalisefmtwords</code></a><code class="code">{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code><span class="floatrightbox"><span class="summarytag">modifier: </span>* <a id="wrglossary.740"></a><a href="#glo:pkg.mfirstuc"><span class="styfmt">mfirstuc</span></a> v2.03+</span><span class="clearfix"></span></div><!-- end of defnbox -->
<p>
Fully expands <span class="meta">〈<em class="metainner">text</em>〉</span> and passes it to <a id="wrglossary.741"></a><a href="#glo:capitalisefmtwords"><code class="csfmt">\capitalisefmtwords</code></a> including the <code class="code">*</code> modifier, if provided. <a href="#sec:capitalisewords">§2</a>; <a href="#wrglossary.472">17</a><p>
<div class="defnbox"><a id="wrglossary.742"></a><a href="#glo:ecapitalisewords"><code class="csfmt">\ecapitalisewords</code></a><code class="code">{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.743"></a><a href="#glo:pkg.mfirstuc"><span class="styfmt">mfirstuc</span></a> v1.10+</span><span class="clearfix"></span></div><!-- end of defnbox -->
<p>
Fully expands <span class="meta">〈<em class="metainner">text</em>〉</span> before passing it to <a id="wrglossary.744"></a><a href="#glo:capitalisewords"><code class="csfmt">\capitalisewords</code></a>. <a href="#sec:capitalisewords">§2</a>; <a href="#wrglossary.420">14</a><p>
<div class="defnbox"><a id="wrglossary.745"></a><a href="#glo:emakefirstuc"><code class="csfmt">\emakefirstuc</code></a><code class="code">{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.746"></a><a href="#glo:pkg.mfirstuc"><span class="styfmt">mfirstuc</span></a> v1.10+</span><span class="clearfix"></span></div><!-- end of defnbox -->
<p>
Fully expands <span class="meta">〈<em class="metainner">text</em>〉</span> before passing it to <a id="wrglossary.747"></a><a href="#glo:makefirstuc"><code class="csfmt">\makefirstuc</code></a>. <a href="#sec:sentencecasecmds">§1.2</a>; <a href="#wrglossary.139">6</a><p>
</section><!-- end of section summary.index6815744 -->
<section id="summary.index6946816"><!-- start of section summary.index6946816 --><div class="tomain"><a href="#main">[top]</a></div>
<h2><!-- start of section header -->G<div class="labellink"><a href="#summary.index6946816">[link]</a></div></h2><!-- end of section header -->
<div class="defnbox"><a id="wrglossary.748"></a><a href="#glo:glsmakefirstuc"><code class="csfmt">\glsmakefirstuc</code></a><code class="code">{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.749"></a><a href="#glo:pkg.mfirstuc"><span class="styfmt">mfirstuc</span></a> v1.05+</span><span class="clearfix"></span></div><!-- end of defnbox -->
<p>
Used by <a id="wrglossary.750"></a><a href="#glo:makefirstuc"><code class="csfmt">\makefirstuc</code></a> to perform the case-change. This uses <code class="code"><a id="wrglossary.751"></a><a href="#glo:MFUsentencecase"><code class="csfmt">\MFUsentencecase</code></a>{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code> but by default will prevent its argument from being expanded. <a href="#sec:sentencecasecmds">§1.2</a>; <a href="#wrglossary.151">6</a><p>
<div class="defnbox"><a id="wrglossary.752"></a><a href="#glo:gMFUnocap"><code class="csfmt">\gMFUnocap</code></a><code class="code">{<span class="meta">〈<em class="metainner">word</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.753"></a><a href="#glo:pkg.mfirstuc"><span class="styfmt">mfirstuc</span></a> v1.09+</span><span class="clearfix"></span></div><!-- end of defnbox -->
<p>
Globally adds <span class="meta">〈<em class="metainner">word</em>〉</span> to the <a id="wrglossary.754"></a><a href="#glo:dual.exclusion-word">exclusion word</a> list for <a id="wrglossary.755"></a><a href="#glo:capitalisewords"><code class="csfmt">\capitalisewords</code></a>. <a href="#sec:nocap">§2.1</a>; <a href="#wrglossary.481">18</a><p>
</section><!-- end of section summary.index6946816 -->
<section id="summary.index7077888"><!-- start of section summary.index7077888 --><div class="tomain"><a href="#main">[top]</a></div>
<h2><!-- start of section header -->I<div class="labellink"><a href="#summary.index7077888">[link]</a></div></h2><!-- end of section header -->
<div class="defnbox"><a id="wrglossary.756"></a><a href="#glo:ifMFUhyphen"><code class="csfmt">\ifMFUhyphen</code></a><code class="code"> <span class="meta">〈<em class="metainner">true</em>〉</span><code class="csfmt">\else</code> <span class="meta">〈<em class="metainner">false</em>〉</span><code class="csfmt">\fi</code></code><span class="floatrightbox"><span class="summarytag">initial: </span><code class="cmd">\iffalse</code>; <a id="wrglossary.757"></a><a href="#glo:pkg.mfirstuc"><span class="styfmt">mfirstuc</span></a> v2.03+</span><span class="clearfix"></span></div><!-- end of defnbox -->
<p>
Conditional that determines whether or not hyphens should be considered word boundaries by the <a id="wrglossary.758"></a><a href="#glo:dual.title-case">title-case</a> commands. <a href="#sec:capitalisewords">§2</a>; <a href="#wrglossary.433">15</a><p>
</section><!-- end of section summary.index7077888 -->
<section id="summary.index7340032"><!-- start of section summary.index7340032 --><div class="tomain"><a href="#main">[top]</a></div>
<h2><!-- start of section header -->M<div class="labellink"><a href="#summary.index7340032">[link]</a></div></h2><!-- end of section header -->
<div class="defnbox"><a id="wrglossary.759"></a><a href="#glo:makefirstuc"><code class="csfmt">\makefirstuc</code></a><code class="code">{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.760"></a><a href="#glo:pkg.mfirstuc"><span class="styfmt">mfirstuc</span></a> v1.0+</span><span class="clearfix"></span></div><!-- end of defnbox -->
<p>
Converts <span class="meta">〈<em class="metainner">text</em>〉</span> to <a id="wrglossary.761"></a><a href="#glo:dual.sentence-case">sentence-case</a> internally using <a id="wrglossary.762"></a><a href="#glo:glsmakefirstuc"><code class="csfmt">\glsmakefirstuc</code></a> to perform the case-change, but first parses <span class="meta">〈<em class="metainner">text</em>〉</span> to deal with special cases. <a href="#sec:sentencecasecmds">§1.2</a>; <a href="#wrglossary.111">4</a><p>
<div class="defnbox"><a id="wrglossary.763"></a><a href="#glo:mfirstucMakeUppercase"><code class="csfmt">\mfirstucMakeUppercase</code></a><code class="code">{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.764"></a><a href="#glo:pkg.mfirstuc"><span class="styfmt">mfirstuc</span></a> v1.07+</span><span class="clearfix"></span></div><!-- end of defnbox -->
<p>
Converts <span class="meta">〈<em class="metainner">text</em>〉</span> to <a id="wrglossary.765"></a><a href="#glo:idx.uppercase">uppercase</a>. Now only used in <a id="wrglossary.766"></a><a href="#glo:mfugrabfirstuc"><code class="csfmt">\mfugrabfirstuc</code></a>. <a href="#sec:allcaps">§3.2</a>; <a href="#wrglossary.660">27</a><p>
<div class="defnbox"><a id="wrglossary.767"></a><a href="#glo:MFUaddmap"><code class="csfmt">\MFUaddmap</code></a><code class="code">{<span class="meta">〈<em class="metainner">cs1</em>〉</span>}{<span class="meta">〈<em class="metainner">cs2</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.768"></a><a href="#glo:pkg.mfirstuc"><span class="styfmt">mfirstuc</span></a> v2.08+</span><span class="clearfix"></span></div><!-- end of defnbox -->
<p>
Identifies a <a id="wrglossary.769"></a><a href="#glo:dual.mapping">mapping</a> from the command <span class="meta">〈<em class="metainner">cs1</em>〉</span> to command <span class="meta">〈<em class="metainner">cs2</em>〉</span>. <a href="#sec:mappings">§1.5</a>; <a href="#wrglossary.357">12</a><p>
<div class="defnbox"><a id="wrglossary.770"></a><a href="#glo:MFUblocker"><code class="csfmt">\MFUblocker</code></a><code class="code">{<span class="meta">〈<em class="metainner">cs</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.771"></a><a href="#glo:pkg.mfirstuc"><span class="styfmt">mfirstuc</span></a> v2.08+</span><span class="clearfix"></span></div><!-- end of defnbox -->
<p>
Locally identifies <span class="meta">〈<em class="metainner">cs</em>〉</span> as a <a id="wrglossary.772"></a><a href="#glo:dual.blocker">blocker</a> command. <a href="#sec:blockers">§1.4</a>; <a href="#wrglossary.284">11</a><p>
<div class="defnbox"><a id="wrglossary.773"></a><a href="#glo:MFUcapword"><code class="csfmt">\MFUcapword</code></a><code class="code">{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.774"></a><a href="#glo:pkg.mfirstuc"><span class="styfmt">mfirstuc</span></a> v2.03+</span><span class="clearfix"></span></div><!-- end of defnbox -->
<p>
Uses either <a id="wrglossary.775"></a><a href="#glo:MFUhyphencapword"><code class="csfmt">\MFUhyphencapword</code></a> or <a id="wrglossary.776"></a><a href="#glo:MFUcapwordfirstuc"><code class="csfmt">\MFUcapwordfirstuc</code></a> depending on <a id="wrglossary.777"></a><a href="#glo:ifMFUhyphen"><code class="csfmt">\ifMFUhyphen</code></a>. <a href="#sec:capitalisewords">§2</a>; <a href="#wrglossary.430">15</a><p>
<div class="defnbox"><a id="wrglossary.778"></a><a href="#glo:MFUcapwordfirstuc"><code class="csfmt">\MFUcapwordfirstuc</code></a><code class="code">{<span class="meta">〈<em class="metainner">word</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.779"></a><a href="#glo:pkg.mfirstuc"><span class="styfmt">mfirstuc</span></a> v2.07+</span><span class="clearfix"></span></div><!-- end of defnbox -->
<p>
Used by <a id="wrglossary.780"></a><a href="#glo:MFUcapword"><code class="csfmt">\MFUcapword</code></a> and <a id="wrglossary.781"></a><a href="#glo:MFUhyphencapword"><code class="csfmt">\MFUhyphencapword</code></a> to apply the case-change to the given word. This just does <code class="code"><a id="wrglossary.782"></a><a href="#glo:makefirstuc"><code class="csfmt">\makefirstuc</code></a>{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code> by default. <a href="#sec:capitalisewords">§2</a>; <a href="#wrglossary.449">16</a><p>
<div class="defnbox"><a id="wrglossary.783"></a><a href="#glo:MFUclear"><code class="csfmt">\MFUclear</code></a><span class="floatrightbox"><a id="wrglossary.784"></a><a href="#glo:pkg.mfirstuc"><span class="styfmt">mfirstuc</span></a> v1.09+</span><span class="clearfix"></span></div><!-- end of defnbox -->
<p>
Locally clears the <a id="wrglossary.785"></a><a href="#glo:dual.exclusion-word">exclusion word</a> list for <a id="wrglossary.786"></a><a href="#glo:capitalisewords"><code class="csfmt">\capitalisewords</code></a>. <a href="#sec:nocap">§2.1</a>; <a href="#wrglossary.483">18</a><p>
<div class="defnbox"><a id="wrglossary.787"></a><a href="#glo:MFUexcl"><code class="csfmt">\MFUexcl</code></a><code class="code">{<span class="meta">〈<em class="metainner">cs</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.788"></a><a href="#glo:pkg.mfirstuc"><span class="styfmt">mfirstuc</span></a> v2.08+</span><span class="clearfix"></span></div><!-- end of defnbox -->
<p>
Locally identifies <span class="meta">〈<em class="metainner">cs</em>〉</span> as an <a id="wrglossary.789"></a><a href="#glo:dual.exclusion">exclusion</a> command. <a href="#sec:exclusions">§1.3</a>; <a href="#wrglossary.194">8</a><p>
<div class="defnbox"><a id="wrglossary.790"></a><a href="#glo:mfugrabfirstuc"><code class="csfmt">\mfugrabfirstuc</code></a><code class="code">{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.791"></a><a href="#glo:pkg.mfirstuc"><span class="styfmt">mfirstuc</span></a> v2.08+</span><span class="clearfix"></span><p>
<div class="noteBox">(avoid where possible)</div><!-- end of noteBox -->
</div><!-- end of defnbox -->
<p>
Provide to emulate <a id="wrglossary.792"></a><a href="#glo:glsmakefirstuc"><code class="csfmt">\glsmakefirstuc</code></a> in v2.07 and below, but can still produce different results to v2.07. This will attempt to grab only the first character of <span class="meta">〈<em class="metainner">text</em>〉</span> and convert it to <a id="wrglossary.793"></a><a href="#glo:idx.uppercase">uppercase</a>, leaving the rest of <span class="meta">〈<em class="metainner">text</em>〉</span> unchanged. This won’t work if <span class="meta">〈<em class="metainner">text</em>〉</span> starts with a <a id="wrglossary.794"></a><a href="#glo:utf8">UTF-8</a> character, unless you are using XeLaTeX or LuaLaTeX. <a href="#sec:sentencecasecmds">§1.2</a>; <a href="#wrglossary.170">7</a><p>
<div class="defnbox"><a id="wrglossary.795"></a><a href="#glo:MFUhyphencapword"><code class="csfmt">\MFUhyphencapword</code></a><code class="code">{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.796"></a><a href="#glo:pkg.mfirstuc"><span class="styfmt">mfirstuc</span></a> v2.07+</span><span class="clearfix"></span></div><!-- end of defnbox -->
<p>
Used by <a id="wrglossary.797"></a><a href="#glo:MFUcapword"><code class="csfmt">\MFUcapword</code></a> to apply <a id="wrglossary.798"></a><a href="#glo:MFUcapwordfirstuc"><code class="csfmt">\MFUcapwordfirstuc</code></a> to each hyphen-separated word in <span class="meta">〈<em class="metainner">text</em>〉</span>, if hyphens should indicate a word-break. <a href="#sec:capitalisewords">§2</a>; <a href="#wrglossary.437">15</a><p>
<div class="defnbox"><a id="wrglossary.799"></a><a href="#glo:MFUhyphenfalse"><code class="csfmt">\MFUhyphenfalse</code></a><span class="floatrightbox"><a id="wrglossary.800"></a><a href="#glo:pkg.mfirstuc"><span class="styfmt">mfirstuc</span></a> v2.03+</span><span class="clearfix"></span></div><!-- end of defnbox -->
<p>
Sets <a id="wrglossary.801"></a><a href="#glo:ifMFUhyphen"><code class="csfmt">\ifMFUhyphen</code></a> to false. <a href="#sec:capitalisewords">§2</a>; <a href="#wrglossary.442">15</a><p>
<div class="defnbox"><a id="wrglossary.802"></a><a href="#glo:MFUhyphentrue"><code class="csfmt">\MFUhyphentrue</code></a><span class="floatrightbox"><a id="wrglossary.803"></a><a href="#glo:pkg.mfirstuc"><span class="styfmt">mfirstuc</span></a> v2.03+</span><span class="clearfix"></span></div><!-- end of defnbox -->
<p>
Sets <a id="wrglossary.804"></a><a href="#glo:ifMFUhyphen"><code class="csfmt">\ifMFUhyphen</code></a> to true. <a href="#sec:capitalisewords">§2</a>; <a href="#wrglossary.440">15</a><p>
<div class="defnbox"><a id="wrglossary.805"></a><a href="#glo:MFUnocap"><code class="csfmt">\MFUnocap</code></a><code class="code">{<span class="meta">〈<em class="metainner">word</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.806"></a><a href="#glo:pkg.mfirstuc"><span class="styfmt">mfirstuc</span></a> v1.09+</span><span class="clearfix"></span></div><!-- end of defnbox -->
<p>
Locally adds <span class="meta">〈<em class="metainner">word</em>〉</span> to the <a id="wrglossary.807"></a><a href="#glo:dual.exclusion-word">exclusion word</a> list for <a id="wrglossary.808"></a><a href="#glo:capitalisewords"><code class="csfmt">\capitalisewords</code></a>. <a href="#sec:nocap">§2.1</a>; <a href="#wrglossary.479">17</a><p>
<div class="defnbox"><a id="wrglossary.809"></a><a href="#glo:MFUsave"><code class="csfmt">\MFUsave</code></a><span class="floatrightbox"><a id="wrglossary.810"></a><a href="#glo:pkg.mfirstuc"><span class="styfmt">mfirstuc</span></a> v2.08+</span><span class="clearfix"></span></div><!-- end of defnbox -->
<p>
Saves the list of <a id="wrglossary.811"></a><a href="#glo:dual.exclusion">exclusions</a>, <a id="wrglossary.812"></a><a href="#glo:dual.blocker">blockers</a> and <a id="wrglossary.813"></a><a href="#glo:dual.mapping">mappings</a> to the <a id="wrglossary.814"></a><a href="#glo:ext.aux"><span class="extfmt">aux</span></a> file (if required by some external tool). This command sets itself to <code class="cmd">\relax</code> so it doesn’t repeat the action if used multiple times, and counteracts any use of <a id="wrglossary.815"></a><a href="#glo:MFUsaveatend"><code class="csfmt">\MFUsaveatend</code></a>. <a href="#sec:savetoaux">§3.1</a>; <a href="#wrglossary.621">26</a><p>
<div class="defnbox"><a id="wrglossary.816"></a><a href="#glo:MFUsaveatend"><code class="csfmt">\MFUsaveatend</code></a><span class="floatrightbox"><a id="wrglossary.817"></a><a href="#glo:pkg.mfirstuc"><span class="styfmt">mfirstuc</span></a> v2.08+</span><span class="clearfix"></span></div><!-- end of defnbox -->
<p>
Saves the list of <a id="wrglossary.818"></a><a href="#glo:dual.exclusion">exclusions</a>, <a id="wrglossary.819"></a><a href="#glo:dual.blocker">blockers</a> and <a id="wrglossary.820"></a><a href="#glo:dual.mapping">mappings</a> to the <a id="wrglossary.821"></a><a href="#glo:ext.aux"><span class="extfmt">aux</span></a> file (if required by some external tool) at the end of the document. This command sets itself to <code class="cmd">\relax</code> so it doesn’t repeat the action if used multiple times, but it can be overridden by <a id="wrglossary.822"></a><a href="#glo:MFUsave"><code class="csfmt">\MFUsave</code></a>. <a href="#sec:savetoaux">§3.1</a>; <a href="#wrglossary.619">26</a><p>
<div class="defnbox"><a id="wrglossary.823"></a><a href="#glo:MFUsentencecase"><code class="csfmt">\MFUsentencecase</code></a><code class="code">{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.824"></a><a href="#glo:pkg.mfirstuc"><span class="styfmt">mfirstuc</span></a> v2.08+</span><span class="clearfix"></span></div><!-- end of defnbox -->
<p>
Converts <span class="meta">〈<em class="metainner">text</em>〉</span> to <a id="wrglossary.825"></a><a href="#glo:dual.sentence-case">sentence-case</a> with expansion. <a href="#sec:sentencecasecmds">§1.2</a>; <a href="#wrglossary.101">4</a><p>
<div class="defnbox"><a id="wrglossary.826"></a><a href="#glo:MFUskippunc"><code class="csfmt">\MFUskippunc</code></a><code class="code">{<span class="meta">〈<em class="metainner">content</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.827"></a><a href="#glo:pkg.mfirstuc"><span class="styfmt">mfirstuc</span></a> v2.07+</span><span class="clearfix"></span></div><!-- end of defnbox -->
<p>
An <a id="wrglossary.828"></a><a href="#glo:dual.exclusion">exclusion</a> command. <a href="#sec:exclusions">§1.3</a>; <a href="#wrglossary.215">8</a><p>
<div class="defnbox"><a id="wrglossary.829"></a><a href="#glo:MFUwordbreak"><code class="csfmt">\MFUwordbreak</code></a><code class="code">{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.830"></a><a href="#glo:pkg.mfirstuc"><span class="styfmt">mfirstuc</span></a> v2.07+</span><span class="clearfix"></span></div><!-- end of defnbox -->
<p>
Used to markup a character or command that should be treated as a word break by the <a id="wrglossary.831"></a><a href="#glo:dual.title-case">title-case</a> commands. <a href="#sec:capitalisewords">§2</a>; <a href="#wrglossary.424">15</a><p>
</section><!-- end of section summary.index7340032 -->
<section id="summary.index8060928"><!-- start of section summary.index8060928 --><div class="tomain"><a href="#main">[top]</a></div>
<h2><!-- start of section header -->X<div class="labellink"><a href="#summary.index8060928">[link]</a></div></h2><!-- end of section header -->
<div class="defnbox"><a id="wrglossary.832"></a><a href="#glo:xcapitalisefmtwords"><code class="csfmt">\xcapitalisefmtwords</code></a><code class="code">{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code><span class="floatrightbox"><span class="summarytag">modifier: </span>* <a id="wrglossary.833"></a><a href="#glo:pkg.mfirstuc"><span class="styfmt">mfirstuc</span></a> v2.03+</span><span class="clearfix"></span></div><!-- end of defnbox -->
<p>
Shortcut for <code class="code"><span class="cmdfmt">\expandafter</span><a id="wrglossary.834"></a><a href="#glo:capitalisefmtwords"><code class="csfmt">\capitalisefmtwords</code></a><span class="cmdfmt">\expandafter</span>{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code> including the <code class="code">*</code> modifier, if provided. <a href="#sec:capitalisewords">§2</a>; <a href="#wrglossary.468">17</a><p>
<div class="defnbox"><a id="wrglossary.835"></a><a href="#glo:xcapitalisewords"><code class="csfmt">\xcapitalisewords</code></a><code class="code">{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.836"></a><a href="#glo:pkg.mfirstuc"><span class="styfmt">mfirstuc</span></a> v1.06+</span><span class="clearfix"></span></div><!-- end of defnbox -->
<p>
Shortcut for <code class="code"><span class="cmdfmt">\expandafter</span><a id="wrglossary.837"></a><a href="#glo:capitalisewords"><code class="csfmt">\capitalisewords</code></a><span class="cmdfmt">\expandafter</span>{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code>. <a href="#sec:capitalisewords">§2</a>; <a href="#wrglossary.417">14</a><p>
<div class="defnbox"><a id="wrglossary.838"></a><a href="#glo:xmakefirstuc"><code class="csfmt">\xmakefirstuc</code></a><code class="code">{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code><span class="floatrightbox"><a id="wrglossary.839"></a><a href="#glo:pkg.mfirstuc"><span class="styfmt">mfirstuc</span></a> v1.01+</span><span class="clearfix"></span></div><!-- end of defnbox -->
<p>
Shortcut for <code class="code"><span class="cmdfmt">\expandafter</span><a id="wrglossary.840"></a><a href="#glo:makefirstuc"><code class="csfmt">\makefirstuc</code></a><span class="cmdfmt">\expandafter</span>{<span class="meta">〈<em class="metainner">text</em>〉</span>}</code>. <a href="#sec:sentencecasecmds">§1.2</a>; <a href="#wrglossary.135">5</a><p>
</section><!-- end of section summary.index8060928 -->
<section id="index"><!-- start of section index --><div class="tomain"><a href="#main">[top]</a></div>
<h1><!-- start of chapter header -->Index<div class="labellink"><a href="#index">[link]</a></div></h1><!-- end of chapter header -->
<div class="nlctusernavbox"><a href="#indexglssymbols">Symbols</a> <a href="#index@">@</a> <a href="#index6619136">B</a> <a href="#index6684672">C</a> <a href="#index6815744">E</a> <a href="#index6881280">F</a> <a href="#index6946816">G</a> <a href="#index7012352">H</a> <a href="#index7077888">I</a> <a href="#index7274496">L</a> <a href="#index7340032">M</a> <a href="#index7405568">N</a> <a href="#index7536640">P</a> <a href="#index7667712">R</a> <a href="#index7733248">S</a> <a href="#index7798784">T</a> <a href="#index7864320">U</a> <a href="#index8060928">X</a></div><!-- end of nlctusernavbox -->
</section><!-- end of section index -->
<section id="indexglssymbols"><!-- start of section indexglssymbols --><div class="tomain"><a href="#main">[top]</a></div>
<h2><!-- start of section header -->Symbols<div class="labellink"><a href="#indexglssymbols">[link]</a></div></h2><!-- end of section header -->
<div class="nlctuserguideidx0"><dfn id="glo:idx.nbsp"><code class="code">~</code></dfn><span class="qquad"></span><a href="#wrglossary.407">14</a></div><!-- end of nlctuserguideidx0 -->
<div class="nlctuserguideidx0"><dfn id="glo:idx.sym.dollar"><code class="code">$</code></dfn><span class="qquad"></span><a href="#wrglossary.347">12</a></div><!-- end of nlctuserguideidx0 -->
</section><!-- end of section indexglssymbols -->
<section id="index@"><!-- start of section index@ --><div class="tomain"><a href="#main">[top]</a></div>
<h2><!-- start of section header -->@<div class="labellink"><a href="#index@">[link]</a></div></h2><!-- end of section header -->
<div class="nlctuserguideidx0"><a href="#glo:@mfu@blockers"><code class="csfmt">\@mfu@blockers</code></a><span class="qquad"></span><a href="#sec:savetoaux">§3.1</a>; <a href="#wrglossary.646">27</a>, <span class="summarylocfmt"><a href="#wrglossary.719">33</a></span>, <div class="crossref"><span class="crossreftag">see also</span> <a href="#glo:MFUsave"><code class="csfmt">\MFUsave</code></a> & <a href="#glo:MFUsaveatend"><code class="csfmt">\MFUsaveatend</code></a></div><!-- end of crossref -->
</div><!-- end of nlctuserguideidx0 -->
<div class="nlctuserguideidx0"><a href="#glo:@mfu@excls"><code class="csfmt">\@mfu@excls</code></a><span class="qquad"></span><a href="#sec:savetoaux">§3.1</a>; <a href="#wrglossary.631">26</a>, <span class="summarylocfmt"><a href="#wrglossary.723">33</a></span>, <div class="crossref"><span class="crossreftag">see also</span> <a href="#glo:MFUsave"><code class="csfmt">\MFUsave</code></a> & <a href="#glo:MFUsaveatend"><code class="csfmt">\MFUsaveatend</code></a></div><!-- end of crossref -->
</div><!-- end of nlctuserguideidx0 -->
<div class="nlctuserguideidx0"><a href="#glo:@mfu@mappings"><code class="csfmt">\@mfu@mappings</code></a><span class="qquad"></span><a href="#sec:savetoaux">§3.1</a>; <a href="#wrglossary.652">27</a>, <span class="summarylocfmt"><a href="#wrglossary.727">33</a></span>, <div class="crossref"><span class="crossreftag">see also</span> <a href="#glo:MFUsave"><code class="csfmt">\MFUsave</code></a> & <a href="#glo:MFUsaveatend"><code class="csfmt">\MFUsaveatend</code></a></div><!-- end of crossref -->
</div><!-- end of nlctuserguideidx0 -->
</section><!-- end of section index@ -->
<section id="index6619136"><!-- start of section index6619136 --><div class="tomain"><a href="#main">[top]</a></div>
<h2><!-- start of section header -->B<div class="labellink"><a href="#index6619136">[link]</a></div></h2><!-- end of section header -->
<div class="nlctuserguideidx0"><dfn id="glo:begin"><code class="csfmt">\begin</code></dfn><span class="qquad"></span><a href="#wrglossary.199">8</a>, <a href="#wrglossary.634">26</a></div><!-- end of nlctuserguideidx0 -->
<div class="nlctuserguideidx0"><dfn id="glo:blocker">blocker</dfn><span class="qquad"></span><a href="#tab:sentencecasesummary">Table 1.1</a>; <a href="#wrglossary.27">1</a>, <a href="#wrglossary.49">2</a>, <a href="#wrglossary.117">5</a>, <a href="#wrglossary.216">9</a>–<a href="#wrglossary.351">12</a>, <a href="#wrglossary.616">26</a>, <a href="#wrglossary.647">27</a>, <span class="termslocfmt"><a href="#wrglossary.704">31</a></span>, <a href="#wrglossary.722">33</a>, <a href="#wrglossary.772">35</a>, <a href="#wrglossary.812">37</a></div><!-- end of nlctuserguideidx0 -->
</section><!-- end of section index6619136 -->
<section id="index6684672"><!-- start of section index6684672 --><div class="tomain"><a href="#main">[top]</a></div>
<h2><!-- start of section header -->C<div class="labellink"><a href="#index6684672">[link]</a></div></h2><!-- end of section header -->
<div class="nlctuserguideidx0"><a href="#glo:capitalisefmtwords"><code class="csfmt">\capitalisefmtwords</code></a><span class="qquad"></span><a href="#sec:capitalisewords">§2</a>; <a href="#wrglossary.461">16</a>, <a href="#wrglossary.473">17</a>, <a href="#wrglossary.533">20</a>, <span class="summarylocfmt"><a href="#wrglossary.731">33</a></span>, <a href="#wrglossary.741">34</a>, <a href="#wrglossary.834">37</a>, <div class="crossref"><span class="crossreftag">see also</span> <a href="#glo:capitalisewords"><code class="csfmt">\capitalisewords</code></a>, <a href="#glo:MFUnocap"><code class="csfmt">\MFUnocap</code></a>, <a href="#glo:gMFUnocap"><code class="csfmt">\gMFUnocap</code></a> & <a href="#glo:ifMFUhyphen"><code class="csfmt">\ifMFUhyphen</code></a></div><!-- end of crossref -->
</div><!-- end of nlctuserguideidx0 -->
<div class="nlctuserguideidx0"><a href="#glo:capitalisewords"><code class="csfmt">\capitalisewords</code></a><span class="qquad"></span><a href="#sec:capitalisewords">§2</a>; <a href="#wrglossary.405">14</a>–<a href="#wrglossary.476">17</a>, <a href="#wrglossary.532">20</a>, <a href="#wrglossary.544">21</a>, <a href="#wrglossary.609">25</a>, <span class="summarylocfmt"><a href="#wrglossary.734">33</a></span>, <a href="#wrglossary.744">34</a>–<a href="#wrglossary.808">36</a>, <a href="#wrglossary.837">38</a>, <div class="crossref"><span class="crossreftag">see also</span> <a href="#glo:capitalisefmtwords"><code class="csfmt">\capitalisefmtwords</code></a>, <a href="#glo:MFUnocap"><code class="csfmt">\MFUnocap</code></a>, <a href="#glo:gMFUnocap"><code class="csfmt">\gMFUnocap</code></a> & <a href="#glo:ifMFUhyphen"><code class="csfmt">\ifMFUhyphen</code></a></div><!-- end of crossref -->
</div><!-- end of nlctuserguideidx0 -->
<div class="nlctuserguideidx0"><dfn id="glo:cite"><code class="csfmt">\cite</code></dfn><span class="qquad"></span><a href="#wrglossary.200">8</a>, <a href="#wrglossary.635">26</a></div><!-- end of nlctuserguideidx0 -->
<div class="nlctuserguideidx0"><dfn id="glo:pkg.csquotes"><span class="styfmt">csquotes</span> package</dfn><span class="qquad"></span><a href="#wrglossary.278">10</a></div><!-- end of nlctuserguideidx0 -->
</section><!-- end of section index6684672 -->
<section id="index6815744"><!-- start of section index6815744 --><div class="tomain"><a href="#main">[top]</a></div>
<h2><!-- start of section header -->E<div class="labellink"><a href="#index6815744">[link]</a></div></h2><!-- end of section header -->
<div class="nlctuserguideidx0"><a href="#glo:ecapitalisefmtwords"><code class="csfmt">\ecapitalisefmtwords</code></a><span class="qquad"></span><a href="#sec:capitalisewords">§2</a>; <a href="#wrglossary.472">17</a>, <span class="summarylocfmt"><a href="#wrglossary.739">34</a></span></div><!-- end of nlctuserguideidx0 -->
<div class="nlctuserguideidx0"><a href="#glo:ecapitalisewords"><code class="csfmt">\ecapitalisewords</code></a><span class="qquad"></span><a href="#sec:capitalisewords">§2</a>; <a href="#wrglossary.420">14</a>, <span class="summarylocfmt"><a href="#wrglossary.742">34</a></span></div><!-- end of nlctuserguideidx0 -->
<div class="nlctuserguideidx0"><a href="#glo:emakefirstuc"><code class="csfmt">\emakefirstuc</code></a><span class="qquad"></span><a href="#sec:sentencecasecmds">§1.2</a>; <a href="#wrglossary.139">6</a>, <a href="#wrglossary.312">11</a>, <a href="#wrglossary.385">13</a>, <span class="summarylocfmt"><a href="#wrglossary.745">34</a></span></div><!-- end of nlctuserguideidx0 -->
<div class="nlctuserguideidx0"><dfn id="glo:end"><code class="csfmt">\end</code></dfn><span class="qquad"></span><a href="#wrglossary.201">8</a>, <a href="#wrglossary.636">26</a></div><!-- end of nlctuserguideidx0 -->
<div class="nlctuserguideidx0"><dfn id="glo:ensuremath"><code class="csfmt">\ensuremath</code></dfn><span class="qquad"></span><a href="#wrglossary.209">8</a>, <a href="#wrglossary.345">12</a>, <a href="#wrglossary.641">26</a></div><!-- end of nlctuserguideidx0 -->
<div class="nlctuserguideidx0"><dfn id="glo:exclusion">exclusion command</dfn><span class="qquad"></span><a href="#tab:sentencecasesummary">Table 1.1</a>; <a href="#wrglossary.30">1</a>, <a href="#wrglossary.38">2</a>, <a href="#wrglossary.129">5</a>, <a href="#wrglossary.195">8</a>, <a href="#wrglossary.281">10</a>–<a href="#wrglossary.387">13</a>, <a href="#wrglossary.491">18</a>, <a href="#wrglossary.614">26</a>, <span class="termslocfmt"><a href="#wrglossary.706">31</a></span>, <a href="#wrglossary.726">33</a>, <a href="#wrglossary.789">36</a>, <a href="#wrglossary.811">37</a></div><!-- end of nlctuserguideidx0 -->
<div class="nlctuserguideidx0"><dfn id="glo:exclusion-word">exclusion word</dfn><span class="qquad"></span><a href="#wrglossary.477">17</a>, <span class="termslocfmt"><a href="#wrglossary.707">31</a></span>, <a href="#wrglossary.738">33</a>–<a href="#wrglossary.807">36</a></div><!-- end of nlctuserguideidx0 -->
<div class="nlctuserguideidx0"><a href="#glo:opt.expanded"><span class="optfmt">expanded</span></a><span class="qquad"></span><a href="#sec:pkgoptions">§1.6</a>; <a href="#wrglossary.73">2</a>, <a href="#wrglossary.161">6</a>, <a href="#wrglossary.389">13</a></div><!-- end of nlctuserguideidx0 -->
</section><!-- end of section index6815744 -->
<section id="index6881280"><!-- start of section index6881280 --><div class="tomain"><a href="#main">[top]</a></div>
<h2><!-- start of section header -->F<div class="labellink"><a href="#index6881280">[link]</a></div></h2><!-- end of section header -->
<div class="nlctuserguideidx0"><dfn id="glo:fileformat">file formats</dfn></div><!-- end of nlctuserguideidx0 -->
<div class="nlctuserguideidx1"><dfn id="glo:ext.aux"><span class="extfmt">aux</span></dfn><span class="qquad"></span><a href="#wrglossary.617">26</a></div><!-- end of nlctuserguideidx1 -->
</section><!-- end of section index6881280 -->
<section id="index6946816"><!-- start of section index6946816 --><div class="tomain"><a href="#main">[top]</a></div>
<h2><!-- start of section header -->G<div class="labellink"><a href="#index6946816">[link]</a></div></h2><!-- end of section header -->
<div class="nlctuserguideidx0"><dfn id="glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span> package</dfn><span class="qquad"></span><a href="#wrglossary.379">13</a></div><!-- end of nlctuserguideidx0 -->
<div class="nlctuserguideidx0"><dfn id="glo:pkg.glossaries"><span class="styfmt">glossaries</span> package</dfn><span class="qquad"></span><a href="#wrglossary.3">a</a>, <a href="#wrglossary.113">4</a>, <a href="#wrglossary.153">6</a>, <a href="#wrglossary.220">9</a>, <a href="#wrglossary.254">10</a>, <a href="#wrglossary.369">12</a>, <a href="#wrglossary.378">13</a>, <a href="#wrglossary.663">27</a></div><!-- end of nlctuserguideidx0 -->
<div class="nlctuserguideidx0"><dfn id="glo:Gls"><code class="csfmt">\Gls</code></dfn><span class="qquad"></span><a href="#wrglossary.5">a</a>, <a href="#wrglossary.373">13</a>, <a href="#wrglossary.649">27</a></div><!-- end of nlctuserguideidx0 -->
<div class="nlctuserguideidx0"><dfn id="glo:gls"><code class="csfmt">\gls</code></dfn><span class="qquad"></span><a href="#wrglossary.372">13</a>, <a href="#wrglossary.643">26</a>, <a href="#wrglossary.655">27</a></div><!-- end of nlctuserguideidx0 -->
<div class="nlctuserguideidx0"><dfn id="glo:glsadd"><code class="csfmt">\glsadd</code></dfn><span class="qquad"></span><a href="#wrglossary.219">9</a>, <a href="#wrglossary.255">10</a></div><!-- end of nlctuserguideidx0 -->
<div class="nlctuserguideidx0"><a href="#glo:glsmakefirstuc"><code class="csfmt">\glsmakefirstuc</code></a><span class="qquad"></span><a href="#sec:sentencecasecmds">§1.2</a>; <a href="#wrglossary.72">2</a>, <a href="#wrglossary.114">4</a>–<a href="#wrglossary.168">7</a>, <a href="#wrglossary.390">13</a>, <a href="#wrglossary.688">28</a>, <a href="#wrglossary.703">29</a>, <span class="summarylocfmt"><a href="#wrglossary.748">34</a></span>, <a href="#wrglossary.762">35</a>, <a href="#wrglossary.792">36</a></div><!-- end of nlctuserguideidx0 -->
<div class="nlctuserguideidx0"><dfn id="glo:Glspl"><code class="csfmt">\Glspl</code></dfn><span class="qquad"></span><a href="#wrglossary.650">27</a></div><!-- end of nlctuserguideidx0 -->
<div class="nlctuserguideidx0"><dfn id="glo:glspl"><code class="csfmt">\glspl</code></dfn><span class="qquad"></span><a href="#wrglossary.644">26</a>, <a href="#wrglossary.657">27</a></div><!-- end of nlctuserguideidx0 -->
<div class="nlctuserguideidx0"><a href="#glo:gMFUnocap"><code class="csfmt">\gMFUnocap</code></a><span class="qquad"></span><a href="#sec:nocap">§2.1</a>; <a href="#wrglossary.481">18</a>, <span class="summarylocfmt"><a href="#wrglossary.752">34</a></span>, <div class="crossref"><span class="crossreftag">see also</span> <a href="#glo:MFUnocap"><code class="csfmt">\MFUnocap</code></a> & <a href="#glo:MFUclear"><code class="csfmt">\MFUclear</code></a></div><!-- end of crossref -->
</div><!-- end of nlctuserguideidx0 -->
<div class="nlctuserguideidx0"><a href="#glo:opt.grabfirst"><span class="optfmt">grabfirst</span></a><span class="qquad"></span><a href="#sec:pkgoptions">§1.6</a>; <a href="#wrglossary.90">3</a>, <a href="#wrglossary.165">6</a>, <a href="#wrglossary.171">7</a>, <a href="#wrglossary.397">13</a>, <a href="#wrglossary.681">27</a>, <a href="#wrglossary.687">28</a></div><!-- end of nlctuserguideidx0 -->
</section><!-- end of section index6946816 -->
<section id="index7012352"><!-- start of section index7012352 --><div class="tomain"><a href="#main">[top]</a></div>
<h2><!-- start of section header -->H<div class="labellink"><a href="#index7012352">[link]</a></div></h2><!-- end of section header -->
<div class="nlctuserguideidx0"><dfn id="glo:pkg.hyperref"><span class="styfmt">hyperref</span> package</dfn><span class="qquad"></span><a href="#wrglossary.531">20</a>, <a href="#wrglossary.541">21</a></div><!-- end of nlctuserguideidx0 -->
</section><!-- end of section index7012352 -->
<section id="index7077888"><!-- start of section index7077888 --><div class="tomain"><a href="#main">[top]</a></div>
<h2><!-- start of section header -->I<div class="labellink"><a href="#index7077888">[link]</a></div></h2><!-- end of section header -->
<div class="nlctuserguideidx0"><a href="#glo:ifMFUhyphen"><code class="csfmt">\ifMFUhyphen</code></a><span class="qquad"></span><a href="#sec:capitalisewords">§2</a>; <a href="#wrglossary.433">15</a>, <span class="summarylocfmt"><a href="#wrglossary.756">34</a></span>, <a href="#wrglossary.777">35</a>, <a href="#wrglossary.801">36</a></div><!-- end of nlctuserguideidx0 -->
<div class="nlctuserguideidx0"><dfn id="glo:index"><code class="csfmt">\index</code></dfn><span class="qquad"></span><a href="#wrglossary.43">2</a></div><!-- end of nlctuserguideidx0 -->
</section><!-- end of section index7077888 -->
<section id="index7274496"><!-- start of section index7274496 --><div class="tomain"><a href="#main">[top]</a></div>
<h2><!-- start of section header -->L<div class="labellink"><a href="#index7274496">[link]</a></div></h2><!-- end of section header -->
<div class="nlctuserguideidx0"><dfn id="glo:label"><code class="csfmt">\label</code></dfn><span class="qquad"></span><a href="#wrglossary.202">8</a>, <a href="#wrglossary.637">26</a></div><!-- end of nlctuserguideidx0 -->
<div class="nlctuserguideidx0"><dfn id="glo:idx.lowercase">lowercase</dfn><span class="qquad"></span><a href="#wrglossary.415">14</a></div><!-- end of nlctuserguideidx0 -->
<div class="nlctuserguideidx0"><dfn id="glo:ltextcaseexcludeargtl"><code class="csfmt">\l_text_case_exclude_arg_tl</code></dfn><span class="qquad"></span><a href="#wrglossary.197">8</a></div><!-- end of nlctuserguideidx0 -->
</section><!-- end of section index7274496 -->
<section id="index7340032"><!-- start of section index7340032 --><div class="tomain"><a href="#main">[top]</a></div>
<h2><!-- start of section header -->M<div class="labellink"><a href="#index7340032">[link]</a></div></h2><!-- end of section header -->
<div class="nlctuserguideidx0"><a href="#glo:makefirstuc"><code class="csfmt">\makefirstuc</code></a><span class="qquad"></span><a href="#sec:sentencecasecmds">§1.2</a>; <a href="#tab:sentencecasesummary">Table 1.1</a>; <a href="#wrglossary.11">a</a>, <a href="#wrglossary.15">1</a>, <a href="#wrglossary.39">2</a>, <a href="#wrglossary.111">4</a>–<a href="#wrglossary.382">13</a>, <a href="#wrglossary.450">16</a>, <a href="#wrglossary.490">18</a>, <a href="#wrglossary.545">21</a>, <a href="#wrglossary.705">31</a>, <a href="#wrglossary.747">34</a>, <span class="summarylocfmt"><a href="#wrglossary.759">35</a></span>, <a href="#wrglossary.840">38</a></div><!-- end of nlctuserguideidx0 -->
<div class="nlctuserguideidx0"><dfn id="glo:MakeTextUppercase"><code class="csfmt">\MakeTextUppercase</code></dfn><span class="qquad"></span><a href="#wrglossary.666">27</a></div><!-- end of nlctuserguideidx0 -->
<div class="nlctuserguideidx0"><dfn id="glo:MakeUppercase"><code class="csfmt">\MakeUppercase</code></dfn><span class="qquad"></span><a href="#wrglossary.173">7</a>, <a href="#wrglossary.401">13</a>, <a href="#wrglossary.662">27</a>, <a href="#wrglossary.695">28</a></div><!-- end of nlctuserguideidx0 -->
<div class="nlctuserguideidx0"><dfn id="glo:mapping">mapping</dfn><span class="qquad"></span><a href="#tab:sentencecasesummary">Table 1.1</a>; <a href="#wrglossary.28">1</a>–<a href="#wrglossary.91">3</a>, <a href="#wrglossary.118">5</a>, <a href="#wrglossary.217">9</a>, <a href="#wrglossary.266">10</a>, <a href="#wrglossary.353">12</a>, <a href="#wrglossary.377">13</a>, <a href="#wrglossary.615">26</a>, <a href="#wrglossary.653">27</a>, <span class="termslocfmt"><a href="#wrglossary.709">31</a></span>, <a href="#wrglossary.730">33</a>, <a href="#wrglossary.769">35</a>, <a href="#wrglossary.813">37</a></div><!-- end of nlctuserguideidx0 -->
<div class="nlctuserguideidx0"><a href="#glo:pkg.mfirstuc-english"><span class="styfmt">mfirstuc-english</span> package</a><span class="qquad"></span><a href="#sec:nocap">§2.1</a>; <a href="#wrglossary.522">19</a></div><!-- end of nlctuserguideidx0 -->
<div class="nlctuserguideidx0"><dfn id="glo:pkg.mfirstuc"><span class="styfmt">mfirstuc</span> package</dfn><span class="qquad"></span><a href="#wrglossary.112">4</a></div><!-- end of nlctuserguideidx0 -->
<div class="nlctuserguideidx0"><a href="#glo:mfirstucMakeUppercase"><code class="csfmt">\mfirstucMakeUppercase</code></a><span class="qquad"></span><a href="#sec:allcaps">§3.2</a>; <a href="#wrglossary.172">7</a>, <a href="#wrglossary.192">8</a>, <a href="#wrglossary.400">13</a>, <a href="#wrglossary.660">27</a>, <span class="summarylocfmt"><a href="#wrglossary.763">35</a></span></div><!-- end of nlctuserguideidx0 -->
<div class="nlctuserguideidx0"><a href="#glo:MFUaddmap"><code class="csfmt">\MFUaddmap</code></a><span class="qquad"></span><a href="#sec:mappings">§1.5</a>; <a href="#wrglossary.357">12</a>, <span class="summarylocfmt"><a href="#wrglossary.767">35</a></span>, <div class="crossref"><span class="crossreftag">see also</span> <a href="#glo:MFUexcl"><code class="csfmt">\MFUexcl</code></a> & <a href="#glo:MFUblocker"><code class="csfmt">\MFUblocker</code></a></div><!-- end of crossref -->
</div><!-- end of nlctuserguideidx0 -->
<div class="nlctuserguideidx0"><a href="#glo:MFUblocker"><code class="csfmt">\MFUblocker</code></a><span class="qquad"></span><a href="#sec:blockers">§1.4</a>; <a href="#wrglossary.284">11</a>, <span class="summarylocfmt"><a href="#wrglossary.770">35</a></span>, <div class="crossref"><span class="crossreftag">see also</span> <a href="#glo:MFUexcl"><code class="csfmt">\MFUexcl</code></a> & <a href="#glo:MFUaddmap"><code class="csfmt">\MFUaddmap</code></a></div><!-- end of crossref -->
</div><!-- end of nlctuserguideidx0 -->
<div class="nlctuserguideidx0"><a href="#glo:MFUcapword"><code class="csfmt">\MFUcapword</code></a><span class="qquad"></span><a href="#sec:capitalisewords">§2</a>; <a href="#wrglossary.430">15</a>, <a href="#wrglossary.737">33</a>, <span class="summarylocfmt"><a href="#wrglossary.773">35</a></span>, <a href="#wrglossary.797">36</a></div><!-- end of nlctuserguideidx0 -->
<div class="nlctuserguideidx0"><a href="#glo:MFUcapwordfirstuc"><code class="csfmt">\MFUcapwordfirstuc</code></a><span class="qquad"></span><a href="#sec:capitalisewords">§2</a>; <a href="#wrglossary.449">16</a>, <a href="#wrglossary.497">18</a>, <span class="summarylocfmt"><a href="#wrglossary.778">35</a></span>, <a href="#wrglossary.798">36</a>, <div class="crossref"><span class="crossreftag">see also</span> <a href="#glo:MFUcapword"><code class="csfmt">\MFUcapword</code></a> & <a href="#glo:MFUhyphencapword"><code class="csfmt">\MFUhyphencapword</code></a></div><!-- end of crossref -->
</div><!-- end of nlctuserguideidx0 -->
<div class="nlctuserguideidx0"><a href="#glo:MFUclear"><code class="csfmt">\MFUclear</code></a><span class="qquad"></span><a href="#sec:nocap">§2.1</a>; <a href="#wrglossary.483">18</a>, <span class="summarylocfmt"><a href="#wrglossary.783">35</a></span>, <div class="crossref"><span class="crossreftag">see also</span> <a href="#glo:gMFUnocap"><code class="csfmt">\gMFUnocap</code></a> & <a href="#glo:MFUnocap"><code class="csfmt">\MFUnocap</code></a></div><!-- end of crossref -->
</div><!-- end of nlctuserguideidx0 -->
<div class="nlctuserguideidx0"><a href="#glo:MFUexcl"><code class="csfmt">\MFUexcl</code></a><span class="qquad"></span><a href="#sec:exclusions">§1.3</a>; <a href="#wrglossary.194">8</a>, <a href="#wrglossary.288">11</a>, <span class="summarylocfmt"><a href="#wrglossary.787">36</a></span>, <div class="crossref"><span class="crossreftag">see also</span> <a href="#glo:MFUblocker"><code class="csfmt">\MFUblocker</code></a> & <a href="#glo:MFUaddmap"><code class="csfmt">\MFUaddmap</code></a></div><!-- end of crossref -->
</div><!-- end of nlctuserguideidx0 -->
<div class="nlctuserguideidx0"><a href="#glo:mfugrabfirstuc"><code class="csfmt">\mfugrabfirstuc</code></a><span class="qquad"></span><a href="#sec:sentencecasecmds">§1.2</a>; <a href="#wrglossary.170">7</a>, <a href="#wrglossary.399">13</a>, <a href="#wrglossary.680">27</a>, <a href="#wrglossary.686">28</a>, <a href="#wrglossary.766">35</a>, <span class="summarylocfmt"><a href="#wrglossary.790">36</a></span></div><!-- end of nlctuserguideidx0 -->
<div class="nlctuserguideidx0"><a href="#glo:MFUhyphencapword"><code class="csfmt">\MFUhyphencapword</code></a><span class="qquad"></span><a href="#sec:capitalisewords">§2</a>; <a href="#wrglossary.437">15</a>, <a href="#wrglossary.501">18</a>, <a href="#wrglossary.775">35</a>, <span class="summarylocfmt"><a href="#wrglossary.795">36</a></span>, <div class="crossref"><span class="crossreftag">see also</span> <a href="#glo:ifMFUhyphen"><code class="csfmt">\ifMFUhyphen</code></a> & <a href="#glo:MFUcapword"><code class="csfmt">\MFUcapword</code></a></div><!-- end of crossref -->
</div><!-- end of nlctuserguideidx0 -->
<div class="nlctuserguideidx0"><a href="#glo:MFUhyphenfalse"><code class="csfmt">\MFUhyphenfalse</code></a><span class="qquad"></span><a href="#sec:capitalisewords">§2</a>; <a href="#wrglossary.442">15</a>, <span class="summarylocfmt"><a href="#wrglossary.799">36</a></span></div><!-- end of nlctuserguideidx0 -->
<div class="nlctuserguideidx0"><a href="#glo:MFUhyphentrue"><code class="csfmt">\MFUhyphentrue</code></a><span class="qquad"></span><a href="#sec:capitalisewords">§2</a>; <a href="#wrglossary.440">15</a>, <span class="summarylocfmt"><a href="#wrglossary.802">36</a></span></div><!-- end of nlctuserguideidx0 -->
<div class="nlctuserguideidx0"><a href="#glo:MFUnocap"><code class="csfmt">\MFUnocap</code></a><span class="qquad"></span><a href="#sec:nocap">§2.1</a>; <a href="#wrglossary.479">17</a>, <a href="#wrglossary.525">19</a>, <a href="#wrglossary.529">20</a>, <span class="summarylocfmt"><a href="#wrglossary.805">36</a></span>, <div class="crossref"><span class="crossreftag">see also</span> <a href="#glo:gMFUnocap"><code class="csfmt">\gMFUnocap</code></a> & <a href="#glo:MFUclear"><code class="csfmt">\MFUclear</code></a></div><!-- end of crossref -->
</div><!-- end of nlctuserguideidx0 -->
<div class="nlctuserguideidx0"><a href="#glo:MFUsave"><code class="csfmt">\MFUsave</code></a><span class="qquad"></span><a href="#sec:savetoaux">§3.1</a>; <a href="#wrglossary.621">26</a>, <span class="summarylocfmt"><a href="#wrglossary.809">36</a></span>, <a href="#wrglossary.822">37</a></div><!-- end of nlctuserguideidx0 -->
<div class="nlctuserguideidx0"><a href="#glo:MFUsaveatend"><code class="csfmt">\MFUsaveatend</code></a><span class="qquad"></span><a href="#sec:savetoaux">§3.1</a>; <a href="#wrglossary.619">26</a>, <span class="summarylocfmt"><a href="#wrglossary.816">37</a></span></div><!-- end of nlctuserguideidx0 -->
<div class="nlctuserguideidx0"><a href="#glo:MFUsentencecase"><code class="csfmt">\MFUsentencecase</code></a><span class="qquad"></span><a href="#sec:sentencecasecmds">§1.2</a>; <a href="#tab:sentencecasesummary">Table 1.1</a>; <a href="#wrglossary.14">1</a>, <a href="#wrglossary.40">2</a>, <a href="#wrglossary.101">4</a>, <a href="#wrglossary.146">6</a>, <a href="#wrglossary.198">8</a>–<a href="#wrglossary.386">13</a>, <a href="#wrglossary.451">16</a>, <a href="#wrglossary.498">18</a>, <a href="#wrglossary.546">21</a>, <a href="#wrglossary.702">28</a>, <a href="#wrglossary.751">34</a>, <span class="summarylocfmt"><a href="#wrglossary.823">37</a></span></div><!-- end of nlctuserguideidx0 -->
<div class="nlctuserguideidx0"><a href="#glo:MFUskippunc"><code class="csfmt">\MFUskippunc</code></a><span class="qquad"></span><a href="#sec:exclusions">§1.3</a>; <a href="#wrglossary.215">8</a>–<a href="#wrglossary.252">10</a>, <a href="#wrglossary.642">26</a>, <span class="summarylocfmt"><a href="#wrglossary.826">37</a></span></div><!-- end of nlctuserguideidx0 -->
<div class="nlctuserguideidx0"><a href="#glo:MFUwordbreak"><code class="csfmt">\MFUwordbreak</code></a><span class="qquad"></span><a href="#sec:capitalisewords">§2</a>; <a href="#wrglossary.424">15</a>, <a href="#wrglossary.453">16</a>, <a href="#wrglossary.500">18</a>, <a href="#wrglossary.502">19</a>, <span class="summarylocfmt"><a href="#wrglossary.829">37</a></span></div><!-- end of nlctuserguideidx0 -->
</section><!-- end of section index7340032 -->
<section id="index7405568"><!-- start of section index7405568 --><div class="tomain"><a href="#main">[top]</a></div>
<h2><!-- start of section header -->N<div class="labellink"><a href="#index7405568">[link]</a></div></h2><!-- end of section header -->
<div class="nlctuserguideidx0"><dfn id="glo:nameref"><code class="csfmt">\nameref</code></dfn><span class="qquad"></span><a href="#wrglossary.55">2</a>, <a href="#wrglossary.269">10</a>, <a href="#wrglossary.292">11</a></div><!-- end of nlctuserguideidx0 -->
<div class="nlctuserguideidx0"><dfn id="glo:NoCaseChange"><code class="csfmt">\NoCaseChange</code></dfn><span class="qquad"></span><a href="#wrglossary.206">8</a>, <a href="#wrglossary.244">9</a>, <a href="#wrglossary.315">11</a>, <a href="#wrglossary.349">12</a>, <a href="#wrglossary.640">26</a></div><!-- end of nlctuserguideidx0 -->
</section><!-- end of section index7405568 -->
<section id="index7536640"><!-- start of section index7536640 --><div class="tomain"><a href="#main">[top]</a></div>
<h2><!-- start of section header -->P<div class="labellink"><a href="#index7536640">[link]</a></div></h2><!-- end of section header -->
<div class="nlctuserguideidx0"><dfn id="glo:pdfstringdefDisableCommands"><code class="csfmt">\pdfstringdefDisableCommands</code></dfn><span class="qquad"></span><a href="#wrglossary.543">21</a></div><!-- end of nlctuserguideidx0 -->
<div class="nlctuserguideidx0"><dfn id="glo:protect"><code class="csfmt">\protect</code></dfn><span class="qquad"></span><a href="#wrglossary.124">5</a></div><!-- end of nlctuserguideidx0 -->
<div class="nlctuserguideidx0"><dfn id="glo:idx.punctuation">punctuation</dfn><span class="qquad"></span><a href="#wrglossary.21">1</a>, <a href="#wrglossary.218">9</a>, <a href="#wrglossary.256">10</a></div><!-- end of nlctuserguideidx0 -->
</section><!-- end of section index7536640 -->
<section id="index7667712"><!-- start of section index7667712 --><div class="tomain"><a href="#main">[top]</a></div>
<h2><!-- start of section header -->R<div class="labellink"><a href="#index7667712">[link]</a></div></h2><!-- end of section header -->
<div class="nlctuserguideidx0"><dfn id="glo:ref"><code class="csfmt">\ref</code></dfn><span class="qquad"></span><a href="#wrglossary.203">8</a>, <a href="#wrglossary.638">26</a></div><!-- end of nlctuserguideidx0 -->
</section><!-- end of section index7667712 -->
<section id="index7733248"><!-- start of section index7733248 --><div class="tomain"><a href="#main">[top]</a></div>
<h2><!-- start of section header -->S<div class="labellink"><a href="#index7733248">[link]</a></div></h2><!-- end of section header -->
<div class="nlctuserguideidx0"><dfn id="glo:semanticcommand">semantic command</dfn><span class="qquad"></span><a href="#wrglossary.31">1</a>, <a href="#wrglossary.103">4</a>, <a href="#wrglossary.116">5</a>, <a href="#wrglossary.606">24</a>, <span class="termslocfmt"><a href="#wrglossary.711">31</a></span></div><!-- end of nlctuserguideidx0 -->
<div class="nlctuserguideidx0"><dfn id="glo:sentence-case">sentence-case</dfn><span class="qquad"></span><a href="#wrglossary.6">a</a>, <a href="#wrglossary.13">1</a>, <a href="#wrglossary.160">6</a>, <a href="#wrglossary.362">12</a>, <a href="#wrglossary.406">14</a>, <span class="termslocfmt"><a href="#wrglossary.714">32</a></span>, <a href="#wrglossary.761">35</a>, <a href="#wrglossary.825">37</a></div><!-- end of nlctuserguideidx0 -->
<div class="nlctuserguideidx0"><dfn id="glo:space"><code class="csfmt">\space</code></dfn><span class="qquad"></span><a href="#wrglossary.408">14</a>, <a href="#wrglossary.559">21</a>, <a href="#wrglossary.587">23</a>, <a href="#wrglossary.593">24</a></div><!-- end of nlctuserguideidx0 -->
</section><!-- end of section index7733248 -->
<section id="index7798784"><!-- start of section index7798784 --><div class="tomain"><a href="#main">[top]</a></div>
<h2><!-- start of section header -->T<div class="labellink"><a href="#index7798784">[link]</a></div></h2><!-- end of section header -->
<div class="nlctuserguideidx0"><dfn id="glo:texorpdfstring"><code class="csfmt">\texorpdfstring</code></dfn><span class="qquad"></span><a href="#wrglossary.537">20</a></div><!-- end of nlctuserguideidx0 -->
<div class="nlctuserguideidx0"><dfn id="glo:pkg.textcase"><span class="styfmt">textcase</span> package</dfn><span class="qquad"></span><a href="#wrglossary.664">27</a></div><!-- end of nlctuserguideidx0 -->
<div class="nlctuserguideidx0"><dfn id="glo:texttitlecase:n"><code class="csfmt">\text_titlecase:n</code></dfn><span class="qquad"></span><a href="#wrglossary.413">14</a></div><!-- end of nlctuserguideidx0 -->
<div class="nlctuserguideidx0"><dfn id="glo:texttitlecasefirst:n"><code class="csfmt">\text_titlecase_first:n</code></dfn><span class="qquad"></span><a href="#wrglossary.102">4</a>, <a href="#wrglossary.676">27</a>, <a href="#wrglossary.699">28</a></div><!-- end of nlctuserguideidx0 -->
<div class="nlctuserguideidx0"><dfn id="glo:textuppercase:n"><code class="csfmt">\text_uppercase:n</code></dfn><span class="qquad"></span><a href="#wrglossary.672">27</a></div><!-- end of nlctuserguideidx0 -->
<div class="nlctuserguideidx0"><dfn id="glo:title-case">title-case</dfn><span class="qquad"></span><a href="#wrglossary.403">14</a>, <a href="#wrglossary.708">31</a>, <span class="termslocfmt"><a href="#wrglossary.716">32</a></span>, <a href="#wrglossary.736">33</a>, <a href="#wrglossary.758">34</a>, <a href="#wrglossary.831">37</a></div><!-- end of nlctuserguideidx0 -->
</section><!-- end of section index7798784 -->
<section id="index7864320"><!-- start of section index7864320 --><div class="tomain"><a href="#main">[top]</a></div>
<h2><!-- start of section header -->U<div class="labellink"><a href="#index7864320">[link]</a></div></h2><!-- end of section header -->
<div class="nlctuserguideidx0"><dfn id="glo:unexpanded"><code class="csfmt">\unexpanded</code></dfn><span class="qquad"></span><a href="#wrglossary.156">6</a></div><!-- end of nlctuserguideidx0 -->
<div class="nlctuserguideidx0"><a href="#glo:opt.unexpanded"><span class="optfmt">unexpanded</span></a><span class="qquad"></span><a href="#sec:pkgoptions">§1.6</a>; <a href="#wrglossary.74">2</a>, <a href="#wrglossary.82">3</a>, <a href="#wrglossary.154">6</a>, <a href="#wrglossary.393">13</a></div><!-- end of nlctuserguideidx0 -->
<div class="nlctuserguideidx0"><dfn id="glo:idx.uppercase">uppercase</dfn><span class="qquad"></span><a href="#wrglossary.414">14</a>, <a href="#wrglossary.661">27</a>, <a href="#wrglossary.715">32</a>, <a href="#wrglossary.765">35</a>, <a href="#wrglossary.793">36</a></div><!-- end of nlctuserguideidx0 -->
<div class="nlctuserguideidx0"><dfn id="glo:utf8">UTF-8</dfn><span class="qquad"></span><a href="#wrglossary.16">1</a>, <a href="#wrglossary.175">7</a>, <a href="#wrglossary.685">28</a>, <span class="termslocfmt"><a href="#wrglossary.718">32</a></span>, <a href="#wrglossary.794">36</a></div><!-- end of nlctuserguideidx0 -->
</section><!-- end of section index7864320 -->
<section id="index8060928"><!-- start of section index8060928 --><div class="tomain"><a href="#main">[top]</a></div>
<h2><!-- start of section header -->X<div class="labellink"><a href="#index8060928">[link]</a></div></h2><!-- end of section header -->
<div class="nlctuserguideidx0"><a href="#glo:xcapitalisefmtwords"><code class="csfmt">\xcapitalisefmtwords</code></a><span class="qquad"></span><a href="#sec:capitalisewords">§2</a>; <a href="#wrglossary.468">17</a>, <span class="summarylocfmt"><a href="#wrglossary.832">37</a></span></div><!-- end of nlctuserguideidx0 -->
<div class="nlctuserguideidx0"><a href="#glo:xcapitalisewords"><code class="csfmt">\xcapitalisewords</code></a><span class="qquad"></span><a href="#sec:capitalisewords">§2</a>; <a href="#wrglossary.417">14</a>, <a href="#wrglossary.592">24</a>, <span class="summarylocfmt"><a href="#wrglossary.835">37</a></span></div><!-- end of nlctuserguideidx0 -->
<div class="nlctuserguideidx0"><a href="#glo:xmakefirstuc"><code class="csfmt">\xmakefirstuc</code></a><span class="qquad"></span><a href="#sec:sentencecasecmds">§1.2</a>; <a href="#wrglossary.135">5</a>, <a href="#wrglossary.311">11</a>, <a href="#wrglossary.384">13</a>, <span class="summarylocfmt"><a href="#wrglossary.838">38</a></span></div><!-- end of nlctuserguideidx0 -->
<p>
</section><!-- end of section index8060928 -->
</div><!-- end of main -->
</body>
</html>
|
