PLD-doc: devel-hints-en.txt, devel-hints-pl.txt - notes on naming packages

[pawelz]

Author: pawelz                       Date: Sun Apr 11 22:14:57 2010 GMT
Module: PLD-doc                       Tag: HEAD
---- Log message:
- notes on naming packages

---- Files affected:
PLD-doc:
   devel-hints-en.txt (1.42 -> 1.43) , devel-hints-pl.txt (1.62 -> 1.63) 

---- Diffs:

================================================================
Index: PLD-doc/devel-hints-en.txt
diff -u PLD-doc/devel-hints-en.txt:1.42 PLD-doc/devel-hints-en.txt:1.43
--- PLD-doc/devel-hints-en.txt:1.42	Wed Feb 24 15:37:08 2010
+++ PLD-doc/devel-hints-en.txt	Mon Apr 12 00:14:51 2010
@@ -36,11 +36,21 @@
 - for PEAR modules: php-pear-<name> (where <name> usually is
   Class[_Class[_Class...]])
 - for binary PECL modules, which are PHP extensions: php-pecl-<name>
-- for Perl modules: perl-<name> (for object modules the name usually
-  is Class[-Class[-Class...]])
-- for Python modules: python-<name>
 - for kernel modules: kernel-<type>-<name> (<type> is the same as the
   subdirectory inside drivers/ - eg. char, net etc.)
+- for any non-native libraries: <lang_name>-<name>, examples:
+  * for Perl modules: perl-<name> (for object modules the name usually
+    is Class[-Class[-Class...]])
+  * for Python modules: python-<name>
+  * for Java libraries: java-<name>
+  * for Ruby libraries: ruby-<name>
+Note that, some packages may contain library and application that uses this
+library. In such case you should split it into two packages: <name> and
+<lang_name>-<name>. If application is only tiny example on how to use library,
+spec should be named <lang_name>-<name>.spec. Otherwise, if it is real
+application and library is used mainly by given application, spec may be named
+<name>.spec (hint: use -n to create subpackage without <name>- prefix). See
+ack.spec for an example of such package.
 
 Subpackages:
 Packages containing shared libraries can be divided into:

================================================================
Index: PLD-doc/devel-hints-pl.txt
diff -u PLD-doc/devel-hints-pl.txt:1.62 PLD-doc/devel-hints-pl.txt:1.63
--- PLD-doc/devel-hints-pl.txt:1.62	Wed Feb 24 15:37:08 2010
+++ PLD-doc/devel-hints-pl.txt	Mon Apr 12 00:14:51 2010
@@ -52,11 +52,23 @@
 - dla modu³ów PEAR-a: php-pear-nazwa (gdzie nazwa zazwyczaj jest postaci
   Klasa[_Klasa[_Klasa...]]
 - dla modu³ów binarnych PECL, bêd±cych rozszerzeniami PHP: php-pecl-nazwa
-- dla modu³ów Perla: perl-nazwa (dla modu³ów obiektowych zazwyczaj
-  nazwa jest postaci Klasa[-Klasa[-Klasa...]]
-- dla modu³ów Pythona: python-nazwa
 - dla modu³ów j±dra: kernel-typ-nazwa (typ jest taki sam, jak podkatalog
   w drivers/ w którym znalaz³by siê modu³ - np. char, net itd.)
+- dla nienatywnych bibliotek: <jêzyk>-<nazwa>, na przyk³ad:
+  * dla modu³ów Perla: perl-nazwa (dla modu³ów obiektowych zazwyczaj
+    nazwa jest postaci Klasa[-Klasa[-Klasa...]]
+  * dla modu³ów Pythona: python-<nazwa>
+  * dla bibliotek Javy: java-<nazwa>
+  * dla bibliotek Rubyego: ruby-<nazwa>
+Zauwa¿, ¿e niektóre pakiety mog± zawieraæ bibliotekê i aplikacjê korzystaj±c±
+z tej biblioteki. W takim przypadku powiniene¶ rozbiæ pakiet na podpakiety:
+<nazwa> i <jêzyk>-<nazwa>. Je¶li aplikacja jest jedynie ma³ym przyk³adem
+ilustruj±cym zastosowanie biblioteki, spec powinien siê nazywaæ
+<jêzyk>-<nazwa>.spec. W przeciwnym przypadku, to znaczy kiedy  mamy do
+czynienia z "prawdziw±" aplikacj±, natomiat biblioteka jest wykorzystywana
+g³ównie przez tê aplikacjê, spec mo¿e siê nazywaæ <nazwa>.spec (wskazówka:
+u¿yj flagi -n aby utworzyæ podpakiet bez prefiksu <nazwa>). Aby obejrzeæ
+przyk³ad takiego pakietu zobacz ack.spec.
 
 Podzia³ na podpakiety:
 Pakiety zawieraj±ce biblioteki dzielone standardowo dzielimy na:
================================================================

---- CVS-web:
    http://cvs.pld-linux.org/cgi-bin/cvsweb.cgi/PLD-doc/devel-hints-en.txt?r1=1.42&r2=1.43&f=u
    http://cvs.pld-linux.org/cgi-bin/cvsweb.cgi/PLD-doc/devel-hints-pl.txt?r1=1.62&r2=1.63&f=u