Re: [Pod2it-translators] Sugli esempi nella documentazione

[Enrico S. <enr...@gm...>]

Ciao Flavio,

Il giorno 27 agosto 2009 10.27, Flavio Poletti<pol...@gm...> ha scritto:
> Ciao a tutti,
>    non ricordo se la discussione è già stata affrontata e tantomeno
> documentata, ma magari non fa male (ri-)farla.
> Sto affrontando perldiag dalla 5.10.1 (lo so bepi, sopportami e magari
> linciami in un altro thread...)

Why? Stavo appunto pensando ad un post sulle revisioni dei pod da
5.8.8 a 5.10.0/1 e sul versioning dei pacchetti.
Ma poi come abbiamo risolto l'alberatura? (OK riprendo in un altro thread)
BTW, perché non parti dal 5.10.0 e in un botto solo abbiamo anche la
5.10.1 (ci sono non più di 20 linee di differenza)?

>e mi trovo di fronte codice del genere:
>     open(OUT,">$ARGV[0]") or die "Can't write to $ARGV[0]: $!";
>     while (<STDIN>) {
>         print;
>         print OUT;
>     }
>     close OUT;
> Ma andiamo, siamo nel 2009 e soprattutto nella documentazione di 5.10.1!!!
> Io sinceramente scriverei così:
>     open(my $out, '>', $ARGV[0]) or die "Can't write to $ARGV[0]: $!";
>     while (<STDIN>) {
>         print;
>         print {$out} $_;
>     }
>     close $out;
> ma prevedo obiezioni su fatto che noi non dobbiamo entrare nel merito, ma
> chi ci crediamo di essere ecc. ecc.
> Il percorso giusto è probabilmente affrontare p5p o perl-documentation,
> farsi ridere dietro per un po' di tempo e magari alla fine spuntarla per
> aggiornare gli esempi nella documentazione ufficiale. Nel frattempo, però...
> è proprio sbagliato "tradurre" il codice in qualcosa che abbia senso nel
> 2009?

Sono d'accordo col correggere ove possibile la parte descrittiva dei
pod in modo da renderla comprensibile.
Ad esempio perldebug che sto finendo di tradurre (praticamente dalla
5.8.0 alla 5.10.1 cambia pochissimo) è abbastanza obsoleta (ci sono
riferimenti ancora al browser netscape), piena di espressioni
intraducibili e un di licenza me la sono necessariamente presa. Però
di codice ce n'è poco.

Sul codice che mostri sono d'accordo sull'inviare la patch a p5p!
perl-documentation sarebbe il luogo indicato ma non so perché non la
usa più nessuno.

bye

   - Enrico

PS: io in genere scrivo

   print $out $_;

senza graffe. Ho commesso un peccato grave? :-)