Grant Proposal: RPerl User Documentation, Part 2


The Grants Committee has received one grant proposal for the January/February round. Before the Committee members vote, we would like to solicit feedback from the Perl community on the proposal.

Review the proposal below and please comment here by February 17th, 2016. The Committee members will start the voting process following that and the conclusion will be announced by February 27th.

RPerl User Documentation, Part 2

  • Name:

    Will Braswell

  • Amount Requested:

    USD 1,600


RPerl v1.5 has been released with numerous new features, as promised. The RPerl User Docs grant work has been completed, but much documentation remains to be written immediately. This grant proposal is to continue work on the Learning RPerl user tutorial.

Benefits to the Perl Community

The number one request and obvious need at this time is still quality RPerl user documentation, to help new RPerl users learn how to write fast software. Learning RPerl is the canonical guide to RPerl and must be completed to enjoy the maximum benefit to the Perl programming community.


Deliverables for this grant proposal are:

1. Complete Learning RPerl Chapter 2

2. Write Learning RPerl Chapter 3

3. Write Learning RPerl Chapter 4

Project Details

I've already written all of the code for the solutions to exercises from chapters 1 through 6 of Learning Perl:

Exercises in Learning Perl which are not supported by RPerl are omitted.

I've already got a partial copy of Learning RPerl on the website:


Chapter 2 Scalar Data

1a. Numbers; Strings; Perl’s Built-in Warnings; Scalar Variables

1b. Output with print; The if Control Structure; Getting User Input; The chomp Operator

1c. The while Control Structure; The undef Value; The defined Function

Chapter 3 Lists and Arrays

2a. Accessing Elements of an Array; Special Array Indices; List Literals; List Assignment

2b. Interpolating Arrays into Strings; The foreach Control Structure

2c. Scalar and List Context; in List Context

Chapter 4 Subroutines

3a. Defining a Subroutine; Invoking a Subroutine; Return Values; Arguments

3b. Private Variables in Subroutines; Variable-Length Parameter Lists; Notes on Lexical (my) Variables

3c. The use strict Pragma; The return Operator;

3d. Non-Scalar Return Values; Persistent, Private Variables

Project Schedule

I will begin work immediately upon granting.

I expect work to take approximately 30 to 60 days.

Completeness Criteria

I will release a new version of RPerl to CPAN with the new documentation.

I will release a new version of the RPerl website with the new documentation.


I am the creator and lead developer of RPerl.

I've been working on RPerl for over 36 months.

I've successfully completed work on 1 TPF grant.

I would like to start work on the 2nd grant now.


Does RPerl have any users? This is a one-man project and I am a little surprised to see that the Perl Foundation has already put funds towards it. If the author were working with the Perl 5 maintainers then that would be one thing, but he seems to be on his own.

There is a language that I'd like to see go faster, and that is Perl 6. Please spend money on that.

Well Perl 5 was originally a one man project!

I was impressed with Will's talk at FOSDEM 2016 and hope it attracts more support.

I think its worth supporting perl 5, perl 6 and rperl and not putting all our eggs in one basket.

Do you have written permission from the copyright holder(s) of Learning Perl to do this? What are the terms of the license/waiver?

"Does RPerl have any users?" - Me!

That's why I need the documentation to be 100% complete.

I'm sure when docs finish and are 100% fully edited, more users will come to RPerl.

I have friends that showed interest in RPerl, but due to the lack of detail documentation, they are hesitant.

Please support Will, because his project deserves it.

Definitely needed, RPerl have future

We need cool projects like this to keep perl 5 alive and kicking, and high quality documentation seems to attract more users.

I vote for this project.

Investigating performance opportunities requires trying different approaches. RPerl is one approach, and Will seemed to eagerly follow his vision for the last years. I'm +1.

RPerl can't expect a proper shot at wider adoption without good documentation, so this task merits support.

I've voted for RPerl before, and also put some money in it, and I wish this grant will be rewarded. RPerl can be so very useful for the evolution of Perl.

Voting YES! Fund it!

RPerl has potential to be a faster , follow up grants may bring Perl5 and RPerl closer together.

Having a Perl that finally allows typing (yes, that means more robust code in larger projects) and brings speed improvements will definitly help.

So if Perl5 wants to stay relevant, the experiments of RPerl and CPerl should be considered a good source for potential to integrate into the main Perl5 branch (or rethink how Perl5 may evolve).

