Changes between Version 6 and Version 7 of NewParrotDeveloperGuide

Show
Ignore:
Timestamp:
12/10/08 17:33:14 (6 years ago)
Author:
gaurav
Comment:

Monospaced program and path names, replaced some "your" -> "you're", other minor fixes

Legend:

Unmodified
Added
Removed
Modified
  • NewParrotDeveloperGuide

    v6 v7  
    11== Newcomers Welcome! == 
    22 
    3 We're going to do our best to document the experiences of newcommers to Perl, Parrot and Open Source software development. Hopefully this will evolve into a road map for those who wish to contribute but are having trouble getting started. 
     3We're going to do our best to document the experiences of newcomers to Perl, Parrot and Open Source software development. Hopefully this will evolve into a road map for those who wish to contribute but are having trouble getting started. 
    44 
    55== Before you start == 
     
    1414== Getting Parrot == 
    1515 
    16 If your going to become part of the development team, you'll need to check out a local copy of the source code. You can visit the  [http://www.parrotcode.org/source.html download] page on the main Parrot web site for full details. You'll need to make sure you have the following already installed on your machine. 
     16If your going to become part of the development team, you'll need to check out a local copy of the source code. You can visit the  [http://www.parrotcode.org/source.html download] page on the main Parrot web site for full details. 
    1717 
    1818Assuming you've got Perl, perldoc and Subversion installed you'll be doing something like this. 
     
    2727}}} 
    2828 
    29 One make target to avoid right now is install. Running make install is not currently recommended. 
     29One make target to avoid right now is install. Running `make install` is not currently recommended. 
    3030 
    3131== Running Parrot == 
     
    4646== Learning Parrot == 
    4747 
    48 You've downloaded, configured, compiled, tested and created the html documentation for Parrot. Now it's time to start reading. Parrots source documentation is stored in [http://en.wikipedia.org/wiki/Plain_Old_Documentation POD] format. If you ran make html you can the view the documentation as html. The file docs/html/index.html is the place to start. An alternative and more flexible method for viewing the documentation is to use [http://search.cpan.org/dist/Pod-Perldoc/lib/perldoc.pod perldoc] to view the actual pod files. Perldoc will allow you to view the pod files formated as man pages. It cannot be stressed enough how important it is to read the documentation for this project. 
     48You've downloaded, configured, compiled, tested and created the html documentation for Parrot. Now it's time to start reading. Parrot's source documentation is stored in [http://en.wikipedia.org/wiki/Plain_Old_Documentation POD] format. If you ran `make html` you can the view the documentation in any HTML browser. The file `docs/html/index.html` is the place to start. An alternative and more flexible method for viewing the documentation is to use [http://search.cpan.org/dist/Pod-Perldoc/lib/perldoc.pod perldoc] to view the actual pod files, formatted as man pages. It cannot be stressed enough how important it is to read the documentation for this project. 
    4949 
    5050The bare minimum reading needed to get you off the ground is: 
    5151 
    52  * docs/info.pod 
    53  * docs/gettingstarted.pod 
     52 * `docs/info.pod` 
     53 * `docs/gettingstarted.pod` 
    5454 
    55 After you read those, you'll want to run through all of the tutorials in examples/tutorial. 
     55After you read those, you'll want to run through all of the tutorials in `examples/tutorial`. 
    5656 
    57 Next on your reading list should be the PDDs (Parrot Design Documents). You will learn much by reading these, so don't skimp. 
     57Next on your reading list should be the PDDs (Parrot Design Documents) in `docs/ppds`. You will learn much by reading these, so don't skimp. 
    5858 
    5959== Contributing == 
    6060 
    61 By now you've read the introductory documentation and reviewed the example/tutorial files. Now you have to decide what area of the project you'd like to contribute to. 
     61By now you've read the introductory documentation and reviewed the `example/tutorial` files. Now you have to decide what area of the project you'd like to contribute to. 
    6262 
    6363=== Test Suite === 
    6464 
    65 Original Parrot tests where written in Perl. Those Perl tests can be ported to PIR test. This is a good place to earn your feathers and learn more PIR at the same time. [http://www.perlfoundation.org/parrot/index.cgi?convert_existing_tests_to_parrot Converting existing tests to Parrot] covers what you'll need to know about the format of a PIR test. If your not familiar with the test suite functions you'll want to review parrot/runtime/library/Test/More.pir. The functions section gives a description of the different testing functions like: plan, diag, ok, nok, is, is_deeply, like, isa_ok, skip, isnt and todo. This is a good time to point out that POD can and usually is embedded in PIR files. So if your in the root build directory you can run the following to view the module documentation: 
     65Original Parrot tests where written in Perl. Those Perl tests can be ported to PIR test. This is a good place to earn your feathers and learn more PIR at the same time. [http://www.perlfoundation.org/parrot/index.cgi?convert_existing_tests_to_parrot Converting existing tests to Parrot] covers what you'll need to know about the format of a PIR test. If you're not familiar with the test suite functions, you'll want to review `parrot/runtime/library/Test/More.pir`. The functions section gives a description of the different testing functions, mainly: `plan`, `diag`, `ok`, `nok`, `is`, `is_deeply`, `like`, `isa_ok`, `skip`, `isnt` and `todo`. This is a good time to point out that POD can and usually is embedded in PIR files. So if you're in the root build directory, you can run the following to view the module documentation: 
    6666 
    6767{{{ 
     
    6969}}} 
    7070 
    71 You already now that make test runs the test suite, but when working on individual tests you'll want to run only the test your concerned with. You can do this using Perls prove for a Perl test or either prove or Parrot itself for PIR tests. 
     71You already know that `make test` runs the test suite, but when working on individual tests you'll want to run only the test your concerned with. You can do this using Perl's [http://perldoc.perl.org/prove.html prove] for a Perl test, or either `prove` or Parrot itself for PIR tests. 
    7272 
    7373{{{ 
     
    110110[http://www.perlfoundation.org/parrot/index.cgi/names_test_rewrite.patch?action=attachments_download;page_name=starting_at_the_bottom;id=20081113142750-0-29058 names_test_rewrite.patch] 
    111111 
    112 Then you'll need to send an email, with the patch as an attachment, to Perlbug. It should look something like this. 
     112Then you'll need to send an email, with the patch as an attachment, to Parrotbug. It should look something like this. 
    113113 
    114114{{{