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
_______________________________________________
pld-cvs-commit mailing list
[email protected]
http://lists.pld-linux.org/mailman/listinfo/pld-cvs-commit
