[PLUTO-soci] Nuove man-pages in italiano: spiegazione tecnica

[Giulio Daprelà]

Per capire le motivazioni che hanno portato all'attuale struttura
delle pagine man in italiano è necessaria una breve premessa su
come funzionano quelle in inglese.
Il pacchetto man-pages ufficiale è gestito da Michael Kerrisk ed è
reperibile presso il sito 
<http://www.win.tue.nl/%7Eaeb/linux/man/>http://www.win.tue.nl/~aeb/linux/man/. 
Per
meglio capire in cosa consiste questo pacchetto traduco un paragrafo
dal sito scritto dallo stesso Kerrisk:
"Le pagine man appartenenti ai programmi di solito sono distribuite
con tali programmi. Pertanto, la distribuzione delle man-pages di Linux
contiene principalmente le pagine di chiamate di sistema e librerie,
dispositivi speciali, e formati di file. Tuttavia essa contiene anche
la documentazione di numerosi programmi, nei casi in cui gli autori o
i maintainer dei programmi non distribuiscano essi stessi le pagine
man."

Questo pacchetto riceve numerosi contributi, e quindi viene aggiornato
molto spesso, circa due o tre volte al mese, tuttavia la gestione
globale delle pagine man offre anche un indubbio vantaggio: gli
aggiornamenti periodici sono documentati da un changelog, e questo
permette un'agevole manutenzione ai traduttori. Se le stesse pagine
man fossero distribuite con i rispettivi pacchetti di appartenenza,
mantenerle aggiornate per i traduttori sarebbe estremamente difficile,
perché si sarebbe costretti a seguire le evoluzioni di decine di
pacchetti differenti (e un changelog di una pagina man non è mai
riportato!).

Da questa considerazione è nata l'idea di suddividere le pagine man in
italiano in due pacchetti: il primo conterrà SOLO le pagine man
provenienti dal pacchetto ufficiale, che ad oggi è alla versione 2.21.
Il numero di versione delle pagine italiane seguirà l'evoluzione delle
pagine inglesi, sarà agganciato ad esse e ci dirà su quale versione
delle pagine ufficiali è allineata la versione italiana. Questo ci dà
la garanzia di avere sempre un pacchetto italiano aggiornato ed
utilizzabile, seppure forzatamente incompleto, dato che ad oggi sono
tradotte circa 130 pagine contro le oltre 3000 presenti nel pacchetto
ufficiale.

Il secondo pacchetto l'ho chiamato man-pages-it-extra, e conterrà tutte
quelle pagine di manuale che non provengono dal pacchetto ufficiale.
La prima versione di questo pacchetto contiene le pagine man dei
pacchetti:
- binutils-2.15.94.0.2.2
- bison-2.0
- inetutils-1.4.2
- wireless-tools-27 (solo iwconfig.8)
- programmi per la gestione e installazione dei pacchetti in formato deb

Si ringrazia Hugh Hackmann per le pagine Debian e Claudio Ferronato
per iwconfig.8.

La prima versione del pacchetto è la 0.1.0, e il cambio di versione
seguirà il seguente andamento:
- ogni aggiornamento di pagine esistenti causerà un cambio della
versione minore (da 0.1.0 a 0.1.1, 0.1.2 ecc.)
- ogni aggiunta di pagine nuove causerà un cambiamento della versione
maggiore (da 0.1.0 a 0.99.0 e poi 1.0.0 ecc.)

Per qualunque dubbio, perplessità, chiarimento o proposta di collaborazione
contattatemi.

Ringrazio tutti i collaboratori di ILDP, senza i quali il mantenimento
del progetto non sarebbe possibile, e ricordo inoltre che chi vuole
collaborare è il benvenuto. Per informazioni, si può consultare il sito di
ILDP (<http://it.tldp.org/>http://it.tldp.org/), iscriversi alla mailing 
list pluto-ildp
attraverso la pagina 
<http://lists.pluto.it/mailman/listinfo/pluto-ildp/>http://lists.pluto.it/mailman/listinfo/pluto-ildp/
oppure contattare direttamente me.

--
Giulio Daprelà - giulio(at)pluto.it
PLUTO Project - <http://www.pluto.it/>http://www.pluto.it/
ILDP - <http://it.tldp.org/>http://it.tldp.org/ | http://ildp.pluto.it/
TLDP - <http://tldp.org/>http://tldp.org/  

--
Gli annunci del PLUTO Project
http://www.pluto.it/