Add translations: reference/gnupg

reference/gnupg/examples.xml

@@ -0,0 +1,88 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- $Revision$ -->
+<!-- EN-Revision: 96c9d88bad9a7d7d44bfb7f26c226df7ee9ddf26 Maintainer: samesch Status: ready -->
+<!-- Reviewed: no -->
+<chapter xml:id="gnupg.examples" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
+ &reftitle.examples;
+ <section xml:id="gnupg.examples-clearsign">
+  <title>Signieren eines Textes mit Klartextsignatur</title>
+  <para>
+   In diesem Beispiel wird ein gegebener Text mit Klartextsignatur signiert.
+  </para>
+  <example>
+   <title>Erstellen einer Klatext-Signatur mit gnupg (prozedural)</title>
+   <programlisting role="php">
+<![CDATA[
+<?php
+// gnupg initialisieren
+$res = gnupg_init();
+// wird nicht benötigt; Clearsign ist voreingestellt.
+gnupg_setsignmode($res,GNUPG_SIG_MODE_CLEAR);
+// Schlüssel mit Passphrase 'test' zum Signieren hinzufügen
+gnupg_addsignkey($res,"8660281B6051D071D94B5B230549F9DC851566DC","test");
+// signieren
+$signed = gnupg_sign($res,"just a test");
+echo $signed;
+?>
+]]>
+   </programlisting>
+  </example>
+  <example>
+   <title>Erstellen einer Klatext-Signatur mit gnupg (objektorientiert)</title>
+   <programlisting role="php">
+<![CDATA[
+<?php
+// neue Klasse
+$gnupg = new gnupg();
+// wird nicht benötigt; Clearsign ist voreingestellt.
+$gnupg->setsignmode(gnupg::SIG_MODE_CLEAR);
+// Schlüssel mit Passphrase 'test' zum Signieren hinzufügen
+$gnupg->addsignkey("8660281B6051D071D94B5B230549F9DC851566DC","test");
+// signieren
+$signed = $gnupg->sign("just a test");
+echo $signed;
+?>
+]]>
+   </programlisting>
+  </example>
+  <example xml:id="gnupg.keylistiterator">
+   <title>keylistiterator</title>
+   <para>
+    Diese Erweiterung enthält auch einen Iterator für den Schlüsselbund.
+   </para>
+   <programlisting role="php">
+<![CDATA[
+<?php
+// Erstellen eines neuen Iterators, der alle öffentlichen Schlüssel auflistet,
+// die auf "example" passen
+foreach($iterator as $fingerprint => $userid){
+    echo $fingerprint." -> ".$userid."\n";
+}
+?>
+]]>
+   </programlisting>
+  </example>
+ </section>
+</chapter>
+
+<!-- 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
+indent-tabs-mode:nil
+sgml-parent-document:nil
+sgml-default-dtd-file:"~/.phpdoc/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
+-->
+

reference/gnupg/functions/gnupg-deletekey.xml

@@ -0,0 +1,106 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- $Revision$ -->
+<!-- EN-Revision: 91db48f3b3debd560173ffe286f3a9b7690135b9 Maintainer: samesch Status: ready -->
+<!-- Reviewed: no -->
+<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.gnupg-deletekey">
+ <refnamediv>
+  <refname>gnupg_deletekey</refname>
+  <refpurpose>Löscht einen Schlüssel aus dem Schlüsselbund</refpurpose>
+ </refnamediv>
+
+ <refsect1 role="description">
+  &reftitle.description;
+  <methodsynopsis>
+   <type>bool</type><methodname>gnupg_deletekey</methodname>
+   <methodparam><type>resource</type><parameter>identifier</parameter></methodparam>
+   <methodparam><type>string</type><parameter>key</parameter></methodparam>
+   <methodparam><type>bool</type><parameter>allow_secret</parameter></methodparam>
+  </methodsynopsis>
+ </refsect1>
+
+ <refsect1 role="parameters">
+  &reftitle.parameters;
+  <para>
+   <variablelist>
+    <varlistentry>
+     <term><parameter>identifier</parameter></term>
+     <listitem>
+      &gnupg.identifier;
+     </listitem>
+    </varlistentry>
+    <varlistentry>
+     <term><parameter>key</parameter></term>
+     <listitem>
+      <para>
+       Der zu löschende Schlüssel.
+      </para>
+     </listitem>
+    </varlistentry>
+    <varlistentry>
+     <term><parameter>allow_secret</parameter></term>
+     <listitem>
+      <para>
+       Gibt an, ob auch geheime Schlüssel gelöscht werden sollen.
+      </para>
+     </listitem>
+    </varlistentry>
+   </variablelist>
+  </para>
+ </refsect1>
+
+ <refsect1 role="returnvalues">
+  &reftitle.returnvalues;
+  <para>
+   &return.success;
+  </para>
+ </refsect1>
+
+ <refsect1 role="examples">
+  &reftitle.examples;
+  <para>
+   <example>
+    <title>Prozedurales <function>gnupg_deletekey</function>-Beispiel</title>
+    <programlisting role="php">
+<![CDATA[
+<?php
+$res = gnupg_init();
+gnupg_deletekey($res, "8660281B6051D071D94B5B230549F9DC851566DC");
+?>
+]]>
+    </programlisting>
+   </example>
+   <example>
+    <title>Objektorientiertes <function>gnupg_deletekey</function>-Beispiel</title>
+    <programlisting role="php">
+<![CDATA[
+<?php
+$gpg = new gnupg();
+$gpg->deletekey("8660281B6051D071D94B5B230549F9DC851566DC");
+?>
+]]>
+    </programlisting>
+   </example>
+  </para>
+ </refsect1>
+
+</refentry>
+<!-- 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
+indent-tabs-mode:nil
+sgml-parent-document:nil
+sgml-default-dtd-file:"~/.phpdoc/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
+-->

