GSoC/GCI Archive
Google Code-in 2010 Parrot Foundation and The Perl Foundation

Parrot: Write program to create wiki page identifying 'hack' comments in source code

completed by: Nagato Yuki

mentors: James E Keenan

Task Description

 

Parrot's source code contains many comments which characterize adjacent code as 'hacks'.  Since there is no universally accepted definition of 'hack', it is not clear what action, if any, needs to be taken to improve the allegedly hack-ish code.  But, at the very least, we need a way to locate all such comments.  It has been suggested that a program be written in Perl 5, PIR or NQP-RX that locates such comments and creates a wiki page on the Parrot trac site that links 'hack' comments to source code pages on Parrot's github site.

Steps To Complete This Task

  1. Create a fork of parrot.git on github.com
  2. Perform all the necessary code and/or documentation changes
  3. Build parrot and run it's test suite (make fulltest) to verify that things still work
  4. You can also submit a smoke report with "make smoke", but that is optional.
  5. Create a Github pull request (button on the upper right of your fork) to have your changes incorporated into the master repository

Benefits

  1. Would enable Parrot developers to locate areas in source code potentially in need of refactoring.

Requirements

  1. Perl 5

Additional Links