Joaquin Ferrero | 7 Mar 2013 21:26
Favicon
Gravatar

Please, update docs (& pods) for Perl 5.16.3!!!


And cherry-pick them!!!

perlfaq is not updated, in Perl 5.16.3-RC1.

Joaquín Ferrero | 16 Nov 2012 02:20
Favicon
Gravatar

[ANNOUNCE] POD2::ES v5.16.2.01

Other new release of POD2::ES

-------------------------------------------------------------------
Last Changes:

5.16.2.01  November 15, 2012

            * Updated to v5.16.2
            * Added the translation of perlglossary.pod and perlcheat.pod
            * Changed the translation of 'closure'
            * Fixed inconsistent translations of 'built-in'

5.16.1.03  September 9, 2012

            * Fixed bug in ES.pm (removed use 5.010 and forgot to
              change defined-or operator)

-------------------------------------------------------------------
Stats:

169 total docs, 107 core docs
78 translated (46.15%)
36 reviewed & published

947,607 total words
33.60% translated (63.33% core docs)
20.56% reviewed & published

-------------------------------------------------------------------

(Continue reading)

Anša Vernerová | 19 Jun 2012 09:58
Picon

documentation for the split command; webpage issues

Hello,

I would like to report that the current documentation for the split command is erronerrous.
http://perldoc.perl.org/functions/split.html says:

--

In time-critical applications, it is worthwhile to avoid splitting into more fields than necessary. Thus, when assigning to a list, if LIMIT is omitted (or zero), then LIMIT is treated as though it were one larger than the number of variables in the list; for the following, LIMIT is implicitly 4:

  1. ($login, $passwd, $remainder) = split(/:/);
--


Calling the third argument $remainer is simply wrong - the remainder is the fourth argument, which is not assigned to anything. This must come from some edit of the older version of the documentation, which can be found e.g. at http://www.tu-chemnitz.de/docs/perldoc-html/functions/split.html :

--

The LIMIT parameter can be used to split a line partially

($login, $passwd, $remainder) = split(/:/, $_, 3);

When assigning to a list, if LIMIT is omitted, or zero, Perl supplies a LIMIT one larger than the number of variables in the list, to avoid unnecessary work. For the list above LIMIT would have been 4 by default. In time critical applications it behooves you not to split into more fields than you really need.

--


When I wanted to report this, I found it hard to find out where and how I should report. There is a contacts section at the bottom of the page, but neither Joe Allen's link nor the link to the project page seem to work - and reporting to the perl 5 porters list did not seem adequate. So I hope this is the right list to report such issues.

Anša

Joaquín Ferrero | 15 May 2012 03:11
Favicon
Gravatar

Perl v5.16R0, VMS and others docs issues

Hi!

Perl v5.16R0 links README[.](.*) docs from pod/perl$1.pod, but not for perlvms.pod,
because perlvms.pod already exist.

pod/perlvms.pod and README.vms are different docs. So, README.vms is not installed with the
distribution, only perlvms.pod.

Another issue (?) is README.micro. It still exists, but is not linked by perl.pod, and therefore
perlmicro.pod is not generated.

JF^D

Joaquin Ferrero | 7 Apr 2012 02:49
Favicon
Gravatar

PerlDoc-ES project, at 33,33% done

Hello,

Last Changes of the project PerlDoc-ES:

	49 pod    files translated
	19 README files translated
	31 files in process

The project is at

	37.45% done (33.33% of core documentation)

	55,585 segments remain :)

Public Progress and Statistics:

	PerlDoc-ES.Traducción
	https://docs.google.com/spreadsheet/ccc?key=0AkmrG_9Q4x15dC1MNWloU0lyUjhGa2NrdTVTOG5WZVE

For more information on the project, please visit
https://github.com/zipf/perldoc-es

Regards,
Joaquín F.
--

-- 
JF^D

Joaquin Ferrero | 25 Mar 2012 03:10
Favicon
Gravatar

Github changed pod rendering HTML format

Hi!.

Today, I saw that Github render iso-8859-1 encoded pod pages with a double utf8 encoding bug.

Example:

	https://github.com/zipf/perldoc-es/blob/master/pod/reviewed/perl.pod

but, one pod utf8 encoded *with* =encoding utf8 tag, renders it well:

	https://github.com/zipf/perldoc-es/blob/master/pod/translated/perl5101delta.pod#___top

¿Will we need to change all POD documentation to utf8, definitely?

--

-- 
JF^D

Shlomi Fish | 24 Mar 2012 19:04
Favicon
Gravatar

Fw: Two Documents Restored from perl.net.au


Begin forwarded message:

Date: Sat, 24 Mar 2012 20:00:32 +0200
From: Shlomi Fish <shlomif <at> shlomifish.org>
To: Perl in Israel <perl <at> perl.org.il>
Subject: Two Documents Restored from perl.net.au

Hi all.

http://perl.net.au/ was a somewhat popular wiki for all things Perl. Then it
was heavily spammed, and afterwards went completely offline for many months,
and the admins have become busy. Luckily, in the past days I was able to restore
some of the contents from the Wayback Machine, and place them here and here:

* http://perl-begin.org/FAQs/freenode-perl/ - the Freenode #perl’s FAQ.

* http://perl-begin.org/humour/ - a page collecting Perl Humour.

