[patch] doc/cs/distcc.xml.patch - bump

patch (text/plain), 4.85 KB, created by Jan Kundrát (RETIRED) on 2005-07-17 16:17:54 UTC

Index: doc/cs/distcc.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/cs/distcc.xml,v
retrieving revision 1.3
diff -u -b -B -r1.3 distcc.xml
--- doc/cs/distcc.xml	19 Jun 2005 10:04:36 -0000	1.3
+++ doc/cs/distcc.xml	17 Jul 2005 23:16:20 -0000
@@ -47,8 +47,8 @@
 <!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
 <license/>
 
-<version>1.11</version>
-<date>2005-06-18</date>
+<version>1.13</version>
+<date>2005-07-01</date>
 
 <chapter>
 <title>Úvod</title>
@@ -60,7 +60,8 @@
 Distcc je program, který rozloží kompilaci mezi několik strojů v&nbsp;síti.
 Skládá se ze serveru, <c>distccd</c>, a klientské části, programu <c>distcc</c>.
 Distcc umí transparentně pracovat s&nbsp;<uri
-link="http://ccache.samba.org">ccache</uri> i Portage, jen s&nbsp;minimem úsilí.
+link="http://ccache.samba.org">ccache</uri>, Portage a Automake jen
+s&nbsp;minimálním úsilím.
 </p>
 
 </body>
@@ -86,8 +87,8 @@
 
 <p>
 Abyste mohli používat distcc, musí mít všechny stroje v&nbsp;síti stejnou verzi
-GCC. Můžete míchat 3.3.x (kde je x rozdílné), ale <b>nelze</b> směšovat 3.3.x a
-3.2.x, protože ve&nbsp;výsledných programech by byly chyby.
+GCC. Můžete například míchat 3.3.x (kde je x rozdílné), ale směšování 3.3.x a
+3.2.x <e>může</e> vést k&nbsp;chybám při kompilaci nebo při běhu programů.
 </p>
 
 </body>
@@ -128,8 +129,8 @@
 <comment>(Zadej N podle své situace)</comment>
 <comment>(Obvykle počet všech  CPU + 1)</comment>
 MAKEOPTS="-jN"
-<comment>(Přidejte distcc do proměnné FEATURES)</comment>
-FEATURES="distcc" (pozn. překladatele (distcc ccache …))
+<comment>(Přidejte distcc do FEATURES)</comment>
+FEATURES="distcc"
 </pre>
 
 </body>
@@ -150,6 +151,11 @@
 @192.168.0.1         @192.168.0.2:/usr/bin/distccd     192.168.0.3
 <comment>(Existuje ještě několik dalších metod, jak definovat seznam strojů;
 detaily viz manuálová stránka distcc.)</comment>
+<comment>Chcete-li kompilovat na lokálním stroji, měli byste jako první položku
+uvést 'localhost'. Naopak pokud nechcete, aby se Váš současný stroj podílel na
+kompilacích (což je poměrně časté), v&nbsp;seznamu jej jednoduše neuvádějte. Na
+pomalých strojích může uvedení localhostu celý proces zpomalit. Pro optimální
+výkon otestujte svá nastavení.</comment>
 </pre>
 
 <p>
@@ -157,18 +163,10 @@
 z&nbsp;první nebo druhé řádky.
 </p>
 
-<ul>
-  <li>1. řádka jsou jen stroje oddělené mezerou</li>
-  <li>
-    2. řádka udává maximální množství úkolů, které lze (v&nbsp;jednom okamžiku)
-    jednomu stroji poslat, pomocí definování čísla <c>/N</c>
-  </li>
-</ul>
-
 <p>
 I když většina lidí 3. a 4. řádku nepoužije, dovolujeme si Vás tímto <uri
 link="http://distcc.samba.org/man/distcc_1.html">nasměrovat na
-dokumentaci distcc</uri>, kde je možnost získat další informace.
+dokumentaci distcc (man distcc)</uri>, kde je možné získat další informace.
 </p>
 
 <p>
@@ -190,6 +188,11 @@
 Design</uri>.
 </p>
 
+<impo>
+Použití --allow a --listen je důležité. Pro dalši informace si prosím přečtěte
+manuálovou stránku distccd či výše uvedený dokument o bezpečnosti.
+</impo>
+
 <p>
 Nyní spusťte distcc démona na všech účastnících se strojích:
 </p>
@@ -217,14 +220,14 @@
 
 <pre caption="Nastavení cesty">
 # <i>export PATH="/usr/lib/ccache/bin:/usr/lib/distcc/bin:${PATH}"</i>
+<comment>Chcete-li, aby se toto provedlo automaticky při každém přihlášení,
+můžete tento řádek přidat do .bashrc či podobného souboru.</comment>
 </pre>
 
 <p>
 Nyní již jen místo <c>make</c> volejte <c>make -jN</c> (kde N je celé číslo).
-Hodnota N záleží na Vaší síti a strojích, které ke kompilaci používáte. Já
-používám duální P3 K6-2/400, který kompiluje všechno pro můj desktop ( 1200MHz
-Athlon Thunderbird) a používám -j5. Vyzkoušejte si vlastní nastavení, při
-kterém bude výkon nejvyšší.</p>
+Hodnota N záleží na Vaší síti a strojích, které ke kompilaci používáte.
+Pro nejvyšší výkon si vyzkoušejte vlastní nastavení.</p>
 
 </body>
 </section>
@@ -272,10 +275,9 @@
 
 <pre caption="Předběžné nastavení">
 # <i>nano -w /etc/make.conf</i>
-<comment>(Přidejte distcc do proměnné FEATURES)</comment>
+<comment>(Přidejte distcc do FEATURES)</comment>
 FEATURES="distcc"
-<comment>(Změňte MAKEOPTS tak, aby obsahovalo -jN, kde N nechť
-odpovídá vaší síti a strojům (N je celé číslo))</comment>
+<comment>(Změňte MAKEOPTS tak, aby obsahovalo -jN, kde N je počet procesorů + 1)</comment>
 MAKEOPTS="-jN"
 </pre>
 
@@ -295,7 +297,7 @@
 </p>
 
 <pre caption="Založení uživatele distcc">
-# <i>echo "distcc:x:240:2:distccd:/dev/null:/bin/false" &gt;&gt; /etc/passwd</i>
+# <i>echo "distcc:x:240:2:distccd:/dev/null:/bin/false" &gt;&gt;/etc/passwd</i>
 </pre>
 
 <impo>