Translation(s): English - Italiano
Usare darcs su Alioth
Creazione di un nuovo repository darcs pubblico (per un nuovo progetto)
Consultare la sezione dedicata nelle FAQ; è necessario cambiare il tipo di repository utilizzato dal progetto che verrà creato in /darcs/<gruppo-progetto>.
Nota: Invece di registrare progetti separati per i pacchetti è consigliabile utilizzare il progetto di manutenzione collaborativa, per maggiori informazioni si veda la pagina Alioth/PackagingProject. Una volta concesso l'accesso a tale progetto (gli sviluppatori Debian hanno accesso in modo predefinito, mentre gli altri devono fare richiesta) è possibile avviare immediatamente il progetto darcs ospitato accedendo su alioth.debian.org e creando un repository darcs in /darcs/collab-maint/.
Per inizializzare il proprio repository remoto, bisogna eseguire questi comandi in /darcs/<gruppo> ( se non si dispone di un progetto dedicato <gruppo> può essere collab-maint):
$ umask 002 $ mkdir <progetto> $ cd <progetto> $ darcs init
Darcsweb offre la possibilità di mostrare alcuni valori particolari, come descrizione del repository (desc), URL del repository (url) e URL del repository a monte (projurl). Modificare i seguenti file:
$ cd /percorso/del/<progetto> $ mkdir -p _darcs/third_party/darcsweb $ vim _darcs/third_party/darcsweb/desc $ vim _darcs/third_party/darcsweb/url $ vim _darcs/third_party/darcsweb/projurl
Quindi inserire un contenuto in tale repository, usando darcs pull su darcs.debian.org o darcs push su darcs.debian.org da una macchina remota. Vedere sotto per gli URL darcs utilizzabili.
Esempio: creare un progetto in un repository collab-maint su Alioth:
$ cd /percorso/del/<progetto> $ darcs push <nome_utente>@darcs.debian.org:/darcs/collab-maint/<progetto>
Accesso ai repository
Sono accessibili da darcs utilizzando http (in sola lettura) o ssh (lettura e scrittura), o da darcsweb all'indirizzo http://darcs.debian.org (sola lettura). Per esempio, si potrà fare il check out del proprio ramo tramite ssh con:
$ darcs get <nome_utente>@darcs.debian.org:/darcs/<gruppo>/<progetto>
Gli utenti anonimi potranno beneficiare di un accesso in sola lettura con i seguenti comandi. <gruppo> potrebbe ad esempio essere il nome del pacchetto o, se ospitato in collaborazione, collab-maint.
$ darcs get http://darcs.debian.org/darcs/<gruppo>/<progetto>
Impostazione delle notifiche
Invio email con diff
È stata inserita una soluzione temporanea in /usr/local/bin/darcs-email-changelog dato che in Debian manca questa funzione (si veda il bug Debian 462330).
Per inviare diffstats ad una mailing list ed al sistema tracciamento pacchetti usare:
$ cd <progetto> $ cat >_darcs/prefs/defaults apply run-posthook apply posthook \ TO=<alioth-nome-progetto>-commits@lists.alioth.debian.org \ BCC=<progetto>_cvs@packages.qa.debian.org \ PROJECT=<alioth-nome-progetto> \ REPO_NAME=<progetto> \ /usr/local/bin/darcs-email-changelog
Invio notifiche su IRC tramite un bot CIA
Ecco alcuni notificatori creati per CIA: http://cia.vc/doc/clients/
Utilizzo di repository darcs personali
È anche possibile avere repository darcs personali. Accedere ad alioth, quindi creare la directory
$ mkdir ~/public_darcs
ed inserirvi all'interno il proprio repository darcs, ad esempio <progetto>.
Dopo qualche ora verranno rilevati automaticamente ed elencati su http://darcs.debian.org. I repository sono disponibili tramite i seguenti URL:
$ darcs get http://darcs.debian.org/~<nome_utente>/<progetto> $ darcs get <nome_utente>@darcs.debian.org:~/public_darcs/<progetto>