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

From: Aron Schlesinger <as(at)doc.bsdgroup.de>
Date: Fri, 21 Sep 2007 20:30:41 GMT

as 2007-09-21 20:30:41 UTC

  FreeBSD German Documentation Repository

  Modified files:
    books/developers-handbook/policies chapter.sgml
  Log:
  Zulange Zeilen gekürzt.
  
  Revision Changes Path
  1.8 +57 -53 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.7
  retrieving revision 1.8
  diff -u -I$FreeBSDde.*$ -r1.7 -r1.8
  --- chapter.sgml 21 Sep 2007 20:20:14 -0000 1.7
  +++ chapter.sgml 21 Sep 2007 20:30:41 -0000 1.8
  @@ -60,15 +60,15 @@
         werden. Nur wenn der Maintainer in einer inakzeptablen
         Zeitspanne auf mehrere E-Mails nicht antwortet, k&ouml;nnen die
         &Auml;nderungen, die mit dem Commit in Kraft treten, auch ohne
  - &Uuml;berpr&uuml;fung durch den Maintainer vollzogen werden. Dennoch
  - wird empfohlen, dass die &Auml;nderungen, falls
  + &Uuml;berpr&uuml;fung durch den Maintainer vollzogen werden.
  + Dennoch wird empfohlen, dass die &Auml;nderungen, falls
         m&ouml;glich, von jemand anderem &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 sie nicht
  - zustimmt, diese Pflicht auf sich zu nehmen. Andererseits muss es kein
  - einzelner Mensch sein. Eine Gruppe von Menschen ist genauso
  + zustimmt, diese Pflicht auf sich zu nehmen. Andererseits muss es
  + kein einzelner Mensch sein. Eine Gruppe von Menschen ist genauso
         in Ordnung.</para>
     </sect1>
   
  @@ -118,26 +118,27 @@
         &Auml;nderungen an die Hauptentwickler zur&uuml;ckflie&szlig;en zu
         lassen.</para>
   
  - <para>Letztendlich kommt es jedoch auf die Menschen an, welche die Arbeit
  - leisten. Wenn die Durchf&uuml;hrung dieses Modells bei einem Paket mal nicht
  - m&ouml;glich ist, k&ouml;nnen Ausnahmen dieser Regeln
  - nur mit Genehmigung des Core-Teams und der &Uuml;bereinstimmung der
  - anderen Entwickler gew&auml;hrt werden.
  - Die F&auml;higkeit, dieses Paket auch in Zukunft pflegen
  - zu k&ouml;nnen, ist eine der Schl&uuml;sselfragen bei dieser
  + <para>Letztendlich kommt es jedoch auf die Menschen an, welche die
  + Arbeit leisten. Wenn die Durchf&uuml;hrung dieses Modells bei
  + einem Paket mal nicht m&ouml;glich ist, k&ouml;nnen Ausnahmen
  + dieser Regeln nur mit Genehmigung des Core-Teams und der
  + &Uuml;bereinstimmung der anderen Entwickler gew&auml;hrt 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
  - des RCS-Dateiformats und die Handhabung von Herstellerzweigen im CVS
  - ist von unwesentlichen, trivialen und/oder kosmetischen &Auml;nderungen
  - an Dateien <emphasis>dringend abzuraten</emphasis>, die
  - dem Herstellerzweig folgen. <quote>Grammatikalische oder
  - sprachliche Fehlerbehebungen</quote> sind explizit unter der
  - <quote>Kosmetik</quote>-Kategorie einzuordnen und sollten
  - bei Dateien mit einer 1.1.x.x-Revision vermieden werden. Das
  - Repository kann sich durch &Auml;nderungen einzelner
  - Zeichen dramatisch aufbl&auml;hen.</para>
  + des RCS-Dateiformats und die Handhabung von Herstellerzweigen
  + im CVS ist von unwesentlichen, trivialen und/oder kosmetischen
  + &Auml;nderungen an Dateien <emphasis>dringend
  + abzuraten</emphasis>, die dem Herstellerzweig folgen.
  + <quote>Grammatikalische oder sprachliche
  + Fehlerbehebungen</quote> sind explizit unter der
  + <quote>Kosmetik</quote>-Kategorie einzuordnen und sollten bei
  + Dateien mit einer 1.1.x.x-Revision vermieden werden. Das
  + Repository kann sich durch &Auml;nderungen einzelner Zeichen
  + dramatisch aufbl&auml;hen.</para>
       </note>
   
       <para>Die eingebettete
  @@ -248,7 +249,8 @@
         dem initialen Import nutzen. Ein Beispiel von
         <filename>src/contrib/cpio</filename> sehen Sie hier:</para>
   
  - <programlisting>This directory contains virgin sources of the original distribution files
  + <programlisting>
  +This directory contains virgin sources of the original distribution files
   on a "vendor" branch. Do not, under any circumstances, attempt to upgrade
   the files in this directory via patches and a cvs commit. New versions or
   official-patch versions must be imported. Please remember to import with
  @@ -292,8 +294,8 @@
       <title>Belastende Dateien</title>
   
       <para>Es kann gelegentlich notwendig sein, belastende Dateien
  - in den FreeBSD-Quelltextbaum zu integrieren.
  - Braucht ein Ger&auml;t zum Beispiel ein St&uuml;ck bin&auml;ren Code, der
  + in den FreeBSD-Quelltextbaum zu integrieren. Braucht ein
  + Ger&auml;t zum Beispiel ein St&uuml;ck bin&auml;ren Code, der
         zuerst geladen werden muss, bevor das Ger&auml;t funktioniert,
         und wir haben keine Quellen zu diesem Code, dann wird die
         bin&auml;re Datei als belastend bezeichnet. Die folgenden
  @@ -334,15 +336,15 @@
         </listitem>
   
         <listitem>
  - <para>Das komplette Modul sollte auch am St&uuml;ck aufbewahrt werden.
  - Es gibt keinen Grund, dieses zu teilen, au&szlig;er es gibt einen
  - Code-Austausch mit Quelltext, der nicht belastend ist.</para>
  + <para>Das komplette Modul sollte auch am St&uuml;ck
  + aufbewahrt werden. Es gibt keinen Grund, dieses zu teilen,
  + au&szlig;er es gibt einen Code-Austausch mit Quelltext, der
  + nicht belastend ist.</para>
         </listitem>
   
         <listitem>
           <para>Objekt-Dateien werden wie folgt benannt:
  - <filename><replaceable>arch</replaceable>/<replaceable>filename</replaceable>.o.uu>
  - </filename>.</para>
  + <filename><replaceable>arch</replaceable>/<replaceable>filename</replaceable>.o.uu></filename>.</para>
         </listitem>
   
         <listitem>
  @@ -356,8 +358,8 @@
             </listitem>
   
             <listitem>
  - <para>Sollten sich immer in <filename>LINT</filename> befinden,
  - jedoch entscheidet das <ulink
  + <para>Sollten sich immer in <filename>LINT</filename>
  + befinden, jedoch entscheidet das <ulink
                 url="&url.articles.contributors;/staff-core.html">Core-Team</ulink>
                 je nach Fall, ob es
                 auskommentiert wird oder nicht. Das <ulink
  @@ -424,13 +426,15 @@
   
       <title>Shared-Libraries</title>
   
  - <para>Sollten Sie die Unterst&uuml;tzung f&uuml;r Shared-Libraries bei einem
  - Port oder einem St&uuml;ck Software, das dies nicht hat,
  - hinzuf&uuml;gen, sollten die Versionsnummern dessen Regeln folgen.
  - Im Allgemeinen hat die sich daraus resultierende Nummer nichts
  - mit der Release-Version der Software zu tun.</para>
  + <para>Sollten Sie die Unterst&uuml;tzung f&uuml;r
  + Shared-Libraries bei einem Port oder einem St&uuml;ck Software,
  + das dies nicht hat, hinzuf&uuml;gen, sollten die Versionsnummern
  + dessen Regeln folgen. Im Allgemeinen hat die sich daraus
  + resultierende Nummer nichts mit der Release-Version der Software
  + zu tun.</para>
   
  - <para>Die drei Grunds&auml;tze zum Erstellen von Shared-Libraries sind:</para>
  + <para>Die drei Grunds&auml;tze zum Erstellen von Shared-Libraries
  + sind:</para>
   
       <itemizedlist>
         <listitem>
  @@ -479,10 +483,10 @@
       <note>
         <para><command>ld.so</command> wird immer die h&ouml;chste
           <quote>Minor</quote>-Revision benutzen. Beispielsweise wird
  - es die <filename>libc.so.2.2</filename> bevorzugen gegen&uuml;ber der
  - <filename>libc.so.2.0</filename>, auch dann, wenn das Programm
  - urspr&uuml;nglich mit <filename>libc.so.2.0</filename>
  - verlinkt war.</para>
  + es die <filename>libc.so.2.2</filename> bevorzugen
  + gegen&uuml;ber der <filename>libc.so.2.0</filename>, auch
  + dann, wenn das Programm urspr&uuml;nglich mit
  + <filename>libc.so.2.0</filename> verlinkt war.</para>
       </note>
   
       <para>Unser dynamischer ELF-Linker kann keine Minor-Versionen
  @@ -490,19 +494,19 @@
         werden, da unsere <filename>Makefile</filename>s <quote>das
         Richtige machen</quote> bezogen auf den Systemtyp.</para>
   
  - <para>F&uuml;r nicht-Port-Bibliotheken lautet die
  - Richtlinie, die Shared-Library-Versionsnummer nur einmal
  - zwischen den Releases zu &auml;ndern. Weiterhin ist es vorgeschrieben,
  - die Major-Version der Shared-Libraries nur bei Major-OS-Releases zu &auml;ndern
  - (beispielsweise von 3.0 auf 4.0). Wenn Sie also eine &Auml;nderung an einer
  - Systembibliothek vornehmen, die eine neue Versionsnummer
  - ben&ouml;tigt, &uuml;berpr&uuml;fen Sie die Commit-Logs des
  - <filename>Makefile</filename>s.
  - Es liegt in der Verantwortung des Committers, dass sich eine erste
  - solche &Auml;nderung seit dem letzten Release in der
  - aktualisierten Versionsnummer der Shared-Library im
  - <filename>Makefile</filename> &auml;u&szlig;ert,
  - folgende &Auml;nderungen werden nicht ber&uuml;cksichtigt.</para>
  + <para>F&uuml;r nicht-Port-Bibliotheken lautet die Richtlinie,
  + die Shared-Library-Versionsnummer nur einmal zwischen den
  + Releases zu &auml;ndern. Weiterhin ist es vorgeschrieben, die
  + Major-Version der Shared-Libraries nur bei Major-OS-Releases zu
  + &auml;ndern (beispielsweise von 3.0 auf 4.0). Wenn Sie also eine
  + &Auml;nderung an einer Systembibliothek vornehmen, die eine neue
  + Versionsnummer ben&ouml;tigt, &uuml;berpr&uuml;fen Sie die
  + Commit-Logs des <filename>Makefile</filename>s. Es liegt in der
  + Verantwortung des Committers, dass sich eine erste solche
  + &Auml;nderung seit dem letzten Release in der aktualisierten
  + Versionsnummer der Shared-Library im
  + <filename>Makefile</filename> &auml;u&szlig;ert, folgende
  + &Auml;nderungen werden nicht ber&uuml;cksichtigt.</para>
     </sect1>
   </chapter>
   
  

To Unsubscribe: send mail to majordomo(at)de.FreeBSD.org
with "unsubscribe de-cvs-doc" in the body of the message
Received on Fri 21 Sep 2007 - 22:32:03 CEST

search this site