PLD-doc: devel-hints-en.txt - added some TODOs (translate sections from -pl...

[pawelz]

Author: pawelz                       Date: Thu Jun 10 12:53:11 2010 GMT
Module: PLD-doc                       Tag: HEAD
---- Log message:
- added some TODOs (translate sections from -pl)
- unified formatting

---- Files affected:
PLD-doc:
   devel-hints-en.txt (1.55 -> 1.56) 

---- Diffs:

================================================================
Index: PLD-doc/devel-hints-en.txt
diff -u PLD-doc/devel-hints-en.txt:1.55 PLD-doc/devel-hints-en.txt:1.56
--- PLD-doc/devel-hints-en.txt:1.55	Mon Jun  7 16:56:12 2010
+++ PLD-doc/devel-hints-en.txt	Thu Jun 10 14:53:06 2010
@@ -513,7 +513,7 @@
    due to lacking write permissions to the directory), they should be created
    in the %post script, keeping in mind to grant them correct permissions.
 
-12.4. %files section for shared libraries:
+12.4. %files section for shared libraries
 
    Consider an example library 'libexample.so.1.0.2' with SONAME
    'libexample.so.1'. Correct %files sections should contain following lines:
@@ -554,7 +554,7 @@
    desktop-file-utils package. More information about their contents can be
    found on http://www.freedesktop.org/Standard/desktop-entry-spec/
 
-12.6. Documentation (%doc files):
+12.6. Documentation (%doc files)
 
    Every package should, whenever possible, contain documentation files.
    Documentation files should be marked with %doc, which makes it possible to
@@ -568,6 +568,22 @@
    - add files that contain the same documentation in various formats
    - add standard license files, contained in the common-licenses package
 
+12.7. System accounts created by packages
+
+{{{TODO: translate
+   Konta systemowe i grupy tworzone przez pakiety: Czasami zdarza się, pakiet
+   potrzebuje utworzyć użytkownika i/lub grupę.  Przykładowo jeżeli jest to
+   demon,który ma być uruchamiany z ograniczonymi prawami. W takiej sytuacji:
+   - rejestrujemy nazwę użytkownika, nazwę grupy, uid oraz gid w pliku:
+     cvs://PLD-doc/uid_gid.db.txt
+   - tworzymy użytkownika/grupę w skrypcie %pre korzystając z makr %groupadd
+     oraz %useradd
+   - usuwamy użytkownika/grupę w skrypcie %postun korzystając z makr
+     %userremove oraz %groupremove
+   - dodajemy odpowiednie zależności. Szczegóły można przeczytać w pliku
+     cvs://PLD-doc/BuildRequires.txt.
+}}}
+
 13. Updating a package
 
    When updating a package you should browse the patches that are applied to
@@ -695,6 +711,16 @@
    cvs up -A <name>.patch
    # modifying <name>.patch
    cvs tag -F <tag> <name>.patch
+
+16.2. Removing obsolete tags/branches
+
+{{{TODO: translate
+   Tag lub branch uznajemy za zbędny w przypadku zmergowania jego zawartości z
+   głównym drzewkiem.  Ma to najczęściej miejsce w przypadku brancha DEVEL. Po
+   udanym mergu z DEVEL na HEAD należy więc usunąć branch DEVEL by nie
+   ogłupiać innych:
+   cvs tag -d DEVEL <nazwa>.spec
+}}}
 
 17. Packaging webapps independant of webserver
 
================================================================

---- CVS-web:
    http://cvs.pld-linux.org/cgi-bin/cvsweb.cgi/PLD-doc/devel-hints-en.txt?r1=1.55&r2=1.56&f=u