cvs: peardoc /de language-defs.ent language-snippets.ent preface.xml
| From: | Alexander Merz | Date: | Sat, 07 Feb 2004 15:02:12 +0000 |
| Subject: | cvs: peardoc /de language-defs.ent language-snippets.ent preface.xml | ||
| Groups: | php.pear.doc | ||
| Request: | Send a blank email to pear-doc+get-2443@lists.php.net to get a copy of this message | ||
alexmerz Sat Feb 7 10:02:12 2004 EDT
Added files:
/peardoc/de preface.xml
Modified files:
/peardoc/de language-defs.ent language-snippets.ent
Log:
initial stuff for german tanslation
http://cvs.php.net/diff.php/peardoc/de/language-defs.ent?r1=1.2&r2=1.3&ty=u Index: peardoc/de/language-defs.ent diff -u peardoc/de/language-defs.ent:1.2 peardoc/de/language-defs.ent:1.3 --- peardoc/de/language-defs.ent:1.2 Fri Dec 27 10:27:41 2002 +++ peardoc/de/language-defs.ent Sat Feb 7 10:02:12 2004 @@ -1,13 +1,14 @@ -<!-- $Revision: 1.2 $ --> +<!-- $Revision: 1.3 $ --> +<!-- Sync: 1.1 --> -<!ENTITY PEARManual "PEAR Manual"> -<!ENTITY Date "Date:"> -<!ENTITY AboutPEAR "About PEAR"> -<!ENTITY DevelopersGuide "Developer Guide"> -<!ENTITY LanguageReference "Language Reference"> -<!ENTITY Features "Features"> -<!ENTITY PEAR "PEAR: the PHP Extension and Application Repository"> +<!ENTITY PEARManual "PEAR-Handbuch"> +<!ENTITY Date "Datum:"> +<!ENTITY AboutPEAR "Über PEAR"> +<!ENTITY DevelopersGuide "Entwickler-Leitfaden"> +<!ENTITY LanguageReference "Sprach-Referenz"> +<!ENTITY Features "Merkmale"> +<!ENTITY PEAR "PEAR: Das PHP Extension and Application Repository"> <!ENTITY Packages "Packages"> <!ENTITY Pecl "PECL Packages"> -<!ENTITY Core "Core components"> -<!ENTITY Contributing "Contributing to PEAR"> +<!ENTITY Core "Core-Bestandteile"> +<!ENTITY Contributing "An PEAR mitarbeiten"> http://cvs.php.net/diff.php/peardoc/de/language-snippets.ent?r1=1.1&r2=1.2&ty=u Index: peardoc/de/language-snippets.ent diff -u peardoc/de/language-snippets.ent:1.1 peardoc/de/language-snippets.ent:1.2 --- peardoc/de/language-snippets.ent:1.1 Mon Sep 30 22:56:03 2002 +++ peardoc/de/language-snippets.ent Sat Feb 7 10:02:12 2004 @@ -1,35 +1,77 @@ -<!-- $Revision: 1.1 $ --> +<!-- $Revision: 1.2 $ --> +<!-- Sync: 1.9 --> -<!ENTITY warn.experimental '<warning><simpara>This module is <emphasis>EXPERIMENTAL</emphasis>. That means, that the behaviour of these functions, these function names, in concreto ANYTHING documented here can change in a future release of this package WITHOUT NOTICE. Be warned, and use this module at your own risk.</simpara></warning>'> -<!ENTITY warn.experimental.func '<warning><simpara>This function is <emphasis>EXPERIMENTAL</emphasis>. That means, that the behaviour of this function, this function name, in concreto ANYTHING documented here can change in a future release of this package WITHOUT NOTICE. Be warned, and use this function at your own risk.</simpara></warning>'> +<!ENTITY warn.experimental '<warning><simpara>Dieses Package ist +<emphasis>EXPERIMENTELL</emphasis>. Das bedeutet ALLES was hier dokumentiert ist, +kann sich ändern - OHNE HINWEIS! Das schließt u.a. ein: das Verhalten von +Funktionen und ihre Namen. Seien Sie gewarnt, dass Sie dieses Packages auf eigenes +Risko verwenden.</simpara></warning>'> -<!ENTITY tip.ob-capture '<tip><simpara>As with anything that outputs its result directly to the browser, you can use the <link linkend="ref.outcontrol">output-control functions</link> to capture the output of this function, and save it - for example - in a <type>string</type>.</simpara></tip>'> +<!ENTITY warn.experimental.func '<warning><simpara>Diese Funktion +ist <emphasis>EXPERIMENTELL</emphasis>. Das bedeutet ALLES was hier dokumentiert ist, +kann sich ändern - OHNE HINWEIS! Das schließt u.a. ein: das Verhalten von +Funktionen und ihre Namen. Seien Sie gewarnt, dass Sie diese Funktion auf eigenes +Risko verwenden.</simpara></warning>'> -<!ENTITY return.success 'Returns &true; on succes, &false; on failure.'> +<!ENTITY warn.undocumented.func '<warning><simpara>Diese Funktion +wurde noch nicht dokumentiert.</simpara></warning>'> -<!ENTITY return.success-pearerror 'Returns &true; on succes, <classname>PEAR_Error</classname> on failure.'> +<!ENTITY warn.undocumented.method '<warning><simpara>Diese Methode +wurde noch nicht dokumentiert.</simpara></warning>'> -<!ENTITY return.falseproblem '<warning><simpara>This function may return &false;, but may also return a value evaluating to &false; in a simple if statement. Please use <link linkend="language.operators.comparison">the === operator</link> for testing the return value of this function.</simpara></warning>'> -<!ENTITY link.coding-standards 'PEAR <link linkend="standards">coding standards.</link>'> +<!ENTITY tip.ob-capture '<tip><simpara>Wie jede Art von Ausgabe an den Brwoser +können Sie auch diese abfangen und z.B. speichern über +<ulink url="&url.php.lookup;outcontrol">output-control Funktionen</ulink> +.</simpara></tip>'> -<!ENTITY note.canstatic '<simpara>This function can be called statically</simpara>'> -<!ENTITY note.shouldstatic '<simpara>This function should be called statically</simpara>'> -<!ENTITY note.notstatic '<simpara>This function can not be called statically</simpara>'> -<!ENTITY note.deprecated '<warning><para>This function is <emphasis>deprecated</emphasis>. So - they could not be supported in further package releases.</para></warning>'> +<!ENTITY return.success 'Gibt bei Erfolg &true; zurück, bei einem Fehler &false;.'> + +<!ENTITY return.success-pearerror 'Gibt bei Erfolg &true; zurück, bei einem Fehler +ein Objekt der Klasse <classname>PEAR_Error</classname>.'> + +<!ENTITY return.falseproblem '<warning><simpara>Diese Funktion kann den Wert +&false; zurückgeben, aber auch einen Wert, der als &false; interpretiert wird in +einer einfachen If-Abfrage. Bitte benutzen Sie den <ulink url="&url.php.lookup;operators.comparison"> === Operator</ulink> +um den Rückgabewert zu testen.</simpara></warning>'> + +<!ENTITY link.coding-standards 'PEAR-<link linkend="standards">Coding +Standards</link>'> + +<!ENTITY note.canstatic '<simpara>Diese Methode kann statisch +aufgerufen werden.</simpara>'> + +<!ENTITY note.shouldstatic '<simpara>Diese Methode sollte statisch +aufgerufen werden..</simpara>'> + +<!ENTITY note.notstatic '<simpara>Diese Methode kann nicht +<emphasis>statisch</emphasis> aufgerufen werden.</simpara>'> + +<!ENTITY note.deprecated '<warning><para>Diese Methode ist +<emphasis>deprecated</emphasis>. Das bedeutet zukünftige Versionen +dieses Packages müssen diese Methode nicht mehr besitzen.</para></warning>'> <!ENTITY title.desc '<title>Beschreibung</title>'> <!ENTITY title.param '<title>Parameter</title>'> <!ENTITY title.returns '<title>Rückgabewert</title>'> -<!ENTITY title.throws '<title>Wirft</title>'> -<!ENTITY title.throws.errortable 'Mögliche PEAR_Error-Werte'> -<!ENTITY title.note '<title>Anmerkung</title>'> -<!ENTITY title.example '<title>Beispiel</title>'> +<!ENTITY title.throws '<title>Fehler-Meldungen</title>'> +<!ENTITY title.throws.errortable 'Mögliche Fehler-Arten'> +<!ENTITY title.note '<title>Hinweise</title>'> +<!ENTITY title.example '<title>Besispiel</title>'> <!ENTITY title.see '<title>Siehe auch</title>'> <!ENTITY title.constants 'Konstanten'> -<!ENTITY purpose.preconstants 'predefined constants'> +<!ENTITY type.bool '<type>boolean</type>'> +<!ENTITY type.int '<type>integer</type>'> +<!ENTITY type.float '<type>float</type>'> +<!ENTITY type.string '<type>string</type>'> +<!ENTITY type.mixed '<type>mixed</type>'> +<!ENTITY type.object '<type>object</type>'> +<!ENTITY type.res '<type>resource</type>'> +<!ENTITY type.array '<type>array</type>'> +<!ENTITY type.resource '<type>resource</type>'> + +<!ENTITY purpose.preconstants 'Vordefinierte Konstanten'> -<!ENTITY pdevrel '(package developer related)'> +<!ENTITY pdevrel '(bezogen auf Package-Entwickler)'> -<!ENTITY notdocumented '<para>Dieses package ist derzeit nicht dokumentiert</para>'> +<!ENTITY notdocumented '<para>Dieses Package ist noch nicht dokumentiert.</para>'> http://cvs.php.net/co.php/peardoc/de/preface.xml?r=1.1&p=1 Index: peardoc/de/preface.xml +++ peardoc/de/preface.xml <?xml version="1.0" encoding="iso-8859-1" ?> <!-- $Revision: 1.1 $ --> <!-- Sync: 1.7 --> <preface id="preface"> <title>Vorwort</title> <abstract> <simpara> <acronym>PEAR</acronym> ist die Abkürzung für: PHP Extension and Application Repository. </simpara> </abstract> <sect1 id="about"> <title>Über dieses Handbuch</title> <para> Dieses Handbuch wird gepflegt in <acronym>XML</acronym> unter Benutzung der <ulink url="&url.docbook.xml;">DocBook XML DTD</ulink> und formatiert mit <ulink url="&url.dsssl;"><acronym>DSSSL</acronym></ulink> (Document Style and Semantics Specification Language). Um die <acronym>HTML</acronym>-Versionen zu erzeugen, wird benutzt: <ulink url="&url.jade;">Jade</ulink>, von <ulink url="&url.jclark;">James Clark</ulink> und die <ulink url="&url.dbstyle;">Modular DocBook Stylesheets</ulink> von <ulink url="&url.nwalsh;">Norman Walsh</ulink>. </para> <para> Die Struktur für das Handbuch basiert auf den Arbeiten der PHP Documentation Group. Lesen Sie dazu für mehr Information <ulink url="&url.php.manual.about;">About the PHP manual</ulink>. </para> </sect1> <sect1 id="structure"> <title>Der Aufbau des Handbuchs</title> <para> Diese Einführung erklärt die allgemeine Struktur, das Layout und die Konventionen im PEAR-Handbuch. Es ist unterteilt in sechs große Teile, die sind: </para> <para> <itemizedlist> <listitem> <para> <link linkend="about-pear">Über PEAR</link> </para> <para> Dieser Teil enthält eine Einführung darüber, was PEAR ist und was es bietet. Dazu kommen allgemeine Informationen über die Installation und die Benutzung von PEAR, Support-Möglichkeiten und beantwortet häufig gestellte Fragen zu PEAR. </para> </listitem> <listitem> <para> <link linkend="guide-developers">Entwickler-Leitfaden</link> </para> <para> Allgemeine Informationen über die Entwicklung und Herausgabe von PEAR-Packages. </para> </listitem> <listitem> <para> <link linkend="core">Core-Bestandteile</link> </para> <para> Dieser Teil dokumentiert die PEAR-Core-Klassen. Sie sind die Basis für jede Klasse in PEAR - wenn Sie die Core-Klassen kennen, dürfte das Arbeiten mit den übrigen keine Schwierigkeit sein. Themen sind u.a.: &class.pear;, PEAR verwalten, die Fehlerbehandlung über die &class.pear-error;-Klasse, und system-nahe Kommandos. Die hier beschriebenen Funktionen sind Bestandteil jeder orginalen PHP-Distribution. </para> </listitem> <listitem> <para> <link linkend="packages">Packages</link> </para> <para> Es gibt eine wachsende Anzahl von PEAR-Packages. Viele sind hier dokumentiert - aber standardmäßig nicht installiert. Für die Installation von PEAR Packages lesen Sie bitte das <link linkend="installation">Installation chapter</link>. </para> <para> Die Dokumentation für jede Klasse enthält zumindest eine Beschreibung aller öffentlichen Methoden. Häufig sind zusätzlich verfügbar: eine Einführung, eine Auflistung definierter Konstanten und Anwendungs-Beispiele. Daneben gibt es natürlich noch Informationen im Quellcode der Klassen selbst. </para> <para> Die Beschreibung jeder Methode enthält einige oder alle folgenden Teile: <itemizedlist> <listitem> <para>Synopsis</para> <para> Zeigt den Aufbau der Methode </para> </listitem> <listitem> <para>Beschreibung</para> <para> Beschreibt, was die Methode tut </para> </listitem> <listitem> <para>Parameter</para> <para> Beschreibt jeden Parameter der Methode mit ihrem Namen und Datentyp. Es werden erforderliche und optionalen Parameter aufgeführt </para> </listitem> <listitem> <para>Rückgabewert</para> <para> Beschreibt den Rückgabewert, wenn kein Fehler auftritt </para> </listitem> <listitem> <para>Fehler-Meldungen</para> <para> Beschreibt das zurückgelieferte <classname>PEAR_Error</classname>-Objekt wenn ein Fehler auftritt </para> </listitem> <listitem> <para>Hinweise</para> <para> Zusätzliche Hinweise über eine Methode. Z.B. ist hier vermerkt, wenn eine Methode statisch aufgerufen werden kann. </para> </listitem> <listitem> <para>Siehe auch</para> <para> Links zu zugehörigen Methoden oder Handbuch-Seiten </para> </listitem> <listitem> <para>Beispiel</para> <para> Ein Benutzungs-Beispiel für die Methode oder Klasse </para> </listitem> </itemizedlist> </para> </listitem> <listitem> <para> <link linkend="pecl">PECL Packages</link> </para> <para> PECL Packages sind normale PHP-Erweiterungen in C. Die Dokumentations-Struktur sollte denen des Package-Teils gleichen </para> </listitem> <listitem> <para> <link linkend="contributing">An PEAR mitarbeiten</link> </para> <para> Enthält Information zum Schreiben eigener PEAR-Packages </para> </listitem> </itemizedlist> </para> </sect1> <sect1 id="authors"> <title>Autoren und Beteiligte</title> <titleabbrev>Autoren</titleabbrev> <para> Die folgende Liste enthält die Namen derjenigen, die an diesem Handbuch beteiligt sind. Wenn Sie einen kontaktieren möchten, schreiben Sie bitte an <ulink url="mailto:&email.pear.doc;">&email.pear.doc;</ulink>. </para> &authors.list; <simpara> (In alphabetischer Reihenfolge) </simpara> </sect1> </preface> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t sgml-parent-document:nil sgml-default-dtd-file:"../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 -->
http://cvs.php.net/diff.php/peardoc/de/language-defs.ent?r1=1.2&r2=1.3&ty=u Index: peardoc/de/language-defs.ent diff -u peardoc/de/language-defs.ent:1.2 peardoc/de/language-defs.ent:1.3 --- peardoc/de/language-defs.ent:1.2 Fri Dec 27 10:27:41 2002 +++ peardoc/de/language-defs.ent Sat Feb 7 10:02:12 2004 @@ -1,13 +1,14 @@ -<!-- $Revision: 1.2 $ --> +<!-- $Revision: 1.3 $ --> +<!-- Sync: 1.1 --> -<!ENTITY PEARManual "PEAR Manual"> -<!ENTITY Date "Date:"> -<!ENTITY AboutPEAR "About PEAR"> -<!ENTITY DevelopersGuide "Developer Guide"> -<!ENTITY LanguageReference "Language Reference"> -<!ENTITY Features "Features"> -<!ENTITY PEAR "PEAR: the PHP Extension and Application Repository"> +<!ENTITY PEARManual "PEAR-Handbuch"> +<!ENTITY Date "Datum:"> +<!ENTITY AboutPEAR "Über PEAR"> +<!ENTITY DevelopersGuide "Entwickler-Leitfaden"> +<!ENTITY LanguageReference "Sprach-Referenz"> +<!ENTITY Features "Merkmale"> +<!ENTITY PEAR "PEAR: Das PHP Extension and Application Repository"> <!ENTITY Packages "Packages"> <!ENTITY Pecl "PECL Packages"> -<!ENTITY Core "Core components"> -<!ENTITY Contributing "Contributing to PEAR"> +<!ENTITY Core "Core-Bestandteile"> +<!ENTITY Contributing "An PEAR mitarbeiten"> http://cvs.php.net/diff.php/peardoc/de/language-snippets.ent?r1=1.1&r2=1.2&ty=u Index: peardoc/de/language-snippets.ent diff -u peardoc/de/language-snippets.ent:1.1 peardoc/de/language-snippets.ent:1.2 --- peardoc/de/language-snippets.ent:1.1 Mon Sep 30 22:56:03 2002 +++ peardoc/de/language-snippets.ent Sat Feb 7 10:02:12 2004 @@ -1,35 +1,77 @@ -<!-- $Revision: 1.1 $ --> +<!-- $Revision: 1.2 $ --> +<!-- Sync: 1.9 --> -<!ENTITY warn.experimental '<warning><simpara>This module is <emphasis>EXPERIMENTAL</emphasis>. That means, that the behaviour of these functions, these function names, in concreto ANYTHING documented here can change in a future release of this package WITHOUT NOTICE. Be warned, and use this module at your own risk.</simpara></warning>'> -<!ENTITY warn.experimental.func '<warning><simpara>This function is <emphasis>EXPERIMENTAL</emphasis>. That means, that the behaviour of this function, this function name, in concreto ANYTHING documented here can change in a future release of this package WITHOUT NOTICE. Be warned, and use this function at your own risk.</simpara></warning>'> +<!ENTITY warn.experimental '<warning><simpara>Dieses Package ist +<emphasis>EXPERIMENTELL</emphasis>. Das bedeutet ALLES was hier dokumentiert ist, +kann sich ändern - OHNE HINWEIS! Das schließt u.a. ein: das Verhalten von +Funktionen und ihre Namen. Seien Sie gewarnt, dass Sie dieses Packages auf eigenes +Risko verwenden.</simpara></warning>'> -<!ENTITY tip.ob-capture '<tip><simpara>As with anything that outputs its result directly to the browser, you can use the <link linkend="ref.outcontrol">output-control functions</link> to capture the output of this function, and save it - for example - in a <type>string</type>.</simpara></tip>'> +<!ENTITY warn.experimental.func '<warning><simpara>Diese Funktion +ist <emphasis>EXPERIMENTELL</emphasis>. Das bedeutet ALLES was hier dokumentiert ist, +kann sich ändern - OHNE HINWEIS! Das schließt u.a. ein: das Verhalten von +Funktionen und ihre Namen. Seien Sie gewarnt, dass Sie diese Funktion auf eigenes +Risko verwenden.</simpara></warning>'> -<!ENTITY return.success 'Returns &true; on succes, &false; on failure.'> +<!ENTITY warn.undocumented.func '<warning><simpara>Diese Funktion +wurde noch nicht dokumentiert.</simpara></warning>'> -<!ENTITY return.success-pearerror 'Returns &true; on succes, <classname>PEAR_Error</classname> on failure.'> +<!ENTITY warn.undocumented.method '<warning><simpara>Diese Methode +wurde noch nicht dokumentiert.</simpara></warning>'> -<!ENTITY return.falseproblem '<warning><simpara>This function may return &false;, but may also return a value evaluating to &false; in a simple if statement. Please use <link linkend="language.operators.comparison">the === operator</link> for testing the return value of this function.</simpara></warning>'> -<!ENTITY link.coding-standards 'PEAR <link linkend="standards">coding standards.</link>'> +<!ENTITY tip.ob-capture '<tip><simpara>Wie jede Art von Ausgabe an den Brwoser +können Sie auch diese abfangen und z.B. speichern über +<ulink url="&url.php.lookup;outcontrol">output-control Funktionen</ulink> +.</simpara></tip>'> -<!ENTITY note.canstatic '<simpara>This function can be called statically</simpara>'> -<!ENTITY note.shouldstatic '<simpara>This function should be called statically</simpara>'> -<!ENTITY note.notstatic '<simpara>This function can not be called statically</simpara>'> -<!ENTITY note.deprecated '<warning><para>This function is <emphasis>deprecated</emphasis>. So - they could not be supported in further package releases.</para></warning>'> +<!ENTITY return.success 'Gibt bei Erfolg &true; zurück, bei einem Fehler &false;.'> + +<!ENTITY return.success-pearerror 'Gibt bei Erfolg &true; zurück, bei einem Fehler +ein Objekt der Klasse <classname>PEAR_Error</classname>.'> + +<!ENTITY return.falseproblem '<warning><simpara>Diese Funktion kann den Wert +&false; zurückgeben, aber auch einen Wert, der als &false; interpretiert wird in +einer einfachen If-Abfrage. Bitte benutzen Sie den <ulink url="&url.php.lookup;operators.comparison"> === Operator</ulink> +um den Rückgabewert zu testen.</simpara></warning>'> + +<!ENTITY link.coding-standards 'PEAR-<link linkend="standards">Coding +Standards</link>'> + +<!ENTITY note.canstatic '<simpara>Diese Methode kann statisch +aufgerufen werden.</simpara>'> + +<!ENTITY note.shouldstatic '<simpara>Diese Methode sollte statisch +aufgerufen werden..</simpara>'> + +<!ENTITY note.notstatic '<simpara>Diese Methode kann nicht +<emphasis>statisch</emphasis> aufgerufen werden.</simpara>'> + +<!ENTITY note.deprecated '<warning><para>Diese Methode ist +<emphasis>deprecated</emphasis>. Das bedeutet zukünftige Versionen +dieses Packages müssen diese Methode nicht mehr besitzen.</para></warning>'> <!ENTITY title.desc '<title>Beschreibung</title>'> <!ENTITY title.param '<title>Parameter</title>'> <!ENTITY title.returns '<title>Rückgabewert</title>'> -<!ENTITY title.throws '<title>Wirft</title>'> -<!ENTITY title.throws.errortable 'Mögliche PEAR_Error-Werte'> -<!ENTITY title.note '<title>Anmerkung</title>'> -<!ENTITY title.example '<title>Beispiel</title>'> +<!ENTITY title.throws '<title>Fehler-Meldungen</title>'> +<!ENTITY title.throws.errortable 'Mögliche Fehler-Arten'> +<!ENTITY title.note '<title>Hinweise</title>'> +<!ENTITY title.example '<title>Besispiel</title>'> <!ENTITY title.see '<title>Siehe auch</title>'> <!ENTITY title.constants 'Konstanten'> -<!ENTITY purpose.preconstants 'predefined constants'> +<!ENTITY type.bool '<type>boolean</type>'> +<!ENTITY type.int '<type>integer</type>'> +<!ENTITY type.float '<type>float</type>'> +<!ENTITY type.string '<type>string</type>'> +<!ENTITY type.mixed '<type>mixed</type>'> +<!ENTITY type.object '<type>object</type>'> +<!ENTITY type.res '<type>resource</type>'> +<!ENTITY type.array '<type>array</type>'> +<!ENTITY type.resource '<type>resource</type>'> + +<!ENTITY purpose.preconstants 'Vordefinierte Konstanten'> -<!ENTITY pdevrel '(package developer related)'> +<!ENTITY pdevrel '(bezogen auf Package-Entwickler)'> -<!ENTITY notdocumented '<para>Dieses package ist derzeit nicht dokumentiert</para>'> +<!ENTITY notdocumented '<para>Dieses Package ist noch nicht dokumentiert.</para>'> http://cvs.php.net/co.php/peardoc/de/preface.xml?r=1.1&p=1 Index: peardoc/de/preface.xml +++ peardoc/de/preface.xml <?xml version="1.0" encoding="iso-8859-1" ?> <!-- $Revision: 1.1 $ --> <!-- Sync: 1.7 --> <preface id="preface"> <title>Vorwort</title> <abstract> <simpara> <acronym>PEAR</acronym> ist die Abkürzung für: PHP Extension and Application Repository. </simpara> </abstract> <sect1 id="about"> <title>Über dieses Handbuch</title> <para> Dieses Handbuch wird gepflegt in <acronym>XML</acronym> unter Benutzung der <ulink url="&url.docbook.xml;">DocBook XML DTD</ulink> und formatiert mit <ulink url="&url.dsssl;"><acronym>DSSSL</acronym></ulink> (Document Style and Semantics Specification Language). Um die <acronym>HTML</acronym>-Versionen zu erzeugen, wird benutzt: <ulink url="&url.jade;">Jade</ulink>, von <ulink url="&url.jclark;">James Clark</ulink> und die <ulink url="&url.dbstyle;">Modular DocBook Stylesheets</ulink> von <ulink url="&url.nwalsh;">Norman Walsh</ulink>. </para> <para> Die Struktur für das Handbuch basiert auf den Arbeiten der PHP Documentation Group. Lesen Sie dazu für mehr Information <ulink url="&url.php.manual.about;">About the PHP manual</ulink>. </para> </sect1> <sect1 id="structure"> <title>Der Aufbau des Handbuchs</title> <para> Diese Einführung erklärt die allgemeine Struktur, das Layout und die Konventionen im PEAR-Handbuch. Es ist unterteilt in sechs große Teile, die sind: </para> <para> <itemizedlist> <listitem> <para> <link linkend="about-pear">Über PEAR</link> </para> <para> Dieser Teil enthält eine Einführung darüber, was PEAR ist und was es bietet. Dazu kommen allgemeine Informationen über die Installation und die Benutzung von PEAR, Support-Möglichkeiten und beantwortet häufig gestellte Fragen zu PEAR. </para> </listitem> <listitem> <para> <link linkend="guide-developers">Entwickler-Leitfaden</link> </para> <para> Allgemeine Informationen über die Entwicklung und Herausgabe von PEAR-Packages. </para> </listitem> <listitem> <para> <link linkend="core">Core-Bestandteile</link> </para> <para> Dieser Teil dokumentiert die PEAR-Core-Klassen. Sie sind die Basis für jede Klasse in PEAR - wenn Sie die Core-Klassen kennen, dürfte das Arbeiten mit den übrigen keine Schwierigkeit sein. Themen sind u.a.: &class.pear;, PEAR verwalten, die Fehlerbehandlung über die &class.pear-error;-Klasse, und system-nahe Kommandos. Die hier beschriebenen Funktionen sind Bestandteil jeder orginalen PHP-Distribution. </para> </listitem> <listitem> <para> <link linkend="packages">Packages</link> </para> <para> Es gibt eine wachsende Anzahl von PEAR-Packages. Viele sind hier dokumentiert - aber standardmäßig nicht installiert. Für die Installation von PEAR Packages lesen Sie bitte das <link linkend="installation">Installation chapter</link>. </para> <para> Die Dokumentation für jede Klasse enthält zumindest eine Beschreibung aller öffentlichen Methoden. Häufig sind zusätzlich verfügbar: eine Einführung, eine Auflistung definierter Konstanten und Anwendungs-Beispiele. Daneben gibt es natürlich noch Informationen im Quellcode der Klassen selbst. </para> <para> Die Beschreibung jeder Methode enthält einige oder alle folgenden Teile: <itemizedlist> <listitem> <para>Synopsis</para> <para> Zeigt den Aufbau der Methode </para> </listitem> <listitem> <para>Beschreibung</para> <para> Beschreibt, was die Methode tut </para> </listitem> <listitem> <para>Parameter</para> <para> Beschreibt jeden Parameter der Methode mit ihrem Namen und Datentyp. Es werden erforderliche und optionalen Parameter aufgeführt </para> </listitem> <listitem> <para>Rückgabewert</para> <para> Beschreibt den Rückgabewert, wenn kein Fehler auftritt </para> </listitem> <listitem> <para>Fehler-Meldungen</para> <para> Beschreibt das zurückgelieferte <classname>PEAR_Error</classname>-Objekt wenn ein Fehler auftritt </para> </listitem> <listitem> <para>Hinweise</para> <para> Zusätzliche Hinweise über eine Methode. Z.B. ist hier vermerkt, wenn eine Methode statisch aufgerufen werden kann. </para> </listitem> <listitem> <para>Siehe auch</para> <para> Links zu zugehörigen Methoden oder Handbuch-Seiten </para> </listitem> <listitem> <para>Beispiel</para> <para> Ein Benutzungs-Beispiel für die Methode oder Klasse </para> </listitem> </itemizedlist> </para> </listitem> <listitem> <para> <link linkend="pecl">PECL Packages</link> </para> <para> PECL Packages sind normale PHP-Erweiterungen in C. Die Dokumentations-Struktur sollte denen des Package-Teils gleichen </para> </listitem> <listitem> <para> <link linkend="contributing">An PEAR mitarbeiten</link> </para> <para> Enthält Information zum Schreiben eigener PEAR-Packages </para> </listitem> </itemizedlist> </para> </sect1> <sect1 id="authors"> <title>Autoren und Beteiligte</title> <titleabbrev>Autoren</titleabbrev> <para> Die folgende Liste enthält die Namen derjenigen, die an diesem Handbuch beteiligt sind. Wenn Sie einen kontaktieren möchten, schreiben Sie bitte an <ulink url="mailto:&email.pear.doc;">&email.pear.doc;</ulink>. </para> &authors.list; <simpara> (In alphabetischer Reihenfolge) </simpara> </sect1> </preface> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t sgml-parent-document:nil sgml-default-dtd-file:"../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 -->