cvs commit: de-docproj/books/porters-handbook book.sgml

From: Aron Schlesinger <as(at)doc.bsdgroup.de>
Date: Thu, 2 Aug 2007 15:16:35 GMT

as 2007-08-02 15:16:35 UTC

  FreeBSD ports repository

  Modified files:
    books/porters-handbook book.sgml
  Log:
  Kapitel 5 - 5.2 entsprechend den FDP-Vorgaben umformatiert.
  
  Revision Changes Path
  1.95 +593 -495 de-docproj/books/porters-handbook/book.sgml
  
  Index: book.sgml
  ===================================================================
  RCS file: /home/cvs/de-docproj/books/porters-handbook/book.sgml,v
  retrieving revision 1.94
  retrieving revision 1.95
  diff -u -I$FreeBSDde.*$ -r1.94 -r1.95
  --- book.sgml 1 Aug 2007 22:52:09 -0000 1.94
  +++ book.sgml 2 Aug 2007 15:16:35 -0000 1.95
  @@ -886,571 +886,669 @@
       </sect1>
     </chapter>
   
  - <chapter id="makefile">
  - <title>Die Konfiguration des Makefile</title>
  + <chapter id="makefile">
  + <title>Die Konfiguration des Makefile</title>
   
  - <para>Das Konfigurieren des <filename>Makefile</filename> ist sehr einfach
  - und wir schlagen vor, dass Sie zun&auml;chst einen Blick auf vorhandene Beispiele werfen.
  - Zus&auml;tzlich gibt es ein
  - <link linkend="porting-samplem">Beispiel eines Makefile</link> in diesem Handbuch.
  - Schauen Sie es sich an und verfolgen Sie bitte die Abfolge der Variablen
  - und Abschnitte in dieser Vorlage. Damit erleichtern Sie es anderen, Ihren
  - Port zu lesen.</para>
  -
  - <para>Bedenken Sie bitte die folgenden Probleme in der hier vorgegebenen
  - Abfolge der Unterabschnitte dieses Kapitels, wenn Sie Ihr neues
  - <filename>Makefile</filename> erstellen:</para>
  + <para>Das Konfigurieren des <filename>Makefile</filename> ist
  + sehr einfach und wir schlagen vor, dass Sie zun&auml;chst
  + einen Blick auf vorhandene Beispiele werfen. Zus&auml;tzlich
  + gibt es ein
  + <link linkend="porting-samplem">Beispiel eines Makefile</link>
  + in diesem Handbuch. Schauen Sie es sich an und verfolgen Sie
  + bitte die Abfolge der Variablen und Abschnitte in dieser
  + Vorlage. Damit erleichtern Sie es anderen, Ihren Port zu lesen.
  + </para>
  +
  + <para>Bedenken Sie bitte die folgenden Probleme in der hier
  + vorgegebenen Abfolge der Unterabschnitte dieses Kapitels, wenn
  + Sie Ihr neues <filename>Makefile</filename> erstellen:
  + </para>
   
  - <sect1 id="makefile-source">
  - <title>Der originale Quelltext</title>
  + <sect1 id="makefile-source">
  + <title>Der originale Quelltext</title>
   
         <para>Liegt der Quelltext in <makevar>DISTDIR</makevar> als eine
  - standardisierte und mit gzip gepackte Datei in der Art
  - <filename>foozolix-1.2.tar.gz</filename>? Falls ja, k&ouml;nnen Sie
  - zum n&auml;chsten Schritt &uuml;bergehen. Falls nicht, sollten Sie versuchen,
  - die Variablen <makevar>DISTVERSION</makevar>,
  - <makevar>DISTNAME</makevar>,
  - <makevar>EXTRACT_CMD</makevar>,
  - <makevar>EXTRACT_BEFORE_ARGS</makevar>,
  - <makevar>EXTRACT_AFTER_ARGS</makevar>,
  - <makevar>EXTRACT_SUFX</makevar>, oder <makevar>DISTFILES</makevar>
  - zu &auml;ndern. Das h&auml;ngt davon ab, wie fremdartig das Distributionsfile
  - Ihres Ports ist (der h&auml;ufigste Fall ist
  - <literal>EXTRACT_SUFX=.tar.Z</literal>, wenn der Tarball durch ein
  - normales <command>compress</command> und nicht durch
  - <command>gzip</command> gepackt wurde).</para>
  -
  - <para>Im schlimmsten Fall k&ouml;nnen Sie einfach Ihre eigene Vorgabe mittels
  - <maketarget>do-extract</maketarget> erzeugen und die Standardvorgabe
  - &uuml;berschreiben; aber dies sollte in den wenigsten F&auml;llen, wenn &uuml;berhaupt,
  - notwendig sein.</para>
  - </sect1>
  + standardisierte und mit gzip gepackte Datei in der Art
  + <filename>foozolix-1.2.tar.gz</filename>? Falls ja,
  + k&ouml;nnen Sie zum n&auml;chsten Schritt &uuml;bergehen.
  + Falls nicht, sollten Sie versuchen, die Variablen
  + <makevar>DISTVERSION</makevar>, <makevar>DISTNAME</makevar>,
  + <makevar>EXTRACT_CMD</makevar>,
  + <makevar>EXTRACT_BEFORE_ARGS</makevar>,
  + <makevar>EXTRACT_AFTER_ARGS</makevar>,
  + <makevar>EXTRACT_SUFX</makevar>, oder
  + <makevar>DISTFILES</makevar> zu &auml;ndern. Das h&auml;ngt
  + davon ab, wie fremdartig das Distributionsfile Ihres Ports ist
  + (der h&auml;ufigste Fall ist
  + <literal>EXTRACT_SUFX=.tar.Z</literal>, wenn der Tarball durch
  + ein normales <command>compress</command> und nicht durch
  + <command>gzip</command> gepackt wurde).</para>
  +
  + <para>Im schlimmsten Fall k&ouml;nnen Sie einfach Ihre eigene
  + Vorgabe mittels <maketarget>do-extract</maketarget> erzeugen
  + und die Standardvorgabe &uuml;berschreiben; aber dies sollte
  + in den wenigsten F&auml;llen, wenn &uuml;berhaupt, notwendig
  + sein.</para>
  +
  + </sect1>
   
  - <sect1 id="makefile-naming">
  - <title>Bezeichnungen</title>
  + <sect1 id="makefile-naming">
  + <title>Bezeichnungen</title>
   
  - <para>Der erste Teil des <filename>Makefile</filename> beschreibt die
  - Versionsnummer des Ports und f&uuml;hrt ihn in der richtigen Kategorie auf.</para>
  + <para>Der erste Teil des <filename>Makefile</filename>
  + beschreibt die Versionsnummer des Ports und f&uuml;hrt ihn in
  + der richtigen Kategorie auf.</para>
   
         <sect2>
  - <title><makevar>PORTNAME</makevar> und <makevar>PORTVERSION</makevar></title>
  + <title><makevar>PORTNAME</makevar> und
  + <makevar>PORTVERSION</makevar></title>
   
  - <para>Setzen Sie bitte die Variable <makevar>PORTNAME</makevar> auf den
  - Basisnamen Ihres Ports und die Variable <makevar>PORTVERSION</makevar>
  - auf dessen Versionsnummer.</para>
  + <para>Setzen Sie bitte die Variable
  + <makevar>PORTNAME</makevar> auf den Basisnamen Ihres Ports
  + und die Variable <makevar>PORTVERSION</makevar> auf dessen
  + Versionsnummer.</para>
         </sect2>
   
         <sect2 id="makefile-naming-revepoch">
  - <title><makevar>PORTREVISION</makevar> und
  - <makevar>PORTEPOCH</makevar></title>
  + <title><makevar>PORTREVISION</makevar> und
  + <makevar>PORTEPOCH</makevar></title>
   
  - <sect3>
  - <title><makevar>PORTREVISION</makevar></title>
  + <sect3>
  + <title><makevar>PORTREVISION</makevar></title>
   
  - <para>Die <makevar>PORTREVISION</makevar>-Variable ist ein
  - streng monoton wachsender Wert, welcher auf 0 zur&uuml;ckgesetzt wird,
  - nachdem <makevar>PORTVERSION</makevar> erh&ouml;ht wurde (d.h.
  + <para>Die <makevar>PORTREVISION</makevar>-Variable ist ein
  + streng monoton wachsender Wert, welcher auf 0
  + zur&uuml;ckgesetzt wird, nachdem
  + <makevar>PORTVERSION</makevar> erh&ouml;ht wurde (d.h.
               jedes Mal, wenn ein offizielles Release erfolgt). Sie wird
  - an den Namen des Pakets angeh&auml;ngt, wenn sie ungleich 0 ist.
  - &Auml;nderungen an <makevar>PORTREVISION</makevar> werden von
  - automatisierten Werkzeugen (z.B. &man.pkg.version.1;)
  - genutzt, um anzuzeigen, dass ein neues Paket
  - verf&uuml;gbar ist.</para>
  -
  - <para><makevar>PORTREVISION</makevar> sollte jedes Mal erh&ouml;ht werden,
  - wenn eine &Auml;nderung am Port erfolgt, die betr&auml;chtliche Auswirkungen
  - auf den Inhalt oder Struktur des aus dem Port erzeugten Pakets
  + an den Namen des Pakets angeh&auml;ngt, wenn sie ungleich
  + 0 ist. &Auml;nderungen an <makevar>PORTREVISION</makevar>
  + werden von automatisierten Werkzeugen (z.B.
  + &man.pkg.version.1;) genutzt, um anzuzeigen, dass ein
  + neues Paket verf&uuml;gbar ist.</para>
  +
  + <para><makevar>PORTREVISION</makevar> sollte jedes Mal
  + erh&ouml;ht werden, wenn eine &Auml;nderung am Port
  + erfolgt, die betr&auml;chtliche Auswirkungen auf den
  + Inhalt oder Struktur des aus dem Port erzeugten Pakets
               zur Folge hat.</para>
   
  - <para>Beispiele daf&uuml;r, wann <makevar>PORTREVISION</makevar>
  - erh&ouml;ht werden sollte:</para>
  + <para>Beispiele daf&uuml;r, wann
  + <makevar>PORTREVISION</makevar> erh&ouml;ht werden sollte:
  + </para>
   
  - <itemizedlist>
  - <listitem>
  - <para>Hinzuf&uuml;gen von Patches, welche Sicherheitsl&uuml;cken schlie&szlig;en,
  - Fehler beseitigen oder neue Funktionalit&auml;t zum Port hinzuf&uuml;gen.</para>
  - </listitem>
  + <itemizedlist>
  + <listitem>
  + <para>Hinzuf&uuml;gen von Patches, welche
  + Sicherheitsl&uuml;cken schlie&szlig;en, Fehler
  + beseitigen oder neue Funktionalit&auml;t zum Port
  + hinzuf&uuml;gen.</para>
  + </listitem>
   
  - <listitem>
  - <para>&Auml;nderungen am <filename>Makefile</filename> des Ports, welche
  - compile-time-Optionen hinzuf&uuml;gen oder entfernen.</para>
  - </listitem>
  + <listitem>
  + <para>&Auml;nderungen am <filename>Makefile</filename>
  + des Ports, welche compile-time-Optionen
  + hinzuf&uuml;gen oder entfernen.</para>
  + </listitem>
   
  - <listitem>
  - <para>&Auml;nderungen bez&uuml;glich Packliste oder am Verhalten w&auml;hrend der
  - Installation des Pakets (d.h. &Auml;nderungen an einem Skript, welches
  - Ausgangsdaten f&uuml;r das Paket erzeugt, wie z.B. SSH-Hostschl&uuml;ssel).</para>
  - </listitem>
  + <listitem>
  + <para>&Auml;nderungen bez&uuml;glich Packliste oder am
  + Verhalten w&auml;hrend der Installation des Pakets
  + (d.h. &Auml;nderungen an einem Skript, welches
  + Ausgangsdaten f&uuml;r das Paket erzeugt, wie z.B.
  + SSH-Hostschl&uuml;ssel).</para>
  + </listitem>
   

----------------------------------------------
Diff block truncated. (Max lines = 200)
----------------------------------------------

To Unsubscribe: send mail to majordomo(at)de.FreeBSD.org
with "unsubscribe de-cvs-doc" in the body of the message
Received on Thu 02 Aug 2007 - 17:18:32 CEST

search this site