PLD-doc: devel-hints-pl.txt - resync by translating recent glen's ...

[saq]

Author: saq                          Date: Wed Oct  5 15:15:26 2005 GMT
Module: PLD-doc                       Tag: HEAD
---- Log message:
- resync by translating recent glen's contributions

---- Files affected:
PLD-doc:
   devel-hints-pl.txt (1.43 -> 1.44) 

---- Diffs:

================================================================
Index: PLD-doc/devel-hints-pl.txt
diff -u PLD-doc/devel-hints-pl.txt:1.43 PLD-doc/devel-hints-pl.txt:1.44
--- PLD-doc/devel-hints-pl.txt:1.43	Tue Jul 12 10:29:03 2005
+++ PLD-doc/devel-hints-pl.txt	Wed Oct  5 17:15:20 2005
@@ -86,6 +86,14 @@
 W takim przypadku po zmianach speca dla tej samej wersji oprogramowania
 zwiększamy ostatnią liczbę w Release ("0" pozostaje bez zmian!).
 
+Uwaga: glen sugeruje, że wiodące "0." jest zbędne, jeśli reszta release
+zaczyna się od czegoś nienumerycznego (np. "RC2"), gdyż litery dają wersje
+mniejsze niż cyfry:
+$ rpmvercmp 1.6.0-RC2 1.6.0-1
+1.6.0-RC2 < 1.6.0-1
+tym niemniej, taka praktyka nie jest powszechnie popierana, z irc-owników
+jedynie glenowi się podoba :)
+
 
 Grupy pakietów:
 Pakiet musi posiadać zdefiniowane pole Group: zgodnie z SOURCES/rpm.groups
@@ -549,8 +557,9 @@
 Pakiety niezależne od wersji Apache
 
 Od wersji 1.3.33-2, apache1 także obsługuje konfigurację opartą o confdir.
-Aby utworzyć pakiet wymagający funkcjonalności apache (bez wskazania
-konkretnej wersji), należy dodać do pakietu:
+Aby utworzyć pakiet wymagający funkcjonalności apache (niezależnie od
+wersji apache, t.j. działający zarówno z apache1 jak i apache2), należy
+dodać do pakietu:
 Requires:	apache >= 1.3.33-3
 
 Jeżeli pakiet wymaga jakiegoś rdzennego modułu apache, dodaje się
@@ -559,7 +568,9 @@
 
 Żeby udostępnić konfigurację dla obu apache'y, należy ją umieścić w
 katalogu konfiguracyjnym danej aplikacji (nie w katalogu apache'a!).
-Często sprawdza się %{_sysconfdir}/apache-%{name}.conf .
+Często sprawdza się %{_sysconfdir}/apache-%{name}.conf . Jeśli aplikacja
+posiada własny %{_sysconfdir}, lepszym wyborem może być
+%{_sysconfdir}/apache.conf .
 
 "Podpinanie" konfiguracje do apache'a
 
@@ -599,9 +610,60 @@
 
 Jeśli wcześniejsze wersje danej aplikacji grzebały w apache.conf lub
 httpd.conf, należy dodać odpowiedni trigger dla konwersji do nowego
-schematu (jest to częste w przypadku aplikacji dla apache1).
-Przykładowy trigger można znaleźć w template-apache1_module.spec.
-Przykład zastosowania triggera dla apache2 znajduje się w turba.spec.
+schematu. Przykładowy trigger można znaleźć w template-apache-package.spec .
+
+Dla modułów apache1 istnieje odrębny wzorzec: template-apache1_module.spec .
 
 Jeśli aplikacja uprzednio trzymała konfigurację w katalogu apache'a,
-także należy dodać trigger dla jego przeniesienia (przykład w imp.spec).
+także należy dodać trigger dla jego przeniesienia (dla przykładu, patrz
+template-apache-package.spec).
+
+
+Nazewnictwo plików w SOURCES
+
+Kilka bezpodstawnych konwencji:
+- NAZWA-foo.patch - łatki
+- NAZWA.cron - fragmenty cron do umieszczenia w /etc/cron.d
+- NAZWA.logrotate - konfiguracja logrotate do umieszczenia w /etc/logrotate.d
+- NAZWA.sysconfig - konfiguracja aplikacji do /etc/sysconfig
+- NAZWA.init - skrypt inicjalizacji do /etc/rc.d/init.d
+
+NAZWA może być %{name} pakietu lub jego właściwą nazwą, jeśli nazwa
+pakietu jest poprzedzona prefiksem grupy (np. php-pear-%{_pearname},
+perl-%{pnam}, python-%{_name}). Poprzedzanie nazwy źródeł i łat nazwą
+pakietu pozwala uniknąć kolizji pomiędzy różnymi pakietami.
+
+Wygodnym jest użycie vi ../SOURCES/NAZWA-<TAB> dla uzyskania listy łat
+oraz vi ../SOURCES/NAZWA.<TAB> aby powłoka rozwinęła listę plików
+konfiguracyjnych.
+
+Zaleca się stosowanie tej konwencji. Gdyby okazała się konieczna masowa
+zmiana plików crontab, skryptów inicjalizacyjnych czy też sysconfig,
+łatwo będzie odnaleźć te pliki w CVS-ie.
+
+
+PERL
+
+perllocal.pod
+
+Zwykle po zainstalowaniu perlowego pakietu z CPAN powstaje niespakietowany
+plik /usr/lib/perl5/5.8.6/i686-pld-linux-thread-multi/perllocal.pod. Żeby
+uniknąć instalacji tego pliku, należy w specu użyć make pure_install,
+zgodnie z przykładem w template-perl.spec.
+
+Tworzenie nowych pakietów perla (CPAN)
+
+Używać należy wrappera ./new-span.sh. Potrzebne są do tego pakiety
+cpan2rpm oraz pldcpan. W zasadzie pldcpan powinien być poprawiony tak,
+żeby sam ściągał pakiety z CPAN. Aktualnie do ściągania używany jest
+cpan2rpm.
+
+TODO usuwać:
+/usr/lib/perl5/vendor_perl/5.8.0/i686-pld-linux-thread-multi/auto/gpg-ezmlm/.packlist
+
+
+PHP PEAR.
+
+Pakiety php-pear należy tworzyć używając polecenia `pear makerpm NAZWAPEAR`.
+Wynik nie jest doskonały, więc trzeba go następnie nieco uporządkować.
+Binarkę pear można znaleźć w pakiecie php-pear-PEAR.
================================================================

---- CVS-web:
    http://cvs.pld-linux.org/PLD-doc/devel-hints-pl.txt?r1=1.43&r2=1.44&f=u