r30: manpage for cp-update

[carnet-tools-cn.git] / README.CARNet

diff --git a/README.CARNet b/README.CARNet
index 3ce87ea..1ec6ee1 100644 (file)
--- a/README.CARNet
+++ b/README.CARNet
@@ -62,6 +62,29 @@ cp_mail [-q] <package> <version>
        Ove dvije funkcije koriste globalnu varijablu CP_NOTICE u koju se
        spremaju poruke za mail.
 
+cp_mv <new-file> <target-file>
+
+       Funkcija cija je namjena da novu datoteku <new-file> instalira kao
+       zadanu <target-file> datoteku, koja moze i/ili ne postojati. Ako ta
+       datoteka postoji onda se novoj dodjeljuje njeno vlasnistvo i modovi
+       pristupa. Operacija je atomicna.
+
+       Funkcija cp_safe_file_replace je prikladna za koristenje kod raznih
+       sed-like izmjena neke postojece datoteke iako se za samo sed-anje
+       preporuca koristiti funkciju cp_check_and_sed.
+
+cp_yes_no [<prompt>]
+
+        Funkcija za jednostavni (y)es/(n)o dijalog. Odgovor y/n vraca u RET.
+       Valja napomenuti da je kao i sve ostalo sto trosi stdin/stdout 
+        nekompatibilan s debconfom (doticnog treba pogasiti prvo).
+
+cp_db_get_wrap <package>/<variable>
+
+        Wrapper za debconfovu funkciju db_get koji umjesto neke neocekivane
+        greske vrati prazni RET. Kome treba greska neka ga ne koristi.
+
+
 Funkcije cije ime pocinje sa cp_get_ pohranjuju rezultat u varijabli $RET,
 a one s prefiksom cp_check_ kao rezultat vracaju exit status.  U pozivnoj
 skripti se mogu definirati sljedece varijable koje utjecu na rad svih
@@ -74,5 +97,9 @@ $CP_SCRIPT_DEBUG
 $CP_ECHO_RETURN
 
        Vracanje rezultata na stdout i u varijabli $RET.
+       Ako se cp_ funkcija koja vraca string poziva unutar neke druge cp_
+       funkcije, treba iskljucivo koristiti $RET konvenciju, i sacuvati
+       prethodno stanje varijable CP_ECHO_RETURN.
+
 
 -- Ivan 'ico' Rako <irako@srce.hr>  Wed, 16 Mar 2005 14:25:14 +0100