diff options
Diffstat (limited to 'Master/texmf-dist/source/latex/koma-script/scrguide/english/introduc.tex')
-rw-r--r-- | Master/texmf-dist/source/latex/koma-script/scrguide/english/introduc.tex | 246 |
1 files changed, 246 insertions, 0 deletions
diff --git a/Master/texmf-dist/source/latex/koma-script/scrguide/english/introduc.tex b/Master/texmf-dist/source/latex/koma-script/scrguide/english/introduc.tex new file mode 100644 index 00000000000..a679d94a798 --- /dev/null +++ b/Master/texmf-dist/source/latex/koma-script/scrguide/english/introduc.tex @@ -0,0 +1,246 @@ +\ProvidesFile{introduc.tex}[2004/09/13 KOMA-Script Manual] +% ============================================================================ +% introduct.tex +% Copyright (c) 2002 Markus Kohm and the authors. +% +% This file is part of the LaTeX2e KOMA-Script-Bundle +% +% This file can be redistributed and/or modified under the terms of the LaTeX +% Project Public License Version 1.0 distributed together with this file. See +% LEGAL.TXT or LEGALDE.TXT. +% +% This bundle is written specialy for use at german-language. So the main +% documentation is german. There may also be an english documentation. See +% readme.txt, if you search for it. +% ---------------------------------------------------------------------------- +% introduct.tex +% Copyright (c) 2002 Markus Kohm und bei die weiteren Autoren. +% +% Diese Datei ist Teil des LaTeX2e KOMA-Script-Pakets. +% +% Diese Datei kann nach den Regeln der LaTeX Project Public Licence +% Version 1.0, wie sie zusammen mit dieser Datei verteilt wird, +% weiterverbreitet und/oder modifiziert werden. Siehe dazu auch LEGAL.TXT oder +% LEGALDE.TXT. +% +% Dieses Paket ist fuer den deutschen Sprachraum konzipiert. Daher ist auch +% diese Anleitung komplett in Deutsch. Moeglicherweise existiert auch eine +% englische Version der Anleitung. Falls Sie eine solche benoetigen, schauen +% Sie bitte in liesmich.txt nach, ob eine solche vorhanden ist. +% ============================================================================ +% +% Module: Introduction +% Translation by: Markus Kohm (MJK) <markus.kohm@gmx.de> +% Contents: The introduction to the manual +% Language: English +% Charset of comments: US-ASCII +% Translation of german file: einleit.tex +% Date of translated german file: 2002-05-27 +% + +\chapter{Introduction} +\label{cha:introduction} + +\section{Preface}\label{sec:introduction.preface} + +{\KOMAScript} is a very complex bundle. You may see this, because it +is not only one class or one package but a bundle of many classes and +packages. The classes are counterparts to the standard classes (see +\autoref{cha:maincls}) but never they come with only the same +commands, environments, options and optional possibilities like the +standard classes nor they result in the same look-a-like. More about +the history of \KOMAScript{} you will find at +\autoref{sec:introduction.history}. + +\KOMAScript{} comes with a lot of classes, packages, commands, +environments and possibilities. Some of these you may find also at the +standard classes, many of them you wouldn't. Some are even supplements to +the \LaTeX{} kernel. + +Because of all this \KOMAScript{} manual has to be large. Also there's +no school for \KOMAScript. So there's no teacher knowing everyone of +his students. Such a teacher should be able to change the lessons +dependent on the kind of students he has to teach. It would be easy to +write a manual which is good for one kind of a reader. But it is nearly +impossible to write a manual which is good for every reader. Never the +less the authors tried to do so. The result must be a +compromise. Please remebers this, if you don't like the manual or +parts of it, before you'll write a report about. We hope the +compromise is a good one. Never the less, if you have solutions of +improvements write us. + +If you habe any problem with \KOMAScript{} please read the manual +despite the size of it. Apart from the guide this means also all the +other text files of the bundle. You will find a list of these as +\File{readme.txt}. + + +\section{Structure of the Manual}\label{sec:introduction.structure} + +There's only less information for \LaTeX{} beginners at the guide. +Beginners should first read documents like \cite{lshort} or +\cite{latex:usrguide}. It would also be good to read a book about +\LaTeX. You'll find literature at almost every faq like \cite{UK:FAQ}. +You should also have a look to these faqs, if you have a problem with +\LaTeX{}. + +\begin{Explain} + Informations about understanding \LaTeX{} or \KOMAScript{} are + written like this paragraph. You do not need this informations to + use \KOMAScript{}, but if you have problems in using \KOMAScript you + should read this parts too. So read them before writing a bug + report. +\end{Explain} + +Some of you do not want to read the whole guide but only informations +about one class or package. This should be possible, because you will +find almost all informations about one package or one class at one +chapter. Only the three main classes are described together at one +chapter, because most informations about are valid for all of them. If +something is only valid for one or two of the three you will find a +note at the margin. If for example something is only valid for +\Class{scrartcl}\OnlyAt{\Class{scrartcl}} this is marked at the +margin like here. + + +\section{History of \KOMAScript}\label{sec:introduction.history} + +\begin{Explain} + At the early 90th Frank Neukam has to write a student script. At + that time \LaTeX2.09 was \LaTeX. At \LaTeX2.09 classes and packages + has been all the same and where called \emph{styles}. Frank thought + the standard document styles not to be good enough for his work. He + needed more and other commands and environments. + + At the same time Frank was very interested in typography. After + reading \cite{JTsch87} he decided to write his own document style + not only to write the one script but also to have a style family + especialy for european and german typography. \Script{} was born. + + I, Markus Kohm, found {\Script} at december 1992. While Frank used + A4 paper format, I often had to use A5. At 1992/1993 the standard + styles and \Script{} had no options for A5 paper. So I`ve changed + \Script{}. These and other changes where also found at \ScriptII{} + released by Frank at december 1993. + + At the middle of 1994 \LaTeXe{} could be found at CTAN. Most users + of \ScriptII{} not only wanted to use these styles at compatibility + mode of \LaTeXe{} but have a native \LaTeXe{} \Script{} --- me too. + So I have made new \LaTeXe{} classes a first package and released all + together named \KOMAScript{} at july~7th~1994. Some month later + Frank declared \KOMAScript{} to be the new \Script. At this time + there was no letter class at \KOMAScript{}. Axel Kielhorn wrote it + and so since december~1994 it is part of \KOMAScript{}. Some time + later Axel Sommerfeldt has written the first real scrguide. The + old english scrguide was made by Werner Lemberg. + + A lot of time is gone. There where minor changes at \LaTeX{} but a + lot of changes at the surroundings. There are many new packages and + classes. \KOMAScript{} isn't the \KOMAScript{} from 1994, it's much + more. While it was first made to have good classes for german + authors, now it made to have classes with more flexibility than the + standard classes. I've got a lot email from all over the + world. Because of this I've written lots of new macros. They all + needs documentation. Some day we needed simply a new scrguide. +\end{Explain} + +This new scrguide is not only made for A5 paper. Because of the +history the implementation is german. The primary documentation is in +german too. Maybe this isn't easy to understand. But see: Almost +everything around \LaTeX{} is english. \KOMAScript{} is german. But +don't worry, the commands, environments, options etc. are +english. Sometimes my english was not good enough to find the correct +english name, never the less I tried. As result you'll find options +called \Option{pointlessnumbers} which means only ``numbers without +dot at the end'' and should be called e.g.\ \Option{dotlessnumbers}. + + +\section{Thanks}\label{sec:introduction.thanks} + +In fact the thanks-giving is part of the addendum, but my thanks +are not primarily for the authors of this guide. +These thanks should be given by the readers! + +I give my personal thanks to Frank Neukam. Without his \Script{} +family \KOMAScript{} wouldn't be. + +I am indebted to the persons who have contributed to {\KOMAScript} +in many different fashions. +Vicariously for all those contributers I would like mention +Jens-Uwe Morawski and Torsten Kr\"uger. +The english translation of the guide is , besides many other things, +obliged to Jens' untiring engagement. +Torsten was the best beta-tester I ever had. Especially his work has +enhanced the usabillity of \Class{scrlttr2} und \Class{scrpage2}. + +Many thanks to all who have encouraged me to go on, make things +better, less error-prone or to implement some additional features. + +Thanks to DANTE, Deutschsprachige Anwendervereinigung +\TeX~e.V\kern-.18em, without the DANTE server, \KOMAScript{} couldn't +be released and distributed. +Thanks to everybody at the \TeX{} news groups and mailing lists, +who answer questions and help me to support \KOMAScript{}. + +\section{Legal Notes}\label{sec:introduction.legal} + +{\KOMAScript} was released under {\LaTeX} Project Public Licence. You +will find it at the file \File{LEGAL.TXT}. Germans will also find a +inofficial translation at \File{LEGALDE.TXT}. This german file is +valid at every country with german being an official language. + +There's no warranty for any documentation or any other part of the +\KOMAScript{} bundle. + +\section{Installation}\label{sec:introduction.installation} +You'll find the documentation about installation at the files +\File{readme.txt} and \File{INSTALL.TXT}. Read also the documentation +of the \TeX{} distribution you're using. + +\section{Bugreports and Other Requests} +\label{sec:introduction.errors} + +If you think, you've found a bug at the documentation, one of the +\KOMAScript{} classes, one of the \KOMAScript{} packages or another +part of \KOMAScript{} please do the following. First have a look at +CTAN to see, if there is a new version of the part with the bug. In +this case install the new part and try it again. + +If you've found an error not at the documentation or a bug, which is +still at the updated file, please write a short example \LaTeX{} +document to show the problem. At this example you should only use +these packages and definitions needed to demonstrate the +problem. Don't use unusual packages. + +Writing this example you will often find out, if the problem is a bug +at \KOMAScript{} or not. Report only bugs at \KOMAScript{} to the +author of \KOMAScript{}. Please use \File{komabug.tex} for the +generation of the bug report. \File{komabug.tex} is an interactive +\LaTeX{} document. + +If you want to ask your question at a news group or mainling list, you +should also write such a example as part of your question. But you +need not use \File{komabug.tex} in this case. To get the versions of +all used packages, simply put \Macro{listfiles} in the preamble of +your example and read the end of the \File{log}-file. + + +\section{Authors}\label{sec:introduction.authors} +Every chapter will be finished with a section called ``authors''. You +will find there the authors of the original chapter of the german +scrguide. The main author is written using a bold font. The translator +is shown using an italic font. If there is an email address, please +send reports about this chapter of the documentation to this +address. If no translator is given, the authors are the translators. +% Please use \textit{} for the name of the translator add all the +% names of the untranslated german file. If the translator is the +% main author, simply use \textbf. +\begin{itemize} +\item \textbf{Markus Kohm} \TextEMail{Markus.Kohm@gmx.de} +\end{itemize} + +\endinput +%%% Local Variables: +%%% mode: latex +%%% TeX-master: "main" +%%% End: |