From 7a9f237be3d1f966fe9172f4704ee052ca09c551 Mon Sep 17 00:00:00 2001
From: Karl Berry <karl@freefriends.org>
Date: Sun, 18 Sep 2011 22:52:19 +0000
Subject: new doc translation translation-filecontents-de (18sep11)

git-svn-id: svn://tug.org/texlive/trunk@24010 c570f23f-e606-0410-a88d-b1316a301751
---
 .../filecontents-de.dtx                            | 396 +++++++++++++++++++++
 1 file changed, 396 insertions(+)
 create mode 100644 Master/texmf-dist/doc/latex/translation-filecontents-de/filecontents-de.dtx

(limited to 'Master/texmf-dist/doc/latex/translation-filecontents-de/filecontents-de.dtx')

diff --git a/Master/texmf-dist/doc/latex/translation-filecontents-de/filecontents-de.dtx b/Master/texmf-dist/doc/latex/translation-filecontents-de/filecontents-de.dtx
new file mode 100644
index 00000000000..e07eb1e23d5
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/translation-filecontents-de/filecontents-de.dtx
@@ -0,0 +1,396 @@
+% \iffalse meta-comment
+%
+% Copyright (C) 2009 Scott Pakin <scott+fc@pakin.org>
+% -------------------------------------------------------
+%
+% This package may be distributed and/or modified under the
+% conditions of the LaTeX Project Public License, either version 1.3c
+% of this license or (at your option) any later version.
+% 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 2008/05/04 or later.
+%
+% \fi
+%
+% \iffalse
+%<*driver>
+\ProvidesFile{filecontents-DE.dtx}
+%</driver>
+%<package>\NeedsTeXFormat{LaTeX2e}[1999/12/01]
+%<package>\ProvidesPackage{filecontents}
+%<*package>
+    [2009/03/17 v1.2 Create an external file from within a LaTeX document]
+%</package>
+%
+%<*driver>
+\documentclass{ltxdoc}
+\usepackage[ngerman]{babel}
+\EnableCrossrefs
+\CodelineIndex
+\RecordChanges
+\begin{document}
+\DocInput{filecontents-DE.dtx}
+\end{document}
+%</driver>
+% \fi
+%
+% %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+%
+% \CheckSum{173}
+%
+% \CharacterTable
+%  {Upper-case    \A\B\C\D\E\F\G\H\I\J\K\L\M\N\O\P\Q\R\S\T\U\V\W\X\Y\Z
+%   Lower-case    \a\b\c\d\e\f\g\h\i\j\k\l\m\n\o\p\q\r\s\t\u\v\w\x\y\z
+%   Digits        \0\1\2\3\4\5\6\7\8\9
+%   Exclamation   \!     Double quote  \"     Hash (number) \#
+%   Dollar        \$     Percent       \%     Ampersand     \&
+%   Acute accent  \'     Left paren    \(     Right paren   \)
+%   Asterisk      \*     Plus          \+     Comma         \,
+%   Minus         \-     Point         \.     Solidus       \/
+%   Colon         \:     Semicolon     \;     Less than     \<
+%   Equals        \=     Greater than  \>     Question mark \?
+%   Commercial at \@     Left bracket  \[     Backslash     \\
+%   Right bracket \]     Circumflex    \^     Underscore    \_
+%   Grave accent  \`     Left brace    \{     Vertical bar  \|
+%   Right brace   \}     Tilde         \~}
+%
+% \GetFileInfo{filecontents-DE.dtx}
+%
+% \title{Das \textsf{filecontents} Paket\thanks{Dateiversion
+%         \fileversion, "uberarbeitet
+%         \filedate.}}
+% \author{Scott Pakin\\scott+fc@pakin.org\\\\
+%		{\small "Ubersetzung ins Deutsche:} \\ {\small Ronny Berndt} \\
+{\small ronny.berndt@uni-jena.de}}
+% \maketitle
+%
+% \changes{v1.0}{2001/07/31}{Initial version}
+% \changes{v1.1a}{2006/03/11}{%
+%   Clarified/corrected the \texttt{\string\string\string\documentclass}
+%   restriction as per Robin Fairbairns's suggestion}
+%
+% ^^A The following were copied verbatim from source2e.tex.
+% \DoNotIndex{\def,\long,\edef,\xdef,\gdef,\let,\global}
+% \DoNotIndex{\if,\ifnum,\ifdim,\ifcat,\ifmmode,\ifvmode,\ifhmode,%
+%             \iftrue,\iffalse,\ifvoid,\ifx,\ifeof,\ifcase,\else,\or,\fi}
+% \DoNotIndex{\box,\copy,\setbox,\unvbox,\unhbox,\hbox,%
+%             \vbox,\vtop,\vcenter}
+% \DoNotIndex{\@empty,\immediate,\write}
+% \DoNotIndex{\egroup,\bgroup,\expandafter,\begingroup,\endgroup}
+% \DoNotIndex{\divide,\advance,\multiply,\count,\dimen}
+% \DoNotIndex{\relax,\space,\string}
+% \DoNotIndex{\csname,\endcsname,\@spaces,\openin,\openout,%
+%             \closein,\closeout}
+% \DoNotIndex{\catcode,\endinput}
+% \DoNotIndex{\jobname,\message,\read,\the,\m@ne,\noexpand}
+% \DoNotIndex{\hsize,\vsize,\hskip,\vskip,\kern,\hfil,\hfill,\hss}
+% \DoNotIndex{\m@ne,\z@,\z@skip,\@ne,\tw@,\p@}
+% \DoNotIndex{\dp,\wd,\ht,\vss,\unskip}
+%
+% ^^A  The following are specific to filecontents.dtx.
+% \DoNotIndex{\@currenvir,\@gobble,\@gobblefour,\@ifundefined,\@makeother}
+% \DoNotIndex{\@undefined,\active,\chardef,\day,\do,\dospecials,\E,\end,\I}
+% \DoNotIndex{\if@tempswa,\L,\LaTeX,\loop,\MessageBreak,\month}
+% \DoNotIndex{\newenvironment,\number,\repeat,\reserved@b,\reserved@c}
+% \DoNotIndex{\two@digits,\year,\*,\}
+%
+% ^^A  Define some commands to help delineate my changes.
+% \newcommand{\startfcchanges}{
+%   \centerline{
+%     \makebox[0pt]{
+%       \raisebox{-2\baselineskip}[0pt][0pt]{
+%       \makebox[0pt][l]{\rule{1pt}{2\baselineskip}}}
+%       \rule{1em}{1pt}
+%       \rule{\linewidth}{1pt}
+%       \rule{1em}{1pt}
+%       \raisebox{-2\baselineskip}[0pt][0pt]{
+%       \makebox[0pt][r]{\rule{1pt}{2\baselineskip}}}
+%     }
+%   }
+%  \noindent
+% }
+% \newcommand{\stopfcchanges}{
+%   \centerline{
+%     \makebox[0pt]{
+%       \raisebox{0pt}[0pt][0pt]{
+%       \makebox[0pt][l]{\rule{1pt}{2\baselineskip}}}
+%       \rule{1em}{1pt}
+%       \rule{\linewidth}{1pt}
+%       \rule{1em}{1pt}
+%       \raisebox{0pt}[0pt][0pt]{
+%       \makebox[0pt][r]{\rule{1pt}{2\baselineskip}}}
+%     }
+%   }
+% }
+%
+%
+% \section{Einleitung}
+%
+% \DescribeEnv{filecontents}
+% Es existiert eine weniger bekannte Umgebung namens |filecontents|, welche in
+% \LaTeXe{} integriert ist. Eine Beschreibung von |filecontents|, welche aus |ltclass.dtx|
+% stammt, lautet folgenderma"sen:   
+%
+% \begin{quotation}
+%   Die |filecontents| Umgebung ist f"ur die Weitergabe von Inhalten aus Paketen,
+%   Optionen oder anderen Dateien bestimmt. Hierdurch werden die Inhalte aus mehreren
+%   Dateien in eine Einzelne eingef"ugt. Der Befehl ben"otigt ein Argument (den Dateinamen),
+%   wodurch eine
+%   neue Datei erzeugt wird. Wenn diese schon existiert (im aktuellen
+%   Verzeichnis, falls das Betriebssystem eine Notation f"ur das `aktuelles Verzeichnis' oder
+%   `Standard Verzeichnis' bereit stellt) passiert nichts (au"ser dass eine Information 
+%   ausgegeben wird) und der
+%   Inhalt des Bereiches der Umgebung wird "ubersprungen. Andernfalls wird der Inhalt
+%   w"ortlich in die Datei geschrieben, dessen Namen man als erstes Argument
+%   angegeben hat. Zus"atzlich werden noch Kommentare in diese Datei geschrieben
+%   um den Benutzer zu zeigen, wie diese erzeugt wurde.
+%
+%   Die Umgebung ist nur vor |\documentclass| erlaubt, um sicherzustellen, dass 
+%   alle Pakete oder Optionen, welche f"ur diesen speziellen Durchlauf gebraucht werden,
+%   vorhanden sind. Die \texttt{begin}- bzw. \texttt{end}-Marke sollten jeweils f"ur sich 
+%   auf einer einzelnen Zeile
+%   stehen. Es besteht die M"oglichkeit die Sternform des Befehls zu verwenden,
+%   welche keinerlei Kommentare in die Datei mit einf"ugt.
+% \end{quotation}
+%
+% \noindent
+% (Der Hinweis, dass |filecontents| nur vor |\documentclass| verwendet werden kann, ist
+% schlichtweg falsch. |filecontents| kann "uberall in der Pr"aambel verwendet werden.)
+%
+% \bigskip
+%
+% Das \textsf{filecontents}-Paket bietet eine verbesserte Version der 
+% |filecontents|- und |filecontents*|-Umgebung, welche die zwei oben genannten
+% Einschr"ankungen ("Uberschreiben von vorhandene Dateien und das |filecontents|
+% vor der Deklaration von |\documentclass| verwendet werden muss) aufhebt.
+% (In Wirklichkeit ist es n"amlich |\begin{document}|).
+% \textsf{filecontents} bietet damit einen bequemeren Weg, um externe Dateien in
+% ein \LaTeX\ Dokument zu schreiben, als es der \LaTeXe-Kernel bietet.
+%
+%
+% \paragraph{Verwendung}
+
+
+% |filecontents| funktioniert "ahnlich wie |verbatim|, au"ser dass es zwingend einen Dateinamen
+% als Argument fordert:
+%
+% \begin{verbatim}
+%     \begin{filecontents}{myfile.tex}
+%     This text gets written to \texttt{myfile.tex}.
+%     \end{filecontents}
+% \end{verbatim}
+%
+% \noindent
+% Der vorangegangene Quelltext wird eine Datei names |myfile.tex| erzeugen
+% und mit folgendem "ahnlichen Inhalt f"ullen:
+%
+% \begin{verbatim}
+%     %% LaTeX2e file `myfile.tex'
+%     %% generated by the `filecontents' environment
+%     %% from source `mydocument' on 2001/07/31.
+%     %%
+%     This text gets written to \texttt{myfile.tex}.
+% \end{verbatim}
+%
+% \noindent
+% |myfile.tex| kann daraufhin durch |\include| oder |\input| zur"uck in das 
+% Dokument eingef"ugt werden. Hat man stattdesssen |filecontents*| benutzt,
+% wird in die Datei nur die Zeile ``\texttt{This text gets written to} \verb"\texttt{myfile.tex}."'' geschrieben.
+% |filecontents*| ist demzufolge sinnvoll zum Schreiben von nicht-\LaTeX\ Dateien, wie zum
+% Beispiel  eingebetteden |PostScript|-Dateien.
+%
+% Wenn Sie das Paket \textsf{ltxtable} benutzen, werden Sie \textsf{filecontents}
+% besonders n"utzlich finden. \textsf{ltxtable} ist eine grobe Ansammlung von
+% \textsf{longtable}, welche "uber Seitengrenzen hinaus gehen und \textsf{tabularx}, 
+% wodurch sich Tabellen auf eine bestimmte Breite weiten lassen. 
+% \textsf{ltxtable}'s Schnittstelle ist ein bisschen unhandlich. Diese fordert, 
+% dass sich die |longtable| Umgebung in einer separaten Datei befindet.
+% Mit dem \textsf{filecontents}-Paket k"onnen Sie diese Datei direkt vor dem Aufruf 
+% von |\LTXtable| erzeugen -- 
+% eine weit bequemere Alternative, als die Tabelle manuell in einer separaten Datei zu 
+% platzieren. 
+%
+%
+% \StopEventually{^^A
+%   \PrintChanges
+%   \PrintIndex
+% }
+%
+% \section{Implementierung}
+%
+% Die meisten Benutzer k"onnen an diesem Punkt mit dem Lesen aufh"oren. 
+% Der Implementierungsteil enth"alt den kommentierten Quelltext f"ur das
+% \textsf{filecontents}- % Paket, welches nur f"ur Personen von Interesse ist, welche 
+% eine ausf"uhrliche und genaue Erkl"arung, 
+% wie \textsf{filecontents} funktioniert, ben"otigen.
+%
+% Ehre, wem Ehre geb"uhrt. Ich habe praktisch keinen Quelltext von 
+% \textsf{filecontents} selbst geschrieben.  Dieser kommt fast ausschlie"slich von dem
+% \LaTeXe-Quellcode, insbesondere aus der Datei |ltclass.dtx|,
+% welcher Frank Mittelbach, Chris Rowley, Alan Jeffrey,
+% und David Carlisle zugeschrieben werden.  Ich habe diesen durch ein paar kleine 
+% "Anderungen (unten durch 
+% Quelltextbl"ocke und Kommentare angezeigt) angepasst, um die
+% |filecontents|- Umgebung bequemer zu benutzen.
+%
+%    \begin{macrocode}
+%<*package>
+%    \end{macrocode}
+%
+% \begin{macro}{\filec@ntents}
+% Sofern nicht anders angegeben, wurde der Quelltext (einschlie"slich der Kommentare) des 
+% |\filec@ntents| Makro w"ortlich aus |ltclass.dtx| "ubernommen.
+%    \begin{macrocode}
+\begingroup%
+\catcode`\*=11 %
+\catcode`\^^M\active%
+\catcode`\^^L\active\let^^L\relax%
+\catcode`\^^I\active%
+%    \end{macrocode}
+%
+%    \begin{macrocode}
+\gdef\filec@ntents#1{%
+  \openin\@inputcheck#1 %
+%    \end{macrocode}
+%
+% \startfcchanges
+% Im urspr"unglichen Quelltext wurde eine existierende Datei nicht "uberschrieben.
+% In der neuen Version dient die Existenzpr"ufung der Datei ausschlie"slich zur Entscheidung,
+% ob ``\texttt{Writing file `\textrm{\meta{filename}}'}'' oder ``\texttt{Overwriting file 
+% `\textrm{\meta{filename}}'}''
+% ausgegeben wird. Die Ablaufsteuerung dient dazu, immer den |\ifeof| Zweig (Datei existiert 
+% nicht; "offne diese)
+% und nie den |\else| Zweig (Datei existiert; mache nichts) auszuf"uhren.
+% \changes{v1.2}{2009/03/17}{Added percent signs after the
+%   \texttt{\char`\\else} and \texttt{\char`\\fi}
+%   lines as per Heiko Oberdiek's suggestion for getting \textsf{filecontents}
+%   to work with the \textsf{guitar} package}
+%    \begin{macrocode}
+  \ifeof\@inputcheck%
+    \@latex@warning@no@line%
+        {Writing file `\@currdir#1'}%
+  \else %
+    \@latex@warning@no@line%
+        {Overwriting file `\@currdir#1'}%
+  \fi %
+%    \end{macrocode}
+%    \begin{macrocode}
+  \chardef\reserved@c15 %
+  \ch@ck7\reserved@c\write%
+  \immediate\openout\reserved@c#1\relax%
+%    \end{macrocode}
+% \stopfcchanges
+%
+%    \begin{macrocode}
+  \if@tempswa%
+    \immediate\write\reserved@c{%
+      \@percentchar\@percentchar\space%
+          \expandafter\@gobble\string\LaTeX2e file `#1'^^J%
+      \@percentchar\@percentchar\space  generated by the %
+        `\@currenvir' \expandafter\@gobblefour\string\newenvironment^^J%
+      \@percentchar\@percentchar\space from source `\jobname' on %
+         \number\year/\two@digits\month/\two@digits\day.^^J%
+      \@percentchar\@percentchar}%
+  \fi%
+  \let\do\@makeother\dospecials%
+%    \end{macrocode}
+% \startfcchanges
+% Das \textsf{inputenc}-Paket hat unter Umst"anden einige der oberen~128
+% Zeichencodes als ``aktiv'' gekennzeichnet (category code~13), welches
+% \textsf{filecontents} verwirrt. Deshalb markieren wir jeden der oberen~128
+% Zeichencodes als ``Buchstabe'' (category code~11), um sie korrekt in eine
+% Datei schreiben zu k"onnen.
+% \changes{v1.1}{2004/08/16}{Made it possible for \textsf{filecontents}
+%   to write \mbox{Latin-1} characters as per Harry Schmidt's feature
+%   request and Frank Mittelbach's suggestion of how to implement it.}
+% \changes{v1.2}{2009/03/17}{Added percent signs after each line in
+%   the loop as per Heiko Oberdiek's suggestion for getting
+%   \textsf{filecontents} to work with the \textsf{guitar} package}
+%    \begin{macrocode}
+  \count0=128\relax %
+  \loop %
+    \catcode\count0=11\relax %
+    \advance\count0 by 1\relax %
+    \ifnum\count0<256 %
+  \repeat %
+%    \end{macrocode}
+% \stopfcchanges
+%
+%    \begin{macrocode}
+  \edef\E{\@backslashchar end\string{\@currenvir\string}}%
+  \edef\reserved@b{%
+    \def\noexpand\reserved@b%
+         ####1\E####2\E####3\relax}%
+  \reserved@b{%
+    \ifx\relax##3\relax%
+%    \end{macrocode}
+% Es gab kein |\end{filecontents}|
+%    \begin{macrocode}
+      \immediate\write\reserved@c{##1}%
+    \else%
+%    \end{macrocode}
+% Es existierte ein |\end{filecontents}|, stoppe diesmal.
+%    \begin{macrocode}
+      \edef^^M{\noexpand\end{\@currenvir}}%
+      \ifx\relax##1\relax%
+      \else%
+%    \end{macrocode}
+% Text vor dem |\end|, schreibe diesen mit einer Warnung.
+%    \begin{macrocode}
+          \@latex@warning{Writing text `##1' before %
+             \string\end{\@currenvir}\MessageBreak as last line of #1}%
+        \immediate\write\reserved@c{##1}%
+      \fi%
+      \ifx\relax##2\relax%
+      \else%
+%    \end{macrocode}
+% Text nach dem |\end|, ignoriere diesen mit einer Warnung.
+%    \begin{macrocode}
+         \@latex@warning{%
+           Ignoring text `##2' after \string\end{\@currenvir}}%
+      \fi%
+    \fi%
+    ^^M}%
+%    \end{macrocode}
+%
+%    \begin{macrocode}
+  \catcode`\^^L\active%
+  \let\L\@undefined%
+  \def^^L{\@ifundefined L^^J^^J^^J}%
+  \catcode`\^^I\active%
+  \let\I\@undefined%
+  \def^^I{\@ifundefined I\space\space}%
+  \catcode`\^^M\active%
+  \edef^^M##1^^M{%
+    \noexpand\reserved@b##1\E\E\relax}}%
+\endgroup%
+%    \end{macrocode}
+% \end{macro}
+%
+%
+% \begin{macro}{\fc@no@preamblecmds}
+% \LaTeXe\ deklariert |\filecontents|, |\filecontents*| und alle
+% zugeh"origen Hilfs\-makros
+% als |\@onlypreamble|, was dazu f"uhrt, dass diese nach einem |\begin{document}|
+% unwirksam werden. Der nachfolgende Code aktiviert die Wiederverwendung dieser
+% Befehle "uberall im Dokument. Dieser wurde aus dem Paket \textsf{pkgindoc} 
+% (generiert durch |ltclass.dtx|) entnommen und ver"andert. Dabei wurden nur die Befehle 
+% angepasst,
+% die durch \textsf{filecontents} gebraucht werden, um diese wieder zu aktivieren.
+% Andere Klassen- und Paketoptionen, sowie verarbeitende Befehle, blieben unber"uhrt.   
+%    \begin{macrocode}
+\def\fc@no@preamblecmds#1\do\filecontents#2\do\filec@ntents#3\relax{%
+  \gdef\@preamblecmds{#1#3}}
+\expandafter\fc@no@preamblecmds\@preamblecmds\relax
+%    \end{macrocode}
+% \end{macro}
+%
+%    \begin{macrocode}
+%</package>
+%    \end{macrocode}
+%
+% \Finale
+%
-- 
cgit v1.2.3

