summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/source/latex/koma-script/doc/english/scrbookreportarticle-experts.tex
blob: 5eba7be27531bf1746e449f47632f203c47812ba (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838
839
840
841
842
843
844
845
846
847
848
849
850
851
852
853
854
855
856
857
858
859
860
861
862
863
864
865
866
867
868
869
870
871
872
873
874
875
876
877
878
879
880
881
882
883
884
885
886
887
888
889
890
891
892
893
894
895
896
897
898
899
900
901
902
903
904
905
906
907
908
909
910
911
912
913
914
915
916
917
918
919
920
921
922
923
924
925
926
927
928
929
930
931
932
933
934
935
936
937
938
939
940
941
942
943
944
945
946
947
948
949
950
951
952
953
954
955
956
957
958
959
960
961
962
963
964
965
966
967
968
969
970
971
972
973
974
975
976
977
978
979
980
981
982
983
984
985
986
987
988
989
990
991
992
993
994
995
996
997
998
999
1000
1001
1002
1003
1004
1005
1006
1007
1008
1009
1010
1011
1012
1013
1014
1015
1016
1017
1018
1019
1020
1021
1022
1023
1024
1025
1026
1027
1028
1029
1030
1031
1032
1033
1034
1035
1036
1037
1038
1039
1040
1041
1042
1043
1044
1045
1046
1047
1048
1049
1050
1051
1052
1053
1054
1055
1056
1057
1058
1059
1060
1061
1062
1063
1064
1065
1066
1067
1068
1069
1070
1071
1072
1073
1074
1075
1076
1077
1078
1079
1080
1081
1082
1083
1084
1085
1086
1087
1088
1089
1090
1091
1092
1093
1094
1095
1096
1097
1098
1099
1100
1101
1102
1103
1104
1105
1106
1107
1108
1109
1110
1111
1112
1113
1114
1115
1116
1117
1118
1119
1120
1121
1122
1123
1124
1125
1126
1127
1128
1129
1130
1131
1132
1133
1134
1135
1136
1137
1138
1139
1140
1141
1142
1143
1144
1145
1146
1147
1148
1149
1150
1151
1152
1153
1154
1155
1156
1157
1158
1159
1160
1161
1162
1163
1164
1165
1166
1167
1168
1169
1170
1171
1172
1173
1174
1175
1176
1177
1178
1179
1180
1181
1182
1183
1184
1185
1186
1187
1188
1189
1190
1191
1192
1193
1194
1195
1196
1197
1198
1199
1200
1201
1202
1203
1204
1205
1206
1207
1208
1209
1210
1211
1212
1213
1214
1215
1216
1217
1218
1219
1220
1221
1222
1223
1224
1225
1226
1227
1228
1229
1230
1231
1232
1233
1234
1235
1236
1237
1238
1239
1240
1241
1242
1243
1244
1245
1246
1247
1248
1249
1250
1251
1252
1253
1254
1255
1256
1257
1258
1259
1260
1261
1262
1263
1264
1265
1266
1267
1268
1269
1270
1271
1272
1273
1274
1275
1276
1277
1278
1279
1280
1281
1282
1283
1284
1285
1286
1287
1288
1289
1290
1291
1292
1293
1294
1295
1296
1297
1298
1299
1300
1301
1302
1303
1304
1305
1306
1307
1308
1309
1310
1311
1312
1313
1314
1315
1316
1317
1318
1319
1320
1321
1322
1323
1324
1325
1326
1327
1328
1329
1330
1331
1332
1333
1334
1335
1336
1337
1338
1339
1340
1341
1342
1343
1344
1345
1346
1347
1348
1349
1350
1351
1352
1353
1354
1355
1356
1357
1358
1359
1360
1361
1362
1363
1364
1365
1366
1367
1368
1369
1370
1371
1372
1373
1374
1375
1376
1377
1378
1379
1380
1381
1382
1383
1384
1385
1386
1387
1388
1389
1390
1391
1392
1393
1394
1395
1396
1397
1398
1399
1400
1401
1402
1403
1404
1405
1406
1407
1408
1409
1410
1411
1412
1413
1414
1415
1416
1417
1418
1419
1420
1421
1422
1423
1424
1425
1426
1427
1428
1429
1430
1431
1432
1433
1434
1435
1436
1437
1438
1439
1440
1441
1442
1443
1444
1445
1446
1447
1448
1449
1450
1451
1452
1453
1454
1455
1456
1457
1458
1459
1460
1461
1462
1463
1464
1465
1466
1467
1468
1469
1470
1471
1472
1473
1474
1475
1476
1477
1478
1479
1480
1481
1482
1483
1484
1485
1486
1487
1488
1489
1490
1491
1492
1493
1494
1495
1496
1497
1498
1499
1500
1501
1502
1503
1504
1505
1506
1507
1508
1509
1510
1511
1512
1513
1514
1515
1516
1517
1518
1519
1520
1521
1522
1523
1524
1525
1526
1527
1528
1529
1530
1531
1532
1533
1534
1535
1536
1537
1538
1539
1540
1541
1542
1543
1544
1545
1546
1547
1548
1549
1550
1551
1552
1553
1554
1555
1556
1557
1558
1559
1560
1561
1562
1563
1564
1565
1566
1567
1568
1569
1570
1571
1572
1573
1574
1575
1576
1577
1578
1579
1580
1581
1582
1583
1584
1585
1586
1587
1588
1589
1590
1591
1592
1593
1594
1595
1596
1597
1598
1599
1600
1601
1602
1603
1604
1605
1606
1607
1608
1609
1610
1611
1612
1613
1614
1615
1616
1617
1618
1619
1620
1621
1622
1623
1624
1625
1626
1627
1628
1629
1630
1631
1632
% ======================================================================
% scrbookreportarticle-experts.tex
% Copyright (c) Markus Kohm, 2001-2017
%
% This file is part of the LaTeX2e KOMA-Script bundle.
%
% This work may be distributed and/or modified under the conditions of
% the LaTeX Project Public License, version 1.3c of the license.
% The latest version of this license is in
%   http://www.latex-project.org/lppl.txt
% and version 1.3c or later is part of all distributions of LaTeX 
% version 2005/12/01 or later and of this work.
%
% This work has the LPPL maintenance status "author-maintained".
%
% The Current Maintainer and author of this work is Markus Kohm.
%
% This work consists of all files listed in manifest.txt.
% ----------------------------------------------------------------------
% scrbookreportarticle-experts.tex
% Copyright (c) Markus Kohm, 2001-2017
%
% Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz,
% Version 1.3c, verteilt und/oder veraendert werden.
% Die neuste Version dieser Lizenz ist
%   http://www.latex-project.org/lppl.txt
% und Version 1.3c ist Teil aller Verteilungen von LaTeX
% Version 2005/12/01 oder spaeter und dieses Werks.
%
% Dieses Werk hat den LPPL-Verwaltungs-Status "author-maintained"
% (allein durch den Autor verwaltet).
%
% Der Aktuelle Verwalter und Autor dieses Werkes ist Markus Kohm.
% 
% Dieses Werk besteht aus den in manifest.txt aufgefuehrten Dateien.
% ======================================================================
%
% Chapter about scrbook, scrreprt, and scrartcl of the KOMA-Script guide
% expert part
% Maintained by Markus Kohm
%
% ----------------------------------------------------------------------
%
% Kapitel ueber scrbook, scrreprt und scrartcl im Experten-Teil der
% KOMA-Script-Anleitung
% Verwaltet von Markus Kohm
%
% ============================================================================

\KOMAProvidesFile{scrbookreportarticle-experts.tex}
                 [$Date: 2017-05-12 13:41:47 +0200 (Fri, 12 May 2017) $
                  KOMA-Script guide (chapter: scrbook, scrreprt, scrartcl for
                                     experts)]

\translator{Gernot Hassenpflug\and Markus Kohm}

% Date of the translated German file: 2017-05-08

\chapter[{Additional Information about the Main Classes and 
  \Package{scrextend}}]{Additional Information about the Main Classes 
  \Class{scrbook},
  \Class{scrreprt}, and \Class{scrartcl} as well as the Package
  \Package{scrextend}}
\labelbase{maincls-experts}
\BeginIndexGroup
\BeginIndex{Class}{scrartcl}%
\BeginIndex{Class}{scrbook}%
\BeginIndex{Class}{scrreprt}%
\BeginIndex{Package}{scrextend}%

This chapter gives additional information about the \KOMAScript{} classes
\Class{scrbook}, \Class{scrreprt}, and \Class{scrartcl}. Some of the features
are also available for package \Package{scrextend}. \iffree{Some parts of the
  chapter are subject to the \KOMAScript{} book \cite{book:komascript}
  only. This should not be a problem, because the}{The} average user, who only
want to use the package, will not need the information, that is addressed to
users with non-standard requirements or who want to write their own classes
using a \KOMAScript{} class. Another part of the information describes features
of the classes that exist only because of compatibility to former
releases of \KOMAScript{} or the standard classes. The features, that exist
only because of compatibility to former \KOMAScript{} releases, are printed
with a sans serif font. You should not use them any longer.

\LoadNonFree{scrbookreportarticle-experts}{0}

\section{Additional Information to User Commands}
\seclabel{addInfos}

\LoadNonFree{scrbookreportarticle-experts}{1}


\section{Cooperation and Coexistence of \KOMAScript{} and Other Packages}
\seclabel{coexistence}

\LoadNonFree{scrbookreportarticle-experts}{2}


\section{Expert Commands}
\seclabel{experts}

This sections described commands, that are more or less out of average user's
interest. Nevertheless these commands provide additional features for
experts. Because the information is addressed to experts it's condensed.

% \subsection{Identification}
% \seclabel{identification}

\begin{Declaration}
  \Macro{KOMAClassName}%
  \Macro{ClassName}
\end{Declaration}
\Macro{KOMAClassName} stores the name of the currently used \KOMAScript{}
class. If someone wants to know, whether or not or a \KOMAScript{} class is
used or which \KOMAScript{} is used this may be tested with this command. In
difference to this, \Macro{ClassName} tells which would be the standard class,
that has been replaced by a \KOMAScript{} class.

Please note\textnote{Attention!}, that the existence of
\DescRef{scrbase.cmd.KOMAScript}\IndexCmd{KOMAScript} is not a indication for
the usage of a \KOMAScript{} class. First of all: Every \KOMAScript{} package
and not only \KOMAScript{} classes define \Macro{KOMAScript}. Furthermore
other packages may also define the \KOMAScript{} word mark with this name.%
% 
\EndIndexGroup

% \subsection{Entries to the Table of Contents}
% \seclabel{toc}

\begin{Declaration}
  \Macro{addtocentrydefault}\Parameter{level}\Parameter{number}%
  \Parameter{heading}
\end{Declaration}
The\ChangedAt{v3.08}{\Class{scrbook}\and \Class{scrreprt}\and
  \Class{scrartcl}} \KOMAScript{} classes do not use
\Macro{addcontentsline}\IndexCmd{addcontentsline}%
\important{\Macro{addcontentsline}} directly. Instead they
call \Macro{addtocentrydefault} with similar arguments. The command may be used
for both, entries with and without number. Thereby \PName{level} is the
textual sectioning level, i.\,e.,  \PValue{part},
\PValue{chapter}, \PValue{section}, \PValue{subsection},
\PValue{subsubsection}, \PValue{paragraph}, or \PValue{subparagraph}. The
already formatted sectioning number is given by the second argument,
\PName{number}. This argument may be empty. The text of the entry is given by
argument \PName{heading}. It is recommended to protect fragile commands inside
this argument with prefix
\Macro{protect}\IndexCmd{protect}\important{\Macro{protect}}.

There's one speciality for argument \PName{number}. An empty argument
signalizes, that an entry without number should be generated. \KOMAScript{}
uses
\begin{quote}
  \Macro{addcontentsline}\PParameter{toc}\Parameter{level}%
  \Parameter{heading}
\end{quote}
for this. Nevertheless, if the argument is not empty an entry with number
will be made and \PName{number} is the already formatted heading
number. \KOMAScript{} uses
\begin{quote}\raggedright
  \Macro{addcontentsline}\PParameter{toc}\Parameter{level}%
  \PParameter{\%\\
    \quad\Macro{protect}\DescRef{tocbasic.cmd.numberline}\Parameter{number}%
    \PName{heading}\%\\
  }
\end{quote}
to make this.

Package authors an authors of wrapper classes may redefined this command to
manipulate the entries. For example\textnote{Example} one could suggest
\begin{lstcode}
  \renewcommand{\addtocentrydefault}[3]{%
    \ifstr{#3}{}{%
      \ifstr{#2}{}{%
        \addcontentsline{toc}{#1}{#3}%
      }{%
        \addcontentsline{toc}{#1}{\protect\numberline{#2}#3}%
      }%
    }%
  }%
\end{lstcode}
to omit entries with empty \PName{heading}. In real live this would not be
needed, because the \KOMAScript{} classes already use another method to
suppress empty entries. See the description of the structuring commands in
\autoref{sec:maincls.structure} from \DescPageRef{maincls.cmd.part}
onward for this.%
%
\EndIndexGroup


\begin{Declaration}
  \Macro{addparttocentry}\Parameter{number}\Parameter{heading}%
  \Macro{addchaptertocentry}\Parameter{number}\Parameter{heading}%
  \Macro{addsectiontocentry}\Parameter{number}\Parameter{heading}%
  \Macro{addsubsectiontocentry}\Parameter{number}\Parameter{heading}%
  \Macro{addsubsubsectiontocentry}\Parameter{number}\Parameter{heading}%
  \Macro{addparagraphtocentry}\Parameter{number}\Parameter{heading}%
  \Macro{addsubparagraphtocentry}\Parameter{number}\Parameter{heading}
\end{Declaration}%
The\ChangedAt{v3.08}{\Class{scrbook}\and \Class{scrreprt}\and
  \Class{scrartcl}} \KOMAScript{} classes call the previously described
command
\DescRef{\LabelBase.cmd.addtocentrydefault}\IndexCmd{addtocentrydefault}%
\important{\DescRef{\LabelBase.cmd.addtocentrydefault}} directly only if no
individual command for the \PName{level} has been defined or if that command
is \Macro{relax}\IndexCmd{relax}\important{\Macro{relax}}. Nevertheless, the
default definition of all these individual commands simply call
\DescRef{\LabelBase.cmd.addtocentrydefault} with their own \PName{level}
passing their arguments through.%
%
\EndIndexGroup


\begin{Declaration}
  \Macro{raggedchapterentry}
\end{Declaration}
Previous\ChangedAt{v3.21}{\Class{scrbook}\and \Class{scrreprt}} versions of
\KOMAScript{} provide a feature for printing chapter entries at the table of
contents left-aligned instead of justified by defining command
\Macro{raggedchapterentry} to be \Macro{raggedright}. Officially this feature
has been removed from \KOMAScript{} version 3.21 on.

Indeed attribute \PValue{raggedentrytext} of toc-entry style \PValue{tocline}
of package \Package{tocbasic}\IndexPackage{tocbasic} has been implemented to
use such a macro \Macro{ragged\PName{entry level}entry} as an indicator for
left-aligned text. If such a macro is \Macro{raggedright}, the text is printed
left-aligned. With any other definition the text is printed justified.

With this implementation of \PValue{raggedentrytext} full compatibility to the
previous documentation of \Macro{raggedchapterentry} is reached. As
stated formerly, other definitions of \Macro{raggedchapterentry}\,---\,and now
also of \Macro{raggedsectionentry} and similar macros for other entry
levels\,---\,could result in the potentially unexpected effect of justified
text.

Nevertheless, it is recommended to use the attribute of style \PValue{tocline}
to select justified or left-aligned text.%
\EndIndexGroup

% \subsection{Font Settings}
% \seclabel{fonts}


\begin{Declaration}
  \Macro{@fontsizefilebase}%
  \Macro{changefontsizes}\Parameter{font size}
\end{Declaration}
The prefix \File{scrsize} for file names of font size files, that has been
mentioned\iffree{ in \autoref{sec:maincls-experts.addInfos}}{} at
\DescPageRef{maincls-experts.option.fontsize} is only the default of the
internal macro \Macro{@fontsizefilebase}\IndexCmd{@fontsizefilebase}. This
default is used only, if the macro has not already be defined when loading a
\KOMAScript{} class or package \Package{scrextend}. Authors of wrapper classes
may define this macro with another file name prefix to use completely
different font size files. Also\textnote{Hint!} authors of wrapper classes
could change or deactivate the \emph{fallback} solution for unknown font sizes
by redefinition of macro
\Macro{changefontsizes}\important{\Macro{changefontsizes}}. This macro has
exactly one argument: the wanted \PName{font size}.%
%
\EndIndexGroup


\begin{Declaration}
  \Macro{newkomafont}\OParameter{warning message}\Parameter{element}%
                     \Parameter{default}%
  \Macro{aliaskomafont}\Parameter{alias name}\Parameter{element}
\end{Declaration}
Experts may use \Macro{newkomafont} to define a \PName{default} for the font
style of an \PName{element}. After this that default may be changed using
commands \DescRef{maincls.cmd.setkomafont} and
\DescRef{maincls.cmd.addtokomafont} (see \autoref{sec:maincls.textmarkup},
\DescPageRef{maincls.cmd.setkomafont}). Of course this is not enough to use
the defined font style. The expert himself has to prepare his code to use
command \DescRef{maincls.cmd.usekomafont}%
\important{\DescRef{maincls.cmd.usekomafont}}\IndexCmd{usekomafont} (see
\DescPageRef{maincls.cmd.usekomafont}) with that \PName{element} at his code
definitions.

The optional argument \PName{warning message} defines a warning message,
that \KOMAScript{} will show whenever the default font style of that
\PName{element} will be changed. The sender of the warning in such cases will
be the used \KOMAScript{} class or package \Package{scrextend}.

Command \Macro{aliaskomafont} defines an \PName{alias name} to an already
defined \PName{element}. \KOMAScript{} will inform the user automatically
about the real name of the element, whenever an \PName{alias name} will be
used. An\textnote{Hint!} \PName{alias name} may be used, e.\,g., if a
developer finds a better name for an element, that has been defined formerly
with another name, if the old name should still be usable because of
compatibility. Also an \PName{alias name}s may increase usability, because
different users may find different names more or less intuitive. \KOMAScript{}
itself defines a lot of \PName{alias name}s for several \PName{element}s.
%
\EndIndexGroup


\begin{Declaration}
  \Macro{addtokomafontrelaxlist}\Parameter{macro}
  \Macro{addtokomafontonearglist}\Parameter{macro}
  \Macro{addtokomafontgobblelist}\Parameter{macro}
\end{Declaration}
As already mentioned in \autoref{part:forAuthors} of this manual, font
settings of elements should consist only in commands to select the size,
family, coding, series, shape, or colour. At least changing the colour is not
always transparent in \LaTeX{} and therefore could result in unwanted effects
if someone uses \DescRef{maincls.cmd.usekomafont} at an inappropriate state.

Users tend to use different, somehow critical things in the font setting of an
element, e.\,g., \Macro{MakeUppercase} at the very end of the setting. As long
as possible, the internal usage of font settings has been implemented so that
such forbidden settings do not matter. Even using a command that expects an
argument, e.\,g., \Macro{textbf} instead of \Macro{bfseries},  would work
mostly, if it the last one in the font setting of an element\,---\,but without
warranty.

Inside \KOMAScript, sometimes, it was necessary to restrict the font change to
real font settings. This has been done, e.\,g., using
\DescRef{maincls.cmd.usefontofkomafont}%
\IndexCmd{usefontofkomafont}%
\IndexCmd{usesizeofkomafont}\IndexCmd{useencodingofkomafont}%
\IndexCmd{usefamilyofkomafont}\IndexCmd{useseriesofkomafont}%
\IndexCmd{useshapeofkomafont} instead of \DescRef{maincls.cmd.usekomafont}
(see \autoref{sec:maincls.textmarkup},
\DescPageRef{maincls.cmd.usefontofkomafont}).

Nevertheless, command \DescRef{maincls.cmd.usefontofkomafont} and it's
siblings have some limitations. Therefore you must not use a command that
always needs a fully expandable argument inside the font setting of an
element. But this is exactly what \Macro{MakeUppercase}
needs. Therefore\ChangedAt{v3.17}{\Class{scrbook}\and \Class{scrreprt}\and
  \Class{scrartcl}} \KOMAScript{} holds a list of macros, which should become
\Macro{relax} inside \DescRef{maincls.cmd.usefontofkomafont} and it's
siblings. Since \KOMAScript~3.24\ChangedAt{v3.24}{\Class{scrbook}\and
  \Class{scrreprt}\and \Class{scrartcl}} only \Macro{normalcolor} is added to
this list by default.

Amongst others, \Macro{normalcolor}, \Macro{MakeUppercase}, and
\Macro{MakeLowercase} are part of that list. More macros can be added one by
one using \Macro{addtokomafontrelaxlist}.

Note that \PName{macro} will be set simply to \Macro{relax}. So if
\PName{macro} really has an argument, the argument will be execute
locally. Therefore you must not add commands like \Macro{setlength} to the
list. The user himself is responsible for all errors resulting in the usage of
\Macro{addtokomafontrelaxlist}. Additionally this command should not be
misunderstood as a legitimation for adding all kind of commands to the font
setting of an element!

For\ChangedAt{v3.24}{\Class{scrbook}\and \Class{scrreprt}\and
  \Class{scrartcl}} some commands you may prefere to execute the first
argument unchanged. These commands can be added to another list using
\Macro{addtokomatfontonearglist}. By default \Macro{MakeUppercase} and
\Macro{MakeLowercase} are added to this list.

If\ChangedAt{v3.19}{\Class{scrbook}\and \Class{scrreprt}\and \Class{scrartcl}}
a \PName{macro} and it's first argument should be ignored locally inside
\DescRef{maincls.cmd.usefontofkomafont} and it's siblings, you can use
\Macro{addtokomafontgobblelist} instead of \Macro{addtokomafontrelaxlist}. An
example for this is the command \Macro{color}, that has to be ignored with the
colour name and therefore is a default member of the gobble-list.

Note, the defaults of the three lists can change. If you need a command inside
one of the lists you should add it yourself.%
\EndIndexGroup


\begin{Declaration}
  \Macro{IfExistskomafont}\Parameter{element}\Parameter{then code}%
  \Parameter{else code}
\end{Declaration}
Which\ChangedAt{v3.15}{\Class{scrbook}\and \Class{scrreprt}\and
  \Class{scrartcl}\and \Class{scrlttr2}} elements are defined depends on the
version of \KOMAScript. So sometimes it may be useful to be able to test,
whether or not an \PName{element} exists. The command executes the \PName{then
  code} only if an \PName{element} has been defined using
\DescRef{\LabelBase.cmd.newkomafont} or \DescRef{\LabelBase.cmd.aliaskomafont}
and therefore can be changed using \DescRef{maincls.cmd.setkomafont} or
\DescRef{maincls.cmd.addtokomafont} and can be used by one of the
\Macro{use\dots komafont} commands. Otherwise it executes the \PName{else
  code}.%
\EndIndexGroup

% \subsubsection{Paragraph Indention or Gap}
% \seclabel{parskip}

\begin{Declaration}
  \Macro{setparsizes}\Parameter{indent}\Parameter{distance}%^^A
  \Parameter{last line end space}
\end{Declaration}
With this command \KOMAScript{} provides to set the indent of the first line
of a new paragraph, the distance between paragraphs and the white space that
has to be at the end of the last line of each paragraph. This command should
be used whenever changes should also be recognized by option
\OptionValueRef{maincls}{parskip}{relative}. \KOMAScript{}\textnote{Beispiel}
itself uses this command, e.\,g., with
\begin{lstcode}
  \setparsizes{0pt}{0pt}{0pt plus 1fil}
\end{lstcode}
to switch of paragraph indent and distance between paragraphs and to allow any
white space at the end of the last line of paragraphs. This make sense, if a
paragraph consists of a box only, that should be printed without vertical
distance but with the whole column width. If, in opposite to that, the box
should only span the whole width but should be printed with the current
settings of paragraph indent and distance between paragraphs, usage of
\begin{lstcode}
  \setlength{\parfillskip}{0pt plus 1fil}
\end{lstcode}
would be recommended.

Since \KOMAScript~3.17\ChangedAt{v3.17}{\Class{scrbook}\and
  \Class{scrreprt}\and \Class{scrartcl}} changing or
reactivation\IndexCmd{activateareas} of the typing area or the margins (see
\autoref{cha:typearea}) will also reactivate the values of \Macro{setparsizes}
if they have not been changed since the last usage of this command. This is
one more reason not to change these values without using \KOMAScript. With
compatibility to a \KOMAScript{} version prior to 3.17 (see
\autoref{sec:maincls.compatibilityOptions},
\DescPageRef{maincls.option.version}, option
\DescRef{maincls.option.version}%
\IndexOption{version}\important{\OptionValueRef{maincls}{version}{3.17}})
this reactivation of the \Macro{setparsizes} values is deactivated.%
%
\EndIndexGroup

% \subsection{Counters}
% \seclabel{counter}

\LoadNonFree{scrbookreportarticle-experts}{3}

% \subsubsection{Sections}
% \seclabel{sections}

\begin{Declaration}
  \Macro{DeclareSectionCommand}\OParameter{attributes}\Parameter{name}%
  \Macro{DeclareNewSectionCommand}\OParameter{attributes}\Parameter{name}%
  \Macro{RedeclareSectionCommand}\OParameter{attributes}\Parameter{name}%
  \Macro{ProvideSectionCommand}\OParameter{attributes}\Parameter{name}
\end{Declaration}
With\ChangedAt{v3.15}{\Class{scrbook}\and \Class{scrreprt}\and
  \Class{scrartcl}} these commands you can either define a new section-like
command \Macro{\PName{name}} or change an already defined sectioning command
\Macro{\PName{name}}. To do so you use the optional argument to setup several
\PName{attributes}. The \PName{attributes} are a comma-separated list of
\PName{key}=\PName{value} assignments. Beside the style-independent attributes
shown in \autoref{tab:maincls-experts.declaresection.keys}, there are style
dependent attributes, too. Currently the following styles are provided:
\begin{labeling}{\PValue{chapter}:}
\item[\PValue{chapter}:] \ChangedAt{v3.18}{\Class{scrbook}\and
    \Class{scrreprt}}Style of chapter headings. This style is currently used
  for \DescRef{maincls.cmd.chapter}\IndexCmd{chapter} and indirectly for
  \DescRef{maincls.cmd.addchap}\IndexCmd{addchap}. You can define new
  section-like commands using this style. To define new or to reconfigure
  existing commands you can also use the additional attributes of
  \autoref{tab:maincls-experts.declarechapterstyle.keys},
  \autopageref{tab:maincls-experts.declarechapterstyle.keys}.
  Note\textnote{Attention!} that command \DescRef{maincls.cmd.addchap} and the
  star variants are configured automatically together with
  \DescRef{maincls.cmd.chapter} and should not be changed independently. Note
  that \Class{scrartcl}\OnlyAt{\Class{scrbook}\and \Class{scrreprt}} does not
  provide this style.
\item[\PValue{part}:] \ChangedAt{v3.18}{\Class{scrbook}\and
    \Class{scrreprt}\and \Class{scrartcl}}Style part headings. This style is
  currently used for \DescRef{maincls.cmd.part}\IndexCmd{part} and indirectly
  for \DescRef{maincls.cmd.addpart}\IndexCmd{addpart}. You can define new
  section-like commands using this style. To define new or to reconfigure
  existing commands you can also use the additional attributes of
  \autoref{tab:maincls-experts.declarepartstyle.keys},
  \autopageref{tab:maincls-experts.declarepartstyle.keys}.
  Note\textnote{Attention!} that command \DescRef{maincls.cmd.addpart} and the
  star variants are configured automatically together with
  \DescRef{maincls.cmd.part} and should not be changed independently.
\item[\PValue{section}:] Style of section headings. This style is currently
  used for \DescRef{maincls.cmd.section}\IndexCmd{section},
  \DescRef{maincls.cmd.subsection}\IndexCmd{subsection},
  \DescRef{maincls.cmd.subsubsection}\IndexCmd{subsubsection},
  \DescRef{maincls.cmd.paragraph}\IndexCmd{paragraph}, and
  \DescRef{maincls.cmd.subparagraph}\IndexCmd{subparagraph}. You can define
  new section-like commands using this style. To define new or to reconfigure
  existing commands you can also use the additional attributes of
  \autoref{tab:maincls-experts.declaresectionstyle.keys},
  \autopageref{tab:maincls-experts.declaresectionstyle.keys}. Definitions of
  new commands need\ChangedAt{v3.24}{\Class{scrbook}\and \Class{scrreprt}\and
    \Class{scrartcl}} at least the \PName{key}s \PValue{style},
  \PValue{afterskip}, \PValue{beforeskip}, and \PValue{level}.  \PValue{font}
  and \PValue{indent} are recommended. Need for \PValue{tocindent} and
  \PValue{tocnumwidth} depend on the command \PName{name}. This is also true
  if a command that was not a section-like command before will be redefined as
  a section-like command using
  \Macro{RedeclareSectionCommand}. Note\textnote{Attention!} that command
  \Macro{addsec} and the star variants are configured automatically together
  with \DescRef{maincls.cmd.section} and should not be changed
  independently. Defining a new section-like command with this style will also
  define an element with the same \PName{name} and the possibility to change
  its font using \DescRef{maincls.cmd.setkomafont} or
  \DescRef{maincls.cmd.addtokomafont} (see \autoref{sec:maincls.textmarkup},
  \DescPageRef{maincls.cmd.setkomafont}), if such an element does not already
  exist.
\end{labeling}

\begin{table}
  \caption[{Style-independent attributes at the declaration of section-like
    commands}]{Available \PName{key}s and \PName{value}s for the
    style-independent \PName{attributes} declaring a section-like command}%
  \label{tab:maincls-experts.declaresection.keys}%
  \begin{tabularx}{\linewidth}{llX}
    \toprule
    \PName{key} & \PName{value} & Description \\
    \midrule%
    \PValue{counterwithin} & \PName{counter name} & The value of the
    counter of the heading should depend on \PName{counter name}. Whenever
    \Macro{stepcounter} or \Macro{refstepcounter} increases the value of
    \PName{counter name}, the value of the counter of this heading should be
    set to 0. Also the output of the value of this heading should be prefixed
    by \Macro{the\PName{counter name}}
    followed by a dot.\\
    \ChangedAt{v3.19}{\Class{scrbook}\and \Class{scrreprt}\and
      \Class{scrartl}}%
    \PValue{counterwithout} & \PName{counter name} & Cancels a prior
    \PValue{counterwithin} setting. Therefore it makes sense only if you
    re-define an existing
    section-like command.\\
    \PValue{expandtopt} & \PName{switch}& If the switch is on, all following
    values for lengths will be completely expanded, evaluated and stored as
    \texttt{pt} values.  If the switch is off, all following values for
    lengths will be completely expanded, tentatively evaluated but only
    expanded stored.  Any values from \autoref{tab:truefalseswitch},
    \autopageref{tab:truefalseswitch} may be used. Default is
    \PValue{false}.\\
    \PValue{level} & \PName{integer} & A number, denoting depth of section
    (see counter \DescRef{maincls.counter.secnumdepth},
    \autoref{sec:maincls.structure},
    \DescPageRef{maincls.counter.secnumdepth});
    the value should be unique.\\
    \PValue{style} & \PName{name} & Defines the style of the
    heading.\\
    \ChangedAt[2016/03]{v3.20}{\Class{scrbook}\and \Class{scrreprt}\and
      \Class{scrartcl}}%
    \PValue{tocstyle} & \PName{name} & Defines the style of the entries into
    the table of contents. You can use every already defined toc-entry style
    (see \autoref{sec:tocbasic.tocstyle}). An empty \PName{name} prevents a
    new definition of the toc-entry
    command \Macro{l@\dots}.\\
    \ChangedAt[2016/03]{v3.20}{\Class{scrbook}\and \Class{scrreprt}\and
      \Class{scrartcl}}%
    \PValue{toc\PName{option}} & \PName{value} & Additional options depending
    on the TOC-entry style given by \Option{tocstyle}. See
    \autoref{sec:tocbasic.tocstyle}, \autopageref{sec:tocbasic.tocstyle} for
    additional information about TOC-entry styles. See
    \autoref{tab:tocbasic.tocstyle.attributes},
    \autopageref{tab:tocbasic.tocstyle.attributes} for information about the
    attributes of the predefined TOC-entry styles of package
    \Package{tocbasic}, that can be used
    as \PName{option}.\\
    % \PValue{tocindent} & \PName{length} & Total indentation from the left
    %                                       margin of the entry in the table of
    %                                       contents corresponding to this
    %                                       heading, if and only if such an
    %                                       entry will be made (see
    %                                       \DescRef{maincls.counter.tocdepth} (siehe
    %                                       \autoref{sec:maincls.toc},
    %                                       \DescPageRef{maincls.counter.tocdepth}).\\ 
    % \PValue{toclevel} & \PName{integer} & 
    %                                       A number denoting the depth of the
    %                                       entry in the table of contents
    %                                       corresponding to this heading, if
    %                                       this should differ from
    %                                       \PValue{level} (see
    %                                       \DescRef{maincls.counter.tocdepth} in
    %                                       \autoref{sec:maincls.toc},
    %                                       \DescPageRef{maincls.counter.tocdepth}). \\
    % \PValue{tocnumwidth} & \PName{length} &
    %                                       Width of the box for the number of
    %                                       the entry in the table of contents.\\
    \bottomrule
  \end{tabularx}
\end{table}

\begin{table}
  \caption[{Attributes of the style \PValue{section} declaring a section-like
    command}]{Additional \PName{keys} and \PName{value}s of attributes
    declaring a section-like command with style \PValue{section}}%
  \label{tab:maincls-experts.declaresectionstyle.keys}%
  \begin{tabularx}{\linewidth}{llX}
    \toprule
    \PName{key} & \PName{value} & Description \\
    \midrule
    \PValue{afterskip} & \PName{length} & A negative value activates a run-in
                                          heading. The absolute value is the
                                          skip to leave to right of the run-in
                                          heading. A positive value is the
                                          vertical skip below the heading.\\
    \PValue{beforeskip} & \PName{length}& The absolute value of the vertical
                                          skip before the heading. If the
                                          value is negative, then the
                                          paragraph indent of the text
                                          following the heading is
                                          suppressed.\\
    \PValue{font} & \PName{font commands}  & 
                                          The initial font setting that
                                          should be used beside 
                                          \DescRef{maincls.fontelement.disposition} for the
                                          heading. You can use all settings,
                                          that are allowed for
                                          \DescRef{maincls.cmd.setkomafont} and
                                          \DescRef{maincls.cmd.addtokomafont} for the
                                          element of the heading.\\
    \PValue{indent} & \PName{length}    & Indentation of heading from the left
                                          margin.\\
    \bottomrule
  \end{tabularx}
\end{table}

\begin{table}
  \caption[{Attributes of the style \PValue{chapter} declaring a section-like
    command}]{Additional \PName{keys} and \PName{value}s of attributes
    declaring a section-like command with style \PValue{chapter}}%
  \label{tab:maincls-experts.declarechapterstyle.keys}%
  \begin{tabularx}{\linewidth}{llX}
    \toprule
    \PName{key} & \PName{value} & Description \\
    \midrule
    \PValue{afterskip} & \PName{length} & The absolute value is the
                                          vertical skip below the heading.\\
    \PValue{beforeskip} & \PName{length}& The absolute value of the vertical
                                          skip before the heading. If the
                                          value is negative, then the
                                          paragraph indent of the text
                                          following the heading is
                                          suppressed. This will be done also
                                          for positive values if class option
                                          \DescRef{maincls.option.version} is
                                          set to a value less than 3.22.\\
    \PValue{font} & \PName{font commands}  & 
                                          The initial font setting that
                                          should be used beside 
                                          \DescRef{maincls.fontelement.disposition} for the
                                          heading. You can use all settings,
                                          that are allowed for
                                          \DescRef{maincls.cmd.setkomafont} and
                                          \DescRef{maincls.cmd.addtokomafont} for the
                                          element of the heading.\\
    \PValue{innerskip} & \PName{length} & The vertical skip between the prefix
                                          line and the heading's text, if a
                                          prefix line is used.\\
    \PValue{pagestyle} & \PName{page style name} &
                                          The name of the page style that
                                          should be used automatically on
                                          pages with the heading. There is no
                                          validation whether or not
                                          \PName{page style name} is really
                                          the name of a page style. Therefore,
                                          wrong names will result in error
                                          messages at usage of the
                                          section-like command.\\
    \PValue{prefixfont} & \PName{font commands} &
                                          The initial font setting that
                                          should be used beside
                                          \DescRef{maincls.fontelement.disposition}
                                          and the
                                          element of the heading for the
                                          prefix line of the heading. You can
                                          use all settings that are allowed
                                          for
                                          \DescRef{maincls.cmd.setkomafont}
                                          and 
                                          \DescRef{maincls.cmd.addtokomafont}
                                          for the element of the prefix
                                          line.\\
    \bottomrule
  \end{tabularx}
\end{table}

\begin{table}
  \caption[{Attributes of the style \PValue{part} declaring a section-like
    command}]{Additional \PName{keys} and \PName{value}s of attributes
    declaring a section-like command with style \PValue{part}}%
  \label{tab:maincls-experts.declarepartstyle.keys}%
  \begin{tabularx}{\linewidth}{llX}
    \toprule
    \PName{key} & \PName{value} & Description \\
    \midrule
    \PValue{afterskip} & \PName{length} & The absolute value is the
                                          vertical skip below the heading.\\
    \PValue{beforeskip} & \PName{length}& The absolute value of the vertical
                                          skip before the heading.\\
    \PValue{font} & \PName{font commands}  & 
                                          The initial font setting that
                                          should be used beside 
                                          \DescRef{maincls.fontelement.disposition}
                                          for the
                                          heading. You can use all settings,
                                          that are allowed for
                                          \DescRef{maincls.cmd.setkomafont} and
                                          \DescRef{maincls.cmd.addtokomafont}
                                          for the element of the heading.\\
    \PValue{innerskip} & \PName{length} & % \OnlyAt{\Class{scrbook}\and
                                          %  \Class{scrreprt}}%
                                          The vertical skip between the prefix
                                          line and the heading's text of
                                          \Class{scrbook} and
                                          \Class{scrreprt}.\\
    \PValue{pagestyle} & \PName{page style name} &
                                          % \OnlyAt{\Class{scrbook}\and
                                          %  \Class{scrreprt}}%
                                          The name of the page style that
                                          should be used automatically on
                                          pages with the heading. There is no
                                          validation whether or not
                                          \PName{page style name} is really
                                          the name of a page style. Therefore,
                                          wrong names will result in error
                                          messages at usage of the
                                          section-like command. This feature
                                          is only available with
                                          \Class{scrbook} or
                                          \Class{scrreprt}.\\
    \PValue{prefixfont} & \PName{font commands} &
                                          The initial font setting that
                                          should be used beside
                                          \DescRef{maincls.fontelement.disposition}
                                          and the
                                          element of the heading for the
                                          prefix line of the heading. You can
                                          use all settings that are allowed
                                          for
                                          \DescRef{maincls.cmd.setkomafont}
                                          and
                                          \DescRef{maincls.cmd.addtokomafont}
                                          for the element of the prefix
                                          line.\\
    \bottomrule
  \end{tabularx}
\end{table}

\Macro{DeclareNewSectionCommand} defines a new section-like command. If the
same \PName{name} is already used by \TeX{} for something else, the command
will result in an error message and will not define anything.

\Macro{ProvideSectionSommand} is similar but does not show any error message.

\Macro{RedeclareSectionCommand} can only change an existing command to a
section-like command with given \PName{attributes}. There is no pre-validation
to make sure that \Macro{\PName{name}} was a section-like command
before. However, it has to be an already used command sequence \PName{name}.

\Macro{DeclareSectionCommand} does not check whether or not \PName{name} is
an already used \TeX{} command sequence. It just defines a section-like
command \Macro{\PName{name}} with the given \PName{attributes}.

Every section-like command has also a corresponding counter with the same
\PName{name}, that will be allocated using \Macro{newcounter} if
necessary. The same rule applies to the corresponding output of the counter:
\Macro{the\PName{name}}, the output format: \Macro{\PName{name}format}, the
command to generate a running head: \Macro{\PName{name}mark}, the counter
format of the running head: \Macro{\PName{name}markformat}, the font element:
\FontElement{\PName{name}}, and the section depth number:
\Macro{\PName{name}numdepth}. The command for the running head
\Macro{\PName{name}mark} will be defined to not generate any running head. The
output of the counter, \Macro{the\PName{name}}, will show an Arabic number. If
the \PName{key} \PValue{counterwithin} defines a counter the heading number
depends on, the output of the counter will be prefixed by the output of that
counter followed by a dot.

Beside\ChangedAt[2016/03]{v3.20}{\Class{scrbook}\and \Class{scrreprt}\and
  \Class{scrartcl}} the section-like command, a command for corresponding
entries to the table of contents is defined also. This is done using package
\Package{tocbasic}\important{\Package{tocbasic}}\IndexPackage{tocbasic}.
Attribute \PName{tocstyle} defines the style of those entries. If you set an
empty \PName{name}, e.\,g., using \OptionValue{tocstyle}{} or
\OptionValue{tocstyle}{\{\}}, the entry command will not be changed. This is
important, if you use another package to modify the table of contents. If you
do not set attribute \PValue{tocstyle} the already configured style will be
used again.

The\ChangedAt[2016/03]{v3.20}{\Class{scrbook}\and \Class{scrreprt}\and
  \Class{scrartcl}} different toc-entry styles also have different, additional
attributes. You can set them here too, if you prefix them with
\PValue{toc}. For example, you can setup the level of the toc-entries,
\PValue{level}, using \PValue{toclevel}, the indention, \PValue{indent}, using
\PValue{tocindent}, or the number width, \PValue{numwidth}, using
\PValue{tocnumwidth}. For more toc-entry style attributes see
\autoref{sec:tocbasic.tocstyle}, \autopageref{sec:tocbasic.tocstyle}.

\begin{Example}
  Because of incomprehensible reasons, the headings of
  \DescRef{maincls.cmd.paragraph} shouldn't be run-in headings any longer but
  headings similar to \DescRef{maincls.cmd.subsubsection}. The vertical skip
  above the heading should be 10\,pt and the following text should be set
  without any vertical distance. To do so, you can simply use:
\begin{lstcode}
  \RedeclareSectionCommand[%
    beforeskip=-10pt,%
    afterskip=1sp%
  ]{paragraph}
\end{lstcode}
  The negative value of \PValue{beforeskip} does not only result in a
  positive vertical skip before the heading, but also deactivates the paragraph
  indentation of the following text. Despite the specification of no vertical
  skip after the heading a value of 1\,sp has been given to
  \PValue{afterskip}. This is because \LaTeX{} here doesn't accept 0\,pt as
  positive value. So 1\,sp is the lowest possible positive value.

  Generally, for the vertical adjustment it is better to have some
  tolerance in the declaration of gaps\,---\,the so called \emph{glue}:
\begin{lstcode}
  \RedeclareSectionCommand[%
    beforeskip=-10pt plus -2pt minus -1pt,%
    afterskip=1sp plus -1sp minus 1sp%
  ]{paragraph}
\end{lstcode}
  Doing so you have to know, that the glue also switches the algebraic sign
  before becoming a skip, if the value is negative. That is the reason for the
  negative glue values in the example. Additionally we used the occasion to
  minimize the vertical skip after the heading using glue too.
\end{Example}

In the example above only \PValue{beforeskip} and \PValue{afterskip} were
needed, because since v3.15 \KOMAScript{} defines
\DescRef{maincls.cmd.paragraph} itself using
\Macro{DeclareSectionCommand}. All other values are just reused with their
initial definition. Furthermore, the original definition of
\DescRef{maincls.cmd.paragraph} in \Class{scrartcl} reads:
\begin{lstcode}
  \DeclareSectionCommand[%
    level=4,
    indent=0pt,
    beforeskip=3.25ex plus 1ex minus .2ex,
    afterskip=-1em,
    font={},
    tocindent=7em,
    tocnumwidth=4.1em,
    counterwithin=subsubsection
  ]{paragraph}
\end{lstcode}
\Class{scrreprt} and \Class{scrbook} use slightly different values.

Some settings of \DescRef{maincls.cmd.chapter} depend on option
\DescRef{maincls.option.headings} (see \autoref{sec:maincls.structure},
\DescPageRef{maincls.option.headings}).
\hyperref[tab:maincls.chapter.skips]{Table~\ref*{tab:maincls.chapter.skips}}
shows the default values of these settings. An overview of all settings is
shown in \autoref{tab:maincls.section.defaults}. For more
information\ChangedAt[2016/03]{v3.20}{\Class{scrbook}\and \Class{scrreprt}\and
  \Class{scrartcl}} about the default of the toc-entry styles see
\autoref{sec:tocbasic.tocstyle}\important{\Package{tocbasic}},
\autopageref{sec:tocbasic.tocstyle}. Please note, that \PValue{1ex} and
\Length{baselineskip} depend on the default font size of the heading or the
table of contents entry.%
%
\begin{table}
  \centering
  \caption{Defaults of the chapter headings of \Class{scrbook}
    and \Class{scrreprt} subject to option \DescRef{maincls.option.headings}}
  \label{tab:maincls.chapter.skips}
  \begin{tabular}{ll}
    \multicolumn{2}{@{}l}{\bfseries 
      With \OptionValueRef{maincls}{headings}{big}:}\\
    \toprule
    Attribute & Default Value \\
    \midrule
    \PValue{afterskip}
      & \PValue{1.725\Length{baselineskip} plus .115\Length{baselineskip}
        minus .192\Length{baselineskip}} \\
    \PValue{beforeskip} 
      & \PValue{-3.3\Length{baselineskip}-\Length{parskip}} \\
    \PValue{font} & \Macro{huge} \\
    \bottomrule\\
    \multicolumn{2}{@{}l}{\bfseries 
      With \OptionValueRef{maincls}{headings}{normal}:}\\
    \toprule
    Attribute & Default Value \\
    \midrule
    \PValue{afterskip}
      & \PValue{1.5\Length{baselineskip} plus .1\Length{baselineskip}
        minus .167\Length{baselineskip}} \\
    \PValue{beforeskip} 
      & \PValue{-3\Length{baselineskip}-\Length{parskip}} \\
    \PValue{font} & \Macro{LARGE} \\
    \bottomrule\\
    \multicolumn{2}{@{}l}{\bfseries 
      With \OptionValueRef{maincls}{headings}{small}:}\\
    \toprule
    Attribute & Default Value \\
    \midrule
    \PValue{afterskip}
      & \PValue{1.35\Length{baselineskip} plus .09\Length{baselineskip}
        minus .15\Length{baselineskip}} \\
    \PValue{beforeskip} 
      & \PValue{-2.8\Length{baselineskip}-\Length{parskip}} \\
    \PValue{font} & \Macro{Large} \\
    \bottomrule
  \end{tabular}
\end{table}

%begin{table}
% \centering
  \begin{longtable}{@{}p{\columnwidth}@{}}
    \caption{Default of the headings of \Class{scrbook} and
      \Class{scrreprt}}%
    \label{tab:maincls.section.defaults}\\
    \endfirsthead
    \caption[]{Default of the headings of \Class{scrbook} and
      \Class{scrreprt} \emph{(Continuation)}}\\
    \addlinespace[-\normalbaselineskip]
    \endhead
    \raggedleft\dots\\
    \endfoot
    \endlastfoot
    \DescRef{maincls.cmd.part}: \\*
    \begin{tabularx}{\linewidth}{ll}
    \toprule
    Attribute & Default Value \\
    \midrule
    \PValue{afterskip}   & \PValue{0pt plus 1fil} \\
    \PValue{beforeskip}  & \PValue{0pt plus 1fil + \Length{baselineskip}} \\
    \PValue{font}        & see element \DescRef{maincls.fontelement.part}, 
                           \autoref{tab:maincls.structureElementsFont}, 
                           \autopageref{tab:maincls.structureElementsFont} \\
    \PValue{innerskip}   & \PValue{20pt} \\
    \PValue{level}       & -1 \\
    \PValue{prefixfont}  & see element 
                           \DescRef{maincls.fontelement.partnumber},
                           \autoref{tab:maincls.structureElementsFont}, 
                           \autopageref{tab:maincls.structureElementsFont} \\
    \PValue{tocindent}   & \PValue{0pt} \\
    \PValue{toclevel}    & -1 \\
    \PValue{tocnumwidth} & \PValue{2em} \\
    \PValue{tocstyle}    & \PValue{part} \\
    \bottomrule
    \end{tabularx} \\
    \addlinespace[\normalbaselineskip]
    \DescRef{maincls.cmd.chapter}: \\*
    \begin{tabularx}{\linewidth}{ll}
    \toprule
    Attribute & Default Value \\
    \midrule
    \PValue{afterskip}   & see \autoref{tab:maincls.chapter.skips} \\
    \PValue{beforeskip}  & see \autoref{tab:maincls.chapter.skips} \\
    \PValue{font}        & see element \DescRef{maincls.fontelement.chapter},
                           \autoref{tab:maincls.structureElementsFont}, 
                           \autopageref{tab:maincls.structureElementsFont} \\
    \PValue{innerskip}   & \PValue{0pt} \\
    \PValue{level}       & 0 \\
    \PValue{prefixfont}  & see element 
                           \DescRef{maincls.fontelement.chapterprefix},
                           \autoref{tab:maincls.structureElementsFont}, 
                           \autopageref{tab:maincls.structureElementsFont} \\
    \PValue{tocindent}   & \PValue{0pt} \\
    \PValue{toclevel}    & 0 \\
    \PValue{tocnumwidth} & \PValue{1.5em} \\
    \PValue{tocstyle}    & \PValue{chapter} \\
    \bottomrule
    \end{tabularx} \\
    \addlinespace[\normalbaselineskip]
    \DescRef{maincls.cmd.section}: \\*
    \begin{tabularx}{\linewidth}{ll}
    \toprule
    Attribute & Default Value \\
    \midrule
    \PValue{afterskip}   & \PValue{2.3ex plus .2ex} \\
    \PValue{beforeskip}  & \PValue{-3.5ex plus -1ex minus -.2ex} \\
    \PValue{font}        & see element \DescRef{maincls.fontelement.section},
                           \autoref{tab:maincls.structureElementsFont}, 
                           \autopageref{tab:maincls.structureElementsFont} \\
    \PValue{indent}      & \PValue{0pt} \\
    \PValue{level}       & 1 \\
    \PValue{tocindent}   & \PValue{1.5em}\\
    \PValue{toclevel}    & 1 \\
    \PValue{tocnumwidth} & \PValue{2.3em}\\
    \PValue{tocstyle}    & \PValue{section} \\
    \bottomrule
    \end{tabularx} \\
    \addlinespace[\normalbaselineskip]
    \DescRef{maincls.cmd.subsection}: \\*
    \begin{tabularx}{\linewidth}{ll}
    \toprule
    Attribute & Default Value \\
    \midrule\nopagebreak
    \PValue{afterskip}   & \PValue{1.5ex plus .2ex} \\
    \PValue{beforeskip}  & \PValue{-3.25ex plus -1ex minus -.2ex} \\
    \PValue{font}        & see element 
                           \DescRef{maincls.fontelement.subsection},
                           \autoref{tab:maincls.structureElementsFont}, 
                           \autopageref{tab:maincls.structureElementsFont} \\
    \PValue{indent}      & \PValue{0pt} \\
    \PValue{level}       & 2 \\
    \PValue{tocindent}   & \PValue{3.8em}\\
    \PValue{toclevel}    & 2 \\
    \PValue{tocnumwidth} & \PValue{3.2em}\\
    \PValue{tocstyle}    & \PValue{section} \\
    \bottomrule
    \end{tabularx} \\
    \addlinespace[\normalbaselineskip]
    \DescRef{maincls.cmd.subsubsection}: \\*
    \begin{tabularx}{\linewidth}{ll}
    \toprule
    Attribute & Default Value \\
    \midrule\nopagebreak
    \PValue{afterskip}   & \PValue{1.5ex plus .2ex} \\
    \PValue{beforeskip}  & \PValue{-3.25ex plus -1ex minus -.2ex} \\
    \PValue{font}        & see element 
                           \DescRef{maincls.fontelement.subsubsection},
                           \autoref{tab:maincls.structureElementsFont}, 
                           \autopageref{tab:maincls.structureElementsFont} \\
    \PValue{indent}      & \PValue{0pt} \\
    \PValue{level}       & 3 \\
    \PValue{tocindent}   & \PValue{7.0em}\\
    \PValue{tocnumwidth} & \PValue{4.1em}\\
    \PValue{toclevel}    & 3 \\
    \PValue{tocstyle}    & \PValue{section} \\
    \bottomrule
    \end{tabularx} \\
    \addlinespace[\normalbaselineskip]
    \DescRef{maincls.cmd.paragraph}: \\*
    \begin{tabularx}{\linewidth}{ll}
    \toprule
    Attribute & Default Value \\
    \midrule\nopagebreak
    \PValue{afterskip}   & \PValue{-1em} \\
    \PValue{beforeskip}  & \PValue{3.25ex plus 1ex minus .2ex} \\
    \PValue{font}        & see element \DescRef{maincls.fontelement.paragraph},
                           \autoref{tab:maincls.structureElementsFont}, 
                           \autopageref{tab:maincls.structureElementsFont} \\
    \PValue{indent}      & \PValue{0pt} \\
    \PValue{level}       & 4 \\
    \PValue{tocindent}   & \PValue{10em}\\
    \PValue{toclevel}    & 4 \\
    \PValue{tocnumwidth} & \PValue{5em}\\
    \PValue{tocstyle}    & \PValue{section} \\
    \bottomrule
    \end{tabularx} \\
    \addlinespace[\normalbaselineskip]
    \DescRef{maincls.cmd.subparagraph}:  \\*
    \begin{tabularx}{\linewidth}{ll}
    \toprule
    Attribute & Default Value \\
    \midrule\nopagebreak
    \PValue{afterskip}   & \PValue{-1em} \\
    \PValue{beforeskip}  & \PValue{3.25ex plus 1ex minus .2ex} \\
    \PValue{font}        & see element
                           \DescRef{maincls.fontelement.subparagraph},
                           \autoref{tab:maincls.structureElementsFont}, 
                           \autopageref{tab:maincls.structureElementsFont} \\
    \PValue{indent}      & \Macro{scr@parindent} \\
    \PValue{level}       & 5 \\
    \PValue{tocindent}   & \PValue{12em}\\
    \PValue{toclevel}    & 5 \\
    \PValue{tocnumwidth} & \PValue{6em}\\
    \PValue{tocstyle}    & \PValue{section} \\
    \bottomrule
    \end{tabularx}
  \end{longtable}
%end{table}
%
\EndIndexGroup


\begin{Declaration}
  \Macro{DeclareSectionCommands}\OParameter{attributes}
                                \Parameter{list of names}%
  \Macro{DeclareNewSectionCommands}\OParameter{attributes}
                                   \Parameter{list of names}%
  \Macro{RedeclareSectionCommands}\OParameter{attributes}
                                  \Parameter{list of names}%
  \Macro{ProvideSectionCommands}\OParameter{attributes}
                                \Parameter{list of names}
\end{Declaration}
With\ChangedAt[2014/11]{v3.15}{\Class{scrbook}\and \Class{scrreprt}\and
  \Class{scrartcl}} these commands you can either define or change several
section-like commands at once. The names of the section-like commands are
given by the comma-separated \PName{list of names}.

There are two more differences to the previously described commands that only
define or change a single section-like command. Firstly, in case of error\,---\,if \Macro{DeclareNewSectionCommands} is used for an already defined \TeX{}
command sequence or if \Macro{RedeclareSectionCommands} is used for an
undefined \TeX{} command sequence\,---\,the definition will be done in spite
of raising an error message.

Secondly, there is one more attribute \PValue{increaselevel} with an optional
integer argument. This attribute changes the meaning of the attributes
\PValue{level} and \PValue{toclevel} (see
\autoref{tab:maincls-experts.declaresection.keys}) so their values become
start values for the first section-like command of the \PName{list of
  names}. From section-like command to section-like command of the \PName{list
  of names} the value of \PValue{level} and \PValue{toclevel}
will be increased by the value of \PValue{increaselevel}. If attribute
\PValue{increaselevel} is used without an assignment the increase value is 1.
%
\EndIndexGroup


\begin{Declaration}
  \Macro{chapterheadstartvskip}%
  \Macro{chapterheadmidvskip}%
  \Macro{chapterheadendvskip}%
  \Macro{partheadstartvskip}%
  \Macro{partheadmidvskip}%
  \Macro{partheadendvskip}%
  \Macro{partheademptypage}
\end{Declaration}
These\important[i]{\DescRef{maincls.cmd.chapter}\\
  \DescRef{maincls.cmd.part}\\
  \DescRef{maincls.cmd.addchap}\\
  \DescRef{maincls.cmd.addpart}} commands are used inside of the definition of the headings
\DescRef{maincls.cmd.chapter}\IndexCmd{chapter}, \DescRef{maincls.cmd.part}, \DescRef{maincls.cmd.addchap},
\DescRef{maincls.cmd.addpart} and their star-variations. Thereby
\Macro{chapterheadstartvskip} is designed to be a command, that inserts a
vertical distance before the chapter heading. Analogues
\Macro{chapterheadendvskip} is designed to be a command, that inserts a vertical
distance after the chapter heading. If\ChangedAt{v3.15}{\Class{scrbook}\and
  \Class{scrreprt}} the chapter heading has a prefix number line (see option
\DescRef{maincls.option.chapterprefix} in \autoref{sec:maincls.structure},
\DescPageRef{maincls.option.chapterprefix}), \Macro{chapterheadmidvskip}
will be used between the number line and the heading text.

Vertical distance above and below part headings will be inserted using the
commands \Macro{partheadstartvskip} and \Macro{partheadendvskip}. A page break
would be interpreted to be part of the vertical distance and therefore is
already part of the default of \Macro{partheadendvskip} in
\Class{scrbook}\OnlyAt{\Class{scrbook}\and \Class{scrreprt}} and
\Class{scrreprt}. Command
\Macro{partheademptypage}\ChangedAt{v3.02}{\Class{scrbook}\and
  \Class{scrreprt}} is used to produce the empty page after the part heading
page of \Class{scrbook} and \Class{scrreprt}.

Since \KOMAScript~3.15\ChangedAt{v3.15}{\Class{scrbook}\and
  \Class{scrreprt}\and \Class{scrartcl}} the defaults of these seven commands
are independent from option \DescRef{maincls.option.headings} (see
\autoref{sec:maincls.structure},
\DescPageRef{maincls.option.headings}). The original definitions of the
chapter heading reads since
\KOMAScript~3.157\ChangedAt{v3.17}{\Class{scrbook}\and \Class{scrreprt}\and
  \Class{scrartcl}}:\IndexLength{@tempskipa}
\begin{lstcode}
  \newcommand*{\chapterheadstartvskip}{\vspace{\@tempskipa}}
  \newcommand*{\chapterheadmidvskip}{\par\nobreak\vskip\@tempskipa}
  \newcommand*{\chapterheadendvskip}{\vskip\@tempskipa}
\end{lstcode}
Every usage of \OptionValueRef{maincls}{headings}{big}\IndexOption{headings},
\OptionValueRef{maincls}{headings}{normal}, or
\OptionValueRef{maincls}{headings}{small} reactivates these default
definitions.

Command \DescRef{maincls.cmd.chapter} automatically sets the internal length
\Length{@tempskipa} to the value of the
\DescRef{\LabelBase.cmd.DeclareSectionCommand}\IndexCmd{DeclareSectionCommand} attribute
\PValue{beforeskip} before calling
\Macro{chapterheadstartvskip}. Correspondingly it sets the length to the value
of attribute \PValue{afterskip} before calling \Macro{chapterheadendvskip} and
\PValue{innerskip} before calling \Macro{chapterheadmidvskip}. If you redefine
\Macro{chapterheadstartvskip}, \Macro{chapterheadmidvskip}, or
\Macro{chapterheadendvskip} you should also correspond the new definition to
\Length{@tempskipa} to respect the values of \DescRef{\LabelBase.cmd.DeclareSectionCommand}.

The default values of the distances of \DescRef{maincls.cmd.part} do not depend on option
\DescRef{maincls.option.headings}. So the corresponding commands will not be redefined using
the options. The\ChangedAt{v3.17}{\Class{scrbook}\and \Class{scrreprt}\and
  \Class{scrartcl}} original definitions of these commands of \Class{scrbook}
and \Class{scrreprt} read:
\begin{lstcode}
  \newcommand*{\partheadstartvskip}{%
    \null\vskip-\baselineskip\vskip\@tempskipa
  }
  \newcommand*{\partheadmidvskip}{%
    \par\nobreak
    \vskip\@tempskipa
  }
  \newcommand*{\partheadendvskip}{%
    \vskip\@tempskipa\newpage
  }
\end{lstcode}
and of \Class{scrartcl}:
\begin{lstcode}
  \newcommand*{\partheadstartvskip}{%
    \addvspace{\@tempskipa}%
  }
  \newcommand*{\partheadmidvskip}{%
    \par\nobreak
  }
  \newcommand*{\partheadendvskip}{%
    \vskip\@tempskipa
  }
\end{lstcode}
Again \DescRef{maincls.cmd.part} sets
\Length{@tempskipa}\IndexLength{@tempskipa} to the values of
\DescRef{\LabelBase.cmd.DeclareSectionCommand}\IndexCmd{DeclareSectionCommand}
before the internal usage of the command.

It\ChangedAt[2015/03]{v3.17}{\Class{scrbook}\and \Class{scrreprt}\and
  \Class{scrartcl}} is not recommended to redefine the command for the
distances above or below the headings only for changing these distances,
because you can reconfigure these distances much easier using
\DescRef{\LabelBase.cmd.RedeclareSectionCommand}. Redefinition of the commands
should be reserved to more complex changes. An\textnote{Example!}  example
that redefines \Macro{chapterheadstartvskip} and \Macro{chapterheadendvskip}
to print extra rules above and below the chapter heading may be found at
\cite{homepage} (in German).%
%
\EndIndexGroup


\begin{Declaration}
  \Macro{chapterlineswithprefixformat}%
    \Parameter{level}\Parameter{number}\Parameter{text}%
  \Macro{chapterlinesformat}%
    \Parameter{level}\Parameter{number}\Parameter{text}
\end{Declaration}
These\ChangedAt{v3.19}{\Class{scrbook}\and \Class{scrreprt}} commands are used
by headings with style \PValue{chapter} to output the heading number and
heading text depending on option
\DescRef{maincls.option.chapterprefix}\IndexOption{chapterprefix}%
\textnote{\DescRef{maincls.option.chapterprefix}} (see \autoref{sec:maincls.structure},
\DescPageRef{maincls.option.chapterprefix}). If the option is
\PValue{true} \Macro{chapterlineswithprefixformat} is used, otherwise
\Macro{chapterlinesformat}.

The arguments \PName{number} and \PName{text} are already formatted, i.\,e.,
they contain font selections. At least the order and layout of both has to be
done with these commands. If a heading has no number argument \PName{number}
will be completely empty also without any format or font commands.

The default definitions are very simple:
\begin{lstcode}
  \newcommand{\chapterlinesformat}[3]{%
    \@hangfrom{#2}{#3}%
  }
  \newcommand{\chapterlineswithprefixformat}[3]{%
    #2#3%
  }
\end{lstcode}

\begin{Example}
  You want to have chapter headings with yellow background. For the headings
  without prefix line you use the follow definition in the document preamble:
\begin{lstcode}
  \makeatletter
  \renewcommand{\chapterlinesformat}[3]{%
    \colorbox{yellow}{%
      \parbox{\dimexpr\linewidth-2\fboxrule-2\fboxsep}{%
        \@hangfrom{#2}#3%
      }%
    }%
  }
  \makeatother
\end{lstcode}
  For chapter headings without prefix line you use:
\begin{lstcode}
  \renewcommand{\chapterlineswithprefixformat}[3]{%
    \colorbox{yellow}{%
      \parbox{\dimexpr\linewidth-2\fboxrule-2\fboxsep}{%
        #2#3%
      }%
    }%
  }
\end{lstcode}
  Unfortunately you will find, that these re-definitions result in justified
  text for the headings. The reason is the \Macro{parbox} command. To change
  this, you can use \DescRef{maincls.cmd.raggedchapter} (see
  \autoref{sec:maincls.structure}, \DescPageRef{maincls.cmd.raggedchapter})
  inside the argument of \Macro{parbox}. Otherwise \Macro{raggedchapter} would
  be used only before \Macro{chapterlineswithprefixformat} and
  \Macro{chapterlinesformat}:
\begin{lstcode}
  \makeatletter
  \renewcommand{\chapterlinesformat}[3]{%
    \colorbox{yellow}{%
      \parbox{\dimexpr\linewidth-2\fboxrule-2\fboxsep}{%
        \raggedchapter
        \@hangfrom{#2}#3%
      }%
    }%
  }
  \makeatother
  \renewcommand{\chapterlineswithprefixformat}[3]{%
    \colorbox{yellow}{%
      \parbox{\dimexpr\linewidth-2\fboxrule-2\fboxsep}{%
        \raggedchapter
        #2#3%
      }%
    }%
  }
\end{lstcode}
  Remember to use \Macro{makeatletter} and \Macro{makeatother} only at the
  document preamble. Do not use it inside your own wrapper-class or
  package. It is only needed because of \Macro{@hangfrom} in the definition of
  \Macro{chapterlinesformat}.
\end{Example}

As the example shows, users, who change the definition of one of the commands,
should take care of several side effects. The alignment of the text is only
one thing. They also have to prevent page breaks in the headings, e.\,g., if
they add extra space into the output. The example above does not have page
break problems. Not only the boxes prevent page breaks. \KOMAScript{} itself
also changes \Macro{interlinepenalty} as part of \PName{text} to prevent page
breaks. It also finishes \PName{text} with an internal paragraph break using
\Macro{@par}.

Command \DescRef{maincls.cmd.raggedchapter} is not part of \PName{text} but
executed before \Macro{chapterlineswithprefixformat} or
\Macro{chapterlinesformat}. This makes it much easier to use, e.\,g.,
\Macro{MakeUppercase} at a re-definition. Please note, typographers use
individual letter spacing at majuscule text, but \LaTeX{} command
\Macro{MakeUppercase} does not.

The first argument, \PName{level}, is not used by the default definition and
also not needed in the example above. It is of interest only, if a user would
define several commands with \PValue{chapter} style and need to distinguish
the different levels. The predefined commands \DescRef{maincls.cmd.chapter},
\DescRef{maincls.cmd.chapter*}, \DescRef{maincls.cmd.addchap}, and
\DescRef{maincls.cmd.addchap*} all share the same \PName{level}
\PName{chapter}.%
\EndIndexGroup


\begin{Declaration}
  \Macro{sectionlinesformat}%
    \Parameter{level}\Parameter{indent}\Parameter{number}\Parameter{text}%
  \Macro{sectioncatchphraseformat}%
    \Parameter{level}\Parameter{indent}\Parameter{number}\Parameter{text}%
\end{Declaration}
These\ChangedAt{v3.19}{\Class{scrbook}\and \Class{scrreprt}\and
  \Class{scrartcl}} commands are used by headings with style \PValue{section}
to output the heading number and heading text. If the heading is printed as
catch phrase at the very beginning of the following paragraph text
\Macro{sectioncatchphraseformat} is used, otherwise
\Macro{sectionlinesformat}.

In both cases \PName{indent} is the value of the horizontal indention of the
heading relative to the text area. If the value is negative the heading should
even move into the left margin.

The arguments \PName{number} and \PName{text} are already formatted, i.\,e.,
they contain font selections. At least the order and layout of both has to be
done with these commands. If a heading has no number argument \PName{number}
will be completely empty also without any format or font commands.

The default definitions are:
\begin{lstcode}
\newcommand{\sectionlinesformat}[4]{%
  \@hangfrom{\hskip #2#3}{#4}%
}
\newcommand{\sectioncatchphraseformat}[4]{%
  \hskip #2#3#4%
}
\end{lstcode}

If the user re-defines one of these commands, he has to take care to prevent
page breaks inside the printing of the heading. \KOMAScript{} itself only
changes \Macro{interlinepenalty} to impede page breaks.

\begin{Example}
  Like chapter headings in the previous example, headings of \PName{level}
  \PValue{section} should be printed with a background colour. The lower
  levels should be affected:
\begin{lstcode}
  \makeatletter
  \renewcommand{\sectionlinesformat}[4]{%
    \@tempswafalse
    \ifstr{#1}{section}{%
      \hspace*{#2}%
      \colorbox{yellow}{%
        \parbox{\dimexpr\linewidth-2\fboxrule-2\fboxsep-#2}{%
          \raggedsection
          \@hangfrom{#3}{#4}%
        }%
      }%
    }{%
      \@hangfrom{\hskip #2#3}{#4}%
    }%
  }
  \makeatother
\end{lstcode}
  With this code the indention part of indented headings would not be
  coloured, but with negative indention the background of the margin part of
  the headings will also become yellow. You can move the \Macro{hspace*}
  command into the \Macro{colorbox} to change this.

  Again remember to use \Macro{makeatletter} and \Macro{makeatother} only at the
  document preamble. Do not use it inside your own wrapper-class or
  package. It is only needed because of \Macro{@hangfrom} in the definition of
  \Macro{sectionlinesformat}.
\end{Example}

The first argument, \PName{level}, is not used by the default definition. The
example shows how to use it to distinguish different heading levels of the
same style \PValue{section}.%
\EndIndexGroup


\begin{Declaration}
  \Macro{SecDef}\Parameter{star command}\Parameter{command}%
  \Macro{scr@startsection}\Parameter{name}\Parameter{level}\Parameter{indent}%
                          \Parameter{beforeskip}\Parameter{afterskip}%
                          \Parameter{style commands}%
                          \OParameter{short version}\Parameter{heading}%
  \labelsuffix[*]%
  \Macro{scr@startsection}\Parameter{name}\Parameter{level}\Parameter{indent}%
                          \Parameter{beforeskip}\Parameter{afterskip}%
                          \Parameter{style commands}%
                          \PValue{*}\Parameter{heading}%
  \labelsuffix%
  \Macro{At@startsection}\Parameter{code}%
  \Macro{Before@ssect}\Parameter{code}%
  \Macro{Before@sect}\Parameter{code}
\end{Declaration}
As\ChangedAt[2014/09]{v3.15}{\Class{scrbook}\and \Class{scrreprt}\and
  \Class{scrartcl}} already explained in \autoref{sec:maincls.structure} in
the description of the sectioning commands beginning with
\DescPageRef{maincls.cmd.chapter}, \KOMAScript{} provides additional
features for the optional argument of those commands. Therefore, it was
necessary to replace some \LaTeX{} kernel commands, especially 
\Macro{secdef}\IndexCmd{secdef}\important{\Macro{secdef}} and
\Macro{@startsection}\IndexCmd{@startsection}%
\important{\Macro{@startsection}}. The meaning of the parameters of these
commands can be found in the \LaTeX{} kernel manual \cite{latex:source2e}.

Unfortunately these commands are often redefined by other packages in a way
that collides with the functionality of \KOMAScript. So \KOMAScript{} not only
changes the definition of these commands but also defines the additional,
alternative commands \Macro{SecDef} and \Macro{scr@startsection}. Package
authors are permitted to use these commands like they would use the
corresponding \LaTeX{} kernel commands and therefore participate in the
additional features of \KOMAScript. Nevertheless these commands should not be
redefined, because they could be changed in future and so the redefinition would
impair \KOMAScript{} again.

\KOMAScript{} internally uses \Macro{SecDef} and \Macro{scr@startsection}
instead of \Macro{secdef} and \Macro{@startsection}, e.\,g., defining
section-like commands by \DescRef{\LabelBase.cmd.DeclareSectionCommand}. So
later redefinition of \Macro{secdef} or \Macro{@startsection} will not
influence the sectioning commands of \KOMAScript.

As an alternative to the redefinition of such commands, \KOMAScript{} provides
the execution of additional \PName{code} at several states of the
\KOMAScript{} replacements. The \PName{code} of each usage of
\Macro{At@startsection}, \Macro{Before@sect}, or \Macro{Before@ssect} will be
cumulated independently. Later removing of added \PName{code} is not
provided.

The \PName{code} of \Macro{At@startsection} is executed immediately after
the evaluation of \PName{beforeskip} and calculation of the resulting
\Length{@tempskipa}, before adding the vertical gap itself. So you still may
change the value of \Length{@tempskipa}.

The \PName{code} of \Macro{Before@sect} and 
\Macro{Before@ssect} is executed just before \Macro{@sect}
and \Macro{@ssect} inside \Macro{scr@startsection}, respectively. At this state
the vertical gap of \Length{@tempskipa} has already been added using
\Macro{addvspace}.

The commands \Macro{At@startsection}, \Macro{Before@sect}, and
\Macro{Before@ssect} are suggested for package authors.%
%
\EndIndexGroup

% \subsection{Appendix}
% \seclabel{appendix}


\begin{Declaration}
  \Macro{appendixmore}
\end{Declaration}%
There is a peculiarity within the \DescRef{maincls.cmd.appendix} command in
the {\KOMAScript} classes. If the command \Macro{appendixmore} is defined,
this command is executed also by the \DescRef{maincls.cmd.appendix}
command. Internally the {\KOMAScript} classes
\Class{scrbook}\OnlyAt{\Class{scrbook}\and \Class{scrreprt}} and
\Class{scrreprt} take advantage of this behaviour to implement the options
\DescRef{maincls.option.appendixprefix} (see \autoref{sec:maincls.structure},
\DescPageRef{maincls.option.appendixprefix}). You\textnote{Attention!}  should
take note of this in case you decide to define or redefine the macro
\Macro{appendixmore}. In case one of this option has been used, you will
receive an error message when using
\verb|\newcommand{\appendixmore}{|\dots\verb|}|. This behaviour is intended to
prevent you from disabling options without noticing it.

\begin{Example}
  You do not want the chapters in the main part of the classes \Class{scrbook}
  or \Class{scrreprt} to be introduced by a prefix line (see layout options
  \DescRef{maincls.option.chapterprefix} in \autoref{sec:maincls.structure},
  \DescPageRef{maincls.option.chapterprefix}). For consistency you also
  do not want such a line in the appendix either. Instead, you would like to
  see the word ``Chapter'' in the language of your choice written in front of
  the chapter letter and, simultaneously, in the page headings.  Instead of
  using layout option \DescRef{maincls.option.appendixprefix}, you would define in the
  document preamble:
%
\begin{lstcode}
  \newcommand*{\appendixmore}{%
    \renewcommand*{\chapterformat}{%
      \appendixname~\thechapter\autodot\enskip}
    \renewcommand*{\chaptermarkformat}{%
      \appendixname~\thechapter\autodot\enskip}
  }
\end{lstcode}
%  
  In case you subsequently change your mind and decide to use the option
  \DescRef{maincls.option.appendixprefix} at a later stage, you will get an
  error message because of the already defined \Macro{appendixmore} command.
  This behaviour prevents the definition made above from invisibly changing
  the settings intended with the option.
  
  It is also possible to get a similar behaviour of the appendix for
  the class \Class{scrartcl}. You can write in the preamble of your
  document:
\begin{lstcode}[moretexcs={ifthenelse,equal}]
  \newcommand*{\appendixmore}{%
    \renewcommand*{\sectionformat}{%
      \appendixname~\thesection\autodot\enskip}%
    \renewcommand*{\sectionmarkformat}{%
      \appendixname~\thesection\autodot\enskip}}
\end{lstcode}
  
  Redefined commands are explained in more detail in
  \autoref{sec:maincls.structure},
  \DescPageRef{maincls.cmd.chapterformat} and
  \DescPageRef{maincls.cmd.chaptermarkformat}.
\end{Example}
%
\EndIndexGroup


% \subsection{Literaturverzeichnis}
% \seclabel{bibliography}

\begin{Declaration}
  \Macro{newbibstyle}\OParameter{parent style}\Parameter{name}%^^A
  \Parameter{instructions}%
  \Macro{newblock}%
  \Macro{@openbib@code}%
  \Macro{bib@beginhook}%
  \Macro{bib@endhook}
\end{Declaration}
The standard classes\textnote{standard classes} already provide command
\Macro{newblock} for structuring of bibliography entries. The exact purpose of
this command depends on the class options. Using option
\Option{openbib}\important{\Option{openbib}} redefine commands
\Macro{@openbib@code} and \Macro{newblock} at the end of the used standard
class. These classes execute command \Macro{@openbib@code} at the
begin\,---\,or more precise: at the specification of the parameters of
the\,---\,list environment, that will be used for the bibliography. It should
be assumed, that many packages will execute this command in the same kind, if
they redefine the bibliography.

The \KOMAScript{} classes do something similar. Nevertheless, they do not
redefine \Macro{@openbib@code} at the end of the class. Instead of, the
bibliography style \PValue{openstyle} is defined using
\Macro{newbibstyle}. The \PName{instructions}, that has been defined as part
of the implementation, contain the appropriate redefinition of
\Macro{@openbib@code} and \Macro{newblock}. Now, if this bibliography style
will be selected using option
\OptionValueRef{maincls}{bibliography}{openstyle}%
\IndexOption{bibliography~=\PValue{openstyle}}%
\important{\OptionValueRef{maincls}{bibliography}{openstyle}}, then the
\PName{instructions} will be executed immediately. This will redefine
\Macro{@openbib@code} and \Macro{newblock}.

Beside \Macro{@openbib@code} and \Macro{newblock} also \Macro{bib@beginhook}
and \Macro{bib@endhook} may be redefined by the \PName{instructions} of the
style. Command \Macro{bib@beginhook} will be executed immediately after
heading and preamble of the bibliography, but before the begin of the list
with the bibliography entries. Command \Macro{bib@endhook} will be executed
immediately after this list at the end of the bibliography. If
\DescRef{maincls.cmd.BreakBibliography} (see
\autoref{sec:maincls.bibliography},
\DescPageRef{maincls.cmd.BreakBibliography}) intercepts the bibliography,
these commands will also executed at the begin and end of each part of the
bibliography, this would be immediately before and after
\DescRef{maincls.cmd.BreakBibliography}.

The commands \Macro{newblock}, \Macro{@openbib@code}, \Macro{bib@beginhook},
and \Macro{bib@endhook} will be reset to an empty definition at the start of
each new bibliography style. After this the \PName{instructions} of the
\PName{parent style} of the bibliography style will be executed. After this
the \PName{instructions} of the bibliography style itself will be
executed. Because of this these commands has to be defined using
\Macro{renewcommand}\IndexCmd{renewcommand}\important{\Macro{renewcommand}}
not \Macro{newcommand} inside of argument \PName{instructions}.

If the user declares additional \PName{instructions} using
\DescRef{maincls.cmd.AtEndBibliography}%\important[i]{\DescRef{maincls.cmd.AtEndBibliography}\\
%  \DescRef{maincls.cmd.AfterBibliographyPreamble}}% Passt bloeder Weise nicht!
\IndexCmd{AtEndBibliography} and
\DescRef{maincls.cmd.AfterBibliographyPreamble}\IndexCmd{AfterBibliographyPreamble}
to be executed after the preamble or at the end of the bibliography, the
\PName{instructions} of \DescRef{maincls.cmd.AfterBibliographyPreamble} will
be executed only once at the begin of the bibliography but after the
\Macro{bib@beginhook} \PName{instructions}, and the \PName{instructions} of
\DescRef{maincls.cmd.AtEndBibliography} will be executed only once at the end
of the bibliography but before \Macro{bib@endhook}.

Package\textnote{Example!}
\Package{multicol}\IndexPackage{multicol}\important{\Package{multicol}} (see
\cite{package:multicol}) could be used to define a bibliography style for
printing the bibliography with two columns:
% Umbruchkorrektur: listings korrigiert
\begin{lstcode}
  \newbibstyle{twocolumstyle}{%
    \renewcommand*{\bib@beginhook}{\begin{multicols}{2}}%
    \renewcommand*{\bib@endhook}{\end{multicols}}}%
\end{lstcode}
If also an \emph{open}-variation of this style should be defined, one may use
the provided heredity feature and specify a \PName{parent style}:
% Umbruchkorrektur: listings korrigiert
\begin{lstcode}
  \newbibstyle{twocolumopenstyle}[openstyle]{%
    \renewcommand*{\bib@beginhook}{\begin{multicols}{2}}%
    \renewcommand*{\bib@endhook}{\end{multicols}}}%
\end{lstcode}
These new defined styles may be selected using option
\DescRef{maincls.option.bibliography} as usual.%
%
\EndIndexGroup


\section{More or Less Obsolete Options and Commands}
\seclabel{obsolete}

\LoadNonFree{scrbookreportarticle-experts}{4}
%
\EndIndexGroup

\endinput

%%% Local Variables: 
%%% mode: latex
%%% mode: flyspell
%%% ispell-local-dictionary: "english"
%%% coding: us-ascii
%%% TeX-master: "../guide"
%%% End: 

%  LocalWords:  Amongst legitimation