From dd8cd465b253cee19fa61fc89383c0c61a0791e4 Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Mon, 20 Jun 2016 22:41:14 +0000 Subject: koma-script (20jun16) git-svn-id: svn://tug.org/texlive/trunk@41508 c570f23f-e606-0410-a88d-b1316a301751 --- .../texmf-dist/source/latex/koma-script/ChangeLog | 106 ++ .../doc/english/scrbookreportarticle-experts.tex | 59 +- .../latex/koma-script/doc/english/tocbasic.tex | 90 +- .../doc/ngerman/scrbookreportarticle-experts.tex | 60 +- .../latex/koma-script/doc/ngerman/tocbasic.tex | 83 +- .../source/latex/koma-script/doc/scrguide.html | 702 +++++----- .../source/latex/koma-script/doc/scrguide.pdf | Bin 2795973 -> 2800047 bytes .../source/latex/koma-script/doc/scrguien.html | 1412 ++++++++++---------- .../source/latex/koma-script/doc/scrguien.pdf | Bin 2610199 -> 2612144 bytes .../source/latex/koma-script/scrkernel-basics.dtx | 59 +- .../latex/koma-script/scrkernel-compatibility.dtx | 10 +- .../source/latex/koma-script/scrkernel-floats.dtx | 219 +-- .../latex/koma-script/scrkernel-miscellaneous.dtx | 17 +- .../latex/koma-script/scrkernel-notepaper.dtx | 32 +- .../latex/koma-script/scrkernel-sections.dtx | 67 +- .../latex/koma-script/scrkernel-tocstyle.dtx | 93 +- .../latex/koma-script/scrkernel-typearea.dtx | 11 +- .../source/latex/koma-script/scrkernel-version.dtx | 4 +- .../source/latex/koma-script/tocbasic.dtx | 29 +- 19 files changed, 1760 insertions(+), 1293 deletions(-) (limited to 'Master/texmf-dist/source') diff --git a/Master/texmf-dist/source/latex/koma-script/ChangeLog b/Master/texmf-dist/source/latex/koma-script/ChangeLog index fed09622ba7..ed801d969d8 100644 --- a/Master/texmf-dist/source/latex/koma-script/ChangeLog +++ b/Master/texmf-dist/source/latex/koma-script/ChangeLog @@ -1,3 +1,109 @@ +r2480 2016-06-14 09:45:01 +0200 kohm: + + * doc/, doc/ngerman/, doc/ngerman/scrbookreportarticle-experts.tex, + doc/english/, doc/english/scrbookreportarticle-experts.tex: additional + info about toc… options + +r2479 2016-06-14 09:11:22 +0200 kohm: + + * doc/, doc/ngerman/, doc/ngerman/tocbasic.tex, doc/english/, + doc/english/tocbasic.tex: additional info about tocentry… options + +r2478 2016-06-13 08:53:07 +0200 kohm: + + * doc/, doc/english/, doc/english/tocbasic.tex: Typofixes reported by + Elke + +r2477 2016-06-12 11:52:43 +0200 kohm: + + * TODO, scrkernel-sections.dtx, tocbasic.dtx, doc/, doc/ngerman/, + doc/ngerman/tocbasic.tex, doc/english/, doc/english/tocbasic.tex: + prefix tocentry instead (or additional to) prefix toc + +r2476 2016-06-12 08:32:29 +0200 kohm: + + * scrkernel-sections.dtx: Summary: several page breaks prevented + +r2475 2016-06-09 09:51:01 +0200 kohm: + + * scrkernel-tocstyle.dtx: improved hyperref compatibility + +r2474 2016-06-06 16:41:04 +0200 kohm: + + * scrkernel-tocstyle.dtx: Summary: handle also long \ragged…entry + +r2473 2016-06-06 16:38:21 +0200 kohm: + + * scrkernel-tocstyle.dtx: Summary: Typofix \flushglue + +r2472 2016-06-06 11:12:11 +0200 kohm: + + * doc/, doc/english/, doc/english/tocbasic.tex: new tocline attribute + raggedentrytext + +r2471 2016-06-06 11:02:57 +0200 kohm: + + * scrkernel-tocstyle.dtx, scrkernel-sections.dtx, doc/, doc/ngerman/, + doc/ngerman/tocbasic.tex, + doc/ngerman/scrbookreportarticle-experts.tex, doc/english/, + doc/english/scrbookreportarticle-experts.tex: \raggedchapterentry does + work again via new tocbasic's tocline attribute raggedentrytext + +r2470 2016-06-06 09:06:27 +0200 kohm: + + * scrkernel-sections.dtx: Summary: change entry date fixed + +r2469 2016-06-02 20:07:52 +0200 kohm: + + * doc/, doc/ngerman/, doc/ngerman/tocbasic.tex, doc/english/, + doc/english/tocbasic.tex: feature nobabel clarified + +r2468 2016-05-31 13:27:28 +0200 kohm: + + * scrkernel-floats.dtx: Summary: new implementation of \@@makecaption + +r2467 2016-05-27 20:35:47 +0200 kohm: + + * scrkernel-basics.dtx: Summary: \scr@ifpdforluatex + +r2466 2016-05-27 20:34:55 +0200 kohm: + + * scrkernel-basics.dtx: Summary: typofix + +r2465 2016-05-27 19:15:42 +0200 kohm: + + * scrkernel-basics.dtx: Summary: em, ex and if pdf output of pdftex or + luatex is used also px are units + +r2464 2016-05-27 19:14:11 +0200 kohm: + + * scrkernel-typearea.dtx: Summary: missing \ before pagewidth and + pageheight added + +r2463 2016-05-19 09:27:47 +0200 kohm: + + * scrkernel-miscellaneous.dtx: Summary: + egregdoesnotlikesansseriftitles in scrletter only by class + +r2462 2016-05-19 09:18:47 +0200 kohm: + + * scrkernel-notepaper.dtx, scrkernel-miscellaneous.dtx: + Summary: scrlttr2 provides option egregdoesnotlikesansseriftitles + too + +r2461 2016-05-19 09:17:15 +0200 kohm: + + * scrkernel-version.dtx, scrkernel-compatibility.dtx: prepared for + 3.21 BETA + +r2460 2016-05-10 15:01:58 +0200 kohm: + + * releaselist.txt: release 2016/05/10 v3.20 + +r2459 2016-05-10 15:01:05 +0200 kohm: + + * scrkernel-version.dtx: prepared for 3.20 + r2458 2016-05-10 14:02:52 +0200 kohm: * doc/, doc/ngerman/, doc/ngerman/tocbasic.tex, doc/english/, diff --git a/Master/texmf-dist/source/latex/koma-script/doc/english/scrbookreportarticle-experts.tex b/Master/texmf-dist/source/latex/koma-script/doc/english/scrbookreportarticle-experts.tex index 017c382ab10..f2275d6c8a3 100644 --- a/Master/texmf-dist/source/latex/koma-script/doc/english/scrbookreportarticle-experts.tex +++ b/Master/texmf-dist/source/latex/koma-script/doc/english/scrbookreportarticle-experts.tex @@ -48,13 +48,13 @@ % ============================================================================ \KOMAProvidesFile{scrbookreportarticle-experts.tex} - [$Date: 2016-04-07 09:48:00 +0200 (Thu, 07 Apr 2016) $ + [$Date: 2016-06-14 09:45:01 +0200 (Tue, 14 Jun 2016) $ KOMA-Script guide (chapter: scrbook, scrreprt, scrartcl for experts)] \translator{Gernot Hassenpflug\and Markus Kohm} -% Date of the translated German file: 2016-03-08 +% Date of the translated German file: 2016-06-14 \chapter[{Additional Information about the Main Classes and @@ -223,15 +223,27 @@ arguments through.% \Macro{raggedchapterentry} \end{Declaration} \BeginIndex{Cmd}{raggedchapterentry}% -Command \Macro{raggedchapterentry} currently only provides for printing -chapter entries at the table of contents justified or left-aligned. Default is -an empty definition with justified results. For left-aligned the command has -to be redefined to be -\Macro{raggedright}\important{\Macro{raggedright}}\IndexCmd{raggedright}. See -also the limitation note in \autoref{sec:maincls-experts.coexistence}, -\autopageref{desc:maincls-experts.cmd.raggedsection}. Other definitions are -not recommended!% -% +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.% \EndIndex{Cmd}{raggedchapterentry} % \subsection{Font Settings} @@ -533,8 +545,9 @@ dependent attributes, too. Currently the following styles are provided: may be used. Default is \PValue{false}.\\ \PValue{level} & \PName{integer} & A number, denoting depth of section - (see counter \Counter{secnumdepth}; - \autoref{desc:maincls.counter.secnumdepth}); + (see counter \Counter{secnumdepth}, + \autoref{sec:maincls.structure}, + \autopageref{desc:maincls.counter.secnumdepth}); the value should be unique.\\ \PValue{style} & \PName{name} & Defines the style of the heading.\\ @@ -546,7 +559,25 @@ dependent attributes, too. Currently the following styles are provided: style (see \autoref{sec:tocbasic.tocstyle}). An empty \PName{name} prevents a new - definition of the toc-entry command.\\ + definition of the toc-entry + command.\\ + \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 diff --git a/Master/texmf-dist/source/latex/koma-script/doc/english/tocbasic.tex b/Master/texmf-dist/source/latex/koma-script/doc/english/tocbasic.tex index 6020dd474dd..eb017eee545 100644 --- a/Master/texmf-dist/source/latex/koma-script/doc/english/tocbasic.tex +++ b/Master/texmf-dist/source/latex/koma-script/doc/english/tocbasic.tex @@ -46,10 +46,10 @@ % ====================================================================== \KOMAProvidesFile{tocbasic.tex} - [$Date: 2016-04-23 19:14:01 +0200 (Sat, 23 Apr 2016) $ + [$Date: 2016-06-14 09:11:22 +0200 (Tue, 14 Jun 2016) $ KOMA-Script guide (package tocbasic)] -% Date of translated German file: 2016/04/07 +% Date of translated German file: 2016/06/13 \translator{Markus Kohm\and Arndt Schubert} @@ -633,6 +633,10 @@ single features. \Package{tocbasic} does know following features: \Package{scrwfile}\important{\Package{scrwfile}}\IndexPackage{scrwfile} uses this feature also for clone destinations, because those will get the language change from the clone source already. + + Please note\textnote{Attention!}, the feature is executed while adding a + file extension to the list of known file extension. Changing the feature + afterwards would not have any effect. \item[\texttt{noparskipfake}] prevents\ChangedAt{v3.17}{\Package{tocbasic}} usage of an extra \Length{parskip} before switching \Length{parskip} off. In general, the consequence of this feature for documents using paragraph @@ -967,11 +971,11 @@ Currently, \Package{tocbasic} defines the following entry styles: \PValue{breakafternumber}, \PValue{indent}, \PValue{linefill}, \PValue{numsep}, \PValue{numwidth}, \PValue{onstarthigherlevel}, \PValue{onstartlowerlevel}, \PValue{onstartsamelevel}, - \PValue{pagenumberbox}, \PValue{pagenumberformat}, and - \PValue{raggedpagenumber}. The defaults of all these attributes depend on - the name of the \PName{entry level}. They correspond to the results of the - standard classes. So after loading \Package{tocbasic}, you can change the - style of the standard classes entries to the table of contents into + \PValue{pagenumberbox}, \PValue{pagenumberformat}, \PValue{raggedentrytext}, + and \PValue{raggedpagenumber}. The defaults of all these attributes depend + on the name of the \PName{entry level}. They correspond to the results of + the standard classes. So after loading \Package{tocbasic}, you can change + the style of the standard classes entries to the table of contents into \PValue{tocline} using \Macro{DeclareTOCEntryStyle} without obvious visual changes unless you change exactly these attributes that should induce such changes. Same is valid for list of figures or list of tables of the standard @@ -1188,13 +1192,17 @@ Currently, \Package{tocbasic} defines the following entry styles: \end{description} \hyperref[tab:tocbasic.tocstyle.attributes]% {Table~\ref*{tab:tocbasic.tocstyle.attributes}} describes all attributes of -all styles defined by \Package{tocbasic}. If you want to use these attributes -as options to \Macro{DeclareNewTOC} (see -\autopageref{desc:tocbasic.cmd.DeclareNewTOC}) or -\Macro{DeclareSectionCommand} (see +all styles defined by +\Package{tocbasic}. If\ChangedAt[2016/06]{v3.21}{\Package{tocbasic}} you want +to use these attributes as options to \Macro{DeclareNewTOC} (see +\autopageref{desc:tocbasic.cmd.DeclareNewTOC}) you have to prefix the names of +the attribute by \PValue{tocentry}, e\,g., attribute \PValue{level} becomes +option \Option{tocentrylevel}. +If\ChangedAt[2015/12]{v3.20}{\Package{tocbasic}} you want to use +these attributes as options to \Macro{DeclareSectionCommand} (see \autopageref{desc:maincls-experts.cmd.DeclareSectionCommand}) and similar -commands you have to prefix the names of the attributes by \PValue{toc}, e\,g., -attribute \PValue{level} becomes option \Option{toclevel}. +commands you have to prefix the names of the attributes by \PValue{toc}, +e\,g., attribute \PValue{level} becomes option \Option{toclevel}. Last but not least using \Macro{DeclareTOCStyleEntry} will define internal command \Macro{l@\PName{entry level}}. @@ -1400,7 +1408,17 @@ command \Macro{l@\PName{entry level}}. all other levels prints the argument in \Macro{normalfont}\Macro{normalcolor}.% }% - \entry{\KOption{raggedpagenumber}\PName{switch}}{% + \entry{\KOption{raggedentrytext}\PName{switch}}{% + \ChangedAt{v3.21}{\Package{tocbasic}}% + \PName{switch} is one of the values for simple switches from + \autoref{tab:truefalseswitch}, \autopageref{tab:truefalseswitch}. If the + switch is active, style \PValue{tocline} does print the text of an entry + left-aligned instead of justified and only word, that are longer than a + text line, are automatically hyphenated. + + This switch is not active by default.% + }% + \entry{\KOption{raggedpagenumber}\PName{switch}}{% \PName{switch} is one of the values for simple switches from \autoref{tab:truefalseswitch}, \autopageref{tab:truefalseswitch}. If the switch is active, style \PValue{tocline} does not force the page number to @@ -2038,7 +2056,7 @@ options cannot be set using \Macro{KOMAoptions}\IndexCmd{KOMAoptions}! An overview of all available options may be found in \autoref{tab:tocbasic.DeclareNewTOC-options}. -If\ChangedAt[2016/03]{v3.20}{\Package{tocbasic}} option \Option{tocentrystyle} +If\ChangedAt[2015/12]{v3.20}{\Package{tocbasic}} option \Option{tocentrystyle} is not used, style \PValue{default} will be used. For information about this style see \autoref{sec:tocbasic.tocstyle}. If you do not want to define a command for entries to the list of something, you can use an empty argument, @@ -2046,12 +2064,13 @@ i.\,e., \OptionValue{tocentrystyle}{} or \OptionValue{tocentrystyle}{\PParameter{}}. Nevertheless, this would contain the risk to get a lot of errors while printing that list. -Depending\ChangedAt[2016/03]{v3.20}{\Package{tocbasic}} on the style of the +Depending\ChangedAt[2015/12]{v3.20}{\Package{tocbasic}}% +\ChangedAt[2016/06]{v3.21}{\Package{tocbasic}} on the style of the entries to the list of something, you can setup all valid attributes of the selected style as part of the \PName{options}. To do so you have to prefix the names of the attributes given in \autoref{tab:tocbasic.tocstyle.attributes} from \autopageref{tab:tocbasic.tocstyle.attributes} by prefix -\PValue{toc}. Later changes of the style of the entries can be made using +\PValue{tocentry}. Later changes of the style of the entries can be made using \Macro{DeclareTOCStyleEntry}% \IndexCmd{DeclareTOCStyleEntry}\important{\Macro{DeclareTOCStyleEntry}}. See \autoref{sec:tocbasic.tocstyle}, @@ -2105,35 +2124,40 @@ about the styles.% before.% }% \entry{\KOption{hang}\PName{length}}{% - \ChangedAt{v3.20}{\Package{tocbasic}}% + \ChangedAt[2015/12]{v3.20}{\Package{tocbasic}}% + \ChangedAt[2015/12]{v3.21}{\Package{tocbasic}}% This option is deprecated since \KOMAScript~3.20. Now, the amount of the hanging indent of the entries for that list\index{table of contents>entry} depend on attributes of the TOC-entry style given by option \Option{tocentrystyle}. The styles of \KOMAScript{} provide an attribute \PValue{numwidth}. If the used style has such an attribute, \Macro{DeclareNewTOC} will initialise it with 1.5\Unit{em}. You can change - the real \PName{value} using \KOption{tocnumwidth}\PName{value}. The - \KOMAScript{} classed for example use \OptionValue{tocnumwidth}{2.3em}.% + the real \PName{value} using \KOption{tocentrynumwidth}\PName{value}. The + \KOMAScript{} classed for example use + \OptionValue{tocentrynumwidth}{2.3em}.% }% \entry{\KOption{indent}\PName{length}}{% - \ChangedAt{v3.20}{\Package{tocbasic}}% + \ChangedAt[2015/12]{v3.20}{\Package{tocbasic}}% + \ChangedAt[2015/12]{v3.21}{\Package{tocbasic}}% This option is deprecated since \KOMAScript~3.20. Now, the amount of indenting the entries of that list\index{table of contents>entry} depend on attributes of the TOC-entry style given by option \Option{tocentrystyle}. The styles of \KOMAScript{} provide an attribute \PValue{indent}. If the used style has such an attribute, \Macro{DeclareNewTOC} will initialise it with 1\Unit{em}. You can change - the real \PName{value} using \KOption{tocindent}\PName{value}. The - \KOMAScript{} classed for example use \OptionValue{tocnumwidth}{1.5em}.% + the real \PName{value} using \KOption{tocentryindent}\PName{value}. The + \KOMAScript{} classed for example use + \OptionValue{tocentrynumwidth}{1.5em}.% }% \entry{\KOption{level}\PName{number}}{% - \ChangedAt{v3.20}{\Package{tocbasic}}% + \ChangedAt[2015/12]{v3.20}{\Package{tocbasic}}% + \ChangedAt[2015/12]{v3.21}{\Package{tocbasic}}% This option is deprecated since \KOMAScript~3.20. Now, the level of the entries of that list\index{table of contents>entry} depend on attributes of the TOC-entry style given by option \Option{tocentrystyle}. Nevertheless all styles have an attribute \PValue{level} and \Macro{DeclareNewTOC} initialises it with 1. You can - change the real \PName{value} using \KOption{toclevel}\PName{value}.% + change the real \PName{value} using \KOption{tocentrylevel}\PName{value}.% }% \entry{\KOption{listname}\PName{string}}{% The name of the TOC. If not given the value of \PValue{types} with upper @@ -2153,17 +2177,27 @@ about the styles.% \PValue{float} will be used.% }% \entry{\KOption{tocentrystyle}\PName{TOC-entry style}}{% - \ChangedAt[2016/03]{v3.20}{\Package{tocbasic}}% + \ChangedAt[2015/12]{v3.20}{\Package{tocbasic}}% \PName{TOC-entry style} is the style that should be used for all entries into the TOC corresponding to the \PName{extension}. The name of the entry level is given by option \Option{type}. Additional to the options of this table all attributes of the \PName{TOC-entry style} can be used as options. To do so, you have to prefix the name of such an attribute by \PValue{toc}. For example, you can change the numerical level of the - entries using option \Option{toclevel}. For more information about the - styles and their attributes see \autoref{sec:tocbasic.tocstyle} from + entries using option \Option{tocentrylevel}. For more information about + the styles and their attributes see \autoref{sec:tocbasic.tocstyle} from \autopageref{sec:tocbasic.tocstyle}.% }% + \entry{\KOption{tocentry\PName{style-option}}\PName{value}}{% + \ChangedAt[2015/12]{v3.20}{\Package{tocbasic}}% + Additional options depending on the \PName{TOC-entry style} given by + \Option{tocentrystyle}. 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{style-option}.% + }% \entry{\KOption{type}\PName{string}}{% sets the type of the new declared TOC. The type will be used e.\,g. to defined a \Macro{listof}\PName{string}. If no type is set up the extension diff --git a/Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrbookreportarticle-experts.tex b/Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrbookreportarticle-experts.tex index 4189d709107..2123ff47c17 100644 --- a/Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrbookreportarticle-experts.tex +++ b/Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrbookreportarticle-experts.tex @@ -48,7 +48,7 @@ % ============================================================================ \KOMAProvidesFile{scrbookreportarticle-experts.tex}% - [$Date: 2016-03-08 10:14:05 +0100 (Tue, 08 Mar 2016) $ + [$Date: 2016-06-14 09:45:01 +0200 (Tue, 14 Jun 2016) $ KOMA-Script guide (chapter: scrbook, scrreprt, scrartcl for experts)] @@ -233,17 +233,32 @@ weiter geben.% \Macro{raggedchapterentry} \end{Declaration} \BeginIndex{Cmd}{raggedchapterentry}% -Mit Hilfe von \Macro{raggedchapterentry} besteht lediglich die Möglichkeit, -Kapiteleinträge im Inhaltsverzeichnis statt im voreingestellten Blocksatz im -linksbündigen Flattersatz zu setzen. Dazu ist die Anweisung als -\Macro{raggedright}\important{\Macro{raggedright}}\IndexCmd{raggedright} zu -definieren. Siehe hierzu auch die einschränkenden Hinweise in -\autoref{sec:maincls-experts.coexistence}, -\autopageref{desc:maincls-experts.cmd.raggedsection}. Voreingestellt ist -hingegen die leere Definition. Andere Einstellungen für -\Macro{raggedchapterentry} werden nicht empfohlen und können zu unerwarteten -Ergebnissen führen.% -% +Bei früheren\ChangedAt{v3.21}{\Class{scrbook}\and \Class{scrreprt}} Version +von \KOMAScript{} gab es die Möglichkeit das \Macro{raggedchapterentry} als +\Macro{raggedright} zu definieren, um den Text der Kapiteleinträge ins +Inhaltsverzeichnis im linksbündigen Flattersatz zu setzen. Offiziell existiert +diese Möglichkeit seit \KOMAScript-Version~3.21 nicht mehr. + +Tatsächlich ist aber in \Package{tocbasic}\IndexPackage{tocbasic} Eigenschaft +\PValue{raggedentrytext} für den Stil \PValue{tocline} so definiert, dass sie +das Makro \Macro{ragged\PName{Eintragsebene}entry} entweder auf +\Macro{raggedright} oder auf \Macro{relax} setzt. Bei der Auswertung der +Eigenschaft wird dann getestet, ob das entsprechende Makro entweder +\Macro{raggedright} ist oder als \Macro{raggedright} definiert ist. In beiden +Fällen wird Flattersatz verwendet. In allen anderen Fällen wird kein +Flattersatz verwendet. + +Da auch früher schon dokumentiert war, dass \Macro{raggedchapterentry} nicht +als etwas anderes als \Macro{raggedright} definiert werden sollte, ist damit +Kompatibilität zum dokumentierten Verhalten früherer Versionen erreicht. Wie +in früheren Versionen gewarnt, führen andere Definitionen von +\Macro{raggedchaperentry} -- nun aber auch von \Macro{raggedsectionentry} und +entsprechend für die anderen Eintragsebenen -- eventuell zu unerwarteten +Ergebnissen. + +Empfohlen wird, eventuell gewünschten Flattersatz für Verzeichniseinträge +stattdessen über die genannte Eigenschaft des Verzeichniseintragsstils +\PValue{tocline} zu wählen.% \EndIndex{Cmd}{raggedchapterentry} @@ -573,8 +588,9 @@ folgenden Stile zur Verf verstanden.\\ \PValue{level} & \PName{Ganzzahl} & Nummerischer Wert der Gliederungsebene (siehe Zähler - \Counter{secnumdepth}; - \autoref{desc:maincls.counter.secnumdepth}); + \Counter{secnumdepth}, + \autoref{sec:maincls.structure}, + \autopageref{desc:maincls.counter.secnumdepth}); der Wert sollte eindeutig sein. \\ \PValue{style} & \PName{Name} & Legt den Stil der Überschriften fest.\\ @@ -589,6 +605,22 @@ folgenden Stile zur Verf \PName{Name} verhindert die Definition des Befehls für Verzeichniseinträge.\\ + \ChangedAt[2016/03]{v3.20}{\Class{scrbook}\and \Class{scrreprt}\and + \Class{scrartcl}}% + \PValue{toc\PName{Option}} & \PName{Wert} + & Weitere Optionen in Abhängigkeit vom + via \Option{tocstyle} gewählten + Verzeichniseintragsstil. Siehe dazu + \autoref{sec:tocbasic.tocstyle} ab + \autopageref{sec:tocbasic.tocstyle}. + Für die von \Package{tocbasic} + vordefinierten + Verzeichniseintragsstile finden sich + die als \PName{Option} verwendbaren + Attribute in + \autoref{tab:tocbasic.tocstyle.attributes}, + ab + \autopageref{tab:tocbasic.tocstyle.attributes}.\\ % \PValue{tocindent} & \PName{Länge} & Der horizontale Einzug des zum % Gliederungsbefehls gehörenden % Eintrags ins Inhaltsverzeichnis, diff --git a/Master/texmf-dist/source/latex/koma-script/doc/ngerman/tocbasic.tex b/Master/texmf-dist/source/latex/koma-script/doc/ngerman/tocbasic.tex index a71fe1e3483..b3dd2fd031e 100644 --- a/Master/texmf-dist/source/latex/koma-script/doc/ngerman/tocbasic.tex +++ b/Master/texmf-dist/source/latex/koma-script/doc/ngerman/tocbasic.tex @@ -46,7 +46,7 @@ % ====================================================================== \KOMAProvidesFile{tocbasic.tex} - [$Date: 2016-05-10 14:02:52 +0200 (Tue, 10 May 2016) $ + [$Date: 2016-06-14 09:11:22 +0200 (Tue, 14 Jun 2016) $ KOMA-Script guide (package tocbasic)] \chapter{Verzeichnisse verwalten mit Hilfe von \Package{tocbasic}} @@ -705,6 +705,10 @@ getrennte Aneinanderreihung von \PName{Eigenschaften}. Das Paket \Package{scrwfile}\important{\Package{scrwfile}}\IndexPackage{scrwfile} für Klonziele verwendet, da die Erweiterungen dort bereits durch das Klonen selbst aus der Klonquelle übernommen werden. + + Es ist zu beachten\textnote{Achtung!}, dass die Eigenschaft bereits vor dem + Hinzufügen der Dateierweiterung zu der Liste der bekannten + Dateierweiterungen gesetzt sein muss, damit sie eine Wirkung hat. \item[\PValue{noparskipfake}] verhindert\ChangedAt{v3.17}{\Package{tocbasic}}, dass vor dem Abschalten des Absatzabstandes für die Verzeichnisse ein letztes Mal ein expliziter Absatzabstand eingefügt wird. Dies führt in der @@ -1061,8 +1065,8 @@ Derzeit werden von \Package{tocbasic} die folgenden Eintragsstile definiert: \PValue{breakafternumber}, \PValue{indent}, \PValue{linefill}, \PValue{numsep}, \PValue{numwidth}, \PValue{onstarthigherlevel}, \PValue{onstartlowerlevel}, \PValue{onstartsamelevel}, - \PValue{pagenumberbox}, \PValue{pagenumberformat} und - \PValue{raggedpagenumber}. Die Voreinstellungen all dieser Eigenschaften + \PValue{pagenumberbox}, \PValue{pagenumberformat}, \PValue{raggedentrytext} + und \PValue{raggedpagenumber}. Die Voreinstellungen all dieser Eigenschaften werden abhängig vom Namen der \PName{Eintragsebene} bestimmt und orientieren sich dann an den Ergebnissen der Standardklassen. Es ist daher möglich, nach Laden von \Package{tocbasic} den Stil der Inhaltsverzeichniseinträge der @@ -1279,10 +1283,14 @@ Derzeit werden von \Package{tocbasic} die folgenden Eintragsstile definiert: \end{figure} \end{description} Eine Erklärung zu den Eigenschaften der von \Package{tocbasic} definierten -Stile findet sich in \autoref{tab:tocbasic.tocstyle.attributes}. Bei -Verwendung der Eigenschaften als Optionen für \Macro{DeclareNewTOC} (siehe -\autopageref{desc:tocbasic.cmd.DeclareNewTOC}) oder -\Macro{DeclareSectionCommand} (siehe +Stile findet sich in \autoref{tab:tocbasic.tocstyle.attributes}. +Bei\ChangedAt[2016/06]{v3.21}{\Package{tocbasic}} Verwendung der Eigenschaften +als Optionen für \Macro{DeclareNewTOC} (siehe +\autopageref{desc:tocbasic.cmd.DeclareNewTOC}) sind die Namen der +Eigenschaften mit dem Präfix \PValue{tocentry}, also beispielsweise +\Option{tocentrylevel} an Stelle von \PValue{level} zu +verwenden. Bei\ChangedAt[2015/12]{v3.20}{\Package{tocbasic}} Verwendung als +Optionen für \Macro{DeclareSectionCommand} (siehe \autopageref{desc:maincls-experts.cmd.DeclareSectionCommand}) und verwandten Anweisungen sind die Namen der Eigenschaften mit dem Präfix \PValue{toc} zu versehen, also beispielsweise \Option{toclevel} an Stelle von \PValue{level} @@ -1529,6 +1537,16 @@ Anweisung \Macro{l@\PName{Eintragsebene}}. \Macro{large}\Macro{bfseries}. Für alle anderen Ebenen erfolgt die Ausgabe in \Macro{normalfont}\Macro{normalcolor}.% }% + \entry{\KOption{raggedentrytext}\PName{Schalter}}{% + \ChangedAt{v3.21}{\Package{tocbasic}}% + \PName{Schalter} ist einer der Werte für einfache Schalter aus + \autoref{tab:truefalseswitch}, \autopageref{tab:truefalseswitch}. + Ist der Schalter beim Stil \PValue{tocline} aktiviert, so wird der Text + des Eintrags nicht im Blocksatz, sondern im Flattersatz gesetzt. Dabei + werden nur noch Wörter getrennt, die länger als eine Zeile sind. + + In der Voreinstellung ist dieser Schalter nicht gesetzt.% + }% \entry{\KOption{raggedpagenumber}\PName{Schalter}}{% \PName{Schalter} ist einer der Werte für einfache Schalter aus \autoref{tab:truefalseswitch}, \autopageref{tab:truefalseswitch}. @@ -2241,7 +2259,7 @@ Optionen\textnote{Achtung!} k die möglichen Optionen bietet \autoref{tab:tocbasic.DeclareNewTOC-options} ab \autopageref{tab:tocbasic.DeclareNewTOC-options}. -Wird\ChangedAt[2016/03]{v3.20}{\Package{tocbasic}} Option +Wird\ChangedAt[2015/12]{v3.20}{\Package{tocbasic}} Option \Option{tocentrystyle} nicht gesetzt, so wird bei Bedarf der Stil \PValue{default} verwendet. Näheres zu diesem Stil ist \autoref{sec:tocbasic.tocstyle} zu entnehmen. Soll kein Befehl für @@ -2251,12 +2269,12 @@ wahlweise \OptionValue{tocentrystyle}{} oder allerdings das Risiko, dass bei Ausgabe des entsprechenden Verzeichnisses diverse Fehler gemeldet werden. -Abhängig\ChangedAt[2016/03]{v3.20}{\Package{tocbasic}} vom Stil der +Abhängig\ChangedAt[2016/06]{v3.21}{\Package{tocbasic}} vom Stil der Verzeichniseinträge können auch alle für diesen Stil gültigen Eigenschaften gesetzt werden, indem die entsprechenden in \autoref{tab:tocbasic.tocstyle.attributes} ab \autopageref{tab:tocbasic.tocstyle.attributes} aufgeführten Namen mit dem -Präfix \PValue{toc} versehen in der \PName{Optionenliste} angegeben +Präfix \PValue{tocentry} versehen in der \PName{Optionenliste} angegeben werden. Nachträgliche Änderungen am Stil sind mit \Macro{DeclareTOCStyleEntry}% \IndexCmd{DeclareTOCStyleEntry}\important{\Macro{DeclareTOCStyleEntry}} @@ -2428,41 +2446,44 @@ jederzeit m \entry{\Option{forcenames}}{% Siehe Option \Option{name} und \Option{listname}.}% \entry{\KOption{hang}\PName{Einzug}}{% - \ChangedAt{v3.20}{\Package{tocbasic}}% + \ChangedAt[2015/12]{v3.20}{\Package{tocbasic}}% + \ChangedAt[2015/12]{v3.21}{\Package{tocbasic}}% Diese Option gilt seit \KOMAScript~3.20 als überholt. Die Breite der Nummer des Verzeichniseintrags\index{Verzeichnis>Eintrag} ist nun stattdessen als Eigenschaft in Abhängigkeit des Verzeichniseintragsstils von Option \Option{tocentrystyle} anzugeben. Bei den Stilen von \KOMAScript{} wäre das beispielsweise die Eigenschaft \PValue{numwidth} - und damit Option \Option{tocnumwidth}. Besitzt ein Stil diese Eigenschaft, - so wird sie von \Macro{DeclareNewTOC} mit 1,5\Unit{em} + und damit Option \Option{tocentrynumwidth}. Besitzt ein Stil diese + Eigenschaft, so wird sie von \Macro{DeclareNewTOC} mit 1,5\Unit{em} voreingestellt. Diese Voreinstellung kann durch explizite Angabe von - \KOption{tocnumwidth}\PName{Wert} leicht mit einem anderen \PName{Wert} - überschrieben werden. Für Abbildungen verwenden die \KOMAScript-Klassen - beispielsweise den \PName{Wert} \PValue{2.3em}.}% + \KOption{tocentrynumwidth}\PName{Wert} leicht mit einem anderen + \PName{Wert} überschrieben werden. Für Abbildungen verwenden die + \KOMAScript-Klassen beispielsweise den \PName{Wert} \PValue{2.3em}.}% \entry{\KOption{indent}\PName{Einzug}}{% - \ChangedAt{v3.20}{\Package{tocbasic}}% + \ChangedAt[2015/12]{v3.20}{\Package{tocbasic}}% + \ChangedAt[2015/12]{v3.21}{\Package{tocbasic}}% Diese Option gilt seit \KOMAScript~3.20 als überholt. Der Einzug des Verzeichniseintrags\index{Verzeichnis>Eintrag} von links ist nun stattdessen als Eigenschaft in Abhängigkeit des Verzeichniseintragsstils von Option \Option{tocentrystyle} anzugeben. Bei den Stilen von \KOMAScript{} wäre das beispielsweise die Eigenschaft \PValue{indent} und - damit Option \Option{tocindent}. Besitzt ein Stil diese Eigenschaft, so - wird sie von \Macro{DeclareNewTOC} mit 1\Unit{em} voreingestellt. Diese + damit Option \Option{tocentryindent}. Besitzt ein Stil diese Eigenschaft, + so wird sie von \Macro{DeclareNewTOC} mit 1\Unit{em} voreingestellt. Diese Voreinstellung kann durch explizite Angabe von - \KOption{tocindent}\PName{Wert} leicht mit einem anderen \PName{Wert} + \KOption{tocentryindent}\PName{Wert} leicht mit einem anderen \PName{Wert} überschrieben werden. Für Abbildungen verwenden die \KOMAScript-Klassen beispielsweise den \PName{Wert} \PValue{1.5em}.}% \entry{\KOption{level}\PName{Gliederungsebene}}{% - \ChangedAt{v3.20}{\Package{tocbasic}}% + \ChangedAt[2015/12]{v3.20}{\Package{tocbasic}}% + \ChangedAt[2015/12]{v3.21}{\Package{tocbasic}}% Diese Option gilt seit \KOMAScript~3.20 als überholt. Der nummerische Wert der Ebene des Verzeichniseintrags\index{Verzeichnis>Eintrag} ist nun stattdessen als Eigenschaft in Abhängigkeit des Verzeichniseintragsstils von Option \Option{tocentrystyle} anzugeben. Nichts desto trotz haben alle Stile die Eigenschaft \PValue{level} und damit Option - \Option{toclevel}. Die Eigenschaft wird von \Macro{DeclareNewTOC} mit 1 - voreingestellt. Diese Voreinstellung kann durch explizite Angabe von - \KOption{toclevel}\PName{Wert} leicht mit einem anderen \PName{Wert} + \Option{tocentrylevel}. Die Eigenschaft wird von \Macro{DeclareNewTOC} mit + 1 voreingestellt. Diese Voreinstellung kann durch explizite Angabe von + \KOption{tocentrylevel}\PName{Wert} leicht mit einem anderen \PName{Wert} überschrieben werden.}% \entry{\KOption{listname}\PName{Verzeichnistitel}}{% Jedes Verzeichnis hat eine Überschrift, die durch diese Option bestimmt @@ -2499,16 +2520,26 @@ jederzeit m den auch die \KOMAScript-Klassen für das Abbildungs- und das Tabellenverzeichnis verwenden.}% \entry{\KOption{tocentrystyle}\PName{Eintragsstil}}{% - \ChangedAt[2016/03]{v3.20}{\Package{tocbasic}}% + \ChangedAt[2015/12]{v3.20}{\Package{tocbasic}}% \PName{Eintragsstil} gibt den Stil an, den Einträge in das entsprechende Verzeichnis haben sollen. Der Name der Eintragsebene wird dabei über Option \Option{type} bestimmt. Zusätzlich zu den Optionen dieser Tabelle können auch alle Eigenschaften des Stils als Optionen angegeben werden, indem die Namen der Eigenschaften mit dem Präfix \PValue{toc} ergänzt werden. So kann der nummerische Wert der Ebene beispielsweise als - \Option{toclevel} angegeben werden. Näheres zu den Stilen ist + \Option{tocentrylevel} angegeben werden. Näheres zu den Stilen ist \autoref{sec:tocbasic.tocstyle} ab \autopageref{sec:tocbasic.tocstyle} zu entnehmen.}% + \entry{\KOption{tocentry\PName{Stiloption}}\PName{Wert}}{% + \ChangedAt[2015/12]{v3.20}{\Package{tocbasic}}% + Weitere Optionen in Abhängigkeit vom via \Option{tocentrystyle} gewählten + \PName{Eintragsstil}. Siehe dazu \autoref{sec:tocbasic.tocstyle} ab + \autopageref{sec:tocbasic.tocstyle}. Für die von \Package{tocbasic} + vordefinierten Verzeichniseintragsstile finden sich die als + \PName{Stiloption} verwendbaren Attribute in + \autoref{tab:tocbasic.tocstyle.attributes}, ab + \autopageref{tab:tocbasic.tocstyle.attributes}.% + }% \entry{\KOption{type}\PName{Eintragstyp}}{% \PName{Eintragstyp} gibt den Typ der Einträge in das entsprechende Verzeichnis an. Der Typ wird auch als Basisname für verschiedene Makros diff --git a/Master/texmf-dist/source/latex/koma-script/doc/scrguide.html b/Master/texmf-dist/source/latex/koma-script/doc/scrguide.html index 7fcea465d6c..ba1f7cb7bd9 100644 --- a/Master/texmf-dist/source/latex/koma-script/doc/scrguide.html +++ b/Master/texmf-dist/source/latex/koma-script/doc/scrguide.html @@ -17,10 +17,10 @@
  • adrFreeIVstop --> 261
  • adrFreeIVwarn --> 261
  • appendixprefix --> 95
  • -
  • autoclearnotecolumns --> 423
  • +
  • autoclearnotecolumns --> 424
  • automark --> 240
  • autooneside --> 240
  • -
  • autoremoveinterfaces --> 399
  • +
  • autoremoveinterfaces --> 400
  • backaddress --> 191
  • bibliography --> 149
  • captions --> 129
  • @@ -31,33 +31,33 @@
  • cleardoublepage --> 87
  • clines --> 251
  • contract --> 269
  • -
  • deactivatepagestylelayers --> 392
  • -
  • draft --> 396, 56
  • +
  • deactivatepagestylelayers --> 393
  • +
  • draft --> 397, 56
  • enlargefirstpage --> 179
  • extendedfeature --> 265
  • -
  • firstfoot --> 204
  • +
  • firstfoot --> 205
  • firsthead --> 180
  • fleqn --> 128
  • foldmarks --> 178
  • fontsize --> 171, 57
  • footbotline --> 249
  • footnotes --> 89
  • -
  • footsepline --> 208, 249, 81
  • +
  • footsepline --> 207, 249, 81
  • footwidth --> 248
  • -
  • forceoverwrite --> 399
  • +
  • forceoverwrite --> 400
  • fromalign --> 180
  • fromemail --> 185
  • fromfax --> 185
  • -
  • fromlogo --> 189
  • +
  • fromlogo --> 190
  • frommobilephone --> 185
  • fromphone --> 185
  • fromrule --> 181
  • fromurl --> 185
  • headings --> 97
  • -
  • headsepline --> 208, 249, 81
  • +
  • headsepline --> 207, 249, 81
  • headtopline --> 249
  • headwidth --> 248
  • -
  • hmode --> 412
  • +
  • hmode --> 413
  • ilines --> 251
  • index --> 152
  • internalonly --> 289
  • @@ -74,16 +74,16 @@
  • numbers --> 99
  • numericaldate --> 197
  • olines --> 251
  • -
  • onpsbackground --> 391
  • -
  • onpsevenpage --> 391
  • -
  • onpsfloatpage --> 391
  • -
  • onpsforeground --> 391
  • -
  • onpsinit --> 391
  • -
  • onpsnonfloatpage --> 391
  • -
  • onpsoddpage --> 391
  • -
  • onpsoneside --> 391
  • -
  • onpsselect --> 391
  • -
  • onpstwoside --> 391
  • +
  • onpsbackground --> 392
  • +
  • onpsevenpage --> 392
  • +
  • onpsfloatpage --> 392
  • +
  • onpsforeground --> 392
  • +
  • onpsinit --> 392
  • +
  • onpsnonfloatpage --> 392
  • +
  • onpsoddpage --> 392
  • +
  • onpsoneside --> 392
  • +
  • onpsselect --> 392
  • +
  • onpstwoside --> 392
  • open --> 95
  • origlongtable --> 143
  • pagenumber --> 208
  • @@ -105,30 +105,30 @@
  • titlepage --> 65
  • toc --> 72
  • version --> 33
  • -
  • visualize --> 473
  • +
  • visualize --> 474
  • Anweisungen

    Umgebungen

    Pseudolängen

    Variablen

    Seitenstile