Menu ▾ ▴

HowTo_DeprecatedOptions

Markus Kohm
There is a newer version of this page. You can find it here.

Wie veraltete Optionen zu ersetzen sind

Beim Wechsel von KOMA-Script 2.9u zu KOMA-Script 3 – konkret im Juli 2006 mit KOMA-Script 2.95, das eine Vorabversion von KOMA-Script 3 darstellte – wurden viele Optionen als veraltet deklariert und gleichzeitig durch neue Optionen mit Wertzuweisung (key-value Optionen) ersetzt. Dabei war eigentlich geplant, diese bis zur Veröffentlichung von KOMA-Script 3.00 zu entfernen. Obwohl bis zum Erscheinen im November 2008 eigentlich reichlich Zeit vergangen war, habe ich auf Anwenderbitten damals entschieden, die veralteten Optionen noch einige Zeit weiter zu behalten. Gleichzeitig schaltete deren Verwendung KOMA-Script über Option version=first einen Kompatibilitätsmodus. Gedacht war das ausschließlich für alte Dokumente, die möglichst unverändert bleiben sollte.

Der Wunsch, Dokumente auch nach Jahren noch mit identischem Umbruch zu erhalten, hat sich allerdings als Illusion erwiesen. Zum einen hat die Beseitigung eindeutiger Bugs, das bereits innerhalb von KOMA-Script an einigen Stellen verhindert. Weit mehr sind alte Dokumente aber von Änderungen in anderen Paketen, Schriften und seit spätestens 2018 auch im LaTeX-Kern betroffen. Daher warnen nicht nur die veralteten Optionen seit Jahren sehr deutlich vor ihrer Verwendung. Auch vor der Verwendung von Option version selbst wird seit langem gewarnt.

Da außerdem der Erhalt von veraltetem Code in KOMA-Script zunehmend zu einem Wartungsproblem wurde und die Verwendung von Option version mit neuerem LaTeX-Kern nicht wirklich sinnvoll ist und selbst mit Verwendung eines LaTeX-Rollbacks zu Inkompatibilitäten und weiteren Warnungen führen kann, wurde beschlossen, nach KOMA-Script 3.49.2 und damit rund 20 Jahre nach dem Wechsel zu KOMA-Script 3 die Situation deutlich zu verschärfen und die veralteten Optionen nicht länger zu unterstützen. In der Regel führt das dann zu „Unused global option(s)” Warnungen und gleichzeitig auch dazu, dass die entsprechenden Optionen unbeachtet bleiben.

Wer die Funktionalität dennoch erhalten haben möchte, hatte rund 20 Jahre Zeit, die veralteten Optionen entsprechend der ausgegebenen Warnungen zu ersetzen. Wer das versäumt hat, sei auf die folgende kurze Gegenüberstellung in alphabetischer Reihenfolge verwiesen:

