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

From: Aron Schlesinger <as(at)doc.bsdgroup.de>
Date: Mon, 10 Sep 2007 00:30:43 GMT

as 2007-09-10 00:30:43 UTC

  FreeBSD German Documentation Repository

  Modified files:
    books/developers-handbook/policies chapter.sgml
  Log:
  Kapitel 5 gegengelesen und korrigiert.
  
  Gesendet von: Dennis Knorr
  
  Revision Changes Path
  1.6 +86 -83 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.5
  retrieving revision 1.6
  diff -u -I$FreeBSDde.*$ -r1.5 -r1.6
  --- chapter.sgml 31 Aug 2007 06:13:10 -0000 1.5
  +++ chapter.sgml 10 Sep 2007 00:30:43 -0000 1.6
  @@ -54,22 +54,22 @@
         um beigesteuerte Software handelt, er neue Versionen verfolgt
         und diese bereitstellt.</para>
   
  - <para>&Auml;nderungen an Verzeichnissen, welcher ein Maintainer
  + <para>&Auml;nderungen an Verzeichnissen, welche 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
  + &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>
  + Gruppe den Status eines Maintainers zu geben, so lange sie nicht
  + zustimmt, diese Pflicht auf sich zu nehmen. Andererseits muss es kein
  + einzelner Mensch sein. Eine Gruppe von Menschen ist genauso
  + in Ordnung.</para>
     </sect1>
   
     <sect1 id="policies-contributed">
  @@ -95,48 +95,49 @@
       <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>,
  + <emphasis>contributed</emphasis> Software. Beispiele daf&uuml;r
  + sind <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>
  + um solche Software zu verwalten und alle haben Vorteile
  + wie auch Nachteile. Dabei hat sich kein Gewinner
  + herauskristallisiert</para>
   
  - <para>Es wurde viel &uuml;ber diesen Umstand debattiert und so
  - wurde eine Methode als die <quote>offizielle</quote> Methode
  + <para>Es wurde viel &uuml;ber diesen Umstand diskutiert und so
  + wurde eine Methode als die <quote>offizielle</quote> Version
         gew&auml;hlt, um in Zukunft diese Art der Software zu
  - importieren. Ferner wird es dringend vorgeschlagen, dass
  + importieren. Ferner wird dringend geraten, 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>
  + ann&auml;hert, da es signifikante Vorteile gegen&uuml;ber der
  + alten Methode gibt. Dazu geh&ouml;rt auch die
  + Leistungsf&auml;higkeit einfache Diffs, bezogen auf die
  + <quote>offiziellen</quote> Version, f&uuml;r jeden zu erzeugen,
  + auch ohne CVS-Zugang. Dies wird es deutlich vereinfachen,
  + &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
  + m&ouml;glich ist, 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
  + 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-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>
  + nutzt, ist von kleinen und/oder kosmetischen &Auml;nderungen
  + <emphasis>sehr abzuraten</emphasis> bei Dateien, welche
  + den Herstellerzweig verfolgen. <quote>Grammatikalische oder
  + sprachliche 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
  @@ -145,23 +146,25 @@
   
       <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
  - <filename>compat</filename> vor dem Import entfernt.</para>
  + Teile, welche unter FreeBSD nicht g&auml;nzlich nutzbar sind,
  + k&ouml;nnen entfernt werden. Im Fall von Tcl wurden die
  + Unterverzeichnisse <filename>mac</filename>,
  + <filename>win</filename> und <filename>compat</filename>
  + vor dem Import entfernt.</para>
   
  - <para><filename>src/lib/libtcl</filename> enth&auml;lt nur ein
  + <para><filename>src/lib/libtcl</filename> enth&auml;lt ein
         <filename>Makefile</filename> im
         <application>bmake</application>-Stil, welches die Regeln des
         Standard-Makefile <filename>bsd.lib.mk</filename> nutzt, um
         die Bibliothek zu erstellen und die Dokumentation zu
         installieren.</para>
   
  - <para><filename>src/usr.bin/tclsh</filename>enth&auml;lt nur ein
  - <filename>Makefile</filename> im bmake-Stil, welches das
  + <para><filename>src/usr.bin/tclsh</filename>enth&auml;lt ein
  + <filename>Makefile</filename> im
  + <application>bmake</application>-Stil, welches das
         <command>tclsh</command>-Programm erstellt und installiert,
  - ebenso die dazugeh&ouml;rigen Manualpages, welche die Regeln
  - von <filename>bsd.prog.mk</filename> nutzen.</para>
  + ebenso die dazugeh&ouml;rigen Manualpages, welche die Regeln von
  + <filename>bsd.prog.mk</filename> nutzen.</para>
   
       <para><filename>src/tools/tools/tcl_bmake</filename> enth&auml;lt
         einige Shellskripte, welche hilfreich sein k&ouml;nnen, wenn die
  @@ -170,20 +173,19 @@
   
       <para>Das Entscheidende ist hier das
         <filename>src/contrib/tcl</filename>-Verzeichnis, welches durch
  - die entsprechenden Regeln erstellt wird: Es wird unterstellt,
  - dass der Quelltext im Original vorhanden ist
  - (ohne RCS-Schl&uuml;sselworte und im korrekten
  - CVS-Herstellerzweig) mit so wenig wie m&ouml;glich
  - FreeBSD-spezifischen &Auml;nderungen. Sollte es Zweifel geben,
  - wie hier zu verfahren ist, ist es selbstverst&auml;ndlich
  - zuerst nachzufragen und nicht auf gut Gl&uuml;ck etwas zu
  - probieren in der vagen Hoffnung, dass es <quote>irgendwie
  - tut</quote>.
  - CVS vergibt keine Fehler beim Importieren und ein hoher
  - Arbeitsaufwand w&auml;re die Folge, um diesen grossen Fehler
  - wieder wettzumachen.</para>
  + die entsprechenden Regeln erstellt wird: Man nimmt an, dass der
  + Quelltext im Original vorhanden ist (ohne
  + RCS-Schl&uuml;sselworte und im korrekten CVS-Herstellerzweig)
  + mit so wenig FreeBSD-spezifischen &Auml;nderungen wie
  + m&ouml;glich. Sollte es Zweifel geben, wie hier zu verfahren
  + ist, ist es selbstverst&auml;ndlich zuerst nachzufragen und
  + nicht auf gut Gl&uuml;ck etwas zu probieren in der vagen
  + Hoffnung, dass es <quote>irgendwie tut</quote>. CVS vergibt
  + keine Fehler beim Importieren und ein hoher Arbeitsaufwand
  + w&auml;re die Folge, um diesen grossen Fehler wieder
  + wettzumachen.</para>
   
  - <para>Durch die Eingangs schon erw&auml;hnten Einschr&auml;nkungen
  + <para>Durch die eingangs schon erw&auml;hnten Einschr&auml;nkungen
         durch das Design beim CVS-Herstellerzweig, ist es erforderlich,
         dass <quote>offizielle</quote> Fehlerbehebungen vom Hersteller
         bei den Originalquellen der Distribution einfliessen und als
  @@ -198,20 +200,20 @@
         Kompatibilit&auml;t mit anderen Architekturen und Umgebungen
         wie FreeBSD gedacht sind, ist es zul&auml;ssig diese Teile zu
         l&ouml;schen, wenn sie f&uuml;r FreeBSD nicht von Interesse
  - sind, da dadurch Speicherplatz gespart wird. Dateien welche
  - ein Copyright enthalten und eine Art von Release-Informationen
  - zu den vorhandenen Dateien, sollten
  - <emphasis>nicht</emphasis> gel&ouml;scht werden.</para>
  + sind, da dadurch Speicherplatz gespart wird. Dateien, welche ein
  + Copyright und Release-artige Informationen zu den vorhandenen
  + Dateien enthalten, sollten <emphasis>nicht</emphasis>
  + gel&ouml;scht werden.</para>
   
       <para>Falls es einfacher erscheint k&ouml;nnen die
  - <command>bmake</command>-<filename>Makefile</filename>s
  - vom Verzeichnisbaum durch einige Dienstprogramme
  - automatisch erstellt werden, was es hoffentlich
  - sogar noch einfacher macht auf eine Version zu aktualisieren.
  - Ist dies geschehen, so stellen Sie bitte sicher diese Werkzeuge
  - in das Verzeichnis <filename>src/tools</filename> mit dem Port
  - an sich einzuchecken, so dass es f&uuml;r zuk&uuml;nftige

----------------------------------------------
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 Mon 10 Sep 2007 - 02:32:11 CEST

search this site