I plan to restore more stuff.

For how I restored it: I tried several scripts (and a CPAN module) I found
online (which were hard to come by, and I was disappointed that apparently the
Wayback Machine does not provide a Web API), and eventually used this script
written in Python:

http://code.activestate.com/recipes/286224-pulling-stuff-out-of-the-internet-archive-wayback-/

I had to modify it to not be recursive.

Anyway, enjoy!

Regards,

	Shlomi Fish

-- 
-----------------------------------------------------------------
Shlomi Fish       http://www.shlomifish.org/
What Makes Software Apps High Quality -  http://shlom.in/sw-quality

Every successful open source project will eventually spawn a sub‐project.

Please reply to list if it's a mailing list post - http://shlom.in/reply .

--

-- 
-----------------------------------------------------------------
Shlomi Fish       http://www.shlomifish.org/
Chuck Norris/etc. Facts - http://www.shlomifish.org/humour/bits/facts/

Beliefs are what divide people. Doubt unites them.
    — http://en.wikiquote.org/wiki/Peter_Ustinov

Please reply to list if it's a mailing list post - http://shlom.in/reply .

Picon
Gravatar

Perl 5 wiki

The [official Perl 5 wiki](http://p3rl.org/wiki) has recently become
unusable for its original purpose, see the
[announcement](http://use.perl.org/~schwern/journal/33751). It is
currently impossible to register as a new user. I sent an email to
<support <at> socialtext.com> six days ago and have yet to receive an
acknowledgement/reply/fix.

I am looking for a champion to take up the cause: investigate what's
going on and keep nagging so that access to registration is restored.
In case we cannot get satisfaction in a reasonable time, let's consider
cutting ties. Some initial thoughts:

* Export everything, tools available from
  <http://search.cpan.org/~lukec/>.
* Evaluate Perl wiki softwares and import. Should support [Wiki
  Creole](http://enwp.org/Creole_(markup)) and
  [Markdown](http://enwp.org/Markdown) syntaxes for editing. Usability
  must pass mst's opinion as "not crap". Must not have URL cruft.
  Insert your own favourite bikeshed colour here.
* Find a reliable host for the software: Perl NOC/digital
  craftsmen/speedchilli/etc.
* Ask [Perl NOC](http://noc.perl.org/) for `wiki.perl.org` CNAME.
* Send webmasters of perlfoundation.org and socialtext.net some
  configuration snippets for their Apache httpd and nginx so that the
  legacy URLs permanently redirect to the new ones.
Joaquin Ferrero | 30 Oct 2011 03:21
Favicon
Gravatar

[ANNOUNCE] POD2::ES v5.14.2.05


Hello,

A new release of POD2::ES is now available on CPAN.

Last Changes:

5.14.2.05  October 30, 2011

            * Fixed typo and made other changes in perlpragma.pod

5.14.2.04  October 29, 2011

            * Added the translation of perlpragma.pod
            * Minor changes in perlfaq1.pod and perlutil.pod
            * Pod fix in perlstyle.pod

5.14.2.03  October 22, 2011

            * Added the translation of perlstyle.pod
            * Minor changes in perldbmfilter.pod

5.14.2.02  October 7, 2011

            * Added the translation of perldoc.pod

5.14.2.01  October 6, 2011

            * Updated to Perl v5.14.2
            * Added the translation of perldbmfilter.pod

The project is at 32.28%.

For more information on the project, please visit https://github.com/zipf/perldoc-es

Best regards,
Joaquín

Shlomi Fish | 10 Sep 2011 12:33
Picon
Gravatar

Re: About.com Guide for Perl [was Fwd: RE: Guide Application for [Perl]]

Hello Joel,

sorry for the late response.

On Tue, 31 May 2011 11:15:08 -0500
Joel Limardo <joel.limardo <at> forwardphase.com> wrote:

> I was the one who asked for your writing sample. I wanted to see if there
> was something fairly obvious in your writing that would cause a rejection.
> After looking at the links you provided, I'm sad to say that I agree with
> About.com.
> 

Well, in my letter I asked if anyone would be willing to volunteer for
maintaining the Perl section of About.com, due to the fact that my
application was rejected. The fact that my application was rejected was a
given and I assumed there was little or nothing I could do about it. Telling me
why my writing is lacking, is besides the point of finding someone to maintain
the Perl section on About.com, and I didn't request that input.

Thanks for passing your commentary on my writing, but it's not going to help
with the issue I raised.

Regards,

	Shlomi Fish

--

-- 
-----------------------------------------------------------------
Shlomi Fish       http://www.shlomifish.org/
Interview with Ben Collins-Sussman - http://shlom.in/sussman

Had I not been already insane, I would have long ago driven myself mad.
    — The Enemy and how I Helped to Fight It

Please reply to list if it's a mailing list post - http://shlom.in/reply .

Naveed Massjouni | 8 Sep 2011 05:30
Picon
Gravatar

HTTP::Tiny and JSON::PP

I noticed that perldoc.perl.org does not list HTTP::Tiny and JSON::PP
as core modules. I believe this is a documentation bug. 5.14 has been
out for a while now. I have contacted Jon Allen a couple weeks ago
about this and have not heard a response. Hopefully someone on this
list can do something about this.

Thanks,
Naveed


Gmane