Permalink
Browse files

While discussion continues on p2, pod files should be at most

80 columns, special on verbatim sections, so we the man formatter
show it properly.


git-svn-id: https://svn.parrot.org/parrot/trunk@14308 d31e2699-5ff4-0310-a27c-f18f2fbe73fe
  • Loading branch information...
1 parent c7b84af commit 67c929f99efe0117925d652625a161e14e472281 @ambs ambs committed Aug 22, 2006
View
@@ -65,7 +65,10 @@ Configure.pl to use it.
mkdir C:\usr\lib\data
set PATH=%PATH%;C:\usr\lib\icu\bin
cd <parrot directory>
- perl Configure.pl --icushared="C:\usr\lib\icu\lib\icudt.lib C:\usr\lib\icu\lib\icuuc.lib" --icuheaders="C:\usr\lib\icu\include" --icudatadir="C:\usr\local\icu\data"
+ perl Configure.pl
+ --icushared="C:\usr\lib\icu\lib\icudt.lib C:\usr\lib\icu\lib\icuuc.lib"
+ --icuheaders="C:\usr\lib\icu\include"
+ --icudatadir="C:\usr\local\icu\data"
Note the step of creating the F<C:\usr\lib\data> directory, as Parrot
really wants it and the binary packages don't contain it. It doesn't
@@ -153,7 +156,11 @@ The HomePage is on L<http://www.mingw.org/>.
With the ActiveState Perl distribution or PXPerl distribution,
tell Configure.pl to use gcc :
- perl Configure.pl --cc=gcc --icushared="C:\usr\lib\icu\lib\icudt.lib C:\usr\lib\icu\lib\icuuc.lib" --icuheaders="C:\usr\lib\icu\include" --icudatadir="C:\usr\local\icu\data"
+ perl Configure.pl
+ --cc=gcc
+ --icushared="C:\usr\lib\icu\lib\icudt.lib C:\usr\lib\icu\lib\icuuc.lib"
+ --icuheaders="C:\usr\lib\icu\include"
+ --icudatadir="C:\usr\local\icu\data"
or
perl Configure.pl --cc=gcc --without-icu
View
@@ -194,9 +194,11 @@ From #parrot:
with leo and I am going to send and email to p6i for deprecation
of certain old features
-=head2 Help other contributors hack their patches into Parrot-style industrial-strength C code.
+=head2 Help other contributors hack their patches into Parrot-style
+industrial-strength C code.
-From chip's comment at L<http://www.oreillynet.com/onlamp/blog/2006/07/calling_for_parrot_janitors.html>
+From chip's comment at
+L<http://www.oreillynet.com/onlamp/blog/2006/07/calling_for_parrot_janitors.html>
We've just had contributed an improved register allocation
implementation, but since the contributor is new to Parrot,
View
@@ -62,7 +62,8 @@ None at this time.
=item * ResizableIntegerArray
-https://rt.perl.org/rt3//Ticket/Display.html?id=32374 # XXX This is the wrong ticket number.
+# XXX This is the wrong ticket number.
+https://rt.perl.org/rt3//Ticket/Display.html?id=32374
=item * splice
@@ -329,26 +329,26 @@ distribution (parrot/docs)
.include "timer.pasm" # for the timer constants
.sub expired
- print "Timer has expired!\n"
+ print "Timer has expired!\n"
.end
.sub _ :main
- $P0 = new .Timer
- $P1 = global "expired"
+ $P0 = new .Timer
+ $P1 = global "expired"
- $P0[.PARROT_TIMER_HANDLER] = $P1 # call sub in $P1 when timer goes off
- $P0[.PARROT_TIMER_SEC] = 2 # trigger every 2 seconds
- $P0[.PARROT_TIMER_REPEAT] = -1 # repeat indefinitely
- $P0[.PARROT_TIMER_RUNNING] = 1 # start timer immediately
- global "timer" = $P0 # keep the timer around
+ $P0[.PARROT_TIMER_HANDLER] = $P1 # call sub in $P1 when timer goes off
+ $P0[.PARROT_TIMER_SEC] = 2 # trigger every 2 seconds
+ $P0[.PARROT_TIMER_REPEAT] = -1 # repeat indefinitely
+ $P0[.PARROT_TIMER_RUNNING] = 1 # start timer immediately
+ global "timer" = $P0 # keep the timer around
- $I0 = 0
+ $I0 = 0
loop:
- print $I0
- print ": running...\n"
- inc $I0
- sleep 1 # wait a second
- goto loop
+ print $I0
+ print ": running...\n"
+ inc $I0
+ sleep 1 # wait a second
+ goto loop
.end
@@ -142,7 +142,8 @@ created as a Coroutine PMC:
The sub C<bar> will return to the caller of C<foo>.
-=head2 How do I generate a sub call with a variable-length parameter list in PIR?
+=head2 How do I generate a sub call with a variable-length parameter
+list in PIR?
If you have a variable amounts of arguments in an array, you can
pass all items of that array with the C<:flat> directive.
@@ -154,7 +155,8 @@ pass all items of that array with the C<:flat> directive.
foo(ar :flat)
...
-=head2 How to I retrieve the contents of a variable-length parameter list being passed to me?
+=head2 How to I retrieve the contents of a variable-length parameter
+list being passed to me?
Use a slurpy array:
@@ -225,7 +227,8 @@ namespace names have a NULL char prepended to their name.
.end
-=head2 How do I use lexical pads to have both a function scope and a global scope?
+=head2 How do I use lexical pads to have both a function scope and a
+global scope?
Please refer to L<docs/pdds/pdd20_lexical_vars.pod> for details.
@@ -266,7 +266,8 @@ mangled by Joshua Hoblitt.
=head1 SEE ALSO
-L<Parrot::Configure>, L<Parrot::Configure::Data>, L<Parrot::Configure::Step>, L<Parrot::Configure::Step::Base>
+L<Parrot::Configure>, L<Parrot::Configure::Data>,
+L<Parrot::Configure::Step>, L<Parrot::Configure::Step::Base>
=cut
View
@@ -134,8 +134,9 @@ Step 7: Step into the JITed code
gdb> s
-At this point, you can step through the instructions, or print out the various
-Parrot registers. FIXME: C<gdb> will know about I0-I31, N0-N31, S0-S31, and P0-P31.
+At this point, you can step through the instructions, or print out the
+various Parrot registers. FIXME: C<gdb> will know about I0-I31,
+N0-N31, S0-S31, and P0-P31.
WARNING: Stepping too far
@@ -103,11 +103,13 @@ The optimizer loop works as follows:
=item 2. Build basic block info.
-=item 3. Run all cfg_optimize() optimizations. If one makes a change, go to step 1.
+=item 3. Run all cfg_optimize() optimizations. If one makes a
+change, go to step 1.
=item 4. Build all other CFG info (dominators, loops, life analysis).
-=item 5. Run all optimize() optimizations. If one makes a change, go to step 1.
+=item 5. Run all optimize() optimizations. If one makes a change, go
+to step 1.
=back
View
@@ -25,7 +25,8 @@ embed.pod - Parrot embedding system
pf = Parrot_readbc(interp, bcfile);
Parrot_loadbc(interp, pf);
- Parrot_runcode(interp, argc, argv); /* argc and argv as seen by the bytecode file */
+ /* argc and argv as seen by the bytecode file */
+ Parrot_runcode(interp, argc, argv);
Parrot_destroy(interp);
@@ -202,7 +203,8 @@ This constant contains the name of your operating system (as the JIT sees it).
Allocates and returns a new Parrot interpreter. C<parent> is NULL for the main
interpreter that will be destroyed last.
-=item C<void Parrot_setflags(Parrot_Interp, Parrot_Interp_flag, Parrot_Interp_flag_val)>
+=item C<void Parrot_setflags(Parrot_Interp, Parrot_Interp_flag,
+Parrot_Interp_flag_val)>
Sets a flag in the Parrot interpreter.
View
@@ -221,14 +221,16 @@ It's not anymore. As of July 2006, the list is called parrot-porters
to reflect the growing list of languages and platforms embraced by
Parrot. The old perl6-internals list forwards to the new one.
-=head2 Pugs is going great shakes - why not just toss Parrot and run Perl 6 on Pugs?
-
-Audrey Tang, the lead on the Pugs project, notes that an B<unoptimized>
-Parrot is already 30% faster than the Haskell-based interpreter. Add compiler
-optimization and a few planned optimizations and Parrot will beat Pugs for
-speed hands down. Audrey thinks that Pugs could be made faster with some
-Haskell compiler tricks, but it's harder work and less effective than the
-Parrot optimizations we already know how to do.
+=head2 Pugs is going great shakes - why not just toss Parrot and run
+Perl 6 on Pugs?
+
+Audrey Tang, the lead on the Pugs project, notes that an
+B<unoptimized> Parrot is already 30% faster than the Haskell-based
+interpreter. Add compiler optimization and a few planned optimizations
+and Parrot will beat Pugs for speed hands down. Audrey thinks that
+Pugs could be made faster with some Haskell compiler tricks, but it's
+harder work and less effective than the Parrot optimizations we
+already know how to do.
Perl 5 is highly portable, and builds on around 50 different systems, many far
removed from Unix or MS Windows. We'd like Perl 6 to be able run everywhere
@@ -173,9 +173,10 @@ integer type constants are working for creating new PMCs.
=item .HLL_map .CoreType, .UserType
-Whenever Parrot has to create PMCs inside C code on behalf of the running user
-program it consults the current type mapping for the executing HLL and creates
-a PMC of type I<.UserType> instead of I<.CoreType>, if such a mapping is defined.
+Whenever Parrot has to create PMCs inside C code on behalf of the
+running user program it consults the current type mapping for the
+executing HLL and creates a PMC of type I<.UserType> instead of
+I<.CoreType>, if such a mapping is defined.
E.g. with this code snippet ...
View
@@ -150,14 +150,14 @@ Parrot has an extensive regression test suite. This can be run by typing:
Substituting make for the name of the make program on your platform. The output
will look something like this:
- C:\Perl\bin\perl.exe t\harness --gc-debug --running-make-test
- t\library\*.t t\op\*.t t\pmc\*.t t\run\*.t t\native_pbc\*.t
- imcc\t\*\*.t t\dynpmc\*.t t\p6rules\*.t t\src\*.t t\perl\*.t
- t\library\dumper...............ok
- t\library\getopt_long..........ok
- ...
- All tests successful, 4 test and 71 subtests skipped.
- Files=163, Tests=2719, 192 wallclock secs ( 0.00 cusr + 0.00 csys = 0.00 CPU)
+ C:\Perl\bin\perl.exe t\harness --gc-debug --running-make-test
+ t\library\*.t t\op\*.t t\pmc\*.t t\run\*.t t\native_pbc\*.t
+ imcc\t\*\*.t t\dynpmc\*.t t\p6rules\*.t t\src\*.t t\perl\*.t
+ t\library\dumper...............ok
+ t\library\getopt_long..........ok
+ ...
+ All tests successful, 4 test and 71 subtests skipped.
+ Files=163, Tests=2719, 192 wallclock secs ( 0.00 cusr + 0.00 csys = 0.00 CPU)
It is possible that a number of tests may fail. If this is a small number, then
it is probably little to worry about, especially if you have the latest Parrot
@@ -202,10 +202,10 @@ register and then use that register with the print instruction.
end
.end
-Here we have stated exactly which register to use. However, by replacing C<S0>
-with C<$S0> we can delegate the choice of which register to use to Parrot. It is
-also possible to use an C<=> notation instead of writing the C<set>
-instruction.
+Here we have stated exactly which register to use. However, by
+replacing C<S0> with C<$S0> we can delegate the choice of which
+register to use to Parrot. It is also possible to use an C<=>
+notation instead of writing the C<set> instruction.
.sub _main
$S0 = "Hello world!\n"
Oops, something went wrong.

0 comments on commit 67c929f

Please sign in to comment.