diff options
Diffstat (limited to 'Master/texmf-dist/source/latex/koma-script/doc/english/preface.tex')
-rw-r--r-- | Master/texmf-dist/source/latex/koma-script/doc/english/preface.tex | 92 |
1 files changed, 73 insertions, 19 deletions
diff --git a/Master/texmf-dist/source/latex/koma-script/doc/english/preface.tex b/Master/texmf-dist/source/latex/koma-script/doc/english/preface.tex index 3047b682368..873f3039879 100644 --- a/Master/texmf-dist/source/latex/koma-script/doc/english/preface.tex +++ b/Master/texmf-dist/source/latex/koma-script/doc/english/preface.tex @@ -1,6 +1,6 @@ % ====================================================================== % preface.tex -% Copyright (c) Markus Kohm, 2008-2017 +% Copyright (c) Markus Kohm, 2008-2018 % % This file is part of the LaTeX2e KOMA-Script bundle. % @@ -18,7 +18,7 @@ % This work consists of all files listed in manifest.txt. % ---------------------------------------------------------------------- % preface.tex -% Copyright (c) Markus Kohm, 2008-2017 +% Copyright (c) Markus Kohm, 2008-2018 % % Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz, % Version 1.3c, verteilt und/oder veraendert werden. @@ -36,28 +36,82 @@ % ====================================================================== \KOMAProvidesFile{preface.tex} - [$Date: 2017-01-16 07:48:29 +0100 (Mon, 16 Jan 2017) $ - Preface to the KOMA-Script book] -%\translator{Markus Kohm} + [$Date: 2018-03-28 11:44:09 +0200 (Wed, 28 Mar 2018) $ + Preface to version 3.25] +\translator{Markus Kohm\and Karl Hagen} -% Date of the translated German file: 2017-01-02 +% Date of the translated German file: 2018-03-12 -\addchap{Preface to the English \KOMAScript{} Guide} +\addchap{Preface to \KOMAScript~3.25} -The translation of the German \KOMAScript{} guide is still a work in progress -and a never ending story. I always try to have an English user guide with all -descriptions of the German one. But as long as I have to do the primary -translation, these translations not only can but should be improved. +The \KOMAScript~3.25 manual,\---\,especially the German version\,---\,once +again benefits from the fact that a new edition of the print version +\cite{book:komascript} and the eBook version \cite{ebook:komascript} will be +published at almost the same time as this version. This has led to many +improvements which also affect the free manual, in both the German and the +English version. -The translation of \autoref{cha:tocbasic} has still an example in German. A -proficient English speaker with basic TeX knowledge could improve the -translation. A large part of \autoref{cha:scrjura} has been translated by -Alexander Willand. The remaining part may need improvement. +One of these improvements is the linking to the explanations of commands, +environments, options, etc., within the manual. To avoid the temptation to +jump to the beginning of the explanation within the explanation itself, and +so to avoid reading recursively, as it were, these links only take effect +if they actually lead away from the current location. -So this English guide is complete but nevertheless not as good as the German -one. Currently there are only a few editors for the English guide, who improve -my translation for free. Many thanks to them for their very good job! -Nevertheless, additional editors or translators would be welcome! +Another important improvement to the English guide has been accomplished by +Karl Hagen, who has newly translated the entire manual. Many, many thanks to +him! Additional editors or translators, however, would still be welcome! + +\iffree{Readers of this free, screen version, however, still have to live with + some restrictions. So some information\,---\,mainly intended for advanced + users or capable of turning an ordinary user into an advanced one\,---\,is + reserved for the printed book, which currently exists only in German. As a + result, some links in this manual lead to a page that simply mentions this + fact. In addition, the free version is scarcely suitable for making a + hard-copy. The focus, instead, is on using it on screen, in parallel with + the document you are working on. It still has no optimized wrapping but is + almost a first draft, in which both the paragraph and page breaks are in + some cases quite poor. Corresponding optimizations are reserved for the + German book editions.}{} + +It is not just about the manual that I now receive little criticism. For the +classes and packages as well, there are hardly any requests for new features. +For me, this means that my knowledge about user desires stagnates. So for a +few years, I mostly implemented things that I thought could be useful. +However, the feedback that I have received about these new possibilities was +largely limited to complaints that old \emph{hacks} based on undocumented +\KOMAScript{} features sometimes no longer work. Little was said about the +happiness that such dirty workarounds were no longer necessary. Therefore, I +have decided to limit extensions and improvements to \KOMAScript{} more and +more to those things that are explicitly requested by users. Could it be that +\KOMAScript{}, after only 25 years, has reached the level that it fulfils all +desires? + +Unfortunately, the declining number of error reports is not purely gratifying. +Over this period, I have often observed that those who discover a problem no +longer report it directly to me but work around it with the help of some +Internet forums. Often, there are more or less ingenious workarounds in these +forums. Although this is generally helpful, it unfortunately, as a rule, +causes the problem to remain unreported and therefore never really eliminated. +It goes without saying that such workarounds can sometimes become a problem +themselves, as mentioned in the previous paragraph. + +Thankfully, there are third parties who occasionally point out such issues. +This applies to individual contributions in a very few forums. Direct contact +with the person for whom the problem occurred is in this case usually not +possible, although it would sometimes be desirable. + +Therefore, let me please ask again explicitly that you report all suspected +bugs directly, either in German or in English. Linguistic perfection is less +important. The message should be reasonably understandable and the problem +comprehensible. A code example that is as short as possible is generally +independent of the language used. With direct contact, I can ask further +questions, if necessary. Please do not rely on anyone else to report the +problem at some point. Assume that it will only be fixed if you report it +yourself. More about error messages can be found in the first chapter of the +manual. + +\bigskip\noindent +Markus Kohm, Neckarhausen in the March rain, 2018. \endinput |