* [gentoo-commits] gentoo commit in xml/htdocs/proj/pl/devrel/handbook: hb-guide-ebuild.xml
@ 2007-09-26 9:59 Lukasz Damentko (rane)
0 siblings, 0 replies; 5+ messages in thread
From: Lukasz Damentko (rane) @ 2007-09-26 9:59 UTC (permalink / raw
To: gentoo-commits
rane 07/09/26 09:59:00
Modified: hb-guide-ebuild.xml
Log:
-> 1.44
Revision Changes Path
1.14 xml/htdocs/proj/pl/devrel/handbook/hb-guide-ebuild.xml
file : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/proj/pl/devrel/handbook/hb-guide-ebuild.xml?rev=1.14&view=markup
plain: http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/proj/pl/devrel/handbook/hb-guide-ebuild.xml?rev=1.14&content-type=text/plain
diff : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/proj/pl/devrel/handbook/hb-guide-ebuild.xml?r1=1.13&r2=1.14
Index: hb-guide-ebuild.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/proj/pl/devrel/handbook/hb-guide-ebuild.xml,v
retrieving revision 1.13
retrieving revision 1.14
diff -u -r1.13 -r1.14
--- hb-guide-ebuild.xml 28 Jun 2007 09:18:36 -0000 1.13
+++ hb-guide-ebuild.xml 26 Sep 2007 09:59:00 -0000 1.14
@@ -1,6 +1,6 @@
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE sections SYSTEM "/dtd/book.dtd">
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/proj/pl/devrel/handbook/hb-guide-ebuild.xml,v 1.13 2007/06/28 09:18:36 rane Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/proj/pl/devrel/handbook/hb-guide-ebuild.xml,v 1.14 2007/09/26 09:59:00 rane Exp $ -->
<!-- The content of this document is licensed under the CC-BY-SA license -->
<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
@@ -1998,25 +1998,25 @@
</p>
<pre caption="Przykład zależności">
-DEPEND="virtual/libc
- sys-libs/zlib"
-RDEPEND="virtual/libc"
+DEPEND="virtual/opengl
+ dev-libs/libxml2"
+RDEPEND="${DEPEND}"
</pre>
<p>
Ten przykład informuje Portage o fakcie, że aby zbudować pakiet
-<path>bla-x.y.z</path> potrzebne będą pakiety <path>virtual/libc</path> (więcej
-o kategoriach wirtualnych wkrótce) i <path>sys-libs/zlib</path>. Nie jest
-podane jakie wersje glibc i zlib są potrzebne, co oznacza, że dobre będą
-wszystkie.
+<path>bla-x.y.z</path> potrzebne będą pakiety <path>virtual/opengl</path>
+(więcej o kategoriach wirtualnych wkrótce) i <path>dev-libs/libxml2</path>. Nie
+jest podane jakie wersje opengl i libxml2 są potrzebne, co oznacza, że dobre
+będą wszystkie.
</p>
<p>
Rzecz jasna, "dobre będą wszystkie" w większości wypadków nie wystarczy.
-Jedynie w przypadku głównych bibliotek takich jak glibc jest to wystarczające,
-ponieważ jego autorzy bardzo się starają, aby był on zawsze w stu procentach
-binarnie kompatybilny. W przypadku innych bibliotek możemy oczywiście podać
-wersje zależności.
+Jedynie w przypadku głównych bibliotek jest to wystarczające, ponieważ jego
+autorzy bardzo się starają, aby był on zawsze w stu procentach binarnie
+kompatybilny. W przypadku innych bibliotek możemy oczywiście podać wersje
+zależności.
</p>
<pre caption="Przykład wersji">
--
gentoo-commits@gentoo.org mailing list
^ permalink raw reply [flat|nested] 5+ messages in thread
* [gentoo-commits] gentoo commit in xml/htdocs/proj/pl/devrel/handbook: hb-guide-ebuild.xml
@ 2008-01-17 0:43 Lukasz Damentko (rane)
0 siblings, 0 replies; 5+ messages in thread
From: Lukasz Damentko (rane) @ 2008-01-17 0:43 UTC (permalink / raw
To: gentoo-commits
rane 08/01/17 00:43:43
Modified: hb-guide-ebuild.xml
Log:
-> 1.47
Revision Changes Path
1.15 xml/htdocs/proj/pl/devrel/handbook/hb-guide-ebuild.xml
file : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/proj/pl/devrel/handbook/hb-guide-ebuild.xml?rev=1.15&view=markup
plain: http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/proj/pl/devrel/handbook/hb-guide-ebuild.xml?rev=1.15&content-type=text/plain
diff : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/proj/pl/devrel/handbook/hb-guide-ebuild.xml?r1=1.14&r2=1.15
Index: hb-guide-ebuild.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/proj/pl/devrel/handbook/hb-guide-ebuild.xml,v
retrieving revision 1.14
retrieving revision 1.15
diff -u -r1.14 -r1.15
--- hb-guide-ebuild.xml 26 Sep 2007 09:59:00 -0000 1.14
+++ hb-guide-ebuild.xml 17 Jan 2008 00:43:43 -0000 1.15
@@ -1,13 +1,13 @@
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE sections SYSTEM "/dtd/book.dtd">
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/proj/pl/devrel/handbook/hb-guide-ebuild.xml,v 1.14 2007/09/26 09:59:00 rane Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/proj/pl/devrel/handbook/hb-guide-ebuild.xml,v 1.15 2008/01/17 00:43:43 rane Exp $ -->
<!-- The content of this document is licensed under the CC-BY-SA license -->
<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
<sections>
-<version>1.0.3</version>
-<date>2007-06-23</date>
+<version>1.0.4</version>
+<date>2007-11-01</date>
<section>
<title>Drzewo Portage</title>
@@ -611,9 +611,7 @@
<ti><c>pkg_setup</c></ti>
<ti>
Funkcja ta służy do wykonywania wszelkich wstępnych czynności. Może to
- obejmować sprawdzenie czy istnieje już plik konfiguracyjny. Jeśli w tym
- miejscu konieczne jest dodanie użytkowników, należy również sprawdzić to
- w funkcji <c>pkg_preinst()</c> zanim pakiet zostanie zainstalowany.
+ obejmować sprawdzenie czy istnieje już plik konfiguracyjny.
</ti>
</tr>
<tr>
@@ -1016,8 +1014,9 @@
<tr>
<ti><c>replace-cpu-flags</c></ti>
<ti>
- Zamienia flagi -march=... lub -mcpu=... zawierające drugi argument
- funkcji flagami z pierwszego argumentu.
+ Tu powinny znajdować się dwa parametry. Pozwala na zamianę wartości
+ mtune/mcpu/mtune na inną. Na przykład replace-cpu-flags 'i686' 'i586'
+ zamieni -mtune/-march/-mcpu=i686 na -mtune/-march/-mcpu=i586).
</ti>
</tr>
<tr>
@@ -1660,7 +1659,7 @@
<ti><c>docinto</c></ti>
<ti><path>""</path></ti>
<ti>
- Ustawia względny podkatalog (<e>DOCDESTTREE</e>) dla skryptu <c>dodoc</c>.
+ Ustawia względny katalog wykorzystywany przez funkcję <c>dodoc</c>.
</ti>
<ti><c>docinto examples</c></ti>
</tr>
@@ -1684,7 +1683,7 @@
<ti>Nie dotyczy</ti>
<ti>
Instaluje podane pliki z uprawnieniami <e>EXEOPTIONS</e> (zob.
- <c>exeopts</c>) w katalogu <path>EXEDESTTREE</path> (zob. <c>exeinto</c>).
+ <c>exeopts</c>) w katalogu <path>PATH</path> (zob. <c>exeinto</c>).
</ti>
<ti><c>doexe ${FILESDIR}/quake3</c></ti>
</tr>
--
gentoo-commits@lists.gentoo.org mailing list
^ permalink raw reply [flat|nested] 5+ messages in thread
* [gentoo-commits] gentoo commit in xml/htdocs/proj/pl/devrel/handbook: hb-guide-ebuild.xml
@ 2008-01-20 17:57 Damian Kuras (shadow)
0 siblings, 0 replies; 5+ messages in thread
From: Damian Kuras (shadow) @ 2008-01-20 17:57 UTC (permalink / raw
To: gentoo-commits
shadow 08/01/20 17:57:56
Modified: hb-guide-ebuild.xml
Log:
sync to 1.48
Revision Changes Path
1.16 xml/htdocs/proj/pl/devrel/handbook/hb-guide-ebuild.xml
file : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/proj/pl/devrel/handbook/hb-guide-ebuild.xml?rev=1.16&view=markup
plain: http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/proj/pl/devrel/handbook/hb-guide-ebuild.xml?rev=1.16&content-type=text/plain
diff : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/proj/pl/devrel/handbook/hb-guide-ebuild.xml?r1=1.15&r2=1.16
Index: hb-guide-ebuild.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/proj/pl/devrel/handbook/hb-guide-ebuild.xml,v
retrieving revision 1.15
retrieving revision 1.16
diff -u -r1.15 -r1.16
--- hb-guide-ebuild.xml 17 Jan 2008 00:43:43 -0000 1.15
+++ hb-guide-ebuild.xml 20 Jan 2008 17:57:55 -0000 1.16
@@ -1,6 +1,6 @@
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE sections SYSTEM "/dtd/book.dtd">
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/proj/pl/devrel/handbook/hb-guide-ebuild.xml,v 1.15 2008/01/17 00:43:43 rane Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/proj/pl/devrel/handbook/hb-guide-ebuild.xml,v 1.16 2008/01/20 17:57:55 shadow Exp $ -->
<!-- The content of this document is licensed under the CC-BY-SA license -->
<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
@@ -645,7 +645,7 @@
<ti>
Tej funkcji użyjemy, aby zainstalować pakiet w katalogu określonym przez
zmienną <c>D</c>. Jesli pakiet korzysta z automake, możemy tego łatwo
- dokonać poprzez <c>make DESTDIR=${D} install</c>. <e>Należy upewnić się, że
+ dokonać poprzez <c>emake DESTDIR=${D} install</c>. <e>Należy upewnić się, że
pakiet wszystkie swoje pliki zainstaluje używając <c>D</c> jako katalogu
głównego!</e> Początkowy katalog roboczy definiuje zmienna <c>S</c>.
</ti>
@@ -799,7 +799,7 @@
localstatedir). Jak wyżej, można przekazać dodatkowe argumenty do komendy
make, przekazując je funkcji <c>einstall</c> przy jej wywołaniu. Zauważmy
jednak, że preferowanym sposobem zainstalowania pakietu jest wywołanie
- komendy <c>make install DESTDIR=${D}</c>, a nie za pomocą <c>einstall</c>.
+ komendy <c>emake install DESTDIR=${D}</c>, a nie za pomocą <c>einstall</c>.
Komenda ta używana jest tylko zastępczo w przypadku popsutych plików make.
</ti>
</tr>
--
gentoo-commits@lists.gentoo.org mailing list
^ permalink raw reply [flat|nested] 5+ messages in thread
* [gentoo-commits] gentoo commit in xml/htdocs/proj/pl/devrel/handbook: hb-guide-ebuild.xml
@ 2008-04-06 20:57 Damian Kuras (shadow)
0 siblings, 0 replies; 5+ messages in thread
From: Damian Kuras (shadow) @ 2008-04-06 20:57 UTC (permalink / raw
To: gentoo-commits
shadow 08/04/06 20:57:19
Modified: hb-guide-ebuild.xml
Log:
sync to 1.49
Revision Changes Path
1.17 xml/htdocs/proj/pl/devrel/handbook/hb-guide-ebuild.xml
file : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/proj/pl/devrel/handbook/hb-guide-ebuild.xml?rev=1.17&view=markup
plain: http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/proj/pl/devrel/handbook/hb-guide-ebuild.xml?rev=1.17&content-type=text/plain
diff : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/proj/pl/devrel/handbook/hb-guide-ebuild.xml?r1=1.16&r2=1.17
Index: hb-guide-ebuild.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/proj/pl/devrel/handbook/hb-guide-ebuild.xml,v
retrieving revision 1.16
retrieving revision 1.17
diff -u -r1.16 -r1.17
--- hb-guide-ebuild.xml 20 Jan 2008 17:57:55 -0000 1.16
+++ hb-guide-ebuild.xml 6 Apr 2008 20:57:19 -0000 1.17
@@ -1,6 +1,6 @@
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE sections SYSTEM "/dtd/book.dtd">
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/proj/pl/devrel/handbook/hb-guide-ebuild.xml,v 1.16 2008/01/20 17:57:55 shadow Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/proj/pl/devrel/handbook/hb-guide-ebuild.xml,v 1.17 2008/04/06 20:57:19 shadow Exp $ -->
<!-- The content of this document is licensed under the CC-BY-SA license -->
<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
@@ -383,216 +383,11 @@
</p>
<p>
-Pierwsza część każdego pliku ebuild składa się z kilku zmiennych. Dzielą się one
-na trzy kategorie wymienione poniżej:
+Pierwsza część każdego pliku ebuild składa się z kilku zmiennych. Aby
+dowiedzieć się więcej o zmiennych należy zajrzeć do <uri
+link="http://devmanual.gentoo.org/ebuild-writing/variables/index.html">devmanuala</uri>.
</p>
-<ul>
- <li>READ: zmiennych tych możemy użyć, ale <e>nie wolno</e> ich ustawiać</li>
- <li>MUST: zmienne, które <e>koniecznie należy ustawić</e></li>
- <li>OPT: zmienne, które powinniśmy ustawić</li>
-</ul>
-
-<table>
-<tr>
- <th>Zmienna</th>
- <th>Kategoria</th>
- <th>Opis</th>
-</tr>
-<tr>
- <ti><c>P</c></ti>
- <ti>READ</ti>
- <ti>Nazwa i wersja pakietu.</ti>
-</tr>
-<tr>
- <ti><c>PN</c></ti>
- <ti>READ</ti>
- <ti>Nazwa pakietu.</ti>
-</tr>
-<tr>
- <ti><c>PV</c></ti>
- <ti>READ</ti>
- <ti>Wersja pakietu.</ti>
-</tr>
-<tr>
- <ti><c>PR</c></ti>
- <ti>READ</ti>
- <ti>
- Zawiera numer rewizji lub <c>r0</c>, jeśli pakiet nie posiada tego numeru.
- </ti>
-</tr>
-<tr>
- <ti><c>PVR</c></ti>
- <ti>READ</ti>
- <ti>Zawiera numer wersji razem z numerem rewizji.</ti>
-</tr>
-<tr>
- <ti><c>PF</c></ti>
- <ti>READ</ti>
- <ti>Zawiera pełną nazwę pakietu <c>${PN}-${PVR}</c>.</ti>
-</tr>
-<tr>
- <ti><c>A</c></ti>
- <ti>READ</ti>
- <ti>
- Rozdzielona spacjami lista nazw plików z <c>SRC_URI</c>. Nie uwzględnia
- ścieżek URL, tylko same nazwy plików.
- </ti>
-</tr>
-<tr>
- <ti><c>DISTDIR</c></ti>
- <ti>READ</ti>
- <ti>
- Zawiera ścieżkę do katalogu <path>distfiles</path>, w którym zwykle są
- przechowywane wszystkie pobrane pliki ze źródłami programów. Zwykle jest to
- katalog <path>/usr/portage/distfiles</path>.
- </ti>
-</tr>
-<tr>
- <ti><c>FILESDIR</c></ti>
- <ti>READ</ti>
- <ti>
- Zawiera ścieżkę do podkatalogu <path>files</path> z katalogu danego pakietu
- w drzewie Portage. Nie wolno modyfikować tej zmiennej.
- </ti>
-</tr>
-<tr>
- <ti><c>WORKDIR</c></ti>
- <ti>READ</ti>
- <ti>
- Katalog główny katalogu roboczego danego ebuilda. Nic nie powinno być
- budowane na zewnątrz tego katalogu.
- </ti>
-</tr>
-<tr>
- <ti><c>S</c></ti>
- <ti>OPT</ti>
- <ti>
- Katalog źródłowy naszego pakietu. Zwykle jest to <c>${WORKDIR}/${P}</c>.
- Portage przyjmie tę wartość jako domyślną, nie trzeba jej więc ustawiać
- samemu.
- </ti>
-</tr>
-<tr>
- <ti><c>T</c></ti>
- <ti>READ</ti>
- <ti>
- Katalog tymczasowy naszego pakietu. Jest on używany jako wirtualny katalog
- <path>/tmp</path> podczas przetwarzania skryptu ebuild.
- </ti>
-</tr>
-<tr>
- <ti><c>D</c></ti>
- <ti>READ</ti>
- <ti>
- Katalog główny, do którego pakiet zostanie zainstalowany. Należy traktować
- go jako wirtualny katalog <path>/</path>.
- </ti>
-</tr>
-<tr>
- <ti><c>SLOT</c></ti>
- <ti>MUST</ti>
- <ti>
- Portage obsługuje instalowanie jednocześnie różnych wersji tego samego
- programu. Na przykład jeśli chcielibyśmy zainstalować jednocześnie GCC 2.95
- i GCC 3.2, należałoby ustawić zmienną <c>SLOT</c> w każdym pliku ebuild. W
- tym przypadku dla GCC 2.95 ustawilibyśmy zmienną <c>SLOT</c> na <c>2</c>, a
- dla GCC 3.2 na <c>3</c>.
- <br/>
- <b>Uwaga</b>: Podanie <c>0</c> jako wartości zmiennej <c>SLOT</c> oznacza,
- że dany pakiet ma tylko jedno możliwe ustawienie <c>SLOT</c> (innymi słowy,
- nie da się jej "SLOT-ować").
- </ti>
-</tr>
-<tr>
- <ti><c>LICENSE</c></ti>
- <ti>MUST</ti>
- <ti>
- Zmienna ta określa jaką licencją objęty jest program, na przykład GPL-2,
- BSD, itp... Zawartością tej zmiennej musi być poprawna licencja (jest nią
- dowolna licencja z pliku <path>/usr/portage/license/</path>). Jesli danej
- licencji nie ma w tym pliku, musi zostać tam dodana zanim plik ebuild
- znajdzie się w drzewie Portage. Jeśli licencja nie zezwala na redystrybucję
- programu, należy dodać <c>RESTRICT</c>="nomirror" do pliku ebuild.
- </ti>
-</tr>
-<tr>
- <ti><c>KEYWORDS</c></ti>
- <ti>MUST</ti>
- <ti>
- Zmienna ta pełni teraz kilka funkcji. Przede wszystkim określa na jakie
- architektury sprzętowe przeznaczony jest dany ebuild. Przykładowe wartości
- to: <e>x86, ppc, sparc, mips, alpha, arm, hppa, amd64 i ia64</e>. Więcej
- szczegółów można znaleźć w pliku profiles/arch.list. Jak nietrudno się
- domyślić, zmienną tę ustawiamy zgodnie z architekturą docelowej maszyny.
- Portage nie zezwoli maszynie x86 budować pakietów innych niż x86, zgodnie z
- tym, co jest podane w zmiennej <c>KEYWORDS</c>. Pakiety, które nie wspierają
- architektury danego komputera są automatycznie maskowane przez Portage.
- Jeśli flaga <c>KEYWORDS</c> posiada przedrostek <e>~</e>, oznacza to, że
- dany ebuild działa, ale powinien zostać przetestowany w kilku środowiskach,
- zanim może zostać uznany za stabilny. Jeśli zaś przed flagą <c>KEYWORDS</c>
- występuje znak <e>-</e>, dany pakiet nie będzie działać na danej
- architekturze. Pakiety jest uznawany za stabilny, jeśli nic nie poprzedza
- zmiennych zawartych w <c>KEYWORDS</c>. Ustawiając odpowiednio zmienną
- <c>ACCEPT_KEYWORDS</c> w pliku <path>make.conf</path> definiujemy którym z
- powyższych typów pakietów zezwalamy na instalację.
- </ti>
-</tr>
-<tr>
- <ti><c>DESCRIPTION</c></ti>
- <ti>MUST</ti>
- <ti><e>Krótki</e>, mieszczący się w jednej linii opis pakietu.</ti>
-</tr>
-<tr>
- <ti><c>SRC_URI</c></ti>
- <ti>MUST</ti>
- <ti>
- URL-e każdego pliku ze źródłami pakietu, rozdzielone białym znakiem (np.
- spacją lub znakiem końca linii). W zmiennych SRC_URI i S nie powinno się
- umieszczać numerów wersji. Powinniśmy zawsze stosować zmienne ${PV} lub
- ${P}, a jeśli numer wersji nie pokrywa się z nazwą pliku zawierającego
- źródła, należy stworzyć zmienną ${MY_P} i użyć jej zamiast dwóch
- poprzednich.
- </ti>
-</tr>
-<tr>
- <ti><c>HOMEPAGE</c></ti>
- <ti>MUST</ti>
- <ti>
- Strona domowa pakietu. Jeśli nie możemy znaleźć oficjalnej strony, można
- podać odnośnik z <uri link="http://freshmeat.net/">freshmeat.net</uri> lub
- podobnej strony z bazą danych programów. Nigdy nie należy odnosić się do
- innej zmiennej wewnątrz tej. Musi ona zawierać tylko czysty tekst.
- </ti>
-</tr>
-<tr>
- <ti><c>IUSE</c></ti>
- <ti>MUST</ti>
- <ti>
- W zmiennej tej zamieszczamy flagi <c>USE</c> z jakich korzysta nasz pakiet.
- Należy pamiętać, że nie wolno tutaj umieścić <c>KEYWORDS</c>!
- </ti>
-</tr>
-<tr>
- <ti><c>DEPEND</c></ti>
- <ti>OPT</ti>
- <ti>
- Tutaj wymieniamy zależności potrzebne do zbudowania pakietu. Więcej
- informacji na temat składni znajdziemy w sekcji <uri
- link="#doc_chap5">Zależności pakietu</uri>.
- </ti>
-</tr>
-<tr>
- <ti><c>RDEPEND</c></ti>
- <ti>OPT</ti>
- <ti>
- Tutaj wymieniamy zależności potrzebne do uruchomienia programu z pakietu.
- Jak wspomniano wyżej, więcej szczegółów można znaleźć w sekcji <uri
- link="#doc_chap5">Zależności pakietu</uri>.
- </ti>
-</tr>
-</table>
-
<p>
<b>Funkcje</b>
</p>
@@ -1583,8 +1378,8 @@
<ti>Nie dotyczy</ti>
</tr>
<tr>
- <ti><c>digest</c>*</ti>
- <ti>Tworzy plik digest pakietu.</ti>
+ <ti><c>manifest</c>*</ti>
+ <ti>Tworzy plik Manifest pakietu.</ti>
<ti>Nie dotyczy</ti>
</tr>
<tr>
--
gentoo-commits@lists.gentoo.org mailing list
^ permalink raw reply [flat|nested] 5+ messages in thread
* [gentoo-commits] gentoo commit in xml/htdocs/proj/pl/devrel/handbook: hb-guide-ebuild.xml
@ 2009-03-09 20:42 Lukasz Damentko (rane)
0 siblings, 0 replies; 5+ messages in thread
From: Lukasz Damentko (rane) @ 2009-03-09 20:42 UTC (permalink / raw
To: gentoo-commits
rane 09/03/09 20:42:15
Modified: hb-guide-ebuild.xml
Log:
-> 1.51 from #259202
Revision Changes Path
1.18 xml/htdocs/proj/pl/devrel/handbook/hb-guide-ebuild.xml
file : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/proj/pl/devrel/handbook/hb-guide-ebuild.xml?rev=1.18&view=markup
plain: http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/proj/pl/devrel/handbook/hb-guide-ebuild.xml?rev=1.18&content-type=text/plain
diff : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/proj/pl/devrel/handbook/hb-guide-ebuild.xml?r1=1.17&r2=1.18
Index: hb-guide-ebuild.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/proj/pl/devrel/handbook/hb-guide-ebuild.xml,v
retrieving revision 1.17
retrieving revision 1.18
diff -u -r1.17 -r1.18
--- hb-guide-ebuild.xml 6 Apr 2008 20:57:19 -0000 1.17
+++ hb-guide-ebuild.xml 9 Mar 2009 20:42:15 -0000 1.18
@@ -1,6 +1,6 @@
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE sections SYSTEM "/dtd/book.dtd">
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/proj/pl/devrel/handbook/hb-guide-ebuild.xml,v 1.17 2008/04/06 20:57:19 shadow Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/proj/pl/devrel/handbook/hb-guide-ebuild.xml,v 1.18 2009/03/09 20:42:15 rane Exp $ -->
<!-- The content of this document is licensed under the CC-BY-SA license -->
<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
@@ -24,7 +24,8 @@
znajdować się kilka innych wersji <c>util-linux</c> razem z wersją
<path>util-linux-2.11y.ebuild</path>. Jest tak, ponieważ <e>wszystkie pliki
ebuild danego pakietu (niezależnie od wersji)</e> mają wspólny katalog
-<path>kategoria/pakiet</path> w głównym katalogu <path>/usr/portage</path>.
+<path>kategoria/pakiet</path> w głównym katalogu <path>/usr/portage</path>,
+jednak tylko w przypadku, gdy nie zainstalowano dodatkowych repozytoriów.
</p>
</body>
@@ -383,11 +384,216 @@
</p>
<p>
-Pierwsza część każdego pliku ebuild składa się z kilku zmiennych. Aby
-dowiedzieć się więcej o zmiennych należy zajrzeć do <uri
-link="http://devmanual.gentoo.org/ebuild-writing/variables/index.html">devmanuala</uri>.
+Pierwsza część każdego pliku ebuild składa się z kilku zmiennych. Dzielą się one
+na trzy kategorie wymienione poniżej:
</p>
+<ul>
+ <li>READ: zmiennych tych możemy użyć, ale <e>nie wolno</e> ich ustawiać</li>
+ <li>MUST: zmienne, które <e>koniecznie należy ustawić</e></li>
+ <li>OPT: zmienne, które powinniśmy ustawić</li>
+</ul>
+
+<table>
+<tr>
+ <th>Zmienna</th>
+ <th>Kategoria</th>
+ <th>Opis</th>
+</tr>
+<tr>
+ <ti><c>P</c></ti>
+ <ti>READ</ti>
+ <ti>Nazwa i wersja pakietu.</ti>
+</tr>
+<tr>
+ <ti><c>PN</c></ti>
+ <ti>READ</ti>
+ <ti>Nazwa pakietu.</ti>
+</tr>
+<tr>
+ <ti><c>PV</c></ti>
+ <ti>READ</ti>
+ <ti>Wersja pakietu.</ti>
+</tr>
+<tr>
+ <ti><c>PR</c></ti>
+ <ti>READ</ti>
+ <ti>
+ Zawiera numer rewizji lub <c>r0</c>, jeśli pakiet nie posiada tego numeru.
+ </ti>
+</tr>
+<tr>
+ <ti><c>PVR</c></ti>
+ <ti>READ</ti>
+ <ti>Zawiera numer wersji razem z numerem rewizji.</ti>
+</tr>
+<tr>
+ <ti><c>PF</c></ti>
+ <ti>READ</ti>
+ <ti>Zawiera pełną nazwę pakietu <c>${PN}-${PVR}</c>.</ti>
+</tr>
+<tr>
+ <ti><c>A</c></ti>
+ <ti>READ</ti>
+ <ti>
+ Rozdzielona spacjami lista nazw plików z <c>SRC_URI</c>. Nie uwzględnia
+ ścieżek URL, tylko same nazwy plików.
+ </ti>
+</tr>
+<tr>
+ <ti><c>DISTDIR</c></ti>
+ <ti>READ</ti>
+ <ti>
+ Zawiera ścieżkę do katalogu <path>distfiles</path>, w którym zwykle są
+ przechowywane wszystkie pobrane pliki ze źródłami programów. Zwykle jest to
+ katalog <path>/usr/portage/distfiles</path>.
+ </ti>
+</tr>
+<tr>
+ <ti><c>FILESDIR</c></ti>
+ <ti>READ</ti>
+ <ti>
+ Zawiera ścieżkę do podkatalogu <path>files</path> z katalogu danego pakietu
+ w drzewie Portage. Nie wolno modyfikować tej zmiennej.
+ </ti>
+</tr>
+<tr>
+ <ti><c>WORKDIR</c></ti>
+ <ti>READ</ti>
+ <ti>
+ Katalog główny katalogu roboczego danego ebuilda. Nic nie powinno być
+ budowane na zewnątrz tego katalogu.
+ </ti>
+</tr>
+<tr>
+ <ti><c>S</c></ti>
+ <ti>OPT</ti>
+ <ti>
+ Katalog źródłowy naszego pakietu. Zwykle jest to <c>${WORKDIR}/${P}</c>.
+ Portage przyjmie tę wartość jako domyślną, nie trzeba jej więc ustawiać
+ samemu.
+ </ti>
+</tr>
+<tr>
+ <ti><c>T</c></ti>
+ <ti>READ</ti>
+ <ti>
+ Katalog tymczasowy naszego pakietu. Jest on używany jako wirtualny katalog
+ <path>/tmp</path> podczas przetwarzania skryptu ebuild.
+ </ti>
+</tr>
+<tr>
+ <ti><c>D</c></ti>
+ <ti>READ</ti>
+ <ti>
+ Katalog główny, do którego pakiet zostanie zainstalowany. Należy traktować
+ go jako wirtualny katalog <path>/</path>.
+ </ti>
+</tr>
+<tr>
+ <ti><c>SLOT</c></ti>
+ <ti>MUST</ti>
+ <ti>
+ Portage obsługuje instalowanie jednocześnie różnych wersji tego samego
+ programu. Na przykład jeśli chcielibyśmy zainstalować jednocześnie GCC 2.95
+ i GCC 3.2, należałoby ustawić zmienną <c>SLOT</c> w każdym pliku ebuild. W
+ tym przypadku dla GCC 2.95 ustawilibyśmy zmienną <c>SLOT</c> na <c>2</c>, a
+ dla GCC 3.2 na <c>3</c>.
+ <br/>
+ <b>Uwaga</b>: Podanie <c>0</c> jako wartości zmiennej <c>SLOT</c> oznacza,
+ że dany pakiet ma tylko jedno możliwe ustawienie <c>SLOT</c> (innymi słowy,
+ nie da się jej "SLOT-ować").
+ </ti>
+</tr>
+<tr>
+ <ti><c>LICENSE</c></ti>
+ <ti>MUST</ti>
+ <ti>
+ Zmienna ta określa jaką licencją objęty jest program, na przykład GPL-2,
+ BSD, itp... Zawartością tej zmiennej musi być poprawna licencja (jest nią
+ dowolna licencja z pliku <path>/usr/portage/license/</path>). Jesli danej
+ licencji nie ma w tym pliku, musi zostać tam dodana zanim plik ebuild
+ znajdzie się w drzewie Portage. Jeśli licencja nie zezwala na redystrybucję
+ programu, należy dodać <c>RESTRICT</c>="nomirror" do pliku ebuild.
+ </ti>
+</tr>
+<tr>
+ <ti><c>KEYWORDS</c></ti>
+ <ti>MUST</ti>
+ <ti>
+ Zmienna ta pełni teraz kilka funkcji. Przede wszystkim określa na jakie
+ architektury sprzętowe przeznaczony jest dany ebuild. Przykładowe wartości
+ to: <e>x86, ppc, sparc, mips, alpha, arm, hppa, amd64 i ia64</e>. Więcej
+ szczegółów można znaleźć w pliku profiles/arch.list. Jak nietrudno się
+ domyślić, zmienną tę ustawiamy zgodnie z architekturą docelowej maszyny.
+ Portage nie zezwoli maszynie x86 budować pakietów innych niż x86, zgodnie z
+ tym, co jest podane w zmiennej <c>KEYWORDS</c>. Pakiety, które nie wspierają
+ architektury danego komputera są automatycznie maskowane przez Portage.
+ Jeśli flaga <c>KEYWORDS</c> posiada przedrostek <e>~</e>, oznacza to, że
+ dany ebuild działa, ale powinien zostać przetestowany w kilku środowiskach,
+ zanim może zostać uznany za stabilny. Jeśli zaś przed flagą <c>KEYWORDS</c>
+ występuje znak <e>-</e>, dany pakiet nie będzie działać na danej
+ architekturze. Pakiety jest uznawany za stabilny, jeśli nic nie poprzedza
+ zmiennych zawartych w <c>KEYWORDS</c>. Ustawiając odpowiednio zmienną
+ <c>ACCEPT_KEYWORDS</c> w pliku <path>make.conf</path> definiujemy którym z
+ powyższych typów pakietów zezwalamy na instalację.
+ </ti>
+</tr>
+<tr>
+ <ti><c>DESCRIPTION</c></ti>
+ <ti>MUST</ti>
+ <ti><e>Krótki</e>, mieszczący się w jednej linii opis pakietu.</ti>
+</tr>
+<tr>
+ <ti><c>SRC_URI</c></ti>
+ <ti>MUST</ti>
+ <ti>
+ URL-e każdego pliku ze źródłami pakietu, rozdzielone białym znakiem (np.
+ spacją lub znakiem końca linii). W zmiennych SRC_URI i S nie powinno się
+ umieszczać numerów wersji. Powinniśmy zawsze stosować zmienne ${PV} lub
+ ${P}, a jeśli numer wersji nie pokrywa się z nazwą pliku zawierającego
+ źródła, należy stworzyć zmienną ${MY_P} i użyć jej zamiast dwóch
+ poprzednich.
+ </ti>
+</tr>
+<tr>
+ <ti><c>HOMEPAGE</c></ti>
+ <ti>MUST</ti>
+ <ti>
+ Strona domowa pakietu. Jeśli nie możemy znaleźć oficjalnej strony, można
+ podać odnośnik z <uri link="http://freshmeat.net/">freshmeat.net</uri> lub
+ podobnej strony z bazą danych programów. Nigdy nie należy odnosić się do
+ innej zmiennej wewnątrz tej. Musi ona zawierać tylko czysty tekst.
+ </ti>
+</tr>
+<tr>
+ <ti><c>IUSE</c></ti>
+ <ti>MUST</ti>
+ <ti>
+ W zmiennej tej zamieszczamy flagi <c>USE</c> z jakich korzysta nasz pakiet.
+ Należy pamiętać, że nie wolno tutaj umieścić <c>KEYWORDS</c>!
+ </ti>
+</tr>
+<tr>
+ <ti><c>DEPEND</c></ti>
+ <ti>OPT</ti>
+ <ti>
+ Tutaj wymieniamy zależności potrzebne do zbudowania pakietu. Więcej
+ informacji na temat składni znajdziemy w sekcji <uri
+ link="#doc_chap5">Zależności pakietu</uri>.
+ </ti>
+</tr>
+<tr>
+ <ti><c>RDEPEND</c></ti>
+ <ti>OPT</ti>
+ <ti>
+ Tutaj wymieniamy zależności potrzebne do uruchomienia programu z pakietu.
+ Jak wspomniano wyżej, więcej szczegółów można znaleźć w sekcji <uri
+ link="#doc_chap5">Zależności pakietu</uri>.
+ </ti>
+</tr>
+</table>
+
<p>
<b>Funkcje</b>
</p>
@@ -1378,8 +1584,8 @@
<ti>Nie dotyczy</ti>
</tr>
<tr>
- <ti><c>manifest</c>*</ti>
- <ti>Tworzy plik Manifest pakietu.</ti>
+ <ti><c>digest</c>*</ti>
+ <ti>Tworzy plik digest pakietu.</ti>
<ti>Nie dotyczy</ti>
</tr>
<tr>
@@ -1454,7 +1660,8 @@
<ti><c>docinto</c></ti>
<ti><path>""</path></ti>
<ti>
- Ustawia względny katalog wykorzystywany przez funkcję <c>dodoc</c>.
+Ustawia względny katalog (DOCDESTTREE) wykorzystywany przez funkcję
+<c>dodoc</c>.
</ti>
<ti><c>docinto examples</c></ti>
</tr>
@@ -1716,9 +1923,8 @@
<ti><c>prepalldocs</c></ti>
<ti>Nie dotyczy</ti>
<ti>
- Rekursywnie kompresuje wszystkie pliki dokumentacji z katalogu
- <path>/usr/share/doc</path> za pomocą narzędzia gzip, automatycznie
- poprawiając wszelkie dowiązania symboliczne.
+ Zachowanie zostało zmienione pomiędzy wersjami Portage, w związku z czym nowe
+ ebuildy nie powinny korzystać z tej funkcji.
</ti>
<ti><c>prepalldocs</c></ti>
</tr>
@@ -1844,7 +2050,8 @@
<p>
=sys-apps/bla-1.2* wybierze najnowsze wersje spośród gałęzi 1.2, ale zignoruje
1.3 i wcześniejsze/późniejsze gałęzie. Tak więc bla-1.2.3 i bla-1.2.0 będą
-odpowiednie, zaś bla-1.3.3, bla-1.3.0 i bla-1.1.0 już nie.
+odpowiednie, zaś bla-1.3.3, bla-1.3.0 i bla-1.1.0 już nie. Warto zauważyć, że
+bla-1.22.3 też pasuje do wzorca, co czasami może spowodować problemy.
</p>
<p>
^ permalink raw reply [flat|nested] 5+ messages in thread
end of thread, other threads:[~2009-03-09 20:42 UTC | newest]
Thread overview: 5+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2008-01-17 0:43 [gentoo-commits] gentoo commit in xml/htdocs/proj/pl/devrel/handbook: hb-guide-ebuild.xml Lukasz Damentko (rane)
-- strict thread matches above, loose matches on Subject: below --
2009-03-09 20:42 Lukasz Damentko (rane)
2008-04-06 20:57 Damian Kuras (shadow)
2008-01-20 17:57 Damian Kuras (shadow)
2007-09-26 9:59 Lukasz Damentko (rane)
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox