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

From: Aron Schlesinger <as(at)doc.bsdgroup.de>
Date: Wed, 1 Aug 2007 22:52:09 GMT

as 2007-08-01 22:52:09 UTC

  FreeBSD ports repository

  Modified files:
    books/porters-handbook book.sgml
  Log:
  Kapitel 4 entsprechend den FDP-Vorgaben umformatiert.
  
  Revision Changes Path
  1.94 +380 -357 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.93
  retrieving revision 1.94
  diff -u -I$FreeBSDde.*$ -r1.93 -r1.94
  --- book.sgml 1 Aug 2007 21:41:49 -0000 1.93
  +++ book.sgml 1 Aug 2007 22:52:09 -0000 1.94
  @@ -479,389 +479,412 @@
       </sect1>
     </chapter>
   
  - <chapter id="slow">
  + <chapter id="slow">
       <title>Einen Port in aller Ruhe erstellen</title>
   
       <para>Ok, das war nicht ganz einfach und der Port hat einige
  - Ver&auml;nderungen erfordert, um funktionieren zu k&ouml;nnen. In diesem
  - Abschnitt werden wir Schritt f&uuml;r Schritt erkl&auml;ren, wie
  - man den funktionierenden Port den Vorgaben der Ports entsprechend anpasst.</para>
  -
  - <sect1 id="slow-work">
  - <title>Die Funktionsweise</title>
  -
  - <para>Beginnen wir mit der Abfolge der Ereignisse, die eintreten,
  - wenn der Nutzer das erste <command>make</command> in Ihrem Portsverzeichnis ausf&uuml;hrt.
  - Sie empfinden es f&uuml;r das Verst&auml;ndnis vielleicht
  - hilfreich <filename>bsd.port.mk</filename> in einem anderen
  - Fenster offen zu haben, w&auml;hrend Sie diesen Abschnitt lesen.</para>
  -
  - <para>Aber machen Sie sich keine Sorgen, falls Sie
  - nicht wirklich verstehen, was <filename>bsd.port.mk</filename>
  - macht, die wenigsten tun dies... <!-- smiley -->
  - <emphasis>:&gt;</emphasis></para>
  + Ver&auml;nderungen erfordert, um funktionieren zu k&ouml;nnen.
  + In diesem Abschnitt werden wir Schritt f&uuml;r Schritt
  + erkl&auml;ren, wie man den funktionierenden Port den Vorgaben
  + der Ports entsprechend anpasst.</para>
  +
  + <sect1 id="slow-work">
  + <title>Die Funktionsweise</title>
  +
  + <para>Beginnen wir mit der Abfolge der Ereignisse, die
  + eintreten, wenn der Nutzer das erste <command>make</command>
  + in Ihrem Portsverzeichnis ausf&uuml;hrt. Sie empfinden es
  + f&uuml;r das Verst&auml;ndnis vielleicht hilfreich
  + <filename>bsd.port.mk</filename> in einem anderen Fenster
  + offen zu haben, w&auml;hrend Sie diesen Abschnitt lesen.
  + </para>
   
  - <procedure>
  + <para>Aber machen Sie sich keine Sorgen, falls Sie nicht
  + wirklich verstehen, was <filename>bsd.port.mk</filename>
  + macht, die wenigsten tun dies... <!-- smiley -->
  + <emphasis>:&gt;</emphasis></para>
   
  - <step>
  - <para>Das Target <maketarget>fetch</maketarget> wird
  - aufgerufen. Es ist daf&uuml;r verantwortlich sicherzustellen,
  - dass der Tarball lokal im <makevar>DISTDIR
  - </makevar> verf&uuml;gbar ist. Falls <maketarget>fetch
  - </maketarget> die ben&ouml;tigten Dateien in <makevar>
  - DISTDIR</makevar> nicht finden kann, durchsucht es die
  - URL <makevar>MASTER_SITES</makevar>, welche im Makefile
  - gesetzt ist, ebenso wie unsere Haupt-FTP-Seite unter
  - <ulink url="ftp://ftp.FreeBSD.org/pub/FreeBSD/ports/distfiles">
  - </ulink>, wo wir genehmigte Distfiles als Backup
  - aufbewahren. Danach wird versucht, so eine direkte Internetverbindung besteht,
  - dass genannte Distfile
  - mit <makevar>FETCH</makevar> herunterzuladen.
  - Falls dies gelingt, wird die Datei in <makevar>DISTDIR
  - </makevar> f&uuml;r weitere Nutzung abgelegt und f&auml;hrt
  - fort.</para>
  - </step>
  + <procedure>
  + <step>
  + <para>Das Target <maketarget>fetch</maketarget> wird
  + aufgerufen. Es ist daf&uuml;r verantwortlich
  + sicherzustellen, dass der Tarball lokal im
  + <makevar>DISTDIR</makevar> verf&uuml;gbar ist. Falls
  + <maketarget>fetch</maketarget> die ben&ouml;tigten Dateien
  + in <makevar>DISTDIR</makevar> nicht finden kann,
  + durchsucht es die URL <makevar>MASTER_SITES</makevar>,
  + welche im Makefile gesetzt ist, ebenso wie unsere
  + Haupt-FTP-Seite unter <ulink
  + url="ftp://ftp.FreeBSD.org/pub/FreeBSD/ports/distfiles">
  + </ulink>, wo wir genehmigte Distfiles als Backup
  + aufbewahren. Danach wird versucht, so eine direkte
  + Internetverbindung besteht, dass genannte Distfile mit
  + <makevar>FETCH</makevar> herunterzuladen. Falls dies
  + gelingt, wird die Datei in <makevar>DISTDIR</makevar>
  + f&uuml;r weitere Nutzung abgelegt und f&auml;hrt fort.
  + </para>
  + </step>
   
  - <step>
  - <para>Das Target <maketarget>extract</maketarget> wird
  - aufgerufen. Es sucht nach den Distfiles Ihres Ports
  - (normalerweise ein gzip-komprimierter Tarball) in
  - <makevar>DISTDIR</makevar> und entpackt diese in ein
  - tempor&auml;res Unterverzeichnis, welches von <makevar>
  - WRKDIR</makevar> festgelegt wird
  - (standardm&auml;&szlig;ig <filename>work</filename>).</para>
  - </step>
  + <step>
  + <para>Das Target <maketarget>extract</maketarget> wird
  + aufgerufen. Es sucht nach den Distfiles Ihres Ports
  + (normalerweise ein gzip-komprimierter Tarball) in
  + <makevar>DISTDIR</makevar> und entpackt diese in ein
  + tempor&auml;res Unterverzeichnis, welches von <makevar>
  + WRKDIR</makevar> festgelegt wird (standardm&auml;&szlig;ig
  + <filename>work</filename>).</para>
  + </step>
   
  - <step>
  - <para>Das Target <maketarget>patch</maketarget> wird
  - aufgerufen. Zuerst werden alle in <makevar>PATCHFILES
  - </makevar> festgelegten Patches eingespielt.
  - Anschlie&szlig;end werden, falls Patches der Form
  - <filename>patch-<replaceable>*</replaceable></filename> in
  - <makevar>PATCHDIR</makevar> (standardm&auml;&szlig;ig das
  - <filename>files</filename>-Unterverzeichnis) gefunden
  - werden, diese in alphabetischer Reihenfolge eingespielt.</para>
  - </step>
  + <step>
  + <para>Das Target <maketarget>patch</maketarget> wird
  + aufgerufen. Zuerst werden alle in
  + <makevar>PATCHFILES</makevar> festgelegten Patches
  + eingespielt. Anschlie&szlig;end werden, falls Patches der
  + Form
  + <filename>patch-<replaceable>*</replaceable></filename> in
  + <makevar>PATCHDIR</makevar> (standardm&auml;&szlig;ig das
  + <filename>files</filename>-Unterverzeichnis) gefunden
  + werden, diese in alphabetischer Reihenfolge eingespielt.
  + </para>
  + </step>
   
  - <step>
  - <para>Das Target <maketarget>configure</maketarget> wird
  - aufgerufen. Dieses kann viele verschiedene Dinge machen.</para>
  + <step>
  + <para>Das Target <maketarget>configure</maketarget> wird
  + aufgerufen. Dieses kann viele verschiedene Dinge machen.
  + </para>
   
  - <orderedlist>
  - <listitem>
  - <para>Existiert <filename>scripts/configure</filename>, so
  - wird es aufgerufen.</para>
  - </listitem>
  + <orderedlist>
  + <listitem>
  + <para>Existiert <filename>scripts/configure</filename>,
  + so wird es aufgerufen.</para>
  + </listitem>
  +
  + <listitem>
  + <para>Falls <makevar>HAS_CONFIGURE</makevar> oder
  + <makevar>GNU_CONFIGURE</makevar> gesetzt sind, wird
  + <filename><makevar>WRKSRC</makevar>/configure
  + </filename>ausgef&uuml;hrt.</para>
  + </listitem>
  +
  + <listitem>
  + <para>Falls <makevar>USE_IMAKE</makevar> gesetzt ist,
  + wird <makevar>XMKMF</makevar>
  + (standardm&auml;&szlig;ig <command>xmkmf -a</command>)
  + ausgef&uuml;hrt.</para>
  + </listitem>
  + </orderedlist>
  + </step>
   
  - <listitem>
  - <para>Falls <makevar>HAS_CONFIGURE</makevar> oder
  - <makevar>GNU_CONFIGURE</makevar> gesetzt sind, wird
  - <filename><makevar>WRKSRC</makevar>/configure
  - </filename>ausgef&uuml;hrt.</para>
  - </listitem>
  + <step>
  + <para>Das Target <maketarget>build</maketarget> wird
  + aufgerufen. Es ist f&uuml;r das Wechseln in das private
  + Arbeitsverzeichnis (<makevar>WRKSRC</makevar>) und das
  + Bauen des Ports zust&auml;ndig. Ist
  + <makevar>USE_GMAKE</makevar> gesetzt, so wird GNU
  + <command>make</command> verwendet, sonst das System
  + <command>make</command>.</para>
  + </step>
  + </procedure>
   
  - <listitem>
  - <para>Falls <makevar>USE_IMAKE</makevar> gesetzt ist,
  - wird <makevar>XMKMF</makevar>
  - (standardm&auml;&szlig;ig <command>xmkmf -a</command>)
  - ausgef&uuml;hrt.</para>
  - </listitem>
  - </orderedlist>
  - </step>
  + <para>Die oben genannten Aktionen sind die Standardaktionen.
  + Zus&auml;tzlich k&ouml;nnen Sie <maketarget>pre-<replaceable>
  + irgendwas</replaceable></maketarget> oder

----------------------------------------------
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 - 00:53:31 CEST

search this site