Alt Neu Klasse/Paket (alt oder neu)
<Format>paper paper=<Format> scrartcl, scrbook, scrlttr2, scrreprt, typearea
<Wert>headlines headlines=<Wert> scrartcl, scrbook, scrreprt, typearea
<Wert>pt fontsize=<Wert>pt scrartcl, scrbook, scrlttr2, scrreprt
abstractoff abstract=false scrlttr2
abstracton abstract=true scrlttr2
BCOR<Wert> BCOR=<Wert> scrartcl, scrbook, scrlttr2, scrreprt, typearea
bibtotoc bibliography=totoc scrartcl, scrbook, scrreprt
bibtotocnumberes bibliography=totocnumbered scrartcl, scrbook, scrreprt
bigheadings headings=big scrartcl, scrbook, scrreprt
cleardoubleempty cleardoublepage=empty scrartcl, scrbook, scrlttr2, scrreprt
cleardoubleplain cleardoublepage=plain scrartcl, scrbook, scrlttr2, scrreprt
cleardoublestandard cleardoublepage=current scrartcl, scrbook, scrlttr2, scrreprt
DIVcalc DIV=calc scrartcl, scrbook, scrlttr2, scrreprt, typearea
DIVclassic DIV=classic scrartcl, scrbook, scrlttr2, scrreprt, typearea
DIV<Wert> DIV=<Wert> scrartcl, scrbook, scrlttr2, scrreprt, typearea
footnosepline footsepline=false scrartcl, scrbook, scrlttr2, scrreprt, typearea
halfparskip* parskip=half* scrartcl, scrbook, scrlttr2, scrreprt
halfparskip+ parskip=half+ scrartcl, scrbook, scrlttr2, scrreprt
halfparskip- parskip=half- scrartcl, scrbook, scrlttr2, scrreprt
headexclude headinclude=false scrartcl, scrbook, scrlttr2, scrreprt, typearea
headnosepline headsepline=false scrartcl, scrbook, scrlttr2, scrreprt, typearea
idxtotoc index=totoc scrartcl, scrbook, scrreprt
komastyle pagestyleset=KOMA-Script scrlayer-scrpage
listsindent listof=graduated scrartcl, scrbook, scrreprt
listsleft listof=flat scrartcl, scrbook, scrreprt
liststotoc listof=totoc scrartcl, scrbook, scrreprt
liststotocnumbered listof=numbered scrartcl, scrbook, scrreprt
markuppercase markcase=upper scrlayer-scrpage
markusedcase markcase=uses scrlayer-scrpage
mpexclude mpinclude=false scrartcl, scrbook, scrlttr2, scrreprt, typearea
noappendixprefix appendixprefix=false scrbook, scrreprt
nochapterprefix chapterprefix=false scrbook, scrreprt
noonelinecaption caption=nooneline scrartcl, scrbook, scrreprt
normalheadings headings=normal scrartcl, scrbook, scrreprt
nouppercase markcase=ignoreuppercase scrlayer-scrpage
onelinecaption captions=oneline scrartcl, scrbook, scrreprt
orgdate numericaldate=false scrlttr2
parindent parskip=false scrartcl, scrbook, scrlttr2, scrreprt
parskip* parskip=full* scrartcl, scrbook, scrlttr2, scrreprt
parskip+ parskip=full+ scrartcl, scrbook, scrlttr2, scrreprt
parskip- parskip=full- scrartcl, scrbook, scrlttr2, scrreprt
pointednumbers numbers=enddot scrartcl, scrbook, scrreprt
pointlessnumbers numbers=noenddot scrartcl, scrbook, scrreprt
scrdate numericaldate=true scrlttr2
slocfield locfield=narrow scrlttr2
smallheadings headings=small scrartcl, scrbook, scrreprt
standardstyle pagestyleset=standard scrlayer-scrpage
tablecaptionabove captions=tableheading scrartcl, scrbook, scrreprt
tablecaptionbelow captions=tablesignature scrartcl, scrbook, scrreprt
tocindent toc=graduated scrartcl, scrbook, scrreprt
tocleft toc=flat scrartcl, scrbook, scrreprt
wlocfield locfield=wide scrlttr2

Zu den Option <Format>paper und <Wert>pt ist anzumerken, dass die von den Standardklassen unterstützen Optionen a4paper, a5paper, b5paper, letterpaper, legalpaper, executivepaper, 10pt, 11pt und 12pt zur Erleichterung des Wechsels von einer Standardklasse zu einer KOMA-Script-Klasse auch weiterhin verarbeitet werden.

Selbstverständlich gab es vor KOMA-Script 3 noch kein Paket scrlayer-scrpage. Es gab aber die Vorgängerpakete scrpage und scrpage2. Diese wurden in der Tabelle jedoch nicht mehr aufgeführt, da sich deren Optionen-Schnittstelle nicht mehr geändert haben.

Bei einigen der Optionen wurden die Klassen mit aufgeführt, obwohl die Option inzwischen von Paket typearea verarbeitet wird. Teilweise werden die Optionen aber explizit von den Klassen durchgereicht oder wurden früher direkt von den Klassen verarbeitet.