So I vote YES.

One of my successful networking contacts is waiting and waiting for RPerl to be more fully developed, incorporating massive speed-up of large scale data manipulation for his pending projects. He obviously needs to understand RPerl to make use of it in developing a number of smart phone apps that cannot otherwise work. The user manuals for RPerl are crucial. Please support this valuable project!

I Vote YES. Let's get this done!

This is a worthwhile project, and an outgrowth of the good "perl ii" explorations. RPerl has staying power, I'm for funding it.

I vote for this project too.

I'd say fund. There is not much else going on in Perl5 right now and this is one of the more interesting projects.

I do vote for not only this proposal, but also everything helping me to use the immortal Perl language. And I am looking forward to see the outcome.

I support this grant, rperl is a good thing for the perl community.

RPerl adds another perspective about perl performance and I would like to see this project evolving.
I vote Yes, please fund it!

I vote yes. I hope it will help to the RPerl team to improve the tool.

Performance matters. I've donated RPerl last time on kickstarter, and this project should go further.
Documentation matters. My friends wanted to try RPerl but stopped due to lack of documents.
Voting YES. Fund it!

I vote fund

Hash: SHA512

To Whom It May Concern,

I'm quite interested in learning more about RPerl. It sounds like a
neat project and I know that Will is quite dedicated. I've never seen
such an unending run of work on a source code repo (560 days
uninterrupted to date). 60 days worth of work in exchange for $1600
sounds like a steal to me and I advise The Perl Foundation to fund
this project.


C.J. Collier

Version: GnuPG v2


I've written a lot of Perl. I would love to keep using my Perl skills for large-scale data processing and scientific computing, and that really means RPerl. R is fast, but it's a language design nightmare. The Python scientific stack is pretty sweet, but using it means digging through stacks of reference documentation to find things about Python that I already know about Perl. Perl is magnificent, but there are speed issues. RPerl seems to be magnificent AND fast ... if only it had complete docs I could rely on. Please fund.

I like RPerl's concept, and the documentation could indeed use some extra work. I vote +1

Yes, I would love to see this happen! It's much vital for Perl 5. I would use it.

I think the man deserves support!

Please fund it!

My vote is YES..

Wil is really passionate about Rperl and after seeing his demos and long term dedication to the project I strongly feel he deserves the Perl Foundations support. 'Classic' Perl needs to maintain long term backward compatibility which makes the language increasingly less viable for new projects the require features like crazy high performance and concurrency. Rperl is a massive opportunity to let people that like Perl and are building new things to get some of these new features, all while not tossing out all hopes of compat with existing code.

I've personally supported the Rperl kickstarter and think the money he's asking for to improve docs and get more people running with it is not a lot for value he's adding.

Compiling Perl into executable binary is definitely useful

I think with RPerl, we could have the faster program without much gain. So I hope documentation of this project is needed.
Voting Yes. :-)

Tutorial material for RPerl would be welcome. Assuming no copyright issues with use of "Learning Perl" this has my vote.

Definitely needed.
I vote Yes, please fund it!

as long as it is done with an eye towards perl 6 compatibility every project that could help gain the interest of the masses (and we never know which projects those turn out to be) is something we should all e for.

+1 for this project!

I vote yes.

RPerl is crucial. Say yest to it and please have it funded. Thanks.

I vote yes.

Voting yes. :^)

Without docs nobody will try to use software, especially rperl. I support this grant.

I vote yes, I would like to see RPerl evolving

Yes for funding! RPerl has improved perl and can sustain against php/c++ in terms of performance!!!


I vote for this project as I have been using RPerl since the beta version.


My vote is YES

OK, why not. Seems fair.

RPerl is one approach to making Perl grow as a community and good quality documentation is a major attractor. I vote yes.

About TPF

The Perl Foundation - supporting the Perl community since 2000. Find out more at

About this Entry

This page contains a single entry by Makoto Nozaki published on February 8, 2016 10:00 PM.

Perl 6 Release Goals: Final Grant Report was the previous entry in this blog.

YAPC::NA::2016 Call for Speakers is the next entry in this blog.

Find recent content on the main index or look in the archives to find all content.


OpenID accepted here Learn more about OpenID
Powered by Movable Type 6.2.2