reference/gnupg/functions/gnupg-getengineinfo.xml

@@ -0,0 +1,116 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- $Revision$ -->
+<!-- EN-Revision: f393ece5f34cb70ceebbfa811e19c92fb8b9eac0 Maintainer: samesch Status: ready -->
+<!-- Reviewed: no -->
+<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.gnupg-getengineinfo">
+ <refnamediv>
+  <refname>gnupg_getengineinfo</refname>
+  <refpurpose>Liefert Informationen über die Engine</refpurpose>
+ </refnamediv>
+
+ <refsect1 role="description">
+  &reftitle.description;
+  <methodsynopsis>
+   <type>array</type><methodname>gnupg_getengineinfo</methodname>
+   <methodparam><type>resource</type><parameter>identifier</parameter></methodparam>
+  </methodsynopsis>
+ </refsect1>
+
+ <refsect1 role="parameters">
+  &reftitle.parameters;
+  <para>
+   <variablelist>
+    <varlistentry>
+     <term><parameter>identifier</parameter></term>
+     <listitem>
+      &gnupg.identifier;
+     </listitem>
+    </varlistentry>
+   </variablelist>
+  </para>
+ </refsect1>
+
+ <refsect1 role="returnvalues">
+  &reftitle.returnvalues;
+  <para>
+   Gibt ein Array mit Informationen zur Engine zurück, das aus
+   <literal>protocol</literal>, <literal>file_name</literal> und
+   <literal>home_dir</literal> besteht.
+  </para>
+ </refsect1>
+
+ <refsect1 role="examples">
+  &reftitle.examples;
+  <para>
+   <example>
+    <title>Prozedurales <function>gnupg_getengineinfo</function>-Beispiel</title>
+    <programlisting role="php">
+<![CDATA[
+<?php
+$res = gnupg_init();
+print_r(gnupg_getengineinfo($res));
+?>
+]]>
+    </programlisting>
+    &example.outputs;
+    <screen>
+<![CDATA[
+array(3) {
+  ["protocol"]=>
+  int(0)
+  ["file_name"]=>
+  string(12) "/usr/bin/gpg"
+  ["home_dir"]=>
+  string(0) ""
+}
+]]>
+    </screen>
+   </example>
+   <example>
+    <title>Objektorientiertes <function>gnupg_getengineinfo</function>-Beispiel</title>
+    <programlisting role="php">
+<![CDATA[
+<?php
+$gpg = new gnupg(["file_name" => "/usr/bin/gpg2", "home_dir" => "/var/www/.gnupg"]);
+print_r($gpg->getengineinfo());
+?>
+]]>
+    </programlisting>
+    &example.outputs;
+    <screen>
+<![CDATA[
+array(3) {
+  ["protocol"]=>
+  int(0)
+  ["file_name"]=>
+  string(13) "/usr/bin/gpg2"
+  ["home_dir"]=>
+  string(15) "/var/www/.gnupg"
+}
+]]>
+    </screen>
+   </example>
+  </para>
+ </refsect1>
+
+</refentry>
+<!-- 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
+indent-tabs-mode:nil
+sgml-parent-document:nil
+sgml-default-dtd-file:"~/.phpdoc/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
+-->