arthas has asked for the wisdom of the Perl Monks concerning the following question:

Hi monks!

Me and others are into a projects which aims at translating as much perl documentation (the perldoc one which is provided with the interpreter) into Italian language.

Problem is we need to find the more updated documentation possible. Perldoc.com seems not to always have the bleeding edge documents, and we only succeded in finding some of them. For instance, perlfaq latest version is available at http://cvs.perl.org/cgi/viewcvs.cgi/. But where's the rest? In particular I'm currently looking for perlthrtut and perlfunc.

Thank you in advance!

Michele.

Replies are listed 'Best First'.
Re: Where's the latest perldoc located?
by hardburn (Abbot) on Jun 12, 2003 at 15:38 UTC

    Let me start off by saying that I think translating the documents is a Good Thing(tm), and nothing I say below should be taken as to discourage the task.

    That said, if the docs change so much that you have to go digging through a CVS repository at least once a week (or even once a month) to get "the bleeding edge", perhaps its not a good canidiate for translation, unless your team is really willing to keep up with that level of activity. Out-of-date documentation is often worse than no documenation at all. Add to this that it is inevitable that something will be lost in the translation (something you just have to live with), and you have a great recipe for confusion.

    I would stick to the docs that come with the currently released version of perl.

    ----
    I wanted to explore how Perl's closures can be manipulated, and ended up creating an object system by accident.
    -- Schemer

    Note: All code is untested, unless otherwise stated

[reply]

      Hi hardburn!

      Of course, I don't know how often we'll be able to update the documentation. However, I think there's no point in translating old documentation when there's some new one out there: I'd just like to get the new one I can get today and translate that.

      Does this make sense? ;-)

      Michele.

[reply]
Re: Where's the latest perldoc located?
by PetaMem (Priest) on Jun 12, 2003 at 18:00 UTC
    I know, that machine translation (MT) is considered to be far below the human quality level translation.

    Well - let me state, that this is not true anymore. And one of the reasons is Perl... ;-)

    If your team'd be willing to inspect/correct/update the EN->IT dictionaries resp. their inevitable extension that'd happen when crunching the perldoc corpora, we could provide you with italian translation at no cost. msg if interested.

    Bye
     PetaMem         All Perl:   MT, NLP, NLU

[reply]
      As a member from Istanbul, Turkey, I'm glad to see that `Türkisch´ is included in your system (even though it is at a primitive form).
[reply]
Re: Where's the latest perldoc located?
by broquaint (Abbot) on Jun 12, 2003 at 23:49 UTC
    The very latest perl documentation can be retrieved by performing an rsync as described in perlhack e.g 
    rsync -avz rsync://ftp.linux.activestate.com/perl-current/ .

    [download]
    As that is the edge material (it ain't called bleadperl for nothin' ;). But I imagine it would be much more useful to translate the 5.8.0 docs as that's the current stable release and I believe quite a few areas of the perl documentation will, and have, been re-written for the next stable release 5.10, but it won't be seen in the wild for a while yet (only Hugo really knows when :).
    HTH

    _________
    broquaint

[reply]
[d/l]

Back to Seekers of Perl Wisdom