cvs commit: de-docproj/books/developers-handbook/policies chapter.sgml

From: Aron Schlesinger <as(at)doc.bsdgroup.de>
Date: Wed, 29 Aug 2007 02:43:33 GMT

as 2007-08-29 02:43:33 UTC

  FreeBSD ports repository

  Modified files:
    books/developers-handbook/policies chapter.sgml
  Log:
  Korrekturlesung vom Kapiel 5.
  ( es folgt eine 2.!)
  
  Gesendet von: ds@
  
  Revision Changes Path
  1.3 +231 -215 de-docproj/books/developers-handbook/policies/chapter.sgml
  
  Index: chapter.sgml
  ===================================================================
  RCS file: /home/cvs/de-docproj/books/developers-handbook/policies/chapter.sgml,v
  retrieving revision 1.2
  retrieving revision 1.3
  diff -u -I$FreeBSDde.*$ -r1.2 -r1.3
  --- chapter.sgml 25 Aug 2007 03:19:35 -0000 1.2
  +++ chapter.sgml 29 Aug 2007 02:43:33 -0000 1.3
  @@ -12,7 +12,7 @@
         <author>
           <firstname>Poul-Henning</firstname>
           <surname>Kamp</surname>
  - <contrib>Beigesteuert von</contrib>
  + <contrib>Beigesteuert von </contrib>
         </author>
       </authorgroup>
       <!-- June 1996 -->
  @@ -20,44 +20,45 @@
   
     <title>Vorgaben und Richtlinien f&uuml;r das Quelltextverzeichnis</title>
     
  - <para>Dieses Kapitel dokumentiert verschiedene Vorgaben und
  - Richtlinien f&uuml;r das FreeBSD Quelltextverzeichnis.</para>
  + <para>Dieses Kapitel dokumentiert verschiedene Vorgaben und
  + Richtlinien f&uuml;r das FreeBSD-Quelltextverzeichnis.</para>
     
     <sect1 id="policies-maintainer">
       <title><makevar>MAINTAINER</makevar> eines Makefiles</title>
       <indexterm><primary>Ports Maintainer</primary></indexterm>
       
  - <para>Wenn ein bestimmter Bereich der FreeBSD Distribution von
  - einer Person, oder Gruppe, gepflegt wird, kann dies durch
  - hinzuf&uuml;gen der Zeile
  + <para>Wenn ein bestimmter Bereich der FreeBSD-Distribution von
  + einer Person oder Gruppe gepflegt wird, kann dies durch
  + Hinzuf&uuml;gen der Zeile
   
         <programlisting>MAINTAINER= email-addresses</programlisting>
   
  - im<filename>Makefile</filename>der Welt mitgeteilt werden.</para>
  + im <filename>Makefile</filename> der &Ouml;ffentlichkeit
  + mitgeteilt werden.</para>
   
       <para>Dies bedeutet folgendes:</para>
       
  - <para>Der Maintainer ist verantwortlich f&uuml;r diesen Code code. Dies
  - bedeutet, dass er einerseits f&uuml;r die Behebung von Fehlern und dem
  - beantworten von Problemberichten f&uuml;r diesen Code die
  - Verantwortung tr&auml;gt, andererseits, so es sich um
  - beigesteuerte Software handelt, er neue Versionen verfolgt und
  + <para>Der Maintainer ist verantwortlich f&uuml;r diesen Code. Dies
  + bedeutet, dass er einerseits f&uuml;r die Behebung von Fehlern
  + und das Beantworten von Problemberichten f&uuml;r diesen Code
  + die Verantwortung tr&auml;gt, andererseits, falls es sich um
  + beigesteuerte Software handelt, er neue Versionen verfolgt und
         diese bereitstellt.</para>
   
  - <para>&Auml;nderungen an Verzeichnissen welcher ein Maintainer
  - definiert hat, sollten an den Maintainer, f&uuml;r eine
  - &Uuml;perpr&uuml;fung gesendet werden, bevor diese committed
  - werden. Nur wenn der Maintainer in einer inakzeptablen Zeitspanne,
  - auf mehrere E-Mails, nicht antwortet, k&ouml;nnen die
  - &Auml;nderungen durch den commit, auch ohne &Uuml;perpr&uuml;fung
  - des Maintainers, vollzogen werden. Dennoch wird vorgeschlagen,
  - dass die &Auml;nderungen, wenn m&ouml;glich, durch jemand anderen
  - &Uuml;berpr&uuml;pft werden.</para>
  -
  - <para>Es ist nicht akzeptabel einer Person, oder Gruppe, den Status
  - eines Maintainers zu geben, so lange dieser Pflicht nicht
  - zugestimmt wird. Auf der anderen Seite muss es kein Committer sein
  - und so kann es leicht eine Gruppe von Leuten sein.</para>
  + <para>&Auml;nderungen an Verzeichnissen, welcher ein Maintainer
  + definiert hat, sollten an den Maintainer f&uuml;r eine
  + &Uuml;berpr&uuml;fung gesendet werden, bevor diese committed
  + werden. Nur wenn der Maintainer in einer inakzeptablen Zeitspanne
  + auf mehrere E-Mails nicht antwortet, k&ouml;nnen die
  + &Auml;nderungen durch den Commit, auch ohne &Uuml;berpr&uuml;fung
  + des Maintainers, vollzogen werden. Dennoch wird vorgeschlagen,
  + dass die &Auml;nderungen, falls m&ouml;glich, durch jemand anderen
  + &uuml;berpr&uuml;ft werden.</para>
  +
  + <para>Es ist nat&uuml;rlich nicht akzeptabel einer Person oder Gruppe
  + den Status eines Maintainers zu geben, so lange dieser Pflicht nicht
  + zugestimmt wurde. Andererseits muss es kein Committer und auch eine
  + eine Gruppe von Menschen ist selbstverst&auml;ndlich legitim.</para>
     </sect1>
     
     <sect1 id="policies-contributed">
  @@ -66,7 +67,7 @@
           <author>
             <firstname>Poul-Henning</firstname>
             <surname>Kamp</surname>
  - <contrib>Beigesteuert von</contrib>
  + <contrib>Beigesteuert von </contrib>
           </author>
           <author>
             <firstname>David</firstname>
  @@ -80,147 +81,156 @@
       
       <indexterm><primary>Beigesteuerte Software</primary></indexterm>
       
  - <para>Einige Teile der FreeBSD Distribution enthalten Software
  - welche aktiv ausserhalb des FreeBSD Projects gepflegt wird.
  - Aus historischen Gr&uuml;nden nennen wir dies
  + <para>Einige Teile der FreeBSD-Distribution enthalten Software,
  + welche aktiv ausserhalb des FreeBSD-Projektes gepflegt wird.
  + Aus historischen Gr&uuml;nden nennen wir dies
         <emphasis>contributed</emphasis> Software. Beispiele dazu sind
  - <application>sendmail</application>, <application>gcc</application>
  - und <application>patch</application>.</para>
  + <application>sendmail</application>,
  + <application>gcc</application> und
  + <application>patch</application>.</para>
      
  - <para>&Uuml;ber die Jahre wurden verschiedenen Methoden genutzt um
  - diese Art der Software zu handhaben, und alle haben Vorteile wie
  - auch Nachteile. So gibt es keinen klaren Gewinner.</para>
  -
  - <para>Es wurde viel &uuml;ber diesen Umstand debattiert, und so
  - wurde eine Methode als die <quote>offizielle</quote> Methode
  - gew&auml;hlt um in Zukunft diese Art der Software zu importieren.
  - Ferner wird es dringend vorgeschlagen, das existierende
  - beigesteuerte Software sich diesem Modell n&auml;hern, da es
  - signifikante Vorteile gegen&uuml;ber der alten Methode gibt.
  - Beispielsweise die Leistungsf&auml;higkeit einfach diffs von der
  - <quote>offiziellen</quote> Version zu beziehen, und das f&uuml;r
  - jedermann, (auch ohne CVS Zugang). Dies wird es deutlich einfacher
  - machen &Auml;nderungen an die Hauptentwickler zur&uuml;fliessen zu
  - lassen.</para>
  -
  - <para>Letztendlich kommt es auf die Leute an die die Arbeit machen.
  - Wenn die Nutzung dieses Modells teilweise nicht M&ouml;glich ist,
  - so k&uml;nnen Ausnahmen von diesen Regeln gew&auml;hrt werden,
  - diese m&uuml;ssen aber durch das Core Team genehmigt, und mit
  - &Uuml;bereinstimmung der anderen Developer, werden. Das
  - Verm&ouml;gen dieses Paket auch in Zukunft pflegen zu k&ouml;nnen
  - ist eine der Schl&uuml;sselfragen bei dieser Entscheidung.</para>
  + <para>&Uuml;ber die Jahre wurden verschiedenen Methoden genutzt,
  + um diese Art der Software zu handhaben, und alle haben Vorteile
  + wie auch Nachteile. So gibt es keinen klaren Gewinner.</para>
  +
  + <para>Es wurde viel &uuml;ber diesen Umstand debattiert und so
  + wurde eine Methode als die <quote>offizielle</quote> Methode
  + gew&auml;hlt, um in Zukunft diese Art der Software zu
  + importieren. Ferner wird es dringend vorgeschlagen, dass
  + existierende, beigesteuerte Software sich diesem Modell
  + n&auml;hert, da es signifikante Vorteile gegen&uuml;ber der
  + alten Methode gibt. Beispielsweise die Leistungsf&auml;higkeit
  + einfach Diffs von der <quote>offiziellen</quote> Version zu
  + beziehen und das f&uuml;r jedermann (auch ohne CVS-Zugang).
  + Dies wird es deutlich einfacher machen &Auml;nderungen an die
  + Hauptentwickler zur&uuml;fliessen zu lassen.</para>
  +
  + <para>Letztendlich kommt es auf die Menschen an, welche die Arbeit
  + leisten. Wenn die Nutzung dieses Modells teilweise nicht
  + m&ouml;glich ist, so k&uml;nnen Ausnahmen von diesen Regeln
  + gew&auml;hrt werden, diese m&uuml;ssen aber durch das Core Team
  + und mit &Uuml;bereinstimmung der anderen Developer genehmigt
  + werden. Die F&auml;higkeit dieses Paket auch in Zukunft pflegen
  + zu k&ouml;nnen ist eine der Schl&uuml;sselfragen bei dieser
  + Entscheidung.</para>
   
       <note>
  - <para>Durch einige bedauernswerte Einschr&auml;nkungen beim
  - Design des RCS Dateiformats und wie CVS vendor branches nutzt,
  - sind kleine und/oder kosmetische &Auml;nderungen
  - <emphasis>sehr entmutigend</emphasis> bei Dateien die die
  - Hersteller branche verfolgen. <quote>Sprechende Fehlerbehebungen</quote>
  - sind explizit unter der <quote>kosmetischen</quote> Kategorie
  - vorhanden und sollten bei Dateien mit einer 1.1.x.x Revision
  - verhindert werden. Das Repository kann sich durch &Auml;nderungen
  - an einzelnen Zeichen dramatisch aufbl&auml;hen.</para>
  + <para>Durch einige bedauernswerte Einschr&auml;nkungen beim
  + Design des RCS-Dateiformates und wie CVS Vendor Branches
  + nutzt, sind kleine und/oder kosmetische &Auml;nderungen
  + <emphasis>sehr entmutigend</emphasis> bei Dateien, welche
  + den Herstellerzweig verfolgen.
  + <quote>Sprechende Fehlerbehebungen</quote>
  + sind explizit unter der <quote>kosmetischen</quote>-Kategorie
  + vorhanden und sollten bei Dateien mit einer 1.1.x.x-Revision
  + verhindert werden. Das Repository kann sich durch
  + &Auml;nderungen an einzelnen Zeichen dramatisch
  + aufbl&auml;hen.</para>
       </note>
       
  - <para>Die eingebettete <application>Tcl</application>
  - Programmiersprache soll als Beispiel dienen wie dieses Modell
  - funktioniert:</para>
  -
  - <para><filename>src/contrib/tcl</filename>enth&auml;lt den
  - Quelltext wie vom Maintainer dieses Paketes bereitgestellt. Teile
  - welche unter FreeBSD nicht nutzbar sind, k&ouml;nnen entfernt
  - werden. Im Fall von Tcl wurden die Unterverzeichnisse
  - <filename>mac</filename>, <filename>win</filename> und
  + <para>Die eingebettete
  + <application>Tcl</application>-Programmiersprache soll als
  + Beispiel dienen, wie dieses Modell funktioniert:</para>
  +
  + <para><filename>src/contrib/tcl</filename> enth&auml;lt den
  + Quelltext wie vom Maintainer dieses Paketes bereitgestellt.

----------------------------------------------
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 Wed 29 Aug 2007 - 04:44:55 CEST

search this site