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

From: Aron Schlesinger <as(at)doc.bsdgroup.de>
Date: Sun, 5 Aug 2007 21:11:10 GMT

as 2007-08-05 21:11:10 UTC

  FreeBSD ports repository

  Modified files:
    books/porters-handbook book.sgml
  Log:
  Kapitel 7 Formatiert.
  
  Revision Changes Path
  1.107 +240 -220 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.106
  retrieving revision 1.107
  diff -u -I$FreeBSDde.*$ -r1.106 -r1.107
  --- book.sgml 5 Aug 2007 20:35:24 -0000 1.106
  +++ book.sgml 5 Aug 2007 21:11:09 -0000 1.107
  @@ -9180,105 +9180,115 @@
     </chapter>
   
     <chapter id="plist">
  - <title>Fortgeschrittene <filename>pkg-plist</filename>-Methoden</title>
  + <title>Fortgeschrittene
  + <filename>pkg-plist</filename>-Methoden</title>
   
       <sect1 id="plist-sub">
  - <title>&Auml;nderungen an <filename>pkg-plist</filename> mit Hilfe von
  - make-Variablen</title>
  + <title>&Auml;nderungen an <filename>pkg-plist</filename> mit
  + Hilfe von make-Variablen</title>
   
  - <para>Einige Ports, insbesondere die <literal>p5-</literal>-Ports,
  - m&uuml;ssen, abh&auml;ngig von ihren Konfigurationsoptionen
  - (oder im Falle der p5-Ports von der <literal>perl</literal>-Version), die
  - <filename>pkg-plist</filename> ver&auml;ndern. Um dies zu vereinfachen,
  - werden f&uuml;r jeden Eintrag in <filename>pkg-plist</filename>
  - die Variablen <literal>%%OSREL%%</literal>,
  - <literal>%%PERL_VER%%</literal> und <literal>%%PERL_VERSION%%</literal>
  - durch die jeweiligen Werte ersetzt. Der Wert von
  - <literal>%%OSREL%%</literal> ist die Revisionsnummer des
  - Betriebssystems (z.B. <literal>4.9</literal>).
  - <literal>%%PERL_VERSION%%</literal> gibt die vollst&auml;ndige
  - Versionsnummer von <command>perl</command> (z.B.
  - <literal>5.00502</literal>) und <literal>%%PERL_VER%%</literal>
  - die Versionsnummer ohne Patchlevel (z.B. <literal>5.005</literal>)
  - an. Weitere, die Dokumentationsdateien des Ports betreffende
  - <literal>%%<replaceable>VARS</replaceable>%%</literal>, werden im
  - <link linkend="install-documentation">entsprechenden Abschnitt</link>
  - erl&auml;utert.</para>
  -
  - <para>Falls Sie weitere Ersetzungen von Variablen durchf&uuml;hren m&uuml;ssen,
  - k&ouml;nnen Sie in der Variable <makevar>PLIST_SUB</makevar>
  - eine Liste von
  - <literal><replaceable>VAR</replaceable>=<replaceable>VALUE</replaceable></literal>
  - -Paaren angeben, wobei in der <filename>pkg-plist</filename>
  - <literal>%%<replaceable>VAR</replaceable>%%</literal>
  - durch <replaceable>VALUE</replaceable> ersetzt wird.</para>
  -
  - <para>Wenn Sie z.B. einen Port haben, der viele Dateien in ein
  - versionsspezifisches Unterverzeichnis installiert, dann k&ouml;nnen
  - Sie etwas wie</para>
  + <para>Einige Ports, insbesondere die
  + <literal>p5-</literal>-Ports, m&uuml;ssen, abh&auml;ngig von
  + ihren Konfigurationsoptionen (oder im Falle der p5-Ports von
  + der <literal>perl</literal>-Version), die
  + <filename>pkg-plist</filename> ver&auml;ndern. Um dies zu
  + vereinfachen, werden f&uuml;r jeden Eintrag in
  + <filename>pkg-plist</filename> die Variablen
  + <literal>%%OSREL%%</literal>, <literal>%%PERL_VER%%</literal>
  + und <literal>%%PERL_VERSION%%</literal> durch die jeweiligen
  + Werte ersetzt. Der Wert von <literal>%%OSREL%%</literal> ist
  + die Revisionsnummer des Betriebssystems (z.B.
  + <literal>4.9</literal>). <literal>%%PERL_VERSION%%</literal>
  + gibt die vollst&auml;ndige Versionsnummer von
  + <command>perl</command> (z.B. <literal>5.00502</literal>) und
  + <literal>%%PERL_VER%%</literal> die Versionsnummer ohne
  + Patchlevel (z.B. <literal>5.005</literal>) an. Weitere, die
  + Dokumentationsdateien des Ports betreffende
  + <literal>%%<replaceable>VARS</replaceable>%%</literal>, werden
  + im <link linkend="install-documentation">entsprechenden
  + Abschnitt</link> erl&auml;utert.</para>
  +
  + <para>Falls Sie weitere Ersetzungen von Variablen
  + durchf&uuml;hren m&uuml;ssen, k&ouml;nnen Sie in der Variable
  + <makevar>PLIST_SUB</makevar> eine Liste von
  + <literal><replaceable>VAR</replaceable>=<replaceable>VALUE</replaceable></literal>-Paaren
  + angeben, wobei in der <filename>pkg-plist</filename>
  + <literal>%%<replaceable>VAR</replaceable>%%</literal> durch
  + <replaceable>VALUE</replaceable> ersetzt wird.</para>
  +
  + <para>Wenn Sie z.B. einen Port haben, der viele Dateien in ein
  + versionsspezifisches Unterverzeichnis installiert, dann
  + k&ouml;nnen Sie etwas wie</para>
   
  - <programlisting>OCTAVE_VERSION= 2.0.13
  + <programlisting>OCTAVE_VERSION= 2.0.13
   PLIST_SUB= OCTAVE_VERSION=${OCTAVE_VERSION}</programlisting>
   
  - <para>in das <filename>Makefile</filename> schreiben und
  - <literal>%%OCTAVE_VERSION%%</literal> verwenden, unabh&auml;ngig davon,
  - wo die Variable in <filename>pkg-plist</filename> verwendet wird.
  - In diesem Fall m&uuml;ssen Sie bei einem Upgrade des Ports nicht
  - dutzende (oder manchmal sogar hunderte) Zeilen in
  - <filename>pkg-plist</filename> anpassen.</para>
  -
  - <para>Diese Ersetzung (ebenso wie das Hinzuf&uuml;gen weiterer
  - <link linkend="makefile-manpages">Manualpages</link>) wird
  - zwischen den <maketarget>pre-install</maketarget>- und
  - <maketarget>do-install</maketarget>-Targets ausgef&uuml;hrt,
  - indem aus <filename><makevar>PLIST</makevar></filename>
  - gelesen und in <filename><makevar>TMPPLIST</makevar></filename>
  - geschrieben wird (Standard:
  - <filename><makevar>WRKDIR</makevar>/.PLIST.mktmp</filename>).
  - Falls Ihr Port also <filename><makevar>PLIST</makevar></filename>
  - w&auml;hrend dem Erstellen generiert, so sollte dies vor oder in
  - <maketarget>pre-install</maketarget> geschehen. Muss Ihr Port
  - die resultierende Datei ver&auml;ndern, so sollte dies in
  - <maketarget>post-install</maketarget> mit der Ausgabedatei
  - <filename><makevar>TMPPLIST</makevar></filename>
  - erfolgen.</para>
  -
  - <para>Eine weitere M&ouml;glichkeit, die Paketliste eines Ports zu
  - ver&auml;ndern, besteht darin die Variablen <makevar>PLIST_FILES</makevar>
  - und <makevar>PLIST_DIRS</makevar> zu setzen.
  - Der Wert jeder der beiden Variablen stellt eine Liste von
  - Pfadnamen dar, die zusammen mit dem Inhalt von
  - <filename><makevar>PLIST</makevar></filename> in
  - <filename><makevar>TMPPLIST</makevar></filename> geschrieben
  - wird. Dabei unterliegen die Namen in <makevar>PLIST_FILES</makevar>
  - und <makevar>PLIST_DIRS</makevar> der weiter oben beschriebenen
  - Substitution von <literal>%%<replaceable>VAR</replaceable>%%</literal>.
  - Die Namen aus <makevar>PLIST_FILES</makevar> werden ansonsten
  - unver&auml;ndert in die endg&uuml;ltige Paketliste &uuml;bernommen,
  - w&auml;hrend den Namen aus <makevar>PLIST_DIRS</makevar> noch der Wert
  - von <literal>@dirrm</literal> vorangestellt wird.
  - Damit die Verwendung von <makevar>PLIST_FILES</makevar>
  - und <makevar>PLIST_DIRS</makevar> &uuml;berhaupt m&ouml;glich ist,
  - m&uuml;ssen diese gesetzt werden, bevor
  - <filename><makevar>TMPPLIST</makevar></filename>
  - geschrieben wird - z.B. in <maketarget>pre-install</maketarget>
  - oder vorher.</para>
  + <para>in das <filename>Makefile</filename> schreiben und
  + <literal>%%OCTAVE_VERSION%%</literal> verwenden,
  + unabh&auml;ngig davon, wo die Variable in
  + <filename>pkg-plist</filename> verwendet wird. In diesem Fall
  + m&uuml;ssen Sie bei einem Upgrade des Ports nicht dutzende
  + (oder manchmal sogar hunderte) Zeilen in
  + <filename>pkg-plist</filename> anpassen.</para>
  +
  + <para>Diese Ersetzung (ebenso wie das Hinzuf&uuml;gen weiterer
  + <link linkend="makefile-manpages">Manualpages</link>) wird
  + zwischen den <maketarget>pre-install</maketarget>- und
  + <maketarget>do-install</maketarget>-Targets ausgef&uuml;hrt,
  + indem aus <filename><makevar>PLIST</makevar></filename>
  + gelesen und in
  + <filename><makevar>TMPPLIST</makevar></filename> geschrieben
  + wird (Standard:
  + <filename><makevar>WRKDIR</makevar>/.PLIST.mktmp</filename>).
  + Falls Ihr Port also
  + <filename><makevar>PLIST</makevar></filename> w&auml;hrend dem
  + Erstellen generiert, so sollte dies vor oder in
  + <maketarget>pre-install</maketarget> geschehen. Muss Ihr Port
  + die resultierende Datei ver&auml;ndern, so sollte dies in
  + <maketarget>post-install</maketarget> mit der Ausgabedatei
  + <filename><makevar>TMPPLIST</makevar></filename>
  + erfolgen.</para>
  +
  + <para>Eine weitere M&ouml;glichkeit, die Paketliste eines
  + Ports zu ver&auml;ndern, besteht darin die Variablen
  + <makevar>PLIST_FILES</makevar> und
  + <makevar>PLIST_DIRS</makevar> zu setzen. Der Wert jeder der
  + beiden Variablen stellt eine Liste von Pfadnamen dar, die
  + zusammen mit dem Inhalt von
  + <filename><makevar>PLIST</makevar></filename> in
  + <filename><makevar>TMPPLIST</makevar></filename> geschrieben
  + wird. Dabei unterliegen die Namen in
  + <makevar>PLIST_FILES</makevar> und
  + <makevar>PLIST_DIRS</makevar> der weiter oben beschriebenen
  + Substitution von
  + <literal>%%<replaceable>VAR</replaceable>%%</literal>. Die
  + Namen aus <makevar>PLIST_FILES</makevar> werden ansonsten
  + unver&auml;ndert in die endg&uuml;ltige Paketliste
  + &uuml;bernommen, w&auml;hrend den Namen aus
  + <makevar>PLIST_DIRS</makevar> noch der Wert von
  + <literal>@dirrm</literal> vorangestellt wird. Damit die
  + Verwendung von <makevar>PLIST_FILES</makevar> und
  + <makevar>PLIST_DIRS</makevar> &uuml;berhaupt m&ouml;glich
  + ist, m&uuml;ssen diese gesetzt werden, bevor
  + <filename><makevar>TMPPLIST</makevar></filename> geschrieben
  + wird&nbsp;&ndash;&nbsp;z.B. in
  + <maketarget>pre-install</maketarget> oder vorher.</para>
       </sect1>
   
       <sect1 id="plist-cleaning">
  - <title>Leere Verzeichnisse</title>
  + <title>Leere Verzeichnisse</title>
   
  - <sect2 id="plist-dir-cleaning">
  - <title>Aufr&auml;umen leerer Verzeichnisse</title>
  + <sect2 id="plist-dir-cleaning">
  + <title>Aufr&auml;umen leerer Verzeichnisse</title>
   
  - <para>Bitte sorgen Sie daf&uuml;r, dass ihre Ports bei der Deinstallation
  - leere Verzeichnisse l&ouml;schen. Dazu wird f&uuml;r jedes
  - Verzeichnis, das der Port erzeugt hat, eine
  - <literal>@dirrm</literal>-Zeile angegeben. Um ein Verzeichnis zu
  - l&ouml;schen m&uuml;ssen Sie zuerst dessen Unterverzeichnisse
  - entfernen.</para>
  + <para>Bitte sorgen Sie daf&uuml;r, dass ihre Ports bei der

----------------------------------------------
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 Sun 05 Aug 2007 - 23:12:28 CEST